Fulcrum Keyboard常见问题排查蓝牙断连、按键失灵等10个解决方案【免费下载链接】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 是一款开源的无线人体工学分体键盘采用 nRF52840 主控并运行 KMK CircuitPython 固件通过蓝牙BLE连接电脑提供 20 键、40 键与 34 键 beta 三个版本。作为一款以手焊方式制作的 DIY 键盘长期使用后难免会遇到蓝牙断连、按键失灵等常见问题。本文为你整理了 10 个高频故障的排查思路与解决步骤从最简单的重新配对到固件重刷帮助你的 Fulcrum Keyboard 快速恢复正常状态。排查前先认识你的 Fulcrum Keyboard动手排查之前先确认你的版本与固件位置能少走很多弯路20 键版固件位于src/20-key/包含code.py主固件与键位和kb.py引脚定义是最成熟的版本40 键版固件位于src/40-key/布局较新但功能完整34 键 beta 版固件位于src/34-key-beta/处于测试阶段。三个版本的code.py末尾都通过HIDModes.BLE以蓝牙模式启动设备名统一为fulcrum后面很多蓝牙问题的排查都会用到这个信息。1. 蓝牙断连或连不上先试试重新配对适用情况电脑蓝牙列表里找不到 fulcrum 设备或配对成功后立即断开。最快也最常用的解决方法是删除设备后重新配对打开系统蓝牙设置找到名为fulcrum的设备并「移除/忘记」关闭再重新打开电脑的蓝牙开关将键盘关机再开机或拨动电源开关等待其重新广播在蓝牙列表中选择 fulcrum 重新配对。 小提示如果之前配对过多次系统里可能残留多个 fulcrum 记录请全部删除后再配对一次。2. 蓝牙频繁断连先检查电池电量与充电状态适用情况使用中每隔几分钟就断一次重连后很快又断。Fulcrum Keyboard 使用锂电池供电官方建议容量不低于500mAh因为它的功耗并不低。电量不足是蓝牙频繁断连的最常见原因通过 TP4056 充电模块或主控板内置充电功能为电池充满电若电池使用超过一年、出现鼓包或续航明显缩水建议直接更换新电池顺手检查电源开关与电池焊点是否松动。 充满电后断连问题消失说明就是电池问题日常记得及时充电即可。3. 蓝牙连接不稳定排查干扰源与连接距离适用情况电池满电但蓝牙依然时好时坏打字有延迟或卡顿。BLE 蓝牙工作在 2.4GHz 频段很容易受到干扰让键盘靠近接收设备保持在 23 米以内远离 USB 3.0 接口、WiFi 路由器、微波炉等强干扰源如果电脑同时连着多个蓝牙外设鼠标、耳机可暂时断开部分设备做交叉测试。把键盘放在开阔位置、避免金属遮挡通常能明显改善连接稳定性。4. 按键完全失灵从手焊接线与引脚定义查起适用情况某个按键完全没反应怎么按都不输出。Fulcrum Keyboard 没有 PCB是一块全手焊键盘接线松动是按键失灵最常见的元凶。排查步骤参考仓库中的接线图photos/wiring-full.jpg逐根检查对应按键的行列连线打开src/20-key/kb.py核对col_pins、row_pins与DiodeOrientation定义是否与你的实际接法一致检查焊点是否有虚焊、冷焊或相邻引脚短路。如果是刚组装完就失灵多半是接线顺序与固件定义不一致优先核对这几点。5. 个别按键时好时坏检查二极管与热插拔插座适用情况按键偶尔失灵用力按或重新插拔轴体后又恢复正常。这类接触不良通常来自两个地方二极管每个 5-way 摇杆需要 1 颗 1N4148 二极管焊点松动会让信号时通时断热插拔插座Fulcrum 支持打印热插拔插座来更换轴体插座夹片松弛、轴体针脚氧化都会造成偶发失灵。建议先换一颗新轴体做交叉测试换新后恢复正常说明是旧轴体或插座的问题反之则是焊点问题。6. 按键输出错误字符核对固件键位与图层配置适用情况按键能触发但打出来的字符和键帽印字不一致。Fulcrum Keyboard 的键位全部定义在固件code.py的keyboard.keymap中采用多层Layers布局同一按键在不同层功能不同检查是否误触发了图层切换键如MO(1)、MO(3)导致当前停留在导航层或数字层对照布局图photos/fulcrum-layout-all-layers-3.jpg确认各层按键定义修改过code.py后记得重新上电才会生效。大部分打错字其实是因为停留在错误图层按一下图层切换键回到主层即可。7. 组合键按不出来调整 Combo 触发时间参数适用情况两键同按输出组合功能时灵时不灵或经常误触发。Fulcrum 20 键版大量使用Combo组合键例如Chord((KC.R, KC.S), KC.BSPC, timeout40)表示同时按下 R、S 输出退格。组合键失灵通常和timeout参数有关timeout太短 → 按键稍慢就触发失败连按容易误触发 → 说明timeout偏长可适当调小。在src/20-key/code.py中找到对应Chord把timeout微调例如 40 → 60后保存并重新上电测试即可。8. 拇指摇杆失灵检查 5-way switch 焊点与导线适用情况摇杆某个方向或全部方向没有反应。Fulcrum 的招牌功能是两侧的5-way 拇指摇杆它通过两片打印平台夹紧后粘在外壳上导线经外壳开孔接入键盘矩阵某个方向失灵 → 优先检查该方向对应的开关触点焊点与导线全部方向失灵 → 检查摇杆底座的公共端GND连接以及平台夹紧是否松脱按压摇杆各方向时听是否有清脆的咔哒声没有声音说明开关本身可能损坏。摇杆打印件损坏的话可以在仓库STLs/SKRH-models-beta/中找到相关模型重新打印。9. 旋钮失效旋转编码器接线与固件配置双查适用情况旋转旋钮没有反应或按下无功能。Fulcrum 左右各有一个旋转编码器默认左旋钮负责撤销/重做右旋钮控制音量先检查编码器的 3 个引脚接线是否与code.py中encoder_handler.pins的定义一致确认编码器的按压功能是否已接入键盘矩阵若只是旋转方向反了属于正常现象调整map映射即可。这类问题 90% 出在接线上用万用表通断档测一下编码器两端很快就能定位。10. 键盘无法开机或无法识别重刷 KMK 固件适用情况键盘完全没反应、指示灯不亮或插入 USB 后电脑无法识别。最后的大招是重刷固件也是恢复系统的最佳途径通过 USB 连接键盘让 nRF52840 主控进入bootloader 模式不同开发板的进入方式不同可查阅主控资料将最新的 CircuitPython / KMK 固件拷贝到主控的存储盘按版本目录拷贝code.py、kb.py等配置文件重新上电等待键盘以 fulcrum 名称重新广播。如果需要获取最新固件源码可以克隆仓库获取git clone https://gitcode.com/gh_mirrors/ful/Fulcrum故障速查表故障现象优先排查项对应方案找不到蓝牙设备删除残留配对后重连方案 1用一会就断电池电量、充电方案 2时断时续干扰源、连接距离方案 3按键完全无反应接线、引脚定义方案 4按键偶尔失灵二极管、热插拔插座方案 5输出字符不对图层状态、键位定义方案 6组合键不灵Combo 的 timeout方案 7摇杆无反应焊点、公共端 GND方案 8旋钮失效编码器接线方案 9无法开机重刷固件方案 10结语Fulcrum Keyboard 是一把很有性格的 DIY 键盘绝大多数蓝牙断连按键失灵问题都出在电池、接线、固件配置这三个环节。建议按本文顺序从最简单的方案开始排查并在每次改动前备份好你的code.py与kb.py。掌握这 10 个排查方法你的 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），仅供参考
Fulcrum Keyboard常见问题排查蓝牙断连、按键失灵等10个解决方案【免费下载链接】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 是一款开源的无线人体工学分体键盘采用 nRF52840 主控并运行 KMK CircuitPython 固件通过蓝牙BLE连接电脑提供 20 键、40 键与 34 键 beta 三个版本。作为一款以手焊方式制作的 DIY 键盘长期使用后难免会遇到蓝牙断连、按键失灵等常见问题。本文为你整理了 10 个高频故障的排查思路与解决步骤从最简单的重新配对到固件重刷帮助你的 Fulcrum Keyboard 快速恢复正常状态。排查前先认识你的 Fulcrum Keyboard动手排查之前先确认你的版本与固件位置能少走很多弯路20 键版固件位于src/20-key/包含code.py主固件与键位和kb.py引脚定义是最成熟的版本40 键版固件位于src/40-key/布局较新但功能完整34 键 beta 版固件位于src/34-key-beta/处于测试阶段。三个版本的code.py末尾都通过HIDModes.BLE以蓝牙模式启动设备名统一为fulcrum后面很多蓝牙问题的排查都会用到这个信息。1. 蓝牙断连或连不上先试试重新配对适用情况电脑蓝牙列表里找不到 fulcrum 设备或配对成功后立即断开。最快也最常用的解决方法是删除设备后重新配对打开系统蓝牙设置找到名为fulcrum的设备并「移除/忘记」关闭再重新打开电脑的蓝牙开关将键盘关机再开机或拨动电源开关等待其重新广播在蓝牙列表中选择 fulcrum 重新配对。 小提示如果之前配对过多次系统里可能残留多个 fulcrum 记录请全部删除后再配对一次。2. 蓝牙频繁断连先检查电池电量与充电状态适用情况使用中每隔几分钟就断一次重连后很快又断。Fulcrum Keyboard 使用锂电池供电官方建议容量不低于500mAh因为它的功耗并不低。电量不足是蓝牙频繁断连的最常见原因通过 TP4056 充电模块或主控板内置充电功能为电池充满电若电池使用超过一年、出现鼓包或续航明显缩水建议直接更换新电池顺手检查电源开关与电池焊点是否松动。 充满电后断连问题消失说明就是电池问题日常记得及时充电即可。3. 蓝牙连接不稳定排查干扰源与连接距离适用情况电池满电但蓝牙依然时好时坏打字有延迟或卡顿。BLE 蓝牙工作在 2.4GHz 频段很容易受到干扰让键盘靠近接收设备保持在 23 米以内远离 USB 3.0 接口、WiFi 路由器、微波炉等强干扰源如果电脑同时连着多个蓝牙外设鼠标、耳机可暂时断开部分设备做交叉测试。把键盘放在开阔位置、避免金属遮挡通常能明显改善连接稳定性。4. 按键完全失灵从手焊接线与引脚定义查起适用情况某个按键完全没反应怎么按都不输出。Fulcrum Keyboard 没有 PCB是一块全手焊键盘接线松动是按键失灵最常见的元凶。排查步骤参考仓库中的接线图photos/wiring-full.jpg逐根检查对应按键的行列连线打开src/20-key/kb.py核对col_pins、row_pins与DiodeOrientation定义是否与你的实际接法一致检查焊点是否有虚焊、冷焊或相邻引脚短路。如果是刚组装完就失灵多半是接线顺序与固件定义不一致优先核对这几点。5. 个别按键时好时坏检查二极管与热插拔插座适用情况按键偶尔失灵用力按或重新插拔轴体后又恢复正常。这类接触不良通常来自两个地方二极管每个 5-way 摇杆需要 1 颗 1N4148 二极管焊点松动会让信号时通时断热插拔插座Fulcrum 支持打印热插拔插座来更换轴体插座夹片松弛、轴体针脚氧化都会造成偶发失灵。建议先换一颗新轴体做交叉测试换新后恢复正常说明是旧轴体或插座的问题反之则是焊点问题。6. 按键输出错误字符核对固件键位与图层配置适用情况按键能触发但打出来的字符和键帽印字不一致。Fulcrum Keyboard 的键位全部定义在固件code.py的keyboard.keymap中采用多层Layers布局同一按键在不同层功能不同检查是否误触发了图层切换键如MO(1)、MO(3)导致当前停留在导航层或数字层对照布局图photos/fulcrum-layout-all-layers-3.jpg确认各层按键定义修改过code.py后记得重新上电才会生效。大部分打错字其实是因为停留在错误图层按一下图层切换键回到主层即可。7. 组合键按不出来调整 Combo 触发时间参数适用情况两键同按输出组合功能时灵时不灵或经常误触发。Fulcrum 20 键版大量使用Combo组合键例如Chord((KC.R, KC.S), KC.BSPC, timeout40)表示同时按下 R、S 输出退格。组合键失灵通常和timeout参数有关timeout太短 → 按键稍慢就触发失败连按容易误触发 → 说明timeout偏长可适当调小。在src/20-key/code.py中找到对应Chord把timeout微调例如 40 → 60后保存并重新上电测试即可。8. 拇指摇杆失灵检查 5-way switch 焊点与导线适用情况摇杆某个方向或全部方向没有反应。Fulcrum 的招牌功能是两侧的5-way 拇指摇杆它通过两片打印平台夹紧后粘在外壳上导线经外壳开孔接入键盘矩阵某个方向失灵 → 优先检查该方向对应的开关触点焊点与导线全部方向失灵 → 检查摇杆底座的公共端GND连接以及平台夹紧是否松脱按压摇杆各方向时听是否有清脆的咔哒声没有声音说明开关本身可能损坏。摇杆打印件损坏的话可以在仓库STLs/SKRH-models-beta/中找到相关模型重新打印。9. 旋钮失效旋转编码器接线与固件配置双查适用情况旋转旋钮没有反应或按下无功能。Fulcrum 左右各有一个旋转编码器默认左旋钮负责撤销/重做右旋钮控制音量先检查编码器的 3 个引脚接线是否与code.py中encoder_handler.pins的定义一致确认编码器的按压功能是否已接入键盘矩阵若只是旋转方向反了属于正常现象调整map映射即可。这类问题 90% 出在接线上用万用表通断档测一下编码器两端很快就能定位。10. 键盘无法开机或无法识别重刷 KMK 固件适用情况键盘完全没反应、指示灯不亮或插入 USB 后电脑无法识别。最后的大招是重刷固件也是恢复系统的最佳途径通过 USB 连接键盘让 nRF52840 主控进入bootloader 模式不同开发板的进入方式不同可查阅主控资料将最新的 CircuitPython / KMK 固件拷贝到主控的存储盘按版本目录拷贝code.py、kb.py等配置文件重新上电等待键盘以 fulcrum 名称重新广播。如果需要获取最新固件源码可以克隆仓库获取git clone https://gitcode.com/gh_mirrors/ful/Fulcrum故障速查表故障现象优先排查项对应方案找不到蓝牙设备删除残留配对后重连方案 1用一会就断电池电量、充电方案 2时断时续干扰源、连接距离方案 3按键完全无反应接线、引脚定义方案 4按键偶尔失灵二极管、热插拔插座方案 5输出字符不对图层状态、键位定义方案 6组合键不灵Combo 的 timeout方案 7摇杆无反应焊点、公共端 GND方案 8旋钮失效编码器接线方案 9无法开机重刷固件方案 10结语Fulcrum Keyboard 是一把很有性格的 DIY 键盘绝大多数蓝牙断连按键失灵问题都出在电池、接线、固件配置这三个环节。建议按本文顺序从最简单的方案开始排查并在每次改动前备份好你的code.py与kb.py。掌握这 10 个排查方法你的 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），仅供参考
