[{"data":1,"prerenderedAt":801},["ShallowReactive",2],{"post-esp32-partition-table-explained-de":3,"related-posts-esp32-partition-table-explained-de":753,"related-categories-esp32-partition-table-explained-de":784},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":715,"categoryText":716,"dateModified":717,"datePublished":717,"description":718,"extension":719,"faqs":720,"image":736,"imageAlt":737,"language":738,"meta":739,"navigation":740,"path":741,"seo":742,"sitemap":743,"stem":744,"summary":745,"tags":746,"__hash__":752},"blog\u002Fde\u002Fblog\u002Fesp32-partition-table-explained.md","ESP32-Partitionstabelle erklärt: Flash-Layout und OTA","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":703},"minimark",[12,33,50,55,65,72,85,88,93,99,103,125,135,142,185,189,209,212,298,317,321,343,348,388,397,401,425,429,445,460,464,481,487,491,500,513,517,520,582,585,591,606,612,616,619,624,673,676,680,689],[13,14,15,16,20,21,24,25,28,29,32],"p",{},"Die ESP32-Partitionstabelle ist eine kleine Karte im Flash bei Offset 0x8000, die dem Bootloader sagt, wo App, Einstellungsspeicher (",[17,18,19],"code",{},"nvs","), OTA-Daten und Dateisystem liegen. Du legst sie mit einer ",[17,22,23],{},"partitions.csv"," fest oder mit einem eingebauten Schema wie ",[17,26,27],{},"default.csv"," oder ",[17,30,31],{},"huge_app.csv",". Reicht die Tabelle über die echte Flash-Größe hinaus, warnt die esptool-Dokumentation von Espressif, dass der Chip nicht richtig funktioniert.",[13,34,35,36,39,40,45,46,49],{},"Dieser Guide liest die Karte so, wie es der Chip tut: die CSV-Spalten, die Arduino-ESP32-Schemata mit ihren Größen in KB, warum der Bootloader-Offset je nach Chip anders ist und was ",[17,37,38],{},"N16R8"," im Modulnamen für dein Layout bedeutet. Das echte Beispiel ist der ",[41,42,44],"a",{"href":43},"\u002Fde\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",": Ich habe die ",[17,47,48],{},"release-partitions.bin"," dekodiert, die sein Flasher schreibt, und sie mit der Dokumentation von Espressif und den CSV-Dateien von Arduino-ESP32 abgeglichen.",[51,52,54],"h2",{"id":53},"was-ist-die-esp32-partitionstabelle","Was ist die ESP32-Partitionstabelle?",[13,56,57,58,64],{},"Eine Partitionstabelle teilt den externen Flash-Chip in benannte Bereiche mit Typ, Offset und Größe auf. Der ",[41,59,63],{"href":60,"rel":61},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fpartition-tables.html",[62],"nofollow","Partitionstabellen-Guide"," von Espressif sagt, dass sie standardmäßig bei 0x8000 geflasht wird, einen 4-KB-Sektor belegt und 0xC00 Bytes lang ist, weil sie höchstens 95 Einträge zulässt, gefolgt von einer MD5-Prüfsumme, mit der der Bootloader ihre Integrität prüft.",[13,66,67],{},[68,69],"img",{"alt":70,"src":71},"Ein Maker hält ein XIAO-Board neben einen gefalteten Papierstreifen mit farbigen Abschnitten namens nvs und app0, wie eine Karte seines Flashs","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained-illustration.webp",[13,73,74,75,80,81,84],{},"Der Bootloader ist das erste Programm, das aus dem Flash läuft. Die ",[41,76,79],{"href":77,"rel":78},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32s3\u002Fapi-guides\u002Fbootloader.html",[62],"Bootloader-Seite"," von ESP-IDF listet seine Aufgaben auf: anhand der Partitionstabelle und, falls vorhanden, von ",[17,82,83],{},"ota_data"," die App-Partition zum Booten wählen, das Image in den RAM laden und die Kontrolle übergeben. Die Tabelle ist also keine Einstellung in deiner App, sondern eine Datei im Flash, die schon vor deinem Code da ist.",[13,86,87],{},"Eine typische Tabelle enthält vier Arten von Partitionen:",[89,90],"blog-list",{":items":91,"variant":92},"[\"nvs: Schlüssel-Wert-Speicher für Einstellungen und WLAN-Daten, genutzt von der Preferences-Bibliothek\",\"otadata: merkt sich, welcher OTA-App-Slot gebootet wird, 0x2000 Bytes\",\"App-Slots (factory, ota_0, ota_1): die Firmware-Images\",\"Datenpartitionen wie spiffs oder coredump: ein Dateisystem, Absturz-Dumps oder deine eigenen Bytes\"]","circle",[13,94,95],{},[68,96],{"alt":97,"src":98},"Die Flash-Karte des Gizmo Ticker für huge_app.csv auf einem 8-MB-Board: Bootloader, Tabelle, nvs, otadata, ein app0 mit 3 MB, 896 KB spiffs, coredump und 4 MB ohne Partition","\u002Fimages\u002Fblog\u002Fde\u002Fesp32-partition-table-explained-flash-map.webp",[51,100,102],{"id":101},"wie-sieht-eine-partitionscsv-aus","Wie sieht eine partitions.csv aus?",[13,104,105,106,109,110,113,114,117,118,124],{},"Die CSV hat sechs Spalten: name, type, subtype, offset, size und flags. Leerraum wird ignoriert, Zeilen mit ",[17,107,108],{},"#"," am Anfang sind Kommentare, und Größen dürfen hexadezimal, dezimal oder mit ",[17,111,112],{},"K"," und ",[17,115,116],{},"M"," stehen. Ein Name ist höchstens 16 Bytes lang, inklusive Terminator. Hier die echte Tabelle aller OpenGizmo-Firmwares, aus dem ",[41,119,122],{"href":120,"rel":121},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fhuge_app.csv",[62],[17,123,31],{}," des Arduino-ESP32-Cores, gelesen am 14. November 2026 (die Kommentarzeile mit den Spaltennamen fehlt hier):",[126,127,133],"pre",{"className":128,"code":130,"filename":31,"language":131,"meta":132},[129],"language-csv","nvs,      data, nvs,     0x9000,  0x5000,\notadata,  data, ota,     0xe000,  0x2000,\napp0,     app,  ota_0,   0x10000, 0x300000,\nspiffs,   data, spiffs,  0x310000,0xE0000,\ncoredump, data, coredump,0x3F0000,0x10000,\n","csv","",[17,134,130],{"__ignoreMap":132},[13,136,137,138,141],{},"Drei Regeln erklären die meisten Zahlen, alle aus dem ESP-IDF-Guide. Offsets sind Vielfache von 4 KB (0x1000), der Sektorgröße des Flashs. Eine ",[17,139,140],{},"app","-Partition muss bei einem Vielfachen von 64 KB (0x10000) beginnen. Deshalb liegt die erste App bei 0x10000, und der Bereich von 0x9000 bis 0xFFFF davor enthält nur kleine Datenpartitionen. Und lässt du einen Offset leer, beginnt die Partition direkt nach der vorherigen, App-Partitionen werden dabei für dich ausgerichtet.",[13,143,144,145,147,148,151,152,154,155,158,159,162,163,165,166,168,169,172,173,176,177,180,181,184],{},"Bootloader und Bibliotheken suchen nach Typ und Subtyp, nicht nach dem Namen. Laut demselben Guide ist die standardmäßige ",[17,146,19],{},"-Partition die mit Typ ",[17,149,150],{},"data"," und Subtyp ",[17,153,19],{},", und ",[17,156,157],{},"otadata"," hat den Subtyp ",[17,160,161],{},"ota",". Die binäre Tabelle, die der Flasher schreibt, speichert sie als Zahlen. Ich habe die ausgelieferte Datei mit ein paar Zeilen Python dekodiert: ",[17,164,19],{}," ist data\u002F0x02, ",[17,167,157],{}," ist data\u002F0x00, ",[17,170,171],{},"app0"," ist app\u002F0x10 (",[17,174,175],{},"ota_0","), ",[17,178,179],{},"spiffs"," ist data\u002F0x82 und ",[17,182,183],{},"coredump"," ist data\u002F0x03.",[51,186,188],{"id":187},"welche-partitionstabelle-nutzen-die-opengizmo-firmwares","Welche Partitionstabelle nutzen die OpenGizmo-Firmwares?",[13,190,191,192,195,196,199,200,205,206,208],{},"Alle drei setzen in der ",[17,193,194],{},"platformio.ini"," ",[17,197,198],{},"board_build.partitions = huge_app.csv",", zum Beispiel in der ",[41,201,204],{"href":202,"rel":203},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[62],"Datei des Tickers",", mit dem Kommentar \"One 3 MB app slot (no wireless updates), the same in every OpenGizmo firmware\". Die ",[17,207,48],{},"-Dateien des Tickers v1.2.0, des Reolink Switch v1.2.0 und der Camera v1.0.0, wie sie am 14. November 2026 vom CDN geliefert wurden, sind Byte für Byte identisch (3.072 Bytes) und lassen sich genau in die CSV oben dekodieren.",[13,210,211],{},"Was heißt das für die Hardware?",[213,214,215,231,237,262],"ul",{},[216,217,218,222,223,225,226,230],"li",{},[219,220,221],"strong",{},"Ein App-Slot, kein OTA."," Es gibt einen einzigen ",[17,224,175],{},"-Slot mit 3 MB (3.072 KB) und keinen zweiten, ein neues Image hat also keinen Platz, solange das alte läuft. Der ",[41,227,229],{"href":228},"\u002Fde\u002Fblog\u002Fesp32-ota-update-methods-compared","Vergleich der OTA-Methoden"," erklärt, warum das WLAN-Updates ausschließt, und vergleicht die Slot-Größen mit der echten App.",[216,232,233,236],{},[219,234,235],{},"Luft nach oben."," Die Ticker-App v1.2.0 ist 1.796.736 Bytes groß, etwa 57 % des Slots. Die App des Reolink Switch hat 1.778.336 Bytes und die der Camera 1.722.192 Bytes, entnommen aus den Größen der Release-Dateien.",[216,238,239,242,243,248,249,252,253,256,257,261],{},[219,240,241],{},"Einstellungen sind sicher."," Die Preferences-Bibliothek ",[41,244,247],{"href":245,"rel":246},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Fapi\u002Fpreferences.html",[62],"speichert Daten in der NVS-Partition",", und die ",[17,250,251],{},"storage.cpp"," von Ticker und Reolink Switch nutzen beide Preferences. Der Flasher schreibt Bootloader, Tabelle, ",[17,254,255],{},"boot_app0"," und App, und nichts davon überlappt 0x9000 bis 0xDFFF, wie der ",[41,258,260],{"href":259},"\u002Fde\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","Guide zum Flashen im Browser"," beschreibt.",[216,263,264,267,268,270,271,274,275,113,278,280,281,284,285,288,289,291,292,297],{},[219,265,266],{},"Ein ungenutztes Dateisystem."," Die 896 KB große ",[17,269,179],{},"-Partition ist deklariert, aber eine Suche nach ",[17,272,273],{},"LittleFS",", ",[17,276,277],{},"SPIFFS",[17,279,179],{}," in den ",[17,282,283],{},"microcontroller\u002F","-Quellen aller drei Firmwares findet nichts. Die gemeinsame Bibliothek ",[17,286,287],{},"gizmo-common"," deckt diese Suche nicht ab. In die 64 KB große ",[17,290,183],{},"-Partition schreibt die ",[41,293,296],{"href":294,"rel":295},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fcore_dump.html",[62],"Core-Dump-Funktion"," von ESP-IDF Absturzdaten. Ob diese Firmwares sie aktivieren, habe ich nicht geprüft.",[13,299,300,301,306,307,310,311,313,314,316],{},"Ein Detail übersieht man leicht. Das XIAO ESP32-S3 hat laut ",[41,302,305],{"href":303,"rel":304},"https:\u002F\u002Fwiki.seeedstudio.com\u002Fxiao_esp32s3_getting_started\u002F",[62],"Seeeds Wiki"," 8 MB Flash (das Plus-Modell 16 MB), und die Board-Datei von PlatformIO verweist auf ",[17,308,309],{},"default_8MB.csv",". Die OpenGizmo-Umstellung auf ",[17,312,31],{}," endet bei 0x400000, die oberen 4 MB dieses Flashs haben also gar keine Partition. Sie leer zu lassen kostet nichts, und der Kommentar in der ",[17,315,194],{}," der Firmware sagt genau das: dieselbe Tabelle in jeder OpenGizmo-Firmware, auch in der ESP32-CAM mit 4 MB.",[51,318,320],{"id":319},"welche-standard-partitionsschemata-hat-arduino-esp32","Welche Standard-Partitionsschemata hat Arduino-ESP32?",[13,322,323,324,332,333,336,337,342],{},"Der Arduino-ESP32-Core bringt Dutzende fertige Tabellen im ",[41,325,328,329],{"href":326,"rel":327},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Ftree\u002Fmaster\u002Ftools\u002Fpartitions",[62],"Ordner ",[17,330,331],{},"tools\u002Fpartitions"," mit: Am 14. November 2026 waren es mehr als 50 Dateien. In der Arduino IDE sind sie das Menü Werkzeuge, Partition Scheme, und in PlatformIO trägst du den Dateinamen in ",[17,334,335],{},"board_build.partitions"," ein, wie die ",[41,338,341],{"href":339,"rel":340},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fplatforms\u002Fespressif32.html",[62],"PlatformIO-Doku zu Espressif 32"," zeigt. Diese begegnen dir am häufigsten:",[344,345],"blog-table",{":headers":346,":rows":347},"[\"Schema-Datei\",\"Nötiger Flash (MB)\",\"App-Slots\",\"Jeder App-Slot (KB)\",\"Dateisystem (KB)\"]","[[\"default.csv\",\"4\",\"2 (OTA)\",\"1.280\",\"1.408\"],[\"min_spiffs.csv\",\"4\",\"2 (OTA)\",\"1.920\",\"128\"],[\"no_ota.csv\",\"4\",\"1\",\"2.048\",\"1.920\"],[\"huge_app.csv\",\"4\",\"1\",\"3.072\",\"896\"],[\"default_8MB.csv\",\"8\",\"2 (OTA)\",\"3.264\",\"1.536\"],[\"default_16MB.csv\",\"16\",\"2 (OTA)\",\"6.400\",\"3.456\"]]",[13,349,350,351,274,357,274,364,274,371,113,377,384,385,387],{},"Die KB-Werte habe ich aus den Offsets und Größen jeder CSV berechnet (",[41,352,355],{"href":353,"rel":354},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fdefault.csv",[62],[17,356,27],{},[41,358,361],{"href":359,"rel":360},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fmin_spiffs.csv",[62],[17,362,363],{},"min_spiffs.csv",[41,365,368],{"href":366,"rel":367},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fno_ota.csv",[62],[17,369,370],{},"no_ota.csv",[41,372,375],{"href":373,"rel":374},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fdefault_8MB.csv",[62],[17,376,309],{},[41,378,381],{"href":379,"rel":380},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Fblob\u002Fmaster\u002Ftools\u002Fpartitions\u002Fdefault_16MB.csv",[62],[17,382,383],{},"default_16MB.csv","). Die Spalte \"Nötiger Flash\" gibt an, wo die letzte Partition endet, ein 64 KB großes ",[17,386,183],{},": 0x400000, 0x800000 oder 0x1000000. Diese Dateien ändern sich zwischen Core-Releases, prüfe also die Version, mit der du baust.",[13,389,390,391,393,394,396],{},"Das Muster ist der Kompromiss, um den sich die ganze Tabelle dreht. Flash ist ein festes Budget, und jeder App-Slot, das Dateisystem und die OTA-Daten konkurrieren darum. Eine Tabelle mit zwei App-Slots halbiert den Platz pro Slot. Darum passt eine 1,7-MB-App wie die des Tickers nicht in die 1.280-KB-Slots von ",[17,392,27],{},", und darum verzichtet ",[17,395,31],{}," auf den zweiten Slot, um einen großen zu bekommen.",[51,398,400],{"id":399},"warum-unterscheiden-sich-die-flash-offsets-je-nach-chip","Warum unterscheiden sich die Flash-Offsets je nach Chip?",[13,402,403,404,409,410,274,414,113,419,424],{},"Die Tabelle selbst liegt beim klassischen ESP32 und beim ESP32-S3 bei 0x8000, aber der Bootloader wandert. Die Bootloader-Seiten von ESP-IDF sagen, dass der Second-Stage-Bootloader ",[41,405,408],{"href":406,"rel":407},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[62],"beim ESP32 bei 0x1000"," liegt und beim ",[41,411,413],{"href":77,"rel":412},[62],"ESP32-S3",[41,415,418],{"href":416,"rel":417},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32c3\u002Fapi-guides\u002Fbootloader.html",[62],"ESP32-C3",[41,420,423],{"href":421,"rel":422},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32c6\u002Fapi-guides\u002Fbootloader.html",[62],"ESP32-C6"," bei 0x0. Die OpenGizmo-Manifeste zeigen den Effekt:",[344,426],{":headers":427,":rows":428},"[\"Teil\",\"Gizmo Camera (ESP32)\",\"Gizmo Ticker (ESP32-S3)\",\"Größe (Bytes)\"]","[[\"Bootloader\",\"0x1000 (4096)\",\"0x0 (0)\",\"23.520 beim ESP32, 19.968 beim S3\"],[\"Partitionstabelle\",\"0x8000 (32768)\",\"0x8000 (32768)\",\"3.072\"],[\"boot_app0\",\"0xE000 (57344)\",\"0xE000 (57344)\",\"8.192\"],[\"App\",\"0x10000 (65536)\",\"0x10000 (65536)\",\"1.722.192 bei der Camera, 1.796.736 beim Ticker\"]]",[13,430,431,432,435,436,438,439,441,442,444],{},"Die Manifeste liegen auf ",[17,433,434],{},"cdn.opengizmo.dev",", und die Größen stammen aus den Dateien, die sie auflisten. Beachte, dass ",[17,437,255],{}," 8.192 Bytes groß ist und bei 0xE000 liegt, also genau Offset und Größe von ",[17,440,157],{}," in der Tabelle oben. Sein erster Sektor beginnt mit dem Wert 1 und ist bis auf ein paar Bytes sonst mit 0xFF gefüllt, der zweite Sektor beginnt mit 0. Das passt zu einem anfänglichen OTA-Data-Image, das den ersten App-Slot auswählt, aber ich habe es nicht am Quellcode von ESP-IDF geprüft, nimm es also als Schlussfolgerung. Wenn du eine eigene Tabelle entwirfst, halte diesen Offset im Gleichschritt mit der Stelle, an die du ",[17,443,157],{}," legst, oder prüfe, was dein Build-Tool schreibt.",[13,446,447,448,451,452,455,456,459],{},"Auch der Offset der Tabelle selbst ist nicht fest: ESP-IDF setzt ihn mit ",[17,449,450],{},"CONFIG_PARTITION_TABLE_OFFSET"," und sagt, du sollst feste Offsets in deiner CSV anpassen, wenn du ihn änderst. Der ",[41,453,454],{"href":259},"Beitrag zum Flashen im Browser"," zeigt, wie diese Offsets in einer ",[17,457,458],{},"manifest.json"," landen.",[51,461,463],{"id":462},"was-bedeuten-n16r8-und-n8r2","Was bedeuten N16R8 und N8R2?",[13,465,466,467,470,471,474,475,480],{},"In einem Espressif-Modulnamen ist ",[17,468,469],{},"N"," die Flash-Größe in Megabyte und ",[17,472,473],{},"R"," die PSRAM-Größe in Megabyte. Das ",[41,476,479],{"href":477,"rel":478},"https:\u002F\u002Fdocumentation.espressif.com\u002Fesp32-s3-wroom-1_wroom-1u_datasheet_en.pdf",[62],"Datenblatt des ESP32-S3-WROOM-1"," von Espressif (Version 1.8) listet sie in seinen Vergleichstabellen auf. PSRAM ist zusätzlicher RAM auf einem separaten Die und taucht deshalb nie in der Partitionstabelle auf. Nur die Flash-Zahl zählt.",[13,482,483],{},[68,484],{"alt":485,"src":486},"Der Modulcode N16R8 in zwei Hälften: N16 sind 16 MB Quad-SPI-Flash, in dem die Partitionstabelle liegt, R8 sind 8 MB Octal-PSRAM, das RAM ist und GPIO35 bis GPIO37 belegt","\u002Fimages\u002Fblog\u002Fde\u002Fesp32-partition-table-explained-module-code.webp",[344,488],{":headers":489,":rows":490},"[\"Modul\",\"Flash (MB)\",\"PSRAM (MB)\",\"Passende Tabelle\"]","[[\"ESP32-S3-WROOM-1-N8R2\",\"8, Quad SPI\",\"2, Quad SPI\",\"default_8MB.csv\"],[\"ESP32-S3-WROOM-1-N8R8\",\"8, Quad SPI\",\"8, Octal SPI\",\"default_8MB.csv\"],[\"ESP32-S3-WROOM-1-N16R8\",\"16, Quad SPI\",\"8, Octal SPI\",\"default_16MB.csv\"]]",[13,492,493,494,499],{},"Hinter dieser Tabelle stecken zwei praktische Punkte. Erstens sagt das Datenblatt, dass bei Modulen mit Octal-PSRAM (den Serien R8 und R16V) die Pins IO35, IO36 und IO37 mit dem PSRAM verbunden sind und nicht für andere Zwecke zur Verfügung stehen, ein N16R8 verliert also drei GPIOs, die ein N8R2 behält. Zweitens ist \"Passende Tabelle\" meine Zuordnung, nicht die von Espressif: Jede Tabelle funktioniert, solange sie innerhalb der Flash-Größe endet. Die ",[41,495,498],{"href":496,"rel":497},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fflash-modes.html",[62],"esptool-Dokumentation"," warnt, dass Partitionen in die konfigurierte Größe passen müssen, sonst funktioniert der ESP32 nicht richtig.",[13,501,502,503,507,508,512],{},"Das XIAO ESP32-S3 ist ein Board und kein WROOM-Modul, aber Seeeds Wiki nennt dasselbe Paar an Fakten: den Chip ESP32-S3R8 mit 8 MB PSRAM und 8 MB Flash. Welchen Chip du überhaupt kaufen solltest, steht in ",[41,504,506],{"href":505},"\u002Fde\u002Fblog\u002Fwhich-esp32-chip-should-you-buy","Welchen ESP32 solltest du kaufen?"," und im ",[41,509,511],{"href":510},"\u002Fde\u002Fblog\u002Fxiao-esp32s3-vs-c3-vs-c6","XIAO-Vergleich",".",[51,514,516],{"id":515},"wie-dimensionierst-du-app-ota-und-dateisystem-partitionen","Wie dimensionierst du App-, OTA- und Dateisystem-Partitionen?",[13,518,519],{},"Geh von der App-Größe nach außen vor und schreib die Tabelle auf, bevor du sie flashst.",[521,522,523,533,552,567,576],"ol",{},[216,524,525,528,529,532],{},[219,526,527],{},"Miss die App."," Baue die Firmware und lies die Größe der ",[17,530,531],{},".bin"," ab. Beim Ticker sind es zum Beispiel 1.796.736 Bytes.",[216,534,535,538,539,541,542,547,548,551],{},[219,536,537],{},"Entscheide dich für oder gegen OTA."," Für Updates per WLAN brauchst du ",[17,540,157],{}," plus zwei App-Slots, laut ",[41,543,546],{"href":544,"rel":545},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-reference\u002Fsystem\u002Fota.html",[62],"ESP-IDF-OTA-Doku",", wie im ",[41,549,550],{"href":228},"OTA-Vergleich"," zusammengefasst. Jeder Slot muss die App mit Luft zum Wachsen aufnehmen können.",[216,553,554,560,561,566],{},[219,555,556,557,559],{},"Plane ",[17,558,19],{}," realistisch."," Die ",[41,562,565],{"href":563,"rel":564},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-reference\u002Fstorage\u002Fnvs_flash.html",[62],"NVS-Dokumentation"," nennt 12 KiB (0x3000) als Minimum für normalen Lese- und Schreibbetrieb. Die Arduino-Tabellen nutzen 0x5000 (20 KB).",[216,568,569,572,573,575],{},[219,570,571],{},"Gib den Rest für ein Dateisystem aus oder verzichte darauf."," Wenn es niemand einhängt, ist ein ungenutztes ",[17,574,179],{}," verschwendeter Platz, den du den App-Slots geben könntest.",[216,577,578,581],{},[219,579,580],{},"Prüfe die Summe."," Die letzte Partition muss spätestens an der Flash-Größe enden, und jeder App-Offset muss ein Vielfaches von 0x10000 sein.",[13,583,584],{},"Ein Board mit 8 MB, zwei 3-MB-Slots und einem kleinen Dateisystem könnte zum Beispiel die folgende Tabelle nutzen. Das ist meine eigene Rechnung, keine Tabelle, die ich gebaut oder geflasht habe, nimm sie also als Vorlage:",[126,586,589],{"className":587,"code":588,"filename":23,"language":131,"meta":132},[129],"nvs,      data, nvs,     0x9000,   0x5000,\notadata,  data, ota,     0xe000,   0x2000,\napp0,     app,  ota_0,   0x10000,  0x300000,\napp1,     app,  ota_1,   0x310000, 0x300000,\nspiffs,   data, spiffs,  0x610000, 0x1E0000,\ncoredump, data, coredump,0x7F0000, 0x10000,\n",[17,590,588],{"__ignoreMap":132},[13,592,593,594,596,597,602,603,605],{},"Die letzte Zeile endet bei 0x800000, genau 8 MB. Speichere sie in der Arduino IDE als ",[17,595,23],{}," im Sketch-Ordner, dann nutzt der Build sie statt der vordefinierten Tabellen, wie das ",[41,598,601],{"href":599,"rel":600},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Ftutorials\u002Fpartition_table.html",[62],"Arduino-ESP32-Tutorial zu Partitionen"," beschreibt. In PlatformIO zeigst du mit ",[17,604,335],{}," auf die Datei.",[13,607,608,609,611],{},"Eine Änderung der Tabelle hat ihren Preis. ESP-IDF sagt, dass ein Update der Tabelle Daten, die unter der alten Tabelle gespeichert waren, nicht löscht. Da jede Partition über ihren Offset gefunden wird, liest eine verschobene oder in der Größe geänderte Partition die Bytes, die jetzt dort liegen (das ist meine Lesart, wie Offsets funktionieren, kein Zitat aus der Doku). Lass ",[17,610,19],{}," dort, wo es ist, und die gespeicherten Einstellungen funktionieren weiter. Sonst plane einen sauberen Neustart ein.",[51,613,615],{"id":614},"wie-findest-du-die-offsets-und-die-flash-größe-eines-boards","Wie findest du die Offsets und die Flash-Größe eines Boards?",[13,617,618],{},"Drei Befehle reichen. Die ersten beiden lesen deinen Build und deinen Chip, der dritte liest, was wirklich auf dem Board ist.",[620,621],"terminal",{":commands":622,"title":623},"[\"pio project metadata -e release --json-output\",\"esptool flash-id\",\"esptool -p \u002Fdev\u002FttyACM0 read-flash 0x8000 0x1000 table.bin\"]","Offsets aus dem Build, Flash-Größe vom Chip",[213,625,626,642,656],{},[216,627,628,633,634,641],{},[219,629,630],{},[17,631,632],{},"pio project metadata"," gibt die Flash-Images mit ihren Adressen und den Offset der Anwendung aus. Das ",[41,635,638],{"href":636,"rel":637},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fscripts\u002Fpackage_firmware.py",[62],[17,639,640],{},"package_firmware.py"," des Tickers liest genau das, um das Manifest zu schreiben, du tippst also nie einen Offset von Hand.",[216,643,644,649,650,655],{},[219,645,646],{},[17,647,648],{},"esptool flash-id"," gibt den Hersteller, die Geräte-ID und die \"Detected flash size\" aus, laut den ",[41,651,654],{"href":652,"rel":653},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[62],"grundlegenden esptool-Befehlen",". Führe es aus, bevor du eine Tabelle für ein Board wählst, das du nicht selbst gekauft hast.",[216,657,658,663,664,668,669,672],{},[219,659,660],{},[17,661,662],{},"read-flash"," kopiert die Tabelle vom Board. Der ",[41,665,667],{"href":60,"rel":666},[62],"ESP-IDF-Guide"," dokumentiert ",[17,670,671],{},"gen_esp32part.py",", um eine binäre Tabelle zurück in CSV zu wandeln. Ich habe die ausgelieferten Dateien stattdessen mit einem eigenen kurzen Skript dekodiert.",[13,674,675],{},"Die Befehlsnamen sind die Formen mit Bindestrich, die die aktuelle esptool-Dokumentation nutzt, ältere Versionen schrieben sie mit Unterstrich. Passe sie an die Version an, die du installiert hast.",[51,677,679],{"id":678},"was-entscheidet-die-partitionstabelle-für-dich","Was entscheidet die Partitionstabelle für dich?",[13,681,682,683,685,686,688],{},"Die ESP32-Partitionstabelle entscheidet, wie ein Flash-Chip fester Größe zwischen deiner App, einer möglichen zweiten App, deinen Einstellungen und einem Dateisystem aufgeteilt wird. Für OpenGizmo ist die Antwort eine bewusste: ",[17,684,31],{},", ein 3-MB-Slot, etwa 57 % davon von der größten App belegt, Einstellungen in ",[17,687,19],{},", die ein USB-Update nie anfasst, und kein OTA.",[13,690,691,692,694,695,697,698,702],{},"Die Grenzen sollte man laut aussprechen. Ich habe die Tabellen gelesen und die ausgelieferten Binärdateien dekodiert, aber keine geänderte Tabelle auf ein Board geflasht, die eigene CSV oben ist also reine Rechnung, und die Rolle von ",[17,693,255],{}," ist eine Schlussfolgerung aus Offset, Größe und ersten Bytes. Als Nächstes lohnt sich der ",[41,696,229],{"href":228},", der zeigt, was ein zweiter Slot dieses Layout kosten würde, oder der Beitrag ",[41,699,701],{"href":700},"\u002Fde\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs PlatformIO",", wenn du noch wählst, wo du das Schema festlegst.",{"title":132,"searchDepth":704,"depth":704,"links":705},2,[706,707,708,709,710,711,712,713,714],{"id":53,"depth":704,"text":54},{"id":101,"depth":704,"text":102},{"id":187,"depth":704,"text":188},{"id":319,"depth":704,"text":320},{"id":399,"depth":704,"text":400},{"id":462,"depth":704,"text":463},{"id":515,"depth":704,"text":516},{"id":614,"depth":704,"text":615},{"id":678,"depth":704,"text":679},"guides","Anleitungen","2026-11-14T00:00:00Z","Was die ESP32-Partitionstabelle ist, wie die Spalten der partitions.csv funktionieren, die Arduino-ESP32-Schemata mit Größen und was N16R8 bedeutet.","md",[721,724,727,730,733],{"question":722,"answer":723},"Wo liegt die Partitionstabelle auf einem ESP32?","Laut ESP-IDF-Dokumentation liegt die ESP32-Partitionstabelle standardmäßig im Flash bei Offset 0x8000. Sie belegt genau einen 4-KB-Sektor und fasst bis zu 95 Einträge plus eine MD5-Prüfsumme. Der Bootloader liest sie bei jedem Start ein, um die App- und die Datenpartitionen zu finden.",{"question":725,"answer":726},"Wie ändere ich das Partitionsschema in Arduino IDE oder PlatformIO?","In der Arduino IDE wählst du unter Werkzeuge, Partition Scheme ein Layout, oder legst eine partitions.csv neben deinen Sketch. In PlatformIO setzt du board_build.partitions in der platformio.ini auf eine eingebaute Tabelle wie huge_app.csv oder auf eine eigene CSV-Datei im Projektordner.",{"question":728,"answer":729},"Was bedeutet N16R8 bei einem ESP32-S3-Modul?","Bei ESP32-S3-WROOM-1-N16R8 steht N16 für 16 MB Quad-SPI-Flash und R8 für 8 MB Octal-SPI-PSRAM, laut dem Datenblatt von Espressif. Die Flash-Größe bestimmt, wie groß deine Partitionstabelle werden darf. Das PSRAM ist zusätzlicher Arbeitsspeicher und taucht in der Partitionstabelle gar nicht auf.",{"question":731,"answer":732},"Ändert PSRAM die ESP32-Partitionstabelle?","Nein. PSRAM ist RAM, hat also keine Partition und belegt keinen Flash. Für die Tabelle zählt nur die Flash-Größe. Ein Modul mit Octal-PSRAM wie das N16R8 reserviert allerdings GPIO35 bis GPIO37 für das PSRAM. Das schränkt deine Pinwahl ein, ändert aber nichts an den Partitionen.",{"question":734,"answer":735},"Löscht das Flashen einer neuen Partitionstabelle meine Daten?","Laut ESP-IDF-Dokumentation löscht das Flashen einer Partitionstabelle den übrigen Flash-Inhalt nicht. Daten werden aber über den Offset gelesen: Verschiebt die neue Tabelle eine Partition oder ändert ihre Größe, wird der alte Inhalt dort falsch gelesen. Bleibt nvs an derselben Stelle mit derselben Größe, überleben die gespeicherten Einstellungen.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg","Ein Maker mit Brille schiebt einen blauen app0-Block in eine Lücke in einem langen Flash-Balken aus nvs-, app1- und spiffs-Blöcken, links ein kleines Chip-Symbol.","de",{},true,"\u002Fde\u002Fblog\u002Fesp32-partition-table-explained",{"title":5,"description":718},{"loc":741},"de\u002Fblog\u002Fesp32-partition-table-explained","Die ESP32-Partitionstabelle liegt bei 0x8000 und teilt den Flash in nvs, otadata, App und Dateisystem. Die huge_app.csv von OpenGizmo gibt einen App-Slot mit 3 MB und kein OTA.",[747,748,749,750,751],"ESP32","Firmware","Embedded Systems","PlatformIO","OpenGizmo","s7exHzsyaKpwpWprJUTthREA15PhJIKqHornjd1oNmQ",[754,760,769,776],{"title":755,"description":756,"image":757,"categoryText":716,"categorySlug":715,"tags":758,"path":259},"ESP Web Tools: ESP32 im Browser flashen","ESP32 im Browser flashen mit ESP Web Tools oder esptool-js: So funktionieren Web Serial, Manifest und Flash-Offsets, mit einem echten OpenGizmo-Manifest.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg",[747,748,759,751,749],"Development Tools",{"title":761,"description":762,"image":763,"categoryText":764,"categorySlug":765,"tags":766,"path":768},"ESPHome oder eigene Firmware auf dem ESP32: Was passt?","ESPHome oder eigene ESP32-Firmware? Eine Entscheidungstabelle, was ESPHome nicht kann und warum Web-App, Portal und MCP-Server von OpenGizmo PlatformIO nutzen.","\u002Fimages\u002Fblog\u002Fesphome-vs-custom-esp32-firmware.jpg","Vergleiche","comparisons",[747,748,767,750,751],"Home Automation","\u002Fde\u002Fblog\u002Fesphome-vs-custom-esp32-firmware",{"title":770,"description":771,"image":772,"categoryText":716,"categorySlug":715,"tags":773,"path":775},"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",[774,747,748,759,751],"ESP32-CAM","\u002Fde\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide",{"title":777,"description":778,"image":779,"categoryText":716,"categorySlug":715,"tags":780,"path":783},"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",[781,747,749,782,748],"Microcontrollers","Electronics","\u002Fde\u002Fblog\u002Fwhat-is-a-microcontroller",[785,791,797],{"name":786,"slug":787,"path":788,"count":789,"image":790},"Projekte","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":792,"slug":793,"path":794,"count":795,"image":796},"Fehlerbehebung","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"name":764,"slug":765,"path":798,"count":799,"image":800},"\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",1795018245271]