STM32通用定时器PWM控制舵机：从原理到CubeMX实战

1. 从零开始：为什么用STM32的通用定时器控制舵机是个好主意

如果你玩过Arduino，控制舵机可能就是一句servo.write(angle)的事，简单到让人忽略了背后的原理。但当你从Arduino转向更强大、也更“底层”的STM32时，你会发现事情没那么简单了。没有现成的Servo库，你得自己“造轮子”。这时候，通用定时器的PWM功能就成了你的最佳拍档。我最初从Arduino转到STM32做机器人项目时，就在舵机控制上栽过跟头，以为随便给个高低电平就能转，结果舵机要么纹丝不动，要么抽搐乱转。后来才明白，舵机吃的是一套非常精确的“语言”——PWM信号。而STM32的通用定时器，天生就是生成这种精确语言的专家。

STM32CubeMX这个工具，对于从零开始配置STM32项目来说，简直是“神器”。它通过图形化界面帮你搞定时钟树、外设初始化这些繁琐又容易出错的底层配置，自动生成初始化代码。对于PWM生成，它能把定时器复杂的预分频、自动重载值、捕获/比较通道这些寄存器操作，变成几个直观的参数设置。这意味着，即使你对定时器的底层寄存器不那么熟悉，也能快速、正确地让STM32输出舵机需要的PWM波形。这不仅仅是“偷懒”，更是确保项目基础稳定可靠的关键一步。本文，我就以最常用的SG90舵机为例，手把手带你用STM32CubeMX配置通用定时器，生成精准的PWM波，并实现从0到180度的角度控制。你会发现，理解了这套流程，你不仅能控制舵机，更能透彻理解STM32中PWM的工作原理，以后控制电机、LED调光都能触类旁通。

2. 核心原理拆解：PWM如何“说服”舵机转动

在动手配置之前，我们必须先搞清楚舵机到底需要什么样的信号，以及STM32的定时器如何产生这个信号。这能让你在后续配置时，每一个参数设置都心中有数，而不是机械地填数字。

2.1 舵机的PWM控制协议：一份精确的时间合同

舵机内部有一个控制电路和一个电机。它并不关心你给的电压幅值有多高（在额定电压范围内），它只认信号的“时间”。标准舵机（如SG90）的控制信号是一个周期为20毫秒（ms）的PWM波。关键就在于每个周期内高电平的持续时间，这个持续时间被称为“脉冲宽度”。

• 0.5ms脉宽：通常对应舵机的最小角度（如0度）。
• 1.5ms脉宽：通常对应舵机的中间角度（如90度）。
• 2.5ms脉宽：通常对应舵机的最大角度（如180度）。

这是一个线性关系。对于180度舵机，其角度控制公式可以概括为：脉冲宽度 (ms) = 0.5ms + (目标角度 / 180°) * 2ms

所以，舵机实际上是在不断地“测量”你发送的脉冲宽度，并驱动电机转到对应的位置。它要求这个20ms的周期必须相当稳定，脉宽必须精确，否则就会导致抖动、定位不准或发出吱吱的噪音。

2.2 STM32通用定时器如何生成PWM：时钟与比较的艺术

STM32的通用定时器（如TIM2, TIM3, TIM4等）功能强大，PWM生成只是其功能之一。其核心原理基于一个计数器、一个自动重载值和一个比较值。

1. 时钟源：定时器由系统时钟（经过分频后）驱动，产生一个基础的计数时钟（CK_CNT）。比如，系统时钟72MHz，经过72分频，得到1MHz的计数时钟，意味着计数器每1微秒（us）加1。
2. 计数器（CNT）与自动重载寄存器（ARR）：计数器从0开始，在每个计数时钟沿加1，一直加到我们预设的“自动重载值”（ARR），然后清零重新开始，如此循环，形成一个周期。这个周期就是PWM信号的周期。PWM周期 = (ARR + 1) / (定时器时钟频率)。
3. 捕获/比较寄存器（CCR）与输出比较：我们还会设置一个“捕获/比较寄存器”（CCR）的值。定时器会不断将计数器CNT的值与CCR值进行比较。
4. PWM模式：通常我们使用“PWM模式1”。在这个模式下，当CNT < CCR时，定时器对应的输出通道（比如CH1）输出高电平（或低电平，可配置）；当CNT >= CCR时，输出反转。这样，CCR的值就直接决定了每个PWM周期内高电平的持续时间，即脉冲宽度。占空比 = CCR / (ARR + 1)。

