如果你玩ESP32有一阵子了，很难不碰到舵机控制这道坎。做智能小车要转方向，做机械臂要抬关节，做云台要偏航俯仰，背后都是同一个东西在干活：舵机。而我见过太多人卡在“代码能编译、舵机就是不听话”这个阶段，要么抖动、要么转不到位、要么接上就重启。这篇ESP32舵机控制全攻略，就是要把这些坑一次性填平：从PWM信号原理、舵机选型、供电设计，到ESP32驱动代码、多舵机管理、平滑运动、串口指令控制，一路讲到高级玩法。新手上手能照着接线跑通第一个例子，有基础的人也能从高级部分找到优化思路。

1. 项目整体拆解：为什么偏偏用ESP32玩舵机

先说方案选型。单片机世界里能做舵机控制的板子很多，但ESP32有几个特性让它特别适合干这活：一是PWM资源多，内置LEDC（LED Control）控制器，最多支持16路PWM输出，不需要外挂扩展芯片就能驱动十来个舵机；二是引脚数量足够多，给每个舵机分配独立信号线很宽松；三是主频高，240MHz跑复杂控制逻辑、多舵机插值运算都不吃力；四是自带Wi-Fi和蓝牙，做完本地控制还能接上位机、接手机，这个后面讲高级应用会用到。

我最初做舵机控制其实用的是普通开发板，引脚少、PWM通道也少，接两个舵机就得精打细算，频率稍微不对整个程序就乱了。换成ESP32之后，最大的感受是“从省着用变成随便用”：16个PWM通道、4组定时器、微秒级脉宽精度，这些参数放在舵机控制场景里非常宽裕。

这套方案要解决的核心问题，其实可以归纳成三类。第一类是“转不起来”：舵机不动作、角度偏、或者上电就卡死，这多半是硬件接线和供电的问题。第二类是“转不准”：角度误差、回中偏差、两路舵机动作不同步，这是PWM信号和控制逻辑的问题。第三类是“转不漂亮”：舵机像开关一样啪地弹过去而不是平滑运动，这是运动规划的问题。大部分人做到第一类就放弃了，实际上后两类才是让项目看起来“专业”的分水岭。

这篇攻略采用的思路是从底层原理讲起，再做最小系统验证，最后往上叠加功能。我不会一上来就丢一堆代码，而是先把“为什么舵机要50Hz PWM”“为什么脉宽是0.5ms到2.5ms”“为什么必须共地”这些底层逻辑讲清楚，这样后面排查问题才有依据。

2. 舵机控制的核心：PWM信号、选型与供电

2.1 角度是靠“脉宽”而不是“占空比”决定的

先聊最容易被忽略的基础。标准模拟舵机的控制信号，是一路周期为20ms的PWM方波，也就是50Hz。舵机真正关心的是高电平持续多久，这个“高电平持续时间”叫脉宽，单位是微秒。

绝大多数标准舵机的脉宽映射关系是这样的：0.5ms脉宽对应0°，1.5ms对应90°，2.5ms对应180°。换算成角度就是：

脉宽(µs) = 500 + (角度 / 180.0) * 2000

反过来说，如果要让舵机停在45°，那脉宽就是500 + 45 / 180 * 2000 = 1000µs，也就是1ms。

这里有个很多人踩过的坑：一听到PWM就只关心占空比。比如你用50Hz频率、50%占空比去驱动舵机，得到的高电平是10ms，远超过2.5ms，舵机要么直接打死，要么狂抖。占空比是比值，而舵机读的是绝对值。所以一定要记住频率固定50Hz、脉宽才是控制量。

有些数字舵机支持更高频率，比如333Hz，甚至部分总线舵机完全不走PWM协议。选舵机前先确认类型，标准模拟舵机就老老实实按50Hz来。

2.2 常见舵机型号怎么选：不是扭矩越大越好

