Arduino IDE 2 es la versión más moderna del popular entorno de desarrollo de Arduino y la opción recomendada para programar placas ESP32.
En este tutorial aprenderás a instalar el soporte para las placas ESP32 y preparar el entorno para comenzar a desarrollar tus propios proyectos, independientemente de si utilizas Windows, macOS o Linux.
Según Arduino, esta nueva versión supone una importante evolución respecto al IDE clásico, incorporando mejoras como:
- Mayor rendimiento y tiempos de respuesta más rápidos.
- Una interfaz renovada y mucho más intuitiva.
- Autocompletado de código, que agiliza la programación.
- Depurador (Debugger) integrado para facilitar la detección de errores en placas compatibles.
- Sincronización con Arduino Cloud, permitiendo gestionar proyectos desde distintos dispositivos.
Aunque el Arduino IDE clásico (1.8.x) sigue siendo compatible con el ESP32, para nuevos proyectos resulta mucho más recomendable utilizar Arduino IDE 2, ya que recibe las últimas mejoras y ofrece una experiencia de desarrollo considerablemente más moderna.
Por otro lado, si buscas un entorno más avanzado con funciones orientadas a proyectos profesionales, también puedes optar por Visual Studio Code junto con la extensión PlatformIO, una combinación muy popular entre los desarrolladores más experimentados.
Requisitos previos
Antes de instalar el soporte para las placas ESP32, asegúrate de tener Arduino IDE 2 correctamente instalado en tu ordenador.
Puedes descargar gratuitamente la versión correspondiente a tu sistema operativo desde la página oficial de Arduino.
La instalación es muy sencilla:
- Windows: ejecuta el archivo descargado y sigue el asistente de instalación. En la mayoría de los casos, la configuración predeterminada es la opción más recomendable.
- macOS: arrastra Arduino IDE a la carpeta Aplicaciones.
- Linux: descomprime el paquete descargado y ejecuta el archivo correspondiente para iniciar el entorno de desarrollo.
Una vez completada la instalación, tendrás todo preparado para añadir el soporte oficial para las placas ESP32 y comenzar a programarlas desde Arduino IDE 2.
¡GADGETS ESP32 MÁS BARATOS DE AMAZON!
¿Cómo instalar el complemento ESP32 en Arduino IDE?
Una vez instalado Arduino IDE 2, el siguiente paso consiste en añadir el paquete oficial de placas ESP32, desarrollado por Espressif Systems. Este complemento incorpora todas las herramientas necesarias para compilar, cargar y depurar programas en cualquier placa basada en ESP32.
El proceso es muy sencillo:
Abre el Gestor de tarjetas desde Herramientas → Placa → Gestor de tarjetas… (Boards Manager). También puedes acceder pulsando el icono correspondiente situado en la barra lateral izquierda de Arduino IDE.
En el cuadro de búsqueda escribe ESP32.
Localiza el paquete esp32 by Espressif Systems y pulsa Instalar.
Se descargará automáticamente la versión estable más reciente (actualmente perteneciente a la rama 3.x, aunque puede variar con el tiempo). La instalación suele completarse en apenas unos segundos, dependiendo de la velocidad de tu conexión a Internet.
Una vez finalizado el proceso, Arduino IDE quedará preparado para reconocer y programar la mayoría de placas basadas en el microcontrolador ESP32, incluyendo modelos tan populares como la ESP32 DevKit, ESP32-WROOM, ESP32-S3, ESP32-C3, ESP32-C6 o la conocida ESP32-CAM, entre muchas otras.
¿Cómo comprobar la instalación?
Una vez instalado el soporte para ESP32 en Arduino IDE, es recomendable realizar una prueba sencilla para comprobar que todo funciona correctamente.
El ejemplo más habitual consiste en hacer parpadear el LED integrado de la placa, conectado normalmente al GPIO 2 en la mayoría de modelos ESP32 DevKit.
Este programa enciende y apaga el LED cada segundo, al mismo tiempo que muestra el estado del LED en el Monitor Serie.
Copia el siguiente código en un nuevo proyecto de Arduino IDE:
#include <Arduino.h>
#define LED 2
void setup() {
// Inicializa la comunicación serie
Serial.begin(115200);
// Configura el GPIO 2 como salida
pinMode(LED, OUTPUT);
}
void loop() {
// Enciende el LED
digitalWrite(LED, HIGH);
Serial.println("LED encendido");
delay(1000);
// Apaga el LED
digitalWrite(LED, LOW);
Serial.println("LED apagado");
delay(1000);
}
¿Qué hace este programa?
Su funcionamiento es muy sencillo:
- Inicializa la comunicación serie a 115200 baudios.
- Configura el GPIO 2 como salida digital.
- Enciende el LED durante un segundo.
- Lo apaga durante otro segundo.
- Repite el proceso indefinidamente.
Si todo está correctamente configurado, observarás cómo el LED azul de la placa parpadea de forma continua. Además, al abrir el Monitor Serie configurado a 115200 baudios, aparecerán mensajes indicando cuándo el LED se enciende y cuándo se apaga.
Nota: Aunque el GPIO 2 es el más habitual para el LED integrado en muchas placas ESP32, algunos fabricantes utilizan un pin diferente. Si el LED no parpadea pero el programa se carga correctamente, consulta la documentación o el pinout de tu placa para identificar el GPIO asociado al LED integrado.
¿Cómo cargar el programa en la placa ESP32?
Una vez preparado el código, solo queda cargarlo en la placa.
¡GADGETS ESP32 MÁS BARATOS DE AMAZON!
1. Selecciona la placa y el puerto
Antes de compilar el programa, asegúrate de que Arduino IDE reconoce correctamente tu ESP32.
En la parte superior de la ventana, haz clic en “Seleccionar otra placa y puerto…” (Select other board and port…).
Se abrirá una nueva ventana desde la que podrás:
- Buscar el modelo exacto de tu placa ESP32.
- Seleccionar el puerto serie (COM) al que está conectada.
En este ejemplo utilizaremos la DOIT ESP32 DEVKIT V1, aunque el procedimiento es prácticamente idéntico para cualquier otra placa basada en ESP32.
2. Compila y sube el programa
Una vez seleccionada la placa, pulsa el botón Subir (Upload) de Arduino IDE.
El entorno compilará automáticamente el programa y, si todo está correctamente configurado, lo transferirá al microcontrolador en cuestión de unos segundos.
Al finalizar el proceso aparecerá un mensaje indicando que la carga se ha realizado correctamente y el ESP32 comenzará a ejecutar el programa de inmediato. Si has utilizado el ejemplo del LED, verás cómo este empieza a parpadear de forma continua, confirmando que la instalación y la programación de la placa han sido un éxito.
Importante: algunas placas de desarrollo ESP32 no entran automáticamente en modo de programación (Flash Mode) al intentar cargar un nuevo programa. Si durante la carga observas una sucesión de puntos (
.....) en la consola de Arduino IDE seguida de un mensaje de error, no significa necesariamente que exista un problema con la placa.
En estos casos, simplemente vuelve a pulsar Subir (Upload) y, cuando comiencen a aparecer los puntos en la consola, mantén presionado el botón BOOT de la placa durante unos segundos. El ESP32 entrará en modo de programación y la carga del firmware continuará con normalidad.
Una vez finalizada la transferencia, el microcontrolador comenzará a ejecutar el programa automáticamente. Si has utilizado el ejemplo del LED integrado, comprobarás que este parpadea una vez por segundo, señal de que todo funciona correctamente.
Comprobar el resultado con el Monitor Serie
Además del LED, también puedes verificar el funcionamiento del programa mediante el Monitor Serie de Arduino IDE.
Haz clic en el icono Monitor Serie y configura la velocidad de comunicación en 115200 baudios, que es la utilizada en el ejemplo anterior.
En la consola aparecerán mensajes similares a los siguientes:
LED encendido
LED apagado
LED encendido
LED apagado
...
Si el LED parpadea y estos mensajes se muestran correctamente, significa que:
- El soporte para las placas ESP32 se ha instalado correctamente.
- Arduino IDE reconoce la placa sin problemas.
- La comunicación mediante el puerto serie funciona correctamente.
- El proceso de compilación y carga del firmware se ha realizado con éxito.
Con todo ello, tu entorno de desarrollo ya está completamente configurado y listo para comenzar a crear proyectos con el ESP32.
Solución de problemas frecuentes
Durante la configuración inicial del ESP32 es posible encontrarse con algunos errores habituales. Afortunadamente, la mayoría tienen una solución sencilla.
Error: “Failed to connect to ESP32: Timed out… Connecting…”
Si al intentar cargar un programa aparece un mensaje similar al siguiente:
A fatal error occurred: Failed to connect to ESP32:
Timed out waiting for packet header...
Connecting...
significa que el ESP32 no ha entrado en modo de programación (Flash Mode).
Para solucionarlo, sigue estos pasos:
- Comprueba que has seleccionado correctamente el modelo de placa y el puerto serie (COM) en Arduino IDE.
- Mantén pulsado el botón BOOT del ESP32.
- Pulsa Subir (Upload) en Arduino IDE.
- Cuando aparezca el mensaje “Connecting…” en la consola, suelta el botón BOOT.
- Espera a que finalice la transferencia del programa. Si todo ha ido bien, aparecerá el mensaje “Done uploading”.
En algunas placas será necesario repetir este procedimiento cada vez que cargues un nuevo programa. No obstante, muchos modelos pueden configurarse para entrar automáticamente en modo de programación, evitando tener que pulsar el botón BOOT en cada carga.
Error: “COM Port not found” o “Puerto COM no disponible”
Si Arduino IDE no detecta ningún puerto serie, lo más probable es que el sistema operativo no disponga del controlador adecuado para el conversor USB-Serie integrado en la placa.
Las placas ESP32 suelen incorporar uno de estos chips:
- CP2102 / CP210x
- CH340 / CH341
Comprueba cuál utiliza tu placa e instala el controlador correspondiente. Una vez instalado, desconecta y vuelve a conectar el ESP32 al ordenador. En la mayoría de los casos, el puerto COM aparecerá automáticamente en Arduino IDE.
Otros problemas habituales
Si continúas teniendo dificultades para programar tu ESP32, revisa los siguientes aspectos antes de pensar que la placa está defectuosa:
- Utiliza un cable USB con transferencia de datos; muchos cables solo sirven para cargar dispositivos.
- Comprueba que el puerto USB funciona correctamente.
- Verifica que has seleccionado el modelo de placa adecuado en Arduino IDE.
- Asegúrate de que ningún otro programa está utilizando el mismo puerto serie.
- Si es necesario, reinicia Arduino IDE o desconecta y vuelve a conectar la placa.
La gran mayoría de los problemas de conexión y programación del ESP32 suelen deberse a alguno de estos factores y pueden resolverse en apenas unos minutos.
¡GADGETS ESP32 MÁS BARATOS DE AMAZON!
¿Cómo instalar el complemento LittleFS para ESP32? (opcional)
Una vez configurado el soporte para las placas ESP32 en Arduino IDE 2, es recomendable instalar también el complemento LittleFS Uploader, especialmente si tienes pensado desarrollar proyectos que utilicen archivos almacenados en la memoria Flash del microcontrolador.
LittleFS es un sistema de archivos ligero diseñado para dispositivos embebidos que permite guardar información directamente en la memoria interna del ESP32, como por ejemplo:
- Páginas HTML, CSS y JavaScript para servidores web.
- Archivos de configuración en formato JSON.
- Imágenes, iconos y otros recursos gráficos.
- Certificados SSL/TLS.
- Registros (logs) o cualquier otro tipo de archivo que deba permanecer almacenado incluso después de reiniciar el dispositivo.
El complemento LittleFS Uploader facilita enormemente este proceso, ya que permite copiar todos estos archivos a la memoria Flash del ESP32 directamente desde Arduino IDE, sin necesidad de utilizar herramientas externas o comandos adicionales.
Esta utilidad resulta especialmente útil cuando se desarrollan servidores web, paneles de control para domótica, interfaces de usuario o aplicaciones IoT, donde es habitual almacenar contenido estático dentro del propio microcontrolador.
¡GADGETS ESP32 MÁS BARATOS DE AMAZON!
Conclusión
Con los pasos descritos en esta guía ya dispones de un entorno completamente preparado para desarrollar aplicaciones con ESP32 utilizando Arduino IDE 2, tanto en Windows como en macOS o Linux.
A partir de este punto ya podrás:
- Instalar y configurar cualquier placa ESP32 compatible.
- Compilar y cargar programas desde Arduino IDE.
- Utilizar el Monitor Serie para depurar tus proyectos.
- Aprovechar las bibliotecas y ejemplos oficiales incluidos en el paquete de Espressif.
- Ampliar las posibilidades del entorno instalando herramientas adicionales como LittleFS, ideales para proyectos de servidores web, domótica e Internet de las Cosas (IoT).
Con el entorno ya configurado, solo queda empezar a experimentar y sacar el máximo partido a uno de los microcontroladores más versátiles y populares del mercado.