STM32F103新手避坑：用TIM2的PWM驱动MG996舵机，从代码到转动的保姆级教程
STM32F103新手避坑：用TIM2的PWM驱动MG996舵机，从代码到转动的保姆级教程
第一次用STM32F103驱动MG996舵机时，我盯着纹丝不动的舵机发呆了半小时。网上那些零散的代码片段就像拼图缺了关键几块——明明照着做了，为什么舵机就是不转？直到用逻辑分析仪捕获到PWM波形，才发现定时器配置里藏着一个初学者最容易忽略的细节。本文将带你从零开始，用TIM2生成精准的50Hz PWM信号，避开那些让新手抓狂的坑。
1. 为什么选择TIM2和这些参数？
刚接触STM32的PWM功能时，最让人困惑的莫过于定时器那一堆参数。让我们拆解这段配置：
TIM_TimeBaseInitStucture.TIM_Period = 2000-1; // ARR值 TIM_TimeBaseInitStucture.TIM_Prescaler = 720-1; // PSC值时钟树是关键：STM32F103的APB1定时器时钟通常是72MHz。预分频720意味着每个定时器时钟周期为：
$$ 定时器频率 = \frac{72MHz}{720} = 100kHz $$
此时每个计数周期耗时10μs。ARR设为2000-1，则PWM周期为：
$$ PWM周期 = (2000) \times 10μs = 20ms \Rightarrow 50Hz $$
这正是MG996舵机需要的基准频率。但这里有个隐藏陷阱：STM32的预分频器实际值为写入值加1，所以720-1才是正确的分频系数。
提示：用STM32CubeMX验证时钟配置时，务必检查"Clock Configuration"标签页的APB1 Timer Clocks数值
2. GPIO配置的魔鬼细节
原始代码中GPIO初始化有个典型错误：
GPIO_InitStucture.GPIO_Pin = GPIO_Pin_1; // 但注释写的是PA0引脚映射必须精确：TIM2_CH2对应的是PA1引脚，不是PA0。正确的配置应该是：
| 参数 | 配置值 | 说明 |
|---|---|---|
| GPIO_Mode | GPIO_Mode_AF_PP | 复用推挽输出 |
| GPIO_Pin | GPIO_Pin_1 | PA1对应TIM2_CH2 |
| GPIO_Speed | GPIO_Speed_50MHz | 高速模式确保信号质量 |
常见错误排查清单：
- 确认开发板原理图上的引脚连接
- 检查GPIO时钟是否启用（RCC_APB2Periph_GPIOA）
- 示波器测量引脚是否有信号输出
3. 完整的PWM初始化流程
下面这个增强版初始化函数增加了错误检查：
void PWM_Init(void) { // 1. 时钟使能 RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 2. GPIO配置 GPIO_InitTypeDef GPIO_InitStruct = { .GPIO_Pin = GPIO_Pin_1, .GPIO_Mode = GPIO_Mode_AF_PP, .GPIO_Speed = GPIO_Speed_50MHz }; GPIO_Init(GPIOA, &GPIO_InitStruct); // 3. 时基单元配置 TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStruct = { .TIM_Period = 2000-1, .TIM_Prescaler = 720-1, .TIM_ClockDivision = TIM_CKD_DIV1, .TIM_CounterMode = TIM_CounterMode_Up }; TIM_TimeBaseInit(TIM2, &TIM_TimeBaseInitStruct); // 4. 输出比较配置 TIM_OCInitTypeDef TIM_OCInitStruct = { .TIM_OCMode = TIM_OCMode_PWM1, .TIM_OutputState = ENABLE, .TIM_Pulse = 150, // 初始占空比1.5ms(中立位) .TIM_OCPolarity = TIM_OCPolarity_High }; TIM_OC2Init(TIM2, &TIM_OCInitStruct); // 5. 启动定时器 TIM_Cmd(TIM2, ENABLE); }关键改进点：
- 添加了初始Pulse值（150对应1.5ms脉宽）
- 使用结构体初始化语法提升可读性
- 明确分离配置步骤
4. 精准控制舵机角度
MG996的脉宽与角度关系：
| 脉宽 | 对应角度 | Compare值 |
|---|---|---|
| 0.5ms | 0° | 50 |
| 1.5ms | 90° | 150 |
| 2.5ms | 180° | 250 |
改进版的占空比设置函数：
void PWM_SetAngle(uint8_t angle) { // 将角度转换为CCR值 (0~180° -> 50~250) uint16_t compare = 50 + (angle * 200) / 180; TIM_SetCompare2(TIM2, compare); // 调试输出 printf("Angle:%d° -> CCR:%d\n", angle, compare); }实测技巧：
- 上电时先给1.5ms中立位信号
- 每次角度变化后延迟100ms以上
- 用逻辑分析仪验证实际脉宽
5. 故障排查实战指南
当舵机无反应时，按照以下流程检查：
电源检查
- 万用表测量舵机供电电压（需5V-6V）
- 确保电源能提供足够电流（MG996峰值可达1.2A）
信号检查
# 用OpenOCD捕获引脚状态 halt mdw 0x40000000 # 查看TIM2寄存器波形测量
- 示波器观察PA1引脚
- 正常波形特征：
- 频率：50Hz±5%
- 高电平时间：0.5-2.5ms
- 上升沿干净无振铃
常见问题解决方案表：
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 舵机抖动不转 | 电源功率不足 | 更换2A以上电源 |
| 只能单向转动 | 脉宽范围不正确 | 调整CCR最小/最大值 |
| 随机角度偏移 | 地线接触不良 | 检查共地连接 |
| 发热严重 | 机械卡阻 | 断开负载检查是否自由转动 |
6. 进阶：用中断实现平滑运动
想要舵机缓慢转动到指定角度？试试这个带缓动的实现：
#define STEP_DELAY 20 // 每步延时(ms) void PWM_SmoothMove(uint8_t target_angle) { static uint8_t current_angle = 90; int8_t direction = (target_angle > current_angle) ? 1 : -1; while(current_angle != target_angle) { current_angle += direction; PWM_SetAngle(current_angle); Delay_ms(STEP_DELAY); } }配合SysTick定时器，可以创建更复杂的运动曲线。记得在main()初始化时调用：
// 系统时钟72MHz时，1ms中断 SysTick_Config(SystemCoreClock / 1000);最后分享一个调试心得：当PWM信号看似正常但舵机仍不响应时，尝试用示波器同时捕获电源电压和信号线——有时电源跌落会导致舵机控制电路复位。我在实验室就遇到过因为长导线电阻导致的问题，换成更粗的电源线后立即解决。