通过精确计算并设置ARR和CCR，我们就可以让定时器输出一个周期20ms、脉宽在0.5ms到2.5ms之间精确可调的PWM波，完美匹配舵机的需求。STM32CubeMX的工作，就是帮我们可视化地完成这些寄存器参数的计算和配置。

3. STM32CubeMX项目配置全流程：一步步搭建PWM引擎

这里我以STM32F103C8T6（蓝色药丸核心板）和SG90舵机为例，演示配置过程。其他型号STM32（如F4、H7系列）和舵机原理完全相同，只需调整时钟等参数。

3.1 创建工程与核心外设选择

首先，打开STM32CubeMX，点击“New Project”。在芯片选择器中输入你的型号，例如STM32F103C8，选择具体的STM32F103C8Tx，点击“Start Project”。

在图形化界面中，你需要关注两个关键部分：

1. 系统核心（System Core）->SYS：将Debug改为Serial Wire。这非常重要，它启用了SWD调试接口，让你能用ST-Link等工具下载和调试程序，否则芯片可能配置一次后就无法再次编程。
2. 连接性（Connectivity）（如果使用特定定时器）或定时器（Timers）：找到你计划使用的通用定时器。对于基本的PWM，TIM2、TIM3、TIM4等都是不错的选择。我们以TIM3的通道1（CH1）为例，它对应到芯片的某个具体引脚（如PA6）。在引脚图上找到TIM3_CH1，其引脚可能显示为灰色，点击它，选择PWM Generation CH1。引脚颜色会变成绿色，表示已启用并配置为复用推挽输出（AF_PP）。

3.2 时钟树配置：一切精度的源头

点击上方“Clock Configuration”标签页。这里是整个系统时序的基石，配置错误会导致所有定时都不准。 对于STM32F103，一个常见的高性能配置是：

• 使用外部高速时钟（HSE），假设你板载了8MHz晶振。
• 在PLL配置中，将HSE作为PLL源，倍频到72MHz。
• 将系统时钟（SYSCLK）来源选择为PLL，这样系统主频就是72MHz。
• APB1总线时钟（APB1 Prescaler）通常设置为2分频，得到36MHz。但这里有个关键点：如果APB1预分频系数不为1，那么挂载在APB1上的定时器时钟（如TIM2-4）会自动倍频2倍。所以，当APB1时钟为36MHz时，TIM3的实际时钟是72MHz。CubeMX的时钟树图会清晰地显示这个“x2”的关系。请务必确认你的定时器时钟（在这里是72MHz），这是后续计算的基础。

3.3 定时器参数计算与配置：将需求转化为参数

点击“Timers” -> “TIM3”。我们需要根据舵机需求和时钟频率，计算并填写几个核心参数。

• 预分频器（Prescaler, PSC）：这个值用于对定时器时钟进行第一次分频，得到计数时钟CK_CNT。我们的目标是让计数器计数一个数的时间，方便我们最终控制脉宽精度（比如1us）。定时器时钟72MHz，如果我们想让计数器每1us加1，那么计数频率应为1MHz。因此，PSC = 72MHz / 1MHz - 1 = 71。CubeMX里填71。

  注意：公式是PSC = (定时器时钟频率 / 期望计数频率) - 1。因为预分频器是0起始的。

• 计数模式（Counter Mode）：选择Up（向上计数），即从0加到ARR。

• 自动重载值（Counter Period, ARR）：这个值决定了PWM的周期。我们需要20ms的周期。计数时钟是1MHz，即每计数一次是1us。20ms = 20,000 us。所以，ARR = 20000 - 1 = 19999。CubeMX里填19999。

  注意：公式是ARR = (PWM周期 * 计数频率) - 1。周期20ms，频率1MHz（即1/us），所以20000 * 1 - 1 = 19999。

• Pulse（脉冲值，即初始的CCR）：这是初始的占空比对应的比较值。根据公式，1.5ms脉宽（对应90度）需要的计数值是1500us / 1us = 1500。我们填1500。后续在代码中会动态修改这个值来控制角度。

• 时钟分频（Clock Division）：保持为0（不分频）。

