Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x: migrar pines, canales y temporizadores

Sustituye las llamadas eliminadas y revisa si cada argumento identifica un pin o un canal antes de cambiar el hardware. Esta guía usa Arduino-ESP32 3.3.8; dos canales distintos no garantizan cambios de frecuencia independientes.

Ejemplos: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4, Arduino CLI 1.6.0. Fuentes revisadas el 2026-11-15.

Comprueba qué core está compilando

La migración de 2.x a 3.0 eliminó ledcSetup y ledcAttachPin. Un sketch de un tutorial antiguo puede fallar antes de generar PWM. Ese error del compilador no diagnostica el servo ni su alimentación.

Revisa el paquete de placa y la versión del core en la salida de compilación. Conserva el proyecto y sus dependencias; comprueba qué core admite una biblioteca externa. Este ejemplo fijo no garantiza que funcionen todas las bibliotecas antiguas.

Migra cada llamada según su función

ledcAttach elige el canal automáticamente. Usa ledcAttachChannel si necesitas elegirlo. Ambas devuelven si la configuración fue correcta. Si el canal ya está configurado, se ignoran la nueva frecuencia y resolución.

En ledcWrite basado en pin, 0 significa GPIO0, no canal 0. Para una salida en GPIO18, pasa 18; si quieres direccionar un canal, usa ledcWriteChannel. Un entero con el significado equivocado puede compilar: revisa también el valor devuelto.

Desplázate horizontalmente para comparar todas las columnas.

FunciónArduino-ESP32 2.xArduino-ESP32 3.3.8
Conectar, canal automáticoledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttach(pin, Hz, bits)
Conectar, canal explícitoledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttachChannel(pin, Hz, bits, channel)
Escribir ciclo de trabajoledcWrite(channel, duty)ledcWrite(pin, duty) / ledcWriteChannel(channel, duty)

Compila un ejemplo fijo para ESP32 clásico

El sketch completo corresponde al perfil ESP32 clásico indicado: GPIO18, canal 0, APB 80 MHz, 50 Hz, 14 bits y un pulso solicitado de 1500 µs. Redondea el ciclo de trabajo y comprueba cada operación. Rechaza otro core o destino de chip.

Sketch completo para ESP32 clásico · Arduino-ESP32 3.3.8
#include <Arduino.h>
#include <esp_arduino_version.h>

#if ESP_ARDUINO_VERSION != ESP_ARDUINO_VERSION_VAL(3, 3, 8)
#error "Use Arduino-ESP32 3.3.8 for this example"
#endif
#if !CONFIG_IDF_TARGET_ESP32
#error "This example targets the classic ESP32 profile"
#endif

constexpr uint8_t SERVO_PIN = 18;
constexpr uint8_t SERVO_CHANNEL = 0;
constexpr uint32_t FREQ_HZ = 50;
constexpr uint8_t RES_BITS = 14;
constexpr uint32_t PULSE_US = 1500;
constexpr uint32_t DUTY =
    (uint64_t(PULSE_US) * FREQ_HZ * (1UL << RES_BITS) + 500000ULL)
    / 1000000ULL;

void setup() {
  Serial.begin(115200);
  bool ok = ledcSetClockSource(LEDC_USE_APB_CLK);
  if (ok) {
    ok = ledcAttachChannel(SERVO_PIN, FREQ_HZ, RES_BITS, SERVO_CHANNEL);
  }
  if (ok) {
    ok = ledcWrite(SERVO_PIN, DUTY);  // pin, not channel
  }
  Serial.println(ok ? "LEDC configured" : "LEDC setup failed");
}

void loop() {}

Guárdalo como ledc_migration/ledc_migration.ino y compila con las herramientas fijadas. El pulso no es un centro ni un límite de recorrido calibrado para cualquier servo. Los proyectos S3/C3 necesitan su propio perfil del planificador y compilación externa.

Compilación externa · Arduino CLI 1.6.0
arduino-cli version
arduino-cli core list
arduino-cli compile --fqbn "esp32:esp32:esp32:FlashMode=dio,FlashSize=4M,PartitionScheme=default" --export-binaries ./ledc_migration

Comprueba frecuencia y resolución juntas

Con un reloj fijo, frecuencia y bits determinan juntos el divisor. A baja frecuencia, reducir los bits aumenta el divisor necesario y puede superar su rango. Por tanto, elegir menos bits no siempre corrige el fallo. La tabla usa los relojes fijos de los perfiles del sitio.

A 50 Hz y 14 bits, cada paso nominal equivale aproximadamente a 1.2207 µs. Una petición de 1500 µs se redondea a 1229 pasos, unos 1500.2441 µs. Son cálculos del modelo de divisor fijado, no mediciones de osciloscopio ni una garantía del ángulo físico.

Desplázate horizontalmente para comparar todas las columnas.

Reloj fijo del perfil50 Hz · 8 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · fuera de rangoD = 97.65625 · viable
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · fuera de rangoD = 48.828125 · viable

Distingue pines, canales y temporizadores

El canal controla el ciclo de trabajo; el temporizador proporciona frecuencia y resolución. La implementación fijada puede reutilizar un temporizador con ajustes coincidentes. Dos canales pueden tener distintos ciclos de trabajo y compartir temporización.

Cambiar la frecuencia puede afectar a otros usuarios del temporizador. Elegir números de canal diferentes no demuestra independencia. Revisa grupo y temporizador en el planificador y conserva frecuencia fija en este ejemplo; no se promete una solución de reajuste dinámico.

Diagnostica antes de modificar el código

Empieza por la primera etapa que falla. Conserva reloj, frecuencia, resolución, pin y canal en el informe para que la configuración pueda reproducirse.

  1. Falta ledcSetup/ledcAttachPin: comprueba el core y aplica la fila de migración adecuada.
  2. La configuración devuelve false: revisa pin real, reservas de periféricos y combinación de frecuencia/resolución.
  3. Compila pero no cambia el ciclo: distingue pin de canal y revisa el resultado de escritura.
  4. Dos frecuencias cambian juntas: comprueba el temporizador compartido; separar canales no prueba independencia.

Preguntas de migración

¿Por qué no se declara ledcSetup?

Pertenece a la API eliminada al migrar de 2.x a 3.0. Comprueba el core real y sustituye configuración y conexión por la API adecuada de 3.3.8. Ese error no comprueba el cableado.

¿Puedo mantener ledcWrite(0,duty)?

Solo si GPIO0 es el pin configurado que quieres controlar. En 3.3.8 ledcWrite recibe un pin. Para canal 0 usa ledcWriteChannel(0,duty); para GPIO18 del ejemplo,ledcWrite(18,duty).

¿Por qué canales diferentes cambian juntos de frecuencia?

Pueden compartir temporizador. El ciclo pertenece al canal; la frecuencia y resolución, al temporizador. La implementación fijada puede reutilizar temporizadores coincidentes.

¿Ejecuta el simulador clásico un proyecto S3 o C3?

No. El planificador permite configurar y exportar los perfiles S3/C3 indicados, pero el emulador ejecuta únicamente ESP32 clásico. Compila otros destinos con su herramienta externa correspondiente.

Fuentes del proyecto

Contacto