STM32CubeMX配置通用定时器PWM驱动舵机：从原理到工程实践

1. 项目概述：从定时器到舵机控制的工程实践

最近在做一个机械臂的小项目，核心关节驱动用的是舵机。舵机这东西，玩过机器人的朋友都不陌生，它本质上是一个带位置反馈的伺服电机，控制信号就是PWM（脉冲宽度调制）。很多新手，包括几年前的我，一开始可能会直接用Arduino的Servo库，简单几行代码就能让舵机动起来。但当你需要更精确的控制、更复杂的多路协同，或者项目需要更低的功耗和更高的可靠性时，把控制核心迁移到STM32这类更专业的微控制器上，就成了必然选择。

STM32功能强大，资源丰富，但直接操作寄存器配置定时器产生PWM，对初学者来说门槛不低。寄存器地址、预分频、自动重载值、捕获比较寄存器……一堆概念砸过来，很容易让人打退堂鼓。好在ST公司提供了STM32CubeMX这个图形化配置工具，它就像一把“瑞士军刀”，能把复杂的底层硬件配置，变成可视化的勾选和填参数。这次，我就以最常用的SG90舵机为例，带你走一遍完整的流程：从CubeMX配置通用定时器产生特定频率和脉宽的PWM信号，到在Keil中编写角度控制函数，最后实现0°到180°的精准角度控制。整个过程，我会把原理讲透，把坑点标清，让你不仅能“照着做出来”，更能明白“为什么要这么做”。

2. 核心原理与硬件选型解析

2.1 PWM如何控制舵机：不仅仅是脉宽

很多人知道舵机用PWM控制，但可能只停留在“改变占空比就能改变角度”的层面。其实，这里面有一个标准的通信协议。以最常见的模拟舵机SG90为例，它要求一个周期为20ms（即频率50Hz）的PWM信号。在这个周期内，高电平脉冲的宽度（即脉宽）决定了舵机转轴的位置。

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

这个关系是线性的。也就是说，脉宽每增加(2.5-0.5)/180 ≈ 11.11μs，舵机角度大约增加1°。这就是我们控制的理论基础。为什么是20ms？这源于舵机内部的控制电路设计，它每隔20ms需要读取一次脉冲信号来刷新位置指令。如果频率太高（比如1kHz），舵机可能无法正确解析；频率太低（比如10Hz），则会导致运动不连续、抖动。

注意：不同品牌、型号的舵机，其脉宽范围可能略有差异。例如，有些舵机的实际可响应范围是0.5ms到2.4ms。在要求高的场合，最好查阅具体舵机的数据手册，或者通过实验校准。

2.2 为什么选择通用定时器？

STM32的定时器资源非常丰富，有基本定时器、通用定时器、高级定时器。对于舵机PWM控制，通用定时器（如TIM2, TIM3, TIM4等）是最常用且性价比最高的选择。

• 基本定时器：只有计数功能，没有PWM输出通道，无法直接使用。
• 高级定时器：功能最强，支持互补输出、死区插入等，常用于电机驱动和数字电源，但配置相对复杂，资源也更宝贵。
• 通用定时器：具备基本的计数、PWM输出、输入捕获等功能，完全满足舵机控制的需求。它通常有4个独立的通道（CH1-CH4），每个通道都可以配置为PWM输出模式，这意味着一个定时器理论上可以控制多达4个舵机，且它们共享相同的频率（周期），非常高效。

我们的目标就是配置通用定时器的某一个通道为PWM模式，并计算出合适的参数，使其输出一个频率50Hz（周期20ms）、脉宽在0.5ms到2.5ms之间可调的方波信号。

2.3 硬件连接与供电须知

硬件连接很简单，但有几个细节决定了项目的成败：

1. 信号线：连接STM32的定时器PWM输出引脚（如PA0, PA1等）到舵机的信号线（通常是橙色或白色）。
2. 电源线：舵机的红线（VCC）和黑线（GND）连接到电源。这是第一个大坑！
   • 绝对禁止：直接从STM32开发板的3.3V或5V引脚取电给舵机供电，尤其是当舵机负载较大或数量多于1个时。舵机在转动，特别是堵转时，瞬间电流可以高达数百mA甚至上A，这会拉低整个系统的电压，导致STM32复位或工作异常。
   • 正确做法：使用独立的电源（如4节AA电池组、5V/2A的直流电源适配器）为舵机供电。务必确保舵机电源的地（GND）与STM32开发板的地（GND）连接在一起，即“共地”，这是信号正常工作的基础。
3. 消抖与保护：在信号线靠近舵机端，可以串联一个100-200欧姆的电阻，以限制电流，保护MCU引脚。对于长线连接，在舵机电源正负极之间并联一个100uF以上的电解电容，可以有效吸收舵机动作引起的电源波动。

