STM32输入捕获测PWM的避坑指南：为什么你的占空比测量总是不准？
调试PWM信号时，输入捕获功能本该是工程师的得力助手，但很多开发者都遇到过这样的困扰：明明按照手册配置了寄存器，测量结果却像抽奖一样不稳定。上周有个做电机控制的朋友向我吐槽，他的占空比读数在45%到55%之间随机跳动，导致闭环控制根本没法用。这背后往往不是代码逻辑问题，而是硬件与软件配置的微妙配合被忽略了。
1. GPIO配置：被低估的第一道门槛
很多人以为输入捕获的精度主要取决于定时器配置，实际上GPIO的工作模式才是第一个坑点。STM32的GPIO输入模式有浮空、上拉、下拉三种常见选择，而PWM信号测量中最容易栽在阻抗匹配这个细节上。
1.1 上拉/下拉电阻的选择艺术
当使用GPIO_Mode_IPU（内部上拉）模式时，上拉电阻通常为40kΩ左右。对于高速PWM信号（>10kHz），这个阻值会与PCB上的寄生电容形成低通滤波器，导致边沿变缓。我曾用示波器抓取过不同配置下的波形：
| 配置模式 | 上升时间(10kHz PWM) | 测量误差 |
|---|---|---|
| 浮空输入 | 85ns | ±0.5% |
| 10kΩ外部上拉 | 120ns | ±1.2% |
| 内部上拉(40kΩ) | 380ns | ±5.8% |
提示：当PWM频率超过50kHz时，建议使用≤5kΩ的外部下拉电阻，并确保信号源有足够驱动能力
1.2 输入滤波器的隐藏代价
TIM_ICFilter参数看似能消除毛刺，实则可能引入更大问题。那个0xF的滤波器值相当于8个时钟周期的延迟，在72MHz时钟下会产生：
// 错误示范：过度滤波导致相位延迟 TIM_ICInitStructure.TIM_ICFilter = 0xF; // 最大滤波值 // 推荐配置：根据实际噪声水平调整 TIM_ICInitStructure.TIM_ICFilter = 0x2; // 2个时钟周期滤波实测发现，当PWM频率为1MHz时，最大滤波设置会导致占空比测量偏差达7%。更合理的做法是用示波器观察实际噪声水平，从0x0开始逐步增加滤波值。
2. 定时器时钟树的精妙平衡
定时器的ARR和PSC参数设置不当，会导致计数器溢出或分辨率不足。有个经典案例：某工程师测量100Hz PWM时直接套用示例代码的72分频，结果发现1%的占空比变化都无法识别。
2.1 分频系数与测量精度的关系
假设系统时钟为72MHz，测量不同频率PWM时的推荐配置：
| PWM频率 | 推荐PSC | 理论分辨率 | 实际可用位 |
|---|---|---|---|
| 100Hz | 720-1 | 0.1% | 10bit |
| 1kHz | 72-1 | 0.1% | 10bit |
| 10kHz | 8-1 | 0.56% | 7bit |
| 100kHz | 0 | 1.39% | 6bit |
// 动态调整预分频的实用代码片段 void TIM_ConfigPrescaler(TIM_TypeDef* TIMx, uint32_t pwm_freq) { uint32_t clock = SystemCoreClock; if(pwm_freq < 1000) { TIMx->PSC = 720 - 1; // 100kHz时基 } else if(pwm_freq < 10000) { TIMx->PSC = 72 - 1; // 1MHz时基 } else { TIMx->PSC = 8 - 1; // 9MHz时基 } TIMx->ARR = 0xFFFF; // 最大周期值 }2.2 自动重载值(ARR)的陷阱
ARR值过小会导致频繁溢出，特别是在PWM输入模式下。有个隐蔽的bug：当ARR值小于PWM周期时，捕获比较寄存器会不断重置，表现为测量值周期性跳变。安全做法是：
// 计算最小ARR值的经验公式 uint32_t min_arr = (SystemCoreClock / TIMx->PSC) / (pwm_freq * 0.1); if(min_arr > 65535) { // 需要增大PSC或使用更高时钟 }3. PWM输入模式的特殊机关
STM32的PWM输入模式虽然方便，但需要两个通道协同工作，这里藏着几个魔鬼细节。
3.1 通道极性必须镜像配置
常见错误是只设置主捕获通道的极性，从通道保持默认。正确的做法应该是：
TIM_ICInitTypeDef TIM_ICInitStructure; // 主通道（周期测量） TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; TIM_ICInit(TIM3, &TIM_ICInitStructure); // 从通道（占空比测量）必须反向 TIM_ICInitStructure.TIM_Channel = TIM_Channel_2; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Falling; TIM_ICInit(TIM3, &TIM_ICInitStructure);3.2 滤波器设置必须一致
两个通道的TIM_ICFilter值不同会导致边沿检测时间偏差，我遇到过因此产生3%的占空比误差。强制同步配置可避免：
TIM_ICInitStructure.TIM_ICFilter = 0x2; // 两个通道必须相同4. 实战调试技巧与验证方法
当测量结果异常时，系统化的排查比盲目改参数更有效。分享几个硬核调试手段：
4.1 交叉验证三件套
- GPIO状态验证：将捕获引脚临时改为输出模式，手动翻转观察波形质量
- 定时器计数验证：在中断中读取CNT值，检查计数是否连续
- 寄存器快照：在捕获中断时记录CCR/ARR/SR寄存器值
void TIM3_IRQHandler(void) { if(TIM_GetITStatus(TIM3, TIM_IT_CC1)) { uint32_t cnt = TIM3->CNT; uint32_t ccr1 = TIM3->CCR1; uint32_t sr = TIM3->SR; // 将关键值通过串口或调试接口输出 TIM_ClearITPendingBit(TIM3, TIM_IT_CC1); } }4.2 示波器触发捕获法
用示波器的双通道同时监测：
- 通道1：原始PWM信号
- 通道2：捕获中断触发信号
通过调整触发沿和时基，可以直观看到捕获事件与实际边沿的时间关系。这个方法帮我发现过一个由PCB布局引起的20ns延迟问题。
4.3 软件补偿算法
对于无法通过硬件消除的误差，可以采用滑动窗口滤波：
#define WINDOW_SIZE 8 uint32_t duty_buffer[WINDOW_SIZE]; uint8_t buffer_index = 0; uint32_t get_smoothed_duty(void) { uint32_t sum = 0; for(uint8_t i=0; i<WINDOW_SIZE; i++) { sum += duty_buffer[i]; } return sum / WINDOW_SIZE; } // 在捕获中断中更新 duty_buffer[buffer_index++] = raw_duty; if(buffer_index >= WINDOW_SIZE) buffer_index = 0;在电机控制项目中，这个简单算法将占空比读数波动从±3%降到了±0.5%。关键是要根据应用场景调整窗口大小——太大导致响应迟滞，太小滤波效果有限。
