ZMK固件中Corne键盘右侧突然失效的排查与解决

问题现象

在使用ZMK固件的Corne键盘（配备Nice!Nano V2控制器）时，用户遇到了右侧键盘突然无法正常工作的问题。具体表现为：

1. 右侧键盘无法通过蓝牙与左侧键盘通信
2. 右侧键盘直接连接USB时也无法发送按键信号
3. 尽管可以正常刷写固件，但问题依然存在

初步排查

用户首先尝试了多种常规解决方法：

1. 重新刷写默认ZMK固件配置
2. 完全擦除并重新刷写bootloader
3. 尝试使用ZMK官方指南中的settings_resetting方法
4. 检查硬件连接，确认没有物理损坏

深入分析

通过查看系统日志，发现了几个关键错误信息：

1. 配对失败错误：

[00:00:00.929,931] <err> bt_smp: pairing failed (peer reason 0x3)
[00:00:00.931,976] <err> zmk: Security failed: D9:75:CD:50:3E:0A (random) level 1 err 4

2. 加密链接问题：

[00:03:07.328,338] <wrn> bt_gatt: Link is not encrypted
[00:03:07.328,338] <dbg> zmk: send_position_state_callback: Error notifying -128

这些错误表明键盘两侧虽然能够发现彼此并尝试连接，但安全配对过程失败，导致无法建立加密通信通道。

解决方案

经过多次尝试，发现问题根源在于settings_reset固件未能正确清除原有的蓝牙配对设置。解决方法如下：

1. 使用特定的settings_reset固件文件（针对Nice!Nano V2定制）
2. 按照以下步骤操作：
   • 将键盘两侧都刷入settings_reset固件
   • 等待至少1分钟确保设置完全清除
   • 重新刷入正常的工作固件
   • 重置键盘

技术要点

1. ZMK固件架构：在ZMK的分体式键盘设计中，左侧（中央端）负责与计算机通信，右侧（外围端）仅通过BLE与左侧通信。这是为什么右侧直接连接USB时无法发送按键信号的原因。

2. 蓝牙配对机制：ZMK使用Nordic Semiconductor的蓝牙协议栈，配对失败可能由多种因素引起，包括但不限于：

   • 配对方的安全设置不匹配
   • 加密密钥生成失败
   • 存储的配对信息损坏

3. 显示问题：左侧显示屏不工作的问题可以通过激活外部电源（&ext_power EP_ON）解决，这反映了ZMK中电源管理的一个特性。

预防措施

为避免类似问题再次发生，建议：

1. 定期备份键盘配置和固件
2. 在进行固件更新前，先执行设置重置
3. 使用可靠的settings_reset固件文件
4. 在修改配置后，充分测试键盘功能

结论

ZMK固件虽然功能强大，但在蓝牙配对和设置管理方面需要特别注意。当遇到分体键盘一侧失效的情况时，系统性的日志分析和正确的重置方法是解决问题的关键。通过本次案例，我们不仅解决了具体问题，也加深了对ZMK固件工作原理的理解。