3. STM32CubeMX工程配置详解

假设我们使用STM32F103C8T6（蓝色战舰最小系统板），计划用TIM3的通道1（对应PA6引脚）来控制舵机。

3.1 时钟树配置：一切计时的源头

打开CubeMX，选择好芯片型号后，首先进入Clock Configuration标签页。系统的时钟决定了定时器计数的“心跳”速度。对于F103，我们通常使用外部高速时钟（HSE），然后通过PLL倍频到72MHz作为系统时钟（SYSCLK）。

定时器的时钟源（APB1 Timer clocks或APB2 Timer clocks）来自于对应的APB总线。这里有个关键点：如果APB总线的预分频系数不为1，那么挂载在该总线上的定时器时钟会被自动乘以2。例如，APB1总线时钟（PCLK1）配置为36MHz，而APB1预分频器是2分频，那么定时器（如TIM2, TIM3, TIM4）的实际时钟频率将是72MHz。CubeMX的时钟树图会清晰地显示这个“x2”的关系。我们配置时，最终确保定时器的时钟源（这里指TIM3的时钟）是72MHz即可，这是后续计算的基础。

3.2 定时器参数计算：核心中的核心

找到TIM3，将其工作模式设为Internal Clock。然后关键步骤在下方的Parameter Settings中：

• Prescaler (PSC - 预分频器)：这个值将定时器的时钟源进行分频，得到计数器CK_CNT的实际计数频率。计算公式：计数器时钟频率 = 定时器时钟源 / (PSC + 1)。我们希望计数器跑得不要太快，以免自动重载值（ARR）设置得过大或过小。我们目标PWM频率是50Hz，可以先试算。设PSC=7199，则计数器时钟频率 = 72MHz / (7199+1) = 10kHz。这意味着计数器每计数一次，耗时0.1ms。
• Counter Mode (计数模式)：选择Up（向上计数模式），即从0计数到ARR值，然后溢出产生更新事件，如此循环。
• Counter Period (ARR - 自动重载寄存器)：这个值决定了PWM的周期。ARR的值对应计数器从0计到满一个周期所需的计数值。PWM周期T = (ARR + 1) / 计数器时钟频率。我们已经有了计数器时钟频率10kHz（周期0.1ms），目标周期T=20ms。所以ARR = T * 计数器时钟频率 - 1 = 20ms * 10kHz - 1 = 200 - 1 = 199。
  • 验证：PWM频率 = 计数器时钟频率 / (ARR + 1) = 10kHz / 200 = 50Hz。完美。
• auto-reload preload (自动重载预装载)：建议使能（Enable）。这样对ARR的修改会在下一次更新事件时才生效，防止在修改途中产生错误的脉冲。

3.3 PWM通道配置：设定脉宽范围

在Parameter Settings同一页，找到Channel 1，选择PWM Generation CH1。下方会出现通道1的专属配置：

• Mode (模式)：保持PWM mode 1。在此模式下，当计数器值小于捕获比较寄存器（CCR）值时，通道输出有效电平（可设置）；大于等于CCR时，输出无效电平。
• Pulse (脉冲值，即CCR)：这个值就是我们控制脉宽的关键！它定义了在一个PWM周期内，高电平持续的计数值。我们先设一个初始值，比如150（对应1.5ms脉宽，舵机中位）。具体计算：脉宽 = (CCR + 1) / 计数器时钟频率。计数器时钟频率10kHz，即每计数值0.1ms。要得到1.5ms脉宽，CCR = 1.5ms / 0.1ms - 1 = 14。等等，这里为什么是150？注意，我们之前的计算是基于计数器时钟频率 = 定时器时钟源 / (PSC + 1)。但在PWM生成中，计数器的计数频率已经是经过预分频后的CK_CNT。所以我们的计算是正确的，初始CCR应该设为14。CubeMX界面上显示的Pulse单位就是“计数值”。我们先填14。
• Fast Mode (快速模式)：禁用。
• CH Polarity (通道极性)：这里很重要！它决定了什么是“有效电平”。如果设置为High，则有效电平为高，PWM模式1下，计数值小于CCR时输出高电平。这是我们通常需要的。如果你发现输出的PWM波高低电平反了，就来调整这个选项。

3.4 GPIO与工程生成

配置好定时器后，对应的GPIO（PA6）会自动被配置为复用推挽输出模式（Alternate Function Push Pull），通常驱动能力和速度保持默认即可。

接下来，在Project Manager里设置好工程名称、路径、IDE（MDK-ARM V5），将Code Generator中的Generated files设置为Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral，这样代码结构更清晰。最后点击GENERATE CODE生成工程。

4. Keil代码编写与角度控制函数实现

4.1 生成的代码结构分析

打开生成的Keil工程，在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间，你会看到CubeMX已经帮我们生成了定时器初始化和启动PWM输出的代码：

HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

这行代码启动了TIM3通道1的PWM输出。此时，PA6引脚就已经在输出一个50Hz，脉宽为(14+1)*0.1ms = 1.5ms的PWM波了。接上舵机，它应该会转动到90°附近的位置。

4.2 编写精准的角度控制函数

我们的目标是输入一个0到180的角度值，函数自动计算出对应的CCR值并更新。在main.c的/* USER CODE BEGIN 4 */区域添加以下函数：

/** * @brief 设置舵机角度 * @param angle: 目标角度，范围0-180 * @retval None */ void Servo_SetAngle(float angle) { if(angle < 0) angle = 0; if(angle > 180) angle = 180; // 脉宽计算：0.5ms + (angle / 180) * (2.5ms - 0.5ms) // 单位转换为ms: pulse_width_ms = 0.5 + angle * (2.0 / 180.0) float pulse_width_ms = 0.5f + angle * (2.0f / 180.0f); // 将脉宽转换为计数值：CCR = pulse_width_ms / (1 / counter_clock_khz) - 1 // 计数器时钟频率为10kHz，周期为0.1ms // 所以：CCR = pulse_width_ms / 0.1ms - 1 = pulse_width_ms * 10 - 1 uint16_t ccr_val = (uint16_t)(pulse_width_ms * 10.0f) - 1; // 更新捕获比较寄存器 __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, ccr_val); }

代码解析：

1. 角度限幅：防止输入角度超出舵机物理范围。
2. 线性映射：将0-180度线性映射到0.5ms-2.5ms脉宽。这是最核心的公式。
3. 单位转换：将脉宽（ms）转换为定时器的计数值。因为我们的计数器每计一次代表0.1ms，所以计数值 = 脉宽(ms) * 10。注意公式末尾的-1，这是因为在PWM模式1下，当计数值等于CCR时，电平就发生翻转，所以高电平持续的计数值实际上是CCR+1。因此，要得到N个计数的高电平，需要设置CCR = N - 1。我们计算出的pulse_width_ms * 10就是需要的计数值N。
4. 更新寄存器：使用HAL库提供的宏__HAL_TIM_SET_COMPARE安全地更新CCR1寄存器。

4.3 主循环控制逻辑

在main.c的/* USER CODE BEGIN WHILE */之后的主循环中，你可以调用这个函数来控制舵机运动了。例如，让舵机在0°和180°之间缓慢摆动：

while (1) { for(int angle = 0; angle <= 180; angle += 10){ Servo_SetAngle(angle); HAL_Delay(500); // 等待500ms } for(int angle = 180; angle >= 0; angle -= 10){ Servo_SetAngle(angle); HAL_Delay(500); } /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ }

5. 调试技巧与常见问题排查

即使按照步骤操作，你也可能会遇到舵机不转、抖动或角度不准的问题。下面是我踩过坑后总结的排查清单。

5.1 问题速查表

5.2 进阶优化与思考

1. 使用DMA自动更新CCR：如果需要舵机非常平滑、无抖动地运动（比如做云台跟踪），频繁调用__HAL_TIM_SET_COMPARE并在中断中计算可能会影响系统实时性。此时可以配置DMA，将一个存储了多个CCR值的数组自动搬运到定时器的CCR寄存器中，实现“硬件的”平滑运动曲线。
2. 多路舵机同步控制：一个通用定时器有4个通道，可以同时输出4路同频率的PWM。你只需要为每个通道计算并设置不同的CCR值即可。注意，所有通道共享同一个ARR（周期），但CCR独立。在CubeMX中使能多个通道，在代码中分别启动（HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_x)），并分别设置各自的比较值。
3. 精度与效率的权衡：我们之前将计数器时钟设为10kHz，每个计数值对应0.1ms。对于180°范围，角度分辨率约为 180° / ( (2.5-0.5)/0.1 ) = 180° / 20 = 9°。这个分辨率不高。如果想提高分辨率，可以提高计数器时钟频率（减小PSC值），这样ARR会变大，CCR的可调范围也更精细。例如，将PSC设为719，则计数器时钟为100kHz（0.01ms/计数值），ARR需设为2000-1=1999以维持50Hz。此时角度分辨率提升到约0.9°。但代价是ARR和CCR值变大，计算时需使用32位变量以防溢出。

最后，关于网络上搜索到的“没有PWM波形输出”这个问题，除了检查配置和代码，务必确认一下GPIO的复用功能是否正确映射。有些芯片的定时器通道可能映射到多个GPIO上，需要在CubeMX的Pinout view中确认你使用的引脚确实被分配给了对应的定时器通道。另一个隐藏点是，在生成代码后，是否忘记了调用HAL_TIM_PWM_Start()函数。这个函数不会在main中自动调用，必须由用户在初始化完成后手动启动PWM输出。