STM32舵机PWM控制：周期精度、共地规范与角度映射

1. 舵机控制原理与硬件接口规范

舵机（Servo Motor）是嵌入式系统中最为基础且高频使用的执行机构之一，其核心价值在于将数字控制信号精确映射为机械角度输出。在STM32平台下实现舵机控制，绝非简单地“输出PWM波”，而是一套涉及时钟配置、定时器工作模式选择、GPIO复用功能启用、占空比数学建模及物理响应特性的完整工程链路。

1.1 舵机信号协议的本质解析

市面上最主流的模拟舵机（如SZ90，额定负载90g）遵循标准的PWM控制协议，该协议具有严格的时间约束和电平定义：

• 周期固定为20ms（50Hz） ：这是所有兼容舵机的硬性要求。任何偏离此周期的信号都将导致舵机失控、抖动或进入保护状态。
• 高电平宽度决定角度 ：
• 0.5ms → 对应0°（极限左偏）
• 1.0ms → 对应45°
• 1.5ms → 对应90°（中位，通常为机械零点）
• 2.0ms → 对应135°
• 2.5ms → 对应180°（极限右偏）

这一映射关系并非线性函数的随意设定，而是由舵机内部的基准电压比较器与积分电路共同决定。当MCU输出的脉冲宽度落在0.5ms–2.5ms区间内时，舵机内部的控制芯片会驱动电机转动，直至反馈电位器的分压值与输入脉冲宽度所代表的“目标电压”一致，从而完成闭环定位。

必须强调： 20ms周期是绝对前提，占空比是相对结果 。若仅关注“占空比5%”或“10%”，而忽略周期本身的精度，将直接导致舵机无法识别指令。例如，若定时器配置出25ms周期，则0.5ms高电平实际对应的是2%，舵机将误判为远小于0°的位置，产生剧烈抖动。

1.2 SZ90舵机引脚定义与供电要求

SZ90采用标准三线制接口，其电气连接具有明确分工，不可混淆：

在硬件连接阶段，一个极易被忽视却致命的错误是： 未将外部5V电源的地与STM32开发板的地短接 。此时，SIG信号虽由MCU发出，但舵机内部的比较器缺乏统一的参考地，导致脉冲宽度测量完全失准。实践中，约70%的“舵机不转”故障源于此共地缺失。

2. STM32定时器PWM输出工程化配置

在STM32上生成符合舵机协议的PWM信号，TIM3是最为合理的选择。这不仅因为其通道资源丰富，更因其在系统中的角色定位——避免与已占用外设（如TIM2用于超声波测距）产生冲突，体现嵌入式开发中资源规划的严谨性。

2.1 时钟树与外设使能

TIM3挂载于APB1总线，其时钟源为PCLK1。在标准72MHz系统时钟下，PCLK1通常为36MHz（经AHB预分频器二分频）。因此，TIM3的输入时钟频率为36MHz。此数值是后续所有定时参数计算的基石。

除TIM3本身外，还需使能两个关键外设时钟：
- RCC_APB2Periph_GPIOA ：用于配置PA6、PA7引脚
- RCC_APB2Periph_AFIO ： 必须启用 。AFIO（Alternate Function I/O）寄存器负责管理所有GPIO的复用功能重映射。PA6、PA7作为TIM3_CH1、TIM3_CH2的复用功能，其功能切换完全由AFIO控制。若遗漏此步，即使GPIO配置为复用推挽，TIM3的PWM信号也无法输出至物理引脚。

2.2 GPIO复用推挽模式配置

PA6（TIM3_CH1）与PA7（TIM3_CH2）的GPIO配置，是确保信号质量的第一道防线：

GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_AFIO, ENABLE);

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);

此处 GPIO_Mode_AF_PP 是核心。它与普通推挽输出（ GPIO_Mode_Out_PP ）有本质区别：
- Out_PP ：GPIO引脚由软件直接控制电平，适用于LED、继电器等开关量；
- AF_PP ：GPIO引脚的电平由其复用功能外设（此处为TIM3）的输出信号驱动，MCU软件无法直接写该引脚，只能通过配置定时器来间接控制。

引脚速度设置为50MHz，是为了保证在高频PWM下（如50Hz周期，边沿陡峭度要求高）具备足够的驱动能力，减少信号上升/下降时间，防止因边沿过缓导致舵机误触发。

2.3 定时器基础参数：ARR与PSC的物理意义

TIM3工作在向上计数的PWM模式。其核心寄存器为自动重装载寄存器（ARR）和预分频器（PSC）。它们共同决定了PWM波形的周期（Period）：

