ZMK固件下Corne键盘配对问题分析与解决方案

问题背景

在使用ZMK固件为Corne键盘（搭载nice!nano v2控制器）进行配对时，用户遇到了无法成功配对两个半边的技术问题。从日志分析可以看到，系统反复出现"Security failed"错误（错误代码2），表明蓝牙安全配对过程未能顺利完成。

技术分析

从系统日志中可以观察到几个关键现象：

1. 连接建立但安全验证失败：中央设备能够发现并连接到外围设备（MAC地址E8:AA:6F:FB:E6:5A），但在安全验证阶段失败，错误代码2表示认证失败。

2. 多次重试未果：系统自动进行了多次重连尝试，但每次都在安全验证阶段失败，最终导致连接断开。

3. 外围设备日志异常：外围设备日志显示"Failed to start advertising"错误（错误代码-120），表明广告启动存在问题。

根本原因

这类配对问题通常源于以下原因之一：

1. 蓝牙配对信息残留：之前的配对信息残留在控制器中，导致新的配对过程冲突。

2. 固件不兼容：如果控制器曾经运行过其他固件（如CircuitPython），可能会在闪存中留下不兼容的数据结构。

3. 安全协议不匹配：两端设备的安全参数配置不一致。

解决方案

经过技术验证，以下步骤可有效解决此问题：

1. 完全清除控制器：

   • 使用专用的清除固件（如zmk_clear.uf2）彻底擦除控制器中的所有数据
   • 这一步确保移除所有可能干扰的残留数据

2. 重新刷写固件：

   • 在完全清除后，重新刷写最新的ZMK固件
   • 确保两个半边使用相同版本的固件

3. 配对流程：

   • 先启动中央设备，进入配对模式
   • 再启动外围设备，等待自动配对
   • 避免在配对过程中操作键盘

技术建议

1. 配对失败后的处理：如果遇到配对问题，建议先对两个控制器都执行清除操作，而不仅是一个。

2. 固件选择：确保使用的固件与硬件完全兼容，nice!nano v2需要特定的ZMK配置。

3. 日志分析：遇到问题时，完整记录两边的系统日志有助于快速定位问题根源。

4. 电源管理：配对过程中确保电池电量充足，低电量可能导致配对不稳定。

总结

ZMK固件下的分体式键盘配对问题通常可以通过彻底的控制器重置解决。关键在于确保两个半边都处于干净的初始状态，使用兼容的固件版本，并遵循正确的配对流程。对于曾经运行过其他类型固件的控制器，使用专用清除工具比标准重置方法更为可靠。