STM32 PWM输出实战：从定时器配置到动态调频调占空比

如果你在嵌入式开发里用过 STM32，大概率绕不开 PWM。调 LED 亮度、控制舵机角度、驱动直流电机、生成音频信号、做 DCDC 电源控制，几乎处处都要和 PWM 打交道。很多新手第一次接触 PWM，是在 STM32F103 上抄一段标准库代码，把 TIM 配好，看到波形出来就算完事。可一旦进入实际项目，问题马上变得具体起来：频率要改成 20kHz，占空比要动态调整，输出要随时关断，多路 PWM 还要同步更新。这时候，如果只会照抄初始化代码，就会非常被动。

这篇文章以 STM32C5A3R 为例，完整走一遍 PWM 输出开发流程：先讲清楚 PWM 频率、占空比和定时器时钟、ARR、CCR 的换算关系；再用 STM32CubeMX 配置一个最小工程；最后重点解决运行期动态修改频率与占空比的问题。读完你会明白，为什么只改一个寄存器往往达不到预期效果，以及如何用 HAL 库的接口安全地实现“频率和占空比都随意变”的功能。如果你正在做电机控制、调光调色、电源控制或信号发生类项目，这篇文章可以直接参考。

1. 为什么写这篇：PWM 开发中最容易卡住的地方

STM32C5 是意法半导体新一代 Arm Cortex-M33 内核 MCU 系列，定位在入门与主流市场，面向家电、工业控制、消费电子等方向。相比老一代产品，它在内核性能、存储容量、安全特性等方面都有明显升级。不过，片子的外设使用思路和老的 STM32 系列是延续的，定时器 PWM 部分同样遵循“时钟分频 + 自动重装载 + 比较捕获”这套经典模型。这给了开发者一个很重要的信号：STM32C5 的 PWM 开发完全可以借鉴老平台的经验，但要注意新平台在时钟树、HAL 库版本和 CubeMX 配置界面上有差异。

我见过很多刚接触 PWM 的读者，最容易在三个地方卡住。

第一个是概念混淆。PWM 的频率、占空比、分辨率、死区、极性，这些术语单独拿出来都能理解，但一结合定时器就乱了。比如有人问“为什么我改了 ARR，频率变了但占空比也变了”，这就是没搞清楚 ARR 同时决定频率和占空比。

第二个是 CubeMX 配置不熟。很多人知道要选 TIM 的 PWM Generation，但分不清 Channel 配置里 Pulse 是什么、Counter Period 是什么、PSC 和 ARR 到底谁影响频率。生成的代码虽然能跑，但初始化参数全靠默认，稍微改个需求就不知道从哪里下手。

第三个是“运行期修改”没搞明白。这是最要命的。项目里不会只在启动时输出一个固定 PWM，往往要根据传感器数据、用户操作或控制算法实时调整频率和占空比。如果直接改 ARR、CCR，不做边界检查，不处理预装载和更新事件，波形可能乱掉，甚至输出异常电平，把后面的功率器件烧掉也不是没可能。

所以这篇不是简单复述“怎么生成 PWM”，而是把“输出 PWM 后，如何动态修改频率与占空比”这个工程问题讲透。重点会放在公式换算、HAL 库接口用法、寄存器生效时机、边界检查这几个实操细节上。

2. PWM 基础概念：频率、占空比和定时器的关系

PWM，全称 Pulse Width Modulation，脉冲宽度调制。本质是让 GPIO 以固定频率输出高低电平，通过改变高电平在一个周期内所占的时间比例，来等效控制输出功率或信号强度。

2.1 频率、占空比、分辨率

频率（Frequency）是 PWM 波每秒钟重复的次数，单位 Hz。频率越高，每个周期越短，输出越平滑，但开关损耗也相应增加。LED 调光通常用几百 Hz 到几十 kHz，电机控制常用 10kHz 到 30kHz，音频应用则要到几十 kHz 甚至上百 kHz。

占空比（Duty Cycle）是一个周期内高电平时间占总周期的比例，通常用百分比表示。占空比 50% 就是半个周期高、半个周期低。占空比 0% 意味着始终低电平，100% 意味着始终高电平。

