Vigil / Guides

How Room Sensing Works: WiFi and Acoustic Sensing Explained

"Room sensing" sounds like science fiction: a house that knows which rooms are occupied without a camera in sight. The underlying physics, though, is old and well understood — sonar has guided ships for a century, and radio engineers have always known that bodies disturb signals. What's new is that ordinary consumer hardware is now sensitive enough, and computers fast enough, to do it at home.

This guide walks through the two sensing families most relevant to a modern setup — acoustic sonar and WiFi channel-state sensing — and then covers the part most product pages skip: the privacy model, and what these systems can and cannot actually tell about you.

Acoustic sonar: hearing the shape of a room

Sonar works by emitting sound and measuring what comes back. A home implementation uses a speaker to play a signal near or above the top of the human hearing range — Vigil's Room Sonar, for example, operates in the 18–22 kHz band, which most adults cannot hear — and a microphone to record the reflections.

Three things make the echoes informative:

The limits are physical: sound doesn't pass through walls, so sonar covers the room the device sits in. Loud environments, absorbent furnishings, and distance all weaken the signal. An honest sonar pipeline reports motion and breathing only when the echo pattern clearly supports it.

WiFi sensing: reading the radio environment

Every WiFi packet that crosses a room arrives at its receiver as many overlapping copies — one for each path the radio waves took, bouncing off walls, floors, furniture, and people. Receivers characterize this multipath environment with a measurement called channel state information (CSI): for each frequency subcarrier in the WiFi channel, how much the signal was attenuated and how its phase shifted in transit.

That measurement exists because WiFi needs it to decode data at all. Sensing repurposes it: since a human body absorbs and reflects 2.4/5 GHz radio waves, a person who enters, moves through, or simply breathes inside the coverage area perturbs the CSI in ways that stand out from the static background of the room.

What CSI-based sensing can support, depending on hardware and conditions:

The property that makes CSI genuinely different from every camera and every sonar: radio passes through interior walls. A single well-placed sensing node can cover space it cannot see, which is what makes whole-home, no-camera coverage possible. In Vigil, inexpensive ESP32-based nodes stream CSI frames over the network (UDP port 5005) to the Mac, which does all the processing; a bundled simulator streams a recorded capture into the same pipeline so you can explore the through-wall view before owning any node hardware.

The privacy model: why sensing is not surveillance

The instinctive worry — "my house is watching me" — deserves a direct answer. It comes in two parts.

1. The signal itself carries very little about you

A camera frame contains your face, your screen, your mail, your body. A CSI frame contains per-subcarrier amplitudes and phases; a sonar buffer contains echo timings. Neither can be "played back" as an image of your life. The information that can be extracted is narrow by construction: something is present, something moved, something is breathing. There is no identity, no appearance, no audio content — sonar pipelines analyze their own emitted chirp's reflections, not your conversations.

2. Where the processing happens decides who learns it

Even narrow signals form a pattern over time — when you're home, which rooms you use, when you sleep. That occupancy pattern is sensitive, and the architecture question is who gets to see it. A cloud-processed sensor ships raw or semi-raw readings to a vendor's servers, where the pattern accumulates outside your control. An on-device system processes everything on hardware you own, so the pattern never exists anywhere else. This is the single most consequential design choice in a sensing product; our guide on keeping smart-home data on your own hardware covers it in depth.

Vigil's position on both parts: raw sensing never leaves your Mac, the core runs with the internet off, and the activity log lives in a folder on your own disk — exportable by you, uploaded to no one.

What room sensing honestly cannot do

Putting it together

A practical room-sensing stack layers the approaches: sonar covers the room your computer sits in with zero extra hardware; camera-based pose (strictly optional, permission-gated) adds detail in that same room; CSI nodes extend coverage through walls to the rest of the home. Each layer feeds one shared model of occupancy, which then drives automations — lights that follow real presence — and a security layer that treats confirmed presence in an armed, empty house as the event worth alerting on.

See your home the way physics does

Vigil runs acoustic sonar, optional camera pose, and through-wall CSI sensing on the Mac you already own — gated, honest readings with no vendor cloud.

Get Vigil — $25/mo