1. 项目概述与核心价值

最近在整理一个老项目时，翻到了当初用STM32调PWM的笔记，从输出一个精准的1kHz方波到实现平滑的呼吸灯效果，这个过程里踩过的坑和总结的经验，现在回头看依然很有价值。对于刚接触STM32或者对定时器、PWM理解还不够深入的朋友来说，这几乎是必经之路。这个项目看似基础，但它像一把钥匙，能帮你打开STM32定时器那扇复杂的大门。掌握了它，你再去玩舵机控制、电机调速、DAC模拟甚至一些简单的通信协议，都会觉得轻松不少。

简单来说，我们要用STM32的定时器，实现两个经典功能：第一，在某个GPIO引脚上输出一个频率固定为1kHz、占空比严格为50%的方波信号，这常用于时钟基准、驱动蜂鸣器或测试信号源；第二，利用PWM的占空比动态变化，控制一个LED实现“呼吸灯”效果，即亮度由暗到亮再到暗循环变化。这不仅仅是让灯闪起来，更深层的价值在于理解定时器从计数、比较到输出的完整链条，以及如何通过软件精准地操控硬件资源。下面，我就结合STM32F103C8T6这款经典的“蓝桥杯”芯片，把整个实现过程、原理细节和那些容易掉进去的坑，掰开揉碎了讲清楚。

2. 硬件与开发环境准备

工欲善其事，必先利其器。在动手写代码之前，我们需要把硬件平台和软件环境搭建好，这一步的准备工作做扎实了，后续的调试会顺利很多。

2.1 核心硬件选型与连接

我手头用的是一块STM32F103C8T6核心板，也就是常说的“蓝色药丸”。这款芯片资源丰富，性价比极高，非常适合学习和中等规模的项目开发。它拥有多达4个通用定时器（TIM2, TIM3, TIM4, TIM5）和2个高级定时器（TIM1, TIM8），我们实现PWM功能主要依赖这些定时器。

对于PWM输出，我们需要选定一个支持PWM输出的引脚。以最常用的定时器TIM2的通道1为例，它在STM32F103C8T6上对应的引脚是PA0（重映射后可能是PA15，这里我们先使用默认映射）。我们将一个LED的正极通过一个220Ω的限流电阻连接到PA0引脚，负极接地（GND）。这样，当PA0输出高电平时LED点亮，输出低电平时LED熄灭。PWM波就是通过高速切换这个高低电平，利用人眼的视觉暂留效应来控制LED的平均亮度。

注意：在连接LED时，务必串联一个限流电阻（通常220Ω-1kΩ），直接连接IO口到LED正极可能会因电流过大损坏单片机IO口或LED。

除了核心板，我们还需要一个调试器。ST-Link V2是最常见的选择，价格便宜，连接稳定。将ST-Link的SWDIO、SWCLK、GND、3.3V分别连接到核心板对应的引脚上。如果核心板自带USB转串口芯片（如CH340），还需要连接串口线（PA9/TX, PA10/RX）到电脑，用于程序打印日志，这在调试阶段非常有用。

2.2 软件开发环境搭建

软件方面，我强烈推荐使用STM32CubeIDE。它是ST官方推出的免费集成开发环境，基于Eclipse和GCC，集成了STM32CubeMX图形化配置工具，可以无缝完成从芯片选型、外设配置、时钟树设置到代码生成的全过程，极大提升了开发效率。

首先，去ST官网下载并安装STM32CubeIDE。安装完成后，新建一个STM32项目，选择对应的芯片型号（STM32F103C8）。项目创建成功后，会自动打开STM32CubeMX的图形化配置界面。在这个界面里，我们可以用鼠标点选的方式配置时钟、外设和引脚功能，比直接读写寄存器直观太多了。

另一种传统方式是使用Keil MDK（ARMCC编译器）或IAR，配合手动编写代码和操作寄存器。这种方式对理解底层原理更有帮助，但效率相对较低。对于初学者，我建议先从CubeIDE上手，快速看到效果，建立信心，之后再深入研究寄存器操作。

3. PWM基础与定时器原理深度解析

在配置代码之前，我们必须搞清楚STM32的定时器是如何产生PWM的。如果只是照着别人的代码抄一遍，一旦参数需要改动或者出了问题，就会束手无策。理解原理，才能以不变应万变。

3.1 定时器是如何工作的？

你可以把STM32的一个通用定时器（比如TIM2）想象成一个向上计数的“秒表”。这个秒表有几个关键部件：