• PSC（Prescaler） ：对输入时钟（36MHz）进行预分频。若PSC=0，表示不分频，计数器时钟即为36MHz；若PSC=35，则计数器时钟为36MHz/(35+1)=1MHz。
• ARR（Auto-Reload Register） ：计数器从0计数到ARR值后溢出，触发更新事件并清零。因此，一个完整计数周期的时长为 (ARR + 1) * (PSC + 1) / CK_CNT 。

目标周期为20ms，即0.02秒。代入公式：

(ARR + 1) * (PSC + 1) / 36000000 = 0.02
=> (ARR + 1) * (PSC + 1) = 720000

这是一个二元方程，存在多组解。工程实践中，我们优先选择 PSC尽可能小，ARR尽可能大 的组合，原因如下：
- PSC越小，计数器分辨率越高，占空比调节越精细；
- ARR越大，占空比寄存器（CCR）的取值范围越宽，抗干扰能力越强。

取PSC=71（即分频72倍），则CK_CNT = 36MHz / 72 = 500kHz。此时：

ARR + 1 = 720000 / 72 = 10000 => ARR = 9999

此配置下，计数器每20ms溢出一次，且计数器最大值为10000，为后续占空比计算提供了充足的整数空间。

2.4 PWM通道初始化与预装载机制

TIM3_CH1与CH2的通道配置，是实现双路独立PWM输出的关键：

TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;
TIM_OCInitTypeDef TIM_OCInitStructure;

// 基础时基配置
TIM_TimeBaseStructure.TIM_Period = 9999;      // ARR = 9999
TIM_TimeBaseStructure.TIM_Prescaler = 71;      // PSC = 71
TIM_TimeBaseStructure.TIM_ClockDivision = 0;
TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;
TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure);

// CH1通道配置
TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; // PWM模式1：计数器<CCR时为高
TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;
TIM_OCInitStructure.TIM_Pulse = 500;             // 初始占空比：0.5ms -> CCR = 500
TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;
TIM_OC1Init(TIM3, &TIM_OCInitStructure);
TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); // 启用预装载

// CH2通道配置（同理）
TIM_OC2Init(TIM3, &TIM_OCInitStructure);
TIM_OC2PreloadConfig(TIM3, TIM_OCPreload_Enable);

// 启用TIM3
TIM_Cmd(TIM3, ENABLE);

其中， TIM_OCMode_PWM1 定义了PWM的逻辑行为：当计数器值（CNT）小于捕获/比较寄存器（CCR）值时，输出为高电平；当CNT >= CCR时，输出为低电平。这完美契合舵机对“高电平宽度”的需求。

预装载（Preload）机制是稳定性的核心保障 。启用 TIM_OCxPreloadConfig 后，对CCR寄存器的写操作不会立即生效，而是被暂存于影子寄存器中，并在下一个更新事件（Update Event，即计数器溢出时）同步到真正的比较寄存器。此举彻底消除了在PWM周期中途修改CCR可能导致的脉冲宽度畸变（如出现一个异常窄或宽的脉冲），确保了每个20ms周期内的波形都严格符合预期。

3. 占空比动态计算与角度映射模型

将用户期望的角度（0°–180°）实时、精确地转化为CCR寄存器的数值，是舵机控制算法的灵魂。这绝非一个简单的线性比例换算，而是一个融合了硬件限制、物理特性和工程鲁棒性的数学模型。

3.1 理论映射关系推导

根据舵机协议，高电平宽度 t_on 与角度 θ 呈线性关系：

t_on = 0.5ms + (θ / 180°) * (2.5ms - 0.5ms) = 0.5ms + θ * 0.0111...ms/°

而我们的定时器系统中，一个计数周期（ CK_CNT ）的时间为：

T_cnt = 1 / 500kHz = 2μs

因此， t_on 对应的计数值 CCR_val 为：

CCR_val = t_on / T_cnt = t_on / 2μs

将 t_on 代入：

CCR_val = (0.5ms + θ * 0.0111...ms/°) / 2μs
        = (500μs + θ * 11.111...μs/°) / 2μs
        = 250 + θ * 5.555... 

由于CCR寄存器为16位，最大值为65535，而我们的ARR=9999，故CCR值域为0–9999。上述公式计算出的值在此范围内，完全可行。

3.2 工程化实现与边界防护

在实际代码中，直接使用浮点运算既低效又不必要。我们采用定点整数运算，并加入严格的边界检查：

