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.

1. Öffne Flash in Desktop-Chrome oder Edge.
2. Verbinde einen unterstützten ESP32 über USB und wähle dann eine Firmware und einen Release-Kanal.
3. Schließe die Wi-Fi-Provisionierung auf dem Bildschirm ab oder kommissioniere Matter mit einem unterstützten Controller.
4. Optional: Öffne Geräteeinstellungen, um einen bevorzugten Access Point festzulegen oder MQTT einzurichten.
5. Ö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

Dokumentation