分辨率（Resolution）描述占空比可以细分的步进数。如果自动重装载值 ARR 是 999，那么占空比可以从 0 到 999 分 1000 级调整，分辨率约为 0.1%。ARR 越大，分辨率越高，但最大 PWM 频率会受限制。

2.2 定时器为什么能产生 PWM

用一句话解释：定时器在内部从 0 数到 ARR，每数到 CCR 时翻转一次输出，数到 ARR 时归零，重新开始下一轮。

如果输出极性配置为高电平有效，那么：

• 计数值小于 CCR 时，输出高电平；
• 计数值大于等于 CCR 时，输出低电平；
• 计数值到达 ARR 后清零，重新计数。

所以 CCR 决定高电平的持续时间，ARR 决定整个周期的长度。二者结合，就生成了频率和占空比都可控的方波。

2.3 频率与占空比的换算公式

设定时器输入时钟为 fCK，预分频系数为 PSC，自动重装载值为 ARR，比较值为 CCR。

PWM 频率：

fPWM = fCK / ((PSC + 1) * (ARR + 1))

占空比：

Duty = CCR / (ARR + 1) * 100%

这里 PSC 和 ARR 都是寄存器值，实际的分频因子和计数周期要分别加 1，这是新手最容易漏掉的地方。例如 fCK = 64MHz，设置 PSC = 63，ARR = 999，那么实际频率是 64MHz / (64 * 1000) = 1kHz。如果把 PSC 写成 64，ARR 写成 1000，频率就是 64MHz / (65 * 1001) ≈ 983Hz，结果完全不同。

从公式也能看出：频率和占空比不是完全独立的。想要只改变频率而不改变占空比，必须同时调整 ARR 和 CCR，让 CCR / (ARR + 1) 的比值保持不变。这个关系在后续动态修改时会反复用到。

2.4 容易混淆的 Timer 参数

在这张表里，PSC 和 ARR 都影响频率，但作用不同。PSC 决定了计数器的时钟频率，ARR 决定了计数器从 0 跑到顶部需要多少个时钟周期。调节频率时，优先考虑改 ARR，因为它不改变计数器的时钟节拍，对占空比分辨率的影响更直观；PSC 更适合做粗调，ARR 适合做细调。

3. 环境准备与 CubeMX 基础配置

要跑通 STM32C5A3R 的 PWM 工程，需要准备以下环境：

• 开发板：STM32C5A3R 芯片的评估板或自制板，本文以通用 TIM 通道演示；
• 调试器：ST-LINK 或兼容调试器，用于下载和在线调试；
• 软件：STM32CubeMX（新版本已支持 STM32C5 系列）、STM32CubeIDE 或 Keil MDK、STM32Cube 固件库；
• 测量工具：示波器或逻辑分析仪。如果没有，可以用 LED 和万用表做粗略验证。

需要注意，STM32C5 系列是较新的产品线，CubeMX 需要较新版本才能识别芯片型号。如果打开软件后在 MCU 选择器里搜不到 STM32C5A3R，要先升级 CubeMX 版本并安装对应的固件包。版本号更新很快，这里不写死，以你实际安装的版本为准。

在 CubeMX 中新建工程的步骤如下：

3.1 选择芯片

打开 STM32CubeMX，点击 New Project，在 MCU Selector 里输入 STM32C5A3R，选中对应型号后开始工程。此时可以顺便设置工程名和保存路径。

3.2 配置时钟源

在 System Core -> RCC 中，将 HSE（高速外部时钟）或 HSI（内部高速时钟）配置为实际板卡使用的时钟源。开发板通常有外部晶振，选择 Crystal/Ceramic Resonator；如果你用的是内部时钟，也可以直接保持 HSI 模式。时钟源会影响后续定时器时钟频率的计算。

3.3 配置定时器和 PWM

在 Timers 中选择一个定时器，例如 TIM3。勾选 Internal Clock，然后在 Channels 列表中选择 Channel1 的 PWM Generation CH1。此时 CubeMX 会自动为你分配一个 GPIO 引脚，并设置为复用功能模式。

