ZMK固件中鼠标滚轮编码器配置问题解析

问题背景

在ZMK固件开发过程中，用户从feat/pointers-move-scroll分支切换到feat/pointers-with-input-processors分支后，发现原本正常工作的编码器滚轮功能失效。这个问题涉及到ZMK固件中鼠标指针和滚轮行为的配置方式变化。

关键配置差异分析

在ZMK固件中，鼠标和滚轮行为通过几个关键参数控制：

1. 滚动速度定义时机：ZMK_MOUSE_DEFAULT_SCRL_VAL等宏定义必须出现在包含鼠标头文件之前，因为这些宏会影响头文件中SCRL_DOWN等行为的默认值定义顺序。

2. 行为覆盖机制：在新版本中，直接使用节点名称如mmv或msc进行行为覆盖不再有效。正确的做法是使用&msc {...}语法结构来覆盖默认值。

配置建议

对于想要自定义鼠标滚轮行为的用户，建议采用以下配置方式：

#define ZMK_MOUSE_DEFAULT_SCRL_VAL 100   // 自定义滚动速度值
#include <dt-bindings/zmk/mouse.h>       // 必须在宏定义后包含

/ {
    behaviors {
        // 使用正确的语法覆盖默认值
        &msc {
            acceleration-exponent = <1>;
            time-to-max-speed-ms = <400>;
            delay-ms = <0>;
        };
        
        scroll_encoder: scroll_encoder {
            compatible = "zmk,behavior-sensor-rotate";
            #sensor-binding-cells = <0>;
            bindings = <&msc SCRL_DOWN>, <&msc SCRL_UP>;
            tap-ms = <30>;
        };
    };
};

版本兼容性说明

不同ZMK分支之间可能存在行为参数的缩放比例差异。在旧版本中可能不需要特别调整速度参数就能正常工作，但在新版本中由于数值范围的变化，显式设置这些参数变得必要。

最佳实践

1. 始终将鼠标相关宏定义放在包含相应头文件之前
2. 使用正确的行为覆盖语法结构
3. 在切换分支时，注意检查相关参数的默认值是否发生变化
4. 对于指针设备相关问题，建议在专门的开发讨论渠道交流

通过遵循这些配置原则，可以确保编码器的滚轮功能在不同版本的ZMK固件中都能正常工作。