Primeros pasos con ESP32 y Arduino IDE: guía completa desde cero
Instala el soporte de ESP32 en Arduino IDE 2, sube tu primer programa, conéctate al Wi-Fi y soluciona los errores más típicos al cargar código.
Lire en français →Algunos enlaces de este artículo son de afiliado: si compras a través de ellos, BeInTech recibe una pequeña comisión sin coste extra para ti. Así se mantiene el blog.
El ESP32 es probablemente el microcontrolador más útil que puedes comprar hoy por menos de 10 €: tiene Wi-Fi y Bluetooth integrados, dos núcleos a 240 MHz y un montón de pines. En esta guía vas a pasar de tener la placa en la caja a verla parpadear un LED y conectarse a tu Wi-Fi, en unos 20 minutos.
Lo que vas a aprender: instalar Arduino IDE 2, añadir las placas ESP32, subir tu primer programa, usar el monitor serie, conectarte al Wi-Fi y resolver los errores de carga más habituales.
Qué necesitas
- Una placa ESP32 DevKit (también llamada ESP32-WROOM-32 DevKit V1). Es la más común y barata. Si dudas entre modelos, mira la comparativa ESP32 vs ESP8266 vs Pico W.
- Un cable USB de datos. Ojo: muchos cables que vienen con cargadores solo llevan corriente y no sirven para programar. Es el error número uno.
- Un ordenador con Windows, macOS o Linux.
Placa ESP32 DevKit V1 (ESP32-WROOM-32)
La placa que uso en este tutorial. Suele venderse en packs de 2 o 3, que salen más baratos por unidad.
Paso 1: instala Arduino IDE 2
Descarga la última versión de Arduino IDE 2 desde la web oficial de Arduino (arduino.cc, sección Software) e instálala con las opciones por defecto. En Windows, acepta la instalación de los drivers cuando te lo pida.
Paso 2: añade el soporte para ESP32
Arduino IDE no trae el ESP32 de serie; hay que añadir el paquete de Espressif (el fabricante del chip):
- Abre Archivo → Preferencias.
- En “Gestor de URLs Adicionales de Tarjetas” pega esta dirección:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
- Pulsa OK.
- Abre el Gestor de placas (icono de la placa en la barra lateral izquierda), busca esp32 e instala el paquete “esp32 by Espressif Systems”. Tarda unos minutos porque descarga el compilador.
Paso 3: conecta la placa y elige el puerto
Conecta el ESP32 por USB. En el desplegable de la parte superior del IDE:
- Placa: busca y selecciona ESP32 Dev Module.
- Puerto: en Windows aparecerá como
COM3,COM4…; en macOS como/dev/cu.usbserial-…; en Linux como/dev/ttyUSB0.
¿No aparece ningún puerto?
Tu placa lleva un chip conversor USB-serie que puede necesitar driver. Mira el chip pequeño junto al conector USB:
| Chip en la placa | Driver que necesitas |
|---|---|
| CP2102 / CP2104 | CP210x USB to UART Bridge de Silicon Labs |
| CH340 / CH9102 | CH340/CH341 o CH9102 de WCH |
Instálalo, desconecta y vuelve a conectar la placa. Si sigue sin aparecer, prueba otro cable: en el 90 % de los casos es eso.
Paso 4: tu primer programa (Blink)
En la mayoría de placas DevKit hay un LED azul conectado al GPIO 2. Copia este código:
// Blink para ESP32: hace parpadear el LED de la placa
const int LED_PIN = 2; // LED integrado en la mayoría de ESP32 DevKit
void setup() {
pinMode(LED_PIN, OUTPUT);
Serial.begin(115200);
Serial.println("¡Hola desde el ESP32!");
}
void loop() {
digitalWrite(LED_PIN, HIGH);
delay(500);
digitalWrite(LED_PIN, LOW);
delay(500);
}
Pulsa el botón Subir (la flecha →). Cuando termine verás Hard resetting via RTS pin... y el LED empezará a parpadear. 🎉
Paso 5: el monitor serie
Abre Herramientas → Monitor Serie y selecciona 115200 baudios abajo a la derecha. Pulsa el botón EN (reset) de la placa y verás el mensaje ¡Hola desde el ESP32!.
El monitor serie es tu mejor herramienta de depuración: usa Serial.println() para saber qué está haciendo tu programa en cada momento.
Paso 6: conéctate al Wi-Fi
Aquí es donde el ESP32 se diferencia de un Arduino normal. Sustituye el código por este, poniendo el nombre y la contraseña de tu red:
#include <WiFi.h>
const char* WIFI_SSID = "NOMBRE_DE_TU_WIFI";
const char* WIFI_PASS = "TU_CONTRASEÑA";
void setup() {
Serial.begin(115200);
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASS);
Serial.print("Conectando");
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println();
Serial.print("Conectado. IP: ");
Serial.println(WiFi.localIP());
Serial.print("Señal (RSSI): ");
Serial.print(WiFi.RSSI());
Serial.println(" dBm");
}
void loop() {
}
Súbelo y abre el monitor serie. En unos segundos verás la IP que tu router ha asignado al ESP32. A partir de aquí puedes montar un servidor web, enviar datos por MQTT o integrarlo en Home Assistant.
Importante: el ESP32 solo funciona con redes de 2,4 GHz. Si tu router emite solo en 5 GHz, o usa el mismo nombre para ambas bandas y da problemas, activa una red de 2,4 GHz separada.
Errores típicos y cómo solucionarlos
Failed to connect to ESP32: Timed out waiting for packet header
La placa no ha entrado en modo de programación. Solución: mantén pulsado el botón BOOT cuando en la consola aparezca Connecting...., y suéltalo cuando empiece a escribir. Si te pasa siempre, se arregla soldando un condensador de 10 µF entre el pin EN y GND.
A fatal error occurred: Could not open port
Otro programa está usando el puerto (por ejemplo, un monitor serie abierto en otra ventana del IDE, PuTTY o PlatformIO). Ciérralo y vuelve a intentarlo.
El programa se sube pero no pasa nada
- Comprueba que el monitor serie está a 115200 baudios.
- Pulsa EN para reiniciar la placa.
- Si tu placa no tiene LED en el GPIO 2, conecta un LED con una resistencia de 220 Ω entre el GPIO 2 y GND.
Brownout detector was triggered
La placa no recibe suficiente corriente, sobre todo al activar el Wi-Fi. Usa otro puerto USB (mejor uno trasero del PC), otro cable o un hub alimentado.
Siguientes pasos
Ya tienes el ESP32 funcionando y conectado a Internet. Lo natural ahora es leer un sensor y enviar sus datos a algún sitio. Para eso te recomiendo empezar con un sensor de temperatura y humedad:
Sensor BME280 (temperatura, humedad y presión)
Preciso, barato y se conecta por I2C con solo 4 cables. Será la base de los próximos tutoriales.
Con él puedes seguir con estos dos tutoriales, en este orden:
- Estación meteorológica con ESP32 y BME280: lee el sensor y muestra los datos en una web.
- MQTT explicado fácil, con Mosquitto y ESP32: envía esos datos a un servidor y controla el ESP32 a distancia.
¿Te has quedado atascado en algún paso? Escríbeme y lo revisamos.