• 重复计数器（Repetition Counter）：高级定时器才有，通用定时器保持0。

• PWM生成通道配置：在下方“Channel1”下拉菜单确认是PWM Generation CH1。模式（Mode）通常就是PWM mode 1。输出极性（Pulse）选择High，表示CNT<CCR时输出高电平，这是我们舵机信号需要的。如果选择Low，则逻辑相反，通常不建议。

配置完成后，TIM3的配置界面应该显示周期为20ms，脉宽为1.5ms，占空比7.5%，这与我们的设计相符。

3.4 生成工程代码：从图形到C语言

点击上方“Project Manager”标签页。

• 给项目起个名字，比如Servo_PWM_Control。
• 选择工程路径。
• “Toolchain / IDE”选择你使用的IDE，例如MDK-ARM V5（Keil）。
• 在“Code Generator”部分，建议勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”，这样每个外设的代码会单独成文件，结构更清晰。
• 最后，点击右上角的“GENERATE CODE”。CubeMX会生成完整的初始化代码工程。

4. 代码编写与角度控制逻辑实现

打开生成的Keil工程（或其他IDE工程）。CubeMX已经为我们生成了定时器和GPIO的初始化代码MX_TIM3_Init()，并在main.c中调用。我们需要做的是启动PWM输出，并编写函数来动态改变CCR值，从而控制角度。

4.1 启动PWM输出

在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间（即外设初始化之后，主循环之前），添加启动PWM通道的代码：

HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

这行代码调用了HAL库函数，启动了TIM3的通道1的PWM输出。此时，如果你用示波器测量PA6引脚，应该能看到一个周期20ms、脉宽1.5ms（因为初始CCR=1500）的PWM波。

4.2 编写角度控制函数

我们需要一个函数，输入目标角度（0-180），自动计算对应的CCR值，并更新定时器。在/* USER CODE BEGIN 4 */和/* USER CODE END 4 */之间（用户代码区）添加这个函数：

/** * @brief 设置舵机角度 * @param angle: 目标角度，范围0-180 * @retval None */ void Servo_Set_Angle(uint16_t angle) { // 将角度限制在0-180范围内 if(angle > 180) angle = 180; // 核心计算公式：脉冲宽度(us) = 500 + angle * (2000 / 180) // 因为我们的计数时钟是1us一次，所以脉冲宽度数值上等于CCR值 // 简化计算：CCR = 500 + angle * 2000 / 180 // 为避免浮点数，先乘后除：CCR = 500 + (angle * 2000) / 180 // 进一步简化分数：2000/180 = 100/9 ≈ 11.111... // 为了更精确，我们使用整数运算：CCR = 500 + (angle * 100) / 9 uint16_t pulse_width_us = SERVO_MIN_PULSE + (angle * (SERVO_MAX_PULSE - SERVO_MIN_PULSE)) / 180; // 更新TIM3通道1的捕获/比较寄存器值 __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, pulse_width_us); }

为了使代码更清晰、易于调整，建议在文件开头/* USER CODE BEGIN PD */处定义舵机的参数：

#define SERVO_PWM_PERIOD 20000 // PWM周期20ms，对应ARR+1 #define SERVO_MIN_PULSE 500 // 0度对应的脉宽0.5ms，单位us #define SERVO_MAX_PULSE 2500 // 180度对应的脉宽2.5ms，单位us

这样，Servo_Set_Angle函数可以写成：

void Servo_Set_Angle(uint16_t angle) { if(angle > 180) angle = 180; uint16_t pulse = SERVO_MIN_PULSE + (angle * (SERVO_MAX_PULSE - SERVO_MIN_PULSE)) / 180; __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, pulse); }

__HAL_TIM_SET_COMPARE是一个HAL库宏，它安全地更新了CCR寄存器的值。这个操作是即时生效的，会在下一个PWM周期就改变脉宽。

4.3 在主循环中测试

现在，你可以在main函数的while(1)循环中调用这个函数来测试舵机了。例如，让舵机在0度、90度、180度之间循环：

