保姆级教程：用STM32CubeMX HAL库驱动SG90舵机（附完整代码和接线图）
STM32CubeMX实战：HAL库驱动SG90舵机全流程解析
第一次接触STM32的PWM控制时，我被SG90舵机那精准的角度转动迷住了——原来只需要几行代码，就能让这个小巧的装置按照指令灵活摆动。本文将带你从零开始，用STM32CubeMX和HAL库搭建完整的舵机控制系统，特别适合手头有STM32F103C8T6开发板（蓝桥杯或正点原子常见型号）的嵌入式初学者。不同于简单的代码搬运，我会重点解释每个配置背后的原理，并分享几个调试时容易踩坑的细节。
1. 硬件准备与环境搭建
手边需要准备以下材料：
- STM32F103C8T6核心板（市面上常见的"蓝色药丸"开发板）
- SG90舵机（9g微型舵机，工作电压4.8-6V）
- 杜邦线若干（建议使用不同颜色区分电源和信号线）
- USB转TTL串口模块（用于程序烧录）
- 5V电源（可为舵机单独供电）
接线示意图：
STM32F103C8T6 SG90舵机 3.3V → RED(电源正极) GND → BROWN(电源负极) PB8 → ORANGE(PWM信号线)注意：当同时连接多个舵机时，建议使用外部5V电源供电，避免开发板USB供电不足导致舵机抖动或复位。
开发环境配置：
- 安装STM32CubeMX（最新版为6.9.2）
- 安装Keil MDK-ARM或STM32CubeIDE
- 安装对应芯片系列的HAL库包
- 准备ST-Link/V2烧录工具驱动
2. CubeMX工程配置详解
2.1 创建新工程
启动CubeMX后，选择"Access to MCU Selector"，在搜索框输入"STM32F103C8"，双击选中STM32F103C8Tx型号。这个系列芯片性价比高，内置定时器资源丰富，非常适合舵机控制等基础外设实验。
2.2 时钟树配置
在RCC配置中，将HSE（外部高速时钟）设为Crystal/Ceramic Resonator。然后进入Clock Configuration标签页，按如下参数配置：
- HCLK设为72MHz（STM32F103的最大主频）
- APB1 Timer clocks设为72MHz
- APB2 Timer clocks设为72MHz
时钟配置直接影响PWM信号的精度，建议先按下图配置，后续可根据舵机响应情况微调：
[时钟树配置示意图]2.3 定时器PWM配置
SG90舵机需要50Hz（周期20ms）的PWM信号，角度控制通过0.5ms-2.5ms的脉宽实现。我们使用TIM4的Channel3（对应PB8引脚）：
- 左侧引脚图中找到PB8，设置为TIM4_CH3
- 在TIM4配置界面：
- Clock Source选择Internal Clock
- Channel3选择PWM Generation CH3
- Prescaler设为71（72MHz/(71+1)=1MHz）
- Counter Period设为19999（1MHz/20000=50Hz）
- Pulse初始值设为500（对应0.5ms脉宽）
- CH Polarity必须设为High（关键配置！）
参数计算公式：
PWM频率 = 定时器时钟 / ((Prescaler+1)*(Counter Period+1)) PWM脉宽 = (Pulse+1) / 定时器时钟(Hz)2.4 调试LED配置（可选）
为方便观察程序运行状态，可配置PB9引脚控制LED：
- 将PB9设为GPIO_Output
- 在Project Manager中勾选"Generate peripheral initialization as a pair of '.c/.h' files"
3. 代码生成与业务逻辑实现
3.1 生成工程代码
点击"Project Manager"标签：
- 设置工程名称（如SG90_Control）
- 选择Toolchain/IDE（MDK-ARM或STM32CubeIDE）
- 勾选"Generate peripheral initialization as a pair of '.c/.h' files"
- 最后点击"GENERATE CODE"
3.2 添加舵机控制代码
在main.c文件中找到/* USER CODE BEGIN 2 /和/ USER CODE END 2 */之间的区域，添加PWM启动代码：
/* 启动TIM4 Channel3的PWM输出 */ HAL_TIM_PWM_Start(&htim4, TIM_CHANNEL_3);然后在while循环中添加角度控制逻辑：
while (1) { // 0度位置 __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, 500); HAL_Delay(1000); // 45度位置 __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, 1000); HAL_Delay(1000); // 90度位置 __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, 1500); HAL_Delay(1000); // 135度位置 __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, 1750); HAL_Delay(1000); // 180度位置 __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, 2000); HAL_Delay(1000); }3.3 调试LED控制（可选）
在while循环前添加LED初始化闪烁，用于确认程序正常运行：
// LED快速闪烁3次表示初始化成功 for(int i=0; i<3; i++) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_9, GPIO_PIN_SET); HAL_Delay(200); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_9, GPIO_PIN_RESET); HAL_Delay(200); }4. 常见问题与进阶技巧
4.1 舵机抖动或不响应
可能原因及解决方案：
- 电源不足：单独为舵机提供5V电源，与开发板共地
- 信号线接触不良：检查杜邦线连接，或更换质量更好的连接线
- PWM参数错误：用示波器检查PB8引脚输出波形是否符合50Hz、0.5-2.5ms脉宽要求
- 代码未烧录成功：通过LED指示灯确认程序是否正常运行
4.2 角度控制不精确
SG90舵机存在个体差异，建议进行校准：
- 记录舵机实际角度与PWM脉宽的对应关系
- 建立校准表，在代码中使用线性插值计算
// 示例：角度到PWM值的转换函数 uint16_t AngleToPulse(uint8_t angle) { // 校准数据：0°=500, 180°=2500 return 500 + (angle * 2000 / 180); }4.3 多舵机协同控制
当需要控制多个舵机时（如机械臂项目），可以采用：
- 多定时器法：为每个舵机分配独立的定时器
- 单定时器多通道：一个定时器配置多个PWM通道
- PWM扩展模块：使用PCA9685等专用芯片扩展控制通道
性能对比表：
| 方案 | 资源占用 | 精度 | 实现难度 | 适用场景 |
|---|---|---|---|---|
| 多定时器 | 高 | 高 | 中 | 3-4个舵机 |
| 单定时器多通道 | 低 | 中 | 低 | ≤2个舵机 |
| PWM扩展模块 | 最低 | 高 | 高 | 多个舵机 |
4.4 使用中断实现平滑运动
为避免舵机突然跳动，可以实现渐变移动效果：
void SmoothMove(uint16_t target_pulse) { uint16_t current = __HAL_TIM_GET_COMPARE(&htim4, TIM_CHANNEL_3); int step = (target_pulse > current) ? 1 : -1; while(current != target_pulse) { current += step; __HAL_TIM_SET_COMPARE(&htim4, TIM_CHANNEL_3, current); HAL_Delay(10); // 控制运动速度 } }5. 项目扩展与实用案例
掌握了基础控制后，可以尝试这些实际应用：
智能垃圾桶方案：
- 超声波传感器检测物体距离
- 当距离<10cm时，舵机带动桶盖开启
- 5秒后自动关闭
// 简化版代码逻辑 if(HCSR04_GetDistance() < 10) { SmoothMove(1000); // 开盖位置 HAL_Delay(5000); SmoothMove(500); // 关盖位置 }摄像头云台控制：
- 两个舵机分别控制水平和垂直方向
- 通过串口接收控制指令
- 实现远程角度调整
机械臂基础动作：
- 3-4个舵机协同工作
- 预设抓取、放置等动作序列
- 加入限位保护机制
在调试多自由度机械结构时，我发现一个实用技巧：先用胶带临时固定舵机，调整好机械结构后再永久固定，可以避免反复拆装损坏舵机齿轮。另外，给舵机供电线路加上1000μF的电容，能有效减少电压波动导致的异常抖动。