STM32舵机PWM控制：周期与脉宽的精准协同

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

舵机（Servo Motor）是嵌入式系统中最为基础且高频使用的执行机构之一，其核心价值在于将数字控制信号精确映射为机械角度输出。在STM32平台下实现舵机控制，本质是生成符合工业标准的PWM（Pulse Width Modulation）信号，而非简单地输出占空比可调的方波。理解其物理层协议是工程实现的前提。

1.1 标准舵机通信协议解析

以SZ90型舵机为例（额定负载90g），其电气接口为三线制：黄色为信号线（Signal），红色为电源正极（VCC，通常为4.8–6.0V），棕色为接地（GND）。该接口定义严格遵循RC（Radio Control）伺服标准，与MCU供电系统必须共地，否则信号参考电平失效，导致舵机无响应或抖动。

其控制逻辑完全基于脉冲宽度调制，关键参数如下：

该协议的核心约束在于： 周期必须严格稳定在20ms，脉宽在0.5–2.5ms范围内线性映射0°–180° 。任何偏离都将导致舵机行为异常——周期过短可能触发保护锁死，周期过长则响应迟滞；脉宽超出范围则舵机仅在极限位置“顶住”，无法精确定位。

值得注意的是，此协议与通用PWM存在本质区别：通用PWM关注占空比（Duty Cycle = 脉宽 / 周期），而舵机协议关注绝对脉宽值（Absolute Pulse Width）。例如，当周期为20ms时，1.5ms脉宽对应7.5%占空比；但若周期误设为10ms，则1.5ms脉宽将变为15%占空比，舵机将错误解读为远超180°的指令，造成机械损伤风险。

1.2 STM32定时器PWM输出机制

在STM32F1系列中，TIM3是独立的16位通用定时器，具备4个互补通道，非常适合舵机控制。其PWM输出依赖于“向上计数模式”（Upcounting Mode）下的自动重装载寄存器（ARR）与捕获/比较寄存器（CCR）协同工作：

• ARR（Auto-Reload Register） ：决定计数器溢出周期，即PWM总周期。
• CCR（Capture/Compare Register） ：决定高电平持续时间，即脉宽。
• 计数器时钟源 ：由APB1总线时钟（通常为72MHz）经预分频器（PSC）分频后提供。

其数学关系为：

PWM Period (us) = ((ARR + 1) × (PSC + 1)) / TIMxCLK (MHz)
PWM Pulse Width (us) = ((CCR + 1) × (PSC + 1)) / TIMxCLK (MHz)

因此，要生成20ms周期、1.5ms脉宽的信号，需解耦ARR/PSC/CCR三者关系。直接硬编码ARR与PSC虽可行，但牺牲了参数可调性与代码复用性。工程实践中，应将ARR与PSC作为全局配置参数，CCR作为运行时动态变量，使角度控制逻辑与底层时序解耦。

2. 硬件资源规划与引脚复用配置

舵机控制对MCU资源占用极低，但需严谨规划以避免与其他外设冲突。本方案选用TIM3通道1（CH1）与通道2（CH2），对应GPIO引脚为PA6与PA7。选择依据如下：

• PA6/PA7物理特性 ：均位于GPIOA端口，支持复用推挽输出（Alternate Function Push-Pull），驱动能力充足（最大25mA/引脚），可直接驱动舵机信号线。
• TIM3通道分配合理性 ：TIM3_CH1（PA6）与TIM3_CH2（PA7）为相邻引脚，布线简洁，减少PCB走线干扰。
• 资源隔离原则 ：前序课程已使用TIM2，故规避TIM2，选用TIM3实现模块化隔离，降低调试耦合度。

2.1 复用功能时钟使能

STM32F1的复用功能（AFIO）需独立使能时钟。TIM3的PWM输出依赖AFIO外设管理GPIO复用映射，因此必须开启AFIO时钟：

RCC->APB2ENR |= RCC_APB2ENR_AFIOEN;  // 使能AFIO时钟

若忽略此步，即使正确配置GPIO模式为 AF_PP ，引脚仍将保持默认功能（如普通推挽），PWM信号无法输出。

2.2 GPIO初始化细节

PA6与PA7需配置为复用推挽输出，速度设为50MHz（满足20ms周期需求）：

