Programar el ESP32 con el IDE de Arduino

El Arduino IDE no trae soporte para el ESP32 de fábrica: hay que añadir su gestor de placas antes de poder compilar y subir código. Una vez hecho ese paso, programar un ESP32 es casi idéntico a programar un Arduino UNO, con algunas diferencias importantes que conviene conocer.

Requisitos previos

• Arduino IDE (2.x recomendado) ya instalado.
• Un cable USB de datos, no solo de carga.
• Conexión a internet la primera vez, para descargar el paquete de la placa.
• En algunos clones, los controladores CP2102 o CH340 del chip USB-serie.

1. Añadir el gestor de placas ESP32

1. Abre Archivo → Preferencias (File → Preferences).
2. En el campo URLs Adicionales de Gestor de Tarjetas, pega esta URL:
   URL Copiar

   https://espressif.github.io/arduino-esp32/package_esp32_index.json

3. Pulsa OK y ve a Herramientas → Placa → Gestor de tarjetas.
4. Busca esp32 e instala el paquete esp32 by Espressif Systems.

2. Conectar y configurar la placa

Conecta el ESP32 al ordenador con el cable USB y configura estos ajustes en el menú Herramientas:

A diferencia de un Arduino UNO, la mayoría de placas ESP32 tienen un circuito de auto-reseteo que entra en modo de subida solo, sin pulsar ningún botón. Si la subida se queda colgada en Connecting..., mantén pulsado el botón BOOT mientras empieza la subida y suéltalo en cuanto veas que conecta.

3. Programa de prueba: parpadeo adaptado al ESP32

El ESP32 no siempre define LED_BUILTIN. En la mayoría de placas de desarrollo el LED integrado está en el GPIO2, aunque conviene revisar la serigrafía de tu placa:

const int LED = 2;

void setup() {
  pinMode(LED, OUTPUT);
}

void loop() {
  digitalWrite(LED, HIGH);
  delay(500);
  digitalWrite(LED, LOW);
  delay(500);
}

Pulsa Verificar para compilar y Subir para cargarlo. Al terminar, el LED debería parpadear cada medio segundo sin necesidad de reiniciar la placa manualmente.

Diferencias frente a un Arduino UNO

• Lógica de 3.3V: tanto las entradas como las salidas digitales trabajan en este rango.
• Sin salida analógica real en los modelos sin DAC: hay que simular voltajes intermedios con PWM (ledcWrite) en vez de analogWrite puro.
• Memoria particionada: el menú Herramientas → Partition Scheme permite repartir la flash entre el programa y un sistema de archivos (SPIFFS o LittleFS) si vas a guardar datos en la propia placa.
• Wi-Fi y Bluetooth integrados: no hacen falta módulos externos ni pines adicionales para conectarse a una red.

Solución de problemas comunes

Con esto ya tienes un flujo de trabajo completo: instalar el gestor de placas, configurar el puerto correcto y subir tu primer programa. A partir de aquí, cualquier ejemplo de Arduino UNO se puede adaptar al ESP32 teniendo en cuenta la tensión de 3.3V y los pines específicos de cada modelo.