Repolode
francescopace

francescopace/espectre

Превращает ESP32 в локальный Wi-Fi-датчик движения, который обнаруживает движение по изменениям Wi-Fi-сигналов — без камеры и микрофона.

Звёзды
9,665
Форки
733
Открытые issues
14
Последний коммит
позавчера

Что это?

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

В проекте доступны несколько вариантов прошивки: Native frontend с MQTT и Home Assistant MQTT Discovery, ESPHome frontend, frontend датчика присутствия Matter и реализация на MicroPython под названием Micro-ESPectre. Кроме того, проект включает встраиваемый C++ SDK, локальный HTTP API, инструменты для прошивки и мониторинга через браузер, а также host CLI для управления устройствами.

В репозитории опубликованы набор данных CSI, веса обученной модели, журнал проверенных и отклонённых экспериментов с признаками и отчёты о производительности. ESPectre обнаруживает только изменения радиообстановки: он не идентифицирует людей и не подсчитывает их. Код распространяется по лицензии GPLv3; для некоторых частей доступна коммерческая лицензия.

Ключевые возможности

  • 01Обнаруживает движение по Wi-Fi CSI на платах ESP32-C6, C5, C3, S3, S2 и классических ESP32.
  • 02Полностью работает на устройстве, не требуя подключения к облаку.
  • 03Интегрируется с Home Assistant через ESPHome или MQTT и определяется как датчик присутствия Matter.
  • 04Предоставляет локальный HTTP API и встраиваемый C++ SDK для создания собственной прошивки.
  • 05Включает инструменты для прошивки через браузер, настройки устройства и мониторинга в реальном времени.

Сценарии использования

  • Включать свет или дисплей, когда кто-то входит в комнату.
  • Регулировать отопление в зависимости от того, используется ли помещение.
  • Отправлять уведомление, если движение обнаружено в зоне, которая должна быть пустой.
  • Добавлять обнаружение присутствия в систему Home Assistant без камер.

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

  1. 1

    Откройте инструмент Flash в настольном Chrome или Edge

  2. 2

    Подключите совместимую плату ESP32 через USB, выберите прошивку и завершите настройку Wi-Fi

  3. 3

    Откройте Monitor, чтобы следить за движением и настроить обнаружение

Что важно знать

  • Требуется совместимая плата ESP32 и сеть Wi-Fi 4 с частотой 2,4 ГГц; предусмотрите по одной плате на комнату.
  • Совместимость с контроллерами Matter пока ограничена и проверена не полностью.
  • Действует копилефт GPLv3, поэтому для прошивки с закрытым исходным кодом нужна отдельная коммерческая лицензия.

Темы

Частые вопросы

Что такое espectre?
Превращает ESP32 в локальный Wi-Fi-датчик движения, который обнаруживает движение по изменениям Wi-Fi-сигналов — без камеры и микрофона. ESPectre работает на поддерживаемых платах ESP32 и считывает информацию о состоянии канала (CSI) из уже присутствующих в помещении Wi-Fi-сигналов. Когда кто-то движется, пути распространения сигнала меняются, и устройство в реальном времени сообщает о движении и его интенсивности. Обработка выполняется на самом устройстве, поэтому облачный сервис не нужен; также не требуются камера, микрофон, носимые устройства или радарное оборудование.
espectre можно использовать бесплатно? Какая у него лицензия?
espectre распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
espectre всё ещё поддерживается?
Активно поддерживается. Последний коммит в espectre — 19 окт. 2026 г..
Для чего можно использовать espectre?
Включать свет или дисплей, когда кто-то входит в комнату. Регулировать отопление в зависимости от того, используется ли помещение. Отправлять уведомление, если движение обнаружено в зоне, которая должна быть пустой. Добавлять обнаружение присутствия в систему Home Assistant без камер.
Как установить espectre?
Откройте инструмент Flash в настольном Chrome или Edge Подключите совместимую плату ESP32 через USB, выберите прошивку и завершите настройку Wi-Fi Откройте Monitor, чтобы следить за движением и настроить обнаружение
Где скачать espectre?
Исходный код и инструкции по установке — на GitHub: https://github.com/francescopace/espectre

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Sesame — миниатюрный робот-квадрупед с открытым исходным кодом, который можно напечатать на 3D-принтере; он работает на ESP32, оснащён OLED-лицом и ходит с помощью сервоприводов.

4,8 тыс.644CApache-2.0Обновлён 6 дней назад