// 启用GPIOA时钟
RCC->APB2ENR |= RCC_APB2ENR_IOPAEN;

// PA6 & PA7 配置：复用推挽，50MHz
GPIOA->CRH &= ~(GPIO_CRH_MODE6 | GPIO_CRH_CNF6 | 
                 GPIO_CRH_MODE7 | GPIO_CRH_CNF7);
GPIOA->CRH |=  (GPIO_CRH_MODE6_1 | GPIO_CRH_CNF6_1 |  // PA6: AF_PP, 50MHz
                 GPIO_CRH_MODE7_1 | GPIO_CRH_CNF7_1);  // PA7: AF_PP, 50MHz

此处 GPIO_CRH_CNF6_1 表示CNF[1:0] = 10（复用功能推挽）， GPIO_CRH_MODE6_1 表示MODE[1:0] = 10（输出模式，50MHz）。配置错误将导致引脚处于高阻态或弱驱动，舵机无法识别信号。

3. TIM3 PWM初始化流程详解

TIM3初始化需按严格时序执行：先配置时基单元（ARR/PSC），再配置通道（CCR/CCER），最后使能定时器。任何步骤错序均可能导致输出异常。

3.1 时基单元配置（ARR与PSC计算）

目标：20ms周期，72MHz输入时钟。

计算过程：
- 20ms = 20000μs
- 计数周期 = 20000μs × 72MHz = 1,440,000 个时钟周期
- 为简化计算并保留调节余量，采用PSC=71（分频72倍），则：
- 计数器时钟 = 72MHz / 72 = 1MHz → 每个计数周期 = 1μs
- ARR = 20000 - 1 = 19999 （因计数从0开始，溢出值为ARR+1）

此配置下，ARR与PSC成为可编程参数：

typedef struct {
    uint16_t arr;  // 自动重装载值，决定周期
    uint16_t psc;  // 预分频值，决定计数器频率
} TIM3_PWM_Config_t;

static TIM3_PWM_Config_t tim3_pwm_config = {19999, 71}; // 20ms @ 72MHz

将ARR/PSC封装为结构体，便于后续通过函数参数动态修改，避免硬编码导致的维护困难。

3.2 通道配置与使能

TIM3_CH1与CH2需配置为PWM模式1（向上计数时，CCR < ARR则输出高电平），并使能预装载寄存器（ARPE）以确保更新原子性：

// 使能TIM3时钟
RCC->APB1ENR |= RCC_APB1ENR_TIM3EN;

// 配置TIM3时基：ARR, PSC, 时钟分割，计数模式
TIM3->ARR = tim3_pwm_config.arr;
TIM3->PSC = tim3_pwm_config.psc;
TIM3->CR1 &= ~TIM_CR1_DIR;           // 向上计数
TIM3->CR1 |= TIM_CR1_ARPE;          // 使能ARR预装载

// 配置CH1为PWM模式1
TIM3->CCMR1 &= ~TIM_CCMR1_OC1M;
TIM3->CCMR1 |= TIM_CCMR1_OC1M_2 | TIM_CCMR1_OC1M_1; // OC1M = 110 (PWM mode 1)
TIM3->CCER |= TIM_CCER_CC1E;                        // 使能CH1输出

// 配置CH2为PWM模式1
TIM3->CCMR1 &= ~TIM_CCMR1_OC2M;
TIM3->CCMR1 |= TIM_CCMR1_OC2M_2 | TIM_CCMR1_OC2M_1; // OC2M = 110
TIM3->CCER |= TIM_CCER_CC2E;                        // 使能CH2输出

// 初始化CCR值（0.5ms脉宽）
TIM3->CCR1 = 500; // 0.5ms @ 1MHz = 500 counts
TIM3->CCR2 = 500;

// 使能TIM3
TIM3->CR1 |= TIM_CR1_CEN;

关键点说明：
- TIM_CCMR1_OC1M_2 | TIM_CCMR1_OC1M_1 组合为 110b ，即PWM模式1，确保计数器向上计数时，当CNT < CCR输出高电平。
- TIM_CR1_ARPE 必须置位，否则ARR更新非原子操作，可能在计数中途修改导致周期跳变。
- CCR初始值设为500（对应0.5ms），使舵机上电即归零，符合安全启动逻辑。