1. 时钟源：秒表走得快慢由时钟决定。STM32的定时器时钟通常来源于系统时钟（SYSCLK）经过预分频器（PSC）之后。比如系统时钟是72MHz，预分频器设置为71，那么定时器的计数时钟频率就是 72MHz / (71+1) = 1MHz。这里的“+1”是因为分频器是从0开始计数的。
2. 计数器（CNT）：这是一个16位或32位的寄存器，它会随着每个计数时钟脉冲递增（向上计数模式），从0开始一直累加。
3. 自动重装载寄存器（ARR）：这是计数器的上限。当计数器（CNT）的值累加到等于ARR的值时，就会产生一个“更新事件”，然后计数器清零，重新开始计数。这个循环的周期，就决定了PWM波的频率。
4. 捕获/比较寄存器（CCRx）：这是我们实现PWM占空比控制的核心。以通道1为例，它对应CCR1寄存器。我们会给CCR1设定一个比较值。

定时器的工作流程是这样的：计数器CNT从0开始，每来一个计数时钟就加1，同时硬件会不断比较CNT的值和CCR1的值。在PWM模式1下：

• 当CNT < CCR1时，对应的输出通道（比如PA0）被设置为有效电平（通常为高电平）。
• 当CNT >= CCR1 且 CNT <= ARR时，输出通道被设置为无效电平（低电平）。
• 当CNT计到ARR时，发生溢出，产生更新事件，CNT归零，开始下一个周期。

3.2 关键参数的计算公式

理解了原理，计算参数就是套公式了。我们的目标是产生频率（Fpwm）为1kHz，占空比（Duty）为50%的方波。

1. 定时器时钟频率（Ftim_clk）：这是定时器“秒表”实际走动的频率。它由系统时钟和预分频器（PSC）共同决定。假设我们使用72MHz系统时钟，并设置PSC=71。Ftim_clk = SYSCLK / (PSC + 1) = 72MHz / (71+1) = 1MHz这意味着计数器每1微秒（us）加1。

2. 自动重装载值（ARR）与PWM频率：ARR决定了计数器的计数周期。一个完整的PWM周期，就是计数器从0数到ARR再归零的时间。PWM周期 Tpwm = (ARR + 1) / Ftim_clkPWM频率 Fpwm = Ftim_clk / (ARR + 1)我们需要Fpwm = 1000Hz， Ftim_clk = 1MHz = 1,000,000 Hz。 所以，ARR = (Ftim_clk / Fpwm) - 1 = (1,000,000 / 1000) - 1 = 1000 - 1 = 999。

3. 捕获比较值（CCR）与PWM占空比：占空比是高电平时间在一个周期内的占比。占空比 Duty = (CCR / (ARR + 1)) * 100%我们需要占空比为50%。 所以，CCR = Duty * (ARR + 1) = 0.5 * (999 + 1) = 500。

计算结果汇总：为了实现1kHz，50%占空比的PWM，在1MHz的定时器时钟下，我们需要设置：

• 预分频器 PSC = 71
• 自动重载值 ARR = 999
• 捕获比较值 CCR = 500

这个计算过程是核心，务必理解。当你需要改变频率或占空比时，只需重新计算这三个参数即可。

4. 使用STM32CubeMX图形化配置

理论准备就绪，现在开始动手配置。STM32CubeMX的图形化界面让这个过程变得非常直观。

4.1 时钟树配置

在CubeMX的“Pinout & Configuration”选项卡中，找到“RCC”设置。将高速外部时钟（HSE）选择为“Crystal/Ceramic Resonator”，这是我们使用外部8MHz晶振的标准配置。

然后，切换到“Clock Configuration”标签页。这里可以看到整个芯片的时钟树。我们的目标是让系统时钟（SYSCLK）达到STM32F103的最高主频72MHz。

1. 在HSE输入框输入8（MHz）。
2. 将PLL Source Mux选择为HSE。
3. 设置PLL倍频因子为9倍。因为8MHz * 9 = 72MHz。
4. 将系统时钟源（SYSCLK）选择为PLLCLK。
5. 检查APB1总线时钟（PCLK1），它应该是36MHz（72MHz/2）。定时器TIM2挂在APB1上，如果APB1预分频器不为1，定时器时钟会是PCLK1的2倍，即72MHz。这正是我们之前计算假设的时钟源。

这一步配置确保了整个芯片，包括我们的定时器，运行在正确的频率上。

4.2 定时器与GPIO配置

接下来配置具体的定时器。在左侧“Timers”目录下找到TIM2。

1. 将时钟源（Clock Source）选择为“Internal Clock”。
2. 在下方通道1（Channel1）选择“PWM Generation CH1”。此时，右侧的芯片引脚图上，PA0会自动被标记为绿色，表示已被配置为TIM2_CH1（定时器2通道1）的复用功能输出。
3. 在右侧的参数配置区“Parameter Settings”中，进行关键参数设置：
   • Prescaler (PSC - 16 bits value): 输入我们计算好的值71。
   • Counter Mode: 选择“Up”（向上计数模式）。
   • Counter Period (AutoReload Register - 16 bits value): 输入999。注意，这里CubeMX的“Period”指的就是ARR。
   • Internal Clock Division (CKD): 保持默认“No Division”。
   • auto-reload preload: 建议使能（Enable）。这会让对ARR的修改在下一个更新事件时才生效，防止在修改途中产生错误的PWM脉冲。
