[{"data":1,"prerenderedAt":784},["ShallowReactive",2],{"post-esp-web-tools-flash-esp32-from-browser-es":3,"related-posts-esp-web-tools-flash-esp32-from-browser-es":728,"related-categories-esp-web-tools-flash-esp32-from-browser-es":756,"blog-project-detail-card-gizmo-ticker-es":775},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":688,"categoryText":689,"dateModified":690,"datePublished":690,"description":691,"extension":692,"faqs":693,"image":712,"imageAlt":713,"language":714,"meta":715,"navigation":716,"path":717,"seo":718,"sitemap":719,"stem":720,"summary":721,"tags":722,"__hash__":727},"blog\u002Fes\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.md","ESP Web Tools: flashear un ESP32 desde el navegador","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":675},"minimark",[12,16,30,37,42,57,60,63,79,94,102,113,117,120,125,138,151,155,163,171,174,178,193,197,204,209,252,256,274,278,290,296,313,324,332,387,390,424,437,443,447,450,477,481,491,516,520,532,538,578,581,622,637,641,644,648,656,660,663],[13,14,15],"p",{},"Sí, puedes flashear un ESP32 desde el navegador. ESP Web Tools, o cualquier página construida sobre esptool-js de Espressif, habla con la placa mediante la Web Serial API: abres una página HTTPS en Chrome o Edge en un equipo de escritorio, conectas un cable USB de datos, eliges el puerto serie y pulsas un botón.",[13,17,18,19,23,24,29],{},"En esta guía te explico cómo funciona ESP Web Tools (Web Serial, el ",[20,21,22],"code",{},"manifest.json",", los offsets) y luego cómo los tres dispositivos de ",[25,26,28],"a",{"href":27},"\u002Fes\u002Fblog\u002Fwhat-is-opengizmo","OpenGizmo"," usan la misma idea, con un manifest real alojado en una CDN. Un detalle antes de empezar: la web de OpenGizmo no incrusta el botón de ESP Web Tools. Usa esptool-js directamente, y te cuento por qué.",[13,31,32],{},[33,34],"img",{"alt":35,"src":36},"Los cuatro pasos del flasheo desde el navegador: elegir el puerto USB con Web Serial, identificar el chip, elegir su build en el manifest y escribir las partes en sus offsets","\u002Fimages\u002Fblog\u002Fes\u002Fesp-web-tools-flash-esp32-from-browser-steps.webp",[38,39,41],"h2",{"id":40},"cómo-funciona-esp-web-tools","¿Cómo funciona ESP Web Tools?",[13,43,44,50,51,56],{},[25,45,49],{"href":46,"rel":47},"https:\u002F\u002Fesphome.github.io\u002Fesp-web-tools\u002F",[48],"nofollow","ESP Web Tools"," es un componente web de código abierto del proyecto ESPHome (Open Home Foundation) que añade a cualquier página un botón para instalar firmware en ESP8266 y ESP32. Su propia web dice que funciona combinando ",[25,52,55],{"href":53,"rel":54},"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Serial_API",[48],"Web Serial",", Improv Wi-Fi (opcional) y un manifest que describe el firmware.",[13,58,59],{},"Espera, ¿qué es Web Serial? Es una API del navegador que permite a una página leer y escribir en dispositivos serie, incluidos los USB que exponen un puerto serie virtual, que es lo que hace una placa de desarrollo ESP32. El navegador muestra un selector de puerto y lo eliges tú, así que una página no puede abrir un dispositivo a tus espaldas.",[13,61,62],{},"Esto es lo que pasa cuando alguien pulsa el botón:",[64,65,66,70,73,76],"ol",{},[67,68,69],"li",{},"El navegador pide al usuario que elija un puerto serie.",[67,71,72],{},"La herramienta se conecta al bootloader ROM del chip y lo detecta. Según la documentación, después elige automáticamente del manifest la variante de firmware correcta.",[67,74,75],{},"Descarga las partes de esa build y escribe cada una en su offset.",[67,77,78],{},"Opcionalmente, espera a Improv Serial para conocer el estado del dispositivo y ofrecer la configuración del Wi-Fi.",[13,80,81,82,87,88,93],{},"El flasheo en sí no se ha reinventado. A noviembre de 2026, el ",[25,83,86],{"href":84,"rel":85},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002Fpackage.json",[48],"paquete de ESP Web Tools"," (versión 10.5.x) depende de ",[25,89,92],{"href":90,"rel":91},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js",[48],"esptool-js",", el port a JavaScript de esptool de Espressif, además del SDK serie de Improv. Por eso las dos herramientas se comportan de forma parecida.",[13,95,96,97,101],{},"Añadir el botón a tu página lleva dos fragmentos de código, ambos de las ",[25,98,100],{"href":46,"rel":99},[48],"instrucciones oficiales",": cargas el script, luego pones el elemento y lo apuntas a tu manifest.",[103,104,111],"pre",{"className":105,"code":107,"filename":108,"language":109,"meta":110},[106],"language-html","\u003Cscript type=\"module\" src=\"https:\u002F\u002Funpkg.com\u002Fesp-web-tools@10\u002Fdist\u002Fweb\u002Finstall-button.js?module\">\u003C\u002Fscript>\n\n\u003Cesp-web-install-button manifest=\"https:\u002F\u002Fexample.com\u002Ffirmware\u002Fmanifest.json\">\u003C\u002Fesp-web-install-button>\n","index.html","html","",[20,112,107],{"__ignoreMap":110},[38,114,116],{"id":115},"qué-navegadores-lo-admiten-y-por-qué-https","¿Qué navegadores lo admiten y por qué HTTPS?",[13,118,119],{},"Web Serial solo existe en contextos seguros, así que la página con el botón debe servirse por HTTPS. ESP Web Tools lo indica como requisito de Web Serial. Además, el navegador tiene que implementar la API, y ese es el límite real.",[121,122],"blog-table",{":headers":123,":rows":124},"[\"Navegador\",\"Web Serial\",\"Nota\"]","[[\"Chrome (escritorio)\",\"Sí, desde la versión 89\",\"esptool-js documenta Chrome y Edge 89 o posterior\"],[\"Edge (escritorio)\",\"Sí, desde la versión 89\",\"Igual que Chrome en los datos de compatibilidad de MDN\"],[\"Chrome en Android\",\"Sí, desde la versión 148\",\"Las versiones 138 a 147 solo veían puertos serie Bluetooth\"],[\"Firefox (escritorio)\",\"Sí, desde la versión 151\",\"Datos de MDN. No lo he probado\"],[\"Firefox en Android\",\"No\",\"Datos de MDN\"],[\"Safari, cualquier navegador en iOS\",\"No\",\"Datos de MDN. ESP Web Tools también dice que iOS no\"]]",[13,126,127,128,133,134,137],{},"Las versiones salen de los ",[25,129,132],{"href":130,"rel":131},"https:\u002F\u002Fgithub.com\u002Fmdn\u002Fbrowser-compat-data\u002Fblob\u002Fmain\u002Fapi\u002FSerial.json",[48],"datos de compatibilidad de navegadores de MDN"," a noviembre de 2026, y la propia MDN marca la función como no Baseline. Solo he comprobado el comportamiento del flasheador de OpenGizmo en el código, no en cada navegador. Su tarjeta muestra \"No se puede flashear desde este navegador\" cuando falta ",[20,135,136],{},"navigator.serial"," o la página no es un contexto seguro.",[13,139,140,141,145,146,150],{},"Si usas Safari o un teléfono, flashea una vez con una herramienta instalada en una computadora: mira ",[25,142,144],{"href":143},"\u002Fes\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs PlatformIO para ESP32"," o, para la ESP32-CAM, la ",[25,147,149],{"href":148},"\u002Fes\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide","guía del programador ESP32-CAM-MB",".",[38,152,154],{"id":153},"cómo-se-escribe-el-manifest-y-se-eligen-los-offsets","¿Cómo se escribe el manifest y se eligen los offsets?",[13,156,157,158,162],{},"Un manifest es un pequeño archivo JSON que le dice al flasheador qué firmware instalar en qué chip. Cada build lista los archivos (partes) que hay que escribir y el offset de flash de cada uno. Este es el más pequeño que sirve, en el formato de la ",[25,159,161],{"href":46,"rel":160},[48],"documentación de ESP Web Tools",":",[103,164,169],{"className":165,"code":167,"filename":22,"language":168,"meta":110},[166],"language-json","{\n  \"name\": \"My Firmware\",\n  \"version\": \"1.0.0\",\n  \"builds\": [\n    {\n      \"chipFamily\": \"ESP32-S3\",\n      \"parts\": [{ \"path\": \"merged-firmware.bin\", \"offset\": 0 }]\n    }\n  ]\n}\n","json",[20,170,167],{"__ignoreMap":110},[13,172,173],{},"Las rutas de las partes se resuelven respecto al manifest y también pueden ser URL completas en otros hosts. Los campos que más te vas a encontrar:",[121,175],{":headers":176,":rows":177},"[\"Clave\",\"Dónde\",\"Qué hace\"]","[[\"name, version\",\"nivel superior\",\"Se muestran en la interfaz. El nombre se compara con el firmware que el dispositivo comunica por Improv\"],[\"builds[].chipFamily\",\"build\",\"ESP8266, ESP32, ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61, ESP32-H2, ESP32-P4, ESP32-S2 o ESP32-S3\"],[\"builds[].parts[]\",\"build\",\"La ruta de un archivo y el offset de flash entero en el que escribirlo\"],[\"builds[].serialType\",\"build\",\"cdc o uart: una build aparte para USB nativo o para un puente USB-UART\"],[\"new_install_prompt_erase\",\"nivel superior\",\"true deja que el usuario elija borrar todo en una instalación nueva\"],[\"new_install_improv_wait_time\",\"nivel superior\",\"Segundos de espera de una respuesta de Improv tras instalar (10 por defecto, 0 desactiva Improv)\"],[\"home_assistant_domain, funding_url\",\"nivel superior\",\"Enlaces opcionales que se muestran tras la instalación\"]]",[13,179,180,181,186,187,192],{},"Los offsets dependen del chip y de cómo compilaste el firmware. Para un firmware dividido en cuatro archivos, la documentación de ESP-IDF coloca el ",[25,182,185],{"href":183,"rel":184},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[48],"bootloader de segunda etapa en 0x1000 en el ESP32"," y ",[25,188,191],{"href":189,"rel":190},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32s3\u002Fapi-guides\u002Fbootloader.html",[48],"en 0x0 en el ESP32-S3",". La página del S3 también coloca la tabla de particiones en 0x8000 por defecto. En las builds de PlatformIO que publico, la imagen boot_app0 va en 0xE000 y la app en 0x10000. Nunca los adivines: léelos de tu build, como hace la siguiente sección.",[38,194,196],{"id":195},"necesitas-un-archivo-de-firmware-unido-merged","¿Necesitas un archivo de firmware unido (merged)?",[13,198,199,200,203],{},"Para un ESP32 compilado con ESP-IDF 4 o posterior, la documentación de ESP Web Tools dice que sí. El motivo que dan: cuando los cuatro archivos se instalan con el comando esptool, esptool ajusta la frecuencia, el tamaño y el modo de la flash al dispositivo de destino, y ESP Web Tools no puede hacerlo sobre la marcha. Así que creas una sola imagen con ",[20,201,202],{},"merge_bin"," y la listas en el offset 0.",[205,206],"terminal",{":commands":207,"title":208},"[\"esptool --chip esp32 merge_bin -o merged-firmware.bin --flash_mode dio --flash_freq 40m --flash_size 4MB 0x1000 bootloader.bin 0x8000 partitions.bin 0xe000 boot.bin 0x10000 your_app.bin\"]","Une las cuatro partes (comando de la documentación de ESP Web Tools)",[13,210,211,212,217,218,221,222,225,226,229,230,233,234,237,238,241,242,245,246,251],{},"Las partes separadas también pueden funcionar: el manifest de ejemplo del ",[25,213,216],{"href":214,"rel":215},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002FREADME.md",[48],"README de ESP Web Tools"," lista cuatro archivos, con un bootloader llamado ",[20,219,220],{},"bootloader_dout_40m.bin"," cuyos ajustes de flash ya se habían elegido al compilar. Unir es la ruta documentada cuando partes de una build normal. La documentación añade dos advertencias: usa ",[20,223,224],{},"dout"," cuando tu tipo de memoria sea ",[20,227,228],{},"opi_opi"," u ",[20,231,232],{},"opi_qspi",", y cambia ",[20,235,236],{},"qio"," o ",[20,239,240],{},"qout"," por ",[20,243,244],{},"dio",". El archivo unido tiene un precio que conviene conocer. La ",[25,247,250],{"href":248,"rel":249},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[48],"documentación de esptool"," dice que en el formato raw los huecos entre archivos se rellenan con bytes 0xFF, el valor de la flash borrada. Una imagen unida cubre, por tanto, todo el rango desde el bootloader hasta la app, incluida la zona de ajustes entre la tabla de particiones y boot_app0. Tenlo presente para la sección de actualizaciones.",[38,253,255],{"id":254},"cómo-flashea-opengizmo-desde-el-navegador-sin-el-componente-web","¿Cómo flashea OpenGizmo desde el navegador sin el componente web?",[13,257,258,259,262,263,186,266,269,270,273],{},"Cada página de proyecto de OpenGizmo tiene una tarjeta de firmware que no es el elemento de ESP Web Tools. Es el componente ",[20,260,261],{},"app\u002Fcomponents\u002Fprojects\u002FFlashFirmware.vue"," del código fuente del sitio, que importa ",[20,264,265],{},"ESPLoader",[20,267,268],{},"Transport"," de esptool-js (versión 0.7.1 en el ",[20,271,272],{},"package.json"," del sitio) y lee un manifest en el formato de ESP Web Tools. El formato es, pues, el mismo; solo cambia el front end.",[275,276],"project-detail-card",{"project-slug":277},"gizmo-ticker",[13,279,280,281,285,286,289],{},"Este es el manifest real que lee la tarjeta del ",[25,282,284],{"href":283},"\u002Fes\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",", en ",[20,287,288],{},"https:\u002F\u002Fcdn.opengizmo.dev\u002Fgizmo-ticker\u002Fmanifest.json"," (descargado el 14 de noviembre de 2026):",[103,291,294],{"className":292,"code":293,"filename":22,"language":168,"meta":110},[166],"{\n  \"name\": \"Gizmo Ticker\",\n  \"version\": \"v1.2.0\",\n  \"new_install_prompt_erase\": false,\n  \"builds\": [\n    {\n      \"chipFamily\": \"ESP32-S3\",\n      \"parts\": [\n        { \"path\": \"v1.2.0\u002Frelease-bootloader.bin\", \"offset\": 0 },\n        { \"path\": \"v1.2.0\u002Frelease-partitions.bin\", \"offset\": 32768 },\n        { \"path\": \"v1.2.0\u002Frelease-boot_app0.bin\", \"offset\": 57344 },\n        { \"path\": \"v1.2.0\u002Frelease-firmware.bin\", \"offset\": 65536 }\n      ]\n    }\n  ]\n}\n",[20,295,293],{"__ignoreMap":110},[13,297,298,299,303,304,308,309,312],{},"Los offsets son decimales, como exige JSON: 32768 es 0x8000, 57344 es 0xE000, 65536 es 0x10000. El manifest del ",[25,300,302],{"href":301},"\u002Fes\u002Fprojects\u002Fgizmo-reolink-switch","Gizmo Reolink Switch"," tiene las mismas cuatro partes en el mismo chip. El manifest de la ",[25,305,307],{"href":306},"\u002Fes\u002Fprojects\u002Fgizmo-camera","Gizmo Camera"," tiene ",[20,310,311],{},"\"chipFamily\": \"ESP32\""," y su bootloader en 4096 (0x1000), como indica la página de ESP-IDF de antes. Los demás offsets son iguales.",[13,314,315,316,319,320,323],{},"Una clave de estos manifests es solo para el componente oficial: ",[20,317,318],{},"new_install_prompt_erase: false",". La tarjeta de OpenGizmo nunca la lee. ESP Web Tools trataría ",[20,321,322],{},"false"," como su valor por defecto, que es borrar todos los datos en una instalación nueva.",[13,325,326,327,331],{},"Cuando pulsas ",[328,329,330],"strong",{},"Flashear firmware",", la tarjeta hace esto, por este orden:",[64,333,334,341,348,355,358,384],{},[67,335,336,337,340],{},"Llama a ",[20,338,339],{},"navigator.serial.requestPort()"," y se conecta con esptool-js a 115200 baudios, lo que identifica el chip.",[67,342,343,344,347],{},"Descarga el manifest con ",[20,345,346],{},"cache: 'no-store'",", para que una versión nueva aparezca al instante.",[67,349,350,351,354],{},"Busca la build cuyo ",[20,352,353],{},"chipFamily"," coincide con el nombre del chip detectado. Si no hay ninguna, se detiene con \"Este firmware no está compilado para el chip conectado\", así que una imagen de ESP32 nunca acaba en un ESP32-S3.",[67,356,357],{},"Descarga las cuatro partes una por una, resolviendo cada ruta respecto a la URL del manifest.",[67,359,336,360,363,364,367,368,186,371,374,375,367,378,186,381,150],{},[20,361,362],{},"writeFlash"," con ",[20,365,366],{},"flashMode",", ",[20,369,370],{},"flashFreq",[20,372,373],{},"flashSize"," en ",[20,376,377],{},"'keep'",[20,379,380],{},"eraseAll: false",[20,382,383],{},"compress: true",[67,385,386],{},"Reinicia la placa.",[13,388,389],{},"¿Por qué no usar el componente web? Puedo señalar tres cosas en el código, y no he probado el botón oficial con estos manifests, así que no puedo decirte cómo se comportaría:",[391,392,393,408,418],"ul",{},[67,394,395,398,399,401,402,407],{},[328,396,397],{},"Las cuatro partes siguen separadas."," Con ",[20,400,377],{},", esptool-js ",[25,403,406],{"href":404,"rel":405},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js\u002Fblob\u002Fmain\u002Fsrc\u002Fesploader.ts",[48],"deja la cabecera del bootloader tal como la generó la build",", así que no hace falta ningún paso de unión. Y las partes se saltan la zona de ajustes, que un archivo unido sobrescribiría.",[67,409,410,413,414,417],{},[328,411,412],{},"Un arreglo del reinicio."," Un comentario en ",[20,415,416],{},"app\u002Futils\u002FhardReset.js"," del sitio dice que esptool-js solo libera RTS, lo cual no hace nada cuando la línea ya está liberada, como ocurre con el USB propio del chip en el ESP32-S3. La placa se quedaba en el bootloader hasta que la desenchufabas. El sitio pasa su propio reinicio: DTR liberado, RTS mantenido 100 ms y luego liberado.",[67,419,420,423],{},[328,421,422],{},"Una tarjeta a medida."," Muestra la versión antes de flashear, cuatro etapas (conectar, descargar, flashear, reiniciar), un log, las notas de la versión que instala y mensajes traducidos.",[13,425,426,427,431,432,436],{},"El firmware no tiene soporte de Improv: no encontré código de Improv en los tres repositorios. La primera configuración del Wi-Fi pasa en cambio por un portal cautivo. La ",[25,428,430],{"href":429},"\u002Fes\u002Fblog\u002Fesp32-wifi-provisioning-methods-compared","comparativa de métodos de provisioning Wi-Fi"," cubre Improv frente a las alternativas, y la ",[25,433,435],{"href":434},"\u002Fes\u002Fblog\u002Fesp32-captive-portal-not-working-fix","guía para arreglar el portal cautivo"," cubre el portal.",[13,438,439],{},[33,440],{"alt":441,"src":442},"Las cuatro partes que flashea el Gizmo Ticker y sus offsets, con la zona de ajustes en 0x9000 intacta","\u002Fimages\u002Fblog\u002Fes\u002Fesp-web-tools-flash-esp32-from-browser-flash-map.webp",[38,444,446],{"id":445},"cuál-es-el-camino-más-corto-hasta-tu-propia-página-de-instalación","¿Cuál es el camino más corto hasta tu propia página de instalación?",[13,448,449],{},"Este es todo el trabajo, en orden, para tu propio firmware:",[64,451,452,455,461,471,474],{},[67,453,454],{},"Compila el firmware y reúne sus partes con sus offsets (o un solo archivo unido en el offset 0 para ESP Web Tools).",[67,456,457,458,460],{},"Sube las partes y un ",[20,459,22],{}," que las liste a un host HTTPS, con cabeceras CORS si no es el mismo sitio de la página.",[67,462,463,464,186,467,470],{},"Añade el fragmento ",[20,465,466],{},"\u003Cscript>",[20,468,469],{},"\u003Cesp-web-install-button>"," de arriba a una página HTTPS, con la URL del manifest.",[67,472,473],{},"Abre la página en Chrome o Edge en un equipo de escritorio, conecta la placa con un cable de datos, pulsa el botón y elige el puerto.",[67,475,476],{},"Comprueba que la placa arranca tu firmware y que la página ofrece la build correcta para cada chip que listes.",[38,478,480],{"id":479},"dónde-alojar-el-firmware-y-qué-pasa-con-cors","¿Dónde alojar el firmware y qué pasa con CORS?",[13,482,483,484,487,488,150],{},"Puedes alojar el manifest y las partes en el mismo sitio que la página de instalación, y entonces no hace falta configurar CORS. OpenGizmo los guarda en una CDN (",[20,485,486],{},"cdn.opengizmo.dev",", respaldada por un bucket de Cloudflare R2 en el workflow de publicación), así que el navegador hace peticiones entre orígenes distintos. En ese caso, ESP Web Tools te dice que envíes ",[20,489,490],{},"Access-Control-Allow-Origin: https:\u002F\u002Fdomain-of-your-website.com",[13,492,493,494,497,498,186,501,504,505,508,509,512,513,150],{},"Lo comprobé el 14 de noviembre de 2026 pidiendo el manifest del Ticker con ",[20,495,496],{},"Origin: https:\u002F\u002Fopengizmo.dev",": la respuesta incluía ",[20,499,500],{},"access-control-allow-origin: https:\u002F\u002Fopengizmo.dev",[20,502,503],{},"vary: Origin",", y una petición preflight devolvió 204 con ",[20,506,507],{},"access-control-allow-methods: GET",". La CDN solo permite el origen del sitio, no ",[20,510,511],{},"*",". Prueba la tuya con ",[20,514,515],{},"curl -I -H \"Origin: https:\u002F\u002Fyour.site\" \u003Cmanifest-url>",[38,517,519],{"id":518},"cómo-publicas-una-versión-nueva-sin-perder-los-ajustes-de-wi-fi","¿Cómo publicas una versión nueva sin perder los ajustes de Wi-Fi?",[13,521,522,523,528,529,162],{},"Guarda los archivos de cada versión en su propia carpeta, no los modifiques nunca y mueve el manifest al final. El ",[25,524,527],{"href":525,"rel":526},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fworkflows\u002Fbuild_and_release.yml",[48],"workflow de publicación"," de OpenGizmo lo hace así, con una ejecución manual desde ",[20,530,531],{},"main",[13,533,534],{},[33,535],{"alt":536,"src":537},"Un navegador muestra la memoria flash escrita en cuatro partes naranjas mientras una parte gris queda bloqueada e intacta, con una XIAO conectada por USB-C","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser-illustration.webp",[64,539,540,547,550,565,568],{},[67,541,542,543,546],{},"Lee ",[20,544,545],{},"VERSION"," y se detiene si el tag ya existe o si la versión de la aplicación web es distinta.",[67,548,549],{},"Ejecuta las pruebas de la aplicación web y las pruebas nativas del firmware, y luego compila el firmware.",[67,551,552,553,558,559,562,563,150],{},"Ejecuta ",[25,554,557],{"href":555,"rel":556},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fscripts\u002Fpackage_firmware.py",[48],"package_firmware.py",", que le pide a PlatformIO las imágenes de flash y sus offsets (",[20,560,561],{},"pio project metadata",") y escribe ",[20,564,22],{},[67,566,567],{},"Crea una release de GitHub con las partes, cuyas notas incluyen un comando esptool para flashear por USB.",[67,569,570,571,574,575,150],{},"Sube las partes con ",[20,572,573],{},"Cache-Control: public, max-age=31536000, immutable"," y después el manifest con ",[20,576,577],{},"max-age=60",[13,579,580],{},"Subir el manifest al final significa que la web solo ofrece una versión subida por completo, y una caché de un minuto hace que una release aparezca en menos de un minuto. Las cabeceras que vi el 14 de noviembre de 2026 coinciden con esto.",[13,582,583,584,587,588,593,594,597,598,601,602,604,605,608,609,611,612,616,617,621],{},"Los ajustes sobreviven por lo que no se escribe. Los proyectos usan la tabla de particiones ",[20,585,586],{},"huge_app.csv",", en la que el ",[25,589,592],{"href":590,"rel":591},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fhuge_app.csv",[48],"core de Arduino define"," ",[20,595,596],{},"nvs"," en 0x9000 (0x5000 bytes) y ",[20,599,600],{},"otadata"," en 0xE000. Las cuatro partes no cubren la región ",[20,603,596],{}," (de 0x9000 a 0xDFFF) y ",[20,606,607],{},"eraseAll"," es ",[20,610,322],{},", así que los datos de Preferences se conservan. Eso se deduce de los offsets y del código: no medí una flash antes y después. La ",[25,613,615],{"href":614},"\u002Fes\u002Fblog\u002Fesp32-partition-table-explained","guía de la tabla de particiones"," explica la distribución, y la ",[25,618,620],{"href":619},"\u002Fes\u002Fblog\u002Fesp32-ota-update-methods-compared","comparativa de OTA"," explica por qué estos dispositivos se actualizan por USB, ya que no tienen un segundo slot de aplicación.",[13,623,624,625,628,629,632,633,636],{},"Con el componente oficial, lee bien la regla de borrado: ESP Web Tools borra todos los datos en una instalación nueva, salvo que ",[20,626,627],{},"new_install_prompt_erase"," sea ",[20,630,631],{},"true"," y el usuario rechace. Ofrece una instalación nueva cuando no puede detectar el firmware actual del dispositivo, o cuando el firmware detectado no coincide con el ",[20,634,635],{},"name"," del manifest.",[38,638,640],{"id":639},"qué-falla-con-más-frecuencia","¿Qué falla con más frecuencia?",[13,642,643],{},"La mayoría de los fallos son del cable, del puerto o del navegador, no del firmware. Recorre esta tabla de arriba abajo, cambiando una sola cosa cada vez.",[121,645],{":headers":646,":rows":647},"[\"Lo que ves\",\"Causa probable\",\"Qué probar\"]","[[\"Botón desactivado, o 'No se puede flashear desde este navegador'\",\"Navegador sin Web Serial, o la página no usa HTTPS\",\"Usa Chrome o Edge en escritorio, por HTTPS o localhost\"],[\"El selector de puerto no muestra ningún dispositivo\",\"Cable USB solo de carga, o la placa no se detecta\",\"Usa un cable de datos y otro puerto USB, y recarga la página\"],[\"Falla la conexión, no se reciben datos serie\",\"El chip no está en modo descarga, o el enlace USB es inestable\",\"Mira la guía de 'Failed to connect'\"],[\"'Este firmware no está compilado para el chip conectado'\",\"El manifest no tiene una build para esa familia de chip\",\"Añade una build para él, o usa la placa correcta\"],[\"'La descarga del firmware falló con el estado 404'\",\"La ruta de una parte en el manifest es incorrecta\",\"Abre la URL de cada parte en una pestaña\"],[\"No se puede leer el manifest, con un error de CORS en la consola\",\"La CDN no permite el origen de tu página\",\"Envía Access-Control-Allow-Origin para tu dominio\"],[\"El flasheo termina pero la placa se queda en el bootloader\",\"No hay un pulso de reinicio real tras flashear\",\"Desenchufa y vuelve a enchufar; un hard reset propio como el de arriba lo arregla\"]]",[13,649,650,651,655],{},"Para la tercera fila, ",[25,652,654],{"href":653},"\u002Fes\u002Fblog\u002Fesp32-failed-to-connect-no-serial-data-received","Failed to Connect to ESP32: No Serial Data Received"," repasa el modo de arranque, los cables y los drivers. Los textos de error de la tabla son los del archivo de traducciones de la tarjeta de OpenGizmo, y tu propia página dirá otra cosa.",[38,657,659],{"id":658},"dónde-se-acaba-el-flasheo-desde-el-navegador","¿Dónde se acaba el flasheo desde el navegador?",[13,661,662],{},"El flasheo desde el navegador te da una página donde cualquiera con Chrome o Edge, un cable y una placa puede instalar tu firmware en un minuto, con los ajustes conservados y un número de versión en pantalla. Hemos visto las piezas: Web Serial sobre HTTPS, un manifest de partes y offsets (unido para ESP Web Tools, o cuatro partes con esptool-js), CORS si los archivos están en otro sitio y una release que sube el manifest al final.",[13,664,665,666,669,670,674],{},"Quedan tres límites. Solo cubre el flasheo por cable; para actualizar por Wi-Fi mira la ",[25,667,668],{"href":619},"comparativa de métodos OTA",". El soporte de navegadores fuera de Chrome y Edge es escaso a noviembre de 2026, y no he probado ninguno. Y el componente oficial solo lo he descrito a partir de su documentación y su código, no de haberlo usado yo. Si quieres ver todo funcionando, la ",[25,671,673],{"href":672},"\u002Fes\u002Fblog\u002Fhow-to-build-a-crypto-ticker-with-esp32-and-max7219","guía de montaje del Gizmo Ticker"," flashea una placa de principio a fin, y las tres páginas de proyecto tienen cada una la tarjeta.",{"title":110,"searchDepth":676,"depth":676,"links":677},2,[678,679,680,681,682,683,684,685,686,687],{"id":40,"depth":676,"text":41},{"id":115,"depth":676,"text":116},{"id":153,"depth":676,"text":154},{"id":195,"depth":676,"text":196},{"id":254,"depth":676,"text":255},{"id":445,"depth":676,"text":446},{"id":479,"depth":676,"text":480},{"id":518,"depth":676,"text":519},{"id":639,"depth":676,"text":640},{"id":658,"depth":676,"text":659},"guides","Guías","2026-11-14T00:00:00Z","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.","md",[694,697,700,703,706,709],{"question":695,"answer":696},"¿Puedo flashear un ESP32 desde el navegador sin instalar nada?","Sí. Una página que usa ESP Web Tools o esptool-js habla con la placa mediante la Web Serial API, así que solo necesitas un cable USB de datos y Chrome o Edge en un equipo de escritorio. La página debe servirse por HTTPS. Eliges el puerto serie y el firmware se escribe desde el navegador.",{"question":698,"answer":699},"¿ESP Web Tools funciona en Firefox o Safari?","ESP Web Tools indica como compatibles Firefox, Chrome, Edge y Chrome en Android, pero no iOS. Los datos de compatibilidad de MDN muestran Web Serial en Firefox desde la versión 151 en escritorio, y en Safari no existe. Chrome y Edge siguen siendo la opción segura, y los demás no los he probado.",{"question":701,"answer":702},"¿Necesito un archivo de firmware unido (merged) para ESP Web Tools?","La documentación de ESP Web Tools dice que el firmware de ESP32 compilado con ESP-IDF 4 o posterior debe unirse en un solo archivo, porque la herramienta no puede ajustar el modo, la frecuencia y el tamaño de la flash como hace esptool. Lo creas con esptool merge_bin y lo listas como una sola parte en el offset 0.",{"question":704,"answer":705},"¿Flashear desde el navegador borra los ajustes de Wi-Fi?","Solo si el flasheador los borra. ESP Web Tools borra todos los datos en una instalación nueva, salvo que el manifest ponga new_install_prompt_erase en true y tú rechaces. El flasheador de OpenGizmo escribe cuatro partes y nunca borra el chip entero, así que los ajustes de la partición NVS sobreviven a una actualización.",{"question":707,"answer":708},"¿Qué es Improv Wi-Fi?","Improv Wi-Fi es un estándar abierto para enviar las credenciales de Wi-Fi a un dispositivo por su puerto serie. Si el firmware lo admite, ESP Web Tools pide conectar el dispositivo a una red justo después de instalar. Un firmware sin Improv, como el de OpenGizmo, usa en cambio un portal cautivo para ese paso.",{"question":710,"answer":711},"¿Por qué flashear desde el navegador necesita HTTPS?","La Web Serial API solo está disponible en contextos seguros, así que la página con el botón de instalación debe servirse por HTTPS (localhost también cuenta como seguro). Una página HTTP normal no puede abrir un puerto serie. Si el manifest y el firmware están en otro host, ese host también debe enviar cabeceras CORS.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg","Un hombre con barba y sudadera azul está junto a una laptop cuyo navegador muestra un botón Install naranja y una barra al 68 %, con un cable USB hasta una placa ESP32.","es",{},true,"\u002Fes\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser",{"title":5,"description":691},{"loc":717},"es\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","ESP Web Tools flashea un ESP32 por Web Serial, en Chrome o Edge y desde una página HTTPS, con un manifest.json que lista cada parte del firmware y su offset. OpenGizmo hace lo mismo con esptool-js.",[723,724,725,28,726],"ESP32","Firmware","Development Tools","Embedded Systems","jlstlMoZpdzQmsPL8OUPd6uBfwftrgwhP-vduJ8Et-g",[729,735,741,749],{"title":730,"description":731,"image":732,"categoryText":689,"categorySlug":688,"tags":733,"path":148},"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",[734,723,724,725,28],"ESP32-CAM",{"title":736,"description":737,"image":738,"categoryText":689,"categorySlug":688,"tags":739,"path":614},"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",[723,724,726,740,28],"PlatformIO",{"title":742,"description":743,"image":744,"categoryText":689,"categorySlug":688,"tags":745,"path":748},"API de CoinGecko en ESP32: límites gratis y frecuencia","El plan Demo gratis de CoinGecko: 100 llamadas\u002Fmin y 10.000 al mes. Cada cuánto consultar con un ESP32, cómo enviar la clave y qué es el error 429.","\u002Fimages\u002Fblog\u002Fcoingecko-api-esp32-rate-limits.jpg",[723,746,724,28,747],"IoT","MAX7219","\u002Fes\u002Fblog\u002Fcoingecko-api-esp32-rate-limits",{"title":750,"description":751,"image":752,"categoryText":689,"categorySlug":688,"tags":753,"path":27},"¿Qué es OpenGizmo? Gadgets ESP32 open source para flashear","OpenGizmo es un conjunto de gadgets ESP32 con licencia MIT de Mauro Brambilla: un ticker cripto con LED, un interruptor para NVR Reolink y una ESP32-CAM.","\u002Fimages\u002Fblog\u002Fwhat-is-open-gizmo.png",[28,754,723,724,755],"Open Source","3D Printing",[757,763,769],{"name":758,"slug":759,"path":760,"count":761,"image":762},"Proyectos","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":764,"slug":765,"path":766,"count":767,"image":768},"Comparativas","comparisons","\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",{"name":770,"slug":771,"path":772,"count":773,"image":774},"Solución de problemas","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"title":284,"badge":776,"description":777,"path":283,"image":778,"cardIcon":779,"highlights":780},"Proyecto open source ESP32 + MAX7219","Un display de criptomonedas con Wi-Fi, construido con un ESP32, una matriz LED MAX7219 y una aplicación web Nuxt 4 para configurarlo desde el navegador.","\u002Fimages\u002Fprojects\u002Fgizmo-ticker\u002Fcover.webp","BitcoinIcon",[781,782,783],"Ticker cripto en tiempo real","Matriz LED MAX7219","Configuración desde el navegador",1795018241885]