ESPectre

Превратите ESP32 в частный локальный Wi-Fi датчик движения.

Когда кто-то движется по комнате, это меняет пути распространения Wi-Fi сигналов. ESPectre считывает эти изменения и сообщает о движении в реальном времени. Без камеры, без микрофона, без носимых устройств и без специализированного радарного оборудования: достаточно поддерживаемого ESP32 и уже имеющейся в комнате Wi-Fi сети.

ESPectre — это платформа с открытым исходным кодом, объединяющая готовую к прошивке прошивку, встраиваемый C++ SDK, реализацию на MicroPython, браузерные инструменты, CLI для хоста, открытый набор данных, открытые веса моделей и исследовательский процесс, использованный для создания и валидации детекторов.

Прошить из браузера · Посмотреть живые инструменты · Читать документацию · Изучить SDK

Применения и интеграции

ESPectre может включать дисплей или освещение при обнаружении движения, регулировать отопление и охлаждение в зависимости от активности в помещении, запускать сигнализацию или уведомление при движении в зоне, которая должна быть пустой, а также управлять другими автоматизациями в помещении. Он подключается к Home Assistant через ESPHome или MQTT, предоставляет стандартный датчик присутствия Matter и локальный Direct HTTP API, а также может быть встроен в пользовательскую прошивку ESP32 через C++ SDK.

ESPectre обрабатывает CSI на устройстве и сообщает состояние движения и оценку движения. Приложения могут реагировать без отправки необработанных данных зондирования в облачный сервис. Одна плата покрывает одну зону зондирования; покрытие на уровне комнаты обычно требует одну плату на комнату.

ESPectre обнаруживает изменения в радиоокружении. Он не идентифицирует людей, не подсчитывает их, не доказывает, что комната пуста, и не заменяет сертифицированную по безопасности охранную, медицинскую или аварийную систему.

Поддерживаемое оборудование

• ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 и классический ESP32
• обычная сеть Wi-Fi 4 (802.11n) на 2,4 ГГц

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

Native, ESPHome и Matter могут выбирать между детектором lightweight, который изучает специфичный для комнаты порог при запуске и оставляет больше ресурсов остальной части приложения, и детектором high_accuracy, который запускает обученную модель, включённую в репозиторий. Их поведение и измеренные компромиссы задокументированы в SETUP.md, ALGORITHMS.md и отчёте о производительности.

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

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

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

Статус Matter: Фронтенд Matter всё ещё проходит валидацию в экосистемах контроллеров. Контроллер может поддерживать стандартные датчики присутствия Matter, не будучи протестированным с текущей прошивкой. См. Matter controller compatibility для текущей матрицы.

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

Для локальных сборок, прошивки из этого репозитория и остальной части пути оператора начните с SETUP.md. Обёртка репозитория предоставляет доступ к доступным рабочим процессам через:

./espectre --help

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

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

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

Безопасность, конфиденциальность и прозрачность

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

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

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

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

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

Лицензия

Собственный код ESPectre доступен под GPLv3, а подходящие части также доступны по отдельному коммерческому соглашению:

• Выбирайте GPLv3, если ваша прошивка или приложение может соответствовать GPLv3, включая предоставление соответствующего исходного кода. См. LICENSE.
• Если вы хотите встроить ESPectre в проприетарную или закрытую прошивку без обязательств по раскрытию исходного кода GPLv3, см. LICENSING.md для коммерческого лицензирования. Коммерческая лицензия покрывает подходящий материал и не заменяет условия третьих сторон; C++ фронтенд ESPHome остаётся только под GPLv3.

Условия третьих сторон и артефакты соответствия, специфичные для сборки, описаны в THIRD_PARTY_NOTICES.md.