ZMK固件中解决编码器误触发问题的技术方案

问题背景

在使用ZMK固件为键盘添加鼠标滚轮编码器时，开发者遇到了一个常见但令人困扰的问题：当向一个方向滚动编码器时，系统会错误地同时触发两个方向的信号（0和1）。这种误触发行为会影响用户体验和功能可靠性。

问题分析

编码器的工作原理是通过两个相位差90度的信号（A相和B相）来判断旋转方向。理想情况下：

• 顺时针旋转时，信号变化顺序应为A相先变化，然后B相变化
• 逆时针旋转时，信号变化顺序相反

当出现两个方向信号同时被触发的情况时，通常与以下因素有关：

1. 信号消抖处理不足
2. 分辨率设置不当
3. 物理接触不良
4. 固件配置参数不匹配

解决方案

关键配置参数调整

在ZMK固件中，有两个关键参数需要特别注意：

1. steps参数：定义编码器每转的物理步数
2. triggers-per-rotation参数：定义每转触发的事件数

经过实践验证，以下配置组合可以解决误触发问题：

right_encoder: encoder_right {
    compatible = "alps,ec11";
    a-gpios = <&pro_micro 3 (GPIO_ACTIVE_HIGH | GPIO_PULL_UP)>;
    b-gpios = <&pro_micro 2 (GPIO_ACTIVE_HIGH | GPIO_PULL_UP)>;
    steps = <48>; // 或96
    status = "okay";
};

sensors: sensors {
    compatible = "zmk,keymap-sensors";
    sensors = <&right_encoder>;
    triggers-per-rotation = <24>;
};

参数选择原则

1. 物理步数与触发数的比例：保持2:1或4:1的比例关系

   • 当triggers-per-rotation = <24>时，steps应设为48或96

2. 分辨率匹配：确保固件配置与编码器物理特性匹配

   • EC11编码器常见每转物理步数为12/24/30等
   • 通过适当提高steps值可以提高识别精度

3. 信号稳定性：较高的steps值可以提供更好的噪声过滤

实现原理

这种配置有效的根本原因在于：

1. 采样密度增加：提高steps值相当于增加了采样点，使固件能更准确地识别旋转方向
2. 滤波效果增强：更多的采样点可以平滑掉接触抖动带来的噪声
3. 事件触发同步：保持steps与triggers-per-rotation的整数倍关系，确保事件触发时机准确

实践建议

1. 对于EC11编码器，建议从以下配置开始测试：

   • steps = 48
   • triggers-per-rotation = 24

2. 如果仍有误触发，可以尝试：

   • 进一步提高steps值（如96）
   • 检查硬件连接是否牢固
   • 确保GPIO引脚配置了上拉电阻

3. 对于不同型号编码器，需要根据其规格书调整参数：

   • 每转物理步数
   • 信号电气特性
   • 机械结构特点

总结

通过合理配置ZMK固件中的编码器参数，特别是steps和triggers-per-rotation的比值关系，可以有效解决编码器误触发问题。这一解决方案不仅适用于鼠标滚轮编码器，也适用于其他旋转编码器的应用场景。开发者应根据具体硬件特性，通过实验找到最优参数组合，以获得稳定可靠的编码器输入体验。