[{"data":1,"prerenderedAt":782},["ShallowReactive",2],{"post-esp-web-tools-flash-esp32-from-browser-it":3,"related-posts-esp-web-tools-flash-esp32-from-browser-it":726,"related-categories-esp-web-tools-flash-esp32-from-browser-it":754,"blog-project-detail-card-gizmo-ticker-it":773},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":686,"categoryText":687,"dateModified":688,"datePublished":688,"description":689,"extension":690,"faqs":691,"image":710,"imageAlt":711,"language":712,"meta":713,"navigation":714,"path":715,"seo":716,"sitemap":717,"stem":718,"summary":719,"tags":720,"__hash__":725},"blog\u002Fit\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.md","ESP Web Tools: flashare un ESP32 dal browser","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":673},"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,251,255,273,277,289,295,312,323,331,385,388,422,435,441,445,448,475,479,489,514,518,530,536,576,579,620,635,639,642,646,654,658,661],[13,14,15],"p",{},"Sì, un ESP32 si può flashare da un browser. ESP Web Tools, o qualunque pagina costruita su esptool-js di Espressif, parla con la scheda tramite la Web Serial API: apri una pagina HTTPS in Chrome o Edge su desktop, colleghi un cavo USB dati, scegli la porta seriale e premi un pulsante.",[13,17,18,19,23,24,29],{},"In questa guida ti spiego come funziona ESP Web Tools (Web Serial, il ",[20,21,22],"code",{},"manifest.json",", gli offset) e poi come i tre dispositivi ",[25,26,28],"a",{"href":27},"\u002Fit\u002Fblog\u002Fwhat-is-opengizmo","OpenGizmo"," usano la stessa idea, con un manifest reale ospitato su una CDN. Un dettaglio subito: il sito di OpenGizmo non incorpora il pulsante di ESP Web Tools. Usa direttamente esptool-js, e ti mostro perché.",[13,31,32],{},[33,34],"img",{"alt":35,"src":36},"I quattro passi del flash da browser: scegli la porta USB con Web Serial, identifica il chip, scegli la sua build nel manifest, scrivi le parti ai loro offset","\u002Fimages\u002Fblog\u002Fit\u002Fesp-web-tools-flash-esp32-from-browser-steps.webp",[38,39,41],"h2",{"id":40},"come-funziona-esp-web-tools","Come funziona 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"," è un web component open source del progetto ESPHome (Open Home Foundation) che aggiunge a qualsiasi pagina web un pulsante per installare il firmware su ESP8266 e ESP32. Il suo sito dice che funziona 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 (opzionale) e un manifest che descrive il firmware.",[13,58,59],{},"Un momento, che cos'è Web Serial? È un'API del browser che permette a una pagina di leggere e scrivere su dispositivi seriali, compresi quelli USB che espongono una porta seriale virtuale, come fa una scheda di sviluppo ESP32. Il browser mostra un selettore di porta e la scegli tu, quindi una pagina non può aprire un dispositivo di nascosto.",[13,61,62],{},"Ecco cosa succede quando qualcuno preme il pulsante:",[64,65,66,70,73,76],"ol",{},[67,68,69],"li",{},"Il browser chiede all'utente di scegliere una porta seriale.",[67,71,72],{},"Lo strumento si collega al bootloader ROM del chip e lo riconosce. Secondo la documentazione, sceglie poi in automatico dal manifest la variante di firmware giusta.",[67,74,75],{},"Scarica le parti di quella build e scrive ciascuna al suo offset.",[67,77,78],{},"Se serve, aspetta Improv Serial per conoscere lo stato del dispositivo e proporre la configurazione del Wi-Fi.",[13,80,81,82,87,88,93],{},"Il flash vero e proprio non è stato reinventato. A novembre 2026, il ",[25,83,86],{"href":84,"rel":85},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002Fpackage.json",[48],"pacchetto ESP Web Tools"," (versione 10.5.x) dipende da ",[25,89,92],{"href":90,"rel":91},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js",[48],"esptool-js",", il port JavaScript di esptool di Espressif, oltre all'SDK seriale di Improv. Ecco perché i due strumenti si comportano in modo simile.",[13,95,96,97,101],{},"Aggiungere il pulsante alla tua pagina richiede due snippet, entrambi dalle ",[25,98,100],{"href":46,"rel":99},[48],"istruzioni ufficiali",": carichi lo script, poi inserisci l'elemento e lo punti al tuo 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},"quali-browser-lo-supportano-e-perché-https","Quali browser lo supportano, e perché HTTPS?",[13,118,119],{},"Web Serial esiste solo in contesti sicuri, quindi la pagina con il pulsante deve essere servita in HTTPS. ESP Web Tools lo indica come requisito di Web Serial. Poi il browser deve implementare l'API, ed è questo il vero limite.",[121,122],"blog-table",{":headers":123,":rows":124},"[\"Browser\",\"Web Serial\",\"Nota\"]","[[\"Chrome (desktop)\",\"Sì, dalla versione 89\",\"esptool-js indica Chrome ed Edge 89 o successivi\"],[\"Edge (desktop)\",\"Sì, dalla versione 89\",\"Uguale a Chrome nei dati di compatibilità di MDN\"],[\"Chrome su Android\",\"Sì, dalla versione 148\",\"Le versioni da 138 a 147 vedevano solo porte seriali Bluetooth\"],[\"Firefox (desktop)\",\"Sì, dalla versione 151\",\"Dati MDN. Non l'ho provato\"],[\"Firefox su Android\",\"No\",\"Dati MDN\"],[\"Safari, qualsiasi browser su iOS\",\"No\",\"Dati MDN. Anche ESP Web Tools dice: non iOS\"]]",[13,126,127,128,133,134,137],{},"Le versioni vengono dai ",[25,129,132],{"href":130,"rel":131},"https:\u002F\u002Fgithub.com\u002Fmdn\u002Fbrowser-compat-data\u002Fblob\u002Fmain\u002Fapi\u002FSerial.json",[48],"dati di compatibilità dei browser di MDN"," a novembre 2026, e MDN stessa segna la funzione come non Baseline. Ho verificato il comportamento del flasher di OpenGizmo solo nel codice, non browser per browser. La sua card mostra \"Flash non disponibile da questo browser\" quando ",[20,135,136],{},"navigator.serial"," manca o la pagina non è un contesto sicuro.",[13,139,140,141,145,146,150],{},"Se usi Safari o uno smartphone, flasha una volta con uno strumento installato su un computer: vedi ",[25,142,144],{"href":143},"\u002Fit\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs PlatformIO per ESP32"," oppure, per la ESP32-CAM, la ",[25,147,149],{"href":148},"\u002Fit\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide","guida al programmatore ESP32-CAM-MB",".",[38,152,154],{"id":153},"come-si-scrive-il-manifest-e-si-scelgono-gli-offset","Come si scrive il manifest e si scelgono gli offset?",[13,156,157,158,162],{},"Un manifest è un piccolo file JSON che dice al flasher quale firmware installare su quale chip. Ogni build elenca i file (le parti) da scrivere e l'offset in flash di ciascuno. Questo è il più piccolo manifest utile, nel formato della ",[25,159,161],{"href":46,"rel":160},[48],"documentazione di 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],{},"I percorsi delle parti sono risolti rispetto al manifest e possono anche essere URL completi su altri host. I campi che incontrerai più spesso:",[121,175],{":headers":176,":rows":177},"[\"Chiave\",\"Dove\",\"Cosa fa\"]","[[\"name, version\",\"livello principale\",\"Compaiono nell'interfaccia. Il nome viene confrontato con il firmware che il dispositivo comunica tramite 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\",\"Il percorso di un file e l'offset di flash intero a cui scriverlo\"],[\"builds[].serialType\",\"build\",\"cdc o uart: una build separata per l'USB nativa o per un bridge USB-UART\"],[\"new_install_prompt_erase\",\"livello principale\",\"true permette all'utente di scegliere se cancellare tutto a una nuova installazione\"],[\"new_install_improv_wait_time\",\"livello principale\",\"Secondi di attesa per una risposta Improv dopo l'installazione (10 di default, 0 disattiva Improv)\"],[\"home_assistant_domain, funding_url\",\"livello principale\",\"Link opzionali mostrati dopo l'installazione\"]]",[13,179,180,181,186,187,192],{},"Gli offset dipendono dal chip e da come hai compilato il firmware. Per un firmware diviso in quattro file, la documentazione di ESP-IDF mette il ",[25,182,185],{"href":183,"rel":184},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[48],"bootloader di secondo stadio a 0x1000 sull'ESP32"," e ",[25,188,191],{"href":189,"rel":190},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32s3\u002Fapi-guides\u002Fbootloader.html",[48],"a 0x0 sull'ESP32-S3",". La pagina dell'S3 mette anche la tabella delle partizioni a 0x8000 di default. Nelle build PlatformIO che distribuisco, l'immagine boot_app0 sta a 0xE000 e l'app a 0x10000. Non andare a intuito: leggili dalla tua build, come fa la prossima sezione.",[38,194,196],{"id":195},"serve-un-file-firmware-unico-merged","Serve un file firmware unico (merged)?",[13,198,199,200,203],{},"Per un ESP32 compilato con ESP-IDF 4 o successivo, la documentazione di ESP Web Tools dice di sì. Il motivo che danno: quando i quattro file si installano con il comando esptool, esptool corregge frequenza, dimensione e modalità della flash in base al dispositivo di destinazione, e ESP Web Tools non può farlo al volo. Quindi crei un'unica immagine con ",[20,201,202],{},"merge_bin"," e la elenchi a 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\"]","Unisci le quattro parti (comando dalla documentazione di ESP Web Tools)",[13,210,211,212,217,218,221,222,225,226,229,230,233,234,229,237,240,241,244,245,250],{},"Anche le parti separate possono funzionare: il manifest d'esempio nel ",[25,213,216],{"href":214,"rel":215},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002FREADME.md",[48],"README di ESP Web Tools"," elenca quattro file, con un bootloader chiamato ",[20,219,220],{},"bootloader_dout_40m.bin"," le cui impostazioni di flash erano già state scelte in fase di build. L'unione è la strada documentata quando parti da una build normale. La documentazione aggiunge due avvertenze: usa ",[20,223,224],{},"dout"," quando il tipo di memoria è ",[20,227,228],{},"opi_opi"," o ",[20,231,232],{},"opi_qspi",", e sostituisci ",[20,235,236],{},"qio",[20,238,239],{},"qout"," con ",[20,242,243],{},"dio",". Il file unito ha un prezzo che vale la pena conoscere. La ",[25,246,249],{"href":247,"rel":248},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[48],"documentazione di esptool"," dice che nel formato raw gli spazi tra i file vengono riempiti con byte 0xFF, il valore della flash cancellata. Un'immagine unita copre quindi tutto l'intervallo dal bootloader all'app, compresa l'area delle impostazioni tra la tabella delle partizioni e boot_app0. Tienilo a mente per la sezione sugli aggiornamenti.",[38,252,254],{"id":253},"come-fa-opengizmo-a-flashare-dal-browser-senza-il-web-component","Come fa OpenGizmo a flashare dal browser senza il web component?",[13,256,257,258,261,262,186,265,268,269,272],{},"Ogni pagina di progetto di OpenGizmo ha una card del firmware che non è l'elemento di ESP Web Tools. È il componente ",[20,259,260],{},"app\u002Fcomponents\u002Fprojects\u002FFlashFirmware.vue"," nel codice sorgente del sito, che importa ",[20,263,264],{},"ESPLoader",[20,266,267],{},"Transport"," da esptool-js (versione 0.7.1 nel ",[20,270,271],{},"package.json"," del sito) e legge un manifest nel formato di ESP Web Tools. Il formato è quindi lo stesso, cambia solo il front end.",[274,275],"project-detail-card",{"project-slug":276},"gizmo-ticker",[13,278,279,280,284,285,288],{},"Ecco il manifest reale che legge la card del ",[25,281,283],{"href":282},"\u002Fit\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",", su ",[20,286,287],{},"https:\u002F\u002Fcdn.opengizmo.dev\u002Fgizmo-ticker\u002Fmanifest.json"," (scaricato il 14 novembre 2026):",[103,290,293],{"className":291,"code":292,"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,294,292],{"__ignoreMap":110},[13,296,297,298,302,303,307,308,311],{},"Gli offset sono decimali, come richiede JSON: 32768 è 0x8000, 57344 è 0xE000, 65536 è 0x10000. Il manifest del ",[25,299,301],{"href":300},"\u002Fit\u002Fprojects\u002Fgizmo-reolink-switch","Gizmo Reolink Switch"," ha le stesse quattro parti sullo stesso chip. Il manifest del ",[25,304,306],{"href":305},"\u002Fit\u002Fprojects\u002Fgizmo-camera","Gizmo Camera"," ha ",[20,309,310],{},"\"chipFamily\": \"ESP32\""," e il bootloader a 4096 (0x1000), come nella pagina di ESP-IDF vista sopra. Gli altri offset sono uguali.",[13,313,314,315,318,319,322],{},"Una chiave di questi manifest serve solo al componente ufficiale: ",[20,316,317],{},"new_install_prompt_erase: false",". La card di OpenGizmo non la legge mai. ESP Web Tools tratterebbe ",[20,320,321],{},"false"," come il suo default, cioè cancellare tutti i dati a una nuova installazione.",[13,324,325,326,330],{},"Quando premi ",[327,328,329],"strong",{},"Flash firmware",", la card fa questo, in quest'ordine:",[64,332,333,340,347,354,357,382],{},[67,334,335,336,339],{},"Chiama ",[20,337,338],{},"navigator.serial.requestPort()"," e si collega con esptool-js a 115200 baud, il che identifica il chip.",[67,341,342,343,346],{},"Scarica il manifest con ",[20,344,345],{},"cache: 'no-store'",", così una nuova release compare subito.",[67,348,349,350,353],{},"Cerca la build il cui ",[20,351,352],{},"chipFamily"," coincide con il nome del chip rilevato. Se non c'è, si ferma con \"Questo firmware non è compilato per il chip collegato\", così un'immagine per ESP32 non finisce mai su un ESP32-S3.",[67,355,356],{},"Scarica le quattro parti una alla volta, risolvendo ogni percorso rispetto all'URL del manifest.",[67,358,335,359,240,362,365,366,186,369,372,373,365,376,186,379,150],{},[20,360,361],{},"writeFlash",[20,363,364],{},"flashMode",", ",[20,367,368],{},"flashFreq",[20,370,371],{},"flashSize"," impostati su ",[20,374,375],{},"'keep'",[20,377,378],{},"eraseAll: false",[20,380,381],{},"compress: true",[67,383,384],{},"Resetta la scheda.",[13,386,387],{},"Perché non usare il web component? Posso indicare tre cose nel codice, e non ho provato il pulsante ufficiale con questi manifest, quindi non so dirti come si comporterebbe:",[389,390,391,406,416],"ul",{},[67,392,393,396,397,399,400,405],{},[327,394,395],{},"Le quattro parti restano separate."," Con ",[20,398,375],{},", esptool-js ",[25,401,404],{"href":402,"rel":403},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js\u002Fblob\u002Fmain\u002Fsrc\u002Fesploader.ts",[48],"lascia l'header del bootloader come l'ha prodotto la build",", quindi non serve nessun passaggio di unione. E le parti saltano l'area delle impostazioni, che un file unito sovrascriverebbe.",[67,407,408,411,412,415],{},[327,409,410],{},"Una correzione del reset."," Un commento in ",[20,413,414],{},"app\u002Futils\u002FhardReset.js"," del sito dice che esptool-js rilascia solo RTS, il che non fa nulla quando la linea è già rilasciata, come succede con l'USB nativa del chip sull'ESP32-S3. La scheda restava nel bootloader finché non la scollegavi. Il sito passa un reset suo: DTR rilasciato, RTS tenuto per 100 ms, poi rilasciato.",[67,417,418,421],{},[327,419,420],{},"Una card su misura."," Mostra la versione prima del flash, quattro fasi (connessione, download, flash, riavvio), un log, le note di rilascio della versione che installa e messaggi tradotti.",[13,423,424,425,429,430,434],{},"Il firmware non supporta Improv: non ho trovato codice Improv nei tre repository. La prima configurazione del Wi-Fi passa invece da un captive portal. Il ",[25,426,428],{"href":427},"\u002Fit\u002Fblog\u002Fesp32-wifi-provisioning-methods-compared","confronto sul provisioning Wi-Fi"," mette Improv a confronto con le alternative, e la ",[25,431,433],{"href":432},"\u002Fit\u002Fblog\u002Fesp32-captive-portal-not-working-fix","guida per sistemare il captive portal"," tratta il portale.",[13,436,437],{},[33,438],{"alt":439,"src":440},"Le quattro parti flashate del Gizmo Ticker e i loro offset, con l'area delle impostazioni a 0x9000 lasciata intatta","\u002Fimages\u002Fblog\u002Fit\u002Fesp-web-tools-flash-esp32-from-browser-flash-map.webp",[38,442,444],{"id":443},"qual-è-la-via-più-breve-per-avere-la-tua-pagina-di-installazione","Qual è la via più breve per avere la tua pagina di installazione?",[13,446,447],{},"Ecco tutto il lavoro in ordine, per il tuo firmware:",[64,449,450,453,459,469,472],{},[67,451,452],{},"Compila il firmware e raccogli le sue parti con i loro offset (oppure un unico file unito a offset 0 per ESP Web Tools).",[67,454,455,456,458],{},"Carica le parti e un ",[20,457,22],{}," che le elenca su un host HTTPS, con gli header CORS se non è il sito stesso della pagina.",[67,460,461,462,186,465,468],{},"Aggiungi lo snippet ",[20,463,464],{},"\u003Cscript>",[20,466,467],{},"\u003Cesp-web-install-button>"," visto sopra a una pagina HTTPS, con l'URL del manifest.",[67,470,471],{},"Apri la pagina in Chrome o Edge su desktop, collega la scheda con un cavo dati, premi il pulsante e scegli la porta.",[67,473,474],{},"Controlla che la scheda avvii il tuo firmware e che la pagina proponga la build giusta per ogni chip che elenchi.",[38,476,478],{"id":477},"dove-ospitare-il-firmware-e-che-dire-del-cors","Dove ospitare il firmware, e che dire del CORS?",[13,480,481,482,485,486,150],{},"Puoi ospitare il manifest e le parti sullo stesso sito della pagina di installazione, e allora non serve nessuna configurazione CORS. OpenGizmo li tiene su una CDN (",[20,483,484],{},"cdn.opengizmo.dev",", appoggiata a un bucket Cloudflare R2 nel workflow di rilascio), quindi il browser fa richieste cross-origin. In quel caso ESP Web Tools ti dice di inviare ",[20,487,488],{},"Access-Control-Allow-Origin: https:\u002F\u002Fdomain-of-your-website.com",[13,490,491,492,495,496,186,499,502,503,506,507,510,511,150],{},"L'ho verificato il 14 novembre 2026 richiedendo il manifest del Ticker con ",[20,493,494],{},"Origin: https:\u002F\u002Fopengizmo.dev",": la risposta conteneva ",[20,497,498],{},"access-control-allow-origin: https:\u002F\u002Fopengizmo.dev",[20,500,501],{},"vary: Origin",", e una richiesta preflight ha restituito 204 con ",[20,504,505],{},"access-control-allow-methods: GET",". La CDN accetta solo l'origine del sito, non ",[20,508,509],{},"*",". Prova il tuo con ",[20,512,513],{},"curl -I -H \"Origin: https:\u002F\u002Fyour.site\" \u003Cmanifest-url>",[38,515,517],{"id":516},"come-rilasci-una-nuova-versione-senza-perdere-le-impostazioni-wi-fi","Come rilasci una nuova versione senza perdere le impostazioni Wi-Fi?",[13,519,520,521,526,527,162],{},"Tieni i file di ogni versione nella loro cartella, non modificarli mai, e sposta il manifest per ultimo. Il ",[25,522,525],{"href":523,"rel":524},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fworkflows\u002Fbuild_and_release.yml",[48],"workflow di rilascio"," di OpenGizmo fa così, con un'esecuzione manuale da ",[20,528,529],{},"main",[13,531,532],{},[33,533],{"alt":534,"src":535},"Un browser mostra la memoria flash scritta in quattro parti arancioni, mentre una parte grigia resta bloccata e intatta, con una XIAO collegata in USB-C","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser-illustration.webp",[64,537,538,545,548,563,566],{},[67,539,540,541,544],{},"Legge ",[20,542,543],{},"VERSION"," e si ferma se il tag esiste già o se la versione della web app è diversa.",[67,546,547],{},"Esegue i test della web app e i test nativi del firmware, poi compila il firmware.",[67,549,550,551,556,557,560,561,150],{},"Esegue ",[25,552,555],{"href":553,"rel":554},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fscripts\u002Fpackage_firmware.py",[48],"package_firmware.py",", che chiede a PlatformIO le immagini di flash e i loro offset (",[20,558,559],{},"pio project metadata",") e scrive ",[20,562,22],{},[67,564,565],{},"Crea una release su GitHub con le parti, le cui note riportano un comando esptool per flashare via USB.",[67,567,568,569,572,573,150],{},"Carica le parti con ",[20,570,571],{},"Cache-Control: public, max-age=31536000, immutable",", poi il manifest con ",[20,574,575],{},"max-age=60",[13,577,578],{},"Caricare il manifest per ultimo significa che il sito propone solo una versione caricata per intero, e una cache di un minuto fa comparire una release entro un minuto. Gli header che ho visto il 14 novembre 2026 corrispondono.",[13,580,581,582,585,586,591,592,595,596,599,600,602,603,606,607,609,610,614,615,619],{},"Le impostazioni sopravvivono grazie a ciò che non viene scritto. I progetti usano la tabella delle partizioni ",[20,583,584],{},"huge_app.csv",", in cui il ",[25,587,590],{"href":588,"rel":589},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fhuge_app.csv",[48],"core Arduino definisce"," ",[20,593,594],{},"nvs"," a 0x9000 (0x5000 byte) e ",[20,597,598],{},"otadata"," a 0xE000. Le quattro parti non coprono la regione ",[20,601,594],{}," (da 0x9000 a 0xDFFF) e ",[20,604,605],{},"eraseAll"," è ",[20,608,321],{},", quindi i dati di Preferences restano. Lo deduco dagli offset e dal codice: non ho misurato una flash prima e dopo. La ",[25,611,613],{"href":612},"\u002Fit\u002Fblog\u002Fesp32-partition-table-explained","guida alla tabella delle partizioni"," spiega il layout, e il ",[25,616,618],{"href":617},"\u002Fit\u002Fblog\u002Fesp32-ota-update-methods-compared","confronto sugli aggiornamenti OTA"," spiega perché questi dispositivi si aggiornano via USB, dato che non hanno un secondo slot per l'app.",[13,621,622,623,626,627,630,631,634],{},"Con il componente ufficiale, leggi bene la regola di cancellazione: ESP Web Tools cancella tutti i dati a una nuova installazione, a meno che ",[20,624,625],{},"new_install_prompt_erase"," sia ",[20,628,629],{},"true"," e l'utente rifiuti. Propone una nuova installazione quando non riesce a rilevare il firmware attuale del dispositivo, o quando il firmware rilevato non corrisponde al ",[20,632,633],{},"name"," del manifest.",[38,636,638],{"id":637},"cosa-si-rompe-più-spesso","Cosa si rompe più spesso?",[13,640,641],{},"La maggior parte dei guasti dipende da cavo, porta o browser, non dal firmware. Scorri questa tabella dall'alto, cambiando una cosa alla volta.",[121,643],{":headers":644,":rows":645},"[\"Cosa vedi\",\"Causa probabile\",\"Cosa provare\"]","[[\"Pulsante disabilitato, o 'Flash non disponibile da questo browser'\",\"Browser senza Web Serial, o la pagina non è in HTTPS\",\"Usa Chrome o Edge su desktop, in HTTPS o su localhost\"],[\"Il selettore di porta non mostra nessun dispositivo\",\"Cavo USB solo ricarica, o scheda non rilevata\",\"Usa un cavo dati e un'altra porta USB, poi ricarica la pagina\"],[\"La connessione fallisce, nessun dato seriale ricevuto\",\"Il chip non è in modalità download, o il collegamento USB è instabile\",\"Vedi la guida a 'Failed to connect'\"],[\"'Questo firmware non è compilato per il chip collegato'\",\"Il manifest non ha una build per quella famiglia di chip\",\"Aggiungi una build per quel chip, o usa la scheda giusta\"],[\"'Download del firmware fallito con stato 404'\",\"Il percorso di una parte nel manifest è sbagliato\",\"Apri l'URL di ogni parte in una scheda del browser\"],[\"Il manifest non si legge, con un errore CORS nella console\",\"La CDN non consente l'origine della tua pagina\",\"Invia Access-Control-Allow-Origin per il tuo dominio\"],[\"Il flash finisce ma la scheda resta nel bootloader\",\"Nessun vero impulso di reset dopo il flash\",\"Scollega e ricollega; un hard reset personalizzato come quello visto sopra risolve\"]]",[13,647,648,649,653],{},"Per la terza riga, ",[25,650,652],{"href":651},"\u002Fit\u002Fblog\u002Fesp32-failed-to-connect-no-serial-data-received","Failed to Connect to ESP32: No Serial Data Received"," passa in rassegna boot mode, cavi e driver. I testi d'errore nella tabella sono quelli del file delle traduzioni della card di OpenGizmo, e la tua pagina dirà altro.",[38,655,657],{"id":656},"dove-si-ferma-il-flash-dal-browser","Dove si ferma il flash dal browser?",[13,659,660],{},"Il flash dal browser ti dà una pagina in cui chiunque abbia Chrome o Edge, un cavo e una scheda può installare il tuo firmware in un minuto, con le impostazioni conservate e un numero di versione a schermo. Abbiamo visto i pezzi: Web Serial su HTTPS, un manifest di parti e offset (unito per ESP Web Tools, oppure quattro parti con esptool-js), il CORS se i file stanno altrove, e una release che carica il manifest per ultimo.",[13,662,663,664,667,668,672],{},"Restano tre limiti. Copre solo il flash via cavo; per gli aggiornamenti via Wi-Fi vedi il ",[25,665,666],{"href":617},"confronto tra i metodi OTA",". Il supporto dei browser fuori da Chrome ed Edge è scarso a novembre 2026, e non ne ho provato nessuno. E il componente ufficiale l'ho descritto solo dalla sua documentazione e dal suo codice, non per averlo usato io. Se vuoi vedere il tutto in funzione, la ",[25,669,671],{"href":670},"\u002Fit\u002Fblog\u002Fhow-to-build-a-crypto-ticker-with-esp32-and-max7219","guida alla costruzione del Gizmo Ticker"," flasha una scheda dall'inizio alla fine, e le tre pagine dei progetti hanno ciascuna la card.",{"title":110,"searchDepth":674,"depth":674,"links":675},2,[676,677,678,679,680,681,682,683,684,685],{"id":40,"depth":674,"text":41},{"id":115,"depth":674,"text":116},{"id":153,"depth":674,"text":154},{"id":195,"depth":674,"text":196},{"id":253,"depth":674,"text":254},{"id":443,"depth":674,"text":444},{"id":477,"depth":674,"text":478},{"id":516,"depth":674,"text":517},{"id":637,"depth":674,"text":638},{"id":656,"depth":674,"text":657},"guides","Guide","2026-11-14T00:00:00Z","Flashare un ESP32 dal browser con ESP Web Tools o esptool-js: come funzionano Web Serial, manifest e offset, con un manifest reale di OpenGizmo.","md",[692,695,698,701,704,707],{"question":693,"answer":694},"Posso flashare un ESP32 dal browser senza installare niente?","Sì. Una pagina che usa ESP Web Tools o esptool-js parla con la scheda tramite la Web Serial API, quindi bastano un cavo USB dati e Chrome o Edge su desktop. La pagina deve essere servita in HTTPS. Scegli la porta seriale e il firmware viene scritto direttamente dal browser.",{"question":696,"answer":697},"ESP Web Tools funziona con Firefox o Safari?","ESP Web Tools indica come supportati Firefox, Chrome, Edge e Chrome su Android, ma non iOS. I dati di compatibilità di MDN mostrano Web Serial in Firefox dalla versione 151 su desktop e in Safari per niente. Chrome ed Edge restano la scelta sicura, e gli altri non li ho provati.",{"question":699,"answer":700},"Serve un file firmware unico (merged) per ESP Web Tools?","La documentazione di ESP Web Tools dice che il firmware per ESP32 compilato con ESP-IDF 4 o successivo va unito in un solo file, perché lo strumento non può correggere modalità, frequenza e dimensione della flash come fa esptool. Lo crei con esptool merge_bin e lo elenchi nel manifest come unica parte a offset 0.",{"question":702,"answer":703},"Flashare dal browser cancella le impostazioni Wi-Fi?","Solo se il flasher le cancella. ESP Web Tools cancella tutti i dati a una nuova installazione, a meno che il manifest imposti new_install_prompt_erase a true e tu rifiuti. Il flasher di OpenGizmo scrive quattro parti e non cancella mai l'intero chip, quindi le impostazioni nella partizione NVS sopravvivono a un aggiornamento.",{"question":705,"answer":706},"Che cos'è Improv Wi-Fi?","Improv Wi-Fi è uno standard aperto per inviare le credenziali Wi-Fi a un dispositivo tramite la sua porta seriale. Se il firmware lo supporta, ESP Web Tools chiede di collegare il dispositivo a una rete subito dopo l'installazione. Un firmware senza Improv, come quello di OpenGizmo, usa invece un captive portal per questo passaggio.",{"question":708,"answer":709},"Perché il flash dal browser richiede HTTPS?","La Web Serial API è disponibile solo in contesti sicuri, quindi la pagina con il pulsante di installazione deve essere servita in HTTPS (anche localhost conta come sicuro). Una pagina HTTP semplice non può aprire una porta seriale. Se manifest e firmware stanno su un altro host, anche quell'host deve inviare gli header CORS.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg","Un uomo con la barba e una felpa blu siede accanto a un portatile il cui browser mostra un pulsante Install arancione e una barra al 68%, con un cavo USB fino a una scheda ESP32.","it",{},true,"\u002Fit\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser",{"title":5,"description":689},{"loc":715},"it\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","ESP Web Tools flasha un ESP32 via Web Serial, con Chrome o Edge su una pagina HTTPS, da un manifest.json che elenca ogni parte del firmware e il suo offset. OpenGizmo fa lo stesso con esptool-js.",[721,722,723,28,724],"ESP32","Firmware","Development Tools","Embedded Systems","rZwQEgg7sA_YiHTj8o3EWWHwAhHIrczWPzL65Zn1eDk",[727,733,739,746],{"title":728,"description":729,"image":730,"categoryText":687,"categorySlug":686,"tags":731,"path":612},"Tabella delle partizioni ESP32: layout flash e OTA","Cos'è la tabella delle partizioni dell'ESP32, come leggere le colonne di partitions.csv, gli schemi Arduino-ESP32 con le dimensioni e cosa significa N16R8.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg",[721,722,724,732,28],"PlatformIO",{"title":734,"description":735,"image":736,"categoryText":687,"categorySlug":686,"tags":737,"path":148},"ESP32-CAM-MB: programmare la ESP32-CAM via USB","Come programmare una ESP32-CAM con la scheda USB ESP32-CAM-MB: cosa contiene, la sequenza IO0 e RST, flashare da Chrome e cosa può andare storto.","\u002Fimages\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide.jpg",[738,721,722,723,28],"ESP32-CAM",{"title":740,"description":741,"image":742,"categoryText":687,"categorySlug":686,"tags":743,"path":27},"Cos'è OpenGizmo? Gadget ESP32 open source da flashare","OpenGizmo è un set di gadget ESP32 con licenza MIT di Mauro Brambilla: ticker crypto a LED, switch per NVR Reolink ed ESP32-CAM, da flashare dal browser.","\u002Fimages\u002Fblog\u002Fwhat-is-open-gizmo.png",[28,744,721,722,745],"Open Source","3D Printing",{"title":747,"description":748,"image":749,"categoryText":687,"categorySlug":686,"tags":750,"path":753},"Cos'è un microcontrollore? Parti, esempi ed ESP32","Un microcontrollore è un chip con CPU, RAM e pin programmabili che esegue un solo programma. Come funziona, differenze dal Raspberry Pi, cosa comprare.","\u002Fimages\u002Fblog\u002Fwhat-is-a-microcontroller.png",[751,721,724,752,722],"Microcontrollers","Electronics","\u002Fit\u002Fblog\u002Fwhat-is-a-microcontroller",[755,761,767],{"name":756,"slug":757,"path":758,"count":759,"image":760},"Confronti","comparisons","\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",{"name":762,"slug":763,"path":764,"count":765,"image":766},"Build","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":768,"slug":769,"path":770,"count":771,"image":772},"Risoluzione problemi","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"title":283,"badge":774,"description":775,"path":282,"image":776,"cardIcon":777,"highlights":778},"Progetto open-source ESP32 + MAX7219","Un display per criptovalute connesso al WiFi, realizzato con ESP32, matrice LED MAX7219 e web app Nuxt 4 configurabile dal browser.","\u002Fimages\u002Fprojects\u002Fgizmo-ticker\u002Fcover.webp","BitcoinIcon",[779,780,781],"Ticker di criptovalute in tempo reale","Matrice LED MAX7219","Configurazione via web",1795018239329]