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 ГГц

Выберите путь прошивки

Быстрый старт

Самый быстрый способ требует только браузер. Используйте настольный Chrome 151 или новее; Edge может прошивать, но Device settings и Monitor могут в нём не работать.

1. Откройте Flash в настольном Chrome или Edge.
2. Подключите поддерживаемый ESP32 через USB, затем выберите прошивку и канал релиза.
3. Завершите провижининг Wi-Fi на экране или выполните комиссионирование Matter с поддерживаемым контроллером.
4. При желании откройте Device settings, чтобы закрепить предпочитаемую точку доступа или настроить MQTT.
5. Откройте Monitor, чтобы наблюдать за движением, настраивать обнаружение и проверять устройство.

Чтобы найти свои устройства в сети, используйте Find devices в браузерных инструментах или ./espectre devices. См. справочник по обнаружению для требований и ограничений.

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

Локальная настройка

Чтобы собрать и прошить из этого репозитория, начните с руководства по настройке. Чтобы увидеть все доступные команды, выполните:

./espectre --help

Документация

Наборы данных, модели и валидация

ESPectre публикует исследовательские материалы и доказательства валидации, лежащие в основе её детекторов:

Безопасность, приватность и прозрачность

Датчик, способный выявлять присутствие, не должен быть чёрным ящиком. Wi-Fi сенсорика не записывает изображения или звук, но данные о движении всё равно могут раскрывать распорядок дня, сон или отсутствие кого-либо дома. ESPectre рассматривает этот риск как часть дизайна:

• обнаружение движения выполняется локально, подключение к облаку не требуется;
• сбор сырых данных CSI является опциональным и предназначен для исследований и отладки;
• руководство по безопасности и ответственному использованию документирует границы развёртывания, согласие, минимизацию данных, сообщения о злоупотреблениях и приватное сообщение об уязвимостях;
• релизы прошивки включают SBOM для конкретных сборок, уведомления и архивы лицензий, чтобы их содержимое можно было проверить;
• веб-сайт и все браузерные инструменты находятся в этом репозитории в docs/web, вместе с их правилами приватности и политикой аналитики;
• протоколы, алгоритмы, результаты тестов, ограничения и планы — всё публично.

Используйте ESPectre только там, где у вас есть на это право. Сообщите затронутым людям, получите согласие там, где это требуется, защитите доступ к устройству и его данным и соблюдайте законы о приватности.

Благодарности

• Спасибо Espressif за предоставление доступа к CSI в ESP-IDF и за признание ESPectre проектом сообщества в esp-csi.
• Спасибо сопровождающим MicroPython за рецензирование, тестирование и слияние вклада ESPectre по CSI, который добавил прямые методы CSI в основной network.WLAN.

Лицензия

Код ESPectre, принадлежащий проекту, доступен под GPLv3, а подходящие части также под отдельной коммерческой лицензией:

• GPLv3 подходит, если вы можете публиковать исходный код вашей прошивки или приложения. См. LICENSE.
• Коммерческая лицензия, для прошивки с закрытым исходным кодом: см. условия лицензирования. Она охватывает только подходящий материал, не заменяет сторонние лицензии и не распространяется на фронтенд ESPHome, который остаётся только под GPLv3.

Сторонние условия и артефакты соответствия для конкретных сборок описаны в уведомлениях третьих сторон.