What this page shows

OPTARIS senses people from WiFi Channel State Information (CSI) — no cameras, no wearables. Movement and breathing perturb the radio field between sensing nodes; the server turns those perturbations into a live occupancy count, dwell time, and per-zone activity.

No mock data, ever

Every value reads — until a real sensing frame arrives. The status badge tells you which state you're in:

• NO SIGNAL nothing connected yet — all values dashed.
• LIVE frames flowing; numbers are real-time.
• SIGNAL LOST stream dropped >5s. People now reverts to —, but today's recorded peak / entries / dwell / curve are kept (they're facts, not mocks).

Reading the tiles

• People now — live count in the space.
• Peak today — highest simultaneous count since midnight.
• Avg dwell — mean time a person stays (needs per-person tracks).
• Entries today — cumulative arrivals since midnight.

Connecting sensors

The page reads the sensing-server WebSocket. Resolution order:

• ?ws=ws://HOST:PORT/ws/sensing in the URL
• window.OPTARIS_WS_URL
• Setup-Wizard saved URL (localStorage.optaris-observatory-settings.wsUrl)
• same-origin /ws/sensing (when this page is served by the sensing-server)

The Sensors button also polls /api/v1/nodes every 3s, so a node connected over USB shows up the moment the server registers it — even before clean CSI flows.

Sensor health & troubleshooting

• Node shows STALE / no fresh CSI — the AP is almost certainly WiFi-6 (HE-only). ESP32-S3 can't extract CSI from 802.11ax frames. Add an 802.11n / HT fallback AP; yield drops to 0 pps otherwise.
• RSSI weaker than ~−78 dBm — move the node closer to the AP or reduce obstructions; weak links give noisy counts.
• Frame rate near 0 Hz — node is connected but not capturing; check channel match and the AP's PHY mode.
• Flashing firmware — the app binary writes to 0x20000 (OTA slot 0), not 0x10000. Wrong offset bricks boot.

Developer endpoints

• GET /api/v1/nodes — node roster (id, status, RSSI, last-seen, motion, person count)
• WS /ws/sensing — sensing_update frames (persons, zones, vital_signs, node_features, bssid_count)
• GET /api/v1/sensing/latest · /health · /api/v1/vital-signs