跳到主要内容

旋钮控制说明

增量与绝对角度​

旋钮可连续旋转，没有电位器的机械行程端点。读取值表示累计变化，不能直接当作绝对角度。若需要固定范围的音量或亮度，在应用程序中设置上下限，并决定到边界后是保持还是循环。

先读取旋转变化，更新菜单索引，再读取按压状态确认选择。避免每次循环都把按住状态处理为一次新点击；记录前一次状态，仅在需要的边沿触发操作。

set() 修改软件计数参考，不会让旋钮机械转到指定位置。设备重启后若需恢复业务设置，由主控应用保存该设置，不把编码器当作掉电保存的绝对位置传感器。

读取节奏​

先用低速旋转验证方向和按压，再测试实际操作速度。避免长时间阻塞主循环而错过交互时机；界面刷新与旋钮读取可分别调度。出现计数异常时先核对库版本、通信和采样流程，不自行假设每格固定等于多少角度。

机械安装​

按尺寸图预留轴、旋钮帽、按压行程和连接器空间。固定 PCB 时避免螺钉压住元件；不要将超过设计负荷的机械力传递到编码器和焊点。