espectre snapshot-dev
ESPectre - Sistema di rilevamento del movimento basato sull'analisi dello spettro Wi-Fi (CSI), con integrazione con Home Assistant.
ESPectre 
Trasforma un ESP32 in un sensore di movimento Wi-Fi privato e locale.
Quando qualcuno si muove in una stanza, cambia il modo in cui i segnali Wi-Fi viaggiano al suo interno. ESPectre legge questi cambiamenti 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, un'implementazione MicroPython, strumenti per il browser, una CLI host, un dataset aperto, pesi dei modelli aperti e il flusso di ricerca utilizzato per costruire e validare i rilevatori.
Flash dal tuo browser · Vedi gli strumenti live · Leggi la documentazione · Esplora l'SDK
Applicazioni e integrazioni
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++.
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 andare nel 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.
Hardware supportato
- ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 e ESP32 classico
- una normale rete Wi-Fi 4 (802.11n) a 2,4 GHz
Scegli un percorso firmware
| Percorso | Ideale per | Inizia da qui |
|---|---|---|
| Native | Sensori standalone, integrazioni MQTT, inclusa Home Assistant MQTT Discovery, e applicazioni personalizzate | Frontend Native |
| ESPHome | Utenti Home Assistant che desiderano entità native, provisioning ESPHome e aggiornamenti Device Builder | Frontend ESPHome |
| Matter | Controller Matter con supporto ai sensori di occupazione; la validazione dei controller è ancora limitata | Frontend Matter |
| Micro-ESPectre | Rilevamento leggero in MicroPython con monitoraggio Direct HTTP locale e in sola lettura | README di Micro-ESPectre |
Avvio rapido
Il modo più rapido richiede solo un browser. Usa Chrome desktop 151 o successivo; Edge può eseguire il flash, ma Device settings e Monitor potrebbero non funzionare.
- Apri Flash in Chrome o Edge desktop.
- Collega un ESP32 supportato via USB, poi scegli un firmware e un canale di rilascio.
- Completa il provisioning Wi-Fi sullo schermo, oppure esegui il commissioning Matter con un controller supportato.
- Facoltativamente, apri Device settings per fissare un access point preferito o configurare MQTT.
- Apri Monitor per osservare il movimento, regolare il rilevamento e ispezionare il dispositivo.
Per trovare i tuoi dispositivi sulla rete, usa Find devices negli strumenti del browser o ./espectre devices. Consulta il riferimento discovery per requisiti e limiti.
Stato Matter: il supporto Matter è ancora in fase di test con i diversi ecosistemi di controller. Un controller che supporta i sensori di occupazione potrebbe non essere ancora stato testato con ESPectre. Consulta la compatibilità dei controller Matter per la matrice attuale.
Configurazione locale
Per compilare ed eseguire il flash da questo repository, inizia con la guida di configurazione. Per vedere tutti i comandi disponibili, esegui:
./espectre --help