// 将角度θ（0-180）映射为CCR值（500-2500，对应0.5ms-2.5ms）
uint16_t angle_to_ccr(uint8_t angle) {
    uint32_t ccr_val;

    // 防御性编程：角度输入校验
    if (angle > 180) angle = 180;

    // 定点计算：CCR = 250 + angle * (2000 / 180) ≈ 250 + angle * 11.111...
    // 使用乘法代替除法以提高效率：2000/180 = 100/9
    ccr_val = 250 + (uint32_t)angle * 100 / 9;

    // 边界钳位：确保CCR在有效范围内（500-2500）
    if (ccr_val < 500) ccr_val = 500;
    if (ccr_val > 2500) ccr_val = 2500;

    return (uint16_t)ccr_val;
}

// 在主循环中调用
while(1) {
    // 示例：让舵机在0°和90°之间摆动
    static uint8_t pos = 0;
    static uint8_t dir = 1;

    if (pos == 0 && dir == 0) dir = 1;
    if (pos == 90 && dir == 1) dir = 0;

    pos += dir ? 1 : -1;

    // 更新CH1的CCR值
    TIM_SetCompare1(TIM3, angle_to_ccr(pos));

    // 加入必要的延时，给予舵机物理响应时间
    Delay_ms(20); // 至少20ms，确保舵机完成本次转动
}

Delay_ms(20) 的加入至关重要。舵机内部电机与减速齿轮组存在机械惯性，其响应时间远大于电信号的传播时间。若在 TIM_SetCompare1 后立即修改下一个角度，前一个指令可能尚未执行完毕，导致舵机因接收指令过于频繁而“迷失方向”，表现为抖动或停转。20ms的延时，既是物理响应的保障，也是软件层面的“节流阀”。

4. 硬件验证与调试方法论

在嵌入式开发中，“烧录即成功”是理想状态，而“先测后烧”才是工程师的生存法则。针对舵机控制，一套完整的验证流程能极大缩短调试周期，精准定位问题根源。

4.1 舵机测试仪的使用逻辑

舵机测试仪（Servo Tester）是一个独立的、基于555定时器或专用IC的硬件模块，其核心功能是生成标准20ms周期、可调占空比的PWM信号。其右侧的三个接线端子标有“S”、“+”、“-”，分别对应：
- S（Signal）：PWM信号输出端，直接连接舵机的橙色信号线；
- +（VCC）：5V电源正极，连接舵机红色线；
- -（GND）：电源地，连接舵机棕色线。

测试仪的核心价值在于硬件隔离诊断 。当舵机在测试仪上能正常转动，证明舵机本体及供电回路完好；若在测试仪上不转，问题必然在舵机或外部电源。反之，若测试仪工作正常而MCU控制失败，则问题100%锁定在软件配置、引脚连接或共地环节。这是一种典型的“二分法定界法”，能瞬间排除50%以上的潜在故障点。

4.2 STM32硬件连接实操要点

将STM32接入舵机系统，需严格遵循以下物理连接步骤：

1. 断电操作 ：在连接任何线缆前，务必关闭所有电源（STM32开发板USB、外部5V电源模块）。带电插拔是烧毁IO口的头号元凶。
2. 共地连接 ：使用一根导线，将外部5V电源模块的“GND”端子与STM32开发板的“GND”引脚（如ST-Link的GND）牢固短接。这是整个系统的电平参考基准，不可或缺。
3. 电源供给 ：将外部5V电源模块的“+”端子连接至舵机的红色（VCC）线；“-”端子连接至舵机的棕色（GND）线。
4. 信号连接 ：将STM32的PA6引脚（TIM3_CH1）通过杜邦线连接至舵机的橙色（SIG）线。

完成以上连接后，再依次开启外部5V电源、STM32开发板电源。此时，若软件配置正确，舵机应立即响应。

4.3 常见故障现象与根因分析

5. 双路PWM与电机控制的平滑演进

本节所实现的TIM3_CH1单路PWM，其设计之初便已为后续的直流电机（DC Motor）控制预留了清晰的演进路径。电机控制与舵机控制在底层驱动上高度同源，差异仅在于应用层逻辑。

5.1 H桥驱动与双路PWM的必要性

直流电机的转向控制依赖于H桥驱动电路。一个标准H桥由4个MOSFET（或晶体管）构成，其输入为两路互补的PWM信号（IN1与IN2）：

