ESP32（六） Arduino 舵机控制

最新推荐文章于 2026-08-17 10:28:17 发布

原创最新推荐文章于 2026-08-17 10:28:17 发布 · 331 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

电子

🔥 全网最适配 ESP32 Core 3.3.x 新版方案 | 彻底解决新手两大致命坑

很多小伙伴用ESP32驱动MG90S舵机时，都会遇到两个无解难题：

1. 新版内核编译报错：ledcSetup/ledcAttachPin 未定义、类型转换失败

2. 舵机只会单向一直转：写了0°/90°角度代码，完全无法来回摆动

本文手把手带你彻底根治问题！核心原因是：你买到的是360°连续旋转版MG90S，而非普通180°角度舵机，两者控制逻辑完全不同，网上90%的旧代码都不适用新版ESP32内核！

文末提供 零报错、开箱即用、状态机稳定往复旋转 完整源码，附带接线、参数调优、故障排查全教程！

一、核心避坑：180°与360° MG90S本质区别

这是99%新手踩坑的根源，两种舵机外观一模一样，控制逻辑天差地别：

1. 普通180°角度舵机

脉冲控制 角度位置
给到对应角度就锁止静止，定点停留
适用：机械臂、云台、开关结构

2. 360°连续旋转舵机（本文适配款）

无角度定位功能，脉冲只控制转向和转速
1500μs = 停止
＞1500μs = 顺时针正转（数值越大越快）
＜1500μs = 逆时针反转（数值越小越快）
适用：小车轮子、往复转动结构、持续运动机构

✅ 结论：360°舵机不能用角度映射代码！必须用脉冲值控制启停和转向！

二、新版ESP32内核报错根源

ESP32 Arduino Core 3.0+ 版本彻底废弃旧API：

❌ 旧版废弃函数（编译报错）：ledcSetup()、ledcAttachPin()

✅ 新版唯一可用组合：ledcAttach() 初始化 + ledcWrite(引脚, 占空比)

本文代码专门适配 3.3.x 最新内核，零编译报错，无需降级内核！

三、硬件接线规范（必看！舵机不动90%是这里的问题）

1. 引脚定义（通用标准）

棕/黑线：GND 负极
红线：5V 电源正极
橙/黄线：PWM 信号线

2. 接线方案

信号脚：舵机橙线 → ESP32 GPIO21
电源：舵机红线 → 外部独立5V供电
共地：舵机GND、外部电源GND、ESP32 GND 必须相连

⚠️ 硬核提醒：360°舵机持续旋转电流大，严禁ESP32板载USB供电，电压跌落会导致舵机乱转、停不住、抖动！

四、项目效果演示

程序实现稳定循环逻辑：

正转10s → 停顿1s → 反转10s → 停顿1s → 无限往复循环

搭配板载D2心跳LED，正常闪烁代表程序运行正常，方便故障自查。

五、完整零报错源码（直接复制编译）

// ESP32 WROOM-32 360° MG90S 往复旋转舵机 + 心跳LED
// 完美适配 ESP32 Arduino Core 3.3.x 新版内核
// 功能：正转10s-停顿1s-反转10s-停顿1s 无限循环
#define SERVO_PIN     21    // 舵机信号引脚
#define LED_PIN       2     // 心跳LED引脚

// 舵机PWM基础参数
const int SERVO_FREQ = 50;
const int SERVO_RESOLUTION = 16;

// 360°舵机专属脉冲参数（可自由调速）
const uint32_t STOP_PULSE    = 1500;   // 标准停止脉冲
const uint32_t CW_PULSE      = 1900;   // 顺时针正转
const uint32_t CCW_PULSE     = 1100;   // 逆时针反转

// 时长配置（自定义循环节奏）
const unsigned long RUN_TIME    = 10000; // 单次转动时长10s
const unsigned long STOP_TIME   = 1000;  // 换向停顿1s
const unsigned long ledHalfInterval = 400; // LED心跳周期

// 状态机枚举，程序更稳定、逻辑清晰
enum ServoState {
  IDLE,         // 空闲停顿
  ROTATE_CW,    // 正转
  ROTATE_CCW    // 反转
};

ServoState currentState = IDLE;
unsigned long stateStartTick = 0;
unsigned long lastLedTime = 0;
bool ledState = LOW;

// 统一设置舵机PWM脉冲
void setServoPulse(uint32_t pulseUs)
{
  uint32_t maxDuty = (1UL << SERVO_RESOLUTION) - 1;
  uint32_t duty = (pulseUs * maxDuty) / 20000UL;
  ledcWrite(SERVO_PIN, duty);
}

void setup()
{
  Serial.begin(115200);
  pinMode(LED_PIN, OUTPUT);
  digitalWrite(LED_PIN, LOW);

  // 新版ESP32内核PWM初始化（无报错专用写法）
  bool ok = ledcAttach(SERVO_PIN, SERVO_FREQ, SERVO_RESOLUTION);
  if(!ok){
    Serial.println("LEDc 引脚分配失败！");
  }

  // 上电初始停止，启动正转循环
  setServoPulse(STOP_PULSE);
  currentState = ROTATE_CW;
  stateStartTick = millis();
  Serial.println("系统启动成功！开始往复旋转循环");
}

void loop()
{
  unsigned long now = millis();

  // 心跳LED 0.8s周期闪烁（程序运行自检）
  if (now - lastLedTime >= ledHalfInterval)
  {
    lastLedTime = now;
    ledState = !ledState;
    digitalWrite(LED_PIN, ledState);
  }

  unsigned long duration = now - stateStartTick;

  // 状态机控制往复旋转
  switch(currentState)
  {
    // 正转状态
    case ROTATE_CW:
      setServoPulse(CW_PULSE);
      if(duration >= RUN_TIME)
      {
        setServoPulse(STOP_PULSE);
        Serial.println("【正转结束】进入停顿阶段");
        currentState = IDLE;
        stateStartTick = now;
      }
      break;

    // 反转状态
    case ROTATE_CCW:
      setServoPulse(CCW_PULSE);
      if(duration >= RUN_TIME)
      {
        setServoPulse(STOP_PULSE);
        Serial.println("【反转结束】进入停顿阶段");
        currentState = IDLE;
        stateStartTick = now;
      }
      break;

    // 空闲停顿状态，自动切换方向
    case IDLE:
      if(duration >= STOP_TIME)
      {
        static bool turnCW = true;
        if(turnCW)
        {
          currentState = ROTATE_CW;
          Serial.println("【开始执行】顺时针正转");
        }
        else
        {
          currentState = ROTATE_CCW;
          Serial.println("【开始执行】逆时针反转");
        }
        turnCW = !turnCW;
        stateStartTick = now;
      }
      break;
  }
}