/* USER CODE BEGIN WHILE */ while (1) { Servo_Set_Angle(0); HAL_Delay(1000); // 等待1秒 Servo_Set_Angle(90); HAL_Delay(1000); Servo_Set_Angle(180); HAL_Delay(1000); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

编译、下载程序到开发板。将舵机的信号线（通常是橙色或黄色）连接到PA6，电源（红色）和地（棕色）分别接到开发板的5V（或3.3V，需确认舵机工作电压）和GND。上电后，你应该能看到舵机规律性地转动到三个位置。

5. 关键细节、调试与进阶优化

项目跑通只是第一步。在实际应用中，以下几个细节和技巧能帮你避开很多坑，并提升控制质量。

5.1 电源隔离与滤波：解决舵机抖动和单片机复位

舵机，尤其是大扭矩舵机，在启动和堵转时电流很大（可达1A甚至更高）。如果和单片机共用同一个电源且没有隔离，这个电流突变会引起电源电压的瞬间跌落（俗称“拉电压”），可能导致单片机复位或程序跑飞。

• 独立供电：最可靠的方法是为舵机单独准备一个电源（如5V/2A的适配器或电池组），并与单片机的电源共地。
• 大电容缓冲：如果必须共用电源，务必在舵机电源引脚附近并联一个大容量电解电容（如470uF或1000uF）和一个小容量陶瓷电容（如0.1uF）。大电容提供能量缓冲，小电容滤除高频噪声。
• 信号线加限流电阻：在单片机PWM输出引脚和舵机信号线之间串联一个100-500欧姆的电阻，可以限制电流，对单片机IO口起到一定的保护作用。

5.2 使用示波器或逻辑分析仪验证波形

当舵机不按预期转动时，第一步不应该是怀疑代码，而应该用工具看看信号到底对不对。

• 测量周期和脉宽：用示波器测量PWM输出引脚（如PA6）的波形。确认周期是否为稳定的20ms（允许有微小误差），以及当你调用Servo_Set_Angle(90)时，高电平脉宽是否稳定在1.5ms左右。
• 观察波形质量：看看上升沿/下降沿是否干净，有没有毛刺。过多的毛刺可能会干扰舵机内部电路的判断。
• 逻辑分析仪：如果没有示波器，一个廉价的USB逻辑分析仪（配合PulseView软件）也能很好地解析PWM信号，查看脉宽数值，性价比极高。

5.3 处理多个舵机与定时器资源分配

一个定时器有多个通道（CH1, CH2, CH3, CH4），它们共享同一个ARR（周期），但各有独立的CCR寄存器。这意味着你可以用一个定时器同时产生最多4路同周期、不同脉宽的PWM信号，完美控制4个舵机。在CubeMX中，只需同时启用TIM3的CH1, CH2, CH3, CH4，并分别设置初始Pulse。在代码中，用HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1 | TIM_CHANNEL_2 | TIM_CHANNEL_3 | TIM_CHANNEL_4);同时启动，然后分别用__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_x, pulse)控制各通道角度。

如果需要控制更多舵机，就需要使用多个定时器。注意APB1和APB2总线上的定时器资源分布，合理规划。

5.4 提升控制平滑度与减少机械噪音

直接让舵机从一个角度跳到另一个角度，会产生很大的瞬时扭矩和机械噪音。可以通过“软移动”来改善：

void Servo_Smooth_Move(uint16_t start_angle, uint16_t end_angle, uint16_t steps, uint16_t delay_ms) { int16_t delta = (int16_t)end_angle - (int16_t)start_angle; for(uint16_t i = 1; i <= steps; i++) { uint16_t current_angle = start_angle + (delta * i) / steps; Servo_Set_Angle(current_angle); HAL_Delay(delay_ms); } }

这个函数将大角度移动分解为多步小角度移动，每步之间有一个短暂的延时，使得舵机运动更平滑、安静。steps是步数，delay_ms是每步的间隔时间。

5.5 校准与参数微调：应对个体差异

并非所有舵机都严格遵循0.5ms-2.5ms的脉宽范围。有些舵机的实际可转动范围可能对应0.6ms-2.4ms。如果你的舵机在0度和180度达不到极限位置，或者有抖动，就需要校准。

• 找出极限脉宽：写一个测试程序，缓慢增加或减少CCR值（对应脉宽），观察舵机刚好开始转动和转到机械极限停止时的脉宽值。这两个值就是你的舵机实际的SERVO_MIN_PULSE和SERVO_MAX_PULSE。
• 更新宏定义：用实测值替换代码中的宏定义。这样你的Servo_Set_Angle函数就能在这个舵机的全范围内进行线性映射了。
• 死区设置：在极限位置留出一点点余量（比如±10个计数值），避免长期让舵机堵转，可以延长其寿命。

