STM32CubeMX配置通用定时器输入捕获，实测PWM信号频率与占空比（避坑HAL库宏定义错误）
STM32CubeMX实战：通用定时器输入捕获精准测量PWM频率与占空比
在电机控制、传感器信号处理等嵌入式应用中，精确测量PWM信号的频率和占空比是常见需求。本文将深入讲解如何通过STM32的通用定时器输入捕获功能实现这一目标，并分享实际开发中遇到的HAL库宏定义陷阱及解决方案。
1. 硬件基础与原理剖析
STM32的通用定时器（如TIM2-TIM5）具备强大的输入捕获功能，其核心是通过记录边沿触发时刻的计数器值来计算时间间隔。与基本定时器不同，通用定时器每个通道都配有独立的捕获/比较寄存器，能够实现多通道并行测量。
输入捕获工作原理：
- 配置捕获通道为上升沿触发，当边沿到来时：
- 当前计数器值(TIMx_CNT)被锁存到捕获寄存器(CCRx)
- 可触发中断或DMA请求
- 切换为下降沿触发模式，重复上述过程
- 两次捕获值的差值即为脉冲宽度
测量PWM的关键参数计算公式：
频率 = 1 / (上升沿间隔周期) 占空比 = 高电平时间 / 周期 * 100%定时器时钟树配置示例（72MHz主频）：
APB1 prescaler = 2 → PCLK1 = 36MHz TIMxCLK = PCLK1 * 2 = 72MHz 定时器分频(PSC) = 71 → CK_CNT = 1MHz (1μs分辨率) 自动重载值(ARR) = 65535 → 最大测量周期65.535ms2. CubeMX工程配置详解
2.1 时钟与定时器基础配置
- 在Pinout & Configuration界面启用TIMx：
- Clock Source选择Internal Clock
- Channelx选择Input Capture direct mode
- 配置定时器参数：
Prescaler (PSC) = 71 // 72MHz/(71+1)=1MHz Counter Mode = Up Counter Period (ARR) = 65535 auto-reload-preload = Disable - 输入捕获通道设置：
Polarity Selection = Rising Edge IC Selection = Direct Input Filter = 0 // 无滤波
2.2 关键NVIC中断配置
必须使能以下中断：
- TIMx全局中断（用于计数器溢出处理）
- TIMx捕获比较中断（用于边沿检测）
典型配置参数：
TIMx_IRQn PreemptionPriority = 1 SubPriority = 1 Enabled = √3. 代码实现与HAL库陷阱规避
3.1 中断回调函数实现
创建全局变量存储捕获状态：
typedef struct { uint8_t edge_flag; // 0=上升沿,1=下降沿 uint8_t capture_done; // 捕获完成标志 uint16_t overflow_cnt; // 溢出次数 uint32_t rise_val; // 上升沿捕获值 uint32_t fall_val; // 下降沿捕获值 } PWM_CaptureTypeDef; PWM_CaptureTypeDef pwm_capture;定时器溢出中断处理：
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIMx) { if(!pwm_capture.capture_done) { pwm_capture.overflow_cnt++; } } }3.2 输入捕获中断核心逻辑
void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { if(!pwm_capture.edge_flag) { // 上升沿捕获 pwm_capture.rise_val = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); pwm_capture.overflow_cnt = 0; __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); pwm_capture.edge_flag = 1; } else { // 下降沿捕获 pwm_capture.fall_val = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); uint32_t period = (pwm_capture.overflow_cnt << 16) + pwm_capture.fall_val; uint32_t pulse_width = pwm_capture.fall_val - pwm_capture.rise_val; float freq = 1000000.0f / period; // 单位Hz float duty = (float)pulse_width / period * 100; printf("Frequency: %.2fHz, Duty: %.1f%%\r\n", freq, duty); __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); pwm_capture.edge_flag = 0; pwm_capture.capture_done = 1; } } }3.3 HAL库宏定义BUG修复
部分HAL库版本存在TIM_RESET_CAPTUREPOLARITY宏定义错误，需检查stm32f1xx_hal_tim.h：
错误版本：
#define TIM_RESET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__) \ (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC1P | TIM_CCER_CC1NP))) : \ ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC2P | TIM_CCER_CC2NP)) : \ ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC3P)) : \ ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC4P)))修正版本（移除多余括号）：
#define TIM_RESET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__) \ (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC1P | TIM_CCER_CC1NP)) : \ ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC2P | TIM_CCER_CC2NP)) : \ ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC3P)) : \ ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC4P)))4. 实测优化与误差分析
4.1 提高测量精度技巧
时钟源选择：
- 使用外部晶振可获得更稳定的时钟基准
- 启用定时器时钟预分频器自动重载（TIMx_CR1_ARPE）
抗干扰措施：
Input Filter = 0x6 // 适当增加数字滤波 IC Prescaler = DIV4 // 每4个事件触发一次捕获动态范围扩展：
// 根据信号频率自动调整分频系数 if(measured_freq > 10kHz) { htimx.Init.Prescaler = 7; // 9MHz } else { htimx.Init.Prescaler = 71; // 1MHz } HAL_TIM_IC_Init(&htimx);
4.2 典型误差来源及对策
| 误差类型 | 产生原因 | 解决方案 |
|---|---|---|
| 量化误差 | 定时器分辨率限制 | 使用更高主频或32位定时器 |
| 中断延迟 | 中断响应时间 | 改用DMA传输捕获值 |
| 信号抖动 | 输入信号噪声 | 增加数字滤波器 |
| 溢出误差 | 长周期测量 | 启用定时器溢出中断计数 |
实测数据对比（1kHz PWM，50%占空比）：
理论值：1000Hz, 50.00% 未滤波：998-1002Hz波动, 49.8-50.3%波动 滤波后：1000Hz±0.5, 50.0%±0.15. 进阶应用场景
5.1 多通道同步测量
通过配置TIMx的多个输入通道，可同时测量多路PWM信号。关键配置点：
- 使用相同的定时器基准时钟
- 设置TRGO触发输出同步各通道
- 共享溢出计数器
// 通道1配置 sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; sConfigIC.ICSelection = TIM_ICSELECTION_DIRECTTI; HAL_TIM_IC_ConfigChannel(&htimx, &sConfigIC, TIM_CHANNEL_1); // 通道2配置 sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_FALLING; sConfigIC.ICSelection = TIM_ICSELECTION_INDIRECTTI; HAL_TIM_IC_ConfigChannel(&htimx, &sConfigIC, TIM_CHANNEL_2);5.2 结合DMA降低CPU负载
对于高频PWM测量，可使用DMA自动传输捕获值：
配置DMA循环模式：
hdma_timx_ch1.Init.Mode = DMA_CIRCULAR; hdma_timx_ch1.Init.PeriphInc = DMA_PINC_DISABLE; hdma_timx_ch1.Init.MemInc = DMA_MINC_ENABLE;启动DMA捕获：
HAL_TIM_IC_Start_DMA(&htimx, TIM_CHANNEL_1, (uint32_t*)capture_buffer, BUFFER_SIZE);在DMA完成中断中处理数据
6. 调试技巧与常见问题
Q：测量结果不稳定怎么办？
- 检查信号接地是否良好
- 尝试增加输入捕获滤波值
- 确认定时器时钟配置正确
Q：无法触发捕获中断？
- 验证GPIO复用功能是否正确配置
- 检查NVIC中断优先级设置
- 确认
HAL_TIM_IC_Start_IT()被调用
Q：高占空比测量不准？
- 确保定时器ARR值足够大
- 检查溢出中断处理逻辑
- 考虑使用从模式重置计数器
示波器调试建议：
- 先验证输入信号质量
- 测量定时器时钟实际频率
- 检查中断响应时间
通过合理配置STM32CubeMX和优化中断处理逻辑，可以实现±0.1%精度的PWM参数测量。实际项目中，建议根据信号特性动态调整定时器分频系数，在测量范围和分辨率之间取得平衡。