francescopace/espectreESPectre - Système de détection de mouvement basé sur l'analyse du spectre Wi-Fi (CSI), avec intégration Home Assistant.
Transformez un ESP32 en un capteur de mouvement Wi-Fi privé et local.
Lorsqu'une personne se déplace dans une pièce, elle modifie la façon dont les signaux Wi-Fi s'y propagent. ESPectre lit ces changements et signale le mouvement en temps réel. Pas de caméra, pas de microphone, pas d'objet connecté à porter, et aucun matériel radar dédié : juste un ESP32 compatible et le réseau Wi-Fi déjà présent dans la pièce.
ESPectre est une plateforme open source qui rassemble un firmware prêt à flasher, un SDK C++ intégrable, une implémentation MicroPython, des outils navigateur, un CLI hôte, un jeu de données ouvert, des poids de modèles ouverts, et le workflow de recherche utilisé pour construire et valider les détecteurs.
Flasher depuis votre navigateur · Voir les outils en direct · Lire la documentation · Explorer le SDK
Utilisez ESPectre pour allumer des lumières ou un écran lorsqu'une personne entre, ajuster le chauffage lorsqu'une pièce est occupée, ou envoyer une alerte lorsqu'il y a du mouvement là où personne ne devrait se trouver. Il fonctionne avec Home Assistant (via ESPHome ou MQTT), apparaît comme un capteur d'occupation Matter standard, offre une API HTTP locale, et peut être intégré à votre propre firmware ESP32 avec le SDK C++.
Tout s'exécute sur l'appareil : il mesure le canal Wi-Fi (channel state information, ou CSI) et rapporte le mouvement ainsi qu'un score de mouvement. Rien n'a besoin d'aller dans le cloud. Une carte couvre une zone, donc prévoyez une carte par pièce.
ESPectre détecte les changements dans l'environnement radio. Il n'identifie pas les personnes, ne les compte pas, ne prouve pas qu'une pièce est vide, et ne remplace pas un système de sécurité, médical ou d'urgence certifié.
| Voie | Idéal pour | Commencez ici |
|---|---|---|
| Native | Capteurs autonomes, intégrations MQTT, y compris Home Assistant MQTT Discovery, et applications personnalisées | Frontend natif |
| ESPHome | Utilisateurs de Home Assistant qui veulent des entités natives, le provisionnement ESPHome, et les mises à jour Device Builder | Frontend ESPHome |
| Matter | Contrôleurs Matter avec prise en charge des capteurs d'occupation ; la validation des contrôleurs reste limitée | Frontend Matter |
| Micro-ESPectre | Détection légère en MicroPython avec surveillance Direct HTTP locale en lecture seule | README Micro-ESPectre |
La méthode la plus rapide ne nécessite qu'un navigateur. Utilisez Chrome 151 ou une version ultérieure sur ordinateur ; Edge peut flasher, mais Device settings et Monitor peuvent ne pas y fonctionner.
Pour trouver vos appareils sur le réseau, utilisez Find devices dans les outils navigateur ou ./espectre devices. Consultez la référence de découverte pour les prérequis et les limites.
Statut Matter : La prise en charge de Matter est encore en cours de test avec les différents écosystèmes de contrôleurs. Un contrôleur qui prend en charge les capteurs d'occupation peut ne pas encore avoir été testé avec ESPectre. Consultez Compatibilité des contrôleurs Matter pour la matrice actuelle.
Pour compiler et flasher depuis ce dépôt, commencez par le guide d'installation. Pour voir toutes les commandes disponibles, exécutez :
./espectre --help