STM32定时器PWM原理与动态调节实战：从电机控制到LED调光-平芜编程栈

1. 项目概述：为什么PWM是嵌入式开发的“瑞士军刀”？

在嵌入式开发，尤其是电机控制、LED调光、电源管理这些领域，PWM（脉冲宽度调制）信号就像空气和水一样不可或缺。它本质上是一种通过数字方式模拟模拟量效果的技术。一个固定频率的方波，通过调整其高电平在一个周期内所占的时间比例（即占空比），就能等效地输出不同的电压或电流平均值，从而实现对电机转速、LED亮度、加热功率的精确控制。

我接触过很多刚上手STM32的朋友，他们往往能很快用库函数点个灯、发个串口数据，但一到PWM这里就容易卡壳。问题常常不是出在代码上，而是对STM32定时器这个“多面手”的理解不够透彻。很多人调不出波形，或者频率、占空比不对，根源在于没搞清楚定时器的时钟树、预分频、自动重载值这些底层寄存器是如何协同工作来“雕刻”出你想要的PWM波的。

这个项目标题“STM32单片机输出频率及占空比可调的PWM波”，看似基础，实则涵盖了从时钟配置、定时器模式理解到动态调节的核心技能。它不仅是驱动舵机、无刷电机的第一步，更是理解STM32高级定时器复杂功能（如互补输出、死区插入）的基石。接下来，我将以一个STM32F103C8T6（也就是常说的“蓝桥杯”或“最小系统板”核心芯片）为例，手把手带你从原理到代码，实现一个频率从1Hz到100kHz、占空比从0%到100%连续可调的PWM信号发生器，并分享那些数据手册不会告诉你的调试经验和避坑指南。

2. 核心原理与硬件设计思路拆解

2.1 PWM的本质与STM32的生成机制

很多人把PWM想复杂了。你可以把它想象成一道不断开关的水闸。频率就是你每秒开关水闸的次数，占空比就是一次开关周期内，水闸打开的时间占总时间的百分比。打开时间长，平均水流就大；打开时间短，平均水流就小。在电路里，“水流”就是电压或电流。

STM32生成PWM，核心靠的是其内置的高级/通用定时器（TIM1/TIM8和TIM2-TIM5等）。这些定时器内部有一个计数器，在时钟驱动下循环计数。PWM模式就是让这个计数器的值，与一个你设定的“比较值”进行实时比较。当计数器值小于比较值时，输出一种电平（通常为高）；大于等于时，输出另一种电平（低）。这样，通过改变“比较值”，就能改变高电平的宽度，即占空比；通过改变计数器的计数周期（自动重载值），就能改变整个波形的频率。

这里的关键公式有两个：

定时器时钟频率 (CK_CNT)= 系统时钟 / (预分频器值 + 1)
PWM频率= CK_CNT / (自动重载值 + 1)

占空比则由比较值（Capture/Compare Register, CCRx）决定：占空比= (CCRx + 1) / (自动重载值 + 1) * 100%

注意：这里的“+1”是因为计数器从0开始计数。例如，自动重载值设为999，计数器实际会经历0~999共1000个计数值，然后溢出，因此周期是1000个时钟 ticks。

2.2 硬件连接与引脚选择

对于STM32F103C8T6，我们选择通用定时器TIM3的通道1（CH1）来输出PWM。查阅数据手册或芯片引脚图可知，TIM3_CH1默认映射到PA6引脚。

你需要准备的硬件很简单：

STM32F103C8T6最小系统板一块。
ST-Link V2下载调试器一个。
杜邦线若干。
一个示波器（至关重要）。调试PWM没有示波器就像修车不看仪表盘，你无法直观验证波形是否正确。如果没有示波器，至少需要一个LED和电阻，通过亮度变化定性观察占空比改变，但无法精确测量频率。

电路连接：

ST-Link的SWDIO、SWCLK、GND、3.3V分别连接STM32的对应引脚。
PA6引脚用杜邦线引出，连接到示波器的探头。
如果使用LED观察，则在PA6和LED正极之间串联一个220Ω-1kΩ的限流电阻，LED负极接GND。

2.3 开发环境与工具链