这个环节有几个关键配置项：

• Prescaler（PSC）：预分频值，写 64-1 表示 64 分频；
• Counter Mode：Up 向上计数即可；
• Counter Period（ARR）：自动重装载值，写 1000-1 或 1000，取决于你希望的计数周期；
• Auto Reload Preload：建议开启 Enable，这样 ARR 的更新会等待当前周期结束，避免波形撕裂；
• Pulse（CCR）：初始比较值，先写 500，对应 50% 占空比；
• CH Polarity：保持 High 即可，表示高电平有效。

PSC 和 ARR 的具体值要和你的时钟频率、目标 PWM 频率匹配。假设定时器时钟是 64MHz，希望输出 1kHz PWM，那么 PSC*ARR 的关系按前面的公式计算。可以先用一个例子验证：PSC = 64-1，ARR = 1000-1，PWM 频率 = 64MHz / (64 * 1000) = 1kHz。注意 CubeMX 界面上填的是分频值和周期值，有些版本会直接帮你换算并显示最终频率。

3.4 生成工程

配置完成后，在 Project Manager 里选择工具链（STM32CubeIDE 或 MDK-ARM），生成工程。启动代码会自动包含定时器初始化函数 MX_TIM3_Init()，并在 main 函数中调用。PWM 输出还需要你在用户代码中显式启动，后面会写。

4. 用 HAL 库输出第一路 PWM

工程生成后，定时器初始化已经完成，但默认状态下 PWM 并没有真正输出。打开 main.c，可以看到类似下面的初始化代码：

/* 文件路径：Core/Src/main.c */ static void MX_TIM3_Init(void) { TIM_OC_InitTypeDef sConfigOC = {0}; htim3.Instance = TIM3; htim3.Init.Prescaler = 64 - 1; htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 1000 - 1; htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; if (HAL_TIM_PWM_Init(&htim3) != HAL_OK) { Error_Handler(); } sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 500; sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; if (HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1) != HAL_OK) { Error_Handler(); } }

这段代码做了四件核心事情：

• 设置定时器时钟分频和周期，决定 PWM 频率；
• 配置 PWM 模式为 PWM1，即计数值小于 CCR 时输出高电平；
• 配置初始占空比 Pulse = 500；
• 使能 ARR 预装载，避免更新过程中波形瞬间异常。

接下来，在 main 函数的 while(1) 之前加入 PWM 启动代码：

HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

编译下载后，用示波器或逻辑分析仪测量对应引脚，应该能看到频率 1kHz、占空比 50% 的 PWM 波形。如果没有硬件测量工具，也可以在引脚上接一个 LED 串联限流电阻，肉眼观察 LED 亮度，再通过修改 Pulse 值来验证占空比变化。

这里要特别提醒：HAL_TIM_PWM_Start 只是启动了 PWM 输出，它不会阻塞程序。如果你的 while(1) 里还跑了其他任务，PWM 会持续在后台由硬件生成，不占用 CPU。这是定时器 PWM 相比软件延时翻转 GPIO 的最大优势。软件 PWM 用 GPIO 翻转加延时，一方面占用 CPU，另一方面频率越高越容易受中断影响，导致波形抖动；硬件 PWM 则完全没有这些问题。

5. 运行期动态修改 PWM 频率与占空比

跑通固定 PWM 之后，真正的工程问题才刚开始。实际项目中，几乎没有“永远 1kHz / 50%”的需求。你可能需要：

• 呼吸灯：占空比从 0 慢慢加到 100，再慢慢减到 0；
• 电机调速：根据 PID 输出实时改变占空比；
• 信号发生器：按用户输入切换输出频率；
• 电源控制：根据负载动态调整开关频率。

这些需求全部指向同一个能力：运行期修改 PWM 参数。下面拆解几种常见做法。

5.1 修改占空比

修改占空比最标准的方法是 HAL 库的宏：

__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 300);

