mirror of https://github.com/ruvnet/RuView synced 2026-06-09 10:13:17 +00:00

Files

T

ruv 8ff7c2c35a feat(plugins): RuView Claude Code + Codex marketplace plugin

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>

2026-05-11 17:39:16 -04:00

2.2 KiB

Raw Blame History

description, argument-hint

description	argument-hint
Provision WiFi credentials, sink IP, and optional channel / MAC-filter overrides onto a RuView ESP32 node.	--port COM8 --ssid ... --password ... --target-ip ... [--channel N] [--filter-mac AA:BB:..]

/ruview-provision

Write NVS config to an ESP32 sensing node.

Invoke the ruview-configure skill (§"Runtime device config" — has the full provision.py flag table).
Run python firmware/esp32-csi-node/provision.py --help for the authoritative options (on Windows: PYTHONUTF8=1 PYTHONIOENCODING=utf-8 python … — the help text has non-ASCII). Collect any missing params (port — default COM8, SSID, password, target sink IP, --target-port default 5005, --node-id).

Run:

python firmware/esp32-csi-node/provision.py --port <PORT> \
  --ssid "<SSID>" --password "<PW>" --target-ip <IP> --target-port 5005 --node-id <0-255> \
  [--channel <N>] [--filter-mac <MAC>] [--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://… --seed-token … --zone lobby] [--swarm-hb 30] [--swarm-ingest 5] [--dry-run]

Explain trade-offs: --channel pins the node (AP's channel) vs. --hop-channels for ADR-061 multi-freq hopping; --filter-mac restricts to one transmitter vs. omit for all (more data, more noise); --edge-tier 0/1/2 = off/stats/vitals; --tdm-slot/--tdm-total slot a multi-node mesh.
⚠️ 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 the user before re-provisioning a working node. --force-partial bypasses the WiFi-creds requirement (knowingly). --dry-run builds the NVS binary without flashing.
Fleet provisioning: scripts/generate_nvs_matrix.py (subprocess-first).
Verify: serial monitor (pyserial on the port, 115200) should show adaptive_ctrl ticks + csi_collector: CSI cb #… len=128 … lines; the sink (cd v2 && cargo run -p wifi-densepose-sensing-server) should report incoming UDP frames if --target-ip points at this host.

2.2 KiB Raw Blame History

/ruview-provision

2.2 KiB

Raw Blame History