ESP Platform v0.1.0 - Flasher and Backups
Date: 2026-07-14
Status: internal release candidate after physical validation
Scope
This release closes the MVP toolchain for firmware catalog, Web Serial flashing, device backup and restore. It does not include OTA, Provisioning, Fleet Management, Edge OS, Compare with repository or Import firmware from connected ESP32.
Included Capabilities
- Simple single-file firmware upload and download.
- Multi-part ESP32 firmware packages with offsets.
- Merged firmware image generation through "esptool merge-bin".
- Artifact library with SHA-256 based reuse.
- Web Serial ESP32 flashing at default baudrate "115200".
- ESP32 erase flash action.
- Serial monitor and hardware reset actions.
- Read flash region diagnostics.
- Complete 4 MB device dump.
- Partition table analysis and selected-region download.
- Backup ZIP generation with "manifest.json", "full-flash.bin" and "checksums.sha256".
- Complete restore from "full-flash.bin".
- Selective restore by region.
- Safety backup before restore.
- Restore cancellation with incomplete-state warning.
- Restore audit events.
Physical Validation Summary
Validated with ESP32-D0WD revision 1, MAC "2c:bc:bb:75:f2:74", Flash ID "16405e", 4 MB flash.
- Complete restore passed with SHA-256 verification.
- Selective "app0" restore passed and preserved NVS.
- Cancellation during writing passed and recovery by complete restore passed.
- Invalid region package was blocked before writing.
- Altered checksum package was blocked before writing.
Known Notes
- Default baudrate remains "115200"; higher speeds remain advanced options.
- Backups can contain credentials and device-specific data. They must remain outside public web paths.
- Full flash dumps do not include eFuses, so Secure Boot and Flash Encryption devices require special caution.
- "Execute restore" requires a connected ESP32, validated package, non-incompatible compatibility report and exact "RESTORE" confirmation.