From 2b3c3e4b452d0a3a46bbd4806467b29fd08d0495 Mon Sep 17 00:00:00 2001 From: ruv Date: Sun, 15 Mar 2026 12:27:31 -0400 Subject: [PATCH] docs: update user guide for v0.4.3.1 (release table, fall threshold, binary size) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Release table: v0.4.3.1 as recommended, importance note updated - fall_thresh default: 500→15000 with unit explanation - Binary size: updated to 978 KB / 755 KB (was 777 KB) Co-Authored-By: claude-flow --- docs/user-guide.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/user-guide.md b/docs/user-guide.md index 99a0eb56..32dca5f5 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -819,11 +819,12 @@ Pre-built binaries are available at [Releases](https://github.com/ruvnet/RuView/ | Release | What It Includes | Tag | |---------|-----------------|-----| -| [v0.4.1](https://github.com/ruvnet/RuView/releases/tag/v0.4.1-esp32) | **Stable** — CSI build fix, compile guard, AMOLED display, edge intelligence ([ADR-057](../docs/adr/ADR-057-firmware-csi-build-guard.md)) | `v0.4.1-esp32` | +| [v0.4.3.1](https://github.com/ruvnet/RuView/releases/tag/v0.4.3.1-esp32) | **Stable (recommended)** — Fall detection fix ([#263](https://github.com/ruvnet/RuView/issues/263)), 4MB flash support ([#265](https://github.com/ruvnet/RuView/issues/265)), watchdog fix ([#266](https://github.com/ruvnet/RuView/issues/266)) | `v0.4.3.1-esp32` | +| [v0.4.1](https://github.com/ruvnet/RuView/releases/tag/v0.4.1-esp32) | CSI build fix, compile guard, AMOLED display, edge intelligence ([ADR-057](../docs/adr/ADR-057-firmware-csi-build-guard.md)) | `v0.4.1-esp32` | | [v0.3.0-alpha](https://github.com/ruvnet/RuView/releases/tag/v0.3.0-alpha-esp32) | Alpha — adds on-device edge intelligence (ADR-039) | `v0.3.0-alpha-esp32` | | [v0.2.0](https://github.com/ruvnet/RuView/releases/tag/v0.2.0-esp32) | Raw CSI streaming, TDM, channel hopping, QUIC mesh | `v0.2.0-esp32` | -> **Important:** Firmware versions prior to v0.4.1 had CSI **disabled** in the build config, causing a runtime error (`E wifi:CSI not enabled in menuconfig!`). Always use v0.4.1 or later. +> **Important:** Always use **v0.4.3.1 or later**. Earlier versions have false fall detection alerts (v0.4.2 and below) and CSI disabled in the build config (pre-v0.4.1). ```bash # Flash an ESP32-S3 with 8MB flash (most boards) @@ -903,14 +904,14 @@ Key NVS settings for edge processing: |---------|---------|-----------------| | `edge_tier` | 0 | Processing tier (0=off, 1=stats, 2=vitals) | | `pres_thresh` | 50 | Sensitivity for presence detection (lower = more sensitive) | -| `fall_thresh` | 500 | Fall detection threshold (variance spike trigger) | +| `fall_thresh` | 15000 | Fall detection threshold in milli-units (15000 = 15.0 rad/s²). Normal walking is 2-5, real falls are 20+. Raise to reduce false positives. | | `vital_win` | 300 | How many frames of phase history to keep for breathing/HR extraction | | `vital_int` | 1000 | How often to send a vitals packet, in milliseconds | | `subk_count` | 32 | Number of best subcarriers to keep (out of 56) | When Tier 2 is active, the node sends a 32-byte vitals packet at 1 Hz (configurable) containing presence state, motion score, breathing BPM, heart rate BPM, confidence values, fall flag, and occupancy estimate. The packet uses magic `0xC5110002` and is sent to the same aggregator IP and port as raw CSI frames. -Binary size: 777 KB (24% free in the 1 MB app partition). +Binary size: 978 KB (53% free in the 2 MB app partition, 8MB flash) or 755 KB (4MB flash). > **Alpha notice**: Vital sign estimation uses heuristic BPM extraction. Accuracy is best with stationary subjects in controlled environments. Not for medical use.