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ón | Arduino-ESP32 2.x | Arduino-ESP32 3.3.8 |
|---|---|---|
| Conectar, canal automático | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttach(pin, Hz, bits) |
| Conectar, canal explícito | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttachChannel(pin, Hz, bits, channel) |
| Escribir ciclo de trabajo | ledcWrite(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.
#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.
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 perfil | 50 Hz · 8 bit | 50 Hz · 14 bit |
|---|---|---|
| ESP32 · APB 80 MHz | D = 6250 · fuera de rango | D = 97.65625 · viable |
| ESP32-S3 / C3 · XTAL 40 MHz | D = 3125 · fuera de rango | D = 48.828125 · viable |
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.
- Falta ledcSetup/ledcAttachPin: comprueba el core y aplica la fila de migración adecuada.
- La configuración devuelve false: revisa pin real, reservas de periféricos y combinación de frecuencia/resolución.
- Compila pero no cambia el ciclo: distingue pin de canal y revisa el resultado de escritura.
- 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.