我常用的是常见的SG90小舵机和MG996R金属齿轮大舵机，这两个型号足够说明选型逻辑。SG90是塑料齿轮，重量9g左右，扭矩大约1.8kg·cm，适合做小车转向、云台俯仰、小型机械臂的末端关节。MG996R是金属齿轮，重量55g左右，扭矩能达到11kg·cm左右，适合做机械臂大臂、底盘转向这类需要承受较大负载的关节。

选型核心看三点。

第一是扭矩余量。舵机的峰值扭矩要大于关节实际负载的2到3倍。如果关节需要1kg·cm的力，用SG90的1.8kg·cm勉强够，但长时间接近满负荷运转会发热严重、寿命骤降。这时候就该上MG996R或者更高一级的舵机。

第二是工作电压。SG90标称4.8V，MG996R可以支持4.8V到6.8V。电压越高扭矩越大，但同时电流也上去。很多人直接把舵机接到ESP32的3.3V引脚上，结果连空载都转不动，道理就在这。常规做法是给舵机一个5V的独立电源，电压不足时再考虑升压或换更高电压舵机。

第三是齿轮材质。金属齿轮抗冲击、寿命长，但价格高、重量大、电流需求也高；塑料齿轮便宜、轻巧，适合低速轻载场景。高速碰撞场景比如机器狗、机械臂快速摆动，别用塑料齿轮，容易扫齿。

2.3 供电设计：最容易翻车的环节没有之一

我调试舵机项目时踩过最狠的坑就是供电。一个SG90空载电流大概100mA到200mA，堵转时能飙到650mA甚至更高；MG996R堵转电流可以超过2A。而大部分ESP32开发板的板载稳压器，能稳定输出的电流也就500mA左右，还要分给主控和Wi-Fi。

结果就是：舵机一启动，电压瞬间被拉低，ESP32直接重启，或者舵机在原地嗡嗡发抖。

正确接法分两路走：ESP32用USB供电或独立的3.3V/5V供电，舵机用独立的5V电源供电，两者之间必须共地。所谓共地，就是把外部电源的负极和ESP32的GND引脚连在一起。如果不共地，PWM信号的电平参考点不一致，舵机收到的信号可能完全乱掉。

如果你只是测试一个SG90，用5V 1A的适配器就够；如果是两个MG996R，建议上5V 3A以上的电源，或者直接用2S锂电池加5V稳压模块/UBEC。总之舵机电源宁大勿小，尤其不要图省事直接从ESP32开发板的Vin引脚甚至3.3V引脚取电。

3. 硬件连接与最小系统搭建

3.1 三根线的正确接法

标准舵机引出来三根线，颜色约定一般是：棕色或黑色是地线（GND），红色是电源线（VCC），橙色或黄色是信号线（Signal）。

信号线接ESP32的GPIO引脚，电源线接外部5V正极，地线接外部电源负极，同时和ESP32的GND相连。注意信号线绝对不要接到5V上，ESP32的GPIO是3.3V逻辑，直接接5V轻则IO口损坏，重则烧芯片。某些舵机（尤其是工业舵机）需要5V逻辑信号，那就要加电平转换电路，不能用3.3V直驱。

推荐优先使用的信号引脚有GPIO13、GPIO12、GPIO14、GPIO27、GPIO26、GPIO25。这几个引脚没有上电时序限制，也没有板载外设占用，是舵机控制的“安全区”。需要避开的是GPIO0（BOOT引脚）、GPIO1和GPIO3（串口）、GPIO6到GPIO11（连接板载Flash）等。

3.2 布线实践：信号线要短，地线要粗

常见场景里，舵机装在机械臂末端，信号线要走一两米，这时就容易出问题。舵机信号线最好控制在20cm以内，越短越稳。如果必须长距离走线，用屏蔽线或者双绞线，并且GPIO上可以加一个1kΩ串联电阻，降低信号反射和干扰。

