STM32定时器输入捕获实战：从HAL库配置到精准脉宽与频率测量

1. STM32定时器输入捕获功能入门指南

第一次接触STM32的定时器输入捕获功能时，我完全被各种专业术语搞晕了。什么上升沿下降沿、捕获寄存器、计数器溢出...听起来就像天书一样。但当我真正理解了它的工作原理后，才发现这个功能简直是为测量脉冲信号量身定做的神器。

简单来说，输入捕获就是定时器的"抓拍"功能。当检测到指定边沿（上升沿或下降沿）时，它会立即把当前计数器的值"拍照"保存到捕获寄存器中。通过比较两次捕获的数值差，我们就能精确计算出脉冲的宽度或周期。这就像用秒表记录运动员的跑步时间一样，只不过STM32的"秒表"精度可以达到纳秒级。

在实际项目中，这个功能最常见的应用场景包括：

• 测量PWM信号的占空比
• 计算外部信号的频率
• 检测按键按下的持续时间
• 解码红外遥控信号

2. 硬件配置与初始化详解

2.1 GPIO配置要点

配置输入捕获的第一步是设置正确的GPIO模式。这里有个坑我踩过好几次：如果测量高电平脉宽，GPIO必须配置为下拉输入；反之则要配置为上拉输入。这是因为STM32的输入捕获功能对信号质量非常敏感，不正确的上下拉配置会导致误触发。

以测量高电平脉宽为例，正确的配置应该是：

GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_0; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLDOWN; // 关键配置 HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

2.2 定时器基础配置

定时器的时钟配置直接影响测量精度。假设使用72MHz的系统时钟，经过72分频后得到1MHz的计数频率（即每个计数代表1微秒）。自动重装载值设为65535（16位定时器的最大值），这样单次最大可测量65.535ms的脉宽。

配置示例：

TIM_HandleTypeDef htim2; htim2.Instance = TIM2; htim2.Init.Prescaler = 71; // 72MHz/(71+1)=1MHz htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 65535; htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_Base_Init(&htim2);

3. HAL库输入捕获配置实战

3.1 输入捕获参数详解

HAL库使用TIM_IC_InitTypeDef结构体配置输入捕获参数，几个关键参数需要特别注意：

• ICPolarity：触发边沿选择，TIM_INPUTCHANNELPOLARITY_RISING为上升沿，TIM_INPUTCHANNELPOLARITY_FALLING为下降沿
• ICSelection：输入映射方式，通常选择TIM_ICSELECTION_DIRECTTI（直接映射）
• ICPrescaler：输入分频，一般保持TIM_ICPSC_DIV1（不分频）
• ICFilter：数字滤波器，可设置为0-15，值越大抗干扰能力越强但响应越慢

完整配置示例：

TIM_IC_InitTypeDef sConfigIC; sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; sConfigIC.ICSelection = TIM_ICSELECTION_DIRECTTI; sConfigIC.ICPrescaler = TIM_ICPSC_DIV1; sConfigIC.ICFilter = 0; HAL_TIM_IC_ConfigChannel(&htim2, &sConfigIC, TIM_CHANNEL_1);

3.2 中断配置技巧

输入捕获需要开启两个中断：捕获中断和更新中断。前者处理边沿触发事件，后者处理计数器溢出。在HAL库中，只需调用以下函数：

HAL_TIM_IC_Start_IT(&htim2, TIM_CHANNEL_1); // 启动捕获中断 HAL_TIM_Base_Start_IT(&htim2); // 启动更新中断

在CubeMX中配置时，记得勾选这两个中断，并设置合适的中断优先级。我的经验是给捕获中断更高的优先级，因为它的实时性要求更高。

4. 中断服务程序与数据处理

4.1 状态机设计思路

处理输入捕获中断最可靠的方法是使用状态机。我通常定义三个状态：

1. 等待第一个上升沿
2. 等待下降沿
3. 等待第二个上升沿（用于频率测量）

对应的标志位结构体如下：

