1. 从零开始：为什么PWM是电机调速的“灵魂”？

大家好，我是老张，一个在嵌入式领域摸爬滚打了十多年的“老司机”。今天咱们不聊那些虚头巴脑的理论，直接上手，聊聊在蓝桥杯竞赛里，怎么用STM32G431RBT6这块板子，把TIM4定时器玩出花来，实现精准的PWM电机调速。很多新手朋友一听到PWM、定时器、自动重装载这些词就头大，感觉是芯片厂商故意设置的“劝退”环节。别怕，今天我就用最“人话”的方式，带你一步步打通关。

PWM，中文叫脉冲宽度调制，听起来高大上，其实原理特别生活化。你可以把它想象成一个水龙头开关。如果你一直把水龙头开到最大，水流就是恒定的，这就像给电机一个固定的电压，它就一直全速转。但如果你想控制水流大小，比如只想要一半的水量，你会怎么做？聪明人可能会选择快速、反复地开关水龙头：开一秒，关一秒，再开一秒，再关一秒……这样平均下来，水流就变成了一半。PWM干的就是这个事儿，它通过高速、精准地控制一个引脚输出高电平（开）和低电平（关）的时间比例，来模拟出不同的“平均电压”，从而控制电机的转速。这个“时间比例”，就是我们常说的“占空比”。占空比50%，就相当于电机半速运转；占空比80%，电机就接近全速了。

在蓝桥杯的嵌入式赛道里，尤其是涉及到智能小车、舵机控制这些题目，PWM绝对是你的核心武器。而STM32G431RBT6这款芯片，内部集成了多个高级定时器（TIM）和通用定时器，TIM4就是其中一个非常灵活好用的通用定时器，特别适合用来生成PWM波。为什么不用软件模拟PWM？因为软件模拟要占用大量CPU时间，精度也差，而硬件定时器产生的PWM波，频率稳定、占空比精准，完全解放了CPU，让你的主程序可以安心去处理传感器数据、逻辑判断这些更重要的任务。所以，掌握TIM4的PWM配置，是你从“点灯侠”晋级到“控制大师”的关键一步。

2. 手把手配置：CubeMX里的TIM4-PWM设置详解

理论懂了，咱们就开干。第一步，也是最关键的一步，就是在STM32CubeMX这个图形化配置工具里，把TIM4的PWM通道给正确“点亮”。很多同学配置完发现引脚没输出，或者频率不对，八成就是这一步的细节没抠对。我踩过的坑，今天都给你填平。

首先，打开CubeMX，选择你的STM32G431RBT6芯片型号。在左侧的“Pinout & Configuration”选项卡里，找到“Timers”分类，点开“TIM4”。你会看到TIM4有四个通道：CH1到CH4。每个通道都可以映射到特定的GPIO引脚上。比如，我想用PA6引脚输出PWM，那么我就找到“TIM4_CH1”，点击它，在下拉菜单里选择“PWM Generation CH1”。这时候，软件会自动把PA6引脚配置为复用推挽输出模式，你会在芯片引脚图上看到PA6变成了绿色，这就说明配置生效了。这里有个小技巧：在配置前，最好先看一眼你的硬件原理图，确认你想用的PWM输出引脚没有被LCD屏、LED灯或者其他外设占用，避免后面出现“灵异”的冲突问题，这个我们后面会细说。

配置好引脚，接下来就是重头戏：参数设置。点击“Parameter Settings”标签页，这里面的每一个参数都直接影响你PWM波的“长相”。

• 时钟源（Clock Source）：默认选择“Internal Clock”就行，表示使用芯片内部的系统时钟。

• 预分频器（Prescaler, PSC）：这是第一个决定频率的参数。定时器的时钟频率 = 系统时钟 / (PSC + 1)。STM32G431的系统时钟频率很高（比如180MHz），直接用它来计数太快了，我们需要先分频降速。假设系统时钟是180MHz，我们想让定时器计数时钟降到1MHz，那么PSC就设置为 (180MHz / 1MHz) - 1 = 179。

• 计数模式（Counter Mode）：对于PWM，我们通常选择“Up”，即向上计数模式。计数器从0开始，一直加到我们设定的重装载值，然后归零，如此循环。

