Skip to content

Commit 2b3c3e4

Browse files
committed
docs: update user guide for v0.4.3.1 (release table, fall threshold, binary size)
- 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 <ruv@ruv.net>
1 parent 024d258 commit 2b3c3e4

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

docs/user-guide.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -819,11 +819,12 @@ Pre-built binaries are available at [Releases](https://github.com/ruvnet/RuView/
819819
820820
| Release | What It Includes | Tag |
821821
|---------|-----------------|-----|
822-
| [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` |
822+
| [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` |
823+
| [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` |
823824
| [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` |
824825
| [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` |
825826
826-
> **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.
827+
> **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).
827828
828829
```bash
829830
# Flash an ESP32-S3 with 8MB flash (most boards)
@@ -903,14 +904,14 @@ Key NVS settings for edge processing:
903904
|---------|---------|-----------------|
904905
| `edge_tier` | 0 | Processing tier (0=off, 1=stats, 2=vitals) |
905906
| `pres_thresh` | 50 | Sensitivity for presence detection (lower = more sensitive) |
906-
| `fall_thresh` | 500 | Fall detection threshold (variance spike trigger) |
907+
| `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. |
907908
| `vital_win` | 300 | How many frames of phase history to keep for breathing/HR extraction |
908909
| `vital_int` | 1000 | How often to send a vitals packet, in milliseconds |
909910
| `subk_count` | 32 | Number of best subcarriers to keep (out of 56) |
910911
911912
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.
912913
913-
Binary size: 777 KB (24% free in the 1 MB app partition).
914+
Binary size: 978 KB (53% free in the 2 MB app partition, 8MB flash) or 755 KB (4MB flash).
914915
915916
> **Alpha notice**: Vital sign estimation uses heuristic BPM extraction. Accuracy is best with stationary subjects in controlled environments. Not for medical use.
916917

0 commit comments

Comments
 (0)