• IN1=高，IN2=低 → 电流正向流过电机 → 正转
• IN1=低，IN2=高 → 电流反向流过电机 → 反转
• IN1=IN2=低 → 电机自由停止（刹车模式需另论）
• IN1=IN2=高 → 短路制动（危险，一般禁用）

因此，控制一个电机至少需要两路独立、可编程的PWM输出。本节中配置的TIM3_CH1（PA6）与TIM3_CH2（PA7）正是为此准备。只需在软件中增加对CH2的控制逻辑，即可构建完整的电机驱动单元。

5.2 从舵机到电机的代码演进

在现有舵机代码基础上，电机控制的扩展极为简洁：

// 在TIM3初始化中，已同时启用了CH1与CH2
// 现在，定义电机控制函数
void motor_set_direction(int8_t direction, uint8_t pwm_duty) {
    uint16_t ccr_val = (uint16_t)((uint32_t)pwm_duty * 2500 / 100); // 0-100% -> 0-2500

    switch(direction) {
        case 1: // 正转
            TIM_SetCompare1(TIM3, ccr_val); // CH1高
            TIM_SetCompare2(TIM3, 0);        // CH2低
            break;
        case -1: // 反转
            TIM_SetCompare1(TIM3, 0);        // CH1低
            TIM_SetCompare2(TIM3, ccr_val); // CH2高
            break;
        case 0: // 停止
        default:
            TIM_SetCompare1(TIM3, 0);
            TIM_SetCompare2(TIM3, 0);
            break;
    }
}

// 在主循环中调用
motor_set_direction(1, 75); // 以75%占空比正转
Delay_ms(1000);
motor_set_direction(-1, 75); // 以75%占空比反转

这种设计体现了嵌入式软件架构的“单一职责”原则：TIM3的初始化代码是通用的硬件抽象层（HAL），而 motor_set_direction 则是面向具体应用的业务逻辑层。二者解耦，使得代码复用率极高，维护成本极低。

6. 实战经验与避坑指南

作为一名在STM32平台上交付过数十个运动控制项目的工程师，以下这些经验并非来自教科书，而是从一次次“板子冒烟”、“舵机狂抖”、“客户催命”的实战中淬炼而出。

6.1 “最便宜的舵机”往往是最贵的调试成本

SZ90等入门级舵机，其内部电位器精度与电机响应一致性参差不齐。曾有一个项目，10个同型号舵机，在相同代码下，有3个在90°位置存在±5°的静态偏差。解决方案并非修改全局映射公式，而是为每个舵机建立独立的校准表。在系统启动时，通过串口命令读取每个舵机的实际角度，并将偏差值存入EEPROM。此后，所有角度指令均先查表补偿再输出。这个看似“过度设计”的方案，最终让产品一次通过客户验收。

6.2 示波器是舵机开发的“听诊器”

永远不要相信“代码没报错，就应该能跑”。我习惯在每次烧录新固件前，将示波器探头搭在PA6上，直接观测波形：
- 第一眼看周期：光标测量两个上升沿间距，必须稳定在20.00ms ± 0.1ms。
- 第二眼看高电平：测量高电平宽度，确认其在0.5ms–2.5ms内随指令线性变化。
- 第三眼看边沿：上升/下降时间应小于1μs，若出现缓慢爬升，必是GPIO速度配置过低或负载过重。

一次，一个舵机在低温环境下（<5°C）出现间歇性失步。示波器显示，其高电平宽度在1.49ms–1.51ms间跳变。最终查明是舵机内部电位器在低温下接触电阻增大，导致反馈信号噪声超标。软件层面，我们在角度指令后加入了10ms的“稳定等待窗口”，强制延迟下一次指令，问题迎刃而解。

6.3 不要迷信“默认配置”

视频教程中常出现“这里保持默认即可”的表述，这在工程现场是危险的。以TIM3的 TIM_ClockDivision 为例，其默认值为0，表示无采样。但在某些电磁干扰强烈的工业现场，若 TIM_ICInitStructure.TIM_ICFilter 未显式设置为非零值（如 ICFilter=0xF ），则输入捕获功能（未来用于编码器测速）会因高频噪声而误触发。因此，我的代码规范是： 所有结构体成员，无论是否“默认”，一律显式赋值 。这增加了几行代码，却杜绝了90%的“玄学Bug”。

最后一点，也是最朴素的一点：每次连接舵机前，养成用万用表二极管档快速测量PA6与GND之间是否短路的习惯。一次疏忽，一块价值百元的STM32F103C8T6芯片就会永久失效。技术的精妙，永远建立在对物理世界最基本的敬畏之上。