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 à 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, une 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 une lumière ou un écran quand quelqu'un entre, ajuster le chauffage lorsqu'une pièce est occupée, ou envoyer une alerte en cas de 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 de passer par le cloud. Une carte couvre une zone, prévoyez donc 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 prenant en charge les capteurs d'occupation ; la validation des contrôleurs reste limitée | Frontend Matter |
| Micro-ESPectre | Détection légère en MicroPython avec supervision HTTP Direct 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 n'a peut-être pas encore été testé avec ESPectre. Consultez la 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