STM32cubeMx实战指南：定时器输入捕获测量信号频率与脉宽

1. 定时器输入捕获功能入门指南第一次接触STM32的定时器输入捕获功能时我完全被各种专业术语搞晕了。后来在实际项目中反复折腾才发现这其实就是个电子秒表功能。想象一下你拿着秒表测量运动员跑完100米的时间 - 输入捕获的工作原理跟这个特别像只不过它是用硬件自动完成时间测量。在电机控制项目中我经常需要测量编码器信号的频率和脉宽。传统方法是用外部中断配合软件计时但精度差且占用CPU资源。后来改用定时器输入捕获后测量精度直接从毫秒级提升到微秒级CPU占用率也大幅降低。这就是为什么输入捕获功能在嵌入式开发中如此重要。输入捕获的核心原理其实很简单当检测到信号边沿上升沿或下降沿时定时器会立即冻结当前计数值并产生中断。通过记录两次边沿触发时的计数值差就能计算出信号的时间参数。比如测量周期就是两个上升沿之间的时间差测量脉宽则是一个上升沿和下一个下降沿之间的时间差。2. CubeMX配置实战步骤2.1 定时器基础配置打开CubeMX新建工程后我习惯先配置时钟树。以STM32F103为例APB2总线时钟设为72MHz时定时器时钟也是72MHz因为APB预分频器不为1时定时器时钟会倍频。这个细节很重要后续计算时间参数都需要参考此时钟频率。选择TIM1高级定时器或TIM2~4通用定时器后关键配置参数有时钟源Internal Clock内部时钟预分频器(Prescaler)71将72MHz分频为1MHz每个计数周期1us计数模式Up向上计数自动重装载值(AutoReload)6553516位定时器最大值重复计数器0高级定时器特有提示预分频值时钟频率/目标频率-1。比如要1MHz计数频率72MHz时钟下预分频值72-1712.2 输入捕获通道设置在TIM1的Channel1配置中选择Input Capture direct mode极性选择根据需求定测量周期Rising Edge上升沿测量脉宽需要同时检测上升沿和下降沿输入分频(ICPrescaler)不分频每次边沿都触发滤波器(ICFilter)根据信号质量设置噪声大时可适当增加我曾在电机测速项目中发现编码器信号有毛刺导致误触发。后来将滤波器设为68个事件滤波就稳定了但会引入约0.5us的延迟需要在校准时考虑这个偏移量。3. 中断与代码实现3.1 中断配置要点在NVIC设置中需要开启两个中断捕获中断TIMx_CC_IRQn处理边沿检测事件更新中断TIMx_UP_IRQn处理计数器溢出优先级设置建议捕获中断设为高优先级抢占优先级0更新中断设为低优先级抢占优先级1曾经因为优先级设置不当我在测量高频信号时频繁丢失捕获事件。后来把捕获中断优先级调高后问题解决这是因为更新中断处理不及时只会影响测量范围而丢失捕获事件会直接导致测量失败。3.2 核心代码解析首先定义必要的全局变量volatile uint8_t g_captureFlag 0; // 捕获完成标志 volatile uint16_t g_captureVal 0; // 捕获值 volatile uint16_t g_overflowCnt 0; // 溢出次数捕获中断回调函数实现void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim-Instance TIM1) { if(g_captureFlag 0) { g_captureVal HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_captureFlag 1; // 设置完成标志 TIM1-CNT 0; // 重置计数器 g_overflowCnt 0; // 重置溢出计数 } } }更新中断处理溢出计数void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim-Instance TIM1) { if(g_captureFlag 0) { // 只在测量过程中计数 g_overflowCnt; } } }主函数中的测量逻辑HAL_TIM_IC_Start_IT(htim1, TIM_CHANNEL_1); // 启动捕获中断 __HAL_TIM_ENABLE_IT(htim1, TIM_IT_UPDATE); // 启动更新中断 while(1) { if(g_captureFlag) { uint32_t period g_overflowCnt * 65536 g_captureVal; // 计算总周期(us) float freq 1000000.0 / period; // 计算频率(Hz) printf(Frequency: %.2f Hz\n, freq); g_captureFlag 0; // 准备下次测量 } }4. 脉宽测量进阶技巧4.1 双边沿检测实现测量PWM占空比需要同时捕获上升沿和下降沿。在CubeMX中配置为上升沿触发后代码中需要动态切换极性void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { static uint32_t riseTime 0; if(htim-Instance TIM1) { if(TIM1-CCER TIM_CCER_CC1P) { // 当前是下降沿触发 uint32_t fallTime HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); uint32_t pulseWidth fallTime - riseTime; // 计算脉宽 printf(Pulse width: %d us\n, pulseWidth); TIM1-CCER ~TIM_CCER_CC1P; // 切换回上升沿检测 } else { // 当前是上升沿触发 riseTime HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); TIM1-CCER | TIM_CCER_CC1P; // 切换为下降沿检测 } } }4.2 高精度测量优化要提高测量精度可以采用以下方法使用更高时钟频率如将APB2时钟设为最大减少预分频值但会缩短测量范围使用定时器的输入捕获预分频功能ICPrescaler多次测量取平均值在激光测距项目中我通过将定时器时钟提升到144MHz超频使用配合2分频实现了10ns级的时间分辨率。不过要注意超频使用可能会影响系统稳定性需要充分测试。5. 常见问题排查指南5.1 捕获不到信号的问题遇到信号无法触发捕获时建议按以下步骤排查确认GPIO引脚配置正确复用功能模式检查信号是否确实到达引脚用示波器观察验证定时器时钟是否使能__HAL_RCC_TIM1_CLK_ENABLE检查中断优先级是否冲突确认信号边沿与配置一致上升沿/下降沿曾经有个bug困扰了我两天 - 明明配置正确却无法触发中断。最后发现是CubeMX生成的代码中漏掉了GPIO时钟使能语句。现在我会在生成代码后第一时间检查所有相关外设的时钟使能情况。5.2 测量值不稳定的处理信号抖动是常见问题可以通过以下方式改善增加输入滤波器CubeMX中的ICFilter参数硬件上添加RC滤波电路软件上采用中值滤波算法适当降低输入信号幅度避免过冲在工业现场使用RS485通信时线路干扰导致脉宽测量波动很大。后来我在硬件上增加了TVS二极管和100Ω终端电阻软件上采用滑动窗口滤波取5次测量中间值最终将测量误差控制在0.1%以内。