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.
2.5 KiB
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-otatool (HTTP server + OTA orchestration) esp-fleet otasubcommand (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-cmdCLI tool - Pi-side:
esp-fleetfleet 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