STM32电机编码器HAL库实战：从配置到高精度速度测量

1次阅读

共计 2687 个字符，预计需要花费 7 分钟才能阅读完成。

在电机控制系统中，编码器作为关键的速度 / 位置传感器，其数据采集的准确性直接影响闭环控制性能。但实际开发中常遇到：

配置复杂：TIM 编码器模式涉及 GPIO 复用、时钟分配、计数方向等多参数联动
信号抖动：电机运行时电磁干扰导致边沿误触发，产生±1 计数误差
速度跳变：简单脉冲计数法在低速时分辨率不足，高速时易溢出

方案	优点	缺点
TIM 编码器模式	硬件正交解码零 CPU 占用	仅限增量式编码器
外部中断 +GPIO	兼容所有编码器类型	高频脉冲时 CPU 负载高
专用 ASIC 芯片	抗干扰强	增加 BOM 成本

结论：对于 STM32+ 增量编码器的组合，TIM 硬件编码器模式是最优解。

关键配置参数示意图：

flowchart TD
    A[时钟源使能] --> B[GPIO 复用配置]
    B --> C[TIM 参数设置]
    C --> D[编码器模式使能]

具体步骤：

GPIO 初始化（以 TIM3_CH1/CH2 为例）：

// 引脚复用配置
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_6 | GPIO_PIN_7;  // PC6,PC7
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_PULLUP;  // 重要！避免悬空
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF2_TIM3; // 查手册确定 AF 编号
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

定时器基础配置：

TIM_Encoder_InitTypeDef sConfig = {0};
TIM_MasterConfigTypeDef sMasterConfig = {0};

htim3.Instance = TIM3;
htim3.Init.Prescaler = 0;  // 不分频
htim3.Init.CounterMode = TIM_COUNTERMODE_UP;
htim3.Init.Period = 65535;  // 16bit 最大值
htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
htim3.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;

// 编码器特定配置
sConfig.EncoderMode = TIM_ENCODERMODE_TI12;  // 双通道模式
sConfig.IC1Polarity = TIM_ICPOLARITY_RISING;  
sConfig.IC1Selection = TIM_ICSELECTION_DIRECTTI;
sConfig.IC1Prescaler = TIM_ICPSC_DIV1;  // 每个边沿都捕获
sConfig.IC1Filter = 6;  // 推荐值，后文解释
// 通道 2 配置同理...
HAL_TIM_Encoder_Init(&htim3, &sConfig);

基本原理：

速度 = Δ 计数值 / 采样周期

抗溢出处理代码：

int32_t GetEncoderSpeed(TIM_HandleTypeDef *htim, uint32_t sample_ms) {
    static uint16_t last_cnt = 0;
    uint16_t current_cnt = __HAL_TIM_GET_COUNTER(htim);
    int32_t delta = (int32_t)(current_cnt - last_cnt);

    // 处理 16bit 计数器溢出
    if(delta > 32767) delta -= 65536;
    else if(delta < -32768) delta += 65536;

    last_cnt = current_cnt;
    return (delta * 1000) / sample_ms;  // 转换为脉冲 / 秒
}

TIM 的输入捕获滤波器 (ICxFilter) 工作原理：

值 N 表示需要连续 N + 1 个相同采样值才更新输入
计算依据：滤波时间 = (N+1) * Tdts（Tdts=2*TIM_CLK）

推荐值：

/* 对于 1MHz 的 TIM 时钟：* N=6 → 滤波时间 = (6+1)*2us = 14us
 * 可有效滤除 <100kHz 的噪声 */
sConfig.IC1Filter = 6;

移动平均滤波实现：

#define FILTER_WINDOW 5
int32_t speed_buf[FILTER_WINDOW] = {0};

int32_t SmoothSpeed(int32_t raw_speed) {
    static uint8_t idx = 0;
    speed_buf[idx++] = raw_speed;
    if(idx >= FILTER_WINDOW) idx = 0;

    int64_t sum = 0;
    for(uint8_t i=0; i<FILTER_WINDOW; i++) {sum += speed_buf[i];
    }
    return sum / FILTER_WINDOW;
}

现象	可能原因	解决方法
计数值不变化	GPIO 未正确复用	检查 AF 映射表
高速时计数丢失	未开启输入滤波	调整 ICxFilter 参数
正反转方向错误	A/ B 相引脚接反	交换接线或改极性配置

当转速过高导致两次采样间计数变化超过 32768 时：

缩短采样周期（建议≥1ms）
改用 32bit 定时器（如 TIM2/TIM5）

启用定时器溢出中断：

// 在 HAL_TIM_Encoder_Init 后添加：__HAL_TIM_ENABLE_IT(&htim3, TIM_IT_UPDATE);

// 中断回调中记录溢出次数
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {if(htim->Instance == TIM3) {overflow_cnt += (htim->Instance->CR1 & TIM_CR1_DIR) ? -1 : 1;
    }
}

GitHub 仓库包含：
– CubeMX 工程文件
– 带 MISRA- C 检查的 Keil 项目
– 速度测量 + 滤波的完整实现

本方案实测在 10000RPM（1024PPR 编码器）下误差 <±0.5%。扩展到多电机系统时建议：