4. 舵机角度控制算法实现

将角度映射为脉宽是舵机控制的核心算法。必须建立严格的线性映射关系，并加入防抖与限幅机制。

4.1 角度-脉宽转换公式

根据协议，0.5ms→0°，2.5ms→180°，线性关系为：

Pulse Width (us) = 500 + (angle × 11.111...) 
                 = 500 + (angle × 10000 / 180)
                 = 500 + (angle × 500 / 9)

为规避浮点运算与除法开销，采用整数运算优化：

#define PULSE_MIN_US 500U   // 0.5ms
#define PULSE_MAX_US 2500U  // 2.5ms
#define ANGLE_MIN_DEG 0U
#define ANGLE_MAX_DEG 180U

uint16_t angle_to_pulse(uint8_t angle) {
    if (angle < ANGLE_MIN_DEG) angle = ANGLE_MIN_DEG;
    if (angle > ANGLE_MAX_DEG) angle = ANGLE_MAX_DEG;

    // 线性插值：pulse = min + (angle - min_angle) * (max_pulse - min_pulse) / (max_angle - min_angle)
    // = 500 + angle * 2000 / 180 = 500 + angle * 100 / 9
    return PULSE_MIN_US + (uint32_t)angle * 100U / 9U;
}

此函数将0–180°角度无损映射为500–2500μs脉宽，精度达0.1°（因100/9≈11.111…，整数除法误差<0.01μs）。

4.2 安全控制策略

舵机机械响应存在惯性，若连续高频更新CCR值，会导致电机啸叫、定位不准甚至损坏齿轮。必须引入软件延时与状态校验：

void set_servo_angle(uint8_t channel, uint8_t angle) {
    uint16_t pulse = angle_to_pulse(angle);

    // 限幅：确保脉宽在合法范围
    if (pulse < PULSE_MIN_US) pulse = PULSE_MIN_US;
    if (pulse > PULSE_MAX_US) pulse = PULSE_MAX_US;

    // 更新CCR：CH1对应PA6，CH2对应PA7
    if (channel == 1) {
        TIM3->CCR1 = pulse;
    } else if (channel == 2) {
        TIM3->CCR2 = pulse;
    }

    // 强制最小延时：舵机典型响应时间为100–300ms，此处设200ms防抖
    delay_ms(200);
}

// 主循环中调用示例
int main(void) {
    // ... 初始化代码 ...

    while (1) {
        set_servo_angle(1, 0);   // 归零
        delay_ms(1000);

        set_servo_angle(1, 90);  // 中间位
        delay_ms(1000);

        set_servo_angle(1, 180); // 极限位
        delay_ms(1000);
    }
}

delay_ms(200) 是工程经验关键值：小于100ms舵机无法完成机械转动；大于500ms则响应迟钝。200ms在可靠性与实时性间取得平衡。

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

在烧录代码前，必须通过硬件级验证确认信号质量，避免“代码无错，硬件不动”的困境。

5.1 舵机测试仪的使用规范

舵机测试仪是专用诊断工具，其右侧标识”S+”、”S-“、”S”分别对应信号正、信号负、信号线。实际接线仅需：
- 测试仪”S+” 接舵机红色线（VCC）
- 测试仪”S-” 接舵机棕色线（GND）
- 测试仪”S” 接舵机黄色线（Signal）

旋钮调节即改变输出脉宽，观察舵机响应可快速判断：
- 若旋钮调节时舵机平稳转动 → 舵机本体完好
- 若旋钮调节无反应 → 检查供电电压（是否≥4.8V）、接线极性、共地是否可靠
- 若舵机抖动或异响 → 供电电流不足（需≥500mA）或信号干扰

此步骤前置，可将故障域精准定位至硬件或软件，大幅提升调试效率。

5.2 示波器信号捕获要点

使用示波器验证MCU输出信号，需关注三大指标：
- 周期稳定性 ：测量连续10个周期，偏差应<±1%（即19.8–20.2ms）
- 脉宽精度 ：在0.5ms、1.5ms、2.5ms三档下，实测值与理论值误差<±2μs
- 边沿陡峭度 ：上升/下降时间<100ns，确保信号完整性

