TECHNICAL SUPPORT
发布时间： 2026-05-18
舵机是一种常见的由电机驱动的装置，它能够对输出轴的角度位置实施精确控制，其应用范围广泛，涵盖机器人关节、航模、智能小车等领域。编写舵机程序的核心要点在于，借助控制器比如单片机，向舵机发送具备特定周期以及占空比的脉冲宽度调制也就是PWM信号，以此来指挥舵机转动至指定角度。本文给出一套清晰的、能够直接执行的编程方法，该方法覆盖常用开发平台，能确保你迅速上手并达成舵机控制。
舵机的管控是全方位依靠PWM信号的，你并不需要去深入探究繁杂的电机理论，仅仅只需明白以下核心关系就好了。
控制线：通常为橙色或白色，用于接收PWM信号。
PWM信号的周期，一般情况下是20毫秒，也就是频率为50Hz。这里信号内涵的关键之处，在于其高电平持续的那个时间，也就是脉冲宽度，这个脉冲宽度直接对应的是舵机的目标角度。
标准对应关系（以180度舵机为例）：
脉冲宽度 0.5ms → 舵机转到 0度 位置。
脉冲宽度 1.5ms → 舵机转到 90度 位置。
脉冲宽度 2.5ms → 舵机转到 180度 位置。
它的脉冲宽度可是在那个0.5ms直至2.5ms的范围之内，呈现出线性变化的态势，而与之相对应的角度呢，则是在0到180度这个区间之中，做着线性转动的动作。
以为基础的代码，以STM32（HAL库）为基础的代码，还有以树莓派（）为基础的代码，全都依照上述PWM原理，你能够直接复制去使用。
内置了便捷的Servo库，是入门最快的方式。
# // 引入舵机库
Servo ; // 创建舵机对象
int = 9; // 舵机信号线连接的数字引脚（支持PWM的引脚，如3,5,6,9,10,11）
void setup() {
.(); // 初始化舵机，绑定控制引脚
}
void loop() {
.write(0); // 控制舵机转到0度
delay(1000); // 等待1秒
.write(90); // 控制舵机转到90度
delay(1000);
.write(180); // 控制舵机转到180度
delay(1000);
}
核心操作：函数.write(angle)，它接受的是处于0到180之间的整数角度值，之后库函数会自动把这个值转换为对应的PWM信号。
针对那些有着更高精度需求的情景，亦或是有着自定义PWM参数要求的情形，能够通过手动方式来进行定时器的配置。
// 假设使用TIM1的通道1（PA8）生成PWM
void (float angle) {
// 1. 将角度转换为脉冲宽度（us），假设0°=500us, 180°=
= 500 + (angle / 180.0) 2000; // 核心计算公式
// 2. 将脉冲宽度转换为定时器比较寄存器的值（ARR为自动重装载值，决定PWM周期）
// 假设定时器时钟频率为84MHz，预分频器PSC=83，则计数频率为1MHz（1us计数一次）
// PWM周期设为20ms（），则ARR应设置为200001
= ; // 因为1us对应一个计数值
// 3. 更新比较寄存器的值
E(&htim1, , );
}
// 在主函数或某个任务中调用
int main() {
// ... 定时器、GPIO初始化代码（由生成）
(&htim1, ); // 启动PWM输出
while (1) {
(45.0); // 转到45度
(1000);
(135.0); // 转到135度
(1000);
}
}
核心操作，关键之处在于这样一个公式，即等于500加上括号内angle除以180.0之后的结果再乘以2000，此公式达成了角度到实际控制信号也就是脉冲宽度的精准映射。
树莓派通过GPIO库生成PWM信号，简单直观。
RPi.GPIO as GPIO
time
= 18 # 舵机信号线连接的GPIO引脚（如）
# 设置GPIO模式和引脚
GPIO.(GPIO.BCM)
GPIO.setup(, GPIO.OUT)
# 创建PWM对象，频率设置为50Hz（周期20ms）
pwm = GPIO.PWM(, 50)
pwm.start(0) # 启动PWM，初始占空比为0
def (angle):
# 关键：将角度转换为占空比
# 公式：占空比 = (0.5ms + angle(2.0ms/180)) / 20ms 100%
duty = 2.5 + (angle / 18.0) # 简化后的计算公式
pwm.(duty)
try:
while True:
(0) # 0度
time.sleep(1)
(90) # 90度
time.sleep(1)
(180) # 180度
time.sleep(1)
:
pwm.stop()
GPIO.()
核心操作中，duty = 2.5 + (angle / 18.0) 这个公式，属于角度到PWM占空比的直接转换公式，它是树莓派平台控制里的核心。
1. 舵机抖动或不转动：
查看电源情况，要保证供电的电压以及电流充足，一般而言数值通常是5 6V，并且电流要大于1A才行，建议凭借独立的电源给舵机供应电力，防止从控制器获取电力致使电压被拉低。
测量信号：借助示波器或者逻辑分析仪去测定PWM信号的周期，查看其是否在20ms左右，还要测定脉冲宽度，看其是否随着角度而精确变化。
针对地线进行检查，一定要要保证控制器，像是单片机，和舵机的地线，也就是GND，连接成为一体，这是促使信号回路得以形成的关键所在。
2. 角度控制不准确：
使校准处于中间位置：实际运作的舵机的“0度”同“180度”所对应的脉冲宽度的边界数值或许会稍微存在差别能够借助实验找寻到舵机恰好开始转动以及抵达极限的脉冲宽度数值用以替换代码里的500us还有。
留意对于机械的限位情况，要防止去发送那种会超出舵机物理所拥有的极限范围的脉冲信号，像是那样时长达到2.5ms的信号，不然的话就存在有可能致使齿轮被损坏的情况。
3. 控制多个舵机：
方法一（此方法为笔者大力推荐之方式）：运用那个专门用于精准运作舵机的控制板。这种板借助I2C、UART这般极其繁复且有一定技术关联的接口，与操纵整个系统运行的主控装置进行信息交互和沟通，它具备这样一种强大能力，那就是能够同时去驱动16个乃至数量更多的舵机，其在程序编写方面呈现出一种特别容易简单的状态，并且在电源管理这个关键环节上，有着十分便利的特性。
方法二：要是主控具备充足数量的PWM输出通道，像是STM32的多个定时器通道这种情况伟创动力，那么能够给每个舵机分派一个单独的PWM通道。
方法三，此方法不推荐用于多关节实时控制，是什么方法，是使用单个定时器通道，如何使用，是通过软件依次生成不同舵机的PWM信号伟创动力舵机，不过，此法响应慢且占用CPU。
首要点：撰写舵机程序实质上是造就精准的PWM信号。不管运用哪一种平台，重点之处在于把目标的角度确切地转变为相对应的脉冲宽度，或者把目标的角度确切地转变为对应的占空比，并且借助硬件或者软件的PWM功能予以输出。
立即行动建议：
1. 硬件怎样连接呢：要把舵机的三条线（分别是信号、电源+、电源）连接得正确无误，而且要给舵机供应独立的、充足的电源。
2. 根据你项目的复杂程度，来挑选最为合适的平台，其中是最容易入门的那款，STM32适宜高性能方面的需求，树莓派则契合上层应用开发。
3. 进行复制以及作测试：直接去复制上文里对应那个平台的代码，把引脚定义作出修改之后，开展上传或者运行的操作，去观察舵机是不是按照预期那样进行转动。
4. 进入更高阶段实践：试着操控多个舵机，制作出一个简易的机械臂，或者达成舵机从当下位置朝着目标位置平缓运作的（比如插值）。
按上述原理、代码以及排错指南来遵循，绝大部分舵机控制程序你能够自主去完成编写。要记住，程序检验的唯一标准是实践，硬件连接以及代码运行是学习进程里最为关键的一步。
