STM32G431 PWM配置实战：从原理到电机驱动应用-开发者社区

1. 从需求到实现：为什么要在STM32G431上搞PWM？

如果你正在玩电机控制、LED调光或者需要生成一个精确的时序信号，那么PWM（脉冲宽度调制）绝对是你绕不开的核心技能。尤其是在STM32这类资源丰富的MCU上，实现PWM功能看似简单，但真想把它调得“听话”、稳定、符合项目要求，里面门道可不少。我最近在基于STM32G431RBT6这颗Cortex-M4内核的芯片做一个小型伺服驱动项目，PWM就是驱动核心。网上教程很多，但要么是HAL库函数调用一笔带过，要么是CubeMX配置完就结束，真到了实际项目里，时钟树怎么配才能输出想要的频率？互补输出和死区时间怎么设置才安全？寄存器底层到底发生了什么？这些问题不搞清楚，调起来就是一头雾水。

STM32G431属于STM32G4系列，主打高精度模拟外设和数字滤波器，它的定时器（特别是高级定时器如TIM1/TIM8）功能非常强大，远不止简单的“开-关”信号。我们不仅要让它输出PWM，更要理解如何利用其特性，比如中央对齐模式、刹车功能、互补输出等，来满足实际工业应用中的需求。这篇文章，我就结合在STM32G431RBTx上的实战，把PWM从原理、配置到调试的完整链条掰开揉碎讲清楚，目标是让你看完后，不仅能配置出PWM，更能明白每一个参数背后的意义，遇到异常能自己排查。

2. 核心原理拆解：PWM不仅仅是“占空比”

很多人对PWM的理解停留在“调节占空比就能改变平均电压”的层面，这没错，但对于嵌入式开发，尤其是使用STM32高级定时器，我们需要更底层的视角。

2.1 PWM的本质与定时器核心机制

PWM波本质上是一个周期固定、脉冲宽度可调的方波。在STM32中，生成PWM的核心硬件是定时器（Timer）。以最常用的通用定时器（如TIM2、TIM3、TIM4）和高级定时器（TIM1、TIM8）为例，它们都包含以下几个关键寄存器，共同协作产生PWM：

自动重装载寄存器（ARR）：这个寄存器决定了PWM波的周期。定时器计数器（CNT）从0开始向上计数，每来一个时钟脉冲就加1，一直加到ARR的值，然后产生一个更新事件（Update Event），同时CNT清零重新开始。所以，PWM的周期T = (ARR + 1) * T_clk，其中T_clk是定时器的计数时钟周期。
捕获/比较寄存器（CCRx）：这是控制脉宽（占空比）的关键。你可以把它理解为一个“比较值”。定时器CNT在计数的过程中，会不断地和CCRx的值进行比较。
捕获/比较模式寄存器（CCMRx）：这里配置比较模式。对于PWM输出，我们需要将其设置为“PWM模式1”或“PWM模式2”。这两者的区别在于输出极性：
- PWM模式1：在向上计数时，当CNT < CCRx，通道输出有效电平（通常为高电平）；当CNT ≥ CCRx，输出无效电平。向下计数时逻辑相反。
- PWM模式2：逻辑与模式1相反。
捕获/比较使能寄存器（CCER）：用于使能或失能对应的输出通道，以及配置输出极性（高电平有效还是低电平有效）。

整个工作流程可以想象成一场“赛跑”：ARR值是跑道长度（周期），CCRx值是终点线上的一个标记（比较点）。计数器CNT是运动员，从起点（0）开始跑。在“PWM模式1”下，运动员跑过CCRx标记之前，输出高电平；跑过之后，直到跑完一圈（到达ARR）再回到起点，这段时间输出低电平。通过改变CCRx这个标记的位置，就改变了高电平的时间，即占空比。

2.2 STM32G431定时器的特色与选型

STM32G431的定时器资源丰富，选择哪个定时器取决于你的具体需求：

高级控制定时器（TIM1, TIM8）：这是功能最强大的定时器。除了基本PWM，它支持互补输出（带死区插入）、刹车输入（用于紧急关断）、中央对齐模式（用于电机控制，减少谐波）等。如果你的应用涉及电机驱动（H桥）、电源转换，必须使用高级定时器。
通用定时器（TIM2, TIM3, TIM4, TIM15, TIM16, TIM17）：TIM2/3/4是标准的通用定时器，功能全面，适合大多数PWM应用，如LED调光、蜂鸣器驱动。TIM15/16/17是“高分辨率定时器”，具有更高的时钟频率和更精细的分辨率，适合需要非常精细占空比调整的场景。
基本定时器（TIM6, TIM7）：这类定时器没有输出通道，不能直接产生PWM，主要用于产生定时中断或触发DAC。

