Files
esp32-hacking/TASKS.md
user d65ac208b9 feat: Add v0.3 OTA updates — dual partition, esp-ota tool, rollback
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.
2026-02-04 16:19:09 +01:00

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 reconfigure to regenerate sdkconfig
  • Build and USB-flash first device (partition table change requires USB)

P1 - Important

  • Pi-side esp-ota tool (HTTP server + OTA orchestration)
  • esp-fleet ota subcommand (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-cmd CLI tool
  • Pi-side: esp-fleet fleet 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_ota is 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