4. 继续向下，找到“PWM Generation Channel 1”的子菜单。
   • Mode: 选择“PWM mode 1”。这是我们最常用的模式，在向上计数时，CNT<CCR为有效电平。
   • Pulse (16 bits value): 输入500。这个“Pulse”就是捕获比较寄存器CCR1的值。
   • Output compare preload: 使能（Enable）。与ARR预装载类似，保证CCR的修改平滑。
   • CH Polarity: 选择“High”。这表示我们定义的有效电平为高电平。即当CNT<CCR时，输出高电平。

至此，一个固定频率和占空比的PWM输出就配置好了。但我们的目标还有呼吸灯，这需要动态改变CCR的值。我们可以在代码中通过__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, new_ccr_value)这个函数来随时修改。

4.3 生成工程与代码初探

点击CubeMX右上角的“GENERATE CODE”，选择工程路径和工具链（STM32CubeIDE），生成代码。

打开工程后，在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间，我们需要启动PWM输出。添加如下代码：

HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);

这行代码会启动定时器2的通道1，开始输出PWM波。此时，如果你用示波器或者逻辑分析仪探头连接到PA0引脚，应该就能看到一个稳定的1kHz，50%占空比的方波了。如果没有仪器，可以接上LED，它会以肉眼无法分辨的速度闪烁，看起来像是半亮状态（因为50%占空比）。

5. 呼吸灯功能的软件实现

呼吸灯的本质是让PWM的占空比（即CCR的值）随时间平滑地变化。通常我们让CCR值从0线性增加到ARR（灯渐亮），再从ARR线性减少到0（灯渐暗），如此循环。实现这个变化，有几种常见思路。

5.1 实现思路对比：阻塞延时 vs. 定时器中断

最简单的办法是在主循环里用HAL_Delay()做阻塞延时，然后逐步修改CCR值。但这种方法会独占CPU，程序无法同时做其他事情，非常低效，不推荐在实际项目中使用。

更优雅和高效的方法是使用定时器中断。我们可以利用另一个定时器（比如基本定时器TIM6），或者就用PWM所在的定时器TIM2的更新中断，来定期触发一个中断服务函数。在这个中断函数里，我们更新CCR的值，从而实现非阻塞的、精准的亮度变化。

这里我演示如何使用TIM2的更新中断来实现呼吸灯，这样我们只需要一个定时器资源。

5.2 基于更新中断的呼吸灯代码实现

首先，回到CubeMX中，对TIM2的配置做一点补充：

1. 在TIM2的配置页面，找到“NVIC Settings”选项卡。
2. 勾选“TIM2 global interrupt”使能全局中断，并可以设置一个合适的抢占优先级和子优先级。

然后，重新生成代码。CubeMX会自动在stm32f1xx_it.c文件中生成TIM2的中断服务函数TIM2_IRQHandler，并在其中调用了HAL_TIM_IRQHandler。我们需要做的是编写自己的中断回调函数。

在main.c文件的开头，定义几个全局变量来控制呼吸灯：

/* USER CODE BEGIN PV */ uint16_t pwm_val = 0; // 当前CCR值 uint8_t direction = 0; // 方向：0为递增，1为递减 /* USER CODE END PV */

在/* USER CODE BEGIN 2 */区域，除了启动PWM，还要启动定时器的更新中断：

HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); HAL_TIM_Base_Start_IT(&htim2); // 启动定时器并开启更新中断

接下来，我们需要重写定时器更新中断的回调函数。HAL库提供了一个弱定义的函数HAL_TIM_PeriodElapsedCallback，当更新中断发生时会被调用。我们在main.c的/* USER CODE BEGIN 4 */区域重写它：

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) // 判断是TIM2的中断 { if(direction == 0) // 渐亮 { pwm_val++; if(pwm_val >= 999) // ARR的值是999 { direction = 1; // 切换到渐暗方向 } } else // 渐暗 { pwm_val--; if(pwm_val <= 0) { direction = 0; // 切换到渐亮方向 } } // 更新CCR1寄存器的值，改变占空比 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, pwm_val); } }

这段代码的逻辑很清晰：每次TIM2计数溢出（频率是1kHz）时，就会进入这个回调函数。根据direction标志位，增加或减少pwm_val，然后将其设置为新的比较值。由于PWM频率是1kHz，即每1ms进入一次中断，改变一次亮度。从0到999需要1000次中断，即1秒完成一次从全暗到全亮的变化。整个呼吸周期大约是2秒。

