
ESPectre — система обнаружения движения на основе анализа Wi-Fi спектра (CSI) с интеграцией с Home Assistant.
Превратите ESP32 в приватный локальный датчик движения на основе Wi-Fi.
Когда кто-то движется по комнате, он изменяет распространение Wi-Fi-сигналов в ней. ESPectre считывает эти изменения и сообщает о движении в реальном времени. Без камеры, без микрофона, без носимых устройств и без специального радарного оборудования: достаточно поддерживаемого ESP32 и Wi-Fi-сети, уже имеющейся в комнате.
ESPectre — это платформа с открытым исходным кодом, объединяющая готовую к прошивке прошивку, встраиваемый C++ SDK, реализацию на MicroPython, браузерные инструменты, хост-CLI, открытый набор данных, открытые веса моделей и исследовательский процесс, использованный для создания и проверки детекторов.
Прошить из браузера · Посмотреть живые инструменты · Читать документацию · Изучить SDK
Используйте ESPectre, чтобы включать свет или дисплей, когда кто-то входит, регулировать отопление, когда комната используется, или отправлять оповещение при движении там, где никого не должно быть. Он работает с Home Assistant (через ESPHome или MQTT), отображается как стандартный датчик присутствия Matter, предоставляет локальный HTTP API и может быть встроен в вашу собственную прошивку ESP32 с помощью C++ SDK.
Всё работает на устройстве: оно измеряет Wi-Fi-канал (channel state information, или CSI) и сообщает о движении и оценке перемещения. Ничего не нужно отправлять в облако. Одна плата покрывает одну зону, поэтому планируйте по одной плате на комнату.
ESPectre обнаруживает изменения в радиосреде. Он не идентифицирует людей, не считает их, не доказывает, что комната пуста, и не заменяет сертифицированную систему безопасности, медицинскую или аварийную систему.
| Путь | Для чего лучше всего | С чего начать |
|---|---|---|
| Native | Автономные датчики, интеграции MQTT, включая Home Assistant MQTT Discovery, и пользовательские приложения | Native frontend |
| ESPHome | Пользователи Home Assistant, которым нужны нативные сущности, провижининг ESPHome и обновления Device Builder | ESPHome frontend |
| Matter | Контроллеры Matter с поддержкой датчиков присутствия; проверка контроллеров всё ещё ограничена | Matter frontend |
| Micro-ESPectre | Лёгкое сенсорное восприятие на MicroPython с локальным мониторингом Direct HTTP только для чтения | Micro-ESPectre README |
Самый быстрый способ требует только браузера. Используйте настольный Chrome 151 или новее; Edge может прошивать, но Device settings и Monitor могут в нём не работать.
Чтобы найти свои устройства в сети, используйте Find devices в браузерных инструментах или ./espectre devices. См. справочник по обнаружению для требований и ограничений.

Статус Matter: Поддержка Matter всё ещё тестируется с различными экосистемами контроллеров. Контроллер, поддерживающий датчики присутствия, возможно, ещё не тестировался с ESPectre. См. Совместимость контроллеров Matter для текущей матрицы.
Чтобы собрать и прошить из этого репозитория, начните с руководства по настройке. Чтобы увидеть все доступные команды, выполните:
./espectre --help