我强烈推荐使用STM32CubeIDE。它集成了STM32CubeMX图形化配置工具和Eclipse开发环境，对于配置复杂的时钟树和外设（如定时器）特别友好，能自动生成初始化代码，极大减少因寄存器配置错误导致的低级问题。

当然，如果你习惯Keil MDK或IAR，原理完全相通，只是配置方式不同。本文的代码逻辑和配置参数具有通用性。

3. 详细配置与代码实现步骤

3.1 使用STM32CubeMX进行图形化配置

创建项目与芯片选择：打开STM32CubeIDE，新建STM32项目，选择STM32F103C8。
配置系统时钟（RCC）：
- 在“Pinout & Configuration”标签页，找到“RCC”高亮。
- 将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。我们的最小系统板外部通常有一个8MHz的晶振。
配置时钟树（Clock Configuration）：
- 这是最容易出错的一步。点击“Clock Configuration”标签。
- 由于HSE是8MHz，我们的目标是将系统时钟（SYSCLK）配置到72MHz（STM32F103的最高主频）。
- 通常路径是：HSE (8MHz) → PLL输入（选择HSE） → PLL倍频因子（x9） → PLL输出（72MHz） → 选择PLL作为SYSCLK源。
- 确保APB1总线时钟（PCLK1）为36MHz，APB2总线时钟（PCLK2）为72MHz。定时器TIM3挂在APB1上，但定时器时钟有倍频器，如果APB1预分频系数不为1，定时器时钟会翻倍。在我们的配置下（APB1 prescaler = 2），TIM3的时钟实际上是APB1时钟的2倍，即72MHz。这一点CubeMX会帮你自动计算并显示，务必核对。
配置定时器TIM3：
- 在左侧“Timers”中找到TIM3。
- 将“Clock Source”设置为“Internal Clock”。
- 切换到“Parameter Settings”子标签：
  - Prescaler (PSC - 预分频器)：设为71。计算：我们希望计数器时钟CK_CNT = 1MHz。因为上一步得到TIM3时钟为72MHz，所以 PSC = 72MHz / 1MHz - 1 = 71。
  - Counter Mode (计数模式)：Up（向上计数）。
  - Counter Period (自动重载值 ARR)：设为999。结合PSC，此时PWM频率 = 1MHz / (999 + 1) = 1kHz。这是一个很好的起始测试频率。
  - auto-reload preload (自动重载预装载)：Enable。这可以防止在修改ARR时产生毛刺波形。
- 在下方的“Channel1”选择“PWM Generation CH1”。
配置PWM模式：
- 点击刚刚激活的“CH1”模式，会弹出更详细的配置。
- Mode (模式)：PWM mode 1。在此模式下，当计数器值小于CCR1时，输出有效电平（我们设为高）；大于等于时，输出无效电平（低）。
- Pulse (脉冲值，即初始CCR1)：设为500。这样初始占空比 = (500+1)/(999+1) ≈ 50%。
- Output compare preload (输出比较预装载)：Enable。同样是为了平滑改变占空比。
- CH Polarity (通道极性)：High。即有效电平为高。
生成代码：
- 在“Project Manager”标签设置好项目名称和路径，选择“MDK-ARM”或“STM32CubeIDE”作为Toolchain。
- 点击右上角的“GENERATE CODE”。

3.2 关键代码分析与编写

CubeMX生成的代码已经完成了GPIO和定时器的初始化。我们需要在用户代码区添加控制逻辑。

打开主循环所在的main.c文件，找到/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间，启动PWM输出：

/* USER CODE BEGIN 2 */ HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); // 启动TIM3的通道1输出PWM /* USER CODE END 2 */

现在，理论上PA6引脚就应该输出一个1kHz、50%占空比的方波了。用示波器测量验证。

3.3 实现频率与占空比动态调节

静态输出不是我们的目标。我们需要通过某种方式（如串口指令、按键、电位器ADC读取）来动态改变频率和占空比。这里以串口指令为例，展示核心的调节函数。

原理回顾：频率由CK_CNT和ARR决定，占空比由CCRx和ARR决定。由于我们通常希望在不改变PWM频率的情况下调整占空比，所以动态调节主要针对CCRx寄存器。若要改变频率，则需要同时调整PSC或ARR，但改变ARR会影响当前占空比的实际比例，需要联动更新CCRx。

