用STM32F103的TIM3捕获PWM信号：从PA6引脚读取方波频率和占空比的保姆级教程
STM32F103实战：用TIM3精准捕获PWM信号的5个关键步骤与避坑指南
当你第一次尝试用STM32测量外部PWM信号时，是否遇到过这些困扰：明明接线正确却读不到数据？测量结果跳动严重？或是占空比计算总出现偏差？作为嵌入式开发者必备的基础技能，PWM输入捕获远不止复制粘贴代码那么简单。本文将用一块STM32F103开发板（兼容野火指南者），带你从硬件连接到代码调试，完整实现PA6引脚的方波频率与占空比测量，重点解决那些教程里没告诉你的实战细节。
1. 硬件准备：别在第一步就埋下隐患
在打开CubeMX之前，正确的硬件连接决定了项目50%的成功率。许多初学者往往忽视了这个环节，导致后续调试困难重重。
必备器材清单：
- STM32F103开发板（如野火指南者）
- 信号发生器（或另一块产生PWM的MCU）
- 示波器（用于交叉验证，非必须但强烈推荐）
- 杜邦线若干
关键连接要点：
- 共地原则：将信号发生器的GND与开发板的GND用杜邦线直接相连，这是大多数测量异常的根本原因。
- 信号接入：PWM信号输出端连接PA6（TIM3_CH1），避免使用过长导线（超过20cm可能引入干扰）。
- 电压匹配：确认信号幅值在3.3V范围内，若来自5V设备需添加电平转换电路。
提示：当没有信号发生器时，可以用另一个定时器（如TIM2）产生测试PWM，但要注意两个定时器的时钟配置必须一致。
常见问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无数据 | 未共地 | 检查GND连接 |
| 数值跳变 | 信号干扰 | 缩短导线，添加10kΩ上拉 |
| 读数错误 | 时钟配置错误 | 确认SystemCoreClock值 |
2. 工程配置：CubeMX的隐藏选项解析
使用STM32CubeMX可以大幅减少底层配置时间，但这些设置项背后的含义值得深究。
关键配置步骤：
- 在Pinout界面中启用TIM3，自动配置PA6为输入模式
- 时钟树配置确保APB1 Timer Clocks为72MHz（默认值）
- 在TIM3参数设置中：
- Clock Source: Internal Clock
- Channel1: Input Capture direct mode
- PWM Input Mode: Disable（需手动配置）
// 生成的初始化代码片段（重点关注部分） htim3.Instance = TIM3; htim3.Init.Prescaler = 0; htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 0xFFFF; htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_IC_Init(&htim3); TIM_IC_ConfigTypeDef sConfigIC; sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; sConfigIC.ICSelection = TIM_ICSELECTION_DIRECTTI; sConfigIC.ICPrescaler = TIM_ICPSC_DIV1; sConfigIC.ICFilter = 0; HAL_TIM_IC_ConfigChannel(&htim3, &sConfigIC, TIM_CHANNEL_1);容易被忽略的参数：
- ICFilter：设置输入滤波（0-15），可有效抑制毛刺，但会增加延迟。对于1kHz以下信号建议设为4-6。
- ClockDivision：保持DIV1除非需要降低采样率，误设会导致计数错误。
- Period：设置为最大（0xFFFF）以获得最宽测量范围。
3. 中断处理：精准计数的核心逻辑
输入捕获的精髓在于中断回调中的时间计算，这里藏着几个影响精度的关键细节。
改进的中断服务例程：
volatile uint32_t IC_Val1, IC_Val2, DutyCycle, Frequency; volatile uint8_t capture_count = 0; void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { if(capture_count == 0) { IC_Val1 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); capture_count = 1; } else if(capture_count == 1) { IC_Val2 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); uint32_t diff = (IC_Val2 > IC_Val1) ? (IC_Val2 - IC_Val1) : (0xFFFF - IC_Val1 + IC_Val2); DutyCycle = (diff * 100) / htim->Instance->ARR; Frequency = SystemCoreClock / htim->Instance->ARR; capture_count = 0; } } } }代码关键点解析：
- 边沿切换：动态改变捕获极性（上升沿/下降沿）实现单通道测量
- 计数器溢出处理：通过差值计算解决计数器回绕问题
- ARR的使用：自动重装载值参与计算提高精度
实测对比：使用双通道（标准PWM输入模式）与单通道+极性切换的测量结果差异：
| 方法 | 优点 | 缺点 |
|---|---|---|
| 标准PWM输入 | 硬件自动完成 | 占用两个捕获通道 |
| 单通道+极性切换 | 节省资源 | 需要更复杂的中断处理 |
4. 调试技巧：串口输出的进阶用法
简单的printf输出可能掩盖了真实问题，这些调试方法能帮你快速定位异常。
增强型调试代码：
void Debug_Output(void) { char buffer[100]; sprintf(buffer, "Rise@%lu | Fall@%lu | Duty:%lu%% | Freq:%luHz\r\n", IC_Val1, IC_Val2, DutyCycle, Frequency); HAL_UART_Transmit(&huart1, (uint8_t*)buffer, strlen(buffer), HAL_MAX_DELAY); // 原始数据十六进制输出（用于深度调试） sprintf(buffer, "TIM3->CNT:0x%04X | CCR1:0x%04X\r\n", TIM3->CNT, TIM3->CCR1); HAL_UART_Transmit(&huart1, (uint8_t*)buffer, strlen(buffer), HAL_MAX_DELAY); }典型调试场景应对：
数值跳变严重
- 检查信号质量（最好用示波器观察）
- 适当增加ICFilter值
- 在PA6添加100nF电容滤波
频率计算误差大
- 确认SystemCoreClock实际值（可能因时钟配置不同）
- 检查APB1预分频系数（不应分频）
无中断触发
- 用万用表测量PA6电压
- 检查NVIC优先级设置
- 验证TIM3时钟是否使能
5. 性能优化：从能用走向好用
基础功能实现后，这些技巧能让你的测量更加稳定可靠。
软件滤波算法示例：
#define SAMPLE_SIZE 5 uint32_t freq_buffer[SAMPLE_SIZE], duty_buffer[SAMPLE_SIZE]; void Moving_Average_Filter(void) { static uint8_t index = 0; freq_buffer[index] = Frequency; duty_buffer[index] = DutyCycle; index = (index + 1) % SAMPLE_SIZE; uint32_t freq_sum = 0, duty_sum = 0; for(int i=0; i<SAMPLE_SIZE; i++) { freq_sum += freq_buffer[i]; duty_sum += duty_buffer[i]; } uint32_t filtered_freq = freq_sum / SAMPLE_SIZE; uint32_t filtered_duty = duty_sum / SAMPLE_SIZE; }进阶优化策略：
- 动态调整测量模式：根据频率自动切换分频系数
if(Frequency < 1000) { htim3.Init.Prescaler = 71; // 1MHz计数时钟 } else { htim3.Init.Prescaler = 0; // 72MHz计数时钟 } HAL_TIM_IC_Init(&htim3); - 硬件优化：在信号输入端添加施密特触发器（如74HC14）整形
- 看门狗集成：防止异常信号导致程序锁死
在实际项目中，我发现最影响测量稳定性的往往是电源质量——当使用USB供电时，接地环路引入的噪声会导致测量值周期性波动。改用电池供电或添加电源滤波器后，测量一致性明显提升。另一个容易忽略的细节是杜邦线的质量，劣质线材的接触电阻会导致信号边沿变缓，建议选用镀金接头的专业跳线。