单片机与物联网 / 系统课时

控制舵机角度

控制舵机角度

本节用 ESP32 的 LEDC 外设直接生成舵机控制脉冲,把 0~180° 目标角度映射为脉宽并持续输出。完成后,你会得到一个无需舵机库的最小程序,并知道如何安全接线、校准端点和判断抖动或顶死问题。

学习目标

  • 理解舵机角度、脉宽与 PWM 占空比之间的关系
  • 使用 Arduino-ESP32 3.x 的 LEDC API 输出 50 Hz 舵机信号
  • 能根据实际舵机调整脉宽端点,避免堵转和持续嗡鸣

接线与控制信号

常见 hobby 舵机有电源、地和信号三根线。信号线可接到支持数字输出的 GPIO,例如 GPIO18;舵机电源应由满足其电压和电流要求的独立电源提供,并让外部电源 GND 与 ESP32 GND 共地。不要把舵机直接挂在 ESP32 的 3.3 V 引脚上供电。

ESP32 与舵机的供电和信号接线关系

舵机并不是通过普通“占空比百分比”理解角度,而是读取每个周期中的高电平持续时间。常用刷新频率约为 50 Hz,即周期约 20 ms;本例先采用 600~2400 μs 作为 0~180° 的映射范围,实际舵机允许范围可能更窄或更宽。

把角度映射为脉宽

映射分两步:先把目标角度线性换算成脉宽,再把脉宽占 20 ms 周期的比例换算为 LEDC 的 duty。选择 14 位分辨率时,duty 范围是 0~16383,足以提供细致的舵机脉宽步进,并兼顾 ESP32 系列芯片的兼容性。

例如 90° 会被映射到约 1500 μs。只要保持 50 Hz 周期不变,改变高电平宽度就能改变目标角度;因此不要使用 analogWrite 式的 0~100% 思维直接设置角度。

用 LEDC 输出舵机脉冲

下面示例使用 Arduino-ESP32 3.x 的 ledcAttach 和 ledcWrite。GPIO18 可按你的开发板改成其他可用输出引脚。

cpp
#include <Arduino.h>

constexpr uint8_t SERVO_PIN = 18;
constexpr uint32_t SERVO_FREQ = 50;
constexpr uint8_t PWM_BITS = 14;
constexpr uint32_t PWM_MAX = (1UL << PWM_BITS) - 1;
constexpr uint32_t FRAME_US = 1000000UL / SERVO_FREQ;

constexpr uint16_t MIN_PULSE_US = 600;
constexpr uint16_t MAX_PULSE_US = 2400;

uint32_t pulseToDuty(uint32_t pulseUs) {
  return (pulseUs * PWM_MAX) / FRAME_US;
}

void setServoAngle(uint8_t angle) {
  // 先限制目标角度,再换算为舵机需要的高电平宽度。
  angle = constrain(angle, 0, 180);
  uint32_t pulseUs = map(angle, 0, 180, MIN_PULSE_US, MAX_PULSE_US);

  // LEDC 接收的是 duty,不是微秒值。
  ledcWrite(SERVO_PIN, pulseToDuty(pulseUs));
  Serial.printf("angle=%u, pulse=%lu us\n",
                angle, static_cast<unsigned long>(pulseUs));
}

void setup() {
  Serial.begin(115200);

  if (!ledcAttach(SERVO_PIN, SERVO_FREQ, PWM_BITS)) {
    Serial.println("LEDC attach failed");
    while (true) {
      delay(1000);
    }
  }

  Serial.println("servo pwm ready");
}

void loop() {
  const uint8_t angles[] = {0, 90, 180, 90};

  for (uint8_t angle : angles) {
    setServoAngle(angle);
    delay(1200);
  }
}

预期输出:

text
servo pwm ready
angle=0, pulse=600 us
angle=90, pulse=1500 us
angle=180, pulse=2400 us
angle=90, pulse=1500 us

串口内容会循环出现,同时舵机依次转向三个目标位置。机械安装、供电和舵机型号都会影响实际角度,因此“串口脉宽正确”并不等于机械端点一定安全。

校准端点并处理异常

首次测试时可以先把 MIN_PULSE_US 和 MAX_PULSE_US 收窄,例如从 800~2200 μs 开始,再逐步向两端扩展。若舵机在端点持续嗡鸣、发热或无法继续转动,说明目标脉宽可能超过机械行程,应立即缩小范围。

如果舵机在静止位置轻微抖动,还应检查电源纹波、信号线过长以及脉宽是否处于机械临界点。稳定控制的关键是:电源可靠、周期稳定,并用实际硬件校准脉宽端点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制舵机角度

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通