[{"data":1,"prerenderedAt":738},["ShallowReactive",2],{"post-arduino-ide-vs-platformio-for-esp32-es":3,"related-posts-arduino-ide-vs-platformio-for-esp32-es":692,"related-categories-arduino-ide-vs-platformio-for-esp32-es":721},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":650,"categoryText":651,"dateModified":652,"datePublished":653,"description":654,"extension":655,"faqs":656,"image":675,"imageAlt":676,"language":677,"meta":678,"navigation":679,"path":680,"seo":681,"sitemap":682,"stem":683,"summary":684,"tags":685,"__hash__":691},"blog\u002Fes\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32.md","Arduino IDE vs PlatformIO para ESP32: cuál usar","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":633},"minimark",[12,21,24,29,32,39,44,61,65,82,92,95,174,193,199,203,206,211,224,230,233,237,250,258,265,269,317,321,336,340,349,355,364,378,382,404,426,430,446,466,478,482,491,572,581,585,588,597,610,614,620],[13,14,15,16,20],"p",{},"Para una placa y un sketch, usa Arduino IDE 2. Para un proyecto ESP32 con varias librerías, más de un target de compilación o tests, usa PlatformIO. Los dos compilan tu código contra el core Arduino-ESP32 de Espressif, así que la diferencia real es dónde viven las versiones: en tu equipo en el IDE, y en un archivo ",[17,18,19],"code",{},"platformio.ini"," dentro del proyecto en PlatformIO.",[13,22,23],{},"Compilo con PlatformIO los tres firmwares de OpenGizmo (Gizmo Ticker, Gizmo Reolink Switch y Gizmo Camera), así que esta comparativa se apoya en sus archivos de configuración reales y en la documentación oficial de ambas herramientas, con la fecha en que comprobé cada dato: noviembre de 2026. También cubre las partes incómodas, como el retraso de Arduino-ESP32 3.x que empujó a la gente hacia un fork, y un camino numerado para pasar un sketch a PlatformIO.",[25,26,28],"h2",{"id":27},"cuál-elegir-para-un-proyecto-esp32","¿Cuál elegir para un proyecto ESP32?",[13,30,31],{},"Elige según lo que el proyecto tenga que poder repetir. Si otra persona (o tú dentro de un año) necesita recompilar el mismo firmware desde una computadora limpia, las versiones tienen que estar escritas en el proyecto. Si solo quieres ver parpadear un LED esta noche, no.",[13,33,34],{},[35,36],"img",{"alt":37,"src":38},"Un maker programando un sketch de ESP32 en PlatformIO dentro de VS Code, con main.cpp abierto junto a la barra lateral Home, Libraries y Debug","\u002Fimages\u002Fblog\u002Fgirl-pc-platform-io.png",[40,41],"blog-table",{":headers":42,":rows":43},"[\"Tema\",\"Arduino IDE 2\",\"PlatformIO\"]","[[\"Archivo de proyecto\",\"Una carpeta de sketch con un archivo .ino\",\"platformio.ini más las carpetas src\u002F, test\u002F y lib\u002F\"],[\"Dónde viven las librerías\",\"Se instalan una vez desde el Library Manager y las comparten todos los sketches\",\"Se descargan por proyecto desde lib_deps a la carpeta libdeps\"],[\"Fijar versiones\",\"No en el IDE; los perfiles de Arduino CLI sí\",\"Líneas platform y lib_deps, con versiones exactas, rangos o tags de Git\"],[\"Varios targets\",\"Un solo menú de placa a la vez\",\"Una sección [env:nombre] por target, elegida con -e\"],[\"Línea de comandos\",\"Arduino CLI es una herramienta aparte\",\"pio run, pio test y pio device monitor son la herramienta base\"],[\"Tests unitarios en tu computadora\",\"Ningún test runner que yo haya encontrado en la documentación\",\"pio test con la plataforma native y Unity\"],[\"Frameworks para ESP32\",\"Core Arduino-ESP32\",\"Arduino y ESP-IDF\"],[\"De dónde viene el core de ESP32\",\"El índice del Boards Manager de Espressif\",\"El core incluido en la plataforma espressif32\"]]",[13,45,46,47,54,55,60],{},"Arduino IDE 2.3.11 era la última versión el 12 de noviembre de 2026, y la extensión de PlatformIO para Visual Studio Code incluye PlatformIO Core, así que no hace falta instalar la línea de comandos por separado. Ambos datos salen de las ",[48,49,53],"a",{"href":50,"rel":51},"https:\u002F\u002Fgithub.com\u002Farduino\u002Farduino-ide\u002Freleases",[52],"nofollow","versiones de Arduino IDE"," y de la ",[48,56,59],{"href":57,"rel":58},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fintegration\u002Fide\u002Fvscode.html",[52],"documentación de PlatformIO para VS Code",".",[25,62,64],{"id":63},"cómo-es-un-platformioini-real","¿Cómo es un platformio.ini real?",[13,66,67,68,70,71,75,76,81],{},"Un ",[17,69,19],{}," es el único archivo que dice con qué placa, qué versión de la plataforma y qué librerías se compila un proyecto. Esta es la configuración del firmware de ",[48,72,74],{"href":73},"\u002Fes\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",", copiada de ",[48,77,80],{"href":78,"rel":79},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[52],"microcontroller\u002Fplatformio.ini"," con los comentarios recortados:",[83,84,90],"pre",{"className":85,"code":87,"filename":80,"language":88,"meta":89},[86],"language-ini","[platformio]\ndefault_envs = release\n\n[env:release]\nextra_scripts = pre:firmware_version.py\nboard = seeed_xiao_esp32s3\nplatform = espressif32 @ 8.0.0\nframework = arduino\nboard_build.partitions = huge_app.csv\nbuild_src_flags = -Wformat\nmonitor_speed = 115200\nlib_deps = \n    majicdesigns\u002FMD_Parola@3.7.5\n    majicdesigns\u002FMD_MAX72XX@3.5.1\n    esp32async\u002FESPAsyncWebServer@3.12.1\n    esp32async\u002FAsyncTCP@3.5.0\n    bblanchon\u002FArduinoJson@7.2.2\n    bblanchon\u002FStreamUtils@1.9.2\n    https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-common.git#v2.5.1\n\n[env:debug]\nextends = env:release\nbuild_unflags = -DCORE_DEBUG_LEVEL=0\nbuild_flags =\n    -D PIO_DEV_MODE=1\n    -D CORE_DEBUG_LEVEL=3\n\n[env:native]\nplatform = native@1.2.1\ntest_framework = unity\ntest_build_src = yes\nbuild_src_filter = -\u003C*> +\u003Cserver\u002Fsettings_json.cpp> +\u003Capi\u002Fmarket_refresh.cpp> +\u003Capi\u002Fmarket_data.cpp>\nbuild_flags =\n    -std=gnu++17\n    -D UNITY_INCLUDE_DOUBLE\nlib_deps =\n    throwtheswitch\u002FUnity@2.6.1\n    bblanchon\u002FArduinoJson@7.2.2\n","ini","",[17,91,87],{"__ignoreMap":89},[13,93,94],{},"Línea por línea, esto es lo que hace cada parte:",[96,97,98,121,127,138,147,164],"ul",{},[99,100,101,104,105,110,111,114,115,120],"li",{},[17,102,103],{},"board = seeed_xiao_esp32s3"," selecciona la ",[48,106,109],{"href":107,"rel":108},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fboards\u002Fespressif32\u002Fseeed_xiao_esp32s3.html",[52],"definición de placa Seeed Studio XIAO ESP32-S3",": 240 MHz, 8 MB de memoria flash, 320 KB de RAM. No es la genérica ",[17,112,113],{},"esp32dev",", que es el ",[48,116,119],{"href":117,"rel":118},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fboards\u002Fespressif32\u002Fesp32dev.html",[52],"perfil ESP32 Dev Module"," con 4 MB de flash. Cada variante de ESP32 necesita su propio ID.",[99,122,123,126],{},[17,124,125],{},"platform = espressif32 @ 8.0.0"," fija la toolchain y el core Arduino-ESP32 que incluye. Más sobre esto abajo.",[99,128,129,132,133,137],{},[17,130,131],{},"board_build.partitions = huge_app.csv"," le da a la app un único slot de 3 MB, que uso en todos los firmwares de OpenGizmo porque ninguno hace actualizaciones inalámbricas. El ",[48,134,136],{"href":135},"\u002Fes\u002Fblog\u002Fesp32-partition-table-explained","artículo sobre la tabla de particiones"," explica el compromiso.",[99,139,140,143,144,60],{},[17,141,142],{},"lib_deps"," lista cada librería con una versión exacta. La última línea apunta a un tag de Git de nuestra librería compartida ",[17,145,146],{},"gizmo-common",[99,148,149,152,153,156,157,160,161,60],{},[17,150,151],{},"[env:debug]"," copia ",[17,154,155],{},"release"," con ",[17,158,159],{},"extends"," y sube el nivel de log del core de 0 a 3. El mismo código, otra compilación, elegida con ",[17,162,163],{},"pio run -e debug -t upload",[99,165,166,169,170,173],{},[17,167,168],{},"[env:native]"," compila tres archivos fuente para tu computadora en vez de para la placa, para ejecutar tests. El filtro ",[17,171,172],{},"-\u003C*> +\u003Carchivo>"," dice \"nada excepto estos archivos\".",[13,175,176,177,182,183,188,189,192],{},"Las mismas tres secciones (release, debug, native) están en las configuraciones de ",[48,178,181],{"href":179,"rel":180},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-reolink-switch\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[52],"Reolink Switch"," y ",[48,184,187],{"href":185,"rel":186},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-camera\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[52],"Camera",". La cámara usa ",[17,190,191],{},"board = esp32cam",", que activa su PSRAM para los frame buffers.",[13,194,195],{},[35,196],{"alt":197,"src":198},"Un solo platformio.ini con tres entornos: release compila el firmware de la XIAO ESP32-S3, debug añade los logs del core, native ejecuta tests Unity en la computadora","\u002Fimages\u002Fblog\u002Fes\u002Farduino-ide-vs-platformio-for-esp32-environments.webp",[25,200,202],{"id":201},"dónde-viven-las-librerías-y-cómo-se-fijan-sus-versiones","¿Dónde viven las librerías y cómo se fijan sus versiones?",[13,204,205],{},"Fijar versiones significa escribir junto al código la versión exacta con la que compilaste, para que una compilación del año que viene use la misma librería y el mismo core. Las dos herramientas se diferencian en dónde puede vivir ese registro.",[207,208,210],"h3",{"id":209},"arduino-ide-2-se-instala-una-vez-y-lo-comparten-todos-los-sketches","Arduino IDE 2: se instala una vez y lo comparten todos los sketches",[13,212,213,214,217,218,223],{},"Añades el core de ESP32 pegando la URL del índice de paquetes de Espressif en las preferencias del IDE y luego instalas la plataforma ",[17,215,216],{},"esp32"," desde el Boards Manager, como describe la ",[48,219,222],{"href":220,"rel":221},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Finstalling.html",[52],"guía de instalación de Arduino-ESP32",". Las librerías vienen del Library Manager. Ambos se instalan en el equipo, una sola vez. Si actualizas una librería para un sketch, todos los demás sketches reciben la versión nueva, y nada en la carpeta del sketch registra con qué versión se escribió.",[13,225,226],{},[35,227],{"alt":228,"src":229},"Un maker escribiendo un sketch.ino en Arduino IDE junto a una placa Arduino y una protoboard","\u002Fimages\u002Fblog\u002Fguy-laptop-arduino-ide.png",[13,231,232],{},"Eso está bien para un sketch que terminas en una tarde. Duele cuando la actualización de una librería cambia una API y tienes que recordar cuál de tus proyectos usa qué versión.",[207,234,236],{"id":235},"perfiles-de-sketch-de-arduino-cli-la-respuesta-del-lado-de-arduino","Perfiles de sketch de Arduino CLI: la respuesta del lado de Arduino",[13,238,239,240,245,246,249],{},"El lado de Arduino tiene una respuesta, pero vive en la herramienta de línea de comandos. En Arduino CLI, un ",[48,241,244],{"href":242,"rel":243},"https:\u002F\u002Fdocs.arduino.cc\u002Farduino-cli\u002Fsketch-project-file\u002F",[52],"perfil de sketch"," en un archivo ",[17,247,248],{},"sketch.yaml"," lista la placa, la versión de la plataforma del core y las versiones de las librerías. La documentación de Arduino dice que una compilación con perfil \"is isolated from the system and will rely only on the resources specified in the profile\". Un perfil de ejemplo para la XIAO ESP32-S3:",[83,251,256],{"className":252,"code":254,"filename":248,"language":255,"meta":89},[253],"language-yaml","profiles:\n  release:\n    fqbn: esp32:esp32:XIAO_ESP32S3\n    platforms:\n      - platform: esp32:esp32 (3.3.12)\n        platform_index_url: https:\u002F\u002Fespressif.github.io\u002Farduino-esp32\u002Fpackage_esp32_index.json\n    libraries:\n      - ArduinoJson (7.2.2)\ndefault_profile: release\n","yaml",[17,257,254],{"__ignoreMap":89},[13,259,260,261,264],{},"Lo compilas con ",[17,262,263],{},"arduino-cli compile --profile release",". Esa página documenta la CLI; con ella no pude confirmar que la ventana de Arduino IDE 2 exponga los perfiles, así que considera el IDE solo de instalación global.",[207,266,268],{"id":267},"platformio-las-versiones-viven-en-el-proyecto","PlatformIO: las versiones viven en el proyecto",[13,270,271,272,274,275,278,279,284,285,288,289,294,295,298,299,302,303,306,307,312,313,316],{},"PlatformIO descarga lo que lista ",[17,273,142],{}," en la carpeta ",[17,276,277],{},"libdeps"," del proyecto (el valor por defecto de la ",[48,280,283],{"href":281,"rel":282},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fprojectconf\u002Fsections\u002Fplatformio\u002Foptions\u002Fdirectory\u002Flibdeps_dir.html",[52],"opción libdeps_dir"," es ",[17,286,287],{},"workspace_dir\u002Flibdeps","), así que dos proyectos nunca comparten una librería. La ",[48,290,293],{"href":291,"rel":292},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fprojectconf\u002Fsections\u002Fenv\u002Foptions\u002Flibrary\u002Flib_deps.html",[52],"documentación de lib_deps"," muestra nombres del registro (",[17,296,297],{},"owner\u002Fname","), rangos SemVer como ",[17,300,301],{},"bblanchon\u002FArduinoJson @ ~5.6,!=5.4"," y URLs de Git con un tag (",[17,304,305],{},"...git#v2.0","). OpenGizmo usa versiones exactas y un tag de Git; el ",[48,308,311],{"href":309,"rel":310},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fworkflows\u002Fbuild_and_release.yml",[52],"workflow de release"," incluso instala un PlatformIO Core fijo (",[17,314,315],{},"platformio==6.2.0","), de modo que la CI y un clon nuevo resuelven el mismo conjunto.",[25,318,320],{"id":319},"platformio-es-compatible-con-el-último-core-arduino-esp32","¿PlatformIO es compatible con el último core Arduino-ESP32?",[13,322,323,324,329,330,335],{},"Sí, a noviembre de 2026, pero tardó. La ",[48,325,328],{"href":326,"rel":327},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fplatforms\u002Fespressif32.html",[52],"plataforma espressif32"," de PlatformIO incluye un core Arduino-ESP32, y la ",[48,331,334],{"href":332,"rel":333},"https:\u002F\u002Fgithub.com\u002Fplatformio\u002Fplatform-espressif32\u002Freleases",[52],"página de versiones de la plataforma"," muestra cuál:",[40,337],{":headers":338,":rows":339},"[\"Versión de espressif32\",\"Fecha\",\"Core Arduino-ESP32\"]","[[\"6.13.0\",\"26 feb\",\"2.0.17\"],[\"7.0.0 a 7.1.0\",\"del 30 abr al 31 ago\",\"2.0.17\"],[\"8.0.0\",\"19 oct\",\"3.3.12\"]]",[13,341,342,343,348],{},"Así que durante toda la línea 7.x la plataforma oficial se quedó en el core 2.0.17, mientras el índice del Boards Manager de Espressif ya había pasado a la 3.x. Ese desfase es la razón por la que la ",[48,344,347],{"href":345,"rel":346},"https:\u002F\u002Fgithub.com\u002Fpioarduino\u002Fplatform-espressif32",[52],"plataforma comunitaria pioarduino",", un fork de la oficial, se hizo popular. La usas reemplazando la línea platform por una URL:",[83,350,353],{"className":351,"code":352,"language":88,"meta":89},[86],"platform = https:\u002F\u002Fgithub.com\u002Fpioarduino\u002Fplatform-espressif32\u002Freleases\u002Fdownload\u002Fstable\u002Fplatform-espressif32.zip\n",[17,354,352],{"__ignoreMap":89},[13,356,357,358,363],{},"Su versión stable también incluye ahora Arduino 3.3.12, y añade extras como un modo de compilación híbrido para chips que el core de Arduino no cubre. Como la 8.0.0 oficial ya se puso al día, yo me quedaría con la plataforma oficial, salvo que necesites alguno de esos extras. Las ",[48,359,362],{"href":360,"rel":361},"https:\u002F\u002Fgithub.com\u002Fplatformio\u002Fplatform-espressif32\u002Freleases\u002Ftag\u002Fv8.0.0",[52],"notas de la versión 8.0.0"," también advierten que Arduino-ESP32 3.x no tiene la refactorización completa de Bluetooth prevista para la v4.0.",[13,365,366,367,370,371,374,375,377],{},"De ahí salen dos reglas prácticas. Fija la plataforma (",[17,368,369],{},"espressif32 @ 8.0.0",", o ",[17,372,373],{},"~8.0.0"," para aceptar versiones de parche), porque subir la plataforma es subir el core, y pasar del core 2 al core 3 cambia las API. Y lee la página de la versión antes de actualizar. Los tres repositorios de OpenGizmo fijan ",[17,376,369],{},", así que compilan sobre el core 3.3.12.",[25,379,381],{"id":380},"cómo-se-comparan-las-opciones-de-depuración","¿Cómo se comparan las opciones de depuración?",[13,383,384,385,388,389,391,392,395,396,398,399,60],{},"La mayor parte de la depuración en ESP32 es logging con ",[17,386,387],{},"Serial",", y ambas herramientas lo hacen. La diferencia con PlatformIO es que el nivel de log es un perfil de compilación: ",[17,390,163],{}," seguido de ",[17,393,394],{},"pio device monitor"," te da el firmware del ticker con los mensajes propios del core activados, y ",[17,397,155],{}," mantiene el log serial apagado. El README del ticker documenta ",[48,400,403],{"href":401,"rel":402},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker#build-profiles",[52],"los tres perfiles de compilación",[13,405,406,407,411,412,415,416,419,420,425],{},"La depuración por hardware (breakpoints y ejecución paso a paso) necesita un probe. La ",[48,408,410],{"href":107,"rel":409},[52],"página de la XIAO ESP32-S3"," de PlatformIO dice que la placa no tiene un probe de depuración integrado y no está lista para depurar, y lista herramientas externas que eliges con la opción ",[17,413,414],{},"debug_tool",", entre ellas ",[17,417,418],{},"esp-builtin",". Arduino IDE 2 tiene su propio ",[48,421,424],{"href":422,"rel":423},"https:\u002F\u002Fdocs.arduino.cc\u002Fsoftware\u002Fide-v2\u002Ftutorials\u002Fide-v2-debugger",[52],"depurador","; en su documentación no pude confirmar que las placas ESP32 estén cubiertas, así que compruébalo antes de comprar un probe. Yo no uso un depurador por hardware en los firmwares de OpenGizmo: me apoyo en el perfil debug y en el log serial.",[25,427,429],{"id":428},"se-puede-probar-el-código-del-esp32-sin-una-placa","¿Se puede probar el código del ESP32 sin una placa?",[13,431,432,433,438,439,441,442,445],{},"Si la lógica no toca el hardware, sí. Los ",[48,434,437],{"href":435,"rel":436},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fadvanced\u002Funit-testing\u002Findex.html",[52],"tests unitarios"," de PlatformIO pueden ejecutar los mismos tests en tu computadora (la plataforma native) o en una placa conectada, con frameworks como Unity. En la configuración de arriba, ",[17,440,168],{}," compila solo tres archivos, y ",[17,443,444],{},"pio test -e native"," los ejecuta:",[96,447,448,454,460],{},[99,449,450,453],{},[17,451,452],{},"server\u002Fsettings_json.cpp",", la correspondencia entre los ajustes y el JSON de la API web",[99,455,456,459],{},[17,457,458],{},"api\u002Fmarket_refresh.cpp",", que decide cuándo volver a pedir los precios",[99,461,462,465],{},[17,463,464],{},"api\u002Fmarket_data.cpp",", que lee la respuesta de CoinGecko",[13,467,468,469,474,475,477],{},"Esos tests viven en ",[48,470,473],{"href":471,"rel":472},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Ftree\u002Fmain\u002Fmicrocontroller\u002Ftest",[52],"microcontroller\u002Ftest\u002F",", y el workflow de release ejecuta ",[17,476,444],{}," antes de compilar el firmware. El límite es real: los tests native cubren la lógica que compila en un PC. Todo lo que hable con la matriz, el Wi-Fi o la memoria flash sigue necesitando una placa. En la documentación de Arduino IDE 2 no encontré un test runner, así que de ese lado tendrías que probar a mano en la placa o automatizarlo con otra herramienta.",[25,479,481],{"id":480},"cómo-se-pasa-un-sketch-de-arduino-a-platformio","¿Cómo se pasa un sketch de Arduino a PlatformIO?",[13,483,484,485,490],{},"Un sketch de un solo archivo se convierte en unos pocos pasos. Las reglas de conversión vienen de la ",[48,486,489],{"href":487,"rel":488},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Ffaq\u002Fino-to-cpp.html",[52],"guía ino to cpp"," de PlatformIO.",[492,493,494,497,512,529,541,555,562],"ol",{},[99,495,496],{},"Instala Visual Studio Code y luego la extensión PlatformIO IDE desde la vista Extensions. Incluye PlatformIO Core.",[99,498,499,500,503,504,506,507,182,509,60],{},"En PlatformIO Home elige New Project, selecciona tu placa (",[17,501,502],{},"seeed_xiao_esp32s3"," para una XIAO ESP32-S3, ",[17,505,113],{}," para un ESP32 DevKit clásico) y el framework Arduino. Obtienes un ",[17,508,19],{},[17,510,511],{},"src\u002Fmain.cpp",[99,513,514,515,517,518,521,522,525,526,60],{},"Pega tu sketch en ",[17,516,511],{},". Añade ",[17,519,520],{},"#include \u003CArduino.h>"," arriba y declara cada función propia antes de llamarla. No declares ",[17,523,524],{},"setup"," ni ",[17,527,528],{},"loop",[99,530,531,532,534,535,537,538,60],{},"Pasa cada librería a ",[17,533,142],{},". Busca en el PlatformIO Registry, copia la forma ",[17,536,297],{}," y añade la versión que usabas, por ejemplo ",[17,539,540],{},"bblanchon\u002FArduinoJson@7.2.2",[99,542,543,544,546,547,550,551,554],{},"Fija la plataforma: ",[17,545,125],{},". Traslada las opciones del menú Tools que importaban, como el esquema de particiones (",[17,548,549],{},"board_build.partitions",") y la velocidad serial (",[17,552,553],{},"monitor_speed = 115200",").",[99,556,557,558,561],{},"Ejecuta ",[17,559,560],{},"pio run",". Corrige prototipos o includes que falten hasta que la compilación termine bien.",[99,563,564,565,568,569,571],{},"Conecta la placa y ejecuta ",[17,566,567],{},"pio run -t upload",", luego ",[17,570,394],{}," para leer la salida serial.",[13,573,574,575,577,578,580],{},"Cuando funcione, añade un ",[17,576,151],{}," que use ",[17,579,159],{}," sobre tu entorno principal, como en el ejemplo de arriba. Es la mejora más barata que te da el cambio.",[25,582,584],{"id":583},"qué-te-cuesta-platformio-y-cuándo-gana-arduino-ide","¿Qué te cuesta PlatformIO y cuándo gana Arduino IDE?",[13,586,587],{},"La objeción más fuerte a PlatformIO es su coste de arranque. Aprendes un archivo ini, una estructura de carpetas y unos cuantos comandos antes del primer parpadeo, y la experiencia del editor depende de una extensión de VS Code. Las actualizaciones de core y plataforma son explícitas, lo cual es bueno para la repetibilidad y significa que te toca leer las notas de cada versión. Para un solo sketch, nada de eso se amortiza.",[13,589,590,591,596],{},"Arduino IDE 2 gana cuando el proyecto es un sketch en una placa, cuando sigues un tutorial escrito para él, o cuando quieres el core más nuevo de Espressif directo del índice del Boards Manager el día que sale. Su ",[48,592,595],{"href":593,"rel":594},"https:\u002F\u002Fdocs.arduino.cc\u002Fsoftware\u002Fide\u002F",[52],"documentación"," es el mejor punto de partida para la primera semana.",[13,598,599,600,604,605,609],{},"Hay también una tercera respuesta: saltarte los dos. ",[48,601,603],{"href":602},"\u002Fes\u002Fblog\u002Fwhat-is-opengizmo","Los proyectos de OpenGizmo"," traen firmware ya compilado que flasheas desde el navegador, y la ",[48,606,608],{"href":607},"\u002Fes\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","guía de ESP Web Tools"," explica cómo. Solo necesitas una toolchain para cambiar el código.",[25,611,613],{"id":612},"entonces-con-cuál-empezar","Entonces, ¿con cuál empezar?",[13,615,616,617,619],{},"Empieza con Arduino IDE 2 si quieres una primera carga hoy. Pasa a PlatformIO cuando te descubras queriendo un segundo perfil de placa, un test o poder recompilar una versión antigua. La conversión del sketch de arriba es corta, y ",[17,618,142],{}," más una plataforma fijada te dan compilaciones que siguen funcionando.",[13,621,622,623,627,628,632],{},"Lo que comprobé: los archivos de configuración de los tres repositorios de firmware de OpenGizmo, las notas de versión de espressif32 y la documentación oficial enlazada arriba, a noviembre de 2026. Lo que no comprobé: si el depurador de Arduino IDE 2 funciona con placas ESP32, y si su interfaz gráfica expone los perfiles de sketch. Después, lee la ",[48,624,626],{"href":625},"\u002Fes\u002Fblog\u002Fxiao-esp32s3-pinout-safe-pins","guía del pinout de la XIAO ESP32-S3"," para la placa que usan estas configuraciones, o la ",[48,629,631],{"href":630},"\u002Fes\u002Fblog\u002Fhow-to-build-a-crypto-ticker-with-esp32-and-max7219","guía para construir Gizmo Ticker"," para ver el proyecto completo construido con este setup.",{"title":89,"searchDepth":634,"depth":634,"links":635},2,[636,637,638,644,645,646,647,648,649],{"id":27,"depth":634,"text":28},{"id":63,"depth":634,"text":64},{"id":201,"depth":634,"text":202,"children":639},[640,642,643],{"id":209,"depth":641,"text":210},3,{"id":235,"depth":641,"text":236},{"id":267,"depth":641,"text":268},{"id":319,"depth":634,"text":320},{"id":380,"depth":634,"text":381},{"id":428,"depth":634,"text":429},{"id":480,"depth":634,"text":481},{"id":583,"depth":634,"text":584},{"id":612,"depth":634,"text":613},"comparisons","Comparativas","2026-11-14T00:00:00Z","2026-06-25T00:00:00Z","¿Arduino IDE 2 o PlatformIO para ESP32? Comparativa de versiones de librerías, Arduino-ESP32 3.x, depuración y tests, con el platformio.ini de Gizmo Ticker.","md",[657,660,663,666,669,672],{"question":658,"answer":659},"¿PlatformIO es mejor que Arduino IDE para ESP32?","Para proyectos con varias librerías, más de un target de compilación o tests, sí: PlatformIO guarda las versiones de plataforma, placa y librerías en un archivo platformio.ini dentro del proyecto. Para un solo sketch en una sola placa, Arduino IDE 2 es más rápido de arrancar y tiene menos partes móviles.",{"question":661,"answer":662},"¿PlatformIO es compatible con el core Arduino-ESP32 3.x?","Sí, a noviembre de 2026. La plataforma oficial espressif32 8.0.0, publicada el 19 de octubre, incluye Arduino-ESP32 3.3.12. Las versiones 7.x anteriores incluían el core 2.0.17, y por eso la plataforma comunitaria pioarduino se hizo popular. Fija la versión de la plataforma y revisa qué incluye antes de actualizar.",{"question":664,"answer":665},"¿PlatformIO puede usar librerías de Arduino?","Sí. PlatformIO compila los proyectos ESP32 sobre el core Arduino-ESP32, así que las librerías de Arduino funcionan. Las declaras en lib_deps, por nombre del registro como bblanchon\u002FArduinoJson @ 7.2.2 o con una URL de Git, y PlatformIO las descarga dentro del proyecto en vez de en una carpeta global compartida.",{"question":667,"answer":668},"¿Cómo fijo las versiones de las librerías en Arduino IDE?","El IDE instala cores y librerías una sola vez para todo el equipo, así que una versión sirve a todos los sketches. Para fijar versiones por sketch usa los perfiles de Arduino CLI: un archivo sketch.yaml lista las versiones del core y de las librerías, y la compilación ignora todo lo demás que tengas instalado.",{"question":670,"answer":671},"¿Puedo probar código de ESP32 sin una placa?","Sí, si el código no toca el hardware. La plataforma native de PlatformIO compila los archivos fuente que elijas para tu computadora y ejecuta tests Unity con pio test -e native. Gizmo Ticker lo hace con el JSON de ajustes y el análisis de datos de mercado, y su CI corre los tests antes de compilar el firmware.",{"question":673,"answer":674},"¿Puedo flashear un ESP32 sin instalar ninguna de las dos herramientas?","Sí. Si un proyecto publica firmware ya compilado, ESP Web Tools lo flashea desde Chrome o Edge por USB sin instalar ninguna toolchain. Solo necesitas Arduino IDE o PlatformIO cuando quieras cambiar el código, añadir librerías o compilar tu propio firmware.","\u002Fimages\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32.png","Una infografía que compara Arduino IDE y PlatformIO, con sus interfaces de desarrollo y una placa ESP32.","es",{},true,"\u002Fes\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32",{"title":5,"description":654},{"loc":680},"es\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Usa Arduino IDE 2 para una placa y un sketch. Usa PlatformIO cuando librerías, targets o tests necesiten versiones fijas: su platformio.ini guarda cada versión en el proyecto, no en tu equipo.",[686,687,688,689,690],"ESP32","Arduino IDE","PlatformIO","Development Tools","Firmware","THz176gPe9gQ9ZMzVqxsHzw1IimO-UZjoEvPrvy4Zpw",[693,701,709,716],{"title":694,"description":695,"image":696,"categoryText":651,"categorySlug":650,"tags":697,"path":700},"ESPHome o firmware propio en ESP32: cuál usar","¿ESPHome o firmware propio en ESP32? Una tabla para decidir, lo que ESPHome no puede hacer y por qué OpenGizmo usa PlatformIO para su app web y su MCP.","\u002Fimages\u002Fblog\u002Fesphome-vs-custom-esp32-firmware.jpg",[686,690,698,688,699],"Home Automation","OpenGizmo","\u002Fes\u002Fblog\u002Fesphome-vs-custom-esp32-firmware",{"title":702,"description":703,"image":704,"categoryText":705,"categorySlug":706,"tags":707,"path":607},"ESP Web Tools: flashear un ESP32 desde el navegador","Flashea un ESP32 desde el navegador con ESP Web Tools o esptool-js: cómo funcionan Web Serial, el manifest y los offsets, con un manifest real de OpenGizmo.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg","Guías","guides",[686,690,689,699,708],"Embedded Systems",{"title":710,"description":711,"image":712,"categoryText":705,"categorySlug":706,"tags":713,"path":715},"ESP32-CAM-MB: programa la ESP32-CAM por USB","Cómo programar una ESP32-CAM con la placa USB ESP32-CAM-MB: qué incluye, la secuencia de botones IO0 y RST, flashear desde Chrome y qué suele fallar.","\u002Fimages\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide.jpg",[714,686,690,689,699],"ESP32-CAM","\u002Fes\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide",{"title":717,"description":718,"image":719,"categoryText":705,"categorySlug":706,"tags":720,"path":135},"Tabla de particiones ESP32: mapa de la flash y OTA","Qué es la tabla de particiones del ESP32, cómo leer las columnas de partitions.csv, los esquemas de Arduino-ESP32 con sus tamaños y qué significa N16R8.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg",[686,690,708,688,699],[722,726,732],{"name":705,"slug":706,"path":723,"count":724,"image":725},"\u002Fblog\u002Fcategories\u002Fguides",11,"\u002Fimages\u002Fblog\u002Fcoingecko-api-esp32-rate-limits.jpg",{"name":727,"slug":728,"path":729,"count":730,"image":731},"Proyectos","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":733,"slug":734,"path":735,"count":736,"image":737},"Solución de problemas","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",1795018241110]