企业官网建设流程全解析

STM32开发有个很实在的现象：跑马灯和串口打印玩利索之后，下一步十有八九就是折腾PWM。LED亮度渐变、舵机角度控制、蜂鸣器发声、电机调速、RGB灯混色，全都要靠它。这次用STM32C5A3R做一组PWM输出实验，把频率和占空比的动态修改一并打通，整个过程走下来，基本就能摸清这款芯片定时器外设的使用套路了。

STM32C5A3R是ST新一代C系列里比较有代表性的型号，主频、Flash、外设配置都处于中间偏上位置，拿来做PWM输出非常合适。定时器资源充足，高级定时器和通用定时器都有，PWM输出通道数量完全够用，GPIO的复用功能映射也灵活。不过很多人第一次上手C5A3R时会发现，它和F1、F4系列在时钟树配置细节上有些差别，这也是这次实验比较有价值的地方——不只是复制粘贴代码，而是把寄存器级别的配置逻辑说清楚，跟着走一遍就知道为什么这么写。

这篇内容适合正在做ST系列项目、想快速搞定PWM输出的开发者，也适合刚切换到C5系列还不熟悉定时器模块的新手。文章会从PWM基础原理讲起，再到工程配置、代码实现、动态修改频率占空比，最后整理一些实际调试中容易踩的坑，全部基于STM32C5A3R这个型号展开，代码可以直接套用到自己的项目里。

1. 内容整体设计与思路拆解

1.1 PWM输出的本质：你需要什么样的波形

PWM，全称Pulse Width Modulation，脉冲宽度调制。本质上就是让一个GPIO引脚按照固定的周期输出高电平和低电平，通过改变高电平持续的时间（脉宽）来传递不同的控制意图。

对于LED来说，脉宽决定亮度；对于舵机来说，脉宽决定转动角度；对于直流电机来说，脉宽决定平均电压进而决定转速。这里面有两个核心参数：频率（PWM周期）和占空比（高电平时间占整个周期的比例）。

STM32C5A3R的定时器模块生成的PWM波，核心就是三个寄存器的配合：PSC（预分频器）、ARR（自动重装载值）、CCR（捕获比较值）。PSC决定定时器计数时钟的频率，ARR决定计数周期，也就是PWM的频率，CCR决定高电平持续的时间，也就是占空比。三者关系如下：

PWM频率 = 定时器时钟频率 / (PSC + 1) / (ARR + 1) 占空比 = CCR / (ARR + 1) × 100%

理解这个公式是整个实验的地基。后面所有配置和动态修改都围绕这三个寄存器展开，所以我把这一步放在最前面，一定要搞清楚再往下走。

1.2 为什么选定时器PWM而不是软件延时模拟

软件延时的方案其实也能输出类似PWM的波形，写个循环拉高拉低IO就行。但在实际项目中基本不会这么干，原因很简单：CPU被完全占住，什么都干不了，而且频率精度和波形稳定性都很难保证。

定时器输出PWM的好处是硬件自动翻转电平，不占用CPU。配置好之后，定时器会按照设定好的频率和占空比持续输出波形，CPU可以去处理其他任务（比如串口通信、按键扫描、传感器采集），需要调整占空比时只需要改CCR寄存器的值即可。STM32C5A3R的定时器模块还支持中心对齐模式、多通道同步输出、刹车输入等功能，这些在电机控制、逆变电源等场景下非常有用。

这个实验选择的是通用定时器TIM3的通道1，因为TIM3挂在APB1总线上，时钟配置灵活，而且C5A3R的TIM3_CH1可以映射到多个引脚上，方便后续做硬件连接调整。如果你手头的板子引脚冲突，也可以换其他定时器，配置思路完全一样。

1.3 实验目标和整体流程规划

这次实验规划了三个阶段性目标，从简单到进阶，逐步加深对PWM的理解：

第一步，输出一个固定频率占空比的PWM波形，用逻辑分析仪或示波器观察波形是否正确，把PSC、ARR、CCR的计算和配置走通。

