如果你在某个深夜把刚买的 SG90 插上 ESP32满怀期待地在代码里写了一个angle 90却发现舵机要么纹丝不动、要么像抽风一样抖个不停那么恭喜你你撞上了大多数舵机入门者都会遇到的第一堵墙。这篇文章不打算从“什么是舵机”这种教科书定义开始讲而是直接站在你面前说ESP32 舵机控制的难点从来不在代码而在供电、信号和机械这三个容易被忽略的环节。这篇攻略会从 PWM 底层原理讲到 LEDC 输出再讲到多舵机协同、平滑运动、蓝牙和 Web 无线控制最后把我实测中踩过的坑和排查思路一并交代清楚。不管你是第一次摸舵机还是已经会转但想做得更顺滑都可以在这篇里找到能直接落地的内容。1. 舵机控制的底层原理为什么脉冲宽度能决定转动角度1.1 舵机内部到底有什么电机、齿轮和电位器的三角关系要理解舵机控制先得知道它的内部构造。你别看舵机外壳严严实实其实拆开之后就是三样核心东西一个直流电机、一套减速齿轮、一个反馈电位器外加一块很小的控制板。直流电机负责产生旋转力但转速快、扭矩小所以要通过齿轮组减速把力量放大。电位器装在输出轴上它的电阻值会随着输出轴的角度变化而变化相当于舵机在时刻汇报“我现在转到哪了”。控制板做的事情很简单读入 PWM 信号里的脉宽算出“目标位置”再读电位器知道“当前位置”两者不一致就驱动电机转一直转到两者相等为止。这个“目标位置 vs 当前位置”的比较过程其实就是舵机的核心闭环逻辑。很多人以为舵机收到信号就会直接跳过去实际上它是一个不断调整的跟踪过程这也是为什么供电不足时舵机会发抖——电压不够控制板都开始“算不清”了。1.2 50Hz 与 0.5ms—2.5msPWM 信号的关键参数舵机最常用的控制信号是 50Hz 的 PWM也就是周期 20ms 的方波。每个周期里高电平持续的时间叫脉宽舵机真正读的就是这个脉宽。标准舵机的角度与脉宽对应关系大致是这样角度脉宽占空比20ms 周期0°0.5ms2.5%90°1.5ms7.5%180°2.5ms12.5%也就是说角度从 0° 到 180°脉宽从 0.5ms 线性增长到 2.5ms。中间每增加 1°脉宽大约增加 11.1 微秒。你算出期望脉宽然后让单片机产生对应的 PWM 波舵机就会转到对应角度。有些读者会问频率一定得是 50Hz 吗常规舵机必须接近 50Hz也就是周期 20ms 左右因为内部电路是按这个周期设计的。你给个 200Hz 甚至更高很多舵机要么不动要么疯转。当然现在也有数字舵机支持更宽的频率范围但保险起见默认 50Hz 依然是所有舵机都能接受的公共选项。1.3 一个生活化类比舵机像一台“带游标的天平”为了把上面这套机制说透我常用一个天平类比。把脉宽想象成你要称的目标重量电位器反馈就是游标当前的位置。控制板做的事情就是不断掂量“目标重量 250g游标现在才 120g不够电机往重的一边推。”推过头了再反向微调最终稳定在目标值。这个类比还能解释很多现象如果电源电压不稳相当于你手里的砝码重量忽大忽小天平自然来回摆动、无法平衡如果信号线上的脉宽在抖动相当于目标重量在快速变化舵机就会像抽风一样来回转。理解了这一层后面排查问题会轻松很多。2. 正式开工前的准备舵机选型、供电与接线2.1 常见舵机怎么选型号、扭矩与电流市面上最常见的是 SG90 和 MG996R 这两类我先说说它们的核心差异。SG90 是 9g 的小塑料齿轮舵机扭矩约 1.8kg·cm工作电压 4.8V—6V空载电流约 100mA堵转电流能到 700mA 左右。它适合轻型云台、小机械臂关节、玩具车转向不适合承受较大外力。MG996R 是 55g 的金属齿轮舵机扭矩可以到 10kg·cm 以上堵转电流在 6V 供电下能到 2.5A。它适合做机器人腿、重型云台但耗电和发热都明显更高。另外还有一种连续旋转舵机360° 舵机它内部取消了电位器反馈PWM 不再控制角度而是控制转速和方向。这种舵机适合做小车驱动不能用来精确控制关节角度。选型时不光看扭矩还要看电流和电压。我的建议是新手先拿 SG90 学透控制逻辑再做承载类结构时换 MG996R 或更高扭矩的舵机。别一上来就买大扭矩舵机配开发板供电那基本必挂。2.2 供电问题为什么舵机不能直接吃开发板的电这是整个 ESP32 舵机攻略里我最想强调的一点。很多人的舵机抖动、复位、不受控根因都是供电。ESP32 开发板上的 5V 引脚是从 USB 进去的 5V 直接引出来的能提供的电流非常有限通常只有 500mA 左右。一个 SG90 空载时 100mA 看着还行但稍微一受力电流就上去了如果是两个、三个舵机同时动作瞬间电流很容易超过开发板能承受的范围。电压一被拉低ESP32 自身都可能重启更别说舵机了。正确的做法是给舵机单独供电。SG90 这类小舵机可以用一个 5V、至少 1A 的电源我一般用 2A 的 USB 电源MG996R 这些大舵机建议 6V、5A 以上或者直接用 2S 锂电池加稳压模块。关键是“共地”外部电源的 GND 必须和 ESP32 的 GND 接在一起。舵机信号线是从 ESP32 输出的电压参考必须与舵机电源一致不共地的话信号根本没有参考电平舵机完全无法正常工作。我在接线时的习惯顺序是先接电源正负再接 GND 共地最后才插信号线。2.3 接线细节与电气注意事项信号线的接法舵机信号线通常白色或黄色接 ESP32 的一个 GPIO比如 GPIO13。SG90 的电源线是红色接外部电源正极棕色线是 GND接外部电源负极同时与 ESP32 GND 相连。有几个细节需要提醒信号线长度不要超过 30cm长了容易引入干扰尤其旁边走电机电源线时抖动概率急剧上升。如果舵机功率大在舵机电源两端并联一个 470uF 电解电容可以吸收电机启动瞬间的电流尖峰很多抖动问题靠这个电容就能解决。上电时舵机会自动“冲”到一个默认位置通常是 0° 或 90°所以机械结构设计时要留出余量别让它一上电就撞限位。3. 第一行代码ESP32 的 LEDC 输出 PWM 驱动舵机3.1 为什么不能用 analogWriteESP32 的 PWM 机制如果之前玩过 Arduino UNO你可能习惯用analogWrite(pin, 128)输出所谓的“PWM”。但 ESP32 的 Arduino 内核里没有像 UNO 那样直接支持舵机需求的 analogWrite因为 ESP32 的硬件 PWM 结构完全不同。ESP32 承接着名为 LEDC 的外设专门用来生成 PWM 波形。它提供多个独立通道每个通道可绑定到不同的 GPIO频率和分辨率都能独立配置远比 AVR 芯片的 PWM 灵活。你要做的其实是三件事ledcSetup配置频率与分辨率ledcAttachPin把引脚绑定到通道ledcWrite写入占空比数值。好处是灵活代价是你得理解通道、频率、分辨率这几个概念。正因如此社区里大多数舵机项目会直接选用封装好的ESP32Servo库让你像写 Arduino 一样写servo.write(angle)。我建议两步走先用库跑通再手写 LEDC 理解底层这样以后遇到问题才有的放矢。3.2 最小可用代码用 ESP32Servo 库快速跑通安装 ESP32Servo 库Arduino 库管理器里直接搜就行然后写这样一段最小代码#include ESP32Servo.h Servo myServo; void setup() { myServo.attach(13, 500, 2500); // GPIO13脉宽范围 500us ~ 2500us } void loop() { myServo.write(0); delay(1000); myServo.write(90); delay(1000); myServo.write(180); delay(1000); }attach的第二个和第三个参数是脉宽上下限单位是微秒。500 对应 0.5ms2500 对应 2.5ms。如果你用的是标准舵机这样写没有问题如果用的是某些国产舵机实际脉宽范围可能窄一些需要在后面校准。把这段代码烧进去你应该能看到舵机先转到 0°停顿一秒转到 90°再停一秒然后 180°。如果出现抖动或不转先别怀疑代码大概率是供电问题回看第 2.2 节。3.3 手动用 LEDC 实现角度到脉宽的映射如果你想知道库背后到底做了什么可以自己用 LEDC 写一个。因为舵机需要 50Hz 的 PWM而 50Hz 的周期是 20ms配合 16 位分辨率0—65535可以这样推导占空比 脉宽 / 20msledcWrite的数值 占空比 × 65535于是 0.5ms 对应0.5 / 20 × 65535 ≈ 16381.5ms 对应约 49152.5ms 对应约 8192。写一个映射函数#define PWM_CH 0 #define PWM_FREQ 50 #define PWM_RES 16 #define PWM_PIN 13 int angleToPulse(int angle) { // 角度 0~180 映射到脉宽 1638~8192 return map(angle, 0, 180, 1638, 8192); } void setup() { ledcSetup(PWM_CH, PWM_FREQ, PWM_RES); ledcAttachPin(PWM_PIN, PWM_CH); } void loop() { ledcWrite(PWM_CH, angleToPulse(0)); delay(1000); ledcWrite(PWM_CH, angleToPulse(90)); delay(1000); ledcWrite(PWM_CH, angleToPulse(180)); delay(1000); }关键点在于map只是线性插值如果你的舵机实际范围不是标准的 0.5—2.5ms就需要调整上下边界。64、80 这类脉宽略偏的舵机用标准映射会转不到极限角度这就是校准的意义。3.4 关于校准国产舵机的脉宽范围并不标准我实测过好几个不同品牌的 SG90标称 0° 到 180°但有的 0° 其实对应 0.7ms有的 180° 只到 2.3ms。如果你发现舵机转不到标称角度或者在中点抖个不停很可能是脉宽上限超过舵机极限了。校准步骤很简单先把attach的脉宽范围放开到 500—2500写一个测试程序每隔一秒write(angle)用串口打印当前角度看舵机的实际表现。如果 0° 时嗡嗡响或已经撞限位就把下界往上调比如 600如果 180° 时声音很大就把上界往下调比如 2400。把这个范围记下来写进attach参数舵机就会乖很多。4. 进阶能力多舵机协同、平滑运动与角度反馈4.1 多舵机同时控制通道分配与资源规划一个机械臂或者六足机器人动辄五六只舵机ESP32 能不能扛住能。LEDC 有 16 个通道每路舵机虽然需要独立通道但可以共用同一个频率设置因此通道占用的成本不高。不过有几个 GPIO 规划上的坑要提前避开GPIO34—GPIO39 是纯输入引脚不能输出 PWM不适合接舵机信号线。ESP32 的 ADC2 通道与 WiFi 模块共用硬件一旦开启 WiFiADC2 的模拟读取会失效。涉及到无线控制的场景模拟传感器尽量挂在 ADC1 通道GPIO32—GPIO39。多个舵机同时动作时瞬间电流是叠加的电源余量要留 50% 以上。四五个 MG996R 一起启动时瞬间电流十安培都不奇怪这时候老老实实用大电源否则任何软件优化都白搭。我用多舵机项目时会先画一个 GPIO 分配表把每个舵机用途、引脚、通道都列出来再动工接线。看起来很麻烦但能少踩好几小时的坑。4.2 平滑运动的三种实现步进、线性插值与缓动曲线默认的write(angle)是直接告诉舵机目标角度舵机会以最快速度冲过去机械冲击很大而且动作显得很生硬。做云台和机械臂时我们通常希望运动平滑。第一种方法是步进逼近每次只转一小段角度加一点延时。这是最土但最不容易出错的方式。for (int ang current; ang target; ang 1) { myServo.write(ang); delay(10); }第二种是线性插值设定运动总时长按时间比例计算当前角度。好处是速度均匀且用millis()做时间基准不阻塞主循环。int startAng 0; int endAng 180; unsigned long duration 2000; unsigned long t0 millis(); while (millis() - t0 duration) { float t (float)(millis() - t0) / duration; int angle startAng (int)((endAng - startAng) * t); myServo.write(angle); delay(10); }第三种是缓动曲线。上面的线性插值虽然匀速但起点和终点瞬间的速度突变仍会造成冲击。把 t 做一次 smoothstep 变换t t * t * (3 - 2 * t)就能让舵机先加速后减速启停都非常柔和。这个方法在云台追拍场景下效果立竿见影。4.3 角度反馈与闭环控制思路普通三线舵机没有角度反馈你让它转 90°它到底转没转到你并不知道。如果被外力掰动它也不会自己纠正。要获得真实角度至少有三条路在关节处外接电位器或磁编码器把读数接到 ESP32 的 ADC 或 I2C。换用带反馈引脚的总线舵机比如一些串行舵机可以通过协议直接读角度。像自稳云台那样用 MPU6050 这类姿态传感器做整体闭环舵机只当执行器。我做过一个简单的云台闭环读电位器反馈角度计算与目标角度的误差用比例控制调 PWM 脉宽。代码本身不复杂核心是那几行int feedback analogRead(36); // 读 ADC1避免和 WiFi 冲突 int error targetFeedback - feedback; float kp 0.3; int adjust error * kp; myServo.write(baseAngle adjust);注意调节kp时过大会来回震荡过小会响应迟钝。实际调参时可以先用串口打印误差曲线大致观察后定一个初始值再手工微调。5. 高级玩法无线遥控与 Web 调参5.1 手机蓝牙控制舵机20 行代码ESP32 自带经典蓝牙用 Arduino 自带的BluetoothSerial库可以很轻松做一个手机蓝牙串口控制。我用手机上的蓝牙串口调试 App 发数字舵机就跟着转非常适合快速验证机械结构。#include BluetoothSerial.h #include ESP32Servo.h BluetoothSerial SerialBT; Servo myServo; void setup() { SerialBT.begin(ESP32Servo); // 蓝牙名称 myServo.attach(13, 500, 2500); } void loop() { if (SerialBT.available()) { int angle SerialBT.parseInt(); if (angle 0 angle 180) { myServo.write(angle); } } }蓝牙方案的迟延会有一点一般几十毫秒手感和线控有明显差距。如果做实时性要求高的遥控机器人建议用 ESP-NOW它不依赖路由器设备间直连延迟更低。5.2 浏览器滑块控制基于 Web 的调参页面ESP32 的 WiFi 功能很适合做一个 Web 控制页电脑或手机浏览器打开页面拖动滑块舵机角度实时变化。这种方式比蓝牙更通用也方便别人上手使用。核心思路是ESP32 开启一个 WebServer前端页面用input typerange做滑块滑块变化时通过 HTTP 请求把角度告诉 ESP32。一个简化思路如下#include WiFi.h #include WebServer.h WebServer server(80); void handleAngle() { if (server.hasArg(angle)) { int angle server.arg(angle).toInt(); myServo.write(angle); } server.send(200, text/plain, OK); } void setup() { myServo.attach(13, 500, 2500); WiFi.begin(your_ssid, your_password); while (WiFi.status() ! WL_CONNECTED) delay(500); server.on(/set, handleAngle); server.begin(); } void loop() { server.handleClient(); }前端部分你可以把 HTML 以字符串形式挂在某个路由上或者用外部工具生成一个带滑块的页面滑块变化时访问/set?angle90。实测下来这种单次请求的方式在滑块连续拖动时会有一定延迟做简单遥控足够但想做平滑跟手还是得上 WebSocket。用 WebSocket 把滑块位置直接推给 ESP32刷新率可以到 30Hz 以上体感顺滑很多。5.3 从遥控到自主决策传感器联动的应用脚本无线控制很好玩但舵机真正的高级应用是跟传感器联动实现自主决策。举个例子一个自动浇花装置用一个土壤湿度传感器读数据当湿度低于阈值时舵机带动阀门打开浇够一分钟再关掉。这里的舵机只是一个执行器核心逻辑是传感器阈值判断和动作调度。再比如一个光控云台用两个光敏电阻判断光源方向舵机带动云台转向光源模拟向日葵的追光效果。这个项目用到两个 ADC 输入、两个舵机通道和一个简单的比例控制正好把所有前面讲的技术点串在一起。我强烈建议新手从这种“传感器 舵机”的小项目开始做比单纯转舵机更能体会到嵌入式系统设计的乐趣。6. 实测中的问题排查与经验沉淀6.1 舵机抖动、发热与不转的常见原因速查表我在调试舵机时遇到最多的几类问题归纳成一张速查表遇到异常直接对着查现象最可能原因快速验证与解决办法上电后不断抖动供电不足电压跌落换大电流电源舵机电源端并联 470uF 电容转不到 180°脉宽上限过低或舵机实际范围窄确认attach脉宽范围放宽到 500—2500 再测试转动时发热堵转或持续处于大电流状态检查机械卡点确认舵机是否被外力堵住完全不动信号线接错、GND 未共地用万用表测信号线电压确认共地方向反了舵机型号不同脉宽映射方向不一致映射时把脉宽上下限互换偶发抽搐信号线太长或靠近动力线干扰缩短信号线避免与电源线平行走线这张表不能解决所有问题但能覆盖九成的新手故障。最高频的永远是供电其次是接地然后是脉宽范围按这三个顺序排查是对的。6.2 一次完整排查案例为什么舵机上电后反复回中我见过最容易让人迷惑的一个现象是舵机上电后明明代码里写了转 90°但它先转到 0°顿一下再回到 90°如此反复。很多人以为是代码逻辑问题其实这是供电不足的典型表现。过程是这样的舵机上电时 ESP32 先复位舵机自动回到初始位置0°然后 ESP32 启动完成开始执行write(90)舵机开始向 90° 转动。如果这时候电源电压被拉低到 ESP32 的复位阈值以下ESP32 会立即重启。重启之后又回到“上电复位”状态舵机回到 0°然后代码又开始跑又转 90°形成无限循环。我在排查这类问题时第一步不是看代码而是用万用表量舵机电源端的电压。如果转动的瞬间电压从 5V 掉到 4V 以下那答案已经出来了换电源加电容问题立刻消失。这个案例也解释了为什么很多人一开始会怀疑是代码 bug结果怎么改都没用。6.3 几个值得长期记住的实操要点最后沉淀几条我自己的实操经验对长期做舵机项目很关键舵机上电默认动作不可控设计机械结构时一定要预留角度余量避免上电瞬间撞限位。信号线上串一个 100Ω—1kΩ 电阻再进舵机可以在舵机内部故障时保住 GPIO。大舵机不要长时间堵转保持超过几秒就会过热金属齿舵机也不例外。多舵机项目把代码里的频率统一设置在 50Hz不要给不同舵机设置不同频率否则部分舵机收不到有效信号。测试舵机时打开串口监视器输入角度值手动控制比每次改代码重新烧写高效得多。我在实际开发中一直保留一个“舵机测试台”一块面包板、一个 5V 2A 电源、一个 470uF 电容、几根杜邦线任何新舵机拿回来先上测试台跑一遍校准好脉宽范围再接入正式项目。这个习惯帮我省掉了大量后续排查时间也建议你养成。 
长河君 · 2026/10/11 1:06:13 · 阅读 1.2k ESP32舵机控制全攻略：从PWM原理到抖动排查与无线控制
如果你在某个深夜把刚买的 SG90 插上 ESP32满怀期待地在代码里写了一个angle 90却发现舵机要么纹丝不动、要么像抽风一样抖个不停那么恭喜你你撞上了大多数舵机入门者都会遇到的第一堵墙。这篇文章不打算从“什么是舵机”这种教科书定义开始讲而是直接站在你面前说ESP32 舵机控制的难点从来不在代码而在供电、信号和机械这三个容易被忽略的环节。这篇攻略会从 PWM 底层原理讲到 LEDC 输出再讲到多舵机协同、平滑运动、蓝牙和 Web 无线控制最后把我实测中踩过的坑和排查思路一并交代清楚。不管你是第一次摸舵机还是已经会转但想做得更顺滑都可以在这篇里找到能直接落地的内容。1. 舵机控制的底层原理为什么脉冲宽度能决定转动角度1.1 舵机内部到底有什么电机、齿轮和电位器的三角关系要理解舵机控制先得知道它的内部构造。你别看舵机外壳严严实实其实拆开之后就是三样核心东西一个直流电机、一套减速齿轮、一个反馈电位器外加一块很小的控制板。直流电机负责产生旋转力但转速快、扭矩小所以要通过齿轮组减速把力量放大。电位器装在输出轴上它的电阻值会随着输出轴的角度变化而变化相当于舵机在时刻汇报“我现在转到哪了”。控制板做的事情很简单读入 PWM 信号里的脉宽算出“目标位置”再读电位器知道“当前位置”两者不一致就驱动电机转一直转到两者相等为止。这个“目标位置 vs 当前位置”的比较过程其实就是舵机的核心闭环逻辑。很多人以为舵机收到信号就会直接跳过去实际上它是一个不断调整的跟踪过程这也是为什么供电不足时舵机会发抖——电压不够控制板都开始“算不清”了。1.2 50Hz 与 0.5ms—2.5msPWM 信号的关键参数舵机最常用的控制信号是 50Hz 的 PWM也就是周期 20ms 的方波。每个周期里高电平持续的时间叫脉宽舵机真正读的就是这个脉宽。标准舵机的角度与脉宽对应关系大致是这样角度脉宽占空比20ms 周期0°0.5ms2.5%90°1.5ms7.5%180°2.5ms12.5%也就是说角度从 0° 到 180°脉宽从 0.5ms 线性增长到 2.5ms。中间每增加 1°脉宽大约增加 11.1 微秒。你算出期望脉宽然后让单片机产生对应的 PWM 波舵机就会转到对应角度。有些读者会问频率一定得是 50Hz 吗常规舵机必须接近 50Hz也就是周期 20ms 左右因为内部电路是按这个周期设计的。你给个 200Hz 甚至更高很多舵机要么不动要么疯转。当然现在也有数字舵机支持更宽的频率范围但保险起见默认 50Hz 依然是所有舵机都能接受的公共选项。1.3 一个生活化类比舵机像一台“带游标的天平”为了把上面这套机制说透我常用一个天平类比。把脉宽想象成你要称的目标重量电位器反馈就是游标当前的位置。控制板做的事情就是不断掂量“目标重量 250g游标现在才 120g不够电机往重的一边推。”推过头了再反向微调最终稳定在目标值。这个类比还能解释很多现象如果电源电压不稳相当于你手里的砝码重量忽大忽小天平自然来回摆动、无法平衡如果信号线上的脉宽在抖动相当于目标重量在快速变化舵机就会像抽风一样来回转。理解了这一层后面排查问题会轻松很多。2. 正式开工前的准备舵机选型、供电与接线2.1 常见舵机怎么选型号、扭矩与电流市面上最常见的是 SG90 和 MG996R 这两类我先说说它们的核心差异。SG90 是 9g 的小塑料齿轮舵机扭矩约 1.8kg·cm工作电压 4.8V—6V空载电流约 100mA堵转电流能到 700mA 左右。它适合轻型云台、小机械臂关节、玩具车转向不适合承受较大外力。MG996R 是 55g 的金属齿轮舵机扭矩可以到 10kg·cm 以上堵转电流在 6V 供电下能到 2.5A。它适合做机器人腿、重型云台但耗电和发热都明显更高。另外还有一种连续旋转舵机360° 舵机它内部取消了电位器反馈PWM 不再控制角度而是控制转速和方向。这种舵机适合做小车驱动不能用来精确控制关节角度。选型时不光看扭矩还要看电流和电压。我的建议是新手先拿 SG90 学透控制逻辑再做承载类结构时换 MG996R 或更高扭矩的舵机。别一上来就买大扭矩舵机配开发板供电那基本必挂。2.2 供电问题为什么舵机不能直接吃开发板的电这是整个 ESP32 舵机攻略里我最想强调的一点。很多人的舵机抖动、复位、不受控根因都是供电。ESP32 开发板上的 5V 引脚是从 USB 进去的 5V 直接引出来的能提供的电流非常有限通常只有 500mA 左右。一个 SG90 空载时 100mA 看着还行但稍微一受力电流就上去了如果是两个、三个舵机同时动作瞬间电流很容易超过开发板能承受的范围。电压一被拉低ESP32 自身都可能重启更别说舵机了。正确的做法是给舵机单独供电。SG90 这类小舵机可以用一个 5V、至少 1A 的电源我一般用 2A 的 USB 电源MG996R 这些大舵机建议 6V、5A 以上或者直接用 2S 锂电池加稳压模块。关键是“共地”外部电源的 GND 必须和 ESP32 的 GND 接在一起。舵机信号线是从 ESP32 输出的电压参考必须与舵机电源一致不共地的话信号根本没有参考电平舵机完全无法正常工作。我在接线时的习惯顺序是先接电源正负再接 GND 共地最后才插信号线。2.3 接线细节与电气注意事项信号线的接法舵机信号线通常白色或黄色接 ESP32 的一个 GPIO比如 GPIO13。SG90 的电源线是红色接外部电源正极棕色线是 GND接外部电源负极同时与 ESP32 GND 相连。有几个细节需要提醒信号线长度不要超过 30cm长了容易引入干扰尤其旁边走电机电源线时抖动概率急剧上升。如果舵机功率大在舵机电源两端并联一个 470uF 电解电容可以吸收电机启动瞬间的电流尖峰很多抖动问题靠这个电容就能解决。上电时舵机会自动“冲”到一个默认位置通常是 0° 或 90°所以机械结构设计时要留出余量别让它一上电就撞限位。3. 第一行代码ESP32 的 LEDC 输出 PWM 驱动舵机3.1 为什么不能用 analogWriteESP32 的 PWM 机制如果之前玩过 Arduino UNO你可能习惯用analogWrite(pin, 128)输出所谓的“PWM”。但 ESP32 的 Arduino 内核里没有像 UNO 那样直接支持舵机需求的 analogWrite因为 ESP32 的硬件 PWM 结构完全不同。ESP32 承接着名为 LEDC 的外设专门用来生成 PWM 波形。它提供多个独立通道每个通道可绑定到不同的 GPIO频率和分辨率都能独立配置远比 AVR 芯片的 PWM 灵活。你要做的其实是三件事ledcSetup配置频率与分辨率ledcAttachPin把引脚绑定到通道ledcWrite写入占空比数值。好处是灵活代价是你得理解通道、频率、分辨率这几个概念。正因如此社区里大多数舵机项目会直接选用封装好的ESP32Servo库让你像写 Arduino 一样写servo.write(angle)。我建议两步走先用库跑通再手写 LEDC 理解底层这样以后遇到问题才有的放矢。3.2 最小可用代码用 ESP32Servo 库快速跑通安装 ESP32Servo 库Arduino 库管理器里直接搜就行然后写这样一段最小代码#include ESP32Servo.h Servo myServo; void setup() { myServo.attach(13, 500, 2500); // GPIO13脉宽范围 500us ~ 2500us } void loop() { myServo.write(0); delay(1000); myServo.write(90); delay(1000); myServo.write(180); delay(1000); }attach的第二个和第三个参数是脉宽上下限单位是微秒。500 对应 0.5ms2500 对应 2.5ms。如果你用的是标准舵机这样写没有问题如果用的是某些国产舵机实际脉宽范围可能窄一些需要在后面校准。把这段代码烧进去你应该能看到舵机先转到 0°停顿一秒转到 90°再停一秒然后 180°。如果出现抖动或不转先别怀疑代码大概率是供电问题回看第 2.2 节。3.3 手动用 LEDC 实现角度到脉宽的映射如果你想知道库背后到底做了什么可以自己用 LEDC 写一个。因为舵机需要 50Hz 的 PWM而 50Hz 的周期是 20ms配合 16 位分辨率0—65535可以这样推导占空比 脉宽 / 20msledcWrite的数值 占空比 × 65535于是 0.5ms 对应0.5 / 20 × 65535 ≈ 16381.5ms 对应约 49152.5ms 对应约 8192。写一个映射函数#define PWM_CH 0 #define PWM_FREQ 50 #define PWM_RES 16 #define PWM_PIN 13 int angleToPulse(int angle) { // 角度 0~180 映射到脉宽 1638~8192 return map(angle, 0, 180, 1638, 8192); } void setup() { ledcSetup(PWM_CH, PWM_FREQ, PWM_RES); ledcAttachPin(PWM_PIN, PWM_CH); } void loop() { ledcWrite(PWM_CH, angleToPulse(0)); delay(1000); ledcWrite(PWM_CH, angleToPulse(90)); delay(1000); ledcWrite(PWM_CH, angleToPulse(180)); delay(1000); }关键点在于map只是线性插值如果你的舵机实际范围不是标准的 0.5—2.5ms就需要调整上下边界。64、80 这类脉宽略偏的舵机用标准映射会转不到极限角度这就是校准的意义。3.4 关于校准国产舵机的脉宽范围并不标准我实测过好几个不同品牌的 SG90标称 0° 到 180°但有的 0° 其实对应 0.7ms有的 180° 只到 2.3ms。如果你发现舵机转不到标称角度或者在中点抖个不停很可能是脉宽上限超过舵机极限了。校准步骤很简单先把attach的脉宽范围放开到 500—2500写一个测试程序每隔一秒write(angle)用串口打印当前角度看舵机的实际表现。如果 0° 时嗡嗡响或已经撞限位就把下界往上调比如 600如果 180° 时声音很大就把上界往下调比如 2400。把这个范围记下来写进attach参数舵机就会乖很多。4. 进阶能力多舵机协同、平滑运动与角度反馈4.1 多舵机同时控制通道分配与资源规划一个机械臂或者六足机器人动辄五六只舵机ESP32 能不能扛住能。LEDC 有 16 个通道每路舵机虽然需要独立通道但可以共用同一个频率设置因此通道占用的成本不高。不过有几个 GPIO 规划上的坑要提前避开GPIO34—GPIO39 是纯输入引脚不能输出 PWM不适合接舵机信号线。ESP32 的 ADC2 通道与 WiFi 模块共用硬件一旦开启 WiFiADC2 的模拟读取会失效。涉及到无线控制的场景模拟传感器尽量挂在 ADC1 通道GPIO32—GPIO39。多个舵机同时动作时瞬间电流是叠加的电源余量要留 50% 以上。四五个 MG996R 一起启动时瞬间电流十安培都不奇怪这时候老老实实用大电源否则任何软件优化都白搭。我用多舵机项目时会先画一个 GPIO 分配表把每个舵机用途、引脚、通道都列出来再动工接线。看起来很麻烦但能少踩好几小时的坑。4.2 平滑运动的三种实现步进、线性插值与缓动曲线默认的write(angle)是直接告诉舵机目标角度舵机会以最快速度冲过去机械冲击很大而且动作显得很生硬。做云台和机械臂时我们通常希望运动平滑。第一种方法是步进逼近每次只转一小段角度加一点延时。这是最土但最不容易出错的方式。for (int ang current; ang target; ang 1) { myServo.write(ang); delay(10); }第二种是线性插值设定运动总时长按时间比例计算当前角度。好处是速度均匀且用millis()做时间基准不阻塞主循环。int startAng 0; int endAng 180; unsigned long duration 2000; unsigned long t0 millis(); while (millis() - t0 duration) { float t (float)(millis() - t0) / duration; int angle startAng (int)((endAng - startAng) * t); myServo.write(angle); delay(10); }第三种是缓动曲线。上面的线性插值虽然匀速但起点和终点瞬间的速度突变仍会造成冲击。把 t 做一次 smoothstep 变换t t * t * (3 - 2 * t)就能让舵机先加速后减速启停都非常柔和。这个方法在云台追拍场景下效果立竿见影。4.3 角度反馈与闭环控制思路普通三线舵机没有角度反馈你让它转 90°它到底转没转到你并不知道。如果被外力掰动它也不会自己纠正。要获得真实角度至少有三条路在关节处外接电位器或磁编码器把读数接到 ESP32 的 ADC 或 I2C。换用带反馈引脚的总线舵机比如一些串行舵机可以通过协议直接读角度。像自稳云台那样用 MPU6050 这类姿态传感器做整体闭环舵机只当执行器。我做过一个简单的云台闭环读电位器反馈角度计算与目标角度的误差用比例控制调 PWM 脉宽。代码本身不复杂核心是那几行int feedback analogRead(36); // 读 ADC1避免和 WiFi 冲突 int error targetFeedback - feedback; float kp 0.3; int adjust error * kp; myServo.write(baseAngle adjust);注意调节kp时过大会来回震荡过小会响应迟钝。实际调参时可以先用串口打印误差曲线大致观察后定一个初始值再手工微调。5. 高级玩法无线遥控与 Web 调参5.1 手机蓝牙控制舵机20 行代码ESP32 自带经典蓝牙用 Arduino 自带的BluetoothSerial库可以很轻松做一个手机蓝牙串口控制。我用手机上的蓝牙串口调试 App 发数字舵机就跟着转非常适合快速验证机械结构。#include BluetoothSerial.h #include ESP32Servo.h BluetoothSerial SerialBT; Servo myServo; void setup() { SerialBT.begin(ESP32Servo); // 蓝牙名称 myServo.attach(13, 500, 2500); } void loop() { if (SerialBT.available()) { int angle SerialBT.parseInt(); if (angle 0 angle 180) { myServo.write(angle); } } }蓝牙方案的迟延会有一点一般几十毫秒手感和线控有明显差距。如果做实时性要求高的遥控机器人建议用 ESP-NOW它不依赖路由器设备间直连延迟更低。5.2 浏览器滑块控制基于 Web 的调参页面ESP32 的 WiFi 功能很适合做一个 Web 控制页电脑或手机浏览器打开页面拖动滑块舵机角度实时变化。这种方式比蓝牙更通用也方便别人上手使用。核心思路是ESP32 开启一个 WebServer前端页面用input typerange做滑块滑块变化时通过 HTTP 请求把角度告诉 ESP32。一个简化思路如下#include WiFi.h #include WebServer.h WebServer server(80); void handleAngle() { if (server.hasArg(angle)) { int angle server.arg(angle).toInt(); myServo.write(angle); } server.send(200, text/plain, OK); } void setup() { myServo.attach(13, 500, 2500); WiFi.begin(your_ssid, your_password); while (WiFi.status() ! WL_CONNECTED) delay(500); server.on(/set, handleAngle); server.begin(); } void loop() { server.handleClient(); }前端部分你可以把 HTML 以字符串形式挂在某个路由上或者用外部工具生成一个带滑块的页面滑块变化时访问/set?angle90。实测下来这种单次请求的方式在滑块连续拖动时会有一定延迟做简单遥控足够但想做平滑跟手还是得上 WebSocket。用 WebSocket 把滑块位置直接推给 ESP32刷新率可以到 30Hz 以上体感顺滑很多。5.3 从遥控到自主决策传感器联动的应用脚本无线控制很好玩但舵机真正的高级应用是跟传感器联动实现自主决策。举个例子一个自动浇花装置用一个土壤湿度传感器读数据当湿度低于阈值时舵机带动阀门打开浇够一分钟再关掉。这里的舵机只是一个执行器核心逻辑是传感器阈值判断和动作调度。再比如一个光控云台用两个光敏电阻判断光源方向舵机带动云台转向光源模拟向日葵的追光效果。这个项目用到两个 ADC 输入、两个舵机通道和一个简单的比例控制正好把所有前面讲的技术点串在一起。我强烈建议新手从这种“传感器 舵机”的小项目开始做比单纯转舵机更能体会到嵌入式系统设计的乐趣。6. 实测中的问题排查与经验沉淀6.1 舵机抖动、发热与不转的常见原因速查表我在调试舵机时遇到最多的几类问题归纳成一张速查表遇到异常直接对着查现象最可能原因快速验证与解决办法上电后不断抖动供电不足电压跌落换大电流电源舵机电源端并联 470uF 电容转不到 180°脉宽上限过低或舵机实际范围窄确认attach脉宽范围放宽到 500—2500 再测试转动时发热堵转或持续处于大电流状态检查机械卡点确认舵机是否被外力堵住完全不动信号线接错、GND 未共地用万用表测信号线电压确认共地方向反了舵机型号不同脉宽映射方向不一致映射时把脉宽上下限互换偶发抽搐信号线太长或靠近动力线干扰缩短信号线避免与电源线平行走线这张表不能解决所有问题但能覆盖九成的新手故障。最高频的永远是供电其次是接地然后是脉宽范围按这三个顺序排查是对的。6.2 一次完整排查案例为什么舵机上电后反复回中我见过最容易让人迷惑的一个现象是舵机上电后明明代码里写了转 90°但它先转到 0°顿一下再回到 90°如此反复。很多人以为是代码逻辑问题其实这是供电不足的典型表现。过程是这样的舵机上电时 ESP32 先复位舵机自动回到初始位置0°然后 ESP32 启动完成开始执行write(90)舵机开始向 90° 转动。如果这时候电源电压被拉低到 ESP32 的复位阈值以下ESP32 会立即重启。重启之后又回到“上电复位”状态舵机回到 0°然后代码又开始跑又转 90°形成无限循环。我在排查这类问题时第一步不是看代码而是用万用表量舵机电源端的电压。如果转动的瞬间电压从 5V 掉到 4V 以下那答案已经出来了换电源加电容问题立刻消失。这个案例也解释了为什么很多人一开始会怀疑是代码 bug结果怎么改都没用。6.3 几个值得长期记住的实操要点最后沉淀几条我自己的实操经验对长期做舵机项目很关键舵机上电默认动作不可控设计机械结构时一定要预留角度余量避免上电瞬间撞限位。信号线上串一个 100Ω—1kΩ 电阻再进舵机可以在舵机内部故障时保住 GPIO。大舵机不要长时间堵转保持超过几秒就会过热金属齿舵机也不例外。多舵机项目把代码里的频率统一设置在 50Hz不要给不同舵机设置不同频率否则部分舵机收不到有效信号。测试舵机时打开串口监视器输入角度值手动控制比每次改代码重新烧写高效得多。我在实际开发中一直保留一个“舵机测试台”一块面包板、一个 5V 2A 电源、一个 470uF 电容、几根杜邦线任何新舵机拿回来先上测试台跑一遍校准好脉宽范围再接入正式项目。这个习惯帮我省掉了大量后续排查时间也建议你养成。