[{"data":1,"prerenderedAt":800},["ShallowReactive",2],{"post-esp32-partition-table-explained-es":3,"related-posts-esp32-partition-table-explained-es":752,"related-categories-esp32-partition-table-explained-es":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\u002Fes\u002Fblog\u002Fesp32-partition-table-explained.md","Tabla de particiones ESP32: mapa de la flash y 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,427,431,447,461,465,482,488,492,501,513,517,520,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 tabla de particiones del ESP32 es un pequeño mapa guardado en la flash en el offset 0x8000 que le dice al bootloader dónde están la app, el almacén de ajustes (",[17,18,19],"code",{},"nvs","), los datos OTA y el sistema de archivos. La eliges con un archivo ",[17,22,23],{},"partitions.csv"," o con un esquema incluido como ",[17,26,27],{},"default.csv"," o ",[17,30,31],{},"huge_app.csv",". Si la tabla se pasa del tamaño real de la flash, la documentación de esptool de Espressif advierte que el chip no funcionará correctamente.",[13,34,35,36,39,40,45,46,49],{},"Esta guía lee ese mapa como lo hace el chip: las columnas del CSV, los esquemas de Arduino-ESP32 con sus tamaños en KB, por qué el offset del bootloader cambia según el chip y qué significa ",[17,37,38],{},"N16R8"," en el nombre de un módulo para tu distribución. El ejemplo real es el ",[41,42,44],"a",{"href":43},"\u002Fes\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",": decodifiqué el ",[17,47,48],{},"release-partitions.bin"," que escribe su flasher y lo comprobé con la documentación de Espressif y con los archivos CSV de Arduino-ESP32.",[51,52,54],"h2",{"id":53},"qué-es-la-tabla-de-particiones-del-esp32","¿Qué es la tabla de particiones del ESP32?",[13,56,57,58,64],{},"Una tabla de particiones divide el chip de flash externa en regiones con nombre, tipo, offset y tamaño. 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","guía de tablas de particiones"," de Espressif dice que por defecto se flashea en 0x8000, ocupa un sector de 4 KB y mide 0xC00 bytes, porque admite como máximo 95 entradas, seguidas de una suma MD5 que el bootloader usa para comprobar su integridad.",[13,66,67],{},[68,69],"img",{"alt":70,"src":71},"Un maker sostiene una placa XIAO junto a una tira de papel doblada con secciones de colores rotuladas nvs y app0, como un mapa de su flash","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained-illustration.webp",[13,73,74,75,80,81,84],{},"El bootloader es el primer programa que se ejecuta desde la 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],"página del bootloader"," de ESP-IDF enumera sus tareas: elegir la partición de aplicación que se va a arrancar según la tabla de particiones y ",[17,82,83],{},"ota_data",", si existe, cargar la imagen en RAM y cederle el control. Así que la tabla no es un ajuste dentro de tu app: es un archivo en la flash que existe antes que tu código.",[13,86,87],{},"Una tabla típica tiene cuatro tipos de particiones:",[89,90],"blog-list",{":items":91,"variant":92},"[\"nvs: almacén clave-valor para ajustes y datos de Wi-Fi, que usa la librería Preferences\",\"otadata: guarda qué slot de app OTA arrancar, 0x2000 bytes\",\"slots de app (factory, ota_0, ota_1): las imágenes del firmware\",\"particiones de datos como spiffs o coredump: un sistema de archivos, volcados de fallos o tus propios bytes\"]","circle",[13,94,95],{},[68,96],{"alt":97,"src":98},"El mapa de la flash del Gizmo Ticker para huge_app.csv en una placa de 8 MB: bootloader, tabla, nvs, otadata, un app0 de 3 MB, 896 KB de spiffs, coredump y 4 MB sin partición","\u002Fimages\u002Fblog\u002Fes\u002Fesp32-partition-table-explained-flash-map.webp",[51,100,102],{"id":101},"cómo-es-un-archivo-partitionscsv","¿Cómo es un archivo partitions.csv?",[13,104,105,106,109,110,113,114,117,118,124],{},"El CSV tiene seis columnas: name, type, subtype, offset, size y flags. Los espacios se ignoran, las líneas que empiezan con ",[17,107,108],{},"#"," son comentarios y los tamaños pueden ir en hexadecimal, en decimal o con ",[17,111,112],{},"K"," y ",[17,115,116],{},"M",". Un nombre mide como máximo 16 bytes, incluido el terminador. Esta es la tabla real de todos los firmwares de OpenGizmo, del ",[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, tal como estaba el 14 de noviembre de 2026 (aquí falta su línea de comentario con los nombres de las columnas):",[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],{},"Tres reglas explican casi todos los números, todas de la guía de ESP-IDF. Los offsets son múltiplos de 4 KB (0x1000), el tamaño del sector de la flash. Una partición ",[17,139,140],{},"app"," debe empezar en un múltiplo de 64 KB (0x10000): por eso la primera app está en 0x10000 y la zona de 0x9000 a 0xFFFF, antes de ella, solo tiene pequeñas particiones de datos. Y si dejas un offset en blanco, la partición empieza justo después de la anterior, y las de app se alinean solas.",[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],{},"El bootloader y las librerías buscan el tipo y el subtipo, no el nombre. Según la misma guía, la partición ",[17,146,19],{}," por defecto es la que tiene tipo ",[17,149,150],{},"data"," y subtipo ",[17,153,19],{},", y ",[17,156,157],{},"otadata"," tiene subtipo ",[17,160,161],{},"ota",". La tabla binaria que escribe el flasher los guarda como números. Decodifiqué el archivo que se distribuye con unas pocas líneas de Python: ",[17,164,19],{}," es data\u002F0x02, ",[17,167,157],{}," es data\u002F0x00, ",[17,170,171],{},"app0"," es app\u002F0x10 (",[17,174,175],{},"ota_0","), ",[17,178,179],{},"spiffs"," es data\u002F0x82 y ",[17,182,183],{},"coredump"," es data\u002F0x03.",[51,186,188],{"id":187},"qué-tabla-de-particiones-usan-los-firmwares-de-opengizmo","¿Qué tabla de particiones usan los firmwares de OpenGizmo?",[13,190,191,192,195,196,199,200,205,206,208],{},"Los tres definen ",[17,193,194],{},"board_build.partitions = huge_app.csv"," en ",[17,197,198],{},"platformio.ini",", por ejemplo en el ",[41,201,204],{"href":202,"rel":203},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[62],"archivo del Ticker",", con el comentario \"One 3 MB app slot (no wireless updates), the same in every OpenGizmo firmware\". Los ",[17,207,48],{}," del Ticker v1.2.0, del Reolink Switch v1.2.0 y de la Camera v1.0.0, tal como los sirvió la CDN el 14 de noviembre de 2026, son idénticos byte a byte (3.072 bytes) y se decodifican exactamente en el CSV de arriba.",[13,210,211],{},"¿Qué significa eso para el hardware?",[213,214,215,231,237,262],"ul",{},[216,217,218,222,223,225,226,230],"li",{},[219,220,221],"strong",{},"Un solo slot de app, sin OTA."," Hay un único slot ",[17,224,175],{}," de 3 MB (3.072 KB) y ningún segundo slot, así que una imagen nueva no tiene dónde escribirse mientras la vieja se ejecuta. La ",[41,227,229],{"href":228},"\u002Fes\u002Fblog\u002Fesp32-ota-update-methods-compared","comparativa de métodos OTA"," explica por qué eso descarta las actualizaciones por Wi-Fi y compara el tamaño de los slots con el de la app real.",[216,232,233,236],{},[219,234,235],{},"Espacio para crecer."," La app del Ticker v1.2.0 pesa 1.796.736 bytes, cerca del 57% del slot. La del Reolink Switch pesa 1.778.336 bytes y la de la Camera 1.722.192 bytes, sacados del tamaño de los archivos de la release.",[216,238,239,242,243,248,249,252,253,256,257,261],{},[219,240,241],{},"Los ajustes están a salvo."," La librería Preferences ",[41,244,247],{"href":245,"rel":246},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Fapi\u002Fpreferences.html",[62],"guarda los datos en la partición NVS",", y tanto el ",[17,250,251],{},"storage.cpp"," del Ticker como el del Reolink Switch usan Preferences. El flasher escribe el bootloader, la tabla, ",[17,254,255],{},"boot_app0"," y la app, y ninguno se solapa con 0x9000-0xDFFF, como describe la ",[41,258,260],{"href":259},"\u002Fes\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","guía de flasheo desde el navegador",".",[216,263,264,267,268,270,271,274,275,113,278,280,281,284,285,288,289,291,292,297],{},[219,265,266],{},"Un sistema de archivos sin usar."," La partición ",[17,269,179],{}," de 896 KB está declarada, pero al buscar ",[17,272,273],{},"LittleFS",", ",[17,276,277],{},"SPIFFS",[17,279,179],{}," en el código de ",[17,282,283],{},"microcontroller\u002F"," de los tres firmwares no aparece nada. La librería compartida ",[17,286,287],{},"gizmo-common"," no entra en esa búsqueda. La partición ",[17,290,183],{}," de 64 KB es donde 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],"función de core dump"," de ESP-IDF escribe los datos de los fallos, y si estos firmwares la activan es algo que no comprobé.",[13,299,300,301,306,307,310,311,313,314,316],{},"Hay un detalle más que se pasa por alto fácil. La XIAO ESP32-S3 tiene 8 MB de flash (el modelo Plus tiene 16 MB) según la ",[41,302,305],{"href":303,"rel":304},"https:\u002F\u002Fwiki.seeedstudio.com\u002Fxiao_esp32s3_getting_started\u002F",[62],"wiki de Seeed",", y el archivo de placa de PlatformIO apunta a ",[17,308,309],{},"default_8MB.csv",". El cambio de OpenGizmo a ",[17,312,31],{}," termina en 0x400000, así que los 4 MB superiores de esa flash no tienen ninguna partición. Dejarlos vacíos no cuesta nada, y el comentario del ",[17,315,198],{}," del firmware dice justo que se usa la misma tabla en todos los firmwares de OpenGizmo, incluida la ESP32-CAM de 4 MB.",[51,318,320],{"id":319},"cuáles-son-los-esquemas-de-particiones-por-defecto-de-arduino-esp32","¿Cuáles son los esquemas de particiones por defecto de Arduino-ESP32?",[13,322,323,324,332,333,336,337,342],{},"El core Arduino-ESP32 trae decenas de tablas ya hechas en su ",[41,325,328,329],{"href":326,"rel":327},"https:\u002F\u002Fgithub.com\u002Fespressif\u002Farduino-esp32\u002Ftree\u002Fmaster\u002Ftools\u002Fpartitions",[62],"carpeta ",[17,330,331],{},"tools\u002Fpartitions",": el 14 de noviembre de 2026 tenía más de 50 archivos. En Arduino IDE son el menú Herramientas, Partition Scheme; en PlatformIO pones el nombre del archivo en ",[17,334,335],{},"board_build.partitions",", como muestra la ",[41,338,341],{"href":339,"rel":340},"https:\u002F\u002Fdocs.platformio.org\u002Fen\u002Flatest\u002Fplatforms\u002Fespressif32.html",[62],"documentación de PlatformIO para Espressif 32",". Estos son los que más te vas a encontrar:",[344,345],"blog-table",{":headers":346,":rows":347},"[\"Archivo del esquema\",\"Flash necesaria (MB)\",\"Slots de app\",\"Cada slot de app (KB)\",\"Sistema de archivos (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],{},"Calculé los valores en KB a partir de los offsets y tamaños de cada 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 columna \"Flash necesaria\" es donde termina la última partición, un ",[17,386,183],{}," de 64 KB: 0x400000, 0x800000 o 0x1000000. Estos archivos cambian entre versiones del core, así que revisa la que usas para compilar.",[13,389,390,391,393,394,396],{},"El patrón es el trueque en el que gira toda la tabla. La flash es un presupuesto fijo, y cada slot de app, el sistema de archivos y los datos OTA compiten por ella. Una tabla con dos slots de app reduce a la mitad el espacio de cada uno. Por eso una app de 1,7 MB como la del Ticker no cabe en los slots de 1.280 KB de ",[17,392,27],{},", y por eso ",[17,395,31],{}," renuncia al segundo slot para tener uno grande.",[51,398,400],{"id":399},"por-qué-cambian-los-offsets-de-la-flash-entre-chips","¿Por qué cambian los offsets de la flash entre chips?",[13,402,403,404,409,410,414,415,420,421,426],{},"La tabla está en 0x8000 tanto en el ESP32 clásico como en el ESP32-S3, pero el bootloader se mueve. Las páginas del bootloader de ESP-IDF dicen que el bootloader de segunda etapa está ",[41,405,408],{"href":406,"rel":407},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-guides\u002Fbootloader.html",[62],"en 0x1000 en el ESP32"," y en 0x0 en el ",[41,411,413],{"href":77,"rel":412},[62],"ESP32-S3",", el ",[41,416,419],{"href":417,"rel":418},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32c3\u002Fapi-guides\u002Fbootloader.html",[62],"ESP32-C3"," y el ",[41,422,425],{"href":423,"rel":424},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32c6\u002Fapi-guides\u002Fbootloader.html",[62],"ESP32-C6",". Los manifiestos de OpenGizmo muestran el efecto:",[344,428],{":headers":429,":rows":430},"[\"Parte\",\"Gizmo Camera (ESP32)\",\"Gizmo Ticker (ESP32-S3)\",\"Tamaño (bytes)\"]","[[\"bootloader\",\"0x1000 (4096)\",\"0x0 (0)\",\"23.520 en ESP32, 19.968 en S3\"],[\"tabla de particiones\",\"0x8000 (32768)\",\"0x8000 (32768)\",\"3.072\"],[\"boot_app0\",\"0xE000 (57344)\",\"0xE000 (57344)\",\"8.192\"],[\"app\",\"0x10000 (65536)\",\"0x10000 (65536)\",\"1.722.192 en Camera, 1.796.736 en Ticker\"]]",[13,432,433,434,437,438,440,441,443,444,446],{},"Los manifiestos están en ",[17,435,436],{},"cdn.opengizmo.dev"," y los tamaños salen de los archivos que enumeran. Fíjate en que ",[17,439,255],{}," mide 8.192 bytes en 0xE000, que es justo el offset y el tamaño de ",[17,442,157],{}," en la tabla de arriba. Su primer sector empieza con el valor 1 y por lo demás está lleno de 0xFF salvo unos pocos bytes, y el segundo sector empieza con 0. Eso encaja con una imagen inicial de datos OTA que selecciona el primer slot de app, pero no lo comprobé en el código fuente de ESP-IDF, así que tómalo como una inferencia. Si diseñas tu propia tabla, mantén ese offset alineado con el lugar donde pongas ",[17,445,157],{},", o revisa qué escribe tu herramienta de compilación.",[13,448,449,450,453,454,457,458,261],{},"El offset de la propia tabla tampoco es fijo: ESP-IDF lo define con ",[17,451,452],{},"CONFIG_PARTITION_TABLE_OFFSET"," y dice que, si lo cambias, actualices los offsets fijos de tu CSV. El ",[41,455,456],{"href":259},"artículo sobre flasheo desde el navegador"," muestra cómo esos offsets acaban en un ",[17,459,460],{},"manifest.json",[51,462,464],{"id":463},"qué-significan-n16r8-y-n8r2","¿Qué significan N16R8 y N8R2?",[13,466,467,468,471,472,475,476,481],{},"En el nombre de un módulo de Espressif, ",[17,469,470],{},"N"," es el tamaño de la flash en megabytes y ",[17,473,474],{},"R"," el de la PSRAM en megabytes. La ",[41,477,480],{"href":478,"rel":479},"https:\u002F\u002Fdocumentation.espressif.com\u002Fesp32-s3-wroom-1_wroom-1u_datasheet_en.pdf",[62],"hoja de datos del ESP32-S3-WROOM-1"," de Espressif (versión 1.8) los enumera en sus tablas comparativas. La PSRAM es RAM adicional en un die aparte, así que nunca aparece en la tabla de particiones. Solo cuenta el número de la flash.",[13,483,484],{},[68,485],{"alt":486,"src":487},"El código del módulo N16R8 partido en dos: N16 son 16 MB de flash quad SPI que aloja la tabla de particiones, R8 son 8 MB de PSRAM octal que es RAM y usa de GPIO35 a GPIO37","\u002Fimages\u002Fblog\u002Fes\u002Fesp32-partition-table-explained-module-code.webp",[344,489],{":headers":490,":rows":491},"[\"Módulo\",\"Flash (MB)\",\"PSRAM (MB)\",\"Tabla que encaja\"]","[[\"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,493,494,495,500],{},"Detrás de esa tabla hay dos puntos prácticos. Primero, la hoja de datos dice que en los módulos con PSRAM octal (las series R8 y R16V) los pines IO35, IO36 e IO37 están conectados a la PSRAM y no están disponibles para otros usos, así que un N16R8 pierde tres GPIO que un N8R2 conserva. Segundo, \"Tabla que encaja\" es un emparejamiento mío, no de Espressif: sirve cualquier tabla mientras termine dentro del tamaño de la flash. La ",[41,496,499],{"href":497,"rel":498},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fflash-modes.html",[62],"documentación de esptool"," advierte que las particiones deben caber en el tamaño configurado, o el ESP32 no funcionará correctamente.",[13,502,503,504,508,509,261],{},"La XIAO ESP32-S3 es una placa, no un módulo WROOM, pero la wiki de Seeed da el mismo par de datos: el chip ESP32-S3R8 con 8 MB de PSRAM y 8 MB de flash. Para saber qué chip comprar en primer lugar, mira ",[41,505,507],{"href":506},"\u002Fes\u002Fblog\u002Fwhich-esp32-chip-should-you-buy","¿Qué ESP32 deberías comprar?"," y la ",[41,510,512],{"href":511},"\u002Fes\u002Fblog\u002Fxiao-esp32s3-vs-c3-vs-c6","comparativa de XIAO",[51,514,516],{"id":515},"cómo-dimensionar-las-particiones-de-app-ota-y-sistema-de-archivos","¿Cómo dimensionar las particiones de app, OTA y sistema de archivos?",[13,518,519],{},"Parte del tamaño de la app hacia afuera y anota la tabla antes de flashearla.",[521,522,523,533,552,566,575],"ol",{},[216,524,525,528,529,532],{},[219,526,527],{},"Mide la app."," Compila el firmware y mira el tamaño del ",[17,530,531],{},".bin",". Por ejemplo, el del Ticker es de 1.796.736 bytes.",[216,534,535,538,539,541,542,547,548,551],{},[219,536,537],{},"Decide si quieres OTA."," Para actualizar por Wi-Fi necesitas ",[17,540,157],{}," más dos slots de app, según la ",[41,543,546],{"href":544,"rel":545},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesp-idf\u002Fen\u002Flatest\u002Fesp32\u002Fapi-reference\u002Fsystem\u002Fota.html",[62],"documentación OTA de ESP-IDF"," resumida en la ",[41,549,550],{"href":228},"comparativa OTA",". Cada slot debe tener sitio para la app con margen para crecer.",[216,553,554,559,560,565],{},[219,555,556,557,261],{},"Sé realista con ",[17,558,19],{}," 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],"documentación de NVS"," da 12 KiB (0x3000) como mínimo para un uso normal de lectura y escritura. Las tablas de Arduino usan 0x5000 (20 KB).",[216,567,568,571,572,574],{},[219,569,570],{},"Gasta el resto en un sistema de archivos, o quítalo."," Si nadie lo monta, un ",[17,573,179],{}," sin usar es espacio desperdiciado que podrías dar a los slots de app.",[216,576,577,580],{},[219,578,579],{},"Revisa la suma."," La última partición debe terminar en el tamaño de la flash o antes, y todo offset de app debe ser múltiplo de 0x10000.",[13,582,583],{},"Por ejemplo, una placa de 8 MB con dos slots de 3 MB y un sistema de archivos pequeño podría usar la tabla de abajo. Es aritmética mía, no una tabla que haya construido ni flasheado, así que tómala como plantilla:",[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],{},"La última fila termina en 0x800000, justo 8 MB. En Arduino IDE, guárdala como ",[17,594,23],{}," en la carpeta del sketch y la compilación la usará en lugar de las tablas predefinidas, como describe el ",[41,597,600],{"href":598,"rel":599},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Farduino-esp32\u002Fen\u002Flatest\u002Ftutorials\u002Fpartition_table.html",[62],"tutorial de particiones de Arduino-ESP32",". En PlatformIO, apunta ",[17,603,335],{}," al archivo.",[13,606,607,608,610],{},"Cambiar la tabla tiene un costo. ESP-IDF dice que actualizarla no borra los datos guardados con la tabla vieja. Como cada partición se encuentra por su offset, una partición movida o con otro tamaño leerá los bytes que ahora haya ahí (es mi lectura de cómo funcionan los offsets, no una cita de la documentación). Deja ",[17,609,19],{}," donde está y los ajustes guardados siguen funcionando; si no, cuenta con empezar de cero.",[51,612,614],{"id":613},"cómo-encuentras-los-offsets-y-el-tamaño-de-la-flash-de-una-placa","¿Cómo encuentras los offsets y el tamaño de la flash de una placa?",[13,616,617],{},"Con tres comandos basta. Los dos primeros leen tu compilación y tu chip, el tercero lee lo que realmente hay en la placa.",[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\"]","Offsets desde la compilación, tamaño de la flash desde el chip",[213,624,625,641,655],{},[216,626,627,632,633,640],{},[219,628,629],{},[17,630,631],{},"pio project metadata"," imprime las imágenes de flash con sus direcciones y el offset de la aplicación. El ",[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 lee justo eso para escribir el manifiesto, así que nunca tecleas un offset a mano.",[216,642,643,648,649,654],{},[219,644,645],{},[17,646,647],{},"esptool flash-id"," imprime el fabricante, el ID del dispositivo y el \"Detected flash size\", según los ",[41,650,653],{"href":651,"rel":652},"https:\u002F\u002Fdocs.espressif.com\u002Fprojects\u002Fesptool\u002Fen\u002Flatest\u002Fesp32\u002Fesptool\u002Fbasic-commands.html",[62],"comandos básicos de esptool",". Ejecútalo antes de elegir una tabla para una placa que no compraste tú.",[216,656,657,662,663,667,668,671],{},[219,658,659],{},[17,660,661],{},"read-flash"," copia la tabla fuera de la placa. La ",[41,664,666],{"href":60,"rel":665},[62],"guía de ESP-IDF"," documenta ",[17,669,670],{},"gen_esp32part.py"," para convertir una tabla binaria otra vez en CSV, y yo decodifiqué los archivos distribuidos con un script corto mío.",[13,673,674],{},"Los nombres de los comandos son las formas con guion que usa la documentación actual de esptool; las versiones anteriores los escribían con guion bajo. Ajústalos a la versión que tengas instalada.",[51,676,678],{"id":677},"qué-decide-por-ti-la-tabla-de-particiones","¿Qué decide por ti la tabla de particiones?",[13,680,681,682,684,685,687],{},"La tabla de particiones del ESP32 decide cómo se reparte un chip de flash de tamaño fijo entre tu app, una posible segunda app, tus ajustes y un sistema de archivos. Para OpenGizmo la respuesta fue deliberada: ",[17,683,31],{},", un solo slot de 3 MB, cerca del 57% ocupado por la app más grande, ajustes en ",[17,686,19],{}," que una actualización por USB nunca toca, y sin OTA.",[13,689,690,691,693,694,696,697,701],{},"Conviene decir los límites en voz alta. Leí las tablas y decodifiqué los binarios distribuidos, pero no flasheé una tabla modificada en una placa, así que el CSV personalizado de arriba es pura aritmética, y el papel de ",[17,692,255],{}," es una inferencia a partir de su offset, su tamaño y sus primeros bytes. El siguiente paso útil es la ",[41,695,229],{"href":228},", que muestra qué le costaría a este layout un segundo slot, o el artículo ",[41,698,700],{"href":699},"\u002Fes\u002Fblog\u002Farduino-ide-vs-platformio-for-esp32","Arduino IDE vs PlatformIO"," si todavía estás decidiendo dónde definir el esquema.",{"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":463,"depth":703,"text":464},{"id":515,"depth":703,"text":516},{"id":613,"depth":703,"text":614},{"id":677,"depth":703,"text":678},"guides","Guías","2026-11-14T00:00:00Z","Qué es la tabla de particiones del ESP32, cómo leer las columnas de partitions.csv, los esquemas de Arduino-ESP32 con sus tamaños y qué significa N16R8.","md",[720,723,726,729,732],{"question":721,"answer":722},"¿Dónde se guarda la tabla de particiones en un ESP32?","Según la documentación de ESP-IDF, la tabla de particiones del ESP32 se guarda por defecto en la flash, en el offset 0x8000. Ocupa un sector de 4 KB y admite hasta 95 entradas más una suma de comprobación MD5. El bootloader la lee en cada arranque para encontrar las particiones de app y de datos.",{"question":724,"answer":725},"¿Cómo cambio el esquema de particiones en Arduino IDE o PlatformIO?","En Arduino IDE elige un esquema en Herramientas, Partition Scheme, o pon un archivo partitions.csv junto a tu sketch. En PlatformIO, define board_build.partitions en platformio.ini con una tabla incluida, como huge_app.csv, o con tu propio archivo CSV en la raíz del proyecto.",{"question":727,"answer":728},"¿Qué significa N16R8 en un módulo ESP32-S3?","En ESP32-S3-WROOM-1-N16R8, N16 son 16 MB de flash quad SPI y R8 son 8 MB de PSRAM octal SPI, según la hoja de datos de Espressif. El tamaño de la flash decide cuán grande puede ser tu tabla de particiones. La PSRAM es RAM adicional y no aparece en la tabla.",{"question":730,"answer":731},"¿La PSRAM cambia la tabla de particiones del ESP32?","No. La PSRAM es RAM, así que no tiene partición ni ocupa flash. Para la tabla solo importa el tamaño de la flash. Eso sí, un módulo con PSRAM octal, como el N16R8, reserva de GPIO35 a GPIO37 para la PSRAM: eso afecta a los pines que puedes elegir, pero no a tus particiones.",{"question":733,"answer":734},"¿Flashear una tabla de particiones nueva borra mis datos?","Según la documentación de ESP-IDF, flashear una tabla de particiones no borra el resto de la flash. Pero los datos se leen por offset: si la tabla nueva mueve o cambia el tamaño de una partición, el contenido viejo se lee mal ahí. Mantén nvs en el mismo offset y con el mismo tamaño, y los ajustes guardados sobreviven.","\u002Fimages\u002Fblog\u002Fesp32-partition-table-explained.jpg","Un maker con gafas mete un bloque azul app0 en un hueco de una larga barra de flash hecha de bloques nvs, app1 y spiffs, con un pequeño icono de chip a la izquierda.","es",{},true,"\u002Fes\u002Fblog\u002Fesp32-partition-table-explained",{"title":5,"description":717},{"loc":740},"es\u002Fblog\u002Fesp32-partition-table-explained","La tabla de particiones del ESP32 está en 0x8000 y reparte la flash en nvs, otadata, app y sistema de archivos. El archivo huge_app.csv de OpenGizmo da un solo slot de app de 3 MB y sin OTA.",[746,747,748,749,750],"ESP32","Firmware","Embedded Systems","PlatformIO","OpenGizmo","MPk1JFEhQ8G14MyU7gR8vwBkTIfx7gp8dAFlpNpVopw",[753,759,768,775],{"title":754,"description":755,"image":756,"categoryText":715,"categorySlug":714,"tags":757,"path":259},"ESP Web Tools: flashear un ESP32 desde el navegador","Flashea un ESP32 desde el navegador con ESP Web Tools o esptool-js: cómo funcionan Web Serial, el manifest y los offsets, con un manifest real de OpenGizmo.","\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 propio en ESP32: cuál usar","¿ESPHome o firmware propio en ESP32? Una tabla para decidir, lo que ESPHome no puede hacer y por qué OpenGizmo usa PlatformIO para su app web y su MCP.","\u002Fimages\u002Fblog\u002Fesphome-vs-custom-esp32-firmware.jpg","Comparativas","comparisons",[746,747,766,749,750],"Home Automation","\u002Fes\u002Fblog\u002Fesphome-vs-custom-esp32-firmware",{"title":769,"description":770,"image":771,"categoryText":715,"categorySlug":714,"tags":772,"path":774},"ESP32-CAM-MB: programa la ESP32-CAM por USB","Cómo programar una ESP32-CAM con la placa USB ESP32-CAM-MB: qué incluye, la secuencia de botones IO0 y RST, flashear desde Chrome y qué suele fallar.","\u002Fimages\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide.jpg",[773,746,747,758,750],"ESP32-CAM","\u002Fes\u002Fblog\u002Fesp32-cam-mb-usb-programmer-guide",{"title":776,"description":777,"image":778,"categoryText":715,"categorySlug":714,"tags":779,"path":782},"¿Qué es un microcontrolador? Partes, ejemplos y ESP32","Un microcontrolador es un chip con CPU, RAM y pines programables que ejecuta un programa. Cómo funciona, diferencias con Raspberry Pi y cuál comprar.","\u002Fimages\u002Fblog\u002Fwhat-is-a-microcontroller.png",[780,746,748,781,747],"Microcontrollers","Electronics","\u002Fes\u002Fblog\u002Fwhat-is-a-microcontroller",[784,788,794],{"name":763,"slug":764,"path":785,"count":786,"image":787},"\u002Fblog\u002Fcategories\u002Fcomparisons",8,"\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg",{"name":789,"slug":790,"path":791,"count":792,"image":793},"Solución de problemas","troubleshooting","\u002Fblog\u002Fcategories\u002Ftroubleshooting",5,"\u002Fimages\u002Fblog\u002Fesp32-brownout-detector-was-triggered.jpg",{"name":795,"slug":796,"path":797,"count":798,"image":799},"Proyectos","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",1795018242879]