如何将Raspberry Pi Pico橡皮鸭的Adafruit HID键盘布局从US改为DE

核心结论 #

可以直接通过Adafruit HID库完成布局替换，无需更换底层依赖库，操作成本很低。

具体操作步骤 #

• 首先确认Adafruit HID库的目录结构，默认美式布局对应adafruit_hid/keyboard_layout_us.py文件，你可以直接基于这个文件的结构修改，也可以找现成适配好的德语布局源码：核心需要保留KEYMAP字典、ASCII_TO_KEYCODE映射表两个核心模块，对照德语键盘的键位调整字符和键码+修饰键的对应关系（比如öäüß、特殊符号、欧元符号的映射调整）
• 把调整完成的德语布局代码保存为keyboard_layout_de.py，如果你的Pico当前用的是.mpy格式的预编译布局文件，可以用mpy-cross工具把写好的keyboard_layout_de.py编译为和你Pico运行的MicroPython版本匹配的.mpy文件，存入对应目录即可
• 修改你的业务代码中的布局导入逻辑：把原来的from adafruit_hid.keyboard_layout_us import KeyboardLayoutUS替换为from keyboard_layout_de import KeyboardLayoutDE，初始化布局实例时调用KeyboardLayoutDE类即可生效

优化建议 #

• 不要直接修改原有US布局的文件，保留多份布局文件需要切换时仅修改导入语句即可，灵活性更高
• 如果遇到部分特殊字符映射错误，直接调整keyboard_layout_de.py中ASCII_TO_KEYCODE的对应关系即可，不需要修改HID底层逻辑
• 预编译为.mpy格式的布局文件占用存储空间更小，加载速度更快，适合Pico这类存储资源有限的设备

内容的提问来源于stack exchange，提问作者Kasmori