Add files via upload

assets/README.txt

@@ -0,0 +1,135 @@
+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