第二步，实现动态修改频率和占空比。考虑到实际项目中经常需要在运行过程中调整输出——比如风扇根据温度调速、LED呼吸灯效果、电机加速减速——这几个操作必须熟练。

第三步，做一个相对完整的综合实验：用按键中断动态调整PWM的频率或占空比，通过串口打印当前参数值，让整个系统的人机交互感觉出来。

为了在调试时能直观看到波形变化，这里选了一个比较典型的频率档位方案：基础PWM频率设为20kHz（对电机控制来说这是很常用的频率，高于人耳听觉范围，不会有啸叫），占空比初始设为50%，后续通过按键以10%为步进增减占空比，再用另一个按键对频率进行多档切换。

2. 核心细节解析与实操要点

2.1 STM32C5A3R的定时器资源与时钟树配置

C5A3R内部有多个定时器，从功能上分大致可以分成三类：高级定时器（TIM1/TIM8）、通用定时器（TIM2/TIM3/TIM4/TIM5等）和基本定时器（TIM6/TIM7）。做PWM输出，通用定时器就够用了，高级定时器多了互补输出和死区插入功能，主要用于电机控制、全桥变换器等场景。

时钟树是这次实验最需要留意的地方。C5A3R的APB1和APB2总线时钟配置会直接影响定时器的计数频率。和F1系列类似，如果APBx预分频器不为1，定时器时钟是APBx时钟的2倍；如果APBx预分频器为1，定时器时钟就等于APBx时钟。很多人在这上面翻车，配出来的PWM频率和计算的差了一倍甚至两倍。

具体到C5A3R，假设系统主频配置为250MHz，APB1时钟125MHz但预分频系数为2时，TIM3的时钟就是250MHz。这个值直接从CubeMX的时钟树页面观察，确保TIM3的时钟频率显示值和你的计算基准一致。

本次工程我将TIM3的时钟频率设为250MHz，通过PSC = 249，ARR = 49来得到20kHz的PWM频率。计算过程如下：

PWM频率 = 250MHz / (249 + 1) / (49 + 1) = 250MHz / 250 / 50 = 20kHz

这个频率段在实际工程中很常用，电机驱动、LED调光、D类功放都经常用到，人为选在了这个档位，也方便后面验证。

2.2 GPIO映射与复用功能配置细节

PWM波形从定时器通道引脚输出到外部，因此GPIO必须配置为复用功能模式，而不是普通推挽输出。很多人直接把GPIO设为输出模式然后开始写电平翻转代码，那和用定时器输出PWM是两条完全不同的路。

在C5A3R上，GPIO复用功能的配置使用HAL库代码如下：

GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_TIM3_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_6; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; GPIO_InitStruct.Alternate = GPIO_AF2_TIM3; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

这里有个关键参数是Alternate，它决定了GPIO引脚复用为哪个外设功能。不同引脚复用到TIM3的通道号不同，需要查数据手册中的Alternate Function Mapping表。比如PA6对应TIM3_CH1，Alternate值可能是GPIO_AF2_TIM3，但有些型号的PB4可能映射到TIM3_CH1的AF2，有些又不同。这个不能靠猜，必须查芯片对应的数据手册或参考CubeMX自动生成的结果。

另外，如果引脚速度配置过低（比如GPIO_SPEED_FREQ_LOW），在高频PWM（比如几百kHz）下波形边沿会变得圆润，影响信号质量。这次实验用的是20kHz，普通速度就够，但在做高频PWM时一定要注意这个细节。

2.3 PWM模式的本质：向上计数、向下计数还是中心对齐

STM32定时器的PWM模式分为PWM模式1和PWM模式2，两种模式的区别在于有效电平的判断逻辑不同。在PWM模式1下，向上计数时，CNT < CCR时输出有效电平，CNT >= CCR时输出无效电平；PWM模式2则刚好反过来。

