Arduino IDE 2.x para ESP32: instalación paso a paso (y los errores de siempre)

Cómo instalar y configurar el Arduino IDE 2.x para el ESP32: URLs de placas, selección de placa, drivers CH340/CP2102, subir el programa y el monitor serie.

También disponible en: EN, ES

Serie Introducción al ESP32 Parte 16 Ver la serie →
Arduino IDE 2.x con el ESP32

El Arduino IDE 2.x es la forma más rápida de tener un LED parpadeando. Tiene fricciones conocidas (placas, drivers, puerto), así que aquí va la guía con los tropiezos típicos ya resueltos.

1. Instalar el IDE

Descárgalo de arduino.cc (versión 2.x). Trae editor, gestor de librerías, monitor serie y gestor de placas.

2. Añadir el soporte de ESP32

En File → Preferences → Additional boards manager URLs pega:

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

Luego ve a Boards Manager, busca esp32 e instala esp32 by Espressif Systems. Tarda un rato: son cientos de MB.

3. Elegir la placa correcta

En Tools → Board escoge la tuya:

  • ESP32 Dev Module → el clásico.
  • ESP32S3 Dev Module, ESP32C3 Dev Module, etc. → la variante.
  • ESP32-WROVER solo si el módulo lleva PSRAM.

Si eliges mal la placa, suele compilar y subir, pero no arranca o se queda en bucle. Es el error número uno.

4. El puerto serie y los drivers

Aquí está el 90 % de los problemas. Mira qué chip USB-serie lleva tu placa:

ChipDriver
CP2102 (Silicon Labs)CP210x VCP
CH340 / CH341 (WCH)CH341SER
USB nativo (S3/C3/C6)no necesita driver

Si no aparece el puerto en Tools → Port, es el driver. En Linux, además, puede que necesites pertenecer al grupo dialout.

5. Subir el primer programa

void setup() {
  Serial.begin(115200);
  pinMode(2, OUTPUT);
}

void loop() {
  digitalWrite(2, !digitalRead(2));
  delay(500);
  Serial.println("parpadeo");
}

Pulsa Upload. Si se queda en Connecting..., mantén pulsado BOOT unos segundos; es el truco clásico.

6. El monitor serie

Ábrelo con el icono de la lupa y pon 115200 baudios. Si ves caracteres raros («����»), es que la velocidad no coincide.

Errores típicos y su causa

SíntomaCausa habitual
«No such file» o puerto ausenteDriver USB-serie
Connecting........ eternoBotón BOOT, cable malo o placa incorrecta
Se sube pero no hace nadaPlaca mal elegida (variante)
Reinicios en bucleFalta de corriente o GPIO12 en alto
Basura en el monitorVelocidad distinta a 115200

Ajustes que ahorran tiempo

  • Activa «Show verbose output during: upload» cuando algo falle: dice la verdad.
  • Usa nombre de puerto fijo si tienes varias placas.
  • Guarda tus placas favoritas para no elegir cada vez.
  • Para proyectos grandes, salta a VS Code + PlatformIO: el IDE de Arduino se queda corto.

Resumen

  1. Instala el IDE y añade la URL de placas de Espressif.
  2. Instala «esp32 by Espressif» desde el Boards Manager.
  3. Elige la placa correcta (esto rompe más proyectos que el código).
  4. Resuelve el driver del chip USB-serie.
  5. Sube, abre el monitor a 115200 y disfruta.

Siguiente paso: VS Code + PlatformIO cuando el proyecto crezca. O vuelve al hub de la serie.

Entradas relacionadas

↑↓ navegar ↵ abrir Esc cerrar