espectre snapshot-dev
ESPectre - Sistema de detección de movimiento basado en el análisis del espectro Wi-Fi (CSI), con integración de Home Assistant.
ESPectre 
Convierte un ESP32 en un sensor de movimiento Wi-Fi privado y local.
Cuando alguien se mueve por una habitación, cambia la forma en que las señales Wi-Fi viajan a través de ella. ESPectre lee esos cambios y reporta movimiento en tiempo real. Sin cámara, sin micrófono, sin dispositivo wearable y sin hardware radar dedicado: solo un ESP32 compatible y la red Wi-Fi que ya está en la habitación.
ESPectre es una plataforma de código abierto que reúne firmware listo para flashear, un SDK de C++ embebible, una implementación en MicroPython, herramientas de navegador, una CLI de host, un conjunto de datos abierto, pesos de modelo abiertos y el flujo de trabajo de investigación utilizado para construir y validar los detectores.
Flashear desde tu navegador · Ver las herramientas en vivo · Leer la documentación · Explorar el SDK
Aplicaciones e integraciones
Usa ESPectre para encender luces o una pantalla cuando alguien entra, ajustar la calefacción cuando una habitación está en uso, o enviar una alerta cuando hay movimiento donde no debería haber nadie. Funciona con Home Assistant (a través de ESPHome o MQTT), aparece como un sensor de ocupación Matter estándar, ofrece una API HTTP local y puede integrarse en tu propio firmware ESP32 con el SDK de C++.
Todo se ejecuta en el dispositivo: mide el canal Wi-Fi (channel state information, o CSI) y reporta movimiento y una puntuación de movimiento. Nada necesita ir a la nube. Una placa cubre una zona, así que planifica una placa por habitación.
ESPectre detecta cambios en el entorno radioeléctrico. No identifica personas, no las cuenta, no demuestra que una habitación esté vacía ni sustituye a un sistema de seguridad, médico o de emergencia certificado.
Hardware compatible
- ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 y ESP32 clásico
- una red Wi-Fi 4 (802.11n) normal en 2,4 GHz
Elige una ruta de firmware
| Ruta | Ideal para | Empieza aquí |
|---|---|---|
| Native | Sensores autónomos, integraciones MQTT, incluido Home Assistant MQTT Discovery, y aplicaciones personalizadas | Frontend Native |
| ESPHome | Usuarios de Home Assistant que quieren entidades nativas, aprovisionamiento ESPHome y actualizaciones de Device Builder | Frontend ESPHome |
| Matter | Controladores Matter con soporte de sensor de ocupación; la validación de controladores aún es limitada | Frontend Matter |
| Micro-ESPectre | Detección ligera en MicroPython con monitoreo Direct HTTP local y de solo lectura | README de Micro-ESPectre |
Inicio rápido
La forma más rápida solo necesita un navegador. Usa Chrome 151 o posterior de escritorio; Edge puede flashear, pero Device settings y Monitor pueden no funcionar en él.
- Abre Flash en Chrome o Edge de escritorio.
- Conecta un ESP32 compatible por USB y luego elige un firmware y un canal de versión.
- Completa el aprovisionamiento Wi-Fi en pantalla, o comisiona Matter con un controlador compatible.
- Opcionalmente, abre Device settings para fijar un punto de acceso preferido o configurar MQTT.
- Abre Monitor para observar el movimiento, ajustar la detección e inspeccionar el dispositivo.
Para encontrar tus dispositivos en la red, usa Find devices en las herramientas de navegador o ./espectre devices. Consulta la referencia de descubrimiento para requisitos y límites.
Estado de Matter: El soporte de Matter aún se está probando con los diferentes ecosistemas de controladores. Es posible que un controlador que admita sensores de ocupación aún no se haya probado con ESPectre. Consulta Compatibilidad de controladores Matter para ver la matriz actual.
Configuración local
Para compilar y flashear desde este repositorio, empieza con la guía de configuración. Para ver todos los comandos disponibles, ejecuta:
./espectre --help