电源线路也要注意。舵机启动瞬间电流很大，如果电源线太细，线路压降会把5V拉到4V以下，舵机自然没劲。我习惯用18AWG以上的线做舵机电源线，或者直接焊线到舵机端而不是用杜邦线。实测过用普通杜邦线带两个MG996R同时动作，线会发热，电压跌落很明显。

最后说一句，多舵机项目里，建议给每个舵机电源端加一个100µF到470µF的电解电容，靠近舵机电源输入位置。这个电容能在启动瞬间补充电流，能明显减少电压跌落导致的抖动。

4. 开发环境配置与舵机库选型

4.1 安装Arduino Core for ESP32与ESP32Servo库

软件侧我用的是Arduino IDE加Espressif官方Arduino Core。安装好核心之后，还需要装一个关键库：ESP32Servo。这个库是专门为ESP32适配的舵机控制库，底层封装了LEDC的PWM设置，并把控制接口抽象成类似普通开发板Servo库的写法。

在Arduino库管理器里搜索“ESP32Servo”直接安装，作者是某个社区开发者，这已经是ESP32舵机控制事实上最常用的库。它能同时管理十几路舵机，支持微秒级脉宽写入，还内置了平滑移动方法，后面的高级应用会用到。

如果不用这个库，直接用ESP32自带的LEDC API写PWM也行，但手写的代码要多处理定时器分组、通道分配这些细节，对新手不友好。我的建议是：标准舵机控制场景一律用ESP32Servo，只有需要非常规频率或自定义波形的特殊需求，才直接用LEDC API。

4.2 ESP32Servo库与LEDC API的关系

理解一下底层逻辑。ESP32的LEDC模块有16个通道，分成4组定时器，每组定时器最多带8个通道。同组定时器的通道必须共用相同的频率和分辨率。ESP32Servo库会把舵机请求的50Hz设置到某个定时器组，然后把通道分配给舵机。

这里有个容易踩雷的地方：同一组定时器里所有通道频率必须相同，如果你在一个项目里又用LEDC做LED呼吸灯（频率比如5kHz），又用ESP32Servo驱动舵机（50Hz），两者如果落在同一组定时器上，会互相干扰，表现为舵机乱抖、灯频闪。解决办法是手动指定servo库使用不同的定时器，或者干脆舵机和LED呼吸灯用不同的LEDC定时器组。

我一般在多任务项目里习惯拆成两组：一组定时器专门给舵机，另一组定时器给其它PWM设备，这样互不干扰。

5. 基础驱动代码：从write到自定义脉宽

5.1 最小驱动代码

装好库之后，跑通第一个舵机最简单：

#include <ESP32Servo.h> Servo myServo; const int servoPin = 13; void setup() { myServo.attach(servoPin, 500, 2400); // 引脚, 最小脉宽µs, 最大脉宽µs myServo.write(90); // 回到中位 } void loop() { for (int angle = 0; angle <= 180; angle += 1) { myServo.write(angle); delay(15); } for (int angle = 180; angle >= 0; angle -= 1) { myServo.write(angle); delay(15); } }

attach函数的三个参数分别是信号引脚、最小脉宽和最大脉宽。默认值是544到2400µs，对应0°和180°。为什么我写500到2400？因为SG90的实际行程范围通常到不了2.5ms，用2400作为180°端点，在接近两端时更不容易顶死。

实测中我发现，用默认值直接write(0)和write(180)时，有些舵机会发出“咔咔”的顶齿声，那是舵机机械限位已经到了，但信号还在驱动它继续往死里顶。把脉宽范围缩小一点反而更安全，代价只是牺牲一点点角度范围，换来的是齿轮和保护。

5.2 用writeMicroseconds精确控制

如果你需要非常精确地控制某一个中间角度，或者想让舵机停在5°、10°这种位置的精细点上，靠write(angle)可能不够细，因为库内部还要做一次浮点到脉宽的转换。更直接的方法是writeMicroseconds：

