Ruview/assets
ruv 8b57a6f64c docs: update README with ADR-045–048, Observatory, adaptive classifier, AMOLED display
- Update ADR count from 44 to 48
- Add adaptive classifier (ADR-048) to Intelligence features
- Add Observatory visualization (ADR-047) and AMOLED display (ADR-045) to Deployment features
- Update screenshot to v2-screen.png
- Add ADR-045 (AMOLED), ADR-046 (Android TV), ADR-047 (Observatory), DDD deployment model
- Add AMOLED display firmware (display_hal, display_task, display_ui, LVGL config)
- Add Observatory UI (13 Three.js modules, CSS, HTML entry point)
- Add trained adaptive model JSON
- Update .gitignore for managed_components, recordings, .swarm

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-05 10:20:48 -05:00
..
exported-assets.zip Add WiFi DensePose implementation and results 2025-06-07 05:23:07 +00:00
README.txt Add files via upload 2026-01-13 16:04:26 -05:00
ruview-small-gemini.jpg Update README hero image to ruview-small-gemini 2026-03-04 10:37:42 -05:00
ruview-small.jpg Add RuView hero image to top of README 2026-03-04 10:19:41 -05:00
screen.png fix: update image references and remove obsolete screenshots 2026-03-02 11:11:58 -05:00
screenshot.png Implement feature X to enhance user experience and optimize performance 2026-02-28 23:51:23 -05:00
v2-screen.png docs: update README with ADR-045–048, Observatory, adaptive classifier, AMOLED display 2026-03-05 10:20:48 -05:00
wifi-densepose-demo.zip Add WiFi DensePose implementation and results 2025-06-07 05:23:07 +00:00
wifi-mat.zip Add files via upload 2026-01-13 16:04:26 -05:00

WiFi-Mat v3.2 - AI Thermal Monitor + WiFi CSI Sensing
======================================================

Embedded AI system combining thermal monitoring with WiFi-based
presence detection, inspired by WiFi-DensePose technology.

For Heltec ESP32-S3 with OLED Display

CORE CAPABILITIES:
------------------
* Thermal Pattern Learning - Spiking Neural Network (LIF neurons)
* WiFi CSI Sensing - Through-wall motion/presence detection
* Breathing Detection - Respiratory rate from WiFi phase
* Anomaly Detection - Ruvector-inspired attention weights
* HNSW Indexing - Fast O(log n) pattern matching
* Power Optimization - Adaptive sleep modes

VISUAL INDICATORS:
------------------
* Animated motion figure when movement detected
* Radar sweep with detection blips
* Breathing wave visualization with BPM
* Status bar: WiFi/Motion/Alert icons
* Screen flash on anomaly or motion alerts
* Dynamic confidence bars

DISPLAY MODES (cycle with double-tap):
--------------------------------------
1. STATS  - Temperature, zone, patterns, attention level
2. GRAPH  - Temperature history graph (40 samples)
3. PTRNS  - Learned pattern list with scores
4. ANOM   - Anomaly detection with trajectory view
5. AI     - Power optimization metrics
6. CSI    - WiFi CSI motion sensing with radar
7. RF     - RF device presence detection
8. INFO   - Device info, uptime, memory

AI POWER OPTIMIZATION (AI mode):
--------------------------------
* Mode: ACTIVE/LIGHT/DEEP sleep states
* Energy: Estimated power savings (0-95%)
* Neurons: Active vs idle neuron ratio
* HNSW: Hierarchical search efficiency
* Spikes: Neural spike efficiency
* Attn: Pattern attention weights

WIFI CSI SENSING (CSI mode):
----------------------------
Uses WiFi Channel State Information for through-wall sensing:

* MOTION/STILL - Real-time motion detection
* Radar Animation - Sweep with confidence blips
* Breathing Wave - Sine wave + BPM when detected
* Confidence % - Detection confidence level
* Detection Count - Cumulative motion events
* Variance Metrics - Signal variance analysis

Technology based on WiFi-DensePose concepts:
- Phase unwrapping for movement detection
- Amplitude variance for presence sensing
- Frequency analysis for breathing rate
- No cameras needed - works through walls

BUTTON CONTROLS:
----------------
* TAP (quick)     - Learn current thermal pattern
* DOUBLE-TAP      - Cycle display mode
* HOLD 1 second   - Pause/Resume monitoring
* HOLD 2 seconds  - Reset all learned patterns
* HOLD 3+ seconds - Show device info

INSTALLATION:
-------------
1. Connect Heltec ESP32-S3 via USB
2. Run flash.bat (Windows) or flash.ps1 (PowerShell)
3. Enter COM port when prompted (e.g., COM7)
4. Wait for flash to complete (~60 seconds)
5. Device auto-connects to configured WiFi

REQUIREMENTS:
-------------
* espflash tool: cargo install espflash
* Heltec WiFi LoRa 32 V3 (ESP32-S3)
* USB-C cable
* Windows 10/11

WIFI CONFIGURATION:
-------------------
Default network: ruv.net

To change WiFi credentials, edit source and rebuild:
  C:\esp\src\main.rs (lines 43-44)

HARDWARE PINOUT:
----------------
* OLED SDA: GPIO17
* OLED SCL: GPIO18
* OLED RST: GPIO21
* OLED PWR: GPIO36 (Vext)
* Button: GPIO0 (PRG)
* Thermal: MLX90614 on I2C

TECHNICAL SPECS:
----------------
* MCU: ESP32-S3 dual-core 240MHz
* Flash: 8MB
* RAM: 512KB SRAM + 8MB PSRAM
* Display: 128x64 OLED (SSD1306)
* WiFi: 802.11 b/g/n (2.4GHz)
* Bluetooth: BLE 5.0

NEURAL NETWORK:
---------------
* Architecture: Leaky Integrate-and-Fire (LIF)
* Neurons: 16 configurable
* Patterns: Up to 32 learned
* Features: 6 sparse dimensions
* Indexing: 3-layer HNSW hierarchy

SOURCE CODE:
------------
Full Rust source: C:\esp\src\main.rs
WiFi CSI module: C:\esp\src\wifi_csi.rs
Build script: C:\esp\build.ps1

BASED ON:
---------
* Ruvector - Vector database with HNSW indexing
* WiFi-DensePose - WiFi CSI for pose estimation
* esp-rs - Rust on ESP32

LICENSE:
--------
Created with Claude Code
https://github.com/ruvnet/wifi-densepose