STM32CubeMX实战：PWM呼吸灯从配置到代码实现-平芜编程栈

1. 硬件准备与开发环境搭建

手头有一块正点原子精英板（STM32F103ZET6）和一根USB数据线，这就是我们实现PWM呼吸灯的全部硬件需求。作为嵌入式开发的新手，我强烈建议你先检查板载LED的连接情况。以精英板为例，板载LED通常连接在PB5引脚，这个引脚恰好支持TIM3定时器的通道2输出，这正是我们需要的PWM功能引脚。

开发环境方面，我们需要三个核心工具：STM32CubeMX、Keil MDK-ARM和ST-Link驱动。第一次使用时最容易踩的坑就是版本兼容性问题。我实测发现CubeMX 6.3.0配合Keil 5.28可以稳定工作。安装CubeMX时记得勾选STM32F1系列的支持包，否则在设备选择列表里会找不到我们的芯片型号。

注意：如果使用Windows 11系统，可能需要以管理员身份运行CubeMX才能正常生成代码

2. CubeMX工程创建与时钟配置

打开CubeMX后点击"New Project"，在芯片选择框输入STM32F103ZET6并双击确认。这里有个新手容易忽略的关键点：一定要先配置时钟源！我在早期项目中曾浪费两小时调试PWM无输出，最后发现是忘了启用外部晶振。

时钟树配置可以分三步走：

在Pinout界面启用RCC下的HSE（外部高速时钟）
切换到Clock Configuration标签页
在HCLK输入框键入72后回车，让工具自动计算分频系数

这里72MHz是STM32F1系列的推荐主频，更高的频率可能导致不稳定。CubeMX会自动配置PLL倍频参数，我们只需要确认APB1总线的时钟不超过36MHz（TIM3挂载在该总线）。如果看到红色警告，就需要调整分频系数直到所有时钟域都显示绿色。

3. 定时器PWM通道配置详解

在Pinout界面右侧找到TIM3，展开通道列表选择"Channel 2 PWM Generation"。这时会发现PB5引脚自动变成了绿色复用状态。我遇到过有同学疑惑为什么PA7突然变成了PB5，其实这是CubeMX的智能引脚映射功能在起作用。

定时器参数配置有三个关键数值：

Prescaler（预分频器）：设置为71（72MHz/(71+1)=1MHz计数器时钟）
Counter Period（自动重载值）：设为999（1MHz/(999+1)=1kHz PWM频率）
Pulse（初始占空比）：先设为0方便测试

这里有个实用技巧：PWM频率=定时器时钟/((Prescaler+1)*(Counter Period+1))。呼吸灯效果通常需要100Hz-1kHz的频率，太低会闪烁，太高可能超出LED响应速度。我习惯先用1kHz测试，效果稳定后再调整。

4. 代码生成与工程导出

点击Project Manager标签，设置工程名称和存储路径。关键配置项：

Toolchain选择MDK-ARM V5
勾选"Generate peripheral initialization as a pair of .c/.h files"
在Code Generator里选择"Copy only necessary library files"

第一次生成代码时，建议打开"Keep User Code when re-generating"选项，这样后续修改配置时不会覆盖我们添加的业务代码。点击GENERATE CODE按钮后，CubeMX会自动创建完整的Keil工程。

实测发现：如果生成的工程无法立即编译，尝试关闭CubeMX再打开Keil工程

5. PWM呼吸灯代码实现

在Keil中打开工程后，找到main.c文件，我们需要在三个关键位置添加代码：

/* USER CODE BEGIN PV */ uint16_t pwmVal = 0; // PWM比较值 uint8_t fadeStep = 1; // 亮度变化方向 /* USER CODE END PV */ /* USER CODE BEGIN 2 */ HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_2); /* USER CODE END 2 */ /* USER CODE BEGIN WHILE */ while (1) { while (pwmVal < 1000) { pwmVal += fadeStep; __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_2, pwmVal); HAL_Delay(1); } while (pwmVal > 0) { pwmVal -= fadeStep; __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_2, pwmVal); HAL_Delay(1); } HAL_Delay(200); // 完成一次呼吸后暂停 } /* USER CODE END WHILE */

这段代码实现了经典的呼吸灯效果：LED亮度从暗到亮再到暗循环变化。__HAL_TIM_SET_COMPARE宏直接修改TIM3的CCR2寄存器值，改变PWM占空比。实际测试时发现，将HAL_Delay参数改为3ms能产生更平滑的渐变效果。