这个宏本质上是把值写入定时器的 CCR 寄存器。如果你只想调亮度、调速度，不改频率，只改这一个宏就够了。占空比会立即更新，不过要清楚，即使开启了 ARR 预装载，CCR 的更新也要等当前计数周期结束，这个延迟最多一个 PWM 周期，通常可以忽略。

也可以直接使用 HAL 库函数：

HAL_TIM_PWM_Stop(&htim3, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

但这种方式不建议在动态调节时使用。因为 Stop 再 Start 会让输出先回到默认电平，再重新开始，可能造成瞬间毛刺。对于电机、电源这类负载，这种毛刺可能导致电流冲击。

5.2 修改频率并保持占空比不变

如果你只修改 ARR，频率确实变了，但占空比也会变。原因很简单：占空比 = CCR / (ARR + 1)。ARR 增大，分母增大，在 CCR 不变的情况下占空比必然下降；ARR 减小，占空比上升。

假设原来 ARR = 999，CCR = 500，占空比 50%。现在要频率翻倍，ARR 改为 499。如果 CCR 还是 500，已经超过 ARR，输出会变成常高，也就是 100% 占空比。这显然不是想要的结果。

正确做法是同时修改 ARR 和 CCR，保持比例不变：

uint32_t new_freq = 2000; // 目标频率 2kHz uint32_t timer_clock = 64000000; // 定时器时钟 64MHz uint32_t psc = 64 - 1; uint32_t arr = timer_clock / ((psc + 1) * new_freq) - 1; uint32_t ccr = (uint32_t)((uint64_t)(arr + 1) * 50 / 100); // 保持 50% __HAL_TIM_SET_AUTORELOAD(&htim3, arr); __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ccr);

注意这里 ccr 计算用到了 uint64_t 强转，避免 (arr + 1) * 50 在 32 位下溢出。很多 MCU 开发者在做这类乘法时容易忽略中间结果溢出，尤其在频率较大、ARR 接近 65535 时。虽然公式简单，但溢出问题非常真实。

还有一点需要提醒：修改 ARR 时，如果开启了 AutoReloadPreload，新值要等当前周期结束后才生效。如果你希望立即生效，可以在修改后加一条更新事件触发：

__HAL_TIM_SET_AUTORELOAD(&htim3, arr); __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ccr); __HAL_TIM_SET_COUNTER(&htim3, 0); __HAL_TIM_GENERATE_UPDATE(&htim3, TIM_EVENTSOURCE_UPDATE);

这里把计数器清零并生成更新事件，是为了让 ARR 和 CCR 的新值同步生效，避免出现一个周期用了新 ARR 但旧 CCR 的情况。在电机控制等对波形连续性要求高的场景，这一步是有价值的。

5.3 修改预分频值 PSC

除了改 ARR，还可以通过修改 PSC 调整频率。改 PSC 的优点是 CCR 不变时占空比也不变，因为占空比只和 CCR/ARR 有关，与 PSC 无关。

__HAL_TIM_SET_PRESCALER(&htim3, 32 - 1);

但修改 PSC 有一个副作用：PSC 变化后，计数器的计数频率变了，可能导致 PWM 频率变化的同时，占空比分辨率也跟着改变。例如原来 PSC=64，ARR=999，频率 1kHz，占空比分辨率 0.1%。改为 PSC=32 后，如果不改 ARR，频率变成 2kHz，分辨率不变，因为 ARR 没变。但如果你为了保持频率不变而调整 ARR，分辨率就会变化。所以 PSC 和 ARR 的配合需要结合具体需求。

实际项目中，我的建议是：

• 占空比需要精细调节，优先保持 ARR 较大，用 CCR 调节；
• 频率切换范围很大，优先改 PSC，再微调 ARR 精度；
• 频率和占空比都要连续变化，封装成一个函数，统一计算 ARR 和 CCR。

5.4 封装一个动态设置函数

为了让代码可复用，建议把“设置 PWM 频率和占空比”封装成独立函数：

