Fulcrum Keyboard固件刷写教程KMK CircuitPython从零开始【免费下载链接】FulcrumThe Fulcrum Keyboard is an ergo-mechanical split keyboard with extra thumb functionality. It has 20 keys, two rotary encoders, and two 5-way switches.项目地址: https://gitcode.com/gh_mirrors/ful/FulcrumFulcrum Keyboard是一款开源的人体工学分体键盘它用两个5向摇杆5-Way Switch彻底释放拇指的潜能配合20键、34键与40键三种极简布局让打字既高效又舒适。而这一切都运行在基于KMK的CircuitPython固件之上。这篇Fulcrum Keyboard固件刷写教程将从零开始带你完成固件烧录、键位配置和蓝牙连接即使你是第一次接触键盘固件的纯新手也能照着一步步搞定。Fulcrum Keyboard是什么认识这款人体工学分体键盘Fulcrum Keyboard由nRF52840微控制器驱动支持无线蓝牙BLE连接左右两半分体设计中间通过排线相连。它的核心卖点在于5向摇杆拇指开关左右各一个把六种操作放到拇指指尖几乎不用移动就能触发。旋钮编码器默认左旋钮负责撤销/重做右旋钮控制音量。组合键Combos同时按下两个键即可输出一个词或一个操作比如同时按 RS 就是退格。多图层布局一个按键可以承载多个功能通过图层切换实现极简配列。目前项目提供了三套固件分别对应20键、34键测试版和40键版本你可以在克隆仓库后的src/目录里找到它们。固件刷写前需要准备什么材料清单动手之前先确认你手头有这几样东西Fulcrum Keyboard本体已经焊好、能上电的成品nRF52840主控如 Adafruit Itsy Bitsy 或 Feather 版本一根USB数据线用于连接电脑与键盘一台电脑Windows / macOS / Linux 均可固件源码从仓库获取终端执行git clone https://gitcode.com/gh_mirrors/ful/Fulcrum克隆完成后进入src/目录你会看到20-key、34-key-beta、40-key三个文件夹每个里面都包含code.py和kb.py两个核心文件。认识固件源码code.py 与 kb.py 的分工在动手刷写前先花一分钟理解固件结构。Fulcrum Keyboard 的固件只由两个文件构成非常简单kb.py硬件配置。定义键盘矩阵的列引脚col_pins、行引脚row_pins以及二极管方向DiodeOrientation.COL2ROW告诉KMK固件每个按键接在主控的哪个引脚上。code.py逻辑配置。加载KMK的各个模块图层、组合键、鼠标键、媒体键等定义组合键规则、旋钮映射以及最重要的——键位布局keymap。以40键版本为例对应的文件是src/40-key/code.py和src/40-key/kb.py。刷写固件本质就是把这两个文件加上KMK运行库一起放进主控的磁盘里让它在开机时自动执行。第一步安装CircuitPython运行环境KMK固件是运行在CircuitPython之上的所以第一步是给nRF52840主控安装CircuitPython前往CircuitPython官网下载适配你主控型号如 nRF52840的.uf2固件文件。按住主控上的复位键RESET插入USB线进入Bootloader模式电脑上会出现一个名为FTHRBOOT之类的磁盘。把下载好的.uf2文件直接拖入该磁盘主控会自动重启并出现一个名为CIRCUITPY的新磁盘。从KMK官方仓库下载对应版本的kmk文件夹放入CIRCUITPY磁盘的根目录这样固件运行时才能import到所需模块。第二步复制固件文件到CIRCUITPY磁盘环境就绪后开始真正的固件刷写根据你的键盘版本进入对应的固件目录例如40键版进入src/40-key/。将code.py和kb.py两个文件复制到CIRCUITPY磁盘根目录。安全弹出磁盘。主控会自动重启并开始运行KMK固件——注意CircuitPython会在修改文件后自动重载所以复制文件这个动作本身就是刷写过程无需任何烧录器或命令行工具这正是KMK CircuitPython固件的最大便利之处。此时键盘应该已经可以识别按键了你可以先插线测试每个键是否响应确认矩阵接线无误。第三步按需修改键位布局KMK固件自定义键位指南固件刷写完成后最有趣的部分来了——自定义键位。KMK固件的键位配置全部集中在code.py的keyboard.keymap中它是一个多层布局结构。以40键版为例它定义了四个图层字母主层ALPHA2、数字层NUM、宏指令层MACRO LAYER等。每个图层是一个按键列表按下图层切换键如KC.MO(1)即可临时切换到对应层。想改某个键只需把列表里对应的KC.XXX换成你想要的键码即可例如把KC.N7换成KC.F7。修改后保存文件CircuitPython会自动重载新键位立刻生效无需重新刷写非常适合新手反复试错。第四步开机连接蓝牙BLE无线连接设置Fulcrum Keyboard默认以无线蓝牙模式运行这在固件末尾的这行代码中指定keyboard.go(hid_typeHIDModes.BLE, ble_namefulcrum)这意味着键盘开机后会以fulcrum这个名字广播蓝牙信号。配对方法打开电脑或手机的蓝牙设置扫描附近设备。找到名为fulcrum的设备并连接。连接成功后即可拔掉USB线享受无线输入。若想修改蓝牙名称把ble_namefulcrum改成你喜欢的名字即可。固件刷写常见问题排查新手刷写固件时最容易遇到几个问题这里一并列出解决方法CIRCUITPY磁盘不出现检查USB线是否为数据线部分线只能充电或重新进入Bootloader模式重刷CircuitPython。部分按键无反应多半是矩阵接线问题。对照kb.py里的引脚定义检查排线也可参考项目里的接线示意图。蓝牙搜索不到设备确认code.py末尾有HIDModes.BLE配置且磁盘已安全弹出避免文件未写入完成。修改键位后键盘没变化确认修改的是对应版本目录下的code.py并检查文件是否已正确保存到CIRCUITPY根目录。进阶玩法在固件中配置组合键与旋钮熟悉基础刷写后可以进一步挖掘KMK固件的进阶玩法。Fulcrum Keyboard的灵魂在于组合键Combos两个键同时按下触发一个操作。在code.py的combos.combos里你可以用一行代码定义自己的组合键例如Chord((KC.R, KC.S), KC.BSPC, timeout40),这表示同时按下 R 和 S 就会输出退格键。20键版本正是靠大量组合键实现全功能输入的。旋钮的配置则通过EncoderHandler完成src/20-key/code.py里给出了现成示例左旋钮默认撤销/重做右旋钮控制音量你还可以给旋钮配置鼠标滚轮、切换标签页等功能。到这里你已经完整掌握了Fulcrum Keyboard固件刷写的全流程从安装CircuitPython、复制KMK固件文件到自定义键位、连接蓝牙再到组合键与旋钮的进阶配置。这套KMK CircuitPython固件的魅力就在于即改即用——每一次保存都是刷写每一次重载都是新键盘。现在就动手克隆仓库把属于你的Fulcrum Keyboard变成独一无二的输入神器吧【免费下载链接】FulcrumThe Fulcrum Keyboard is an ergo-mechanical split keyboard with extra thumb functionality. It has 20 keys, two rotary encoders, and two 5-way switches.项目地址: https://gitcode.com/gh_mirrors/ful/Fulcrum创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
