How ruvnet/ruview works
RuView is a WiFi-based spatial sensing platform: ESP32 nodes capture CSI, sensing pipelines infer occupancy, motion, pose and vital signs, and user interfaces or smart-home integrations expose results. The repository also documents model training/loading, governed evidence, local automation, a multi-sensor world model, and an AI operator. The graph preserves those major branches alongside the sampled firmware, dashboard and processing modules. Some subsystems are represented by their enclosing source directories because their implementation files were not sampled; unsampled internal connections are not asserted.
Main entry points: csi_pipeline.rs CSI processing · main ESP32 CSI nodes · app.js RuView dashboard · adaptive_controller.c Adaptive controller
Components 24
Edge sensing
- ESP32 CSI nodes
firmware/esp32-csi-node/main - Adaptive controller
firmware/esp32-csi-node/main/adaptive_controller.c - Radio operations
firmware/esp32-csi-node/main/rv_radio_ops.h - Feature state
firmware/esp32-csi-node/main/rv_feature_state.h - Privacy shield
wifi-veil/firmware/core/veil_shield.h - RIS controller
wifi-veil/firmware/esp32/veil_ris_controller/veil_ris_controller.c
Sensing and inference
- CSI processing
v2/crates/wifi-densepose-pointcloud/src/csi_pipeline.rs - Pose refinement
v2/crates/wifi-densepose-physics/src/engine.rs - Sensing server
v2/crates/wifi-densepose-sensing-server/src/rvf_pipeline.rs - Unified RF world model
v2/crates - Governed evidence
v2/crates/wifi-densepose-sensing-server/src
User interfaces
- RuView dashboard
ui/app.js - Live sensing view
ui/components/LiveDemoTab.js - Sensing service
ui/services/sensing.service.js - WebSocket service
ui/services/websocket.service.js - Spatial workspace
dashboard/src/components/nv-app.ts - App runtimes
dashboard/src/store/appRuntimes.ts - Simulation transport
dashboard/src/transport/NvsimClient.ts
Models and automation
- RVF model container
v2/crates/wifi-densepose-sensing-server/src - Model workflow
ui/components/TrainingPanel.js - HOMECORE automation
v2/crates/homecore-automation/src/engine.rs
Operator toolkit
- RuView MetaHarness
harness/ruview/src
Other components
- Room occupants
- Smart-home ecosystems
Connections 22
- Room occupants → ESP32 CSI nodes: disturbs radio
- ESP32 CSI nodes → CSI processing: provides CSI
- CSI processing → Pose refinement: estimates pose
- CSI processing → Sensing server: sends sensing data
- Sensing server → RVF model container: builds model data
v2/crates/wifi-densepose-sensing-server/src/rvf_pipeline.rs - Model workflow → RVF model container: loads model files
- ESP32 CSI nodes → Adaptive controller: adapts capture
firmware/esp32-csi-node/main/adaptive_controller.c - Adaptive controller → Radio operations: sets capture profile
firmware/esp32-csi-node/main/adaptive_controller.c - Adaptive controller → Feature state: reads node state
firmware/esp32-csi-node/main/adaptive_controller.c - CSI processing → Sensing service: supplies sensing results
- Sensing service → WebSocket service: streams updates
- RuView dashboard → Live sensing view: initializes view
ui/app.js - RuView dashboard → Sensing service: initializes service
ui/app.js - RuView dashboard → WebSocket service: uses service
ui/app.js - Spatial workspace → App runtimes: manages workspace
- App runtimes → Simulation transport: uses client
dashboard/src/store/appRuntimes.ts - Sensing server → Governed evidence: attaches provenance
v2/crates/wifi-densepose-sensing-server/src/rvf_pipeline.rs - CSI processing → Unified RF world model: contributes RF sensing
v2/crates/wifi-densepose-pointcloud/src/csi_pipeline.rs - HOMECORE automation → Smart-home ecosystems: exposes automation
- RuView MetaHarness → ESP32 CSI nodes: accesses devices
- RuView MetaHarness → Model workflow: guides training
- Privacy shield → RIS controller: controls obfuscation
wifi-veil/firmware/esp32/veil_ris_controller/veil_ris_controller.c