ZMK固件中旋转编码器配置问题解析与解决方案

问题背景

在使用ZMK固件为Swoop键盘进行配置时，开发者遇到了一个关于旋转编码器(EC11)配置的编译问题。该键盘设计为分体式结构，左右两侧均可选配旋转编码器。当尝试在设备树中启用传感器配置时，编译过程会失败。

问题现象

开发者最初在设备树文件中添加了两个编码器节点(left_encoder和right_encoder)，并尝试通过sensors节点将它们整合到键盘系统中。当sensors节点被注释掉时，配置能够正常编译；但一旦取消注释启用sensors节点，编译就会失败，错误信息显示"SENSOR_CHILD_DEFAULTS未声明"。

问题分析

经过深入排查，发现问题的根源在于设备树中sensors节点的compatible属性存在拼写错误。正确的属性值应为"zmk,keymap-sensors"(使用连字符)，而开发者最初使用了"zmk,keymap_sensors"(使用下划线)。这个细微的差别导致了编译系统无法正确识别和处理传感器配置。

解决方案

1. 修正拼写错误：将compatible属性值改为正确的"zmk,keymap-sensors"

2. 启用必要的配置选项：在配置文件(swoop.conf)中添加以下选项：

   CONFIG_EC11=y
   CONFIG_EC11_TRIGGER_GLOBAL_THREAD=y
   

3. 调整无线传输功率：针对分体键盘通信距离问题，可以增加蓝牙传输功率：

   CONFIG_BT_CTLR_TX_PWR_PLUS_8=y
   

技术要点

1. ZMK中的编码器支持：ZMK固件通过alps,ec11驱动支持EC11型旋转编码器，需要配置A/B相GPIO引脚和分辨率参数。

2. 传感器集成：多个编码器需要通过zmk,keymap-sensors节点统一管理，指定传感器列表和每转触发次数。

3. 分体键盘通信优化：对于分体式键盘设计，无线通信距离和稳定性是关键考虑因素，适当增加发射功率可以改善连接质量。

实施建议

1. 在配置旋转编码器时，务必仔细检查设备树节点的所有属性值，特别是compatible这类关键属性。

2. 对于分体式键盘设计，建议：

   • 优先测试无线连接稳定性
   • 根据实际使用距离调整发射功率
   • 考虑天线布局和屏蔽问题

3. 在功耗敏感场景下，需要平衡通信性能和电池续航时间。

通过以上解决方案，开发者成功解决了编码器配置的编译问题，并改善了分体键盘的无线通信性能。这为类似项目的开发提供了有价值的参考经验。