Blog
Instalar ESP32: placas, IDEs y librerías
Instalar el paquete de placas ESP32 y sus librerías en el Arduino IDE y en VS Code — las preguntas de configuración que frenan a la gente antes del primer blink.
¿Cómo instalar el ESP32?
Instala el paquete de placas y el IDE conoce el chip. En Arduino IDE: File → Preferences, pega https://dl.espressif.com/dl/package_esp32_index.json en “Additional Boards Manager URLs,” luego Tools → Board → Boards Manager, busca “esp32” e instala “esp32 by Espressif Systems.” Un solo paquete cubre el WROOM-32D, el S3 y el C3. En mi máquina Windows la primera instalación tardó unos cuatro minutos; las siguientes van más rápido porque el compilador queda en caché. Reinicia el IDE después — la lista de placas se refresca al reiniciar, y saltarse ese paso es por lo que la gente cree que la instalación falló. El FAQ del Arduino IDE tiene el mismo recorrido con las trampas señaladas.
¿Cómo añadir ESP32 a Arduino?
“Añadir” e “instalar” son la misma operación: añades una placa instalando su paquete desde Boards Manager. Pega la URL JSON de Espressif en Additional Boards Manager URLs, instala, y reinicia — ese reinicio resuelve la mitad de los reportes de “todavía no aparece”.
¿Cómo instalar ESP32 en Arduino?
Quiere decir lo mismo que “añadir”: el paquete de placas de Espressif define todas las variantes del ESP32. Cuando aterrice, verifica con Tools → Board → ESP32 Arduino → ESP32 Dev Module. ¿Falta el submenú? Reinstala y reinicia antes de tocar nada más.
¿Cómo instalar ESP32 en Arduino 2.0?
El Arduino IDE 2.x conserva el mismo campo Additional Boards Manager URLs en File → Preferences. La 2.x muestra el progreso por paquete e instala versiones en paralelo. Los paquetes viejos hacen sombra a los nuevos, así que desinstala la entrada ESP32 antigua antes de actualizar desde la 1.8.x. En general funciona bien una vez que lo sabes.
¿Cómo instalar librerías de ESP32?
Sketch → Include Library → Manage Libraries, busca, instala — las librerías se instalan por IDE, no por placa. El core ESP32 trae incluidas (WiFi, BLE, esp32-hal), así que los errores de “library not found” suelen ser una ruta de include que falta, no una instalación fallida. Las librerías de terceros aparecen en cuanto el paquete de placas está presente.
¿Cómo hacer funcionar VS Code con ESP32?
Dos rutas. La extensión PlatformIO: instálala, crea un proyecto, elige “Espressif ESP32 Dev Module” como placa, y el toolchain se descarga en el primer build — es la ruta que uso a diario; las librerías van por proyecto. O la extensión de Arduino más el paquete de placas que ya instalaste. El primer build baja ~500 MB de toolchain, lo que parece un cuelgue en conexiones lentas; no lo es, espera. El FAQ de PlatformIO cubre la estructura de proyectos.
¿Por qué la instalación falla en “Downloading packages”?
Normalmente es la red, no los archivos — los proxies y las VPN cortan la descarga a mitad, y el IDE reintenta desde cero. Soluciones: limpia la carpeta de staging y reintenta; cambia a cable; quita el proxy; o instala manualmente. La vía manual difiere según la versión del IDE y la documentación oficial es vaga al respecto, así que la mayoría reintenta por red.
¿Necesito VS Code y el Arduino IDE a la vez?
No. Elige uno. El Arduino IDE es la vía más suave; PlatformIO es la vía de ingeniería, con mejor depuración y librerías por proyecto. El código es el mismo C++ de cualquier manera.
¿Y si instalo MicroPython en su lugar?
Instalación distinta, mismo hardware: borra el flash con esptool y luego escribe el binario de firmware MicroPython en la dirección 0x1000. El paquete de placas de Arduino deja de importar desde ese momento — MicroPython no usa el toolchain de Arduino para nada. Buena opción si prefieres Python, con cobertura de librerías de sensores más pobre como contrapartida. Depende de tu proyecto, la verdad.
La instalación funcionó — ¿y ahora qué?
Blink. Sube el sketch Blink, mira el monitor serie y luego cablea un LED a GPIO2. Ese bucle — instalar, flashear, imprimir — es la mayor parte de lo que “instalar” significa en la práctica, y el FAQ de flasheo es la vía de recuperación cuando deje de funcionar más adelante.
Los proyectos de este tema se ejecutan directamente en el simulador gratuito de sensbench: circuito preconectado, firmware incluido, sin cuenta y sin instalación.