ZMK固件蓝牙签名错误问题分析与解决

问题现象

近期在ZMK固件项目中，用户报告了一个关于蓝牙连接的严重问题。具体表现为：当使用nice!nano控制器的无线分体键盘（如Corne键盘）时，主控端（通常为左半部分）可以单独正常工作，但当从控端（右半部分）开启后，主控端会立即停止响应，显示屏（如nice!view）也会冻结。

通过USB调试日志可以看到关键错误信息："<bt_att> Error signing data"，这表明在蓝牙通信的数据签名环节出现了问题。该问题首次出现在2024年9月6日（太平洋时间）中午后的构建版本中。

技术背景

ZMK固件是一个专为机械键盘设计的开源固件，特别支持无线分体式键盘。在分体键盘设计中，通常一个半区作为蓝牙主设备（Central），另一个半区作为从设备（Peripheral），两者通过蓝牙低功耗（BLE）协议进行通信。

蓝牙通信中的数据签名是安全机制的一部分，用于验证数据的完整性和真实性。当这个环节出现问题时，设备间的通信就会中断。

问题根源

经过开发者调查，这个问题是由一个与分体键盘功能相关的代码变更引起的。该变更可能破坏了中央控制器代码的向后兼容性，导致在设备间握手过程中无法正确完成数据签名。

值得注意的是：

1. 问题只出现在特定时间后的构建版本中
2. 即使回退到之前能正常工作的代码版本重新构建，问题仍然存在
3. 使用设置重置固件（settings_reset）无法解决问题
4. 问题与Docker容器版本无关

解决方案

项目维护者迅速响应，采取了以下措施：

1. 暂时回退了引起问题的合并请求（PR）
2. 建议用户在问题修复后更新主分支（main）并重新测试

多位用户确认，在回退变更后的构建版本中，问题得到了解决，分体键盘的两半能够正常建立连接并通信。

经验总结

这个案例展示了几个重要的开发实践：

1. 蓝牙协议兼容性：在修改无线通信协议相关代码时，必须特别注意向后兼容性
2. 问题追踪：详细的错误日志（如<bt_att> Error signing data）对于快速定位问题至关重要
3. 社区协作：用户及时反馈问题，开发者快速响应，共同解决了这个影响用户体验的关键问题

对于ZMK固件用户，建议在遇到类似问题时：

1. 检查最新的社区讨论，看是否是已知问题
2. 提供详细的错误日志帮助诊断
3. 关注官方仓库的更新和修复

这个问题的快速解决展现了开源社区的高效协作，也提醒我们在固件开发中需要特别注意无线通信协议的稳定性。