实际使用中，PWM模式1用得最多。此外还有一个常被忽略的配置项——计数模式，即TIM_COUNTERMODE_UP（向上计数）、TIM_COUNTERMODE_DOWN（向下计数）、TIM_COUNTERMODE_CENTERALIGNED1/2/3（中心对齐模式）。向上计数和向下计数输出的波形本质一样，但中心对齐模式会有差异：计数器的值先增后减，PWM输出在半个周期内有效。这种模式在电机控制中很有用，可以让PWM波形对称，降低谐波成分，并且在计数器到达顶点时触发ADC采样，可以获得和PWM同步的采样点。

对于本次实验，采用最基本的向上计数+PWM模式1即可，但我会在代码中把中心对齐模式的配置也注释出来，方便后续在电机控制场景下直接修改。

2.4 三个关键寄存器的精确计算：实战案例

前面提到过三个核心参数的计算公式，这里用一个实际案例完整走一遍。如果需求是“输出频率10kHz，占空比30%的PWM，从PA6输出”，按以下步骤计算：

先确定定时器时钟。假设TIM3时钟为250MHz。注意，这里的250MHz指的是定时器外设本身收到的时钟，不是系统主频，也不是APB1时钟，中间可能隔着分频器。

计算PSC和ARR。先将PSC设为249，这样计数时钟为250MHz / 250 = 1MHz，也就是计数器每1微秒加1。然后为了得到10kHz频率，周期为100微秒，所以ARR = 100 - 1 = 99。合在一起：10kHz = 250MHz / (249 + 1) / (99 + 1)。

计算CCR。占空比30%，则高电平时间占30微秒，CCR = 30% × 100 = 30。在PWM模式1向上计数时，CNT从0计数到29期间输出高电平，CNT从30计数到99期间输出低电平，占空比正好30%。

代码配置如下：

TIM_OC_InitTypeDef sConfigOC = {0}; htim3.Instance = TIM3; htim3.Init.Prescaler = 249; htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 99; htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(&htim3); sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 30; sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

这里有个小细节：AutoReloadPreload建议置为ENABLE，ARR会在更新事件时才会真正加载到影子寄存器，避免在计数过程中修改ARR时出现波形异常。同理，CCR可以通过TIM_OC1PreloadConfig使能预装载，保证占空比更新不会撕裂波形。

3. 实操过程与核心环节实现

3.1 初始化工程：基于STM32CubeMX生成基础代码

打开STM32CubeMX，选择芯片型号STM32C5A3R，双击进入配置页面。先确认调试接口为Serial Wire，避免后续无法连接调试器。然后在Pinout视图中找到PA6，将其配置为TIM3_CH1。这时在右侧配置面板中会自动出现TIM3的配置项。

在Clock Configuration页面检查TIM3的时钟输入，记录下当前值。正如前面所说，C5A3R的TIM3时钟输入值和APB1预分频设置直接相关，务必确保这个值与你的计算基准一致。如果TIM3时钟显示的数值不合适，可以调整时钟树中的分频系数，但要注意不要影响USART等其他外设的时钟（通常USART1挂在APB2上，影响不大，但USART2、USART3挂在APB1上）。

然后切换到TIM3的配置页面，在Slave Mode中设为Disable，在Internal Clock处确认时钟源勾选。在Parameter Settings中配置Prescaler为249，Counter Mode为Up，Counter Period为49，AutoReload Preload为Enable。在PWM Generation Channel1中配置Mode为PWM Generation CH1，Pulse为25（对应50%占空比），Output compare preload为Enable，Fast Mode为Disable，CH Polarity为High。

生成工程时选择STM32CubeIDE或MDK-ARM，生成后会自动包含MX_GPIO_Init、MX_TIM3_Init等函数。这里特别提醒：生成的代码默认不会启动PWM输出，必须在main函数里手动调用HAL_TIM_PWM_Start。

3.2 基础PWM输出：验证20kHz、50%占空比的波形