myServo.writeMicroseconds(1500); // 90°位置 myServo.writeMicroseconds(1000); // 45°位置 myServo.writeMicroseconds(2000); // 135°位置

这里有个好处：你可以绕过角度整数，直接给任意脉宽，实现亚度级的位置控制。还有一个实际用途：校准舵机的中位。不同品牌舵机的90°位置对应的脉宽可能略有偏差，有的在1480µs，有的在1520µs。用一个可以微调脉宽的程序，实测找出舵机真正回中的脉宽，再把这个值作为基准，能显著提升多舵机项目的精度。

5.3 多舵机同步控制

多舵机控制有两种思路：一种是每个舵机独立attach，然后逐个write；另一种是所有舵机循环一个时间片，让它们在视觉上“同步”运动。

第一种写法的参考代码：

#include <ESP32Servo.h> Servo servo[6]; int pins[6] = {13, 12, 14, 27, 26, 25}; void setup() { for (int i = 0; i < 6; i++) { servo[i].attach(pins[i], 500, 2400); servo[i].write(90); } } void loop() { for (int a = 0; a <= 180; a += 2) { for (int i = 0; i < 6; i++) { servo[i].write(a); } delay(20); } }

注意，我在loop里不是把一个舵机从0转到180再转下一个，而是所有舵机同时逐步变化。舵机物理响应有一个时间过程，多个舵机同时收到位置更新指令时，它们在视觉上是同步开始运动的，这就是“伪同步”。

如果真要让多个舵机精确到同一时刻到达某个角度，单靠write是不够的，需要计算每个舵机的速度和加速度，让它们在同一时间窗内到达目标，这就引出下一步的平滑运动。

6. 高级应用：平滑运动、串口控制与多路扩展

6.1 用插值实现平滑运动

直接write会让舵机以最大速度“弹”到目标位置，在机械臂上看起来非常生硬，而且还容易因为惯性造成末端抖动。解决思路是中间插值：把一段行程切成很多小步，每步之间加延时，让舵机看起来是“匀速滑过去”。

void smoothMove(Servo &s, int startAngle, int endAngle, int durationMs) { int steps = 30; int delta = endAngle - startAngle; for (int i = 0; i <= steps; i++) { int angle = startAngle + delta * i / steps; s.write(angle); delay(durationMs / steps); } }

这个接口看起来简单，但实际使用有几个细节。第一是steps太少会有顿挫感，太多则舵机追不上指令，动作反而出现滞后。我实践经验是30步左右对大多数模拟舵机刚刚好。第二是durationMs的最小值有物理限制，普通模拟舵机从0°转到180°大约需要0.3到0.5秒，如果你强行把durationMs设成200ms，舵机追不上，最后还是全速冲过去。第三是这种简单线性插值没有加减速，机械臂高速启动、急停时依然会有冲击感；真正的顺滑要在起始和结束段做S曲线加减速，即速度先慢、中间快、末尾再慢。

S曲线实现也不复杂，就是在插值时不再等比例分配角度，而是按一个正弦或多项式曲线分配比例。比如用正弦函数：

float t = (float)i / steps; float eased = (1.0 - cos(t * PI)) / 2.0; int angle = startAngle + (int)(delta * eased);

这个公式的好处是起步和收尾速度都是0，中间自然加速，机械动作明显柔和很多。

6.2 串口指令控制：把舵机交给上位机

项目做大了之后，舵机不可能总在固定的循环里跑，你需要在上位机或者另一块主控上随时指定某个舵机转到某个角度。最简单的实现就是串口协议。

#include <ESP32Servo.h> Servo myServo; String input = ""; void setup() { Serial.begin(115200); myServo.attach(13, 500, 2400); } void loop() { while (Serial.available()) { char c = Serial.read(); if (c == '\n') { int angle = input.toInt(); if (angle >= 0 && angle <= 180) { myServo.write(angle); Serial.println("OK:" + String(angle)); } else { Serial.println("ERR"); } input = ""; } else { input += c; } } }

