espectre snapshot-dev
ESPectre - Bewegungserkennungssystem basierend auf Wi-Fi-Spektralanalyse (CSI), mit Home-Assistant-Integration.
ESPectre 
Verwandle einen ESP32 in einen privaten, lokalen Wi-Fi-Bewegungssensor.
Wenn sich jemand durch einen Raum bewegt, verändert er die Art und Weise, wie sich Wi-Fi-Signale darin ausbreiten. ESPectre liest diese Veränderungen und meldet Bewegung in Echtzeit. Keine Kamera, kein Mikrofon, kein Wearable und keine dedizierte Radar-Hardware: nur ein unterstützter ESP32 und das Wi-Fi-Netzwerk, das bereits im Raum vorhanden ist.
ESPectre ist eine Open-Source-Plattform, die flash-fertige Firmware, ein einbettbares C++-SDK, eine MicroPython-Implementierung, Browser-Tools, eine Host-CLI, einen offenen Datensatz, offene Modellgewichte und den Forschungs-Workflow vereint, mit dem die Detektoren entwickelt und validiert wurden.
Im Browser flashen · Die Live-Tools ansehen · Die Dokumentation lesen · Das SDK erkunden
Anwendungen und Integrationen
Nutze ESPectre, um Lichter oder ein Display einzuschalten, wenn jemand den Raum betritt, die Heizung anzupassen, wenn ein Raum genutzt wird, oder einen Alarm zu senden, wenn Bewegung dort auftritt, wo niemand sein sollte. Es funktioniert mit Home Assistant (über ESPHome oder MQTT), erscheint als standardmäßiger Matter-Anwesenheitssensor, bietet eine lokale HTTP-API und kann mit dem C++-SDK in deine eigene ESP32-Firmware integriert werden.
Alles läuft auf dem Gerät: Es misst den Wi-Fi-Kanal (Channel State Information, oder CSI) und meldet Bewegung sowie einen Bewegungs-Score. Nichts muss in die Cloud. Ein Board deckt einen Bereich ab, plane also ein Board pro Raum.
ESPectre erkennt Veränderungen in der Funkumgebung. Es identifiziert keine Personen, zählt sie nicht, beweist nicht, dass ein Raum leer ist, und ersetzt kein sicherheitszertifiziertes Sicherheits-, Medizin- oder Notfallsystem.
Unterstützte Hardware
- ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 und klassischer ESP32
- ein normales Wi-Fi 4 (802.11n)-Netzwerk auf 2,4 GHz
Wähle einen Firmware-Pfad
| Pfad | Am besten geeignet für | Hier starten |
|---|---|---|
| Native | Standalone-Sensoren, MQTT-Integrationen, einschließlich Home Assistant MQTT Discovery, und benutzerdefinierte Anwendungen | Native-Frontend |
| ESPHome | Home-Assistant-Nutzer, die native Entitäten, ESPHome-Provisionierung und Device-Builder-Updates wünschen | ESPHome-Frontend |
| Matter | Matter-Controller mit Unterstützung für Anwesenheitssensoren; die Controller-Validierung ist noch eingeschränkt | Matter-Frontend |
| Micro-ESPectre | Leichtgewichtige Sensorik in MicroPython mit lokalem, schreibgeschütztem Direct-HTTP-Monitoring | Micro-ESPectre README |
Schnellstart
Der schnellste Weg benötigt nur einen Browser. Verwende Desktop-Chrome 151 oder neuer; Edge kann flashen, aber Geräteeinstellungen und Monitor funktionieren darin möglicherweise nicht.
- Öffne Flash in Desktop-Chrome oder Edge.
- Verbinde einen unterstützten ESP32 über USB und wähle dann eine Firmware und einen Release-Kanal.
- Schließe die Wi-Fi-Provisionierung auf dem Bildschirm ab oder kommissioniere Matter mit einem unterstützten Controller.
- Optional: Öffne Geräteeinstellungen, um einen bevorzugten Access Point festzulegen oder MQTT einzurichten.
- Öffne Monitor, um Bewegung zu beobachten, die Erkennung abzustimmen und das Gerät zu inspizieren.
Um deine Geräte im Netzwerk zu finden, verwende Find devices in den Browser-Tools oder ./espectre devices. Siehe die Discovery-Referenz für Anforderungen und Einschränkungen.
Matter-Status: Die Matter-Unterstützung wird noch mit den verschiedenen Controller-Ökosystemen getestet. Ein Controller, der Anwesenheitssensoren unterstützt, wurde möglicherweise noch nicht mit ESPectre getestet. Siehe Matter-Controller-Kompatibilität für die aktuelle Matrix.
Lokale Einrichtung
Um aus diesem Repository zu bauen und zu flashen, beginne mit dem Einrichtungsleitfaden. Um alle verfügbaren Befehle zu sehen, führe aus:
./espectre --help