在main函数中，在MX_TIM3_Init()之后加上PWM启动代码：

HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

编译下载后，用逻辑分析仪或示波器测量PA6引脚的波形。正常应看到周期为50微秒（20kHz）的方波，高电平和低电平各占25微秒（50%占空比）。如果没有示波器，可以用一个LED串联电阻接到PA6，观察LED的亮度——50%占空比下LED应该是半亮状态，但用视觉判断精度很差，只能做大致的初步验证。

实测时我发现，有些逻辑分析仪在20kHz时的波形显示没问题，但采样率不够高的便宜设备会把边沿显示得倾斜，这属于测量工具的问题，不是代码的问题。建议采样率至少为信号频率的20倍以上，也就是400kS/s以上。

3.3 动态修改占空比：呼吸灯实验

占空比的动态修改是最常见的操作，HAL库提供了现成的宏：

__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 25);

这行代码将CCR的值设为25，如果ARR为49，占空比即为25/50 = 50%。改变CCR即可实现呼吸灯效果：

uint16_t duty = 0; int8_t direction = 1; while (1) { __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, duty); HAL_Delay(5); duty += direction; if (duty >= 49) { direction = -1; duty = 49; } else if (duty <= 1) { direction = 1; duty = 1; } }

呼吸灯实现起来很简单，但有个容易踩的坑：当CCR的值大于ARR时，PWM输出会一直保持高电平；当CCR为0时，输出会一直为低电平。所以在步进循环时必须限制CCR的范围，不能让它越过ARR。我在代码中把上下限分别掐在1和49，没有到0和50，这样波形始终有跳变沿，LED不会出现极端的全亮或全灭状态，视觉效果也更自然。

3.4 动态修改频率与占空比：完整闭环实验

如果要同时修改频率和占空比，思路是同时更新PSC和ARR，再根据新的ARR值重新计算CCR。PSC修改后，要触发一次更新事件让预装载值生效，否则要等一个计数周期才生效，这在实时性要求高的项目中可能是不可接受的。

修改频率的核心代码：

void PWM_SetFrequency(uint32_t freq_khz) { uint32_t arr_value = 1000000 / freq_khz; // 假设计数时钟为1MHz uint32_t ccr_value = arr_value * duty_percent / 100; __HAL_TIM_SET_PRESCALER(&htim3, 249); __HAL_TIM_SET_AUTORELOAD(&htim3, arr_value - 1); __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ccr_value); __HAL_TIM_GENERATE_EVENT(&htim3, TIM_EVENTSOURCE_UPDATE); }

这里注意，__HAL_TIM_SET_PRESCALER修改的是预分频寄存器的影子值，必须在更新事件后才能生效。加上__HAL_TIM_GENERATE_EVENT强行触发一次更新事件，可以保证修改立即生效。如果不加这一行，PSC值会在下一次计数器溢出时才生效，对于频率切换场景来说可能会造成额外一个周期的延迟。

同时，在修改ARR时如果使能了AutoReloadPreload，ARR会延迟到更新事件时才生效。如果关闭了预装载，ARR直接写入影子寄存器，立即生效但有撕裂风险。实际项目中推荐保持预装载使能，然后手动触发更新事件，这样既安全又快速。

3.5 完整的按键调整实验：频率和占空比组合调整

把上面的功能组合起来，做一个可通过按键调节频率和占空比的完整程序：

uint16_t duty = 50; // 占空比百分比 uint32_t freq = 20; // 频率 kHz，初始20kHz while (1) { if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_SET) { duty += 10; if (duty > 90) duty = 10; PWM_SetDuty(freq, duty); printf("Duty: %d%%\r\n", duty); HAL_Delay(200); } if (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) == GPIO_PIN_SET) { freq += 5; if (freq > 100) freq = 5; PWM_SetFrequency(freq); PWM_SetDuty(freq, duty); printf("Freq: %d kHz\r\n", freq); HAL_Delay(200); } }

其中PWM_SetDuty的实现为：

void PWM_SetDuty(uint32_t freq_khz, uint16_t duty_percent) { uint32_t psc_value = 249; uint32_t arr_value = (SystemCoreClock / (psc_value + 1)) / (freq_khz * 1000) - 1; uint32_t ccr_value = arr_value * duty_percent / 100; __HAL_TIM_SET_PRESCALER(&htim3, psc_value); __HAL_TIM_SET_AUTORELOAD(&htim3, arr_value); __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ccr_value); __HAL_TIM_GENERATE_EVENT(&htim3, TIM_EVENTSOURCE_UPDATE); }