注意：在CubeMX中，TIM1的通道默认标识为“CHx”，而其互补通道标识为“CHxN”。使能互补输出（Complementary）后，必须同时配置死区时间（Dead Time），否则上下桥臂可能直通，烧毁硬件。

对于大多数入门和中级应用，从通用定时器开始上手更简单。但如果你明确要做电机驱动，直接从TIM1开始啃硬骨头是更高效的选择。我这次的项目需要驱动一个三相BLDC电机，所以毫不犹豫地选择了TIM1的三个通道（CH1, CH2, CH3）及其互补通道（CH1N, CH2N, CH3N）。

3. 实战配置：从CubeMX到代码生成

理论清楚了，我们动手配置。我将以驱动一个频率为20kHz，初始占空比为50%的PWM为例，使用TIM1的通道1。选择20kHz是因为这个频率高于人耳听觉上限（用于驱动无刷电机时噪音小），同时开关损耗在可控范围内。

3.1 STM32CubeMX图形化配置详解

打开CubeMX，选择你的STM32G431RBTx芯片。

时钟树（Clock Configuration）配置：这是确保PWM频率精确的第一步。STM32G431最高可运行于170MHz。假设我们使用内部HSI（16MHz）通过PLL倍频到80MHz作为系统时钟（SYSCLK）。我们需要找到定时器的时钟源。
- 在Pinout视图，找到TIM1，激活Clock Source为Internal Clock。
- 切换到Clock Configuration标签页。定时器通常挂载在APB总线上。对于TIM1，它挂在APB2总线上。你需要确保APB2的预分频器（APB2 prescaler）设置正确。如果APB2预分频器不为1，则定时器实际时钟是APB时钟的2倍。例如，系统时钟80MHz，APB2预分频器设为/2，则APB2时钟为40MHz，但TIM1的时钟会是80MHz（因为有一个x2的机制）。这一点CubeMX通常会帮你计算好，但你必须心里有数。我们假设TIM1的输入时钟（TIMxCLK）为80MHz。
定时器参数（Parameter Settings）配置：在左侧找到TIM1，进入配置。
- Prescaler (PSC)：预分频器。定时器时钟TIMxCLK = 80MHz，如果我们希望计数器（CNT）的计数频率为1MHz（即每个计数周期1us），则PSC = (TIMxCLK / 期望计数频率) - 1 = (80MHz / 1MHz) - 1 = 79。输入79。
- Counter Mode：计数模式。选择Up（向上计数）。对于电机控制，Center Aligned（中央对齐）模式也很常用，它会让计数器先向上再向下计数，PWM波形关于中心对称，有利于减少电磁干扰。
- Counter Period (ARR)：自动重装载值。这决定了PWM频率。PWM频率Fpwm = 定时器计数频率 / (ARR + 1)。我们希望Fpwm = 20kHz，定时器计数频率为1MHz，所以ARR = (1MHz / 20kHz) - 1 = 50 - 1 = 49。输入49。
- Internal Clock Division (CKD)：时钟分频，保持默认No Division。
- auto-reload preload：自动重载预装载，建议使能（Enable）。这样只有在发生更新事件时，新写入的ARR值才会生效，防止在修改参数时产生毛刺。
PWM通道配置：在下方找到Channel1，选择PWM Generation CH1。
- Mode：会显示为PWM mode 1。
- Pulse (CCR1)：脉冲宽度，即捕获/比较寄存器的初始值。占空比 =Pulse / (ARR + 1)。初始占空比50%，即Pulse = (ARR + 1) * 50% = 50 * 0.5 = 25。输入25。
- Fast Mode：快速模式，禁用即可。使能后，在比较匹配时输出会立即改变，而不是等到下一个计数周期，一般用于需要快速响应的场景。
- CH Polarity：通道极性。选择High，表示有效电平为高。如果你希望默认输出低电平，脉冲是高电平，则选择Low。
GPIO设置：配置完成后，对应的引脚（PA8 for TIM1_CH1）会自动被配置为复用推挽输出（Alternate Function Push Pull）。你可以在Pinout视图确认，也可以调整输出速度（Output Speed），对于PWM，建议设置为High以减少边沿失真。
生成代码：在Project Manager中设置好工程名、路径、IDE（如MDK-ARM或STM32CubeIDE），然后在Code Generator中勾选Generate peripheral initialization as a pair of ‘.c/.h’ files，这样定时器的配置代码会独立成模块，方便管理。最后点击GENERATE CODE。

3.2 生成的代码分析与关键函数解读

CubeMX生成的代码结构清晰，我们重点关注tim.c和main.c。

在tim.c的MX_TIM1_Init函数中，你可以看到我们刚才所有配置的寄存器赋值过程。例如：

htim1.Instance = TIM1; htim1.Init.Prescaler = 79; htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 49; htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter = 0; htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE;

以及PWM通道的配置：

sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 25; sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1);

