Guides

Learn how Wi-Fi sensing works, set up your first sensor, then tune it for your room.

Furnished room with fixed blue Wi-Fi paths and an amber path reflected by a walking person before reaching an ESP32
THEORY

What is Wi-Fi sensing?

How it detects movement, what you need, and how to try it at home.

4 min read
Six supported ESP32 boards arranged in a row
HARDWARE

Choose your hardware

How to choose a compact board, antenna, and power supply.

2 min read
An ESP32 board connected to a laptop for browser flashing
SETUP

Flash and set up your device

Install from the browser, connect to Wi-Fi, and add the device to Home Assistant.

7 min read
Top-down room showing a router, an ESP32, a walking person, and reflected Wi-Fi paths
INSTALLATION

Place your ESPectre sensor

Distance, antenna orientation, obstacles, and a repeatable room test.

6 min read
An ESP32 branching one Wi-Fi signal into short and deep processing paths
DETECTION

Choose your detection profile

Lightweight or High Accuracy: what each one costs and when to pick it.

3 min read
An ESP32 sending sensing data to the ESPectre dashboard in Home Assistant
HOME ASSISTANT

Build your Home Assistant dashboard

Build a dashboard for ESPHome or MQTT devices, and add the optional traffic generator app.

8 min read
An ESP32 board connected to an abstract YAML configuration panel and a smart-home motion icon
ESPHOME

Use the component built into ESPHome

Add motion sensing to any ESPHome YAML, and see how it compares with the external component.

5 min read
A Python snake mascot perched on an Espressif board connected to a laptop displaying CSI traces
MICROPYTHON

Run ESPectre on MicroPython

Capture CSI and detect motion in MicroPython, with the CSI support ESPectre added upstream.

3 min read
An ESP32 board connected to a laptop displaying the Arduino logo, sending a Wi-Fi CSI signal to a motion icon
ARDUINO

Add ESPectre to an Arduino sketch

Detect motion in an Arduino-ESP32 sketch, while your sketch keeps control of Wi-Fi.

3 min read
ESP32-C3 beside a laptop displaying a CSI amplitude surface
MACHINE LEARNING

Collect CSI data for machine learning

Record labelled datasets, check capture quality, and contribute measurements from your room.

5 min read
An ESP32 connected to a laptop showing signal diagnostics, with a magnifying glass inspecting a waveform
TROUBLESHOOTING

Troubleshoot your sensor

Fix calibration that never finishes, false or missed motion, and devices you can’t reach.

5 min read
Two Wi-Fi devices coordinating a sensing measurement around a person
FUTURE OF SENSING

The future of Wi-Fi sensing

What IEEE 802.11bf adds to Wi-Fi, what it leaves open, and where it would fit in ESPectre.

3 min read