[{"data":1,"prerenderedAt":784},["ShallowReactive",2],{"post-esp-web-tools-flash-esp32-from-browser-de":3,"related-posts-esp-web-tools-flash-esp32-from-browser-de":728,"related-categories-esp-web-tools-flash-esp32-from-browser-de":756,"blog-project-detail-card-gizmo-ticker-de":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\u002Fde\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.md","ESP Web Tools: ESP32 im Browser flashen","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,251,255,273,277,289,295,312,323,331,386,389,423,436,442,446,449,477,481,492,517,521,533,539,580,583,623,637,641,644,648,656,660,663],[13,14,15],"p",{},"Ja, du kannst einen ESP32 im Webbrowser flashen. ESP Web Tools, oder jede Seite auf Basis von Espressifs esptool-js, spricht das Board über die Web Serial API an: Du öffnest eine HTTPS-Seite in Chrome oder Edge auf einem Desktop-Rechner, steckst ein USB-Datenkabel an, wählst den seriellen Port und drückst einen Button.",[13,17,18,19,23,24,29],{},"In dieser Anleitung erkläre ich, wie ESP Web Tools funktioniert (Web Serial, die ",[20,21,22],"code",{},"manifest.json",", die Offsets) und zeige dann, wie die drei ",[25,26,28],"a",{"href":27},"\u002Fde\u002Fblog\u002Fwhat-is-opengizmo","OpenGizmo","-Geräte dieselbe Idee nutzen, mit einem echten Manifest auf einem CDN. Vorab ein Detail: Die OpenGizmo-Website bindet den ESP-Web-Tools-Button nicht ein. Sie nutzt esptool-js direkt, und ich zeige dir, warum.",[13,31,32],{},[33,34],"img",{"alt":35,"src":36},"Die vier Schritte beim Flashen im Browser: USB-Port per Web Serial wählen, Chip erkennen, im Manifest den passenden Build wählen, die Teile an ihren Offsets schreiben","\u002Fimages\u002Fblog\u002Fde\u002Fesp-web-tools-flash-esp32-from-browser-steps.webp",[38,39,41],"h2",{"id":40},"wie-funktioniert-esp-web-tools","Wie funktioniert 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"," ist eine Open-Source-Webkomponente des ESPHome-Projekts (Open Home Foundation), die jeder Webseite einen Install-Button für ESP8266- und ESP32-Firmware hinzufügt. Laut der eigenen Website kombiniert es ",[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 (optional) und ein Manifest, das die Firmware beschreibt.",[13,58,59],{},"Moment, was ist Web Serial? Das ist eine Browser-API, mit der eine Seite serielle Geräte lesen und beschreiben kann, auch USB-Geräte, die einen virtuellen seriellen Port bereitstellen, so wie ein ESP32-Entwicklungsboard. Der Browser zeigt eine Port-Auswahl, und du wählst den Port selbst, eine Seite kann also kein Gerät hinter deinem Rücken öffnen.",[13,61,62],{},"Das passiert, wenn jemand den Button drückt:",[64,65,66,70,73,76],"ol",{},[67,68,69],"li",{},"Der Browser bittet den Nutzer, einen seriellen Port zu wählen.",[67,71,72],{},"Das Tool verbindet sich mit dem ROM-Bootloader des Chips und erkennt ihn. Laut Dokumentation wählt es danach automatisch die passende Firmware-Variante aus dem Manifest.",[67,74,75],{},"Es lädt die Teile dieses Builds herunter und schreibt jeden an seinen Offset.",[67,77,78],{},"Optional wartet es auf Improv Serial, um den Gerätezustand zu erfahren und die WLAN-Einrichtung anzubieten.",[13,80,81,82,87,88,93],{},"Das Flashen selbst wurde nicht neu erfunden. Stand November 2026 hängt das ",[25,83,86],{"href":84,"rel":85},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002Fpackage.json",[48],"ESP-Web-Tools-Paket"," (Version 10.5.x) von ",[25,89,92],{"href":90,"rel":91},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js",[48],"esptool-js"," ab, Espressifs JavaScript-Port des esptool-Flashers, sowie vom Improv-Serial-SDK. Deshalb verhalten sich die beiden Tools ähnlich.",[13,95,96,97,101],{},"Den Button in deine Seite einzubauen braucht zwei Snippets, beide aus der ",[25,98,100],{"href":46,"rel":99},[48],"offiziellen Anleitung",": Du lädst das Skript, setzt dann das Element ein und zeigst damit auf dein 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},"welche-browser-unterstützen-es-und-warum-https","Welche Browser unterstützen es, und warum HTTPS?",[13,118,119],{},"Web Serial gibt es nur in sicheren Kontexten, die Seite mit dem Button muss also über HTTPS ausgeliefert werden. ESP Web Tools nennt das als Web-Serial-Voraussetzung. Außerdem muss der Browser die API implementieren, und das ist die eigentliche Grenze.",[121,122],"blog-table",{":headers":123,":rows":124},"[\"Browser\",\"Web Serial\",\"Hinweis\"]","[[\"Chrome (Desktop)\",\"Ja, ab Version 89\",\"esptool-js nennt Chrome und Edge ab 89\"],[\"Edge (Desktop)\",\"Ja, ab Version 89\",\"In den MDN-Kompatibilitätsdaten identisch mit Chrome\"],[\"Chrome auf Android\",\"Ja, ab Version 148\",\"Die Versionen 138 bis 147 sahen nur Bluetooth-Ports\"],[\"Firefox (Desktop)\",\"Ja, ab Version 151\",\"MDN-Daten. Nicht von mir getestet\"],[\"Firefox auf Android\",\"Nein\",\"MDN-Daten\"],[\"Safari, jeder Browser auf iOS\",\"Nein\",\"MDN-Daten. ESP Web Tools sagt ebenfalls: kein iOS\"]]",[13,126,127,128,133,134,137],{},"Die Versionen stammen aus den ",[25,129,132],{"href":130,"rel":131},"https:\u002F\u002Fgithub.com\u002Fmdn\u002Fbrowser-compat-data\u002Fblob\u002Fmain\u002Fapi\u002FSerial.json",[48],"Browser-Kompatibilitätsdaten von MDN",", Stand November 2026, und MDN selbst markiert die Funktion als nicht Baseline. Das Verhalten des OpenGizmo-Flashers habe ich nur im Code geprüft, nicht in jedem Browser. Seine Karte zeigt \"Flashen in diesem Browser nicht möglich\", wenn ",[20,135,136],{},"navigator.serial"," fehlt oder die Seite kein sicherer Kontext ist.",[13,139,140,141,145,146,150],{},"Wenn du Safari oder ein Smartphone nutzt, flashe einmal mit einem Tool, das auf einem Computer installiert ist: Siehe ",[25,142,144],{"href":143},"\u002Fde\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs. PlatformIO für ESP32"," oder, für die ESP32-CAM, die ",[25,147,149],{"href":148},"\u002Fde\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide","Anleitung zum ESP32-CAM-MB-Programmer",".",[38,152,154],{"id":153},"wie-schreibst-du-das-manifest-und-wählst-die-offsets","Wie schreibst du das Manifest und wählst die Offsets?",[13,156,157,158,162],{},"Ein Manifest ist eine kleine JSON-Datei, die dem Flasher sagt, welche Firmware auf welchen Chip kommt. Jeder Build listet die zu schreibenden Dateien (Teile) und den Flash-Offset jeder Datei auf. Das hier ist das kleinste brauchbare Manifest, im Format der ",[25,159,161],{"href":46,"rel":160},[48],"ESP-Web-Tools-Dokumentation",":",[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],{},"Pfade der Teile werden relativ zum Manifest aufgelöst und können auch vollständige URLs auf anderen Hosts sein. Die Felder, denen du am ehesten begegnest:",[121,175],{":headers":176,":rows":177},"[\"Schlüssel\",\"Wo\",\"Was er bewirkt\"]","[[\"name, version\",\"oberste Ebene\",\"Werden in der Oberfläche angezeigt. Der Name wird mit der Firmware verglichen, die das Gerät über Improv meldet\"],[\"builds[].chipFamily\",\"Build\",\"ESP8266, ESP32, ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61, ESP32-H2, ESP32-P4, ESP32-S2 oder ESP32-S3\"],[\"builds[].parts[]\",\"Build\",\"Ein Dateipfad und der ganzzahlige Flash-Offset, an den die Datei geschrieben wird\"],[\"builds[].serialType\",\"Build\",\"cdc oder uart: ein eigener Build für natives USB oder für eine USB-UART-Bridge\"],[\"new_install_prompt_erase\",\"oberste Ebene\",\"true lässt den Nutzer bei einer Neuinstallation wählen, ob alles gelöscht wird\"],[\"new_install_improv_wait_time\",\"oberste Ebene\",\"Sekunden, die nach der Installation auf eine Improv-Antwort gewartet wird (standardmäßig 10, 0 schaltet Improv ab)\"],[\"home_assistant_domain, funding_url\",\"oberste Ebene\",\"Optionale Links, die nach der Installation angezeigt werden\"]]",[13,179,180,181,186,187,192],{},"Die Offsets hängen vom Chip ab und davon, wie du die Firmware gebaut hast. Für eine Firmware aus vier Dateien legt die ESP-IDF-Dokumentation den ",[25,182,185],{"href":183,"rel":184},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[48],"Second-Stage-Bootloader auf 0x1000 beim ESP32"," und ",[25,188,191],{"href":189,"rel":190},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Fstable\u002Fesp32s3\u002Fapi-guides\u002Fbootloader.html",[48],"auf 0x0 beim ESP32-S3",". Die S3-Seite legt außerdem die Partitionstabelle standardmäßig auf 0x8000. In den PlatformIO-Builds, die ich ausliefere, liegt das boot_app0-Image bei 0xE000 und die App bei 0x10000. Rate nie: Lies sie aus deinem Build, wie es der nächste Abschnitt tut.",[38,194,196],{"id":195},"brauchst-du-eine-zusammengeführte-firmware-datei","Brauchst du eine zusammengeführte Firmware-Datei?",[13,198,199,200,203],{},"Für einen ESP32, der mit ESP-IDF 4 oder neuer gebaut wurde, sagt die ESP-Web-Tools-Dokumentation: ja. Ihre Begründung: Werden die vier Dateien mit dem esptool-Befehl installiert, passt esptool Flash-Frequenz, -Größe und -Modus an das Zielgerät an, und ESP Web Tools kann das nicht im laufenden Betrieb. Also baust du mit ",[20,201,202],{},"merge_bin"," ein einziges Image und trägst es bei Offset 0 ein.",[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\"]","Die vier Teile zusammenführen (Befehl aus der ESP-Web-Tools-Dokumentation)",[13,210,211,212,217,218,221,222,225,226,229,230,233,234,229,237,240,241,244,245,250],{},"Getrennte Teile können ebenfalls funktionieren: Das Beispielmanifest in der ",[25,213,216],{"href":214,"rel":215},"https:\u002F\u002Fgithub.com\u002Fesphome\u002Fesp-web-tools\u002Fblob\u002Fmain\u002FREADME.md",[48],"README von ESP Web Tools"," listet vier Dateien, mit einem Bootloader namens ",[20,219,220],{},"bootloader_dout_40m.bin",", dessen Flash-Einstellungen schon beim Build festgelegt wurden. Das Zusammenführen ist der dokumentierte Weg, wenn du von einem normalen Build ausgehst. Die Dokumentation nennt zwei Einschränkungen: Nimm ",[20,223,224],{},"dout",", wenn dein Speichertyp ",[20,227,228],{},"opi_opi"," oder ",[20,231,232],{},"opi_qspi"," ist, und ersetze ",[20,235,236],{},"qio",[20,238,239],{},"qout"," durch ",[20,242,243],{},"dio",". Die zusammengeführte Datei hat einen Preis, den du kennen solltest. Die ",[25,246,249],{"href":247,"rel":248},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[48],"esptool-Dokumentation"," sagt, dass im Raw-Format die Lücken zwischen den Dateien mit 0xFF-Bytes aufgefüllt werden, dem Wert von gelöschtem Flash. Ein zusammengeführtes Image deckt also den gesamten Bereich vom Bootloader bis zur App ab, einschließlich des Einstellungsbereichs zwischen Partitionstabelle und boot_app0. Merke dir das für den Abschnitt über Updates.",[38,252,254],{"id":253},"wie-flasht-opengizmo-im-browser-ohne-die-webkomponente","Wie flasht OpenGizmo im Browser ohne die Webkomponente?",[13,256,257,258,261,262,186,265,268,269,272],{},"Jede OpenGizmo-Projektseite hat eine Firmware-Karte, die nicht das ESP-Web-Tools-Element ist. Sie ist die Komponente ",[20,259,260],{},"app\u002Fcomponents\u002Fprojects\u002FFlashFirmware.vue"," im Quellcode der Website, die ",[20,263,264],{},"ESPLoader",[20,266,267],{},"Transport"," aus esptool-js importiert (Version 0.7.1 in der ",[20,270,271],{},"package.json"," der Website) und ein Manifest im ESP-Web-Tools-Format liest. Das Format ist also gemeinsam, nur das Frontend unterscheidet sich.",[274,275],"project-detail-card",{"project-slug":276},"gizmo-ticker",[13,278,279,280,284,285,288],{},"Hier ist das echte Manifest, das die Karte des ",[25,281,283],{"href":282},"\u002Fde\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker"," liest, unter ",[20,286,287],{},"https:\u002F\u002Fcdn.opengizmo.dev\u002Fgizmo-ticker\u002Fmanifest.json"," (abgerufen am 14. November 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],{},"Die Offsets sind dezimal, wie JSON es verlangt: 32768 ist 0x8000, 57344 ist 0xE000, 65536 ist 0x10000. Das Manifest des ",[25,299,301],{"href":300},"\u002Fde\u002Fprojects\u002Fgizmo-reolink-switch","Gizmo Reolink Switch"," hat dieselben vier Teile auf demselben Chip. Das Manifest der ",[25,304,306],{"href":305},"\u002Fde\u002Fprojects\u002Fgizmo-camera","Gizmo Camera"," hat ",[20,309,310],{},"\"chipFamily\": \"ESP32\""," und seinen Bootloader bei 4096 (0x1000), passend zur ESP-IDF-Seite von oben. Die anderen Offsets sind gleich.",[13,313,314,315,318,319,322],{},"Ein Schlüssel in diesen Manifesten ist nur für die offizielle Komponente: ",[20,316,317],{},"new_install_prompt_erase: false",". Die OpenGizmo-Karte liest ihn nie. ESP Web Tools würde ",[20,320,321],{},"false"," wie seinen Standard behandeln, nämlich bei einer Neuinstallation alle Daten zu löschen.",[13,324,325,326,330],{},"Wenn du auf ",[327,328,329],"strong",{},"Firmware flashen"," drückst, macht die Karte Folgendes, in dieser Reihenfolge:",[64,332,333,340,347,354,357,383],{},[67,334,335,336,339],{},"Ruft ",[20,337,338],{},"navigator.serial.requestPort()"," auf und verbindet sich mit esptool-js bei 115200 Baud, wodurch der Chip erkannt wird.",[67,341,342,343,346],{},"Lädt das Manifest mit ",[20,344,345],{},"cache: 'no-store'"," herunter, damit ein neues Release sofort erscheint.",[67,348,349,350,353],{},"Sucht den Build, dessen ",[20,351,352],{},"chipFamily"," dem erkannten Chip-Namen entspricht. Gibt es keinen, bricht sie mit \"Diese Firmware ist nicht für den angeschlossenen Chip gebaut\" ab, so landet nie ein ESP32-Image auf einem ESP32-S3.",[67,355,356],{},"Lädt die vier Teile nacheinander herunter und löst jeden Pfad relativ zur Manifest-URL auf.",[67,358,335,359,362,363,366,367,186,370,373,374,366,377,186,380,150],{},[20,360,361],{},"writeFlash"," auf, mit ",[20,364,365],{},"flashMode",", ",[20,368,369],{},"flashFreq",[20,371,372],{},"flashSize"," auf ",[20,375,376],{},"'keep'",[20,378,379],{},"eraseAll: false",[20,381,382],{},"compress: true",[67,384,385],{},"Setzt das Board zurück.",[13,387,388],{},"Warum nicht die Webkomponente nutzen? Ich kann auf drei Dinge im Code verweisen, und ich habe den offiziellen Button nicht mit diesen Manifesten ausprobiert, kann also nicht sagen, wie er sich verhalten würde:",[390,391,392,407,417],"ul",{},[67,393,394,397,398,400,401,406],{},[327,395,396],{},"Die vier Teile bleiben getrennt."," Mit ",[20,399,376],{}," ",[25,402,405],{"href":403,"rel":404},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesptool-js\u002Fblob\u002Fmain\u002Fsrc\u002Fesploader.ts",[48],"lässt esptool-js den Header des Bootloaders so, wie der Build ihn erzeugt hat",", es ist also kein Merge-Schritt nötig. Und die Teile überspringen den Einstellungsbereich, den eine zusammengeführte Datei überschreiben würde.",[67,408,409,412,413,416],{},[327,410,411],{},"Ein Reset-Fix."," Ein Kommentar in ",[20,414,415],{},"app\u002Futils\u002FhardReset.js"," der Website sagt, dass esptool-js nur RTS freigibt, was nichts bewirkt, wenn die Leitung schon freigegeben ist, wie es über das chipeigene USB beim ESP32-S3 der Fall ist. Das Board blieb dann im Bootloader, bis man es abzog. Die Website übergibt einen eigenen Reset: DTR freigegeben, RTS 100 ms gehalten, dann freigegeben.",[67,418,419,422],{},[327,420,421],{},"Eine maßgeschneiderte Karte."," Sie zeigt die Version vor dem Flashen, vier Phasen (Verbinden, Herunterladen, Flashen, Neustart), ein Log, die Release Notes der Version, die sie installiert, und übersetzte Meldungen.",[13,424,425,426,430,431,435],{},"Die Firmware hat keine Improv-Unterstützung: In den drei Repositories habe ich keinen Improv-Code gefunden. Die erste WLAN-Einrichtung läuft stattdessen über ein Captive Portal. Der ",[25,427,429],{"href":428},"\u002Fde\u002Fblog\u002Fesp32-wifi-provisioning-methods-compared","Vergleich der WLAN-Provisioning-Methoden"," behandelt Improv im Vergleich zu den Alternativen, und die ",[25,432,434],{"href":433},"\u002Fde\u002Fblog\u002Fesp32-captive-portal-not-working-fix","Anleitung zur Behebung von Captive-Portal-Problemen"," behandelt das Portal.",[13,437,438],{},[33,439],{"alt":440,"src":441},"Die vier Flash-Teile des Gizmo Ticker und ihre Offsets, mit dem Einstellungsbereich bei 0x9000 unangetastet","\u002Fimages\u002Fblog\u002Fde\u002Fesp-web-tools-flash-esp32-from-browser-flash-map.webp",[38,443,445],{"id":444},"was-ist-der-kürzeste-weg-zu-deiner-eigenen-installationsseite","Was ist der kürzeste Weg zu deiner eigenen Installationsseite?",[13,447,448],{},"Hier ist die ganze Arbeit der Reihe nach, für deine eigene Firmware:",[64,450,451,454,460,471,474],{},[67,452,453],{},"Baue die Firmware und sammle ihre Teile mit den Offsets (oder eine zusammengeführte Datei bei Offset 0 für ESP Web Tools).",[67,455,456,457,459],{},"Lade die Teile und eine ",[20,458,22],{},", die sie auflistet, auf einen HTTPS-Host hoch, mit CORS-Headern, falls der Host nicht zur Domain der Installationsseite gehört.",[67,461,462,463,466,467,470],{},"Füge das ",[20,464,465],{},"\u003Cscript>","- und ",[20,468,469],{},"\u003Cesp-web-install-button>","-Snippet von oben mit der Manifest-URL in eine HTTPS-Seite ein.",[67,472,473],{},"Öffne die Seite in Chrome oder Edge auf einem Desktop-Rechner, schließe das Board mit einem Datenkabel an, drücke den Button und wähle den Port.",[67,475,476],{},"Prüfe, ob das Board deine Firmware startet und ob die Seite für jeden aufgelisteten Chip den richtigen Build anbietet.",[38,478,480],{"id":479},"wo-hostest-du-die-firmware-und-was-ist-mit-cors","Wo hostest du die Firmware, und was ist mit CORS?",[13,482,483,484,487,488,491],{},"Du kannst Manifest und Teile auf derselben Website wie die Installationsseite hosten, dann ist keine CORS-Einrichtung nötig. OpenGizmo hält sie auf einem CDN (",[20,485,486],{},"cdn.opengizmo.dev",", im Release-Workflow von einem Cloudflare-R2-Bucket gestützt), der Browser stellt also Cross-Origin-Anfragen. ESP Web Tools sagt dir für diesen Fall, dass du ",[20,489,490],{},"Access-Control-Allow-Origin: https:\u002F\u002Fdomain-of-your-website.com"," senden sollst.",[13,493,494,495,498,499,186,502,505,506,509,510,513,514,150],{},"Ich habe das am 14. November 2026 geprüft, indem ich das Ticker-Manifest mit ",[20,496,497],{},"Origin: https:\u002F\u002Fopengizmo.dev"," angefragt habe: Die Antwort enthielt ",[20,500,501],{},"access-control-allow-origin: https:\u002F\u002Fopengizmo.dev",[20,503,504],{},"vary: Origin",", und eine Preflight-Anfrage lieferte 204 mit ",[20,507,508],{},"access-control-allow-methods: GET",". Das CDN erlaubt nur den Origin der Website, nicht ",[20,511,512],{},"*",". Teste deins mit ",[20,515,516],{},"curl -I -H \"Origin: https:\u002F\u002Fyour.site\" \u003Cmanifest-url>",[38,518,520],{"id":519},"wie-veröffentlichst-du-eine-neue-version-ohne-wlan-einstellungen-zu-verlieren","Wie veröffentlichst du eine neue Version, ohne WLAN-Einstellungen zu verlieren?",[13,522,523,524,529,530,162],{},"Lege die Dateien jeder Version in einen eigenen Ordner, ändere sie nie und verschiebe das Manifest zuletzt. Der ",[25,525,528],{"href":526,"rel":527},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fworkflows\u002Fbuild_and_release.yml",[48],"Release-Workflow"," von OpenGizmo macht das bei einem manuellen Lauf von ",[20,531,532],{},"main",[13,534,535],{},[33,536],{"alt":537,"src":538},"Ein Browser zeigt den Flash-Speicher, der in vier orangen Teilen beschrieben wird, während ein grauer Teil gesperrt und unberührt bleibt, mit einem XIAO an USB-C","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser-illustration.webp",[64,540,541,548,551,567,570],{},[67,542,543,544,547],{},"Liest ",[20,545,546],{},"VERSION"," und bricht ab, wenn der Tag existiert oder die Version der Web-App abweicht.",[67,549,550],{},"Führt die Web-App-Tests und die nativen Firmware-Tests aus und baut dann die Firmware.",[67,552,553,554,559,560,563,564,566],{},"Führt ",[25,555,558],{"href":556,"rel":557},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fscripts\u002Fpackage_firmware.py",[48],"package_firmware.py"," aus, das PlatformIO nach den Flash-Images und ihren Offsets fragt (",[20,561,562],{},"pio project metadata",") und ",[20,565,22],{}," schreibt.",[67,568,569],{},"Erstellt ein GitHub-Release mit den Teilen, dessen Notes einen esptool-Befehl zum Flashen über USB enthalten.",[67,571,572,573,576,577,150],{},"Lädt die Teile mit ",[20,574,575],{},"Cache-Control: public, max-age=31536000, immutable"," hoch, danach das Manifest mit ",[20,578,579],{},"max-age=60",[13,581,582],{},"Das Manifest zuletzt hochzuladen bedeutet, dass die Website nur eine vollständig hochgeladene Version anbietet, und ein Cache von einer Minute lässt ein Release innerhalb einer Minute erscheinen. Die Header, die ich am 14. November 2026 gesehen habe, passen dazu.",[13,584,585,586,589,590,400,595,598,599,602,603,605,606,609,610,612,613,617,618,622],{},"Die Einstellungen überleben wegen dessen, was nicht geschrieben wird. Die Projekte nutzen die Partitionstabelle ",[20,587,588],{},"huge_app.csv",", in der der ",[25,591,594],{"href":592,"rel":593},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fhuge_app.csv",[48],"Arduino-Core",[20,596,597],{},"nvs"," bei 0x9000 (0x5000 Bytes) und ",[20,600,601],{},"otadata"," bei 0xE000 definiert. Die vier Teile decken die ",[20,604,597],{},"-Region (0x9000 bis 0xDFFF) nicht ab, und ",[20,607,608],{},"eraseAll"," ist ",[20,611,321],{},", also bleiben die Preferences-Daten erhalten. Das folgt aus den Offsets und dem Code. Einen Flash vorher und nachher habe ich nicht gemessen. Die ",[25,614,616],{"href":615},"\u002Fde\u002Fblog\u002Fesp32-partition-table-explained","Anleitung zur Partitionstabelle"," erklärt das Layout, und der ",[25,619,621],{"href":620},"\u002Fde\u002Fblog\u002Fesp32-ota-update-methods-compared","OTA-Vergleich"," erklärt, warum diese Geräte per USB aktualisiert werden, da sie keinen zweiten App-Slot haben.",[13,624,625,626,609,629,632,633,636],{},"Lies bei der offiziellen Komponente die Löschregel genau: ESP Web Tools löscht bei einer Neuinstallation alle Daten, außer ",[20,627,628],{},"new_install_prompt_erase",[20,630,631],{},"true"," und der Nutzer lehnt ab. Es bietet eine Neuinstallation an, wenn es die aktuelle Firmware des Geräts nicht erkennen kann oder wenn die erkannte Firmware nicht zum ",[20,634,635],{},"name"," im Manifest passt.",[38,638,640],{"id":639},"was-geht-am-häufigsten-schief","Was geht am häufigsten schief?",[13,642,643],{},"Die meisten Fehler liegen an Kabel, Port oder Browser, nicht an der Firmware. Arbeite diese Tabelle von oben nach unten ab und ändere immer nur eine Sache.",[121,645],{":headers":646,":rows":647},"[\"Was du siehst\",\"Wahrscheinliche Ursache\",\"Was du versuchen kannst\"]","[[\"Button deaktiviert, oder 'Flashen in diesem Browser nicht möglich'\",\"Browser ohne Web Serial, oder die Seite nutzt kein HTTPS\",\"Nimm Chrome oder Edge auf dem Desktop, über HTTPS oder localhost\"],[\"Die Port-Auswahl zeigt kein Gerät\",\"USB-Kabel nur zum Laden, oder das Board wird nicht erkannt\",\"Nimm ein Datenkabel und einen anderen USB-Port, dann lade die Seite neu\"],[\"Verbindung schlägt fehl, keine seriellen Daten empfangen\",\"Der Chip ist nicht im Download-Modus, oder die USB-Verbindung ist wackelig\",\"Siehe die Anleitung zu 'Failed to connect'\"],[\"'Diese Firmware ist nicht für den angeschlossenen Chip gebaut'\",\"Das Manifest hat keinen Build für diese Chip-Familie\",\"Füge einen Build dafür hinzu, oder nimm das richtige Board\"],[\"'Der Firmware-Download ist mit Status 404 fehlgeschlagen'\",\"Der Pfad eines Teils im Manifest ist falsch\",\"Öffne die URL jedes Teils in einem Tab\"],[\"Manifest nicht lesbar, mit CORS-Fehler in der Konsole\",\"Das CDN erlaubt den Origin deiner Seite nicht\",\"Sende Access-Control-Allow-Origin für deine Domain\"],[\"Das Flashen endet, aber das Board bleibt im Bootloader\",\"Kein echter Reset-Impuls nach dem Flashen\",\"Abziehen und wieder einstecken; ein eigener Hard-Reset wie der oben behebt es\"]]",[13,649,650,651,655],{},"Zur dritten Zeile: ",[25,652,654],{"href":653},"\u002Fde\u002Fblog\u002Fesp32-failed-to-connect-no-serial-data-received","Failed to Connect to ESP32: No Serial Data Received"," geht Boot-Modus, Kabel und Treiber durch. Die Fehlertexte in der Tabelle stammen aus der Übersetzungsdatei der OpenGizmo-Karte, und deine eigene Seite wird etwas anderes anzeigen.",[38,657,659],{"id":658},"wo-endet-das-flashen-im-browser","Wo endet das Flashen im Browser?",[13,661,662],{},"Flashen im Browser gibt dir eine Seite, auf der jeder mit Chrome oder Edge, einem Kabel und einem Board deine Firmware in einer Minute installieren kann, mit erhaltenen Einstellungen und einer Versionsnummer auf dem Bildschirm. Wir haben die Bausteine durchgesprochen: Web Serial über HTTPS, ein Manifest aus Teilen und Offsets (zusammengeführt für ESP Web Tools, oder vier Teile mit esptool-js), CORS, falls die Dateien woanders liegen, und ein Release, das das Manifest zuletzt hochlädt.",[13,664,665,666,669,670,674],{},"Drei Grenzen bleiben. Es deckt nur das Flashen per Kabel ab; für Updates über WLAN siehe den ",[25,667,668],{"href":620},"Vergleich der OTA-Methoden",". Die Browser-Unterstützung außerhalb von Chrome und Edge ist Stand November 2026 dünn, und ich habe nichts davon getestet. Und die offizielle Komponente habe ich nur anhand von Dokumentation und Quellcode beschrieben, nicht aus eigener Nutzung. Wenn du das Ganze in Aktion sehen willst, flasht die ",[25,671,673],{"href":672},"\u002Fde\u002Fblog\u002Fhow-to-build-a-crypto-ticker-with-esp32-and-max7219","Bauanleitung für den Gizmo Ticker"," ein Board von Anfang bis Ende, und jede der drei Projektseiten hat die Karte.",{"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":253,"depth":676,"text":254},{"id":444,"depth":676,"text":445},{"id":479,"depth":676,"text":480},{"id":519,"depth":676,"text":520},{"id":639,"depth":676,"text":640},{"id":658,"depth":676,"text":659},"guides","Anleitungen","2026-11-14T00:00:00Z","ESP32 im Browser flashen mit ESP Web Tools oder esptool-js: So funktionieren Web Serial, Manifest und Flash-Offsets, mit einem echten OpenGizmo-Manifest.","md",[694,697,700,703,706,709],{"question":695,"answer":696},"Kann ich einen ESP32 im Browser flashen, ohne etwas zu installieren?","Ja. Eine Seite mit ESP Web Tools oder esptool-js spricht das Board über die Web Serial API an. Du brauchst nur ein USB-Datenkabel und Chrome oder Edge auf einem Desktop-Rechner. Die Seite muss über HTTPS ausgeliefert werden. Du wählst den seriellen Port, und die Firmware wird direkt aus dem Browser geschrieben.",{"question":698,"answer":699},"Funktioniert ESP Web Tools in Firefox oder Safari?","ESP Web Tools nennt Firefox, Chrome, Edge und Chrome auf Android als unterstützt, iOS aber nicht. Laut den Kompatibilitätsdaten von MDN gibt es Web Serial in Firefox ab Version 151 auf dem Desktop, in Safari gar nicht. Chrome und Edge bleiben die sichere Wahl, die anderen habe ich nicht getestet.",{"question":701,"answer":702},"Brauche ich für ESP Web Tools eine zusammengeführte Firmware-Datei?","Laut Dokumentation von ESP Web Tools muss ESP32-Firmware, die mit ESP-IDF 4 oder neuer gebaut wurde, zu einer einzigen Datei zusammengeführt werden, weil das Tool Flash-Modus, Frequenz und Größe nicht wie esptool anpassen kann. Du erzeugst sie mit esptool merge_bin und trägst sie im Manifest als einen Teil bei Offset 0 ein.",{"question":704,"answer":705},"Löscht Flashen im Browser meine WLAN-Einstellungen?","Nur wenn der Flasher sie löscht. ESP Web Tools löscht bei einer Neuinstallation alle Daten, außer das Manifest setzt new_install_prompt_erase auf true und du lehnst ab. Der OpenGizmo-Flasher schreibt vier Teile und löscht nie den ganzen Chip, daher überleben die Einstellungen in der NVS-Partition ein Update.",{"question":707,"answer":708},"Was ist Improv Wi-Fi?","Improv Wi-Fi ist ein offener Standard, um WLAN-Zugangsdaten über die serielle Schnittstelle an ein Gerät zu senden. Unterstützt die Firmware ihn, fordert ESP Web Tools direkt nach der Installation dazu auf, das Gerät mit einem Netzwerk zu verbinden. Firmware ohne Improv, wie die von OpenGizmo, nutzt dafür stattdessen ein Captive Portal.",{"question":710,"answer":711},"Warum braucht Flashen im Browser HTTPS?","Die Web Serial API gibt es nur in sicheren Kontexten, deshalb muss die Seite mit dem Install-Button über HTTPS ausgeliefert werden (localhost gilt ebenfalls als sicher). Eine normale HTTP-Seite kann keinen seriellen Port öffnen. Liegen Manifest und Firmware auf einem anderen Host, muss dieser Host ebenfalls CORS-Header senden.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg","Ein Mann mit Bart und blauem Hoodie sitzt an einem Laptop, dessen Browser einen orangen Install-Button und einen Fortschritt von 68 % zeigt, ein USB-Kabel führt zum ESP32-Board.","de",{},true,"\u002Fde\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser",{"title":5,"description":691},{"loc":717},"de\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","ESP Web Tools flasht einen ESP32 über Web Serial, in Chrome oder Edge auf einer HTTPS-Seite, mit einer manifest.json, die jeden Firmware-Teil und seinen Flash-Offset auflistet. OpenGizmo macht es mit esptool-js genauso.",[723,724,725,28,726],"ESP32","Firmware","Development Tools","Embedded Systems","egDub5EeXBNC-Fqxwo-c7ivIUzDHxdoEJ5GnXXchItk",[729,735,741,748],{"title":730,"description":731,"image":732,"categoryText":689,"categorySlug":688,"tags":733,"path":615},"ESP32-Partitionstabelle erklärt: Flash-Layout und OTA","Was die ESP32-Partitionstabelle ist, wie die Spalten der partitions.csv funktionieren, die Arduino-ESP32-Schemata mit Größen und was N16R8 bedeutet.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg",[723,724,726,734,28],"PlatformIO",{"title":736,"description":737,"image":738,"categoryText":689,"categorySlug":688,"tags":739,"path":148},"ESP32-CAM-MB: ESP32-CAM per USB programmieren","So programmierst du eine ESP32-CAM mit dem USB-Board ESP32-CAM-MB: was drauf ist, die Tastenfolge IO0 und RST, Flashen aus Chrome und was schiefgehen kann.","\u002Fimages\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide.jpg",[740,723,724,725,28],"ESP32-CAM",{"title":742,"description":743,"image":744,"categoryText":689,"categorySlug":688,"tags":745,"path":27},"Was ist OpenGizmo? Open-Source-ESP32-Gadgets zum Flashen","OpenGizmo ist eine Sammlung von ESP32-Gadgets unter MIT-Lizenz von Mauro Brambilla: ein Krypto-LED-Ticker, ein Schalter für Reolink-NVRs und eine ESP32-CAM.","\u002Fimages\u002Fblog\u002Fwhat-is-open-gizmo.png",[28,746,723,724,747],"Open Source","3D Printing",{"title":749,"description":750,"image":751,"categoryText":689,"categorySlug":688,"tags":752,"path":755},"Was ist ein Mikrocontroller? Aufbau, Beispiele, ESP32","Ein Mikrocontroller ist ein Chip mit CPU, RAM und programmierbaren Pins, der ein Programm ausführt. So funktioniert er, Unterschied zum Pi, Kauftipps.","\u002Fimages\u002Fblog\u002Fwhat-is-a-microcontroller.png",[753,723,726,754,724],"Microcontrollers","Electronics","\u002Fde\u002Fblog\u002Fwhat-is-a-microcontroller",[757,763,769],{"name":758,"slug":759,"path":760,"count":761,"image":762},"Projekte","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":764,"slug":765,"path":766,"count":767,"image":768},"Vergleiche","comparisons","\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",{"name":770,"slug":771,"path":772,"count":773,"image":774},"Fehlerbehebung","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"title":283,"badge":776,"description":777,"path":282,"image":778,"cardIcon":779,"highlights":780},"Open-Source-Projekt mit ESP32 + MAX7219","Ein Krypto-Display mit WLAN, gebaut aus einem ESP32, einer MAX7219-LED-Matrix und einer Nuxt-4-Web-App für die Einrichtung und Konfiguration im Browser.","\u002Fimages\u002Fprojects\u002Fgizmo-ticker\u002Fcover.webp","BitcoinIcon",[781,782,783],"Krypto-Ticker in Echtzeit","MAX7219-LED-Matrix","Einrichtung im Browser",1795018244293]