Dual OTA partition table (ota_0/ota_1, 1920 KB each) on 4MB flash. Firmware gains OTA command, LED_OTA double-blink, version in STATUS, and automatic rollback validation. Pi-side esp-ota tool serves firmware via HTTP and orchestrates the update flow. esp-fleet gains ota subcommand.
2.1 KiB
2.1 KiB
ESP32 Hacking Tasks
Last Updated: 2026-02-04
Current Sprint: v0.3 - OTA Updates
P0 - Critical
- Create dual OTA partition table (
partitions.csv) - Update
sdkconfig.defaults(4MB flash, custom partitions, rollback, HTTP OTA) - Firmware: OTA command, ota_task, LED_OTA, rollback validation
- Firmware: Add version to STATUS reply
idf.py reconfigureto regenerate sdkconfig- Build and USB-flash first device (partition table change requires USB)
P1 - Important
- Pi-side
esp-otatool (HTTP server + OTA orchestration) esp-fleet otasubcommand (sequential fleet OTA)- Test OTA end-to-end:
esp-ota amber-maple.local - Regenerate
sdkconfig.sample
P2 - Normal
- OTA update remaining fleet (muddy-storm, hollow-acorn) via USB
- Test rollback (flash bad firmware, verify auto-revert)
- Document esp-ota in USAGE.md
P3 - Low
- Document esp-crab dual-antenna capabilities
- Document esp-radar console features
Completed: v0.2 - Remote Management
- Firmware: UDP command listener (port 5501)
- Firmware: LED status indicator (GPIO2)
- Firmware: NVS config persistence (rate, tx_power)
- Firmware: REBOOT, IDENTIFY, STATUS commands
- Firmware: RATE command (10-100 Hz, restarts ping)
- Firmware: POWER command (2-20 dBm)
- Pi-side:
esp-cmdCLI tool - Pi-side:
esp-fleetfleet management tool - mDNS hostname, watchdog, human-readable uptime
- Build and flash to device
- Update CHEATSHEET.md
Completed: v0.1 - Documentation
- Copy firmware sources to project
- Document current firmware and settings
- Document build & flash workflow
- Create .gitignore for build artifacts
- Test building firmware from this repo
- Document CSI config options
Notes
- NVS offset changes with new partition table — first USB flash resets saved config
- First device must be USB-flashed to switch partition table, subsequent updates via OTA
esp_https_otais built into ESP-IDF core — no extra deps needed- OTA download ~790 KB on LAN takes ~3-5s, well under 30s watchdog
- CSI data keeps flowing during OTA download