这个实现里一个核心细节是：PWM_SetDuty函数里的arr_value是根据当前设置的PSC和频率实时计算的。如果PSC是固定249，计数时钟是1MHz，那么arr_value = 1000 / freq_khz - 1。20kHz时arr为49，50kHz时arr为19，占空比计算时用整数乘除法，整数除法会丢弃小数部分，导致占空比有量化误差。比如50kHz、ARR=19时，10%占空比对应的CCR为1.9，取整为1，实际占空比只有5.26%。这种量化误差在高频时尤其明显，实际工程中需要评估是否能接受。

有一个优化空间：如果希望保持占空比精度，可以改用CCR微调的方式，或者降低PSC以增大ARR的余量。比如计数时钟设为10MHz，ARR的数值范围变大，同样的10%占空比就能获得更高的精度。但代价是PSC变小、功耗略增、更新事件更频繁。取舍需要根据实际应用来定。

3.6 PWM常见应用场景的参数选择参考

PWM参数选型是实际项目中绕不开的一环，不同的负载和应用场景对频率、占空比范围的要求差异很大。我把工作中积累的一些经验值整理在下面，方便大家做方案时快速参考：

• LED调光：频率建议1kHz到10kHz，太高会有可闻噪声（尤其是输出电容有啸叫风险），太低会肉眼看到频闪。1kHz以上基本无感。
• 蜂鸣器：有源蜂鸣器直接给高低电平即可，无源蜂鸣器的PWM频率就是声音频率，常见2kHz到4kHz，占空比50%。
• 直流电机调速：建议15kHz到25kHz，低于15kHz容易产生人耳可闻的啸叫，高于25kHz时电机驱动器的开关损耗会显著上升。此区间内20kHz是个合理点。
• 舵机控制：频率固定在50Hz（周期20ms），占空比范围通常在5%到10%之间，对应0.5ms到2.5ms的脉宽。这里PWM频率不能乱调，必须锁定在50Hz左右。
• 无刷电机FOC驱动：典型载波频率在16kHz到50kHz之间，同时需要互补PWM和死区插入，这时应该选用高级定时器TIM1/TIM8。
• 加热器控制：频率通常在1Hz到100Hz，占空比直接对应加热功率，频率过高会导致继电器频繁通断，烧毁触点，SSR可以放宽。

表格如下：

3.7 串口调试：实时打印参数

为了在实验中直观看到频率和占空比的当前值，通过串口将参数打印出来。C5A3R的USART1默认映射在PA9/PA10，波特率115200，8位数据位，无校验，1位停止位。在CubeMX中配置好USART1后，使用重定向printf的方式输出：

#ifdef __GNUC__ int _write(int fd, char *ptr, int len) { HAL_UART_Transmit(&huart1, (uint8_t *)ptr, len, HAL_MAX_DELAY); return len; } #endif

然后结合前面的按键逻辑，按下按键后串口输出当前的freq和duty值。这个调试手段在实际项目中非常关键，没有串口打印，只靠示波器观察，很多时候你根本不知道代码内部的执行逻辑是否正确。

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

实际调试中踩过的坑，比看十遍数据手册都管用。这里把几个典型的故障场景和排查思路整理出来，每一项都是真实发生过的，希望对大家有帮助。

4.1 引脚没有波形输出

排查思路按以下顺序过一遍：