/* 文件路径：pwm_utils.c */ #include "tim.h" static uint32_t pwm_timer_clock = 64000000; /* 根据实际时钟修改 */ void PWM_SetFreqDuty(TIM_HandleTypeDef *htim, uint32_t channel, uint32_t freq_hz, uint8_t duty_percent) { uint32_t psc = 64 - 1; /* 可根据需要改为参数 */ uint32_t arr; uint32_t ccr; if (freq_hz == 0) { return; } arr = pwm_timer_clock / ((psc + 1) * freq_hz) - 1; if (duty_percent > 100) { duty_percent = 100; } ccr = (uint32_t)((uint64_t)(arr + 1) * duty_percent / 100); __HAL_TIM_SET_AUTORELOAD(htim, arr); __HAL_TIM_SET_COMPARE(htim, channel, ccr); }

使用时，只需要在 main 中调用：

PWM_SetFreqDuty(&htim3, TIM_CHANNEL_1, 2000, 25);

这个函数最大的意义是让业务代码不再关心 ARR、CCR 的计算细节。后续要加边界检查、日志输出或限幅逻辑，集中在这个函数里改即可。对于团队协作来说，这种封装能明显降低其他同事使用 PWM 模块的出错率。

6. 验证与测量：如何确认输出正确

完成了代码开发，还必须用实际测量验证输出是否达标。下面给出三种验证方式，从最准确的到最便捷的。

6.1 示波器测量

将示波器探头接到 PWM 输出引脚，地线接开发板 GND，设置触发模式为上升沿，测量频率和占空比。

预期输出：

• 频率接近你设定的目标值，误差在允许范围内；
• 占空比接近你设定的百分比；
• 波形上升沿和下降沿清晰，无明显毛刺。

如果频率偏差较大，第一步检查定时器时钟是否如你预期。很多情况下，CubeMX 默认生成的时钟树会把定时器时钟设置成某个分频后的值，而不是你手动计算的 64MHz。进入调试模式，查看 htim3.Init.Prescaler 和 htim3.Init.Period 的实际值，再倒推频率即可。

6.2 逻辑分析仪测量

没有示波器时，逻辑分析仪是很好的替代方案。把逻辑分析仪通道连接到 PWM 引脚，设置采样率高于 PWM 频率的 10 倍以上，打开协议解析里的 PWM 解码，可以直接读出频率和占空比。

对于 1kHz 信号，逻辑分析仪非常轻松；对于 100kHz 以上的高频 PWM，要检查逻辑分析仪的带宽是否足够，否则测出来的占空比可能失真。

6.3 LED + 人眼粗略验证

如果手头没有测量工具，可以用 LED 做粗验证。LED 串联一个 1k 电阻接到 PWM 引脚，频率固定在 1kHz 时，修改占空比：

• 占空比 0%：LED 灭；
• 占空比 50%：LED 半亮；
• 占空比 100%：LED 全亮。

如果修改频率而不改占空比，LED 亮度应保持不变。这个测试虽然不能给出精确数值，但能验证“频率变化是否影响占空比”这个关键问题。如果频率变了 LED 亮度明显变化，说明 ARR 和 CCR 没有同步修改，公式或代码有问题。

7. 常见问题与排查思路

PWM 开发中遇到的问题，大部分集中在配置错误、公式写错、寄存器生效时机不对这几个方面。下面整理一份排查表格。

在排查 PWM 问题时，建议先不要急着看代码，而是先回答三个问题：

• 定时器时钟是多少？
• PSC 和 ARR 实际写入的是多少？
• CCR 实际写入的是多少？

只要这三个值明确，频率和占空比按公式手算一遍，绝大多数问题都能定位。很多人排查了半天，最后发现是 CubeMX 里的时钟树把定时器时钟分频了，或者自己把 PSC 和 ARR 的值写反了。

8. 工程化最佳实践

PWM 虽然简单，但工程化时有很多细节会影响可靠性和开发效率。下面这些建议来自实际项目经验，供你参考。

8.1 参数集中定义

不要在 main 函数里到处散落定时器参数。建议使用宏或结构体统一管理频率和占空比的默认值，例如：

