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

Статус Matter: сопряжение, обновления занятости и автоматизации протестированы с Google Home, Apple Home и Home Assistant. Amazon Alexa и Samsung SmartThings пока не тестировались. Google Home требует однократной настройки Developer Console. Актуальную матрицу см. в разделе Совместимость контроллеров Matter.
Локальная настройка
Чтобы собрать и прошить из этого репозитория, начните с руководства по настройке. Чтобы увидеть все доступные команды, выполните:
./espectre --help