Files
esp32-hacking/TASKS.md

66 lines
2.3 KiB
Markdown

# ESP32 Hacking Tasks
**Last Updated:** 2026-02-04
## Current Sprint: v0.4 - Adaptive Sampling
### P0 - Critical
- [ ] On-device CSI wander calculation (simplified)
- [ ] Adaptive rate: 10 pkt/s idle → 100 pkt/s on motion
### P1 - Important
- [ ] Rate change notification to Pi
- [ ] Tunable motion threshold via UDP command
### P2 - Normal
- [ ] OTA update remaining fleet (muddy-storm, hollow-acorn) via USB
- [ ] Test rollback (flash bad firmware, verify auto-revert)
### P3 - Low
- [ ] Document esp-crab dual-antenna capabilities
- [ ] Document esp-radar console features
## Completed: v0.3 - OTA Updates
- [x] Dual OTA partition table (`partitions.csv`)
- [x] 4MB flash, custom partitions, rollback in sdkconfig.defaults
- [x] Firmware: OTA command, ota_task, LED_OTA, rollback validation
- [x] Firmware: version in STATUS reply
- [x] Pi-side `esp-ota` tool (HTTP server + OTA orchestration)
- [x] `esp-fleet ota` subcommand (sequential fleet update)
- [x] Build and USB-flash amber-maple (partition table change)
- [x] End-to-end OTA test verified
- [x] Regenerate sdkconfig.sample
- [x] Update CHEATSHEET.md, USAGE.md
## Completed: v0.2 - Remote Management
- [x] Firmware: UDP command listener (port 5501)
- [x] Firmware: LED status indicator (GPIO2)
- [x] Firmware: NVS config persistence (rate, tx_power)
- [x] Firmware: REBOOT, IDENTIFY, STATUS commands
- [x] Firmware: RATE command (10-100 Hz, restarts ping)
- [x] Firmware: POWER command (2-20 dBm)
- [x] Pi-side: `esp-cmd` CLI tool
- [x] Pi-side: `esp-fleet` fleet management tool
- [x] mDNS hostname, watchdog, human-readable uptime
- [x] Build and flash to device
- [x] Update CHEATSHEET.md
## Completed: v0.1 - Documentation
- [x] Copy firmware sources to project
- [x] Document current firmware and settings
- [x] Document build & flash workflow
- [x] Create .gitignore for build artifacts
- [x] Test building firmware from this repo
- [x] 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 ~896 KB on LAN takes ~3-5s, well under 30s watchdog
- CSI data keeps flowing during OTA download