6. 常见问题排查与解决思路

即使按照教程操作，你也可能会遇到一些问题。这里列出一些常见情况及其排查方向。

6.1 完全没有PWM波形输出

• 检查引脚配置：首先确认CubeMX中是否正确配置了TIMx_CHx为PWM Generation CHx，并且生成的代码中该引脚被初始化为复用推挽输出（AF_PP）。可以检查MX_GPIO_Init函数。
• 检查定时器时钟是否使能：CubeMX通常会自动使能外设时钟，但可以检查main.c开头附近是否有__HAL_RCC_TIM3_CLK_ENABLE();这样的语句。
• 检查PWM启动函数：确认HAL_TIM_PWM_Start被正确调用，且参数（定时器句柄、通道）无误。句柄名通常是htim3，可以在tim.c文件中找到它的定义。
• 检查下载与复位：程序是否成功下载？下载后是否按了复位键？有些开发板需要手动复位。
• 使用万用表：用万用表电压档测量PWM输出引脚。虽然看不到波形，但如果PWM正常输出，其平均电压应该在1V-2V之间（占空比7.5%，高电平3.3V），而不是0V或3.3V。

6.2 舵机只振动不转动，或转动角度不准

• 首要怀疑电源：99%的舵机乱转问题源于供电不足。确保你的电源能提供足够的电流（单个SG90工作电流约100-200mA，堵转时更大）。使用万用表监测舵机电源引脚电压，在转动时是否大幅跌落（如从5V跌到4V以下）。
• 精确测量PWM脉宽：用示波器测量。可能你的ARR或PSC计算有误，导致周期不是20ms。或者CCR计算有误，导致脉宽不对。严格按照第3.3节的计算公式核对。
• 检查极性：确认CubeMX中PWM的Pulse极性设置为High。如果设为Low，则输出信号是反的，舵机无法识别。
• 检查舵机型号：确认你的舵机是标准的20ms周期、0.5-2.5ms脉宽控制的模拟舵机。有些数字舵机或特殊型号（如180度连续旋转舵机）协议不同。

6.3 控制多个舵机时，其中一个或几个不正常

• 电源负载能力：多个舵机同时动作对电源是巨大考验。务必使用功率足够的电源，并在每个舵机的电源入口处并联滤波电容。
• 代码逻辑冲突：确保你在修改一个通道的CCR值时，没有影响到其他通道。使用__HAL_TIM_SET_COMPARE宏时，指定的通道参数要正确。
• 定时器通道与引脚映射：双击CubeMX中的芯片图，确认你使用的几个通道对应的物理引脚没有冲突，且都被正确配置。例如，TIM3_CH1是PA6，CH2是PA7，CH3是PB0，CH4是PB1。确保这些引脚没有被其他功能（如USART、SPI）占用。

6.4 代码修改后，舵机响应有延迟或卡顿

• 主循环阻塞：如果你的while(1)循环中有HAL_Delay或其他耗时很长的操作，会阻塞主程序，导致无法及时响应角度更新命令。考虑使用非阻塞的方式，比如基于HAL_GetTick()的定时状态机。
• 中断干扰：如果开启了其他高优先级中断，并且执行时间很长，可能会打断PWM定时器的更新，导致信号偶尔异常。检查中断优先级，确保SysTick（系统滴答定时器，HAL_Delay依赖它）和PWM所用定时器中断的优先级设置合理。
• HAL库函数耗时：__HAL_TIM_SET_COMPARE是直接写寄存器，速度很快。但如果你错误地使用了其他HAL函数来修改占空比，可能会更慢。

通过以上步骤，你不仅能够实现STM32对舵机的稳定控制，更能深刻理解从芯片时钟、定时器原理到实际应用的全链路。这套方法具有很高的通用性，稍加修改，便可应用于直流电机调速、LED呼吸灯、无源蜂鸣器发声等任何需要PWM的场合。记住，嵌入式开发中，理解原理永远比记住步骤更重要。当你下次遇到新的外设时，尝试用同样的思路去拆解它的需求、分析MCU的能力、然后用工具（CubeMX）和代码去搭建桥梁，你会发现很多问题都迎刃而解了。