Назад к обновлениям
New releaseAug 18, 2026

espectre snapshot-dev

ESPectre — система обнаружения движения на основе анализа Wi-Fi спектра (CSI) с интеграцией с Home Assistant.

Поделиться

Компонент ESP-IDF Библиотека Arduino Покрытие C++ Покрытие Python Покрытие Web

ESPectre Логотип 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 BuilderESPHome frontend
MatterКонтроллеры Matter с поддержкой датчиков присутствия; протестировано с Google Home, Apple Home и Home AssistantMatter frontend
Micro-ESPectreЛегковесное сенсорное восприятие на MicroPython с локальным мониторингом Direct HTTP только для чтенияMicro-ESPectre README

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

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

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

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

ESPectre Monitor

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

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

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

./espectre --help

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

Категории