在main.c的用户代码区，我们需要手动启动PWM输出。

/* 在定时器初始化后，启动PWM */ HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1);

这一行代码至关重要，它启动了定时器的计数并使能了指定通道的输出。如果没有调用，即使配置正确，引脚上也没有波形。

3.3 动态调整PWM占空比

项目中经常需要实时改变占空比，比如调节电机速度、LED亮度。HAL库提供了非常简单的函数：

/* 设置TIM1通道1的占空比为75% */ __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 38); // 38 = 50 * 0.75

或者使用更通用的函数：

TIM1->CCR1 = 38; // 直接操作寄存器，速度最快

__HAL_TIM_SET_COMPARE宏本质上也是操作CCR1寄存器。在中断或主循环中调用此函数即可实时更新占空比。需要注意的是，在中央对齐模式下，修改CCRx最好在计数器为0（更新事件）时进行，以避免不对称的PWM脉冲。HAL库的__HAL_TIM_SET_COMPARE是即时生效的，对于要求严格的应用，可以配合__HAL_TIM_GET_COUNTER判断计数状态后再修改。

4. 进阶应用与避坑指南：不止于基础输出

当你成功在示波器上看到稳定的20kHz、占空比可调的方波后，恭喜你，入门了。但实际项目中的挑战才刚刚开始。

4.1 互补输出与死区时间插入：电机驱动的安全锁

使用TIM1驱动H桥或半桥电路时，我们需要一对互补的PWM信号（CHx和CHxN）来控制上下桥臂的开关。绝对不能同时导通，否则会造成电源短路（直通），瞬间烧毁MOS管。死区时间（Dead Time）就是在互补信号切换时，插入一个两者都为低电平（或无效电平）的短暂重叠时间，确保一个管子完全关断后，另一个管子才开启。

在CubeMX中配置TIM1的通道1为PWM Generation CH1和PWM Generation CH1N，即可启用互补输出。关键步骤在Parameter Settings页面的底部：

Dead Time：死区时间。需要计算。死区时间取决于你使用的MOS管或IGBT的开关特性（尤其是关断延迟时间）。假设我们需要500ns的死区时间。定时器时钟是80MHz，一个计数周期是12.5ns。Dead Time = 500ns / 12.5ns = 40个计数周期。STM32的死区时间发生器有专门的公式和寄存器（DTG），CubeMX帮我们封装了。我们选择Dead Time为40 * 定时器时钟周期，或者直接选择0.5 us（如果单位可选）。CubeMX会自动计算并设置BDTR寄存器的DTG[7:0]位。
Break and Dead-time register (BDTR) configuration：这里还可以配置刹车功能（Break）的极性、使能等。刹车功能通常连接到一个外部故障信号（如过流检测），一旦触发，会强制所有输出进入安全状态（通常为固定电平），是重要的保护机制。

配置完成后，用示波器同时测量CH1（PA8）和CH1N（PA7）的波形，你应该能看到两个反相、且在高电平转换边缘有一个微小重叠低电平区域的方波，那个重叠区域就是死区。

4.2 测量与调试：没有示波器怎么办？

不是每个人都有豪华的示波器。调试PWM时，可以借助一些简单方法：

LED+电阻：这是最直观的方法。将一个LED（串联一个1kΩ限流电阻）接到PWM输出引脚和地之间。改变占空比，LED的亮度会平滑变化。如果LED常亮或常灭，说明PWM没启动或配置错误。
万用表直流电压档：测量PWM引脚对地的平均电压。平均电压Vavg = Vcc * DutyCycle。例如，3.3V供电，50%占空比，测得的平均电压应该在1.65V左右。当动态改变占空比时，电压表读数会相应变化。这可以用来粗略验证占空比控制是否生效。
STM32自身的输入捕获：如果你有另一个定时器，可以将其配置为输入捕获模式，用来测量PWM信号的频率和占空比。这是一种“自检”的好方法。
逻辑分析仪：相比示波器便宜很多，但同样可以抓取数字波形，查看频率、占空比、死区时间，是性价比极高的调试工具。

4.3 常见问题排查链路

问题：引脚上没有输出任何信号。

排查链1：时钟与初始化
1. 检查SystemClock_Config()函数是否被正确调用，系统时钟是否配置到预期频率？可以用HAL_RCC_GetSysClockFreq()函数打印验证。
2. 检查MX_TIM1_Init()是否被调用？确保定时器初始化结构体htim1的配置无误。
3. 检查HAL_TIM_PWM_Start()是否被调用？这是最容易忘记的一步。
排查链2：GPIO与复用
1. 在CubeMX生成的main.c中，检查MX_GPIO_Init()函数，确认对应引脚（如PA8）的模式被正确初始化为GPIO_MODE_AF_PP（复用推挽输出）。
2. 使用调试器，在运行时查看该GPIO端口的MODER寄存器，看是否被设置为复用模式（0b10）。
排查链3：寄存器级诊断
1. 在调试器中查看TIM1的CR1寄存器，确保CEN位（Counter ENable）为1（已启动）。
2. 查看CCER寄存器，确保对应通道（如CC1E）为1（输出使能）。
3. 查看CCMR1寄存器，确保OC1M位域被设置为PWM模式（110或111）。

