Torna agli aggiornamenti
New releaseAug 18, 2026

espectre snapshot-dev

ESPectre - Sistema di rilevamento del movimento basato sull'analisi dello spettro Wi-Fi (CSI), con integrazione con Home Assistant.

Condividi

Componente ESP-IDF Libreria Arduino Copertura C++ Copertura Python Copertura Web

ESPectre Logo di ESPectre

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

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++ 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.

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

PercorsoIdeale perInizia da qui
NativeSensori autonomi, integrazioni MQTT, inclusa Home Assistant MQTT Discovery, e applicazioni personalizzateFrontend Native
ESPHomeUtenti di Home Assistant che desiderano entità native, provisioning ESPHome e aggiornamenti tramite Device BuilderFrontend ESPHome
MatterController Matter con supporto per sensori di occupazione; testato con Google Home, Apple Home e Home AssistantFrontend Matter
Micro-ESPectreRilevamento leggero in MicroPython con monitoraggio Direct HTTP locale in sola letturaREADME di Micro-ESPectre

Avvio rapido

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.

  1. Apri Flash in Chrome o Edge per desktop.
  2. Collega un ESP32 supportato tramite USB, poi scegli un firmware e un canale di rilascio.
  3. Completa il provisioning Wi-Fi a schermo, oppure esegui la commissione Matter con un controller supportato.
  4. Facoltativamente, apri Device settings per fissare un punto di accesso preferito o configurare MQTT.
  5. Apri Monitor per osservare il movimento, ottimizzare il rilevamento e ispezionare il dispositivo.

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.

ESPectre Monitor

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.

Configurazione locale

Per compilare e flashare da questo repository, inizia con la guida alla configurazione. Per vedere tutti i comandi disponibili, esegui:

./espectre --help

Documentazione

Categorie