STM32CubeMX配置编码器模式后为何CNT不计数？

Question

STM32CubeMX配置编码器模式后CNT不计数，是初学者高频踩坑问题。常见原因包括：① 编码器输入引脚（如TIM2_CH1/CH2）未正确映射到硬件对应通道，或GPIO模式未设为“AF_PP”；② 时钟未使能——除TIMx时钟外，还需确认GPIO端口时钟已开启；③ TIMx主从模式配置错误，如未禁用SMS（Slave Mode）或未设为“Encoder Mode”（需在CubeMX中勾选“Encoder Interface”并选择TI1/TI2或TI1+TI2）；④ 编码器信号无有效边沿——实测发现A/B相接反、悬空、无上拉/下拉或信号幅值不足（尤其使用开漏输出编码器时）；⑤ 初始化后未清除CNT寄存器或未启动计数（HAL_TIM_Encoder_Start()未调用）。建议用逻辑分析仪抓波形验证A/B相正交性，并检查HAL_StatusTypeDef返回值确认启动成功。

Answer 1

```html

一、现象层：CNT寄存器恒为0——最表层的故障表征

初学者常在调试时发现：调用HAL_TIM_ReadEncoder(&htim2, TIM_CHANNEL_1)始终返回0，或直接读取__HAL_TIM_GET_COUNTER(&htim2)亦无变化。此非软件逻辑错误，而是底层硬件交互未建立的明确信号。该现象是“编码器模式失效”的最终输出表现，但绝非根因——它像仪表盘上的故障灯，提示系统某处已断链。

二、配置层：CubeMX图形化配置的隐性陷阱

• 引脚复用冲突：TIM2_CH1（如PA0）与TIM2_CH2（如PA1）必须同时配置为GPIO_MODE_AF_PP，且AF功能号需严格匹配数据手册（如STM32F407中TIM2对应AF1）；若误设为GPIO_MODE_INPUT或GPIO_MODE_OUTPUT_PP，硬件无法触发输入捕获边沿。
• 时钟使能遗漏：CubeMX虽自动勾选RCC → TIM2CLK，但常忽略RCC → GPIOA clock（以PA0/PA1为例），导致AF功能物理失能——这是5年以上工程师也偶发的手动疏漏点。
• 编码器接口启用错位：必须在TIM2 → Parameter Settings → Encoder Interface中显式勾选并选择TI1 + TI2（推荐），而非仅在Channel1/Channel2中设置输入模式。

三、寄存器层：HAL库初始化背后的硬件映射真相

HAL库生成的MX_TIM2_Encoder_Init()函数会执行以下关键操作：

// 关键寄存器写入序列（摘自stm32f4xx_hal_tim.c）
htim->Instance->SMCR = TIM_SMCR_SMS_1 | TIM_SMCR_SMS_2; // SMS=0b011 → 编码器模式
htim->Instance->CCMR1 = TIM_CCMR1_CC1S_0 | TIM_CCMR1_CC2S_0; // TI1/TI2作为输入源
htim->Instance->CCER = TIM_CCER_CC1P | TIM_CCER_CC2P; // 极性：默认下降沿有效（可配）
htim->Instance->ARR = 0xFFFF; // 自动重装载值决定计数范围

若手动修改过htim.Instance或未调用HAL_TIM_Encoder_Start(&htim2, TIM_CHANNEL_ALL)，则CCER和CR1.CEN位不会置位，CNT永久冻结。

四、信号链层：从MCU引脚到物理世界的全路径验证

验证环节	典型问题	检测工具
A/B相接线极性	CH1接B相、CH2接A相 → 计数反向或锁死	万用表通断档 + 编码器手册
上拉/下拉配置	开漏编码器未外接4.7kΩ上拉 → 信号幅值＜1.5V，MCU无法识别	示波器DC耦合测量
正交性质量	A/B相边沿偏移＞50%周期 → 丢脉冲或误计数	逻辑分析仪（推荐Saleae Logic Pro 16）

五、诊断流程层：结构化排障决策树

graph TD
  A[Cnt==0?] --> B{GPIO时钟使能?}
  B -->|否| C[使能RCC→GPIOx]
  B -->|是| D{TIMx时钟使能?}
  D -->|否| E[使能RCC→TIMx]
  D -->|是| F{HAL_TIM_Encoder_Start成功?}
  F -->|HAL_ERROR| G[检查HAL_StatusTypeDef返回值]
  F -->|HAL_OK| H{逻辑分析仪见A/B边沿?}
  H -->|否| I[查接线/电源/上拉]
  H -->|是| J[确认TI1+TI2相位差90°±20°]

六、进阶避坑：资深工程师的实战经验沉淀

• ARR值陷阱：若设置htim2.Init.Period = 0，部分F4系列芯片在编码器模式下会触发硬件异常（CNT溢出锁定），务必设为非零值（如65535）；
• 中断干扰：若同时启用Encoder + Update Interrupt，需确保NVIC_SetPriority(TIM2_IRQn, 5)优先级高于其他可能抢占的中断；
• 低功耗场景：STOP模式下TIM2时钟被关闭，需改用LPTIM或配置WKUP引脚唤醒——此点常被工业控制项目忽略；
• HAL库版本差异：STM32Cube_FW_F4_V1.26.0起，HAL_TIM_Encoder_Start()内部增加__HAL_TIM_ENABLE_IT(&htim, TIM_IT_UPDATE)调用，旧版需手动补全。

七、验证闭环：不可绕过的黄金三步法

1. 波形捕获：用逻辑分析仪同步抓取PA0（A）、PA1（B）、PA2（触发线）三路信号，验证90°相位关系及边沿陡峭度（上升时间＜1μs）；
2. 寄存器快照：在main()中插入调试语句：printf("CNT=%d, CNTDIR=%d, SR=%08X\n", __HAL_TIM_GET_COUNTER(&htim2), __HAL_TIM_IS_TIM_COUNTING_DOWN(&htim2), htim2.Instance->SR);；
3. 硬件注入测试：短接PA0→PA1（模拟A相脉冲），观察CNT是否单向递增——排除编码器本体故障。

```