https://github.com/thelastoutpostworkshop/esp32partitionbuilder
ESP32 Partitions Web Application
https://github.com/thelastoutpostworkshop/esp32partitionbuilder
esp32 partition partitioner partitioning partitions
Last synced: 3 months ago
JSON representation
ESP32 Partitions Web Application
- Host: GitHub
- URL: https://github.com/thelastoutpostworkshop/esp32partitionbuilder
- Owner: thelastoutpostworkshop
- License: mit
- Created: 2024-06-15T10:47:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-22T22:15:50.000Z (about 1 year ago)
- Last Synced: 2025-03-19T02:37:34.478Z (12 months ago)
- Topics: esp32, partition, partitioner, partitioning, partitions
- Language: Vue
- Homepage: https://youtu.be/EuHxodrye6E
- Size: 288 KB
- Stars: 10
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ESP32 Partition Builder Web Application
The web application is [here](https://thelastoutpostworkshop.github.io/ESP32PartitionBuilder/).
## Youtube Tutorial
[
](https://youtu.be/EuHxodrye6E)
## Troubleshooting
> Do not forget to set the flash size correctly in the board options in the Arduino IDE or Arduino Workshop Extension for Visual Studio Code.
> If you use Wi-Fi, BLE, or Preferences API an NVS partition is mandatory
If for some reason the flash size is not available in the board options you may need to adjust the maximum upload size in your boards definition.
The IDE has no way to read the custom partition, see this [issue](https://github.com/espressif/arduino-esp32/issues/9831).
By default many of the custom partitions in boards definition have a 16MB max upload size, so if your board has less than 16MB flash memory, for example 4MB is typical, the compiler will report a wrong space occupied by your sketch.
To fix this, you have to edit the Espressif boards.txt file, which is normally located in
`[your drive]\[your name]\AppData\Local\Arduino15\packages\esp32\hardware\esp32\[esp32 core version]`
This is a very large file and you need to search for your specific board and change the line (here for the ESP32S3 Dev Module) :
`esp32s3.menu.PartitionScheme.custom.upload.maximum_size=16777216`
to
`esp32s3.menu.PartitionScheme.custom.upload.maximum_size=4194304`
for a microcontroller with 4MB flash memory.
> When boards are updated by the IDE or you uninstall and reinstall it, you will have to redo your changes.
### Partition table offset / large bootloaders
Use the “Partition Table Offset” control in the sidebar (0x8000 by default; 0x18000 for larger bootloaders). The app will realign partitions automatically—leave offsets blank in CSV files to have them adapt. Remember to build both bootloader and app with the same `PARTITION_TABLE_OFFSET` in `sdkconfig`, and keep the value a multiple of 0x1000.
## Contributors
Contributors are welcomed! If you want to submit pull requests, [here is how you can do it](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project).
**Recommended IDE Setup**
The recommended IDE setup is [Visual Studio Code](https://code.visualstudio.com/) + [Vue - Official extension](https://marketplace.visualstudio.com/items?itemName=Vue.volar).
**Project Setup**
```sh
npm install
```
**Compile and Hot-Reload for Development**
```sh
npm run dev
```