ruv
8ff7c2c35a
Add `plugins/ruview` — an end-to-end toolkit for working with RuView (WiFi-DensePose) from Claude Code, mirrored as Codex prompts. Marketplace: `plugins/.claude-plugin/marketplace.json` (one plugin, `ruview`). Skills (9): ruview-quickstart, ruview-hardware-setup, ruview-configure, ruview-applications, ruview-model-training, ruview-advanced-sensing, ruview-cli-api, ruview-mmwave, ruview-verify — shell-first (cargo / python / idf.py / docker / node), no claude-flow MCP dependency. Commands (7): /ruview-start, /ruview-flash, /ruview-provision, /ruview-app, /ruview-train, /ruview-advanced, /ruview-verify. Agents (3): ruview-onboarding-guide, ruview-config-engineer, ruview-training-engineer. Codex mirror: codex/AGENTS.md + codex/README.md + codex/prompts/*.md (full command parity, enforced by scripts/smoke.sh). Docs: docs/adrs/0001-ruview-plugin-contract.md (Proposed). Verification: scripts/smoke.sh (13 structural checks). Provisioning docs reflect the full `provision.py` flag set (TDM mesh, edge tiers, vitals, hop channels, Cognitum Seed, swarm intervals) and the issue #391 NVS-namespace-replace gotcha. Verified: `claude plugin validate` (plugin + marketplace), loads via `claude --plugin-dir`, smoke 13/13, and confirmed against an attached ESP32-S3 on COM8 running the RuView CSI firmware (live adaptive_ctrl + csi_collector serial output). Co-Authored-By: claude-flow <ruv@ruv.net>
2.4 KiB
/ruview-provision — provision an ESP32 sensing node
Write NVS config to a RuView ESP32 node. Args: $ARGUMENTS (expect --port, --ssid, --password, --target-ip, optional --channel, --filter-mac). Default port COM8.
First get the authoritative flag list: python firmware/esp32-csi-node/provision.py --help (on Windows prefix PYTHONUTF8=1 PYTHONIOENCODING=utf-8 — the help text has non-ASCII and crashes under cp1252). Then run:
python firmware/esp32-csi-node/provision.py --port COM8 \
--ssid "<SSID>" --password "<PW>" --target-ip <SINK_IP> --target-port 5005 --node-id <0-255> \
[--channel <N>] [--filter-mac <AA:BB:CC:DD:EE:FF>] [--hop-channels 1,6,11 --hop-dwell 200] \
[--tdm-slot <i> --tdm-total <n>] [--edge-tier 0|1|2] [--pres-thresh 50] [--fall-thresh 15000] \
[--vital-win 300] [--vital-int 1000] [--subk-count 32] \
[--seed-url http://10.1.10.236 --seed-token <bearer> --zone lobby] [--swarm-hb 30] [--swarm-ingest 5] [--dry-run]
Trade-offs:
--channel <N>pins the node to one WiFi channel (set it to the AP's channel). Omit it and pass--hop-channels 1,6,11for the firmware's multi-band hopping schedule (more sensing bandwidth, uses neighbour APs as illuminators;--hop-dwellms per channel).--filter-mac <MAC>restricts CSI capture to one transmitter (cleaner signal); omit for all transmitters (more data, more noise).--edge-tier0/1/2 = off / stats / vitals (ADR-041).--tdm-slot/--tdm-totalslot a multi-node mesh.--fall-thresh 15000≈ 15.0 rad/s² (raise to cut false falls).
⚠️ Issue #391: flashing rewrites the entire csi_cfg NVS namespace — every key not on the CLI is erased. Pass the full set you want; warn before re-provisioning a working node. --dry-run builds the NVS binary without flashing; --force-partial allows config without WiFi creds (knowingly).
Fleet provisioning: python scripts/generate_nvs_matrix.py (subprocess-first — the esp_idf_nvs_partition_gen API changed across versions).
Verify: serial monitor (pyserial on COM8, 115200) should show adaptive_ctrl ticks + csi_collector: CSI cb #… len=128 rssi=… ch=… lines; the sink cd v2 && cargo run -p wifi-densepose-sensing-server should report incoming UDP frames if --target-ip points at this host. If no frames: wrong channel, MAC filter too tight, target-ip not this host, or WiFi creds wrong — re-run with corrected args.