用STM32CubeMX玩转PWM：手把手实现呼吸灯与舵机控制（基于TIM3）
PWM（脉冲宽度调制）是嵌入式开发中最常用的技术之一，从简单的LED亮度调节到复杂的电机控制都离不开它。对于STM32开发者来说，CubeMX工具极大地简化了PWM的配置过程，让初学者也能快速上手。本文将带你从零开始，通过TIM3定时器实现两个经典案例：呼吸灯效果和舵机角度控制。
1. PWM基础与CubeMX环境搭建
PWM本质上是通过快速开关信号来控制平均电压的技术。占空比（高电平时间占整个周期的比例）决定了输出效果——LED的亮度、舵机的角度都由此决定。
在开始前，请确保已安装：
- STM32CubeMX最新版本
- 对应STM32系列的支持包（如F1/F4等）
- 一款IDE（Keil、IAR或STM32CubeIDE）
提示：本文以STM32F103C8T6（蓝核板）为例，但方法适用于大多数STM32系列
2. TIM3的PWM配置详解
2.1 CubeMX中的定时器设置
打开CubeMX新建工程，选择对应芯片型号后，按以下步骤配置TIM3：
- 时钟配置：确保APB1 Timer Clocks为72MHz（F1系列默认值）
- TIM3模式选择：
- 在"Pinout"标签页找到TIM3
- 选择Channel1或Channel2为"PWM Generation CHx"
- 参数配置：
Prescaler: 71 // 72MHz/(71+1)=1MHz计数器时钟 Counter Mode: Up // 向上计数 Counter Period: 199 // PWM周期=(199+1)/1MHz=200us(5kHz) Pulse: 100 // 初始占空比50%
2.2 生成工程与基础测试
生成代码后，在main函数中添加PWM启动代码：
HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);烧录程序后，用示波器测量对应引脚（如PA6）应能看到5kHz、占空比50%的方波。
3. 呼吸灯实现方案
呼吸灯的关键在于动态改变CCR寄存器值（即Pulse参数）。我们使用正弦变化实现平滑效果。
3.1 代码实现
在main.c中添加以下变量和函数：
// 全局变量 uint8_t breathDirection = 0; // 0:增加亮度 1:降低亮度 uint16_t breathValue = 0; // 在while(1)循环中添加 if(!breathDirection) { breathValue += 5; if(breathValue >= 199) breathDirection = 1; } else { breathValue -= 5; if(breathValue <= 0) breathDirection = 0; } __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, breathValue); HAL_Delay(10);3.2 优化建议
- 使用硬件定时器中断代替HAL_Delay()实现更精确控制
- 采用伽马校正使亮度变化更符合人眼感知：
// 伽马校正表（简化版） const uint8_t gammaTable[32] = {0,1,2,3,4,5,7,9,12,15,19,23,28,33,39,46, 53,61,69,78,88,98,109,120,132,145,158,172,186,201,217,233};
4. 舵机控制实战
标准舵机通常需要50Hz（20ms周期）的PWM信号，控制脉冲宽度在0.5ms-2.5ms之间。
4.1 重新配置TIM3
修改CubeMX参数：
Prescaler: 719 // 72MHz/(719+1)=100kHz Counter Period: 1999 // 20ms周期(100kHz/2000=50Hz)4.2 角度控制函数
添加舵机角度转换函数：
void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, float angle) { // 角度限制在0-180度 angle = (angle > 180) ? 180 : (angle < 0) ? 0 : angle; // 0.5ms(0°)-2.5ms(180°)对应CCR值50-250 uint16_t pulse = 50 + (angle / 180.0) * 200; __HAL_TIM_SET_COMPARE(htim, Channel, pulse); }4.3 使用示例
// 让舵机在0-180度之间摆动 for(int angle=0; angle<=180; angle+=10) { Servo_SetAngle(&htim3, TIM_CHANNEL_1, angle); HAL_Delay(100); } for(int angle=180; angle>=0; angle-=10) { Servo_SetAngle(&htim3, TIM_CHANNEL_1, angle); HAL_Delay(100); }5. 高级技巧与问题排查
5.1 多通道PWM同步
TIM3支持4个独立通道，可同时控制多个设备。配置时注意：
- 所有通道共享相同的Prescaler和Period
- 每个通道有独立的CCR寄存器
5.2 常见问题解决
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无PWM输出 | GPIO未正确配置 | 检查CubeMX引脚分配 |
| 频率不正确 | 时钟源配置错误 | 确认APB1时钟和Prescaler |
| 舵机抖动 | 电源供电不足 | 使用独立电源供电 |
5.3 性能优化
对于需要高精度控制的场景：
// 直接操作寄存器（比HAL库更快） TIM3->CCR1 = 100; // 直接设置通道1的CCR值 // 使用DMA自动更新CCR值（适合复杂波形） HAL_TIM_PWM_Start_DMA(&htim3, TIM_CHANNEL_1, pData, Length);在实际项目中，我发现呼吸灯效果最容易出现的问题是亮度变化不均匀，这通常是由于延时函数不精确导致的。改用定时器中断更新CCR值可以完美解决这个问题。对于舵机控制，特别注意供电稳定性——不稳定的电源会导致舵机定位不准甚至损坏。
