Files
esp32-hacking/TASKS.md
user c922e05266 feat: Add v0.4 adaptive sampling — wander detection, auto rate control
On-device CSI wander calculation (coefficient of variation over 50-packet
window). Rate drops to 10 Hz when idle, jumps to 100 Hz on motion with
3s holdoff. EVENT notifications sent to Pi on rate changes. New commands:
ADAPTIVE ON/OFF, THRESHOLD. RATE command disables adaptive mode.
All settings NVS-persisted.
2026-02-04 16:34:19 +01:00

2.5 KiB

ESP32 Hacking Tasks

Last Updated: 2026-02-04

Current Sprint: v0.5 - BLE Scanning

P0 - Critical

  • Enable Bluetooth alongside WiFi
  • Periodic BLE advertisement scanning

P1 - Important

  • Report device MAC, RSSI, name via UDP
  • Pi-side BLE device tracking

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.4 - Adaptive Sampling

  • On-device CSI wander calculation (coefficient of variation)
  • Adaptive rate: 10 pkt/s idle (3s holdoff) → 100 pkt/s on motion
  • EVENT notification to Pi on rate change
  • ADAPTIVE ON/OFF command (NVS persisted)
  • THRESHOLD command for tuning sensitivity (NVS persisted)
  • RATE command disables adaptive mode
  • adaptive/motion fields in STATUS reply
  • OTA deployed and verified on amber-maple

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

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

  • Adaptive threshold varies by environment; 0.001-0.01 is a good starting range
  • NVS keys: send_rate, tx_power, adaptive, threshold
  • EVENT packets sent on CSI UDP port when adaptive rate changes
  • OTA download ~904 KB on LAN takes ~3-5s, well under 30s watchdog