协议格式定义为：直接发整数如90，换行确认。回读OK或ERR方便上位机确认指令到达。这个协议很短，但扩展性很好：如果要控制多个舵机，可以约定成1:90表示1号舵机到90°，解析时用split处理冒号即可。

再往上走，可以用ESP32的Wi-Fi功能，把舵机控制做成一个HTTP接口或者WebSocket服务。上位机不需要连串口线，直接在浏览器里拖动滑块，远程控制机械臂。这部分本质上是把串口字符换成了网络请求，控制逻辑完全一样，但应用场景一下子就打开了。

6.3 多舵机数量扩展：PCA9685还是继续用ESP32引脚

如果舵机数量超过10个，直接占用GPIO就不太划算了，因为还要留引脚给传感器、编码器、显示屏。这种时候我倾向于用PCA9685舵机驱动板。它通过I2C接口控制16路PWM，整个板子只占ESP32的两个引脚（SDA和SCL），却能接16个舵机，扩展多块板子还能继续堆通道数。

PCA9685的接线也很简单：VCC接5V，GND共地，SDA接GPIO21，SCL接GPIO22（ESP32的默认I2C引脚）。软件上装Adafruit PWM Servo Driver库，初始化时设置频率为50Hz，然后通过setPWM(channel, 0, pulseWidth)控制对应舵机。

这里有个关键参数：PCA9685内部是12位分辨率，占空比数值范围0到4095。50Hz周期20ms，那么1ms脉宽对应的计数是4095 * 1 / 20 ≈ 205，1.5ms对应307。换算公式：

pulseCount = 脉宽(ms) * 4095 / 20

用这个库驱动舵机时，记得给PCA9685单独供电，它板载的稳压器一般是给逻辑部分用的，舵机电流还是从外部5V走。

6.4 定时器分组与自定义PWM：突破库的边界

ESP32Servo库很好用，但它隐藏了定时器分配细节。如果你需要完全掌控PWM输出，或者是想在同一块板上同时输出多种频率，可以直接使用LEDC API：

const int freq = 50; const int resolution = 16; const int channel = 0; const int pin = 13; ledcSetup(channel, freq, resolution); ledcAttachPin(pin, channel); // 0°对应脉宽0.5ms，20ms周期，duty = 2^16 * 0.5 / 20 = 1638 ledcWrite(channel, 1638); // 90°对应1.5ms脉宽，duty = 65535 * 1.5 / 20 = 4915 ledcWrite(channel, 4915);

用16位分辨率时，计数范围0到65535，50Hz下每个计数单位约0.3µs的脉宽精度，足够精细。但要注意，16位分辨率下LEDC的实际分频系数是有限制的，某些频率组合可能导致实际输出频率偏离设定值。我实测下来50Hz配16位在ESP32上工作正常，如果你需要高速PWM，把分辨率降到12位或更低反而更稳定。

这个方案适合的场景：舵机需要非标准脉宽范围、需要和别的PWM设备并行、或者需要在中断里动态改脉宽的情况。普通控制还是用ESP32Servo更省心。

7. 常见问题与排查技巧实录

7.1 舵机抖动或嗡嗡响怎么查

舵机抖动永远是供电问题排在第一位，信号问题排在第二位。先看电源：舵机供电电压是否稳定，有没有用独立电源，地线有没有共地，电源线是否太细。用万用表实时量一下舵机电源端的电压，如果动作瞬间电压掉到4.5V以下，基本就是供电不足。

排除供电后再看信号线：线是否太长、是否靠近电机或电感元件、有没有和电源线绑在一起走线。我遇到过一次舵机在某个特定角度狂抖，查了很久发现是控制线和大电流导线平行走了40cm，干扰信号了。把导线分开、加上屏蔽后解决。

