Intégrer un capteur radar KW007 dans Home Assistant avec ESPHome

Ajouter une détection de mouvement par radar à votre système Home Assistant est plus simple qu’il n’y paraît, avec seulement quelques composants et trois fils.

Le capteur Keywave KW007-SE exploite une technologie radar Doppler en 5.8GHz. Il surpasse les détecteurs infrarouges passifs classiques sur plusieurs points : il ne dépend pas de la chaleur corporelle, offre une couverture omnidirectionnelle et peut, dans un mode avancé, distinguer une approche d’un éloignement.

Ce guide se concentre sur sa configuration la plus simple. Un signal GPIO Haut/Bas signale la présence ou l’absence de mouvement vers une carte ESP. Cette méthode facilite la transition depuis un PIR traditionnel et permet une mise à jour ultérieure vers le mode I2C avec le même matériel.

Baguette C3, KW007-SE et 3 fils : la connexion minimale pour un détecteur radar

Le montage repose sur une connexion électrique extrêmement simple. Après avoir placé la carte Baguette C3 et le module KW007 sur une plaque d’essai, trois fils de liaison suffisent pour les relier.

Le brochage est le suivant : la broche 3V de la Baguette va au 3V3 du capteur, la masse G à GND, et la sortie de données GPO du KW007 à la broche GPIO4 de la carte. Aucune autre connexion n’est nécessaire pour ce mode basique.

ESPHome et GPIO4 : compiler un firmware sur-mesure en quelques clics

Une fois la carte connectée en USB à l’ordinateur, l’étape suivante se déroule dans ESPHome Device Builder. Après avoir créé un nouveau projet pour une ESP32-C3, il faut ajouter un bloc de configuration YAML spécifique.

Le code à insérer définit un capteur binaire lié à la broche utilisée, ici la GPIO4. Il suffit de le coller à la fin du fichier de configuration existant.

L’installation du firmware commence par l’étape de compilation, qui peut prendre plusieurs minutes. Ensuite, le logiciel guide l’utilisateur pour flasher la carte connectée en USB, en sélectionnant l’option USB JTAG correspondant à la Baguette C3.

Détection radar de 1 à 64 secondes : maîtriser le temps de maintien du signal

Par défaut, la sortie GPO reste à l’état Haut pendant 64 secondes après la dernière détection. Ce paramètre, nommé « hold time », peut être ajusté facilement en ajoutant une résistance entre les broches DELAY et GND du capteur.

Une valeur de 270kΩ réduit ce délai à environ une seconde, tandis qu’une résistance de 150kΩ le fixe à 32 secondes. Une connexion directe entre DELAY et GND donne un délai de 16 secondes. Cette flexibilité permet d’adapter le capteur à divers scénarios d’automatisation.

De retour dans Home Assistant, le nouveau périphérique apparaît dans la section Appareils et services. Après son ajout, l’entité « Motion » reflète l’état du capteur et peut être utilisée pour déclencher des automatisations, comme l’éclairage.

Pour les utilisateurs souhaitant explorer davantage, le capteur KW007-SE propose un mode de communication I2C donnant accès à des données plus riches, comme le sens du mouvement. Cette première approche en trois fils sert de point d’entrée idéal avant de s’aventurer vers ces fonctionnalités avancées.