先确认GPIO复用功能是否正确。检查GPIO_InitStruct.Alternate的值是否和芯片型号匹配。很多人从F1项目的代码迁移过来，F1用GPIO_PinAFConfig函数来配置复用，C5A3R用HAL的Alternate参数，两者形式不同，容易遗漏或配错。

再确认定时器时钟已使能。CubeMX生成代码中通常会在MX_TIM3_Init里调用__HAL_RCC_TIM3_CLK_ENABLE()，如果手动编写初始化代码，很容易忘记这一步。定时器没有时钟，PWM自然无从谈起。

接着确认PWM已启动。HAL_TIM_PWM_Start这一步不可省略，它使能了定时器主输出和通道输出。很多人初始化完就直接看波形，发现没有输出，就是因为没启动PWM。

最后确认引脚连接。PA6是否被复用为TIM3_CH1，有没有和其他外设冲突。在CubeMX中如果引脚冲突，会在Pinout页面用黄色或红色标出，创建工程前就应该消除冲突。

4.2 PWM频率和计算值不一致，差了2倍

这个90%是时钟树配置的问题。前面提到过，APB1预分频系数不为1时，定时器时钟是APB1的2倍，很多人直接拿APB1的时钟频率去算PWM频率，结果频率正好翻了一倍。

排查方法很直接：在CubeMX的Clock Configuration页面，点击TIM3的时钟输入位置，查看实际显示的频率值，以这个值为准重新计算PSC和ARR。同时在代码中，可以通过HAL_RCC_GetPCLK1Freq()获取APB1时钟频率，然后根据APB1的分频系数（通过RCC->CFGR & RCC_CFGR_PPRE1读取）来推断定时器时钟：

uint32_t timer_clk = HAL_RCC_GetPCLK1Freq(); if (RCC->CFGR & RCC_CFGR_PPRE1_2) // 分频系数>1 timer_clk *= 2;

不过最稳妥的方式还是从CubeMX的时钟树上读取，因为代码方式解析寄存器位的逻辑在不同系列上有差异，容易踩坑。

4.3 动态修改频率后，波形过一个周期才变化

前面提到，PSC和ARR的预装载功能会导致修改延迟一个周期生效。这在某些应用中是致命的，比如电机控制器在紧急刹车时希望立即改变PWM输出。

解决方案是在修改PSC和ARR后，手动调用__HAL_TIM_GENERATE_EVENT(&htim3, TIM_EVENTSOURCE_UPDATE)强制产生更新事件。这样PSC和ARR的预装载值会立即写入影子寄存器，新的频率立即生效。

另外，如果不需要预装载功能，可以关闭AutoReloadPreload，这样ARR的修改会立即生效。但关闭预装载后，如果在计数过程中修改ARR，可能产生不完整的PWM周期，需要根据实际需求权衡。

4.4 占空比突变到0%或100%

这基本是CCR和ARR的关系处理不当导致的。CCR大于ARR时输出持续高电平（100%占空比），CCR为0时输出持续低电平（0%占空比）。比如在动态调整频率时，先改了ARR，再改CCR，中间就会有一个短暂的不一致状态，表现为波形毛刺。

解决方法：调整参数时保持原子性，先计算好新的ARR和CCR，再依次写入。如果对实时性要求极高，可以考虑使用DMA方式更新CCR，或者在临界区中操作。但最简单的方案还是按照“先算后写”的顺序来，代码见前面的PWM_SetDuty函数。

4.5 PWM波形有毛刺或抖动

导致波形毛刺的原因比较多，逐一排查：