还有一个容易忽略的点：PWM频率。如果你用ESP32Servo库，频率被固定在50Hz不需要管；但如果你手写了LEDC配置，频率设错比如设成500Hz，舵机就会疯狂抖动并尖锐鸣叫。检查ledcSetup里的freq参数。

7.2 舵机不动但发烫

先听声音。如果舵机通电后内部马达在较劲，发出闷闷的嗡声，说明舵机在努力往某个方向转但被卡住了。常见原因是齿轮卡死、连杆过紧、或者电源电压不够导致驱动不了。这时候立即断电，手动转动舵机摇臂看是否顺畅，排除机械卡顿。

另一种情况是信号根本没进去。用示波器或逻辑分析仪看GPIO有没有方波输出；没有示波器的话，先用Serial.print打印一下程序运行状态，确认程序确实跑到了attach和write那几行。我吃过一次亏：初始化代码写在setup里，然后loop里有个死循环跳不出来，舵机当然纹丝不动。

7.3 接上舵机ESP32就重启

这是最经典的电源坑。舵机启动瞬间的电流冲击拉低了整个系统的电压，ESP32的稳压器检测到欠压直接复位。排查方法：把舵机的电源线和ESP32分开，用独立5V电源给舵机，共地后如果问题消失，那就确认了是供电不足。

如果临时没有独立电源，有一个应急办法：在舵机电源引脚旁边加一个大电容，比如1000µF电解电容，能缓解瞬间浪涌。但这只是缓兵之计，长期跑项目一定要独立供电。

7.4 多个舵机动作互相干扰

现象是动A舵机时B舵机也跟着抖，或者两个舵机位置错乱。这大概率是定时器组冲突。前面讲过ESP32的LEDC分4组定时器，同组共享频率。如果两个舵机恰好被分配到同组定时器，而且你在程序里又手动去改了这个组里某一个通道的频率，就会把整组通道带偏。

解决办法：ESP32Servo库里有setTimerHz相关配置，或者在attach前查清楚通道和定时器分配。更省事的方法是把所有用到不同频率的PWM设备用同一组频率驱动，比如LED呼吸灯直接舍弃，或者单独用另一个LEDC定时器组、让舵机全部走某一个组。

7.5 实测排查顺序表

根据我大量排查经验，列一张速查表，按顺序检查，能省下大量时间：

这张表不一定覆盖所有情况，但能解决日常八成问题。我后来做舵机项目，都是先按表格过一遍，再决定要不要深入排查程序逻辑。

8. 一些亲测好用的工程习惯

最后聊点代码之外的东西。第一个习惯是所有舵机项目先把电源做成“可断”的，舵机电源独立开关，方便程序烧录时断开舵机电源。否则每次烧录时舵机突然回中，机械臂会猛甩一下，危险不说还容易撞坏结构件。

第二个习惯是给每路舵机定义一个逻辑编号结构体，统一管理角度范围、当前角度、目标角度。项目变大以后你会发现，所有舵机直接写死在代码里根本维护不了，用结构体数组加上统一的MoveTo接口，上层逻辑会清晰很多。

第三个习惯是API设计上尽量保留writeMicroseconds而不是只用write。角度write确实直观，但当你需要做舵机校准时，脉宽是更底层的真实控制量。我习惯在配置里保存每路舵机的脉宽零点和范围，运行时全部用脉宽控制，需要角度时再临时换算。这样换了舵机型号后只需改配置不改代码。

ESP32加舵机这个组合还有个扩展空间很大的方向：接上MPU6050陀螺仪做闭环，把舵机当成云台的执行器，姿态数据作为反馈，做一个真正意义上的稳定云台。这已经不是单纯PWM控制的问题了，而是控制算法的范畴。不过只要PWM这条线走得稳，到那个阶段也只是水到渠成的事。