[{"data":1,"prerenderedAt":800},["ShallowReactive",2],{"post-esp32-partition-table-explained-it":3,"related-posts-esp32-partition-table-explained-it":752,"related-categories-esp32-partition-table-explained-it":783},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":714,"categoryText":715,"dateModified":716,"datePublished":716,"description":717,"extension":718,"faqs":719,"image":735,"imageAlt":736,"language":737,"meta":738,"navigation":739,"path":740,"seo":741,"sitemap":742,"stem":743,"summary":744,"tags":745,"__hash__":751},"blog\u002Fit\u002Fblog\u002Fesp32-partition-table-explained.md","Tabella delle partizioni ESP32: layout flash e OTA","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":702},"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,426,430,446,460,464,481,487,491,500,512,516,519,581,584,590,605,611,615,618,623,672,675,679,688],[13,14,15,16,20,21,24,25,28,29,32],"p",{},"La tabella delle partizioni dell'ESP32 è una piccola mappa salvata nella flash all'offset 0x8000, che dice al bootloader dove stanno l'app, lo spazio per le impostazioni (",[17,18,19],"code",{},"nvs","), i dati OTA e il filesystem. La scegli con un file ",[17,22,23],{},"partitions.csv"," o con uno schema integrato come ",[17,26,27],{},"default.csv"," o ",[17,30,31],{},"huge_app.csv",". Se la tabella supera la flash reale, la documentazione di esptool di Espressif avverte che il chip non funzionerà correttamente.",[13,34,35,36,39,40,45,46,49],{},"In questa guida leggiamo quella mappa come la legge il chip: le colonne del CSV, gli schemi Arduino-ESP32 con le dimensioni in KB, perché l'offset del bootloader cambia da un chip all'altro e cosa significa ",[17,37,38],{},"N16R8"," nel nome di un modulo per il tuo layout. L'esempio reale è il ",[41,42,44],"a",{"href":43},"\u002Fit\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",": ho decodificato il ",[17,47,48],{},"release-partitions.bin"," che scrive il suo flasher e l'ho confrontato con la documentazione di Espressif e con i file CSV di Arduino-ESP32.",[51,52,54],"h2",{"id":53},"cosè-la-tabella-delle-partizioni-dellesp32","Cos'è la tabella delle partizioni dell'ESP32?",[13,56,57,58,64],{},"Una tabella delle partizioni divide il chip di flash esterna in regioni con un nome, un tipo, un offset e una dimensione. La ",[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","guida alle partition table"," di Espressif dice che di default viene flashata a 0x8000, occupa un settore da 4 KB ed è lunga 0xC00 byte, perché ammette al massimo 95 voci, seguite da un checksum MD5 che il bootloader usa per controllarne l'integrità.",[13,66,67],{},[68,69],"img",{"alt":70,"src":71},"Un maker tiene in mano una scheda XIAO accanto a una striscia di carta piegata con sezioni colorate etichettate nvs e app0, come una mappa della sua flash","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained-illustration.webp",[13,73,74,75,80,81,84],{},"Il bootloader è il primo programma che gira dalla flash. La ",[41,76,79],{"href":77,"rel":78},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32s3\u002Fapi-guides\u002Fbootloader.html",[62],"pagina sul bootloader"," di ESP-IDF ne elenca i compiti: scegliere la partizione dell'applicazione da avviare in base alla tabella delle partizioni e a ",[17,82,83],{},"ota_data",", se c'è, caricare l'immagine in RAM e passarle il controllo. Quindi la tabella non è un'impostazione dentro la tua app: è un file nella flash che esiste prima del tuo codice.",[13,86,87],{},"Una tabella tipica contiene quattro tipi di partizioni:",[89,90],"blog-list",{":items":91,"variant":92},"[\"nvs: archivio chiave-valore per impostazioni e dati Wi-Fi, usato dalla libreria Preferences\",\"otadata: segna quale slot app OTA avviare, 0x2000 byte\",\"slot app (factory, ota_0, ota_1): le immagini del firmware\",\"partizioni di dati come spiffs o coredump: un filesystem, i dump dei crash o i tuoi byte\"]","circle",[13,94,95],{},[68,96],{"alt":97,"src":98},"La mappa della flash del Gizmo Ticker per huge_app.csv su una scheda da 8 MB: bootloader, tabella, nvs, otadata, un app0 da 3 MB, 896 KB di spiffs, coredump e 4 MB senza partizione","\u002Fimages\u002Fblog\u002Fit\u002Fesp32-partition-table-explained-flash-map.webp",[51,100,102],{"id":101},"che-aspetto-ha-un-file-partitionscsv","Che aspetto ha un file partitions.csv?",[13,104,105,106,109,110,113,114,117,118,124],{},"Il CSV ha sei colonne: name, type, subtype, offset, size e flags. Gli spazi vengono ignorati, le righe che iniziano con ",[17,107,108],{},"#"," sono commenti e le dimensioni possono essere in esadecimale, in decimale o con ",[17,111,112],{},"K"," e ",[17,115,116],{},"M",". Un nome è lungo al massimo 16 byte, terminatore compreso. Ecco la tabella reale di tutti i firmware OpenGizmo, dal ",[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],{}," del core Arduino-ESP32, letto il 14 novembre 2026 (qui manca la riga di commento con i nomi delle colonne):",[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],{},"Tre regole spiegano la maggior parte dei numeri, tutte dalla guida ESP-IDF. Gli offset sono multipli di 4 KB (0x1000), la dimensione del settore della flash. Una partizione ",[17,139,140],{},"app"," deve iniziare a un multiplo di 64 KB (0x10000): per questo la prima app sta a 0x10000 e la zona da 0x9000 a 0xFFFF, prima di lei, contiene solo piccole partizioni di dati. E se lasci vuoto un offset, la partizione parte subito dopo la precedente, con le partizioni app allineate al posto tuo.",[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],{},"Il bootloader e le librerie cercano tipo e sottotipo, non il nome. Sempre secondo la guida, la partizione ",[17,146,19],{}," predefinita è quella con tipo ",[17,149,150],{},"data"," e sottotipo ",[17,153,19],{},", e ",[17,156,157],{},"otadata"," ha sottotipo ",[17,160,161],{},"ota",". La tabella binaria che scrive il flasher li salva come numeri. Ho decodificato il file distribuito con poche righe di Python: ",[17,164,19],{}," è data\u002F0x02, ",[17,167,157],{}," è data\u002F0x00, ",[17,170,171],{},"app0"," è app\u002F0x10 (",[17,174,175],{},"ota_0","), ",[17,178,179],{},"spiffs"," è data\u002F0x82 e ",[17,182,183],{},"coredump"," è data\u002F0x03.",[51,186,188],{"id":187},"quale-tabella-delle-partizioni-usano-i-firmware-opengizmo","Quale tabella delle partizioni usano i firmware OpenGizmo?",[13,190,191,192,195,196,199,200,205,206,208],{},"Tutti e tre impostano ",[17,193,194],{},"board_build.partitions = huge_app.csv"," in ",[17,197,198],{},"platformio.ini",", per esempio nel ",[41,201,204],{"href":202,"rel":203},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[62],"file del Ticker",", con il commento \"One 3 MB app slot (no wireless updates), the same in every OpenGizmo firmware\". I file ",[17,207,48],{}," del Ticker v1.2.0, del Reolink Switch v1.2.0 e della Camera v1.0.0, scaricati dalla CDN il 14 novembre 2026, sono identici byte per byte (3.072 byte) e si decodificano esattamente nel CSV qui sopra.",[13,210,211],{},"Cosa significa per l'hardware?",[213,214,215,231,237,262],"ul",{},[216,217,218,222,223,225,226,230],"li",{},[219,220,221],"strong",{},"Un solo slot app, niente OTA."," C'è un unico slot ",[17,224,175],{}," da 3 MB (3.072 KB) e nessun secondo slot, quindi una nuova immagine non ha dove essere scritta mentre la vecchia gira. Il ",[41,227,229],{"href":228},"\u002Fit\u002Fblog\u002Fesp32-ota-update-methods-compared","confronto tra i metodi OTA"," spiega perché questo esclude gli aggiornamenti via Wi-Fi e mette a confronto le dimensioni degli slot con l'app reale.",[216,232,233,236],{},[219,234,235],{},"Spazio per crescere."," L'app del Ticker v1.2.0 pesa 1.796.736 byte, circa il 57% dello slot. L'app del Reolink Switch pesa 1.778.336 byte e quella della Camera 1.722.192 byte, ricavate dalle dimensioni dei file di release.",[216,238,239,242,243,248,249,252,253,256,257,261],{},[219,240,241],{},"Le impostazioni sono al sicuro."," La libreria Preferences ",[41,244,247],{"href":245,"rel":246},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Fapi\u002Fpreferences.html",[62],"salva i dati nella partizione NVS",", e lo ",[17,250,251],{},"storage.cpp"," del Ticker e quello del Reolink Switch usano entrambi Preferences. Il flasher scrive bootloader, tabella, ",[17,254,255],{},"boot_app0"," e app, e nessuno di questi si sovrappone a 0x9000-0xDFFF, come descrive la ",[41,258,260],{"href":259},"\u002Fit\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","guida al flashing dal browser",".",[216,263,264,267,268,270,271,274,275,113,278,280,281,284,285,288,289,291,292,297],{},[219,265,266],{},"Un filesystem inutilizzato."," La partizione ",[17,269,179],{}," da 896 KB è dichiarata, ma cercando ",[17,272,273],{},"LittleFS",", ",[17,276,277],{},"SPIFFS",[17,279,179],{}," nei sorgenti ",[17,282,283],{},"microcontroller\u002F"," dei tre firmware non si trova nulla. La libreria condivisa ",[17,286,287],{},"gizmo-common"," non rientra in quella ricerca. La partizione ",[17,290,183],{}," da 64 KB è dove la ",[41,293,296],{"href":294,"rel":295},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fcore_dump.html",[62],"funzione core dump"," di ESP-IDF scrive i dati dei crash, e se questi firmware la abilitino non l'ho verificato.",[13,299,300,301,306,307,310,311,313,314,316],{},"Un altro dettaglio si nota facilmente. La XIAO ESP32-S3 ha 8 MB di flash (il modello Plus ne ha 16 MB) secondo la ",[41,302,305],{"href":303,"rel":304},"https:\u002F\u002Fwiki.seeedstudio.com\u002Fxiao_esp32s3_getting_started\u002F",[62],"wiki di Seeed",", e il file board di PlatformIO punta a ",[17,308,309],{},"default_8MB.csv",". L'override di OpenGizmo su ",[17,312,31],{}," finisce a 0x400000, quindi i 4 MB superiori di quella flash non hanno nessuna partizione. Lasciarli vuoti non costa niente, e il commento nel ",[17,315,198],{}," del firmware dice proprio che la stessa tabella vale per ogni firmware OpenGizmo, compresa la ESP32-CAM da 4 MB.",[51,318,320],{"id":319},"quali-sono-gli-schemi-di-partizioni-predefiniti-di-arduino-esp32","Quali sono gli schemi di partizioni predefiniti di Arduino-ESP32?",[13,322,323,324,332,333,336,337,342],{},"Il core Arduino-ESP32 include decine di tabelle già pronte nella ",[41,325,328,329],{"href":326,"rel":327},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Ftree\u002Fmaster\u002Ftools\u002Fpartitions",[62],"cartella ",[17,330,331],{},"tools\u002Fpartitions",": il 14 novembre 2026 contava più di 50 file. In Arduino IDE sono il menu Strumenti, Partition Scheme; in PlatformIO scrivi il nome del file in ",[17,334,335],{},"board_build.partitions",", come mostrano i ",[41,338,341],{"href":339,"rel":340},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fplatforms\u002Fespressif32.html",[62],"documenti PlatformIO per Espressif 32",". Questi sono quelli che incontri più spesso:",[344,345],"blog-table",{":headers":346,":rows":347},"[\"File dello schema\",\"Flash necessaria (MB)\",\"Slot app\",\"Ogni slot app (KB)\",\"Filesystem (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],{},"Ho calcolato i valori in KB dagli offset e dalle dimensioni di ogni CSV (",[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","). La colonna \"Flash necessaria\" è il punto in cui finisce l'ultima partizione, un ",[17,386,183],{}," da 64 KB: 0x400000, 0x800000 o 0x1000000. Questi file cambiano da una release del core all'altra, quindi controlla la versione con cui compili.",[13,389,390,391,393,394,396],{},"Lo schema è sempre lo stesso compromesso su cui ruota tutta la tabella. La flash è un budget fisso, e slot app, filesystem e dati OTA se lo contendono. Una tabella con due slot app dimezza lo spazio di ciascuno. Per questo un'app da 1,7 MB come quella del Ticker non entra negli slot da 1.280 KB di ",[17,392,27],{},", e per questo ",[17,395,31],{}," rinuncia al secondo slot per averne uno grande.",[51,398,400],{"id":399},"perché-gli-offset-della-flash-cambiano-da-un-chip-allaltro","Perché gli offset della flash cambiano da un chip all'altro?",[13,402,403,404,409,410,274,414,419,420,425],{},"La tabella sta a 0x8000 sia sull'ESP32 classico sia sull'ESP32-S3, ma il bootloader si sposta. Le pagine sul bootloader di ESP-IDF dicono che il bootloader di secondo stadio sta ",[41,405,408],{"href":406,"rel":407},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[62],"a 0x1000 sull'ESP32"," e a 0x0 su ",[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"," ed ",[41,421,424],{"href":422,"rel":423},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32c6\u002Fapi-guides\u002Fbootloader.html",[62],"ESP32-C6",". I manifest di OpenGizmo mostrano l'effetto:",[344,427],{":headers":428,":rows":429},"[\"Parte\",\"Gizmo Camera (ESP32)\",\"Gizmo Ticker (ESP32-S3)\",\"Dimensione (byte)\"]","[[\"bootloader\",\"0x1000 (4096)\",\"0x0 (0)\",\"23.520 su ESP32, 19.968 su S3\"],[\"tabella delle partizioni\",\"0x8000 (32768)\",\"0x8000 (32768)\",\"3.072\"],[\"boot_app0\",\"0xE000 (57344)\",\"0xE000 (57344)\",\"8.192\"],[\"app\",\"0x10000 (65536)\",\"0x10000 (65536)\",\"1.722.192 su Camera, 1.796.736 su Ticker\"]]",[13,431,432,433,436,437,439,440,442,443,445],{},"I manifest sono su ",[17,434,435],{},"cdn.opengizmo.dev"," e le dimensioni vengono dai file che elencano. Nota che ",[17,438,255],{}," è di 8.192 byte a 0xE000, cioè l'offset e la dimensione esatti di ",[17,441,157],{}," nella tabella qui sopra. Il suo primo settore inizia con il valore 1 ed è per il resto pieno di 0xFF a parte pochi byte, mentre il secondo settore inizia con 0. Torna con un'immagine OTA data iniziale che seleziona il primo slot app, ma non l'ho verificato sul sorgente di ESP-IDF, quindi consideralo un'inferenza. Se disegni una tabella tua, tieni quell'offset allineato a dove metti ",[17,444,157],{},", oppure controlla cosa scrive il tuo strumento di build.",[13,447,448,449,452,453,456,457,261],{},"Neanche l'offset della tabella è fisso: ESP-IDF lo imposta con ",[17,450,451],{},"CONFIG_PARTITION_TABLE_OFFSET"," e dice di aggiornare gli offset fissi nel tuo CSV se lo cambi. Il ",[41,454,455],{"href":259},"post sul flashing dal browser"," mostra come quegli offset finiscono in un ",[17,458,459],{},"manifest.json",[51,461,463],{"id":462},"cosa-significano-n16r8-e-n8r2","Cosa significano N16R8 e N8R2?",[13,465,466,467,470,471,474,475,480],{},"Nel nome di un modulo Espressif, ",[17,468,469],{},"N"," è la dimensione della flash in megabyte e ",[17,472,473],{},"R"," quella della PSRAM in megabyte. Il ",[41,476,479],{"href":477,"rel":478},"https:\u002F\u002Fdocumentation.espressif.com\u002Fesp32-s3-wroom-1_wroom-1u_datasheet_en.pdf",[62],"datasheet dell'ESP32-S3-WROOM-1"," di Espressif (versione 1.8) li elenca nelle tabelle di confronto. La PSRAM è RAM aggiuntiva in un die separato, quindi non compare mai nella tabella delle partizioni. Conta solo il numero della flash.",[13,482,483],{},[68,484],{"alt":485,"src":486},"Il codice del modulo N16R8 diviso in due: N16 sono 16 MB di flash quad SPI che ospita la tabella delle partizioni, R8 sono 8 MB di PSRAM octal che è RAM e usa da GPIO35 a GPIO37","\u002Fimages\u002Fblog\u002Fit\u002Fesp32-partition-table-explained-module-code.webp",[344,488],{":headers":489,":rows":490},"[\"Modulo\",\"Flash (MB)\",\"PSRAM (MB)\",\"Tabella adatta\"]","[[\"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],{},"Dietro quella tabella ci sono due punti pratici. Primo: il datasheet dice che sui moduli con PSRAM octal (le serie R8 e R16V) i pin IO35, IO36 e IO37 sono collegati alla PSRAM e non sono disponibili per altri usi, quindi un N16R8 perde tre GPIO che un N8R2 conserva. Secondo: \"Tabella adatta\" è un mio abbinamento, non di Espressif: va bene qualsiasi tabella, purché finisca entro la dimensione della flash. La ",[41,495,498],{"href":496,"rel":497},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fflash-modes.html",[62],"documentazione di esptool"," avverte che le partizioni devono stare nella dimensione configurata, altrimenti l'ESP32 non funzionerà correttamente.",[13,501,502,503,507,508,261],{},"La XIAO ESP32-S3 è una scheda, non un modulo WROOM, ma la wiki di Seeed riporta la stessa coppia di dati: il chip ESP32-S3R8 con 8 MB di PSRAM e 8 MB di flash. Per capire quale chip comprare, vedi ",[41,504,506],{"href":505},"\u002Fit\u002Fblog\u002Fwhich-esp32-chip-should-you-buy","Quale ESP32 comprare?"," e il ",[41,509,511],{"href":510},"\u002Fit\u002Fblog\u002Fxiao-esp32s3-vs-c3-vs-c6","confronto tra XIAO",[51,513,515],{"id":514},"come-dimensionare-le-partizioni-app-ota-e-filesystem","Come dimensionare le partizioni app, OTA e filesystem?",[13,517,518],{},"Parti dalla dimensione dell'app e vai verso l'esterno, e scrivi la tabella prima di flasharla.",[520,521,522,532,551,566,575],"ol",{},[216,523,524,527,528,531],{},[219,525,526],{},"Misura l'app."," Compila il firmware e leggi la dimensione del ",[17,529,530],{},".bin",". Per esempio, quello del Ticker è di 1.796.736 byte.",[216,533,534,537,538,540,541,546,547,550],{},[219,535,536],{},"Decidi se vuoi l'OTA."," Per aggiornare via Wi-Fi servono ",[17,539,157],{}," più due slot app, secondo la ",[41,542,545],{"href":543,"rel":544},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-reference\u002Fsystem\u002Fota.html",[62],"documentazione OTA di ESP-IDF"," come riassunta nel ",[41,548,549],{"href":228},"confronto OTA",". Ogni slot deve contenere l'app con un po' di margine per crescere.",[216,552,553,559,560,565],{},[219,554,555,556,558],{},"Dai a ",[17,557,19],{}," lo spazio che serve davvero."," La ",[41,561,564],{"href":562,"rel":563},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-reference\u002Fstorage\u002Fnvs_flash.html",[62],"documentazione NVS"," indica 12 KiB (0x3000) come minimo per un normale uso in lettura e scrittura. Le tabelle di Arduino usano 0x5000 (20 KB).",[216,567,568,571,572,574],{},[219,569,570],{},"Spendi il resto in un filesystem, oppure rinuncia."," Se nessuno lo monta, uno ",[17,573,179],{}," inutilizzato è spazio sprecato che potresti dare agli slot app.",[216,576,577,580],{},[219,578,579],{},"Controlla la somma."," L'ultima partizione deve finire entro la dimensione della flash e ogni offset app deve essere un multiplo di 0x10000.",[13,582,583],{},"Per esempio, una scheda da 8 MB con due slot da 3 MB e un piccolo filesystem potrebbe usare la tabella qui sotto. È un calcolo mio, non una tabella che ho costruito o flashato, quindi trattala come un modello:",[126,585,588],{"className":586,"code":587,"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,589,587],{"__ignoreMap":132},[13,591,592,593,595,596,601,602,604],{},"L'ultima riga finisce a 0x800000, esattamente 8 MB. In Arduino IDE salvala come ",[17,594,23],{}," nella cartella dello sketch e la build la usa al posto delle tabelle predefinite, come descrive il ",[41,597,600],{"href":598,"rel":599},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Ftutorials\u002Fpartition_table.html",[62],"tutorial sulle partizioni di Arduino-ESP32",". In PlatformIO punta ",[17,603,335],{}," al file.",[13,606,607,608,610],{},"Cambiare la tabella ha un costo. ESP-IDF dice che aggiornarla non cancella i dati salvati con la vecchia tabella. Visto che ogni partizione si trova tramite il suo offset, una partizione spostata o ridimensionata leggerà i byte che ora stanno lì (è la mia lettura di come funzionano gli offset, non una citazione dalla documentazione). Lascia ",[17,609,19],{}," dov'è e le impostazioni salvate continuano a funzionare; altrimenti metti in conto di ripartire da zero.",[51,612,614],{"id":613},"come-trovi-gli-offset-e-la-dimensione-della-flash-di-una-scheda","Come trovi gli offset e la dimensione della flash di una scheda?",[13,616,617],{},"Bastano tre comandi. I primi due leggono la tua build e il tuo chip, il terzo legge cosa c'è davvero sulla scheda.",[619,620],"terminal",{":commands":621,"title":622},"[\"pio project metadata -e release --json-output\",\"esptool flash-id\",\"esptool -p \u002Fdev\u002FttyACM0 read-flash 0x8000 0x1000 table.bin\"]","Offset dalla build, dimensione della flash dal chip",[213,624,625,641,655],{},[216,626,627,632,633,640],{},[219,628,629],{},[17,630,631],{},"pio project metadata"," stampa le immagini flash con i loro indirizzi e l'offset dell'applicazione. Il ",[41,634,637],{"href":635,"rel":636},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002F.github\u002Fscripts\u002Fpackage_firmware.py",[62],[17,638,639],{},"package_firmware.py"," del Ticker legge esattamente questo per scrivere il manifest, così non digiti mai un offset a mano.",[216,642,643,648,649,654],{},[219,644,645],{},[17,646,647],{},"esptool flash-id"," stampa il produttore, l'ID del dispositivo e la \"Detected flash size\", come descrivono i ",[41,650,653],{"href":651,"rel":652},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[62],"comandi base di esptool",". Lancialo prima di scegliere una tabella per una scheda che non hai comprato tu.",[216,656,657,662,663,667,668,671],{},[219,658,659],{},[17,660,661],{},"read-flash"," copia la tabella fuori dalla scheda. La ",[41,664,666],{"href":60,"rel":665},[62],"guida ESP-IDF"," documenta ",[17,669,670],{},"gen_esp32part.py"," per riconvertire una tabella binaria in CSV, e io ho decodificato i file distribuiti con un mio breve script.",[13,673,674],{},"I nomi dei comandi sono le forme con il trattino che usa la documentazione attuale di esptool; le versioni più vecchie li scrivevano con il trattino basso. Adattali alla versione che hai installato.",[51,676,678],{"id":677},"cosa-decide-per-te-la-tabella-delle-partizioni","Cosa decide per te la tabella delle partizioni?",[13,680,681,682,684,685,687],{},"La tabella delle partizioni dell'ESP32 decide come un chip di flash di dimensione fissa viene diviso tra la tua app, una possibile seconda app, le tue impostazioni e un filesystem. Per OpenGizmo la risposta è stata una scelta precisa: ",[17,683,31],{},", un solo slot da 3 MB, circa il 57% occupato dall'app più grande, impostazioni in ",[17,686,19],{}," che un aggiornamento via USB non tocca mai, e niente OTA.",[13,689,690,691,693,694,696,697,701],{},"I limiti conviene dirli ad alta voce. Ho letto le tabelle e decodificato i binari distribuiti, ma non ho flashato su una scheda una tabella modificata, quindi il CSV personalizzato qui sopra è solo un calcolo, e il ruolo di ",[17,692,255],{}," è un'inferenza dal suo offset, dalla dimensione e dai primi byte. Il prossimo passo utile è il ",[41,695,229],{"href":228},", che mostra quanto costerebbe un secondo slot a questo layout, oppure il post ",[41,698,700],{"href":699},"\u002Fit\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs PlatformIO"," se stai ancora scegliendo dove impostare lo schema.",{"title":132,"searchDepth":703,"depth":703,"links":704},2,[705,706,707,708,709,710,711,712,713],{"id":53,"depth":703,"text":54},{"id":101,"depth":703,"text":102},{"id":187,"depth":703,"text":188},{"id":319,"depth":703,"text":320},{"id":399,"depth":703,"text":400},{"id":462,"depth":703,"text":463},{"id":514,"depth":703,"text":515},{"id":613,"depth":703,"text":614},{"id":677,"depth":703,"text":678},"guides","Guide","2026-11-14T00:00:00Z","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.","md",[720,723,726,729,732],{"question":721,"answer":722},"Dove si trova la tabella delle partizioni su un ESP32?","Secondo la documentazione ESP-IDF, la tabella delle partizioni dell'ESP32 sta di default nella flash all'offset 0x8000. Occupa un settore da 4 KB e contiene fino a 95 voci più un checksum MD5. Il bootloader la legge a ogni avvio per trovare le partizioni app e quelle dei dati.",{"question":724,"answer":725},"Come cambio lo schema delle partizioni in Arduino IDE o PlatformIO?","In Arduino IDE scegli un layout da Strumenti, Partition Scheme, oppure metti un file partitions.csv accanto allo sketch. In PlatformIO imposti board_build.partitions in platformio.ini con una tabella integrata, come huge_app.csv, oppure con un tuo file CSV nella radice del progetto.",{"question":727,"answer":728},"Cosa significa N16R8 su un modulo ESP32-S3?","In ESP32-S3-WROOM-1-N16R8, N16 sono 16 MB di flash quad SPI e R8 sono 8 MB di PSRAM octal SPI, secondo il datasheet di Espressif. La dimensione della flash decide quanto può essere grande la tua tabella delle partizioni. La PSRAM è RAM in più e nella tabella non compare.",{"question":730,"answer":731},"La PSRAM cambia la tabella delle partizioni dell'ESP32?","No. La PSRAM è RAM, quindi non ha una partizione e non occupa flash. Per la tabella conta solo la dimensione della flash. Un modulo con PSRAM octal, come l'N16R8, riserva però da GPIO35 a GPIO37 alla PSRAM: questo limita la scelta dei pin, ma non le partizioni.",{"question":733,"answer":734},"Se flasho una nuova tabella delle partizioni perdo i dati?","Secondo la documentazione ESP-IDF, flashare una tabella delle partizioni non cancella il resto della flash. Però i dati si leggono per offset: se la nuova tabella sposta o ridimensiona una partizione, il vecchio contenuto viene letto male. Tieni nvs allo stesso offset e con la stessa dimensione e le impostazioni salvate sopravvivono.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg","Un maker con gli occhiali infila un blocco blu app0 in un buco di una lunga barra flash fatta di blocchi nvs, app1 e spiffs, con una piccola icona di chip a sinistra.","it",{},true,"\u002Fit\u002Fblog\u002Fesp32-partition-table-explained",{"title":5,"description":717},{"loc":740},"it\u002Fblog\u002Fesp32-partition-table-explained","La tabella delle partizioni dell'ESP32 sta a 0x8000 e divide la flash in nvs, otadata, app e filesystem. Il file huge_app.csv di OpenGizmo dà un solo slot app da 3 MB e niente OTA.",[746,747,748,749,750],"ESP32","Firmware","Embedded Systems","PlatformIO","OpenGizmo","uPwsNmuUs_qdJ--5vTBKnZwTVv4nHEmup5Ptw6oG52k",[753,759,768,776],{"title":754,"description":755,"image":756,"categoryText":715,"categorySlug":714,"tags":757,"path":259},"ESP Web Tools: flashare un ESP32 dal browser","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.","\u002Fimages\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser.jpg",[746,747,758,750,748],"Development Tools",{"title":760,"description":761,"image":762,"categoryText":763,"categorySlug":764,"tags":765,"path":767},"ESPHome o firmware custom su ESP32: quale scegliere","ESPHome o firmware custom per ESP32? Una tabella per decidere, cosa ESPHome non sa fare e perché web app, portal e server MCP di OpenGizmo usano PlatformIO.","\u002Fimages\u002Fblog\u002Fesphome-vs-custom-esp32-firmware.jpg","Confronti","comparisons",[746,747,766,749,750],"Home Automation","\u002Fit\u002Fblog\u002Fesphome-vs-custom-esp32-firmware",{"title":769,"description":770,"image":771,"categoryText":715,"categorySlug":714,"tags":772,"path":775},"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",[773,746,748,774,747],"Microcontrollers","Electronics","\u002Fit\u002Fblog\u002Fwhat-is-a-microcontroller",{"title":777,"description":778,"image":779,"categoryText":715,"categorySlug":714,"tags":780,"path":782},"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",[781,746,747,758,750],"ESP32-CAM","\u002Fit\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide",[784,790,796],{"name":785,"slug":786,"path":787,"count":788,"image":789},"Risoluzione problemi","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"name":791,"slug":792,"path":793,"count":794,"image":795},"Build","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",{"name":763,"slug":764,"path":797,"count":798,"image":799},"\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",1795018239958]