• 电源纹波过大。如果给MCU供电的电源噪声很大，PWM输出引脚可能出现额外的抖动。解决方法是保证供电稳定，在电源引脚附近增加去耦电容。
• 调试器断开时机不当。使用ST-Link在线调试时，如果程序在修改PWM寄存器的指令处停下，波形会暂时保持当前状态，这是正常的，不是代码问题。
• 中断优先级配置不当。如果在PWM更新中断或外部中断中修改CCR，且中断优先级和主循环中修改CCR的操作发生竞争，可能导致CCR写入撕裂。建议动态修改CCR的操作统一放在主循环中，或通过信号量保证互斥。
• 时钟源不稳定。如果使用了PLL倍频且倍频系数很高，时钟抖动可能比较大，进而导致PWM频率有一定抖动。对于PWM输出要求高的场景，可以考虑使用HSE直接驱动或降低PLL倍频系数，看波形是否有明显改善。

4.6 代码中使用了printf但串口不输出

重定向printf的函数名和实现方式在不同编译器下不同。GCC工具链（STM32CubeIDE）使用_write，ARMCC（Keil MDK）使用fputc。如果换了IDE没有同步修改重定向函数，printf输出就不会生效。

另外，检查USART1的GPIO配置是否正确，波特率是否匹配，调试助手的串口号是否选对。在C5A3R上，USART1_TX映射到PA9，USART1_RX映射到PA10，但如果板子使用了USB转串口芯片，要留意TTL电平是否和调试助手匹配。

4.7 快速排查表

5. PWM进阶：死区、刹车与中心对齐模式

5.1 死区时间：为什么电桥电路必须设置死区

如果只是驱动LED或单端负载，普通的PWM输出就够了。但在H桥、三相逆变等电机驱动电路里，同一桥臂的上下两个开关管（MOSFET或IGBT）如果有任何一瞬间同时导通，就会发生直通短路，烧毁功率管。

防止直通的关键就是死区时间——上下管切换时留出一段“两者都不导通”的时间窗口。这个时间通常在几百纳秒到几微秒之间，取决于功率管的关断延迟、栅极驱动电路的设计等。

STM32的高级定时器（TIM1/TIM8）支持在互补PWM输出中自动插入死区时间。通过配置TIM_BreakDeadTimeConfigTypeDef结构体的DeadTime参数来设定。C5A3R的TIM1_CH1和TIM1_CH1N就是一对互补输出，直接在CubeMX中配置死区时间即可。死区时间不是拍脑袋定的，需要参考功率管的datasheet中关断延迟时间（td_off）和下降时间（tf），一般来说，死区要大于这两者之和。

5.2 刹车功能：PWM故障保护的硬件级实现

刹车功能可以理解为PWM输出的硬件级保护机制。当刹车输入引脚检测到异常信号（比如过流、过压、过热信号）时，定时器会立即停止PWM输出，并且输出去激活状态，从而保护功率电路。这个响应是硬件级别的，不依赖CPU的中断响应时间，在纳秒级到微秒级就能完成封锁。

C5A3R的高级定时器提供了刹车输入引脚，配置方法是使能Break功能、选择Polarity（高有效还是低有效），并设置自动恢复还是锁存。在电机驱动项目中，将过流保护信号连接到刹车输入，是标配做法。如果只做通用PWM输出实验，这个功能可以先不管，但了解它的存在很重要，等做电源和电机项目时会用到。

5.3 中心对齐模式与ADC同步采样

默认的向上计数模式中，PWM在CNT达到ARR时溢出，高电平从CNT=0开始持续到CNT=CCR。这种模式的波形不对称，在电机控制中会产生偏置电流，降低控制精度。

中心对齐模式下，计数器先向上计数到ARR，再向下计数到0。PWM输出高电平的起始点不在加减计数器的边界，而是在计数器的中间位置，波形左右对称，谐波成分更小。这也是FOC等高性能电机控制算法中使用中心对齐模式的原因。

如何配置中心对齐模式下的ADC采样时刻？正确做法是使用定时器的触发输出，在计数器到达特定位置（比如上溢或下溢点）时触发ADC注入组转换。C5A3R的TIM1/8支持这种触发联动，配置时需要在CubeMX中将TIM1的Trigger Output配置为Update Event或OC1REF，然后在ADC的配置中启用外部触发转换。这样就能保证每个PWM周期中，ADC采集的电流值正好对应PWM中点附近的平均电流，采样噪声最小。

