Cómo configurar el ESP32 en Arduino IDE
El ESP32 es uno de los microcontroladores más usados en proyectos IoT: tiene WiFi, Bluetooth, más memoria y más pines que su antecesor el ESP8266. Sin embargo, como pasa con cualquier placa no oficial de Arduino, no aparece en el IDE por defecto. Hay que decirle dónde buscarla.
En este tutorial vas a aprender a agregar el soporte para ESP32 en Arduino IDE, instalar las librerías necesarias y verificar que tu placa funciona correctamente.
Lo que necesitás antes de empezar:
- Arduino IDE instalado (versión 1.8.x o 2.x, recomendado 2.x)
- Una placa basada en ESP32 y cable USB
- Conexión a internet para descargar los paquetes
Índice
- Agregar la URL del gestor de placas
- Instalar el paquete ESP32
- Seleccionar tu placa
- Instalar librerías adicionales
- Verificar que todo funciona
Paso 1: Agregar la URL del gestor de placas
El Arduino IDE soporta placas de terceros mediante URLs de índice. Para el ESP32 de Espressif, la URL oficial es:
https://dl.espressif.com/dl/package_esp32_index.json
Para agregarla: abrí el IDE y andá a File → Preferences (en Mac: Arduino IDE → Preferences). En el campo "Additional boards manager URLs" pegá la URL y hacé clic en OK.
Si ya tenés otras URLs (por ejemplo la del ESP8266), separarlas con una coma. Podés tener ambas al mismo tiempo sin problema.
Paso 2: Instalar el paquete ESP32
Ahora el IDE sabe dónde buscar los archivos del ESP32.
Andá a Tools → Board → Boards Manager. En el buscador escribí esp32 y vas a ver el paquete "esp32 by Espressif Systems". Hacé clic en Install.
Este paquete es bastante pesado (puede superar los 300 MB), así que la descarga puede tardar varios minutos. Cuando termine, el botón muestra "Installed".
Tip: si usás Arduino IDE 2.x, el Boards Manager está en el panel lateral izquierdo con el ícono de placa.
Paso 3: Seleccionar tu placa
Conectá tu placa ESP32 por USB.
Andá a Tools → Board → ESP32 Arduino y elegí la placa que corresponda a tu hardware. Las más comunes son:
- ESP32 Dev Module — para la mayoría de los módulos genéricos de ESP32
- DOIT ESP32 DEVKIT V1 — para el dev kit muy popular de DOIT
- ESP32-S2, ESP32-C3, ESP32-S3 — si tenés variantes más nuevas del chip
Si no sabés exactamente cuál tenés, empezá con ESP32 Dev Module, que funciona con la mayoría de los módulos genéricos.
Después andá a Tools → Port y seleccioná el puerto que corresponde a tu placa.
Si no aparece el puerto, puede que necesites el driver CP2102 o CH340, dependiendo del chip USB que use tu placa. Revisá qué chip tiene tu módulo y buscá el driver correspondiente.
Paso 4: Instalar librerías adicionales
Al instalar el paquete ESP32, ya quedan disponibles librerías esenciales como WiFi.h y BluetoothSerial.h. Para otras funcionalidades, usás el gestor de librerías.
Andá a Sketch → Include Library → Manage Libraries (o Ctrl+Shift+I). Algunas librerías muy usadas con ESP32:
- PubSubClient — para comunicación MQTT
- ArduinoJson — para trabajar con JSON
- AsyncTCP + ESPAsyncWebServer — para crear un servidor web asíncrono en el ESP32
- TFT_eSPI — si usás una pantalla TFT
- ESP32Servo — para controlar servomotores
Buscás el nombre, seleccionás la versión más reciente y hacés clic en Install.
Paso 5: Verificar que todo funciona
Para confirmar que la placa está bien configurada, cargá un ejemplo de WiFi. Andá a File → Examples → WiFi → WiFiScan.
Este programa escanea las redes WiFi disponibles y las muestra por el monitor serial. Hacé clic en Upload y esperá a que compile y se suba. Cuando termine, abrí el monitor serial en Tools → Serial Monitor con una velocidad de 115200 baudios.
Deberías ver las redes WiFi cercanas listadas con su SSID y nivel de señal. Si aparecen, la configuración está completa y el módulo WiFi funciona correctamente.
Errores comunes
"No se encuentra el puerto" — Verificá el driver USB. Los módulos ESP32 suelen usar CH340 o CP2102. Si no sabés cuál tiene el tuyo, revisá el chip pequeño que está cerca del puerto USB en la placa.
"A fatal error occurred: Failed to connect to ESP32" — Muchas placas ESP32 requieren que mantengas apretado el botón BOOT al inicio de la carga. Cuando veas Connecting... en la consola, apretá BOOT, esperá 1-2 segundos y soltalo.
"Sketch too big" — El ESP32 Dev Module por defecto puede tener una partición pequeña. Andá a Tools → Partition Scheme y elegí una opción con más espacio para la app, como "Huge APP (3MB No OTA)".
¿Qué aprender después?
Con el ESP32 configurado, las posibilidades son muchas. Algunos próximos pasos:
- Conectar el ESP32 a una red WiFi y consumir una API REST
- Usar Bluetooth para comunicar el ESP32 con el celular
- Crear un servidor web local con ESPAsyncWebServer
- Explorar el modo deep sleep para proyectos con batería