espectre snapshot-dev
ESPectre — система обнаружения движения на основе анализа Wi-Fi спектра (CSI) с интеграцией с Home Assistant.
ESPectre 
Превратите 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 канал (информация о состоянии канала, или 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 с поддержкой датчиков присутствия; проверка контроллеров всё ещё ограничена | Matter frontend |
| Micro-ESPectre | Легковесное сенсорное восприятие на MicroPython с локальным, доступным только для чтения Direct HTTP мониторингом | Micro-ESPectre README |
Быстрый старт
Самый быстрый способ требует только браузер. Используйте настольный Chrome 151 или новее; Edge может прошивать, но Device settings и Monitor могут в нём не работать.
- Откройте Flash в настольном Chrome или Edge.
- Подключите поддерживаемый ESP32 через USB, затем выберите прошивку и канал релиза.
- Завершите провижининг Wi-Fi на экране или выполните комиссионирование Matter с поддерживаемым контроллером.
- При желании откройте Device settings, чтобы закрепить предпочитаемую точку доступа или настроить MQTT.
- Откройте Monitor, чтобы наблюдать за движением, настраивать обнаружение и проверять устройство.
Чтобы найти свои устройства в сети, используйте Find devices в браузерных инструментах или ./espectre devices. См. справочник по обнаружению для требований и ограничений.
Статус Matter: Поддержка Matter всё ещё тестируется с различными экосистемами контроллеров. Контроллер, поддерживающий датчики присутствия, возможно, ещё не тестировался с ESPectre. См. Совместимость контроллеров Matter для текущей матрицы.
Локальная настройка
Чтобы собрать и прошить из этого репозитория, начните с руководства по настройке. Чтобы увидеть все доступные команды, выполните:
./espectre --help