typedef struct { uint8_t edge_state; // 当前边沿状态 uint16_t rise_value; // 上升沿捕获值 uint16_t fall_value; // 下降沿捕获值 uint16_t overflow_count; // 溢出次数 } IC_HandleTypeDef;

4.2 完整中断处理示例

在HAL库中，我们需要重写两个回调函数：

// 定时器溢出回调 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM2) { icHandle.overflow_count++; } } // 输入捕获回调 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM2) { switch(icHandle.edge_state) { case 0: // 等待上升沿 icHandle.rise_value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); icHandle.overflow_count = 0; // 切换为下降沿捕获 sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_FALLING; HAL_TIM_IC_ConfigChannel(htim, &sConfigIC, TIM_CHANNEL_1); icHandle.edge_state = 1; break; case 1: // 等待下降沿 icHandle.fall_value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 切换回上升沿捕获 sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; HAL_TIM_IC_ConfigChannel(htim, &sConfigIC, TIM_CHANNEL_1); icHandle.edge_state = 0; // 计算脉宽 CalculatePulseWidth(); break; } } }

5. 测量结果计算与误差处理

5.1 脉宽计算算法

考虑计数器溢出的情况，完整的脉宽计算公式为：

脉宽 = (溢出次数 × 定时周期) + (下降沿值 - 上升沿值)

转换为代码：

uint32_t CalculatePulseWidth(void) { uint32_t pulse_width = 0; if(icHandle.fall_value >= icHandle.rise_value) { pulse_width = icHandle.overflow_count * 65536 + (icHandle.fall_value - icHandle.rise_value); } else { pulse_width = (icHandle.overflow_count - 1) * 65536 + (65536 - icHandle.rise_value + icHandle.fall_value); } return pulse_width; // 返回单位为定时器时钟周期 }

5.2 频率测量实现

频率测量需要捕获两个上升沿，然后计算时间差：

uint32_t CalculateFrequency(void) { uint32_t period = 0; if(second_rise_value >= first_rise_value) { period = overflow_between_edges * 65536 + (second_rise_value - first_rise_value); } else { period = (overflow_between_edges - 1) * 65536 + (65536 - first_rise_value + second_rise_value); } return SystemCoreClock / (prescaler + 1) / period; // 返回Hz为单位的频率 }

5.3 精度提升技巧

通过实测发现，以下几个方法可以显著提高测量精度：

1. 使用更高的定时器时钟频率（如使用APB总线时钟而非系统时钟）
2. 适当增加数字滤波值（ICFilter）消除毛刺
3. 多次测量取平均值
4. 在信号进入GPIO前添加硬件滤波电路

6. 常见问题排查指南

6.1 捕获不到中断

遇到这种情况，建议按以下步骤排查：

1. 确认GPIO模式配置正确（输入模式+正确上下拉）
2. 检查定时器时钟是否使能
3. 验证中断优先级配置
4. 使用逻辑分析仪检查信号是否真的到达GPIO引脚

6.2 测量结果不稳定

测量值跳动通常由以下原因导致：

• 信号本身有抖动（添加硬件滤波）
• 中断处理时间过长（优化代码或提高优先级）
• 定时器配置不当（调整预分频值）

6.3 长脉宽测量不准确

当脉宽超过定时器最大周期时，必须正确处理溢出中断。常见错误包括：

• 未清零溢出计数器
• 在中断中未及时清除标志位
• 计算时未考虑溢出情况

7. 进阶应用与优化建议

7.1 PWM输入模式

STM32的高级定时器支持PWM输入模式，可以自动测量周期和占空比。配置方法：

TIM_IC_InitTypeDef sConfigIC; sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; sConfigIC.ICSelection = TIM_ICSELECTION_INDIRECTTI; // 关键区别 sConfigIC.ICPrescaler = TIM_ICPSC_DIV1; sConfigIC.ICFilter = 0; HAL_TIM_IC_ConfigChannel(&htim2, &sConfigIC, TIM_CHANNEL_2); // 从通道 HAL_TIM_PWM_Init(&htim2, TIM_CHANNEL_1); // 主通道

7.2 使用DMA降低CPU负载

对于高频信号测量，可以使用DMA直接将捕获值传输到内存：

HAL_TIM_IC_Start_DMA(&htim2, TIM_CHANNEL_1, (uint32_t*)&captureBuffer, CAPTURE_BUFFER_SIZE);

7.3 低功耗优化技巧

在电池供电应用中：

1. 仅在需要测量时使能定时器
2. 使用LPTIM（低功耗定时器）
3. 适当降低定时器时钟频率
4. 利用唤醒中断模式