我第一次用ESP32Servo库驱动SG90时场面可以用“迷惑”来形容代码读了好几遍看不出问题舵机就是不动好不容易动了一转起来就开始抽搐好像接触不良一样。后来才发现问题根本不在代码而在我把舵机直接插在了开发板的3.3V上而且信号线接的是GPIO12。从那之后我每次调舵机都先做一件事量电源电压。这篇文章就把我从选型、接线、装库到调试的完整流程翻出来哪些坑能躲就躲哪些坑躲不过也告诉你怎么处理。内容围绕ESP32Servo库和SG90接线调试展开适合刚接触ESP32和舵机、想把云台、机械臂、小车方向机跑起来的创客也适合被舵机折腾到没脾气的老朋友参考。1. 先把SG90的供电账算清楚版本、参数和电源方案1.1 买对版本位置反馈版和连续旋转版是两码事很多时候舵机“不对劲”不是接线问题而是买错了版本。SG90按功能分两大类一类是标准位置反馈舵机PWM脉宽控制角度我们做云台、机械臂时用的就是这种另一类是360度连续旋转舵机PWM脉宽控制的不是角度而是转速和方向。如果你买的是360度版本用write(90)得到的不是中位而是“静止”write(0)和write(180)分别是两个方向的全速旋转。很多人在这一环节栽跟头舵机一直在转还以为是代码写错了。所以拿到舵机先确认包装如果买散件没有包装就问卖家要文档确认是180度位置版还是360度连续版。除此之外SG90还有普通塑料齿和MG90S金属齿的差异。金属齿版本的耐用性更好尤其用在机械臂上经常受力的时候塑料齿容易扫齿。9g是指舵机本身的重量这个参数对小型机器人很关键。扭矩方面标准SG90标称扭矩大约1.8kg·cm听起来不大但用在轻型云台、小车转向机构上已经够用超过这个负载就别硬让一颗9g舵机去扛。1.2 电压、电流和瞬间峰值为什么USB供电总出问题SG90标称工作电压通常是4.8V到6V大家习惯用5V。这个看似简单实际全是坑。先看电流。舵机空载旋转时电流大约100mA到200mA这个数字容易让人低估它。真正危险的是堵转电流和启动瞬间电流堵转时电流可以冲到500mA到700mA启动瞬间的尖峰甚至更高。你想象一下一个9g的小舵机瞬间要拉接近1A的电流在电子世界里算是相当“暴力”的设备了。USB口能扛住吗电脑USB口一般能提供500mA左右手机充电器一般是1A、2A、2.1A不等。如果用电脑USB直接给开发板供电再从这个5V轨上给舵机取电舵机一转电压被瞬间拉低开发板上的3.3V稳压器也跟着“掉血”ESP32直接复位重启。表现就是舵机刚动一下板子重启代码重新跑舵机又动一下像抽风一样。这几乎是新手阶段最常遇到的问题。我建议按这个标准估算带1个SG90电源预留1A带2个预留2A带3个以上每个舵机单独走线总容量至少留50%的余量。不要按空载电流去算要按堵转和启动瞬间来算。1.3 三种供电方案怎么选先说结论不要用ESP32板载3.3V给舵机供电。SG90在3.3V下不仅有气无力还容易在工作电压边界上反复横跳板载3.3V稳压器电流余量本来就小能不给它增加负担就别加。供电方案适用场景关键注意电脑USB直接供电单个舵机轻载验证电流限制大堵转时容易掉压重启手机充电器 DC-DC降压模块1-2个舵机模块调好5V输出能力要大于1A锂电池 升压/降压模块移动项目按实际电流选模块注意波纹无论用哪种方案都要记住舵机电源的GND必须与ESP32的GND连在一起也就是“共地”。这个细节单独拿一节讲因为漏接的人太多了。2. 接线不是三根线一插就完颜色陷阱、共地与引脚禁忌2.1 三线颜色别想当然确认引脚定义最稳SG90最常见的三根线颜色是橙色信号、红色VCC、棕色GND这个“橙红棕”会刻在很多人的DNA里。问题出在市面上SG90的兼容版、山寨版太多了颜色已经完全放飞。有些是黄线信号、红线电源、黑线地有些甚至三根线颜色跟标准版完全不搭。如果你只按颜色去猜一旦插反电源线冒烟是很正常的结局。我的做法是新舵机到手后先看包装或卖家文档确认三根线的定义。正规SG90会在插头附近标注VCC、GND、Signal或者至少提供接线图。如果买的是散货没有任何标注就直接找卖家要引脚定义或者搜这个型号的接线图。不要“闭眼插”这是省不掉的步骤。2.2 共地原则没有共地就没有信号逻辑三根线里最容易漏接的是GND。许多人在面包板上接好了信号线和电源线唯独GND没有和ESP32连在一起结果舵机纹丝不动。原因其实很朴素PWM信号是一个有参考电平的方波高电平和低电平都是相对于GND而言的。如果ESP32和舵机电源各自有自己的一套地两边地电位不一致信号线的低电平在舵机看来可能变成0.7V高电平变成3.5V逻辑完全错乱。可以用一个类比理解两个人对表一人说“下午3点”但两个人拿的时区标准不一样这话就等于没说。解决办法也简单把ESP32的GND和舵机电源的GND用短线连起来。在面包板上通常就是把两个GND挂在同一根GND轨上。共地线越短越粗越稳别用一根又细又长的跳线绕半个面包板。2.3 ESP32引脚选择避开启动依赖和输入专用脚ESP32的引脚不像Arduino UNO那样随意。部分引脚在上电和烧录期间有特殊状态接舵机信号线可能导致启动失败或者烧录失败。引脚原因GPIO0上电时进入下载模式影响启动GPIO2连接板载LED上电状态特殊GPIO12MTDI引脚上电时影响Flash电压GPIO15上电状态影响调试输出GPIO36-39仅输入无PWM输出能力推荐用GPIO13、GPIO14、GPIO25、GPIO26、GPIO27这类常规IO脚。另外如果项目同时开了WiFi、蓝牙或者用了SD卡、ADC2等外设部分LEDC通道会有功能复用冲突建议在方案阶段就查一遍ESP32的引脚复用表格别等联调时再排查。3. 环境准备阶段最容易踩的两个坑开发板内核与舵机库安装3.1 为什么ESP32上不能用标准Arduino Servo库Arduino标准Servo库是为AVR系列单片机设计的它靠精确的硬件定时器中断来生成舵机PWM信号。ESP32的芯片架构完全不同Arduino内核并没有延续AVR那套定时器用法。直接#include Servo.h会出现在其他板卡上能编译、在ESP32上编译失败或者行为异常的情况。ESP32Servo库就是专门为ESP32写的替代方案底层使用的是ESP32的LEDC PWM控制器API基本兼容标准Servo库。这也是为什么很多老教程代码可以直接搬到ESP32上跑的原因。但如果你只装了标准Servo库编译时会碰到各种莫名其妙的问题。所以环境准备的核心是先把手头的库换成ESP32Servo。3.2 安装步骤与版本建议Arduino IDE 2.x的流程是这样先打开“文件”菜单里的“首选项”在“附加开发板管理器网址”里填入Espressif官方ESP32开发板的JSON地址然后到“工具-开发板-开发板管理器”里搜索esp32并安装。安装完后选择开发板型号“ESP32 Dev Module”再选串口端口。接着装舵机库。在库管理器里搜索“ESP32Servo”选择作者是Kevin Harrington的库安装。库管理器里有时候会出现ServoESP32这类同类型库它们的API稍有差异最稳妥的是直接用ESP32Servo。装完建议重启IDE再编译。版本选择上ESP32开发板内核选稳定版不用追最新RC版不然库和内核之间的兼容性容易出问题。3.3 编译报错排查思路比较常见的编译报错有三种。第一种找不到ESP32Servo.h。一般是因为库没装成功或者IDE没有重启或者当前没有选择ESP32开发板。先检查这三项。第二种提示Multiple libraries were found for Servo.h。说明电脑里同时存在标准Servo库和ESP32Servo库IDE不知道用哪个。去库管理器把标准Servo库卸载掉或者暂时移除冲突的库文件夹重新编译。第三种报错和ledcSetup、ledcAttachPin有关通常是ESP32内核版本和库版本不匹配。把内核换到稳定版或者更新到最新稳定版一般能解决。这些都是我实际编译时碰到过的都不难解决主要别一上来就怀疑代码本身。4. 代码核心逻辑周期、脉宽、角度映射和三个关键函数4.1 从PWM到角度SG90要的是20ms周期的脉冲SG90这一类模拟舵机内部靠脉冲宽度判断目标角度。它需要的PWM周期是20ms也就是50Hz频率。在这20ms里脉冲高电平的宽度决定舵机位置0度对应约0.5ms高电平90度对应约1.5ms180度对应约2.5ms。占空比看起来不高但舵机吃的是绝对脉宽不是占空比百分比。不同厂家对SG90的脉宽范围定义不一定相同有些是0.5ms到2.5ms有些是0.6ms到2.4ms。所以写代码时要保留可调上下限的能力这也是后面调试角度偏移的关键。4.2 一个可直接编译的Demo先把最基础的代码贴出来后面排错都基于它#include ESP32Servo.h Servo myServo; const int servoPin 13; void setup() { Serial.begin(115200); // 先设置频率50Hz再绑定引脚和脉宽范围 myServo.setPeriodHertz(50); myServo.attach(servoPin, 500, 2500); myServo.write(0); delay(1000); myServo.write(90); delay(1000); myServo.write(180); delay(1000); } void loop() { for (int pos 0; pos 180; pos) { myServo.write(pos); Serial.printf(Angle: %d\n, pos); delay(15); } for (int pos 180; pos 0; pos--) { myServo.write(pos); Serial.printf(Angle: %d\n, pos); delay(15); } }这段代码上电后先让舵机依次去0度、90度、180度然后循环往复摆动。如果你接好线后舵机完全没反应先不要往下改功能逻辑把这段代码跑通再说。4.3 三个核心函数逐个拆解函数作用使用场景setPeriodHertz(50)设置PWM频率为50Hz在attach之前调用attach(pin, minUs, maxUs)绑定引脚设置脉宽范围初始化时使用write(angle)按角度0-180输出日常控制writeMicroseconds(us)直接输出脉宽值调试舵机、校准范围detach()释放引脚降低功耗、断开保持力writeMicroseconds(1500)是万能的“测试动作”。1.5ms脉宽对应中位只要舵机能回到中位并保持力矩说明信号链路基本正常。如果你直接调角度不灵先试这个函数能把问题范围瞬间缩小。4.4 让舵机“开口说话”串口打印角度与交互测试排错时需要知道舵机的目标值到底是多少。上面示例代码已经打印Angle打开串口监视器波特率115200就能看到舵机每一帧的目标角度。用IDE自带的串口监视器或者你习惯的串口调试助手都行。更实用的做法是做个串口交互测试。把loop里换成下面这段然后往串口发送0到180之间的数字舵机就会转到对应角度void loop() { if (Serial.available()) { int angle Serial.parseInt(); if (angle 0 angle 180) { myServo.write(angle); Serial.printf(move to %d\n, angle); } } }这个交互逻辑在我调云台限位时帮了大忙。不用反复改代码重新烧录直接在串口里发数字就能观察舵机动作。5. 调试排错的标准链路不动、抖动、角度漂移按顺序查5.1 舵机完全不动五步检查法遇到舵机完全没反应我通常按这个顺序查不跳步。第一步量电压。用万用表直接量舵机红黑线两端不是量电源模块输出。因为导线本身有电阻重载时候舵机端可能已经掉到4.5V以下而模块端显示还是5V。第二步查共地。确认ESP32的GND和舵机电源的GND之间有导线连接。面包板上最好用同一根GND轨避免两根GND跳线中间还有别的元件。第三步查信号线。确认代码里写的引脚和实际插入的引脚一致没插到GPIO36到GPIO39这类输入专用脚上。第四步用writeMicroseconds(1500)写一个最小测试程序让舵机回中并保持力矩。如果这一步过了说明信号链路基本正常问题可能在角度映射范围上。第五步用手轻轻转动舵机臂。如果能轻转但无保持力可能是信号没进去或者舵机控制板损坏如果完全卡死可能是机械卡死或齿轮损坏。这个顺序能覆盖绝大多数“不动”的情况其中前两步暴露问题最多。5.2 持续抖动和乱转先怀疑供电再查信号舵机抖动和乱转常见原因是供电问题。舵机一转电压被拉低ESP32复位代码重新初始化如果舵机电源和ESP32共用一路不稳定的5V这个循环会一直继续。表现就是舵机抖两下、停一下、又抖两下整个板子像在“重启循环”。解决方法是给舵机独立供电GND共地必要时在电源端并联一个大电容。这里分享一个没有示波器也能验证的土办法把舵机信号线拔掉直接量舵机电源电压然后在舵机空载动作时看电压跌到多少。如果跌破4.5V电源一定有问题别急着改代码。如果供电稳定还抖动再看信号线是否太长、太靠近电机线等干扰源。超过20cm的信号线建议用双绞线或者把信号线单独走不要跟舵机电源线、电机驱动线绑在一起。5.3 角度偏移和“对不准”脉宽校准与舵盘零位调整角度不准分两种情况。第一种是整体偏移。比如write(90)实际转到85度这种情况用writeMicroseconds扫描脉宽。从500us到2500us每次步进10us观察舵机臂实际到达的极限位置记录机械真正0度对应的脉宽值以及真正180度对应的脉宽值然后把这两个值填到attach函数的min和max参数里。第二种是零位不对。舵机回中后舵机臂还是歪的这是安装问题。把舵机臂拆下来在舵机回到中位后再重新装上让舵机臂与输出轴的键位对齐。不要靠代码硬纠偏否则到极限位置时很容易顶到机械限位轻则发烫重则扫齿。我曾经在一台机械臂上遇到过“90度总是差3度”的情况最后发现是装舵盘时没对准不是代码问题。这类问题用代码去修越修越乱。5.4 上电抽搐和高频蜂鸣到底是不是故障上电瞬间ESP32的引脚还没初始化舵机会咔哒响一下这是正常的。如果你设计的产品不能接受这个瞬间动作可以让舵机供电晚于ESP32启动或者加一个MOS管开关电路。持续的高频滋滋声是模拟舵机在维持位置时的正常锁定声只要声音不大、不发热就没事。但如果声音很响、舵机发烫、电流偏大多半是卡住或负载超限要赶紧断电检查不然会烧掉电机或齿轮。6. 多舵机和稳定性的进阶细节通道分配、滤波电容与调试习惯6.1 多舵机并联通道分配和总电流ESP32Servo库基于LEDC支持多个舵机。我做云台时两个舵机分别接GPIO13和GPIO14代码里定义两个Servo对象分别attach即可。ESP32的LEDC通道足够常规使用库也会自动分配通道不需要手动管理通道编号。但要注意总电流。两个SG90同时动作、带负载瞬时电流轻松超过1A。如果是三个以上建议每个舵机的电源线在舵机端就近并联一个小电容电源主线适当加粗GND线尽量粗短避免地线成为整个系统的瓶颈。多舵机还有一个容易忽略的地方初始化顺序。先初始化不受力或行程中位的舵机再初始化会顶到机械结构的舵机能减少上电瞬间的机械冲击。6.2 电源端滤波电容的参数与连接位置并联电容是解决舵机抖动的物理手段之一。电解电容选100uF到1000uF再并一个0.1uF陶瓷电容放在舵机电源端。电解电容正极接VCC负极接GND接反会爆浆容量越大越要注意极性。为什么要这样放舵机动态电流变化非常快电源线本身的电感会造成瞬时掉电。电容相当于一个蓄水池先顶住尖峰。如果用的是DC-DC降压模块模块输出端也可以加同样的电容组合。这个操作对USB供电的场景改善尤其明显。6.3 从能转到能用我每次调试舵机时遵守的顺序先固定硬件再调软件先保证供电再怀疑代码。我实际调试的顺序一般是这样第一步检查舵机电源电压和共地第二步用一个最简单的回中程序也就是writeMicroseconds(1500)验证舵机本身第三步才开始写角度逻辑第四步全程用串口打印目标角度配合串口调试助手对比实际现象。每次只改一个变量要么改电源要么改代码别同时改两样否则出了问题根本定位不到。最后再分享一个小习惯接电之前先把舵机输出轴轻轻转到中位附近防止上电瞬间从初始脉宽猛甩到另一个位置撞到机械限位。这个习惯帮我省了好几颗舵机。