esp32-hacking/TASKS.md

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

• Dual OTA partition table (partitions.csv)
• 4MB flash, custom partitions, rollback in sdkconfig.defaults
• Firmware: OTA command, ota_task, LED_OTA, rollback validation
• Firmware: version in STATUS reply
• Pi-side esp-ota tool (HTTP server + OTA orchestration)
• esp-fleet ota subcommand (sequential fleet update)
• Build and USB-flash amber-maple (partition table change)
• End-to-end OTA test verified
• Regenerate sdkconfig.sample
• Update CHEATSHEET.md, USAGE.md

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 ~896 KB on LAN takes ~3-5s, well under 30s watchdog
• CSI data keeps flowing during OTA download