Retour aux mises à jour
New releaseAug 18, 2026

espectre snapshot-dev

ESPectre - Système de détection de mouvement basé sur l'analyse du spectre Wi-Fi (CSI), avec intégration Home Assistant.

Partager

ESP-IDF component Arduino library C++ coverage Python coverage Web coverage

ESPectre ESPectre logo

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 réunit un firmware prêt à flasher, un SDK C++ intégrable, une bibliothèque Arduino, une implémentation MicroPython, des outils pour 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

Applications et intégrations

Utilisez ESPectre pour allumer une lumière 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, propose une API HTTP locale et peut être intégré à votre propre firmware ESP32 avec le SDK C++ ou un sketch Arduino-ESP32.

Tout s'exécute sur l'appareil : il mesure le canal Wi-Fi (channel state information, ou CSI) et signale le mouvement ainsi qu'un score de mouvement. Rien n'a besoin de transiter 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é.

Matériel compatible

  • ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 et ESP32 classique
  • un réseau Wi-Fi 4 (802.11n) normal sur 2,4 GHz

Choisir une voie de firmware

VoieIdéale pourCommencer ici
NativeCapteurs autonomes, intégrations MQTT, y compris Home Assistant MQTT Discovery, et applications personnaliséesFrontend natif
ESPHomeUtilisateurs de Home Assistant souhaitant des entités natives, le provisionnement ESPHome et les mises à jour via Device BuilderFrontend ESPHome
MatterContrôleurs Matter prenant en charge les capteurs d'occupation ; testé avec Google Home, Apple Home et Home AssistantFrontend Matter
Micro-ESPectreDétection légère en MicroPython avec surveillance Direct HTTP locale en lecture seuleREADME Micro-ESPectre

Démarrage rapide

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.

  1. Ouvrez Flash dans Chrome ou Edge sur ordinateur.
  2. Connectez un ESP32 pris en charge via USB, puis choisissez un firmware et un canal de version.
  3. Effectuez le provisionnement Wi-Fi à l'écran, ou commissionnez Matter avec un contrôleur pris en charge.
  4. Facultativement, ouvrez Device settings pour épingler un point d'accès préféré ou configurer MQTT.
  5. Ouvrez Monitor pour observer le mouvement, ajuster la détection et inspecter l'appareil.

Pour trouver vos appareils sur le réseau, utilisez Find devices dans les outils du navigateur ou ./espectre devices. Consultez la référence de découverte pour les prérequis et les limites.

ESPectre Monitor

État de Matter : l'appairage, les mises à jour d'occupation et les automatisations sont testés avec Google Home, Apple Home et Home Assistant. Amazon Alexa et Samsung SmartThings ne sont pas encore testés. Google Home nécessite une configuration unique dans la Developer Console. Consultez la compatibilité des contrôleurs Matter pour la matrice actuelle.

Configuration locale

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

Documentation

Catégories