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

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.

1. Apri Flash in Chrome o Edge desktop.
2. Collega un ESP32 supportato via USB, poi scegli un firmware e un canale di rilascio.
3. Completa il provisioning Wi-Fi sullo schermo, oppure esegui il commissioning Matter con un controller supportato.
4. Facoltativamente, apri Device settings per fissare un access point preferito o configurare MQTT.
5. 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

Documentazione

Dataset, modelli e validazione

ESPectre pubblica le risorse di ricerca e le prove di validazione alla base dei suoi rilevatori:

Sicurezza, privacy e trasparenza

Un sensore che può rivelare la presenza non dovrebbe essere una scatola nera. Il rilevamento Wi-Fi non registra immagini né audio, ma i dati di movimento possono comunque rivelare routine, sonno o quando non c'è nessuno in casa. ESPectre considera questo rischio parte del design:

• il rilevamento del movimento è locale e la connettività cloud non è richiesta;
• la raccolta CSI grezza è opzionale ed è pensata per ricerca e debug;
• la guida alla sicurezza e all'uso responsabile documenta i confini di distribuzione, il consenso, la minimizzazione dei dati, la segnalazione di abusi e la segnalazione privata di vulnerabilità;
• le release del firmware includono SBOM specifici per build, avvisi e archivi di licenze, così che i loro contenuti possano essere ispezionati;
• il sito web e tutti gli strumenti del browser sono in questo repository sotto docs/web, con le loro regole sulla privacy e la politica di analytics;
• protocolli, algoritmi, risultati dei test, limitazioni e piani sono tutti pubblici.

Usa ESPectre solo dove ne hai il diritto. Informa le persone coinvolte, ottieni il consenso dove richiesto, proteggi l'accesso al dispositivo e ai suoi dati e rispetta le leggi sulla privacy.

Ringraziamenti

• Grazie a Espressif per aver reso accessibile il CSI in ESP-IDF e per aver riconosciuto ESPectre come progetto della community in esp-csi.
• Grazie ai maintainer di MicroPython per aver revisionato, testato e unito il contributo CSI di ESPectre, che ha aggiunto metodi CSI diretti al network.WLAN mainline.

Licenza

Il codice di prima parte di ESPectre è disponibile sotto GPLv3, e le parti idonee anche sotto una licenza commerciale separata:

• GPLv3 è adatta se puoi pubblicare il sorgente del tuo firmware o della tua applicazione. Vedi LICENSE.
• Licenza commerciale, per firmware closed-source: vedi i termini di licenza. Copre solo materiale idoneo, non sostituisce le licenze di terze parti e non copre il frontend ESPHome, che rimane solo GPLv3.

I termini di terze parti e gli artefatti di conformità specifici per build sono descritti nelle note di terze parti.