* fix: provision.py esptool v5 syntax + refuse partial NVS flashes (#391)
Bug 1: `write_flash` -> `write-flash` for esptool v5.x compat
- Actual flash command (flash_nvs, line 153) was already fixed
- Dry-run manual-flash hint (line 301) still printed old syntax
Bug 2: Refuse partial invocations that would silently wipe NVS
- provision.py flashes a fresh NVS binary at offset 0x9000, which
REPLACES the entire csi_cfg namespace. Any key not passed on the
CLI is erased.
- Previously: `provision.py --port COM8 --target-port 5005` would
silently wipe ssid, password, target_ip, node_id, etc., causing
"Retrying WiFi connection (10/10)" in the field.
- Now: refuse unless all of --ssid/--password/--target-ip provided,
or --force-partial is set (prints warning listing wiped keys).
Validation:
- Dry-run: binary generates to 24576 bytes, hint uses write-flash
- Safety check: partial invocation rejected with clear message
- Force-partial: warning lists keys that will be wiped
- Hardware: esptool v5.1.0 `read-flash 0x9000 0x100` works on
attached ESP32-S3 (COM8); NVS preserved, device reconnected at
192.168.1.104 with node_id=2 intact after reset.
Co-Authored-By: claude-flow <ruv@ruv.net>
* docs: CHANGELOG catch-up for v0.5.5, v0.6.0, v0.7.0 (#367)
The changelog was stale at v0.5.4 — three releases were cut without
updating it. Added full entries for each, plus an [Unreleased] block
for the #391 provision.py fixes.
version.txt correctly stays at 0.6.0 — v0.7.0 was a model/pipeline
release, not a new firmware binary. Latest firmware is v0.6.0-esp32.
Closes#367
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(firmware): fall detection false positives + 4MB flash support (#263, #265)
Issue #263: Default fall_thresh raised from 2.0 to 15.0 rad/s² — normal
walking produces accelerations of 2.5-5.0 which triggered constant false
"Fall Detected" alerts. Added consecutive-frame requirement (3 frames)
and 5-second cooldown debounce to prevent alert storms.
Issue #265: Added partitions_4mb.csv and sdkconfig.defaults.4mb for
ESP32-S3 boards with 4MB flash (e.g. SuperMini). OTA slots are 1.856MB
each, fitting the ~978KB firmware binary with room to spare.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): repair all 3 QEMU workflow job failures
1. Fuzz Tests: add esp_timer_create_args_t, esp_timer_create(),
esp_timer_start_periodic(), esp_timer_delete() stubs to
esp_stubs.h — csi_collector.c uses these for channel hop timer.
2. QEMU Build: add libgcrypt20-dev to apt dependencies —
Espressif QEMU's esp32_flash_enc.c includes <gcrypt.h>.
Bump cache key v4→v5 to force rebuild with new dep.
3. NVS Matrix: switch to subprocess-first invocation of
nvs_partition_gen to avoid 'str' has no attribute 'size' error
from esp_idf_nvs_partition_gen API change. Falls back to
direct import with both int and hex size args.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): pip3 in IDF container + fix swarm QEMU artifact path
QEMU Test jobs: espressif/idf:v5.4 container has pip3, not pip.
Swarm Test: use /opt/qemu-esp32 (fixed path) instead of
${{ github.workspace }}/qemu-build which resolves incorrectly
inside Docker containers.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): source IDF export.sh before pip install in container
espressif/idf:v5.4 container doesn't have pip/pip3 on PATH — it
lives inside the IDF Python venv which is only activated after
sourcing $IDF_PATH/export.sh.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): pad QEMU flash image to 8MB with --fill-flash-size
QEMU rejects flash images that aren't exactly 2/4/8/16 MB.
esptool merge_bin produces a sparse image (~1.1 MB) by default.
Add --fill-flash-size 8MB to pad with 0xFF to the full 8 MB.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): source IDF export before NVS matrix generation in QEMU tests
The generate_nvs_matrix.py script needs the IDF venv's python
(which has esp_idf_nvs_partition_gen installed) rather than the
system /usr/bin/python3 which doesn't have the package.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): QEMU validation treats WARNs as OK + swarm IDF export
1. validate_qemu_output.py: WARNs exit 0 by default (no real WiFi
hardware in QEMU = no CSI data = expected WARNs for frame/vitals
checks). Add --strict flag to fail on warnings when needed.
2. Swarm Test: source IDF export.sh before running qemu_swarm.py
so pip-installed pyyaml is on the Python path.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): provision.py subprocess-first NVS gen + swarm IDF venv
provision.py had same 'str' has no attribute 'size' bug as the
NVS matrix generator — switch to subprocess-first approach.
Swarm test also needs IDF export for the swarm smoke test step.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): handle missing 'ip' command in QEMU swarm orchestrator
The IDF container doesn't have iproute2 installed, so 'ip' binary
is missing. Add shutil.which() check to can_tap guard and catch
FileNotFoundError in _run_ip() for robustness.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): skip Rust aggregator when cargo not available in swarm test
The IDF container doesn't have Rust installed. Check for cargo
with shutil.which() before attempting to spawn the aggregator,
falling back to aggregator-less mode (QEMU nodes still boot and
exercise the firmware pipeline).
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(ci): treat swarm test WARNs as acceptable in CI
The max_boot_time_s assertion WARNs because QEMU doesn't produce
parseable boot time data. Exit code 1 (WARN) is acceptable in CI
without real hardware; only exit code 2+ (FAIL/FATAL) should fail.
Co-Authored-By: claude-flow <ruv@ruv.net>
* fix(firmware): Kconfig EDGE_FALL_THRESH default 2000→15000
The nvs_config.c fallback (15.0f) was never reached because
Kconfig always defines CONFIG_EDGE_FALL_THRESH. The Kconfig
default was still 2000 (=2.0 rad/s²), causing false fall alerts
on real WiFi CSI data (7 alerts in 45s).
Fixed to 15000 (=15.0 rad/s²). Verified on real ESP32-S3 hardware
with live WiFi CSI: 0 false fall alerts in 60s / 1300+ frames.
Co-Authored-By: claude-flow <ruv@ruv.net>
* docs: update README, CHANGELOG, user guide for v0.4.3-esp32
- README: add v0.4.3 to release table, 4MB flash instructions,
fix fall-thresh example (5000→15000)
- CHANGELOG: v0.4.3-esp32 entry with all fixes and additions
- User guide: 4MB flash section with esptool commands
Co-Authored-By: claude-flow <ruv@ruv.net>
- provision.py: add --channel (CSI channel override) and --filter-mac
(AA:BB:CC:DD:EE:FF format) arguments with validation
- nvs_config: add csi_channel, filter_mac[6], filter_mac_set fields;
read from NVS on boot
- csi_collector: auto-detect AP channel when no NVS override is set;
filter CSI frames by source MAC when filter_mac is configured
- ADR-060 documents the design and rationale
Fixes#247, fixes#229
Fixes#215: provision.py now correctly imports from esp_idf_nvs_partition_gen
package (the pip-installable version) before falling back to legacy import.
Fixes#216: Added sdkconfig.defaults.template with custom partition table
configuration for 8MB flash boards. Copy to sdkconfig.defaults before build:
cp sdkconfig.defaults.template sdkconfig.defaults
Changes:
- firmware/esp32-csi-node/provision.py: Try esp_idf_nvs_partition_gen first
- scripts/provision.py: Same import fix
- firmware/esp32-csi-node/sdkconfig.defaults.template: 8MB flash config with
2MB OTA partitions, compiler size optimization, and CSI enabled
Co-Authored-By: claude-flow <ruv@ruv.net>
The user guide and release notes document TDM and edge intelligence
provisioning flags but provision.py only accepted --ssid, --password,
--target-ip, --target-port, and --node-id.
Add all NVS keys the firmware actually reads:
- --tdm-slot / --tdm-total: TDM mesh slot assignment
- --edge-tier: edge processing tier (0=off, 1=stats, 2=vitals)
- --pres-thresh, --fall-thresh: detection thresholds
- --vital-win, --vital-int: vitals timing parameters
- --subk-count: top-K subcarrier selection
Also validates that --tdm-slot and --tdm-total are specified together
and that slot < total.
Closes#130
- Move provision.py from release-only asset into firmware/esp32-csi-node/
- Fix user guide references from scripts/provision.py to correct path
- Update release link to v0.2.0-esp32
Co-Authored-By: claude-flow <ruv@ruv.net>
rUv
Reuven