Merge a83956a8ac into f5d0e1e69e

demo-single-esp32s3/README.md

@@ -0,0 +1,122 @@
+# RuView Single ESP32-S3 Demo
+
+A simplified setup for running RuView with just ONE ESP32-S3 board for basic presence detection.
+
+> **Note:** Single-node detection has limited spatial resolution. For full pose estimation (17 keypoints), use 2+ nodes. This demo focuses on **presence detection** - detecting if someone is in the room.
+
+## What You Need
+
+| Item | Cost | Notes |
+|------|------|-------|
+| ESP32-S3 DevKit (8MB flash) | ~$9 | Any ESP32-S3 with 8MB flash works |
+| Micro USB cable | ~$5 | For power + programming |
+| WiFi network | - | 2.4GHz WiFi required |
+
+## Quick Start
+
+### Step 1: Get Pre-built Firmware
+
+Download the latest firmware from releases:
+- Go to: https://github.com/Rudraa-25/RuView/releases
+- Download `esp32-csi-node.bin` (or build from source - see below)
+
+### Step 2: Flash the Firmware
+
+Connect your ESP32-S3 to your PC via USB. Note the COM port (e.g., COM7 on Windows).
+
+```bash
+# Install esptool if you don't have it
+pip install esptool
+
+# Flash the firmware (replace COM7 with your port)
+python -m esptool --chip esp32s3 --port COM7 --baud 460800 \
+  write_flash --flash_mode dio --flash_size 8MB \
+  0x0 release/bootloader.bin \
+  0x8000 release/partition-table.bin \
+  0x10000 release/esp32-csi-node.bin
+```
+
+### Step 3: Provision WiFi
+
+After flashing, provision your WiFi credentials (no reflashing needed):
+
+```bash
+python firmware/esp32-csi-node/provision.py --port COM7 \
+  --ssid "YourWiFiName" --password "YourWiFiPassword" --target-ip 192.168.1.100
+```
+
+### Step 4: Run the Sensing Server
+
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Start the server (single-node mode)
+cargo run -p wifi-densepose-sensing-server -- --http-port 3000 --source single
+```
+
+### Step 5: Open the Dashboard
+
+Navigate to http://localhost:3000 in your browser.
+
+You should see presence detection data flowing in when people are in range of your WiFi router and the ESP32-S3.
+
+## Building from Source (Optional)
+
+If you want to build the firmware yourself:
+
+```bash
+# Using Docker (recommended for Windows)
+MSYS_NO_PATHCONV=1 docker run --rm \
+  -v "$(pwd)/firmware/esp32-csi-node:/project" -w /project \
+  espressif/idf:v5.2 bash -c \
+  "rm -rf build sdkconfig && idf.py set-target esp32s3 && idf.py build"
+
+# Flash the built firmware
+python -m esptool --chip esp32s3 --port COM7 --baud 460800 \
+  write_flash --flash_mode dio --flash_size 8MB \
+  0x0 firmware/esp32-csi-node/build/bootloader/bootloader.bin \
+  0x8000 firmware/esp32-csi-node/build/partition_table/partition-table.bin \
+  0x10000 firmware/esp32-csi-node/build/esp32-csi-node.bin
+```
+
+## What's Detected
+
+With a single ESP32-S3, you can detect:
+
+| Feature | Description |
+|---------|-------------|
+| **Presence** | Is someone in the room? (Yes/No) |
+| **Motion** | Is someone moving? |
+| **Distance** | Approximate distance from the ESP32 |
+
+## What's NOT Available (Needs 2+ Nodes)
+
+- Full body pose (17 keypoints)
+- Breathing rate
+- Heart rate
+- 3D position tracking
+
+## Troubleshooting
+
+**No data appearing?**
+- Check ESP32 is connected to WiFi: `python -m serial.tools.miniterm COM7 115200`
+- Verify the IP address is reachable from your PC
+- Make sure your WiFi router is on the same network
+
+**Getting errors?**
+- Check the logs in `logs/` folder
+- Verify COM port is correct (check Device Manager on Windows)
+
+## Files in This Demo
+
+```
+demo-single-esp32s3/
+├── README.md           # This file
+├── setup.sh            # Quick setup script
+└── config.env.example  # Example configuration
+```
+
+## License
+
+MIT - Same as main RuView project

demo-single-esp32s3/check_esp32.py

@@ -0,0 +1,34 @@
+"""
+Simple script to check ESP32 connection status.
+Run this to see if your ESP32 is connected to WiFi.
+"""
+import serial
+import time
+import sys
+
+def check_esp32(port='COM5', baud=115200):
+    print(f"Checking ESP32 on {port} at {baud} baud...")
+    print("Press Ctrl+C to exit\n")
+
+    try:
+        ser = serial.Serial(port, baud, timeout=1)
+        time.sleep(2)  # Wait for connection
+
+        # Read some output
+        for _ in range(20):
+            if ser.in_waiting:
+                line = ser.readline().decode('utf-8', errors='ignore').strip()
+                if line:
+                    print(line)
+            time.sleep(0.5)
+
+    except serial.SerialException as e:
+        print(f"Error: {e}")
+        print("\nMake sure:")
+        print("1. ESP32 is connected to your PC via USB")
+        print("2. No other program is using the COM port")
+        print("3. You're using the correct COM port (e.g., COM5)")
+
+if __name__ == "__main__":
+    port = sys.argv[1] if len(sys.argv) > 1 else 'COM5'
+    check_esp32(port)