{"id":26788208,"url":"https://github.com/tinygs/esp32partitiongrow","last_synced_at":"2026-05-15T08:32:14.284Z","repository":{"id":284967867,"uuid":"956636261","full_name":"tinygs/esp32partitionGrow","owner":"tinygs","description":"A secure utility for modifying ESP32 partition tables via OTA. This tool enables safe partition table updates without physical access to the device","archived":false,"fork":false,"pushed_at":"2025-03-28T16:16:13.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T17:35:39.933Z","etag":null,"topics":["esp32","idf","ota","ota-firmware-updates"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tinygs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-28T15:38:06.000Z","updated_at":"2025-03-28T16:16:16.000Z","dependencies_parsed_at":"2025-03-28T17:35:42.635Z","dependency_job_id":"63aa0d39-bac7-4ba0-a6f1-41fc9d66f4a2","html_url":"https://github.com/tinygs/esp32partitionGrow","commit_stats":null,"previous_names":["tinygs/esp32partitiongrow"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinygs%2Fesp32partitionGrow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinygs%2Fesp32partitionGrow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinygs%2Fesp32partitionGrow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinygs%2Fesp32partitionGrow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinygs","download_url":"https://codeload.github.com/tinygs/esp32partitionGrow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246187233,"owners_count":20737463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esp32","idf","ota","ota-firmware-updates"],"created_at":"2025-03-29T13:16:18.631Z","updated_at":"2025-10-23T20:47:40.632Z","avatar_url":"https://github.com/tinygs.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PartitionGrow\n\nA tool to safely modify the ESP32 partition table via OTA (Over The Air).\n\n## Description\n\nThis tool allows remote and safe modification of the ESP32 partition table through OTA updates. The process is designed to be secure with automatic rollback capability.\n\n## How It Works\n\n1. The tool is loaded via OTA\n2. When executed, it checks if it's running from the \"app1\" partition\n   - If running from app1: proceeds to apply partition table changes\n   - If not running from app1: no changes are made\n3. After the check and possible modification, the tool always returns to the previous firmware\n\n## Important Notes\n\n- If the original firmware is running from app1, no changes will be made\n- For the process to work, a new OTA upload of the original firmware must be done so it runs from app0\n- The tool includes security mechanisms and verification to prevent issues during modification\n- It's crucial to maintain the partition names \"app0\" and \"app1\" unchanged in the CSV files\n\n## Usage Process\n\n1. Ensure the original firmware is in app0 (through an OTA update if necessary)\n2. Load this tool via OTA\n3. The tool will:\n   - Verify if it's running from app1\n   - Apply changes if safe to do so\n   - Automatically return to the original firmware\n\n## Partition Tables\n\nThe project includes two example partition tables:\n\n1. `default.csv`: Default partition layout\n\n   ```csv\n   # Name,   Type, SubType, Offset,  Size, Flags\n   nvs,      data, nvs,     0x9000,  0x5000,\n   otadata,  data, ota,     0xe000,  0x2000,\n   app0,     app,  ota_0,   0x10000, 0x140000,\n   app1,     app,  ota_1,   0x150000,0x140000,\n   spiffs,   data, spiffs,  0x290000,0x160000,\n   coredump, data, coredump,0x3F0000,0x10000,\n   ```\n\n2. `app_1_5mb.csv`: Modified layout with larger app partitions\n\n   ```csv\n   # Name,   Type, SubType, Offset,  Size, Flags\n   nvs,      data, nvs,     0x9000,  0x5000,\n   otadata,  data, ota,     0xe000,  0x2000,\n   app0,     app,  ota_0,   0x10000, 0x170000,\n   app1,     app,  ota_1,   0x180000,0x170000,\n   spiffs,   data, spiffs,  0x2F0000,0x100000,\n   coredump, data, coredump,0x3F0000,0x10000,\n   ```\n\n## Generating Partition Binary\n\nTo generate the binary file from your CSV partition table:\n\n1. Generate the binary:\n\n   ```bash\n   python $(IDF_PATH)/components/partition_table/gen_esp32part.py new_partition.bin new_partitions.csv\n   ```\n\n2. Convert binary to C header:\n\n   ```bash\n   xxd -C -n NEW_PARTITION -i new_partition.h new_partition.bin\n   sed -i 's/unsigned char/const unsigned char/' new_partition.h\n   ```\n\n## Inspiration\n\nThis project is inspired by:\n\n- [Article: Changing an ESP32 partition table over the air](https://medium.com/the-toit-take/changing-an-esp32-partition-table-over-the-air-276c86feeba8)\n- [Original Code](https://gist.github.com/floitsch/ed2530caa613581057d8998dee0a911f)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinygs%2Fesp32partitiongrow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinygs%2Fesp32partitiongrow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinygs%2Fesp32partitiongrow/lists"}