需要注意的是，中心对齐模式下，修改CCR时如果预装载未使能，波形会在计数中点附近产生不对称，这点和向上计数模式相同，启用CCR预装载可解决问题。

5.4 为什么有些PWM应用必须考虑动态频率自适应

在PMSM电机控制中，PWM频率的选择不仅是噪声问题，还直接影响电流环带宽和开关损耗。传统的固定PWM频率在电机转速很低或很高时都存在效率问题。近年的自适应频率控制思路是：在低速段用较高频率来降低电流纹波，在高速段适当降低频率来减小开关损耗。

PMSM的开关频率受限于MCU的ADC采样周期和FOC算法执行时间。C5A3R如果主频足够，FOC的运算时间可以控制在几十微秒内，PWM频率还能提高一些空间。自适应频率控制在代码层面其实就是本文章前面实现的动态修改PSC和ARR。有了这个基础，后续根据转子速度动态调整PWM频率就顺理成章了。

5.5 PWM的误区和边界：不是频率越高越好

很多人以为PWM频率越高越好，其实不然。频率高，波形平滑，噪声小，但开关损耗正比于频率，MOSFET的栅极驱动损耗也会上升。20kHz的开关频率下，一个MOSFET的开关损耗是10kHz时的两倍。在小型电机驱动中，20kHz已经足够，再往上升，波形可能更好看，但功率管发热会明显加剧。

另一个边界是占空比的分辨率。PWM频率越高，ARR越小，占空比的调节档位就越少。100kHz的PWM，如果ARR从0到49，只有50级占空比调节，很难做精细的电流控制。而10kHz的PWM，ARR可以达到2499，占空比调节精细得多。所以在项目设计中，选择PWM频率时不仅要考虑负载特性，还要评估占空比的精度需求。

6. 写在最后的实际调试建议

用STM32C5A3R做完这组PWM实验，几个体会比较深。第一点，PWM输出的稳定性强烈依赖于时钟树的正确配置，动手写代码之前先把CubeMX时钟树页面里的TIM时钟频率截图记录下来，后面所有计算结果都以这个值为基准，别用脑子里的默认值。第二点，动态修改频率时一定要考虑预装载的生效时机，这决定了你的控制实时性是否达标，而不是代码能不能跑起来。第三点，示波器或逻辑分析仪是PWM调试的必备工具，如果没有，至少准备一个LED和串口打印，否则出了问题只能盲猜。

还有个实用的排查技巧：如果波形频率和预期差很多，优先怀疑PSC和ARR的取值是否让计数器溢出。PSC和ARR都是16位的，最大65535。如果计算出的ARR超过65535，说明PSC太小了，需要换算。例如要输出1Hz的PWM，计数时钟1MHz，ARR需要999999，超出了16位范围，这时必须加大PSC，让计数时钟降低到64左右，ARR才能落在合理区间内。推荐的计算顺序是先根据目标频率和16位ARR的限制反推PSC，再精确算出ARR。

做PWM实验时我习惯在CubeMX中把TIM3的所有通道都配置成PWM输出，哪怕只用一个通道。这样如果后续想快速验证多通道PWM的同步输出，可以直接在代码里启动其他通道，不用重新生成工程。另外，TIM3还能通过DMA方式更新CCR，这在需要输出正弦波（SPWM）或渐变波形的场景下非常有用，实现方式是在ARR中断中通过DMA搬运正弦表数据到CCR寄存器，有兴趣的读者可以沿着这个方向继续深入。

这套实验做完，PWM从原理到代码实现，从静态输出到动态调整，从单通道到多通道扩展，算是彻底走通了。下一阶段可以尝试把PWM和ADC联动起来，比如做一个通过电位器调节亮度的闭环系统，或者把输出接在电机驱动板上做一个简易的电机调速器，逐步建立完整的嵌入式控制思路。