典型故障信号特征：
- 周期漂移：ARR/PSC配置错误或时钟源不稳定
- 脉宽跳变：CCR更新未同步或ARPE未使能
- 信号削顶：GPIO驱动能力不足或负载过重（需加驱动芯片）

6. 双路舵机协同控制实践

虽然单舵机仅需一路PWM，但预留CH2通道为后续电机控制铺路。双路协同需注意时序一致性与资源竞争。

6.1 同步更新机制

若两路舵机需同步动作（如云台俯仰+偏航），必须确保CCR1与CCR2在同一更新事件中生效：

// 原子化同步更新
TIM3->CCR1 = pulse1;
TIM3->CCR2 = pulse2;
// 触发更新事件（强制重载CCR）
TIM3->EGR |= TIM_EGR_UG; // 产生更新事件

TIM_EGR_UG 置位将强制重载所有预装载寄存器，确保两路PWM参数在同一时刻生效，消除相位差。

6.2 电源设计警示

舵机属大电流瞬态负载，启动电流可达额定电流3–5倍。常见误区是直接使用ST-Link的3.3V供电驱动舵机，必然导致：
- MCU复位（因VDD跌落）
- 舵机失步（因供电不足）
- USB端口过流保护

正确方案：
- 舵机VCC与GND由独立稳压模块（如LM2596）提供5V/2A
- MCU与舵机GND必须单点共地，避免地线噪声耦合
- 信号线（PA6/PA7）与电源线分离走线，间距>5mm

7. 工程陷阱与实战经验

在数十个舵机项目中，以下问题反复出现，特此总结为避坑指南：

7.1 “代码编译无错，舵机不转”的十大原因

1. 共地缺失 ：MCU GND与舵机GND未连接 → 信号无参考电平
2. 供电不足 ：USB供电无法驱动舵机 → 必须外接5V/2A电源
3. AFIO时钟未使能 → PA6/PA7无法切换至复用功能
4. ARR/PSC计算错误 → 周期非20ms（用示波器验证）
5. CCER未使能通道 → TIM3->CCER |= TIM_CCER_CC1E 遗漏
6. TIM3时钟未使能 → RCC->APB1ENR |= RCC_APB1ENR_TIM3EN 遗漏
7. GPIO速度配置过低 → GPIO_CRH_MODE6_1 未设置为50MHz
8. 中断抢占优先级冲突 → 高优先级中断长时间占用CPU，TIM3更新被延迟
9. 引脚焊接虚焊 → PA6引脚接触不良（万用表通断测试）
10. 舵机损坏 → 用测试仪验证舵机本体（最易忽略的环节）

7.2 舵机寿命延长技巧

• 避免极限位置长期保持 ：持续施加2.5ms脉宽会使舵机电机堵转发热，建议在175°而非180°停靠
• 上电软启动 ：首次上电时，先发送0.5ms脉宽维持500ms，再逐步增加，防止齿轮冲击
• 信号线滤波 ：在PA6/PA7引脚串联100Ω电阻，靠近MCU端并联0.1μF陶瓷电容至GND，抑制高频噪声

我在一个农业机器人项目中曾因忽略第2条（供电不足），导致舵机在田间作业时频繁失步。更换为车载12V转5V/5A开关电源后，连续运行200小时无故障。硬件可靠性永远优先于软件炫技。

8. 从舵机到电机控制的演进路径

本节舵机方案实为直流电机控制的基石。二者核心差异仅在于：
- 舵机：单路PWM + 固定周期 → 角度控制
- 直流电机：双路PWM（IN1/IN2） + 可变占空比 → 方向+速度控制

TIM3_CH1/CH2已为此预留：
- CH1（PA6）接电机IN1
- CH2（PA7）接电机IN2
- 通过组合CH1/CH2的PWM输出，实现：
- 正转：CH1=50%，CH2=0%
- 反转：CH1=0%，CH2=50%
- 刹车：CH1=CH2=50%
- 停止：CH1=CH2=0%

此架构无需额外硬件，仅需修改 set_servo_angle() 为 set_motor_duty() ，并增加方向控制参数。真正的工程复用性，始于对底层时序的透彻理解。