当前位置：首页 > news >正文

保姆级教程：用STM32F103的HAL库和CubeMX，5分钟搞定PWM频率占空比测量（附串口打印代码）

news 2026/7/5 17:43:59

STM32F103实战指南：5分钟实现PWM精准测量与串口可视化

最近在调试舵机控制时，发现很多初学者对PWM信号的测量感到困惑。其实用STM32F103的定时器输入捕获功能，配合CubeMX可视化配置，可以快速搭建一个PWM测量系统。下面我就分享一个经过实际项目验证的解决方案，从CubeMX配置到代码实现，手把手带你完成这个实用功能。

1. 硬件准备与CubeMX基础配置

首先确保手头有一块STM32F103ZET6开发板（其他F103系列也适用），我用的是常见的"蓝色药丸"开发板。硬件连接很简单：用杜邦线将PWM信号源接入PA6引脚（TIM3_CH1），同时用另一根线连接开发板的GND。

打开CubeMX新建工程，关键配置步骤如下：

时钟树配置：保持默认72MHz主频，APB1定时器时钟为72MHz
TIM3输入捕获设置：
- Channel1选择"Input Capture direct mode"
- Channel2选择"Input Capture indirect mode"
- Slave Mode选择"Reset Mode"
- Trigger Source选择"TI1FP1"
- IC1设置为上升沿捕获，IC2设置为下降沿捕获

// CubeMX生成的TIM3初始化片段 htim3.Instance = TIM3; htim3.Init.Prescaler = 71; // 预分频值 htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 65535; // ARR值 htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;

TIM4 PWM输出配置（用于测试信号生成）：
- Channel1选择PWM Generation CH1
- 预分频值设为719，ARR设为1999（生成50Hz PWM）
- 默认占空比设为50%

提示：预分频值(PSC)和自动重载值(ARR)的选择很关键，后面会详细解释计算原理。

2. PWM测量核心原理深度解析

理解定时器的工作机制对调试很有帮助。当配置为PWM输入模式时，TIM3的工作流程如下：

第一个上升沿触发定时器复位，CNT清零
下降沿时CNT值存入CCR2（脉宽测量）
第二个上升沿时CNT值存入CCR1（周期测量），同时再次复位定时器

测量精度取决于定时器时钟频率。计算公式如下：

实际频率 = 定时器时钟 / (PSC+1) / CCR1 占空比 = CCR2 / CCR1 * 100%

参数选择需要考虑两个关键因素：

参数	作用	设置建议
PSC	预分频系数	根据信号频率选择，低频信号需要更大PSC
ARR	自动重载值	通常设为最大值65535以获得最宽测量范围

常见误区：很多新手会忽略测量下限问题。对于72MHz时钟，最小可测频率为：

Fmin = 72MHz / (PSC+1) / (ARR+1) = 72000000 / 72 / 65536 ≈ 15.2Hz

所以测量50Hz舵机信号完全没有问题。

3. 代码实现与中断处理

CubeMX生成工程后，需要添加的核心代码如下：

// 全局变量定义 uint32_t CCR1_Value = 0, CCR2_Value = 0; float DutyCycle = 0, Frequency = 0; uint8_t measure_flag = 0; // 启动定时器 HAL_TIM_IC_Start_IT(&htim3, TIM_CHANNEL_1); HAL_TIM_IC_Start_IT(&htim3, TIM_CHANNEL_2); HAL_TIM_PWM_Start(&htim4, TIM_CHANNEL_1); // 输入捕获回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { CCR1_Value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); if(CCR1_Value != 0) { CCR2_Value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_2); Frequency = (float)1000000 / (CCR1_Value * (71 + 1) / 72); DutyCycle = (float)CCR2_Value * 100 / CCR1_Value; measure_flag = 1; } } } // 主循环中打印结果 while (1) { if(measure_flag) { printf("频率: %.2f Hz, 占空比: %.2f%%\r\n", Frequency, DutyCycle); measure_flag = 0; } HAL_Delay(500); }

调试技巧：

如果测量值不稳定，检查硬件连接是否接触良好
测量异常高频率时，适当减小PSC值
使用逻辑分析仪交叉验证测量结果

4. 实战案例：舵机信号测量与分析

现在我们来测量一个实际的舵机PWM信号。标准舵机控制信号参数为：

频率：50Hz（周期20ms）
脉宽：0.5ms-2.5ms
对应占空比：2.5%-12.5%

硬件连接示意图：

舵机信号线 -> PA6(TIM3_CH1) 舵机GND -> 开发板GND

在代码中设置TIM4输出测试信号：

// 设置50Hz，7.5%占空比(中立位) __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_1, 150);

串口输出预期结果：

频率: 50.00 Hz, 占空比: 7.50%

异常情况处理：

测量值为0：
- 检查定时器时钟配置
- 确认输入信号极性设置正确
测量值波动大：
- 增加软件滤波，如连续测量3次取平均
- 检查电源稳定性
测量范围受限：
- 高频信号：减小PSC值
- 低频信号：增大PSC值

5. 进阶优化与扩展应用

基础功能实现后，可以考虑以下优化：

精度提升方案：

使用更高频率的外部时钟
启用定时器溢出中断处理极端情况
添加软件校准补偿

// 带溢出处理的增强版回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { static uint32_t overflow_count = 0; if(htim->Instance == TIM3) { if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { CCR1_Value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); overflow_count = 0; } else if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_2) { CCR2_Value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_2); } if(CCR1_Value != 0) { uint32_t total_ticks = CCR1_Value + (overflow_count * 65536); Frequency = (float)1000000 / (total_ticks * (71 + 1) / 72); DutyCycle = (float)CCR2_Value * 100 / total_ticks; measure_flag = 1; } } } // 溢出中断处理 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { overflow_count++; } }

扩展应用场景：