frank/ruvnet--RuView
1
0
Fork 0
mirror of https://github.com/ruvnet/RuView synced 2026-06-09 10:13:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat: RuView Live unified dashboard + improved examples README

Browse Source 
ruview_live.py: single-file dashboard that auto-detects CSI and
mmWave sensors, displays fused vitals (HR, BR, BP, stress/HRV),
environment (light, RSSI, RF fingerprint), presence, and events.

Tested live: CSI 1000 frames/60s (17 Hz), light trending 7.4→6.0
lux, RSSI -57 to -72 dBm. Handles graceful degradation when
sensors are unavailable.

README: updated with unified dashboard as primary entry point,
hardware table with capabilities, expanded quick start.

Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
ruv
2026-03-15 16:56:11 -04:00
parent 24ea88cbe0
commit 4239dfa35a
2 changed files with 421 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
examples/README.md
+35 -15
View File
@@ -2,34 +2,54 @@
Real-time sensing applications built on the RuView platform.
## Unified Dashboard (start here)
```bash
pip install pyserial numpy
python examples/ruview_live.py --csi COM7 --mmwave COM4
```
The live dashboard auto-detects available sensors and displays fused vitals, environment data, and events in real-time. Works with any combination of sensors.
## Individual Examples
| Example | Sensors | What It Does |
|---------|---------|-------------|
| [Medical: Blood Pressure](medical/) | mmWave (COM4) | Contactless BP estimation from HRV |
| [Sleep: Apnea Screener](sleep/) | mmWave (COM4) | Detects breathing cessation events, computes AHI |
| [Stress: HRV Monitor](stress/) | mmWave (COM4) | Real-time stress level from heart rate variability |
| [Environment: Room Monitor](environment/) | CSI (COM7) + mmWave (COM4) | Occupancy, light, RF fingerprint, activity events |
| [**ruview_live.py**](ruview_live.py) | CSI + mmWave + Light | Unified dashboard: HR, BR, BP, stress, presence, light, RSSI |
| [Medical: Blood Pressure](medical/) | mmWave | Contactless BP estimation from HRV |
| [Sleep: Apnea Screener](sleep/) | mmWave | Detects breathing cessation events, computes AHI |
| [Stress: HRV Monitor](stress/) | mmWave | Real-time stress level from heart rate variability |
| [Environment: Room Monitor](environment/) | CSI + mmWave | Occupancy, light, RF fingerprint, activity events |
## Hardware Required
## Hardware
| Port | Device | Cost |
|------|--------|------|
| COM7 | ESP32-S3 (WiFi CSI) | ~$9 |
| COM4 | ESP32-C6 + Seeed MR60BHA2 (60 GHz mmWave) | ~$15 |
| Port | Device | Cost | What It Provides |
|------|--------|------|-----------------|
| COM7 | ESP32-S3 (WiFi CSI) | ~$9 | Presence, motion, breathing, heart rate (through walls) |
| COM4 | ESP32-C6 + Seeed MR60BHA2 | ~$15 | Precise HR/BR, presence, distance, ambient light |
Either sensor works alone. Both together enable fusion (mmWave 80% + CSI 20%).
## Quick Start
```bash
pip install pyserial numpy
# Blood pressure
# Unified dashboard (recommended)
python examples/ruview_live.py --csi COM7 --mmwave COM4
# Blood pressure estimation
python examples/medical/bp_estimator.py --port COM4
# Sleep apnea screening
python examples/sleep/apnea_screener.py --port COM4 --duration 3600
# Sleep apnea screening (run overnight)
python examples/sleep/apnea_screener.py --port COM4 --duration 28800
# Stress monitoring
python examples/stress/hrv_stress_monitor.py --port COM4
# Stress monitoring (workday session)
python examples/stress/hrv_stress_monitor.py --port COM4 --duration 3600
# Full room monitor (both sensors)
# Room environment monitor
python examples/environment/room_monitor.py --csi-port COM7 --mmwave-port COM4
# CSI only (no mmWave)
python examples/ruview_live.py --csi COM7 --mmwave none
```