实操心得：直接在主中断回调里进行pwm_val++和--操作，呼吸效果是线性的，但人眼对亮度的感知是非线性的（近似对数曲线）。线性增加PWM占空比，会感觉亮度先增加得快，后增加得慢。如果想要视觉上均匀的呼吸效果，可以建立一个gamma校正表，或者使用pwm_val = sin(phase) * 500 + 500这样的正弦函数来计算CCR值，效果会平滑自然得多。

6. 调试技巧与常见问题排查实录

代码写好了，下载到板子里，但LED可能不亮，或者呼吸效果不对。别着急，调试是嵌入式开发的常态。下面是我总结的几个常见问题点和排查思路。

6.1 完全没有PWM波形输出

这是最让人头疼的情况。你可以按照以下清单逐一排查：

6.2 PWM频率或占空比不准

用示波器测量发现频率不是1kHz，或者占空比不是50%。

1. 系统时钟不对：这是最常见的原因。确保外部晶振（HSE）起振，并且PLL配置正确。可以在代码中通过SystemCoreClock变量打印系统时钟频率，或者通过点灯的方式粗略测试（写一个1ms翻转一次的IO，用示波器看周期是否为2ms）。
2. 参数计算错误：回头仔细核对第三节的计算公式。记住Fpwm = Ftim_clk / (ARR + 1)， 以及ARR = (Ftim_clk / Fpwm) - 1。Ftim_clk的确定需要结合APB1预分频器考虑。
3. 示波器测量误差：确保示波器探头接地良好，时基和触发电平设置正确。对于1kHz信号，时基可以设置为500us/div或1ms/div。

6.3 呼吸灯效果不流畅或闪烁

1. 中断频率过高或过低：我们的例子中，PWM频率1kHz，更新中断也是1kHz。对于呼吸灯来说，1ms改变一次亮度是足够的。如果感觉跳动，可能是中断里执行了太多代码，导致中断处理时间过长，影响了下次中断的准时发生。优化中断服务函数，只做最必要的操作（如更新CCR）。
2. 亮度变化非线性：如前所述，这是生理感知问题，不是程序错误。如果需要，应用Gamma校正。
3. 方向切换点判断错误：检查代码中if(pwm_val >= 999)和if(pwm_val <= 0)的判断条件。ARR是999，所以最大值是999。如果写成>，pwm_val只能到998，亮度达不到最亮。

6.4 使用逻辑分析仪进行调试

如果没有示波器，一个几十块钱的USB逻辑分析仪是调试数字信号（如PWM、串口）的神器。配合PulseView或Saleae Logic软件，可以清晰地看到PWM波的频率、占空比和随时间的变化趋势。将探头连接到PWM输出引脚，设置合适的采样率（对于1kHz信号，几百KHz就够），就能直观地验证你的程序是否按预期工作，呼吸灯占空比是否在平滑变化。

7. 项目进阶与扩展思路

当你成功实现了基础的固定PWM和呼吸灯后，可以尝试以下扩展，这会让你的理解更上一层楼。

7.1 多通道与互补输出

一个定时器往往有多个通道（如TIM2有CH1-CH4）。你可以轻松配置多个通道输出不同占空比但同频率的PWM，用于同时控制多个LED或电机。高级定时器（TIM1/TIM8）还支持互补输出带死区控制，这是驱动三相电机（如无刷直流电机BLDC）的关键技术。你可以尝试用TIM1的CH1和CH1N（互补通道）输出一对互补的PWM，并用死区寄存器插入一个短暂的全低电平时间，防止上下桥臂直通短路。

7.2 动态调整频率与占空比

我们的呼吸灯只动态改变了占空比（CCR），频率（ARR）是固定的。在某些应用，如电机调速或音频生成中，可能需要动态改变频率。注意，改变ARR会影响所有通道的PWM频率。如果需要独立调整，可以考虑使用多个定时器，或者更高级的“定时器主从模式”与“影子寄存器”功能。

7.3 利用DMA自动更新PWM数据

对于需要极其平滑、无CPU干预的PWM波形（如复杂的灰度LED灯带WS2812B的时序模拟，或音频流播放），可以使用DMA（直接存储器访问）。你可以将一组预先计算好的CCR值存放在数组中，然后配置DMA，让定时器在每次更新事件时自动从数组中搬运一个新的CCR值到寄存器。这样CPU就被完全解放出来，PWM输出也毫无抖动。这是提升系统性能和实现复杂波形的高级技巧。

从输出一个简单的方波到实现流畅的呼吸灯，再到探索更高级的应用，这个过程正是嵌入式软件工程师成长的缩影。最关键的不是记住代码，而是理解定时器这个强大外设的工作原理和设计思想。下次当你遇到需要精准定时、波形生成或电机控制的任务时，希望这次对STM32 PWM的深入探讨能为你提供一个清晰的思路和坚实的起点。