在main.c的/* USER CODE BEGIN 4 */区域添加以下函数：

/* USER CODE BEGIN 4 */ /** * @brief 动态设置PWM占空比 * @param duty: 占空比，范围0-100 (代表百分比) * @retval None */ void Set_PWM_DutyCycle(uint8_t duty) { if(duty > 100) duty = 100; uint32_t pulse = (htim3.Instance->ARR + 1) * duty / 100; // 注意：因为计数器从0开始，所以比较值应为 pulse - 1，但根据公式占空比 = (CCR+1)/(ARR+1)， // 我们直接计算 pulse = (ARR+1)*duty/100，然后设置 CCR = pulse - 1。 // 更简单的理解：我们希望高电平时间为 (ARR+1) * (duty/100) 个时钟周期。 // 在PWM Mode 1下，CCR值就是计数器从0开始计数，计到CCR值后电平翻转。 // 因此，CCR = (ARR+1) * duty / 100 - 1。 // 但HAL库的 __HAL_TIM_SET_COMPARE() 函数内部处理了这些关系，我们通常直接设置脉宽。 // 使用HAL库函数，它期望的是“比较值” __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, pulse); } /** * @brief 动态设置PWM频率 (通过改变ARR实现，保持时钟源不变) * @param freq_hz: 目标频率，单位Hz * @retval 实际设置成功的频率 * @note 这是一个简化函数，假设PSC固定为71（CK_CNT=1MHz）。实际频率 = 1MHz / (ARR+1) */ uint32_t Set_PWM_Frequency(uint32_t freq_hz) { if(freq_hz == 0) return 0; // 计算新的ARR值 uint32_t new_arr = (1000000 / freq_hz) - 1; // CK_CNT = 1MHz // 检查ARR值是否在有效范围内（对于16位定时器，最大65535） if(new_arr > 0xFFFF) new_arr = 0xFFFF; // 先停止PWM输出，修改关键寄存器，再重启，避免中间状态产生异常波形 HAL_TIM_PWM_Stop(&htim3, TIM_CHANNEL_1); htim3.Instance->ARR = new_arr; // 修改频率后，为了保持原有占空比百分比，需要按比例更新CCR值 // 获取旧的占空比百分比 uint32_t old_ccr = __HAL_TIM_GET_COMPARE(&htim3, TIM_CHANNEL_1); uint32_t old_arr = htim3.Instance->ARR; // 注意，ARR刚被修改，这里需要旧的ARR值，需要提前保存 // 更稳健的做法：在函数开始就保存旧的ARR和CCR // 此处为简化逻辑，假设我们知道旧ARR是999，直接计算比例。 // 实际项目应传递旧参数或使用全局变量保存状态。 uint32_t new_ccr = new_arr * old_ccr / 999; // 999是初始ARR __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, new_ccr); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); // 返回实际频率 return 1000000 / (new_arr + 1); } /* USER CODE END 4 */

然后，你可以在主循环中，或者在一个串口中断回调函数里，解析接收到的指令，调用这两个函数。例如，收到“D50”设置占空比为50%，收到“F2000”设置频率为2000Hz。

重要心得：直接操作htim3.Instance->ARR这类寄存器时，务必小心。在高级定时器或需要同步更新的复杂场景下，可能需要使用__HAL_TIM_SET_AUTORELOAD()等宏，并配合TIM_EGR_UG位产生更新事件来同步预装载寄存器和影子寄存器。对于通用定时器的简单应用，在停止计数器后直接修改通常问题不大，但了解这个机制对深入开发至关重要。

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

调不出PWM波形，或者波形不对，是新手最常见的问题。下面这个排查清单，是我踩过无数坑后总结的，能解决95%以上的问题。

4.1 问题一：完全没有波形输出

检查步骤：
1. 引脚复用是否正确：确认你使用的引脚确实支持该定时器的PWM输出功能。PA6默认是GPIO，你必须在CubeMX中将其配置为TIM3_CH1，代码中才会将其初始化为复用推挽输出模式。用万用表量一下PA6电压，如果一直是0或3.3V，可能是GPIO模式不对。
2. 定时器时钟是否使能：CubeMX生成的代码通常会自动使能时钟，但如果你手动编写寄存器，漏掉__HAL_RCC_TIM3_CLK_ENABLE()是常见错误。
3. PWM输出是否启动：你调用了HAL_TIM_PWM_Start()吗？这个函数必须调用。
4. 计数器是否使能：HAL_TIM_PWM_Start()内部会调用HAL_TIM_Base_Start()。确保定时器的基础计数功能已开启。
5. GPIO冲突：检查该引脚是否被其他外设（如调试接口SWD/JTAG）占用。例如，PA13、PA14、PA15默认是SWD接口，如果复用为普通GPIO，可能导致无法下载程序。PA6一般无此问题。

4.2 问题二：频率或占空比与计算值不符

检查步骤：
1. 时钟树核对：这是最高频的错误原因。双击打开CubeMX的.ioc文件，再次进入“Clock Configuration”页面，仔细查看TIM3的输入时钟频率。确保你理解APB1 timer clocks这一行的值。它应该是APB1时钟的1倍或2倍。
2. 公式代入验证：用示波器测量的实际频率，反推回去。例如，你目标1kHz，实测是500Hz。可能的原因：ARR值你以为是999，但实际代码中可能被其他地方修改了；或者PSC值计算错误（忘了“-1”）。
3. 预装载寄存器使能：确保TIMx_CR1寄存器中的ARPE位（Auto-reload preload enable）已置位（CubeMX中已使能）。这能保证你对ARR的修改在下一个更新事件时才生效，避免产生破碎的PWM周期。
4. 动态修改时的时机：如果你在程序运行中动态修改CCR或ARR，确保在计数器停止时或使用__HAL_TIM_SET_COMPARE()和__HAL_TIM_SET_AUTORELOAD()这类原子操作宏。直接赋值可能在计数器运行时发生，导致一个周期内出现不可预测的波形。

4.3 问题三：波形毛刺多或不平滑

原因与解决：
1. 电源噪声：使用示波器查看3.3V和GND的电源纹波。如果噪声大，在芯片电源引脚附近增加一个10uF电解电容并联一个0.1uF陶瓷电容。
2. 输出负载过重：PA6引脚直接驱动大电流负载（如电机）会导致波形变形。一定要用三极管、MOS管或电机驱动芯片（如L298N、TB6612）来隔离和放大信号。
3. 软件干扰：如果在一个复杂的中断服务程序中频繁计算并修改PWM参数，可能导致输出抖动。尽量将参数计算放在主循环或低优先级任务中，修改寄存器的操作要快。

4.4 示波器使用小技巧

触发设置：将示波器触发模式设为“边沿触发”，触发电平设为1.65V左右（Vcc/2），触发源选择你测量的那个通道。这样波形会稳定显示。
测量功能：使用示波器的自动测量功能，直接读取频率、周期、占空比、高电平时间等参数，与你的计算值对比。
看细节：将时间轴调小（如1us/div），观察上升沿和下降沿是否陡峭，是否有振铃现象。这能反映驱动能力和线路布局问题。

5. 进阶应用与扩展思路

掌握了基础PWM输出后，你可以尝试更复杂的应用，这些都是实际项目中经常遇到的。

5.1 驱动舵机

舵机控制需要的是周期为20ms（50Hz），脉宽在0.5ms到2.5ms之间的PWM信号。脉宽对应舵机角度。

配置：将定时器配置为50Hz。例如，若CK_CNT=1MHz，则ARR = (1,000,000 / 50) - 1 = 19999。
控制角度：设定CCR值来控制脉宽。0.5ms对应CCR = 500，2.5ms对应CCR = 2500。线性映射即可。
注意：舵机对脉冲宽度要求比较精确，且需要持续的信号来维持位置。确保你的定时器中断或DMA不会干扰PWM信号的持续生成。

5.2 实现呼吸灯效果

呼吸灯的本质是让占空比随时间平滑变化。你可以在主循环或定时器中断中，周期性调用Set_PWM_DutyCycle函数。

简单实现：用一个变量brightness从0递增到100，再递减到0，循环往复。每次变化后加一个几毫秒的HAL_Delay()。但这种方法会阻塞CPU。
优雅实现：使用另一个定时器（如TIM2）产生一个固定间隔（如10ms）的中断。在中断服务程序里更新呼吸灯PWM的CCR值。这样变化平滑且不阻塞主程序。