用STM32CubeMX和HAL库搞定编码电机测速：从定时器编码器模式到串口打印转速
STM32CubeMX与HAL库实现编码电机测速全流程解析
正交编码器作为电机控制中的关键传感器，其信号处理直接影响闭环系统的稳定性。许多初学者在配置STM32定时器编码器模式时，常因忽略溢出处理或转速计算公式而陷入调试困境。本文将彻底拆解从CubeMX配置到转速计算的每个技术细节，手把手构建可复用的测速模块。
1. 硬件连接与编码器原理
正交编码器通过两个相位差90°的霍尔传感器（A/B相）输出方波信号。当电机旋转时：
- 正转：A相上升沿时B相为高电平
- 反转：A相上升沿时B相为低电平
典型接线方式如下表所示：
| 编码器引脚 | STM32连接建议 | 信号特性 |
|---|---|---|
| A相 | TIMx_CH1 | 需配置为上拉输入 |
| B相 | TIMx_CH2 | 需配置为上拉输入 |
| VCC | 3.3V/5V | 根据编码器规格选择电压 |
| GND | GND | 必须共地 |
注意：部分增量式编码器还提供Z相（零位信号），可用于位置校准，但基础测速可暂不连接。
2. CubeMX关键配置步骤
打开STM32CubeMX新建工程，选择对应型号后进入定时器配置界面：
定时器模式选择
在Parameter Settings选项卡中：- 设置
Combined Channels为Encoder Mode Encoder Mode选择Encoder Mode TI1 and TI2
- 设置
计数器参数配置
Prescaler = 0 // 不分频 Counter Period = 65535 // 16位计数器最大值 Auto-reload = ENABLE // 必须开启自动重装载GPIO设置检查
确认对应通道引脚已自动配置为：GPIO mode：Input pull-upGPIO Pull-up/Pull-down：Pull-up
常见配置错误警示：
- 未开启定时器时钟：在
Clock Configuration中确认对应APB总线时钟已使能 - 引脚冲突：检查TIMx_CH1/CH2是否被其他外设占用
- 未生成中断代码：需在NVIC设置中启用定时器全局中断
3. HAL库中断处理与转速计算
3.1 计数器溢出处理
在stm32fxx_it.c中重写定时器中断回调函数：
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { // 替换为实际使用的定时器 if(__HAL_TIM_IS_TIM_COUNTING_DOWN(&htim)) { overflow_count--; // 向下计数时的溢出处理 } else { overflow_count++; // 向上计数时的溢出处理 } } }3.2 转速计算公式推导
采用固定采样周期法计算转速（单位：RPM）：
转速 = [ (当前计数值 - 上次计数值) + (溢出次数 × 65536) ] × 60 / (编码器线数 × 采样周期)示例代码实现：
#define ENCODER_LINES 1024 // 编码器每转脉冲数 #define SAMPLE_MS 10 // 采样周期(ms) int32_t get_rpm(TIM_HandleTypeDef *htim) { static int32_t last_count = 0; int32_t current_count = (int32_t)__HAL_TIM_GET_COUNTER(htim); int32_t delta = (current_count - last_count) + (overflow_count * 65536); last_count = current_count; overflow_count = 0; return (delta * 60 * 1000) / (ENCODER_LINES * SAMPLE_MS); }4. 串口输出优化与调试技巧
4.1 非阻塞式数据打印
避免在中断中直接调用printf，推荐采用环形缓冲区+DMA传输：
// 在main.c中定义缓冲区 uint8_t uart_buf[128]; int buf_index = 0; void log_rpm(int32_t rpm) { int len = sprintf((char*)&uart_buf[buf_index], "RPM:%d\n", rpm); HAL_UART_Transmit_DMA(&huart1, &uart_buf[buf_index], len); buf_index = (buf_index + len) % sizeof(uart_buf); }4.2 常见问题排查指南
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 计数值始终为0 | 引脚配置错误 | 检查CubeMX中TIMx_CH1/CH2配置 |
| 转速显示跳变 | 未处理计数器溢出 | 完善overflow_count逻辑 |
| 反转时转速显示为正 | 编码器A/B相序接反 | 交换A/B相接线 |
| 低速时测量不准 | 采样周期过长 | 缩短采样时间至5-20ms |
实际调试中发现，当电机转速低于50RPM时，建议采用以下优化公式提高精度：
// 增加浮点运算提高低速精度 float rpm = (delta * 60.0f * 1000.0f) / (ENCODER_LINES * SAMPLE_MS);5. 进阶应用：与PID控制的衔接
完成测速模块后，可轻松接入速度环PID控制。创建转速控制结构体：
typedef struct { int32_t target_rpm; int32_t current_rpm; float kp, ki, kd; float integral; float last_error; } PID_Controller;在main循环中实现简易PID计算：
void update_pid(PID_Controller *pid) { float error = pid->target_rpm - pid->current_rpm; pid->integral += error * SAMPLE_MS / 1000.0f; float output = pid->kp * error + pid->ki * pid->integral + pid->kd * (error - pid->last_error) / (SAMPLE_MS / 1000.0f); pid->last_error = error; __HAL_TIM_SET_COMPARE(&htim_pwm, TIM_CHANNEL_1, (uint32_t)output); }通过CubeMX的图形化配置结合HAL库的中断回调机制，我们构建了鲁棒的编码器测速模块。特别提醒：在电机启停瞬间，建议增加软件滤波（如移动平均）消除机械振动导致的脉冲抖动。