• 自动重装载值（Counter Period, ARR）：这是第二个决定频率，同时也是决定PWM分辨率的关键参数。它定义了PWM波的周期。PWM的频率 = 定时器时钟频率 / (ARR + 1)。接上面的例子，定时器时钟是1MHz，如果我们想要一个1kHz的PWM波，那么ARR = (1MHz / 1kHz) - 1 = 999。同时，ARR也决定了占空比调节的精细程度。如果你设置ARR为999，那么占空比就可以从0/1000到1000/1000，有1001个调节档位，非常精细。在CubeMX里，这个值就是“Counter Period”。这里有一个至关重要的选项，叫做“auto-reload preload”（自动重装载预装载）。我强烈建议你把它设置为“Enable”。这是什么意思呢？它相当于一个“双缓冲”机制。当你修改ARR或者CCR（捕获/比较寄存器，决定占空比）的值时，新值并不会立即生效，而是先放在一个“预备寄存器”里。等到当前PWM周期完整结束后，新值才会被装载进工作寄存器，开始下一个新周期。这样做的好处是，可以确保每一个PWM周期都是完整的，不会出现“半截子”波形，从而避免了电机在调速时产生抖动或噪音。对于电机控制来说，稳定性压倒一切，所以这个选项务必打开。

• PWM模式（PWM Mode）：在通道配置里（比如Channel1），模式选择“PWM Mode 1”或“PWM Mode 2”。两者的区别在于输出极性。通常我们选择“PWM Mode 1”，在计数器值小于CCR时输出有效电平（高电平），大于时输出无效电平。你可以根据后续的电机驱动电路需求，在下面的“Output Compare Polarity”里选择高电平有效还是低电平有效。

• 脉冲（Pulse）：这个值就是初始的CCR值，决定了初始占空比。比如ARR设为999，Pulse设为500，那么初始占空比就是50%。这个值后面我们完全可以通过代码动态修改。

最后，别忘了在“NVIC Settings”里，如果你需要用到PWM周期更新中断或者捕获比较中断，就把对应的中断使能勾选上。对于简单的调速应用，我们可能不需要中断，但如果你想像原始文章里那样，做一个呼吸灯效果或者更复杂的波形，中断就派上用场了。配置完成后，点击“GENERATE CODE”，生成初始化代码。

3. 代码实战：让电机转起来并听话

CubeMX帮我们生成了底层的初始化代码（MX_TIM4_Init），它已经帮我们把定时器、PWM通道、GPIO都设置好了。我们的任务，就是在主程序中启动PWM，并学会如何动态地改变占空比，让电机转速随心所欲。

3.1 启动PWM输出

生成的代码里，会有一个htim4的结构体变量，它包含了TIM4的所有配置信息。要让PWM开始输出，非常简单，只需要在main函数的初始化部分（/* USER CODE BEGIN 2 */ 区域）调用HAL库提供的启动函数：

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

这一句执行后，你连接到PA6引脚（假设你用的是CH1）的示波器上，应该就能看到一个稳定的PWM方波了，占空比就是你之前在CubeMX里设置的“Pulse”值。如果接上了电机驱动模块（比如L298N、TB6612等），电机就应该开始匀速转动了。

3.2 动态调整占空比（调速核心）

让电机转起来只是第一步，让它根据我们的指令快慢变化，才是精髓。调整占空比，本质就是修改对应通道的捕获/比较寄存器（CCR）的值。HAL库提供了非常直观的函数：

__HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_1, 新的CCR值);

或者，你也可以直接操作寄存器，这样效率更高，在中断等对实时性要求高的场合常用：

htim4.Instance->CCR1 = 新的CCR值; // 直接设置TIM4的CCR1寄存器

这里有一个非常重要的细节，就是原始文章里提到的“htim是结构体变量不是指针”。在生成的代码里，htim4是一个TIM_HandleTypeDef类型的结构体变量，所以我们要用点操作符.来访问它的成员Instance。而Instance是一个指向TIM_TypeDef寄存器结构的指针，所以后面我们要用箭头->来访问具体的寄存器（如CCR1）。这个区别一定要搞清楚，否则编译会报错。

那么，这个“新的CCR值”怎么来呢？这完全取决于你的控制逻辑。比如，你想用一个按键控制加速减速：

// 假设按键按下，每次增加50个步进
if(KEY_UP_Pressed) {
    uint16_t current_pulse = __HAL_TIM_GET_COMPARE(&htim4, TIM_CHANNEL_1);
    current_pulse += 50;
    if(current_pulse > 999) current_pulse = 999; // 不要超过ARR值
    __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_1, current_pulse);
}

或者，你想让电机做一个平滑的呼吸灯式加速减速，就像原始文章里的示例代码那样。那个代码其实是一个在PWM周期更新中断（或脉冲完成回调）里自动调整CCR值的经典例子。它定义了一个方向标志cnt_dir，让temp_pluse（即CCR值）在5000到10000之间往复增减，从而产生占空比周期性变化的效果，电机转速就会呈现“加速-减速-加速”的循环。不过原文代码是给TIM3的CH3写的，我们用到TIM4上要相应改一下句柄和通道。

3.3 避开那些“坑”：硬件冲突与中断使用

