STM32定时器玩转SG90舵机：从PWM波形到代码实战，一个CubeMX配置就搞定
STM32定时器玩转SG90舵机：从PWM波形到代码实战，一个CubeMX配置就搞定
在嵌入式开发中，舵机控制是一个经典且实用的项目。SG90作为入门级舵机的代表，因其体积小、价格低、控制简单等特点，常被用于机器人关节、摄像头云台等场景。传统的舵机控制方法往往需要手动计算PWM参数并配置复杂的寄存器，这对于初学者来说无疑是一道门槛。而STM32CubeMX的出现，让这一切变得简单直观。
本文将带你用STM32CubeMX这一图形化配置工具，快速生成控制SG90舵机所需的PWM信号。无需深入理解底层寄存器，只需几个简单的配置步骤，就能让舵机按照你的指令精准转动。我们不仅会讲解CubeMX的具体配置方法，还会分析PWM参数与舵机角度的对应关系，最后给出可直接调用的代码示例。
1. 理解SG90舵机的PWM控制原理
SG90舵机的控制核心在于PWM（脉冲宽度调制）信号。这种9克微型舵机通常需要满足以下信号要求：
- 周期：20ms（频率50Hz）
- 脉冲宽度：0.5ms-2.5ms
- 对应角度：0.5ms对应0度，2.5ms对应180度（部分型号为90度）
关键参数关系：
角度 = (脉宽 - 0.5ms) × (180° / 2.0ms)注意：不同厂家生产的SG90可能存在微小差异，建议在实际使用前进行校准。
在STM32中，我们需要通过定时器来生成这样的PWM信号。传统方法需要手动计算定时器的预分频值(PSC)和自动重装载值(ARR)，而CubeMX可以帮我们自动完成这些计算。
2. CubeMX工程创建与基本配置
首先启动STM32CubeMX并完成以下基础设置：
- 选择芯片型号：根据你的开发板选择对应的STM32系列（如STM32F103C8T6）
- 配置系统时钟：
- 在"Clock Configuration"标签页设置系统时钟
- 对于STM32F1系列，通常设置为72MHz
- 启用调试接口：在"System Core"→"SYS"中启用SWD调试
提示：确保你的时钟配置正确，错误的时钟设置会导致PWM频率不准确。
3. 定时器PWM通道配置
以TIM1的通道1为例，配置步骤如下：
- 在"Pinout & Configuration"界面找到TIM1
- 选择Channel1为"PWM Generation CH1"
- 在"Parameter Settings"标签页配置：
- Prescaler (PSC): 71
- Counter Mode: Up
- Counter Period (ARR): 1999
- Pulse (CCR): 初始值设为150（对应1.5ms脉宽）
- CH Polarity: High
参数计算原理：
定时器时钟 = 系统时钟 / (PSC + 1) = 72MHz / 72 = 1MHz PWM周期 = (ARR + 1) / 定时器时钟 = 2000 / 1MHz = 2ms这里我们配置为2ms周期而非标准的20ms，是为了提高控制精度。实际应用中可通过软件分频实现20ms周期。
4. GPIO引脚配置与工程生成
- 确认TIM1_CH1对应的GPIO引脚已自动配置为复用功能
- 在"Project Manager"标签页设置工程名称和路径
- 选择开发环境（MDK-ARM/IAR/STM32CubeIDE等）
- 点击"Generate Code"生成工程
生成的关键代码位于：
tim.c：定时器初始化配置main.c：用户代码区域
5. 编写舵机控制代码
在生成的工程中，添加以下控制代码：
/* 在main.c的USER CODE BEGIN 2部分添加 */ HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); /* 在while循环中添加控制代码 */ while (1) { // 0度位置 __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 50); // 0.5ms HAL_Delay(1000); // 90度位置 __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 150); // 1.5ms HAL_Delay(1000); // 180度位置 __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 250); // 2.5ms HAL_Delay(1000); }脉宽与CCR值换算：
CCR值 = (期望脉宽 / PWM周期) × (ARR + 1) 例如：1.5ms脉宽 → (1.5/2.0)×2000 = 1506. 进阶技巧与常见问题
6.1 提高控制精度
为了获得更精细的角度控制，可以采用以下方法：
增加ARR值：将ARR设为更大的值（如19999），同时调整PSC保持20ms周期
PSC = 71 ARR = 19999 周期 = (19999+1)/1MHz = 20ms CCR范围：500-2500（对应0.5ms-2.5ms）使用浮点计算：先计算所需角度对应的CCR值，再四舍五入为整数
float angle = 45.0; // 45度 uint16_t ccr = (uint16_t)((angle / 180.0 * 2000.0) + 500.0); __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, ccr);
6.2 常见问题排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 舵机不转动 | 电源不足 | 确保使用5V电源，开发板USB供电可能不足 |
| 舵机抖动 | PWM频率不准 | 检查时钟配置和定时器参数 |
| 角度不准确 | 脉宽范围不对 | 校准0度和180度对应的CCR值 |
| 发热严重 | 堵转或过载 | 避免机械阻力过大，检查负载 |
6.3 多舵机控制
当需要控制多个舵机时，可以采用以下方案：
- 使用多个定时器：每个定时器控制1-4个舵机（取决于通道数）
- 单定时器多通道：一个定时器的不同通道控制不同舵机
- PWM扩展模块：如PCA9685，通过I2C控制多达16路PWM
// 多通道控制示例 HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_2); while(1) { __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 150); // 舵机1到90度 __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_2, 200); // 舵机2到135度 HAL_Delay(1000); }7. 实际应用案例：简易云台控制
结合两个SG90舵机，我们可以构建一个简单的双轴云台系统：
硬件连接：
- 水平舵机：TIM1_CH1
- 垂直舵机：TIM2_CH1
- 共用5V电源（建议外接电源）
控制代码：
typedef struct { TIM_HandleTypeDef *htim; uint32_t channel; uint16_t min_ccr; uint16_t max_ccr; uint16_t current_ccr; } Servo; Servo pan_servo = {&htim1, TIM_CHANNEL_1, 50, 250, 150}; Servo tilt_servo = {&htim2, TIM_CHANNEL_1, 50, 250, 150}; void set_servo_angle(Servo *s, float angle) { angle = angle < 0 ? 0 : (angle > 180 ? 180 : angle); s->current_ccr = s->min_ccr + (uint16_t)(angle / 180.0 * (s->max_ccr - s->min_ccr)); __HAL_TIM_SET_COMPARE(s->htim, s->channel, s->current_ccr); } // 在主循环中调用 set_servo_angle(&pan_servo, 45.0); // 水平45度 set_servo_angle(&tilt_servo, 30.0); // 俯仰30度- 扩展功能：
- 添加摇杆控制
- 实现平滑移动效果
- 增加限位保护
通过这个案例，我们可以看到CubeMX配置PWM控制舵机的高效性。相比传统寄存器级的开发方式，CubeMX不仅减少了出错概率，还大幅提高了开发效率。对于需要快速验证想件的开发者来说，这无疑是最佳选择。