
ESPectre - Sistema di rilevamento del movimento basato sull'analisi dello spettro Wi-Fi (CSI), con integrazione con Home Assistant.
Trasforma un ESP32 in un sensore di movimento Wi-Fi privato e locale.
Quando qualcuno si muove in una stanza, modifica il modo in cui i segnali Wi-Fi la attraversano. ESPectre legge queste variazioni e segnala il movimento in tempo reale. Nessuna telecamera, nessun microfono, nessun dispositivo indossabile e nessun hardware radar dedicato: solo un ESP32 supportato e la rete Wi-Fi già presente nella stanza.
ESPectre è una piattaforma open source che riunisce firmware pronto da flashare, un SDK C++ integrabile, una libreria Arduino, un'implementazione MicroPython, strumenti per il browser, una CLI host, un dataset aperto, pesi dei modelli aperti e il flusso di lavoro di ricerca utilizzato per costruire e validare i rilevatori.
Flash dal tuo browser · Scopri gli strumenti live · Leggi la documentazione · Esplora l'SDK
Usa ESPectre per accendere luci o un display quando qualcuno entra, regolare il riscaldamento quando una stanza è occupata o inviare un avviso quando c'è movimento dove non dovrebbe esserci nessuno. Funziona con Home Assistant (tramite ESPHome o MQTT), appare come un sensore di occupazione Matter standard, offre un'API HTTP locale e può essere integrato nel tuo firmware ESP32 con l'SDK C++ o uno sketch Arduino-ESP32.
Tutto viene eseguito sul dispositivo: misura il canale Wi-Fi (channel state information, o CSI) e segnala il movimento e un punteggio di movimento. Nulla deve essere inviato al cloud. Una scheda copre un'area, quindi prevedi una scheda per stanza.
ESPectre rileva i cambiamenti nell'ambiente radio. Non identifica le persone, non le conta, non dimostra che una stanza è vuota e non sostituisce un sistema di sicurezza, medico o di emergenza certificato per la sicurezza.
| Percorso | Ideale per | Inizia da qui |
|---|---|---|
| Native | Sensori autonomi, integrazioni MQTT, inclusa Home Assistant MQTT Discovery, e applicazioni personalizzate | Frontend Native |
| ESPHome | Utenti di Home Assistant che desiderano entità native, provisioning ESPHome e aggiornamenti tramite Device Builder | Frontend ESPHome |
| Matter | Controller Matter con supporto per sensori di occupazione; testato con Google Home, Apple Home e Home Assistant | Frontend Matter |
| Micro-ESPectre | Rilevamento leggero in MicroPython con monitoraggio Direct HTTP locale in sola lettura | README di Micro-ESPectre |
Il modo più rapido richiede solo un browser. Usa Chrome 151 o successivo per desktop; Edge può eseguire il flash, ma le impostazioni del dispositivo e Monitor potrebbero non funzionare.
Per trovare i tuoi dispositivi sulla rete, usa Find devices negli strumenti del browser oppure ./espectre devices. Consulta il riferimento alla scoperta per requisiti e limiti.

Stato Matter: associazione, aggiornamenti di occupazione e automazioni sono testati con Google Home, Apple Home e Home Assistant. Amazon Alexa e Samsung SmartThings non sono ancora testati. Google Home richiede una configurazione una tantum della Developer Console. Consulta la compatibilità dei controller Matter per la matrice attuale.
Per compilare e flashare da questo repository, inizia con la guida alla configurazione. Per vedere tutti i comandi disponibili, esegui:
./espectre --help