原始文章里反复强调了一点：“一定不要让LCD影响到LED端口（LCD的初始化及其执行的函数都要屏蔽掉）”。这绝对是血泪教训。在蓝桥杯的官方板子上，资源是有限的，引脚复用情况非常复杂。可能TIM4的某个PWM输出通道，恰好和LCD屏的某个数据线或控制线是同一个引脚。如果你既初始化了LCD，又初始化了TIM4的PWM，那么后初始化的外设会覆盖前一个的配置，导致其中一个功能失效。

怎么排查和解决？

1. 查手册/原理图：这是最根本的方法。找到STM32G431RBT6的数据手册和蓝桥杯板子的原理图，查看你打算使用的引脚（如PA6）的复用功能。确认它除了作为TIM4_CH1，是否还被其他外设（如SPI、I2C、USART或者直接驱动了LED）占用。
2. 在CubeMX中检查：在Pinout视图，你可以看到每个引脚当前配置的功能。如果有冲突，引脚会显示为橙色或红色警告。你必须做出取舍，要么换一个PWM通道，要么禁用冲突的外设。
3. 代码隔离：如果比赛题目允许，且你暂时用不到LCD，最干脆的办法就是在main.c里注释掉LCD的初始化函数MX_LCD_Init()以及所有LCD显示相关的函数调用。等调试完PWM电机控制，再根据需要恢复。

关于中断，原始文章里提到了“别忘了打开定时器3的中断”。对于PWM生成，我们通常不需要开启定时器更新中断，除非你有特殊需求，比如在每个PWM周期结束时都要执行一段代码（像那个呼吸灯算法）。如果你需要，就在CubeMX的NVIC设置里使能“TIM4 global interrupt”，然后在代码中重写更新中断回调函数HAL_TIM_PeriodElapsedCallback()。但要注意，中断服务函数里代码一定要简洁，快进快出，否则会影响PWM本身的稳定性。

4. 进阶技巧：让电机控制更丝滑稳定

基础功能实现后，我们可以追求更极致的控制效果。这里分享几个我实战中总结的进阶技巧。

首先，PWM频率的选择是一门学问。 频率不是随便设的，它需要匹配你的电机和驱动电路。

• 频率太低（比如几十Hz）：你会听到电机发出明显的“滋滋”声，这是线圈在通断时产生的振动噪音，而且电机转动可能不够平滑，会有顿挫感。
• 频率太高（比如几十kHz以上）：开关损耗会增加，有些简单的电机驱动模块（如晶体管）可能响应不过来，导致波形畸变，效率下降。
• 常用范围：对于普通的直流有刷电机，1kHz到20kHz是一个比较理想的区间。在这个范围内，电机运行平稳，噪音小，大多数驱动电路也能很好工作。你可以用前面讲的公式（频率 = 定时器时钟 / (ARR+1)）来反推ARR值。比如定时器时钟是1MHz，想要10kHz的PWM，ARR就设为99。

其次，占空比与速度的关系并非完全线性。 特别是电机在低速启动时，由于静摩擦力等因素，你可能发现占空比低于某个阈值（比如20%），电机根本不转，这叫“死区”。而一旦转起来，低速区的转速增长可能比占空比增长更快。为了获得更好的线性控制手感，你可以尝试建立一张“占空比-速度”查找表，或者使用简单的PID算法来闭环控制转速（如果板子上有编码器的话）。在蓝桥杯的开放题中，这种细节优化往往是拿高分的关键。

最后，电源一定要干净且功率充足。 电机是“用电大户”，启动和堵转时电流很大。如果直接用电开发板的5V或3.3V引脚给电机供电，很可能导致板子电压被拉低，单片机复位，或者PWM波形变形。务必使用独立的电源给电机驱动模块供电，并且确保电源地（GND）和开发板的地连接在一起。在电机电源线上并联一个大电容（如100uF的电解电容）来缓冲瞬间电流冲击，也是立竿见影的稳定措施。

调试时，万用表和示波器是你的好帮手。用万用表测量PWM引脚的平均电压，它应该等于（占空比 * 引脚高电平电压）。用示波器看波形，确保波形干净、方波陡直、没有毛刺。如果波形不好，检查一下GPIO的输出速度设置（在CubeMX引脚配置里，可以设置为“High”），以及硬件上是否有过长的飞线。

纸上得来终觉浅，绝知此事要躬行。PWM配置的每个参数，都亲手调一调，看看电机反应有何不同；硬件冲突的坑，亲自踩一次，印象才深刻。蓝桥杯的赛场，比拼的不仅是知识，更是这种在有限时间内快速定位和解决实际问题的动手能力。希望这篇从原理到配置、从代码到调试的全程解析，能帮你把TIM4-PWM这个工具牢牢握在手里，在接下来的比赛中，让你控制的小车跑得又快又稳。