Blog
ESP32 PlatformIO: configuración, portado y depuración
Cómo usar platformio con esp32 sin el dolor habitual — config de la Freenove ESP32-S3 breakout, portar sketches de Arduino, depurar cuando nada compila.
¿Cómo usar PlatformIO con ESP32?
Instala la extensión PlatformIO en VS Code, crea un proyecto y escribe un archivo platformio.ini — esa es toda la configuración. PlatformIO envuelve el mismo toolchain de Espressif, pero fija cada versión. Mi primer pio run descargó el toolchain espressif32 entero y compiló sin un solo paso manual; el mismo sketch me había costado una tarde en el IDE.
¿Qué contiene realmente un archivo platformio.ini?
Tres líneas cubren la mayoría de proyectos: [env:esp32dev], platform = espressif32 y board = esp32dev. Añade framework = arduino y monitor_speed = 115200. Todo lo demás es opcional hasta que deja de serlo.
¿Cómo configurar PlatformIO para la Freenove ESP32-S3 breakout?
No hace falta config personalizada para la mayoría de placas Freenove S3 — el registro trae un alias como freenove_esp32_s3_wroom, así que pon board = freenove_esp32_s3_wroom y el resto se rellena solo. Dos cosas atrapan a la gente sea cual sea el alias: el puerto USB nativo del S3 necesita el upload_port correcto — elige el puerto que aparece al conectarla — y el LED RGB onboard está en GPIO 48 en la mayoría de variantes Freenove. El alias exacto depende de la revisión de tu placa. Nuestra base de conocimiento mantiene la tabla Freenove actual.
¿Cómo depurar ESP32 con PlatformIO?
Empieza con pio run -t upload y luego pio device monitor — los logs serie son el 90% de la depuración ESP32. Breakpoints reales quieren un ESP-Prog por JTAG, o un S3 con depuración USB nativa; los devkits WROOM normales funcionan casi todos con un clon barato de ESP-Prog, pero la documentación oficial es vaga sobre qué clones negocian el handshake. Cuando esptool reporte Failed to connect to ESP32: timed out waiting for packet header, mantén BOOT durante la subida — ese error es un problema de modo, no un chip muerto. El FAQ de depuración cubre el resto.
¿Cómo portar mi proyecto Arduino ESP32 a PlatformIO?
Crea una carpeta de proyecto, añade platformio.ini con framework = arduino y renombra el .ino a src/main.cpp — PlatformIO compila C++ puro, así que el envoltorio de Arduino desaparece. setup() y loop() se quedan igual. Las librerías van a lib_deps, como lib_deps = bblanchon/ArduinoJson@^7.
¿Cómo portar mi proyecto Arduino ESP32 a PlatformIO sin perder ajustes?
Haz copia de tres cosas antes de moverte: los ajustes de placa y flash que expresarías en platformio.ini, tu carpeta lib/ y cualquier carpeta data/ que se envíe con pio run -t uploadfs. El sketch es portable; lo que se pierde son las credenciales Wi-Fi en archivos de config y los layouts de particiones hardcodeados. Muévelos al ini (board_build.partitions) y a un config ignorado por git. Ejecuta pio pkg list primero para que las versiones coincidan.
¿Por qué mi monitor serie está lleno de basura?
Desajuste de baudios, casi seguro — el ESP32 arranca su ROM a 115200, así que cualquier otra tasa imprime galimatías. Una vez perdí una hora con 74880 en un ESP8266 antes de darme cuenta de que PlatformIO había heredado un monitor_speed equivocado; pon monitor_speed = 115200 y sale limpio.
¿Cómo hacer pio monitor a un dispositivo ESP32?
Ejecuta pio device list y luego pio device monitor — así se hace pio monitor a un dispositivo esp32. En Linux, únete al grupo dialout; en Windows, instala el driver CH340 o CP2102 o el puerto nunca aparece.
¿Funcionará PlatformIO con el dev module ESP32?
Sí — la respuesta corta a “will platformio work with the esp32 dev module” es que esp32dev es el valor por defecto para el devkit WROOM clásico. Los clones con LEDs o tamaños de flash distintos sobreescriben esos dos ajustes.
¿Cómo configurar PlatformIO para ESP32 a la manera rápida?
La mayoría de guías de “how to setup platformio for esp32” asumen VS Code, pero la CLI funciona sola: pio project init --board esp32dev crea un proyecto funcional al instante. Itera en el simulador del navegador y luego flashea la placa real.
Los proyectos de este tema se ejecutan directamente en el simulador gratuito de sensbench: circuito preconectado, firmware incluido, sin cuenta y sin instalación.