#define PWM_DEFAULT_FREQ_HZ 1000u #define PWM_DEFAULT_DUTY_PCT 50u #define PWM_MIN_FREQ_HZ 100u #define PWM_MAX_FREQ_HZ 10000u #define PWM_MIN_DUTY_PCT 0u #define PWM_MAX_DUTY_PCT 100u

这样后续调参、做边界检查、对接 UI 或协议，都有明确入口。

8.2 边界检查

动态修改占空比时，一定要防止写入非法值。例如电机控制中，如果 PID 输出异常导致占空比突然为 100%，电机可能过流；如果为 0%，又可能导致动力瞬间中断。更稳妥的做法是在设置函数里加限幅，并且在发现非法输入时保留上一次有效值，而不是直接写入。

8.3 关注 ARR 上限

STM32 的通用定时器 ARR 通常是 16 位，最大值 65535。如果你想输出非常低的频率，比如 1Hz，而定时器时钟是 64MHz，光靠 ARR 可能不够，这时必须加大 PSC。反过来，如果你追求高频率，ARR 会被压到很小，占空比分辨率就会快速下降，可能出现“占空比跳变”的情况。这是定时器 PWM 的固有限制，设计阶段就要评估清楚。

8.4 多个 PWM 通道的同步问题

如果用同一个定时器的多个通道输出 PWM，它们共享同一个 PSC 和 ARR，因此频率必然相同，只能分别修改占空比。如果多个通道需要不同频率，就必须使用不同定时器。这是定时器资源规划时的重要约束。

在多通道场景下，如果希望多路 PWM 的占空比在同一个周期内同时生效，需要利用定时器的更新事件，让所有 CCR 寄存器的更新与周期对齐。HAL 库默认在更新事件后加载新值，但如果你在周期中间改 CCR，新值会在下一个周期生效，看起来是“慢慢移动”，这在呼吸灯效果里反而是优点，在需要精确同步的场合则需要额外处理。

8.5 启动顺序与安全

涉及电机、加热器、功率电源等项目，PWM 启动前要确保负载状态安全。建议按以下顺序操作：

• 先将 CCR 设为 0 或安全值；
• 启动定时器 PWM 输出；
• 再逐步修改占空比到目标值。

停止时反过来，先把占空比降为 0，再停 PWM。这个顺序可以有效避免上电瞬间或停机瞬间的电流冲击。

8.6 结合 DMA 或 ADC

PWM 不只能做输出。可以利用 PWM 上升沿触发 ADC 采样，实现电流环、电压环的同步采样，这在电机控制和电源控制中非常常见。也可以使用 DMA 周期性更新 CCR，实现正弦波输出、SVPWM 等复杂波形。这些方向都是 PWM 的进阶用法，建议先掌握本文的基础，再逐步探索。

9. 总结与后续学习方向

到这里，用 STM32C5A3R 输出 PWM、修改频率和占空比的完整流程已经梳理了一遍。本文从 PWM 的频率、占空比与定时器参数的换算关系切入，完整走过了 CubeMX 工程配置、HAL 库 PWM 启动、运行期动态修改 ARR 与 CCR、以及示波器和逻辑分析仪的验证方法，最后整理了一份常见问题排查表。核心收获可以概括为三点：第一，PWM 频率由 PSC 与 ARR 共同决定，占空比由 CCR 与 ARR 共同决定；第二，动态修改频率时，必须同步调整 CCR 才能保持占空比不变；第三，预装载寄存器和更新事件决定了新参数何时生效，工业场景要特别关注这个时机。

建议你下一步找一个开发板，先在 CubeMX 上配出一路 1kHz / 50% 的 PWM，然后用示波器测量确认；接着试着写一个呼吸灯程序，让占空比从 0 缓慢加到 100；最后写一个按键切换频率的程序，验证修改 ARR 时占空比是否还能保持不变。这个练习做完，你对 PWM 的理解会上一个台阶。

如果这些已经掌握，可以继续研究 PWM 触发 ADC 采样、互补 PWM 加死区、以及 STM32 高分辨率定时器 HRTIM 的用法。这些内容在实际的电机控制、数字电源项目中用得很多，也是从“会配置”走向“会设计”的必经之路。