Encoder Mode是微控制器硬件提供的正交解码模式，通过定时器直接对A/B相正交信号进行四倍频计数与方向判别，全程无需CPU干预；而普通GPIO中断需软件实现状态机，易漏脉冲、方向误判、受抖动干扰。
Encoder Mode 是什么，和普通 GPIO 中断有啥区别
Encoder Mode 不是 C++ 语言特性，而是微控制器（比如 STM32、RP2040、ESP32）硬件外设提供的专用计数模式。它直接在芯片底层对 A/B 相正交信号做状态机解码，自动识别方向、过滤抖动、累加计数，全程不依赖 CPU 中断——这意味着即使主频很低或中断被屏蔽，计数也不会丢。
用普通 GPIO + 外部中断模拟正交解码，容易漏脉冲、方向判错、受干扰抖动影响大；而启用 Encoder Mode 后，TIMx（如 TIM2、TIM3）会把两个引脚配成编码器接口，硬件自动完成四倍频计数（AB 相每周期产生 4 个边沿）。
STM32 HAL 库下怎么配置 TIMx 为 Encoder Mode
以 STM32F407 + HAL 库为例，关键不是写 C++ 类，而是正确初始化定时器的编码器接口。HAL 提供了封装好的函数，但必须注意引脚复用、时钟使能、输入滤波等细节。
-
__HAL_RCC_TIM2_CLK_ENABLE()必须在MX_TIM2_Init()前调用，否则寄存器写不进去 - A/B 相引脚需配置为
AF_PP（复用推挽），且复用功能号必须匹配对应 TIM 的编码器通道（查 Reference Manual 表 128） -
htim2.Init.CounterMode = TIM_COUNTERMODE_UP要设为UP，Encoder Mode 下该字段实际被忽略，但 HAL 检查非空，填错会初始化失败 -
htim2.EncoderInterfaceConfig.IC1PSC和IC2PSC建议设为0（不分频），滤波用IC1Filter/IC2Filter（推荐 6–10 个系统时钟周期）抗干扰
初始化后，计数值存在 __HAL_TIM_GET_COUNTER(&htim2)，但注意：该值是有符号的 16 位（TIM2 是 16 位定时器），溢出后会翻转。若需长期累计，得在应用层记录上一次读值并判断方向后做补偿。
读取计数值时为什么总卡在 0 或跳变异常
常见原因不是代码逻辑错，而是硬件或配置没对齐。尤其容易踩的坑：
- A/B 相接反了（比如 PA0 接 B 相、PA1 接 A 相），会导致方向恒反，手动旋转时
__HAL_TIM_GET_COUNTER()只减不增 - 没开启定时器主从模式控制位：
__HAL_TIM_ENABLE(&htim2)必须调用，仅初始化不启动外设，寄存器值永远为 0 - 忘记清除初始计数：
__HAL_TIM_SET_COUNTER(&htim2, 0)最好在启动前调一次，避免上电残留值干扰 - 使用
HAL_TIM_Encoder_Start()启动后，不能再调HAL_TIM_Base_Start()，否则工作模式冲突，计数停滞 - 示波器确认 A/B 相有稳定方波且相位差 90°；若只有单相有信号，说明另一路断线或上拉没接好（多数编码器需外接 4.7kΩ 上拉）
怎么安全读取并转换成物理位移（毫米/角度）
Encoder Mode 输出的是原始脉冲计数，要转物理量，必须结合编码器分辨率和机械传动比。例如：1000 线编码器（即每圈 A 或 B 相输出 1000 个脉冲），四倍频后每圈 4000 计数；若连接 5:1 减速齿轮，则电机转 5 圈，轴才转 1 圈——此时每计数 1 单位对应的角度是 360.0f / (1000 * 4 * 5) 度。
实操建议：
- 用
volatile int32_t存储上次读值，每次读取后用int32_t delta = current - last;计算增量，再更新last = current;，避免 16 位翻转导致大负数误判 - 不要在中断里做浮点运算或串口打印；把原始计数送入环形缓冲区，主循环中批量处理
- 如果需要绝对位置，得外加霍尔/光电开关做零点校准，Encoder Mode 本身只提供相对计数
硬件级正交计数本身很可靠，但“读出来”和“用对”之间，差的是引脚定义、时钟树配置、溢出处理这三步。少一个，数据就静默失效，而不是报错提醒。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