问题：PWM频率或占空比不对。

1. 双检查PSC和ARR的计算公式。确认你用的定时器时钟（TIMxCLK）频率是多少。一个常见错误：忽略了APB预分频器对定时器时钟的x2效应，导致实际频率是预期的一半或两倍。
1. 检查Pulse（CCRx）的值是否在0到ARR之间。如果大于ARR，占空比将始终为100%。
1. 如果使用__HAL_TIM_SET_COMPARE动态修改占空比无效，检查是否在修改前关闭了通道输出？通常不需要关闭。检查传入的通道参数是否正确（TIM_CHANNEL_1）。

问题：互补输出不正常，没有死区或直通。

1. 检查CubeMX中是否同时使能了CHx和CHxN。
1. 检查死区时间（Dead Time）是否已配置并启用。查看BDTR寄存器的DTG位域。
1. 用示波器同时观察两个通道，确认死区时间是否出现。如果没有，检查MOS管驱动电路是否正常，有时是硬件问题。

5. 从定时器到应用：PWM的工程化思考

掌握了单个PWM的产生，我们要把它放到更大的系统里去看。

5.1 同步多个定时器：复杂系统的节拍器

在一些应用中，比如三相逆变器，需要三个相位互差120度的PWM波。我们可以使用一个定时器（TIM1）作为主模式（Master），产生统一的时钟和更新事件，去触发另外两个从定时器（TIM2, TIM3），并设置从定时器的计数偏移来实现相位差。

在CubeMX中，这可以通过配置定时器的“触发输出”（Trigger Output）和“从模式”（Slave Mode）来实现。例如，将TIM1配置为Master，Trigger Event Selection选择为Update Event。然后将TIM2配置为Slave，Trigger Source选择为ITR0（内部触发0，对应TIM1），Slave Mode选择为Trigger Mode。这样，TIM1的每次更新都会复位并启动TIM2的计数。通过设置TIM2的TIMx->CR1寄存器中的CR1_CKD或使用延迟，可以引入相位差。这是一种高级用法，需要仔细阅读参考手册的定时器同步章节。

5.2 结合DMA与ADC：实现闭环控制

PWM开环控制是基础，闭环才是精髓。例如，在电机控制中，我们根据ADC采样到的电流值，通过PID算法实时调整PWM占空比。这个过程对实时性要求极高。

一种高效的做法是利用定时器的更新事件（或比较匹配事件）触发ADC采样，采样完成后由DMA将数据搬运到内存，然后在ADC转换完成中断中处理数据并更新PWM占空比。STM32G431的定时器可以直接通过硬件连接触发ADC，精度和延迟远优于软件触发。这需要配置定时器的TRGO输出，以及ADC的External Trigger Source。

5.3 资源权衡与性能优化

分辨率与频率的权衡：PWM的分辨率由ARR值决定。分辨率 =1 / (ARR + 1)。ARR=49时，分辨率约2%。如果你需要0.1%的精细调光，ARR需要999，但此时如果定时器时钟不变，PWM频率会下降到1kHz。提高定时器时钟（减小PSC）可以提高频率，但受限于系统时钟上限。你需要根据应用需求（如电机控制的频率要求、LED调光无闪烁要求）来权衡。
使用高分辨率定时器（HRTIM）：对于开关电源等需要极高PWM精度和灵活性的应用，STM32G431内置的HRTIM是更好的选择。它可以提供皮秒级的分辨率，但配置也更为复杂。
减少CPU干预：尽量利用定时器的硬件特性，如DMA、触发同步、刹车等，让硬件自动完成工作，把CPU解放出来处理更复杂的算法和通信任务。

折腾STM32的PWM，从点灯到驱动电机，是一个不断深入硬件细节的过程。最开始你可能只关心占空比，后来会关注死区时间，再后来会研究如何用硬件同步和触发来构建精密的控制系统。我个人的体会是，千万不要只停留在调用HAL库函数的层面。多翻翻参考手册里定时器那章的结构图，理解每个寄存器位的作用，遇到异常时学会通过调试器查看寄存器状态。这样，当项目需求从“输出一个PWM”变成“输出一组严格同步、带保护、可动态调整的PWM”时，你才能从容应对。最后一个小技巧：建立一个自己的“外设驱动验证工程”，每学透一个外设（如PWM、ADC、SPI），就把它模块化、封装好，并写好测试用例。以后在新项目中直接复用，能节省大量调试时间。