Comment configurer Home Assistant pour recevoir une alerte en cas de consommation d'eau anormale
La gestion domotique moderne s'étend au-delà de l'électricité. La plateforme logicielle Home Assistant permet désormais de suivre sa consommation d'eau directement dans son tableau de bord Énergie, au même titre que l'électricité ou le gaz, selon la documentation officielle de Home Assistant. Ce suivi granulaire peut aider à identifier les gaspillages invisibles et à déclencher une alerte.
L'essentiel en bref
- Identifier l'interface physique du compteur pour choisir la technologie de captation.
- Transmettre les données de lecture via le réseau local avec le protocole MQTT.
- Normaliser la valeur et l'unité avec un template YAML (`state_class: total_increasing`).
- Configurer une alerte automatique (`device_class: problem` ou avec l'extension Water-Monitor).
Quel capteur choisir selon mon type de compteur d'eau ?
La première étape pour numériser un relevé d'eau consiste à identifier l'interface physique offerte par le compteur existant. L'architecture interne du cadran dicte directement la technologie de captation requise pour transmettre les données au serveur domotique. À noter : ce tableau s'adresse aux compteurs mécaniques dotés d'un cadran visible ou d'un disque. Si vous possédez déjà un compteur télérelevé, rendez-vous directement dans la FAQ.
La sélection matérielle
Ce tableau de décision structure le choix du capteur en fonction des caractéristiques visuelles et mécaniques du compteur installé.
| type de compteur physique | technologie de lecture | contraintes et avantages technologiques |
|---|---|---|
| Analogique ancien (flèche ou totalisateur simple) | Caméra ESP32 (AI-on-the-edge-device) | Traitement d'image local ; configuration fastidieuse orientée DIY (Do It Yourself) |
| Analogique récent (disque rotatif) | Capteur de proximité | Détection magnétique au passage du disque ; installation simple mais précision standard |
| Analogique récent (disque rotatif) | Capteur de lumière | Analyse optique du signal réfléchi ; haute précision pour la détection précoce |
Les limites des compteurs anciens
Les compteurs d'eau les plus anciens, qui n'affichent qu'une simple flèche rotative ou un cadran de totalisation basique, nécessitent souvent une approche complexe. La solution recommandée repose sur un montage de type « AI-on-the-edge-device ». Il s'agit d'une caméra pilotée par un microcontrôleur ESP32 qui numérise le cadran grâce à un algorithme de reconnaissance d'image. Bien que cette méthode soit techniquement efficace, elle s'avère particulièrement fastidieuse à configurer, l'orientant vers un public adepte de montages personnalisés (DIY).
L'avantage des compteurs à disque rotatif
Pour les compteurs d'eau légèrement plus modernes équipés d'un disque rotatif, la captation est facilitée. Ces modèles se lisent selon deux méthodes distinctes : par capteur de proximité ou par capteur de lumière. Pour la lecture de proximité magnétique, l'utilisation d'un lecteur à magnétomètre bon marché (QMC5883L ou HMC5883L) est une approche courante.
L'approche optique se démarque particulièrement. La lecture par capteur de lumière repose sur l'analyse du signal lumineux réfléchi au passage d'un marqueur ou du disque. Cette méthode atteint une précision de 100 millilitres. Ce niveau de détail, qui supplante largement le pas de mesure traditionnel d'un litre, s'avère utile pour identifier rapidement l'apparition d'une micro-fuite.
Comment relier un compteur analogique à Home Assistant via MQTT ?
Face à la nécessité de raccorder un compteur analogique classique, le recours à un pont matériel s'impose. Une passerelle spécifique est proposée par SmartGateways.nl.
La captation par impulsions
Cette passerelle matérielle mesure le débit d'eau à l'aide d'un commutateur à lames souples (reed switch). Ce composant électronique réagit au champ magnétique généré par la rotation d'un aimant intégré dans le mécanisme interne du compteur d'eau. À chaque rotation complète ou partielle correspondant à un volume d'eau défini, le reed switch ferme le circuit, générant une impulsion électrique. Ce comptage d'impulsions est ensuite converti en données de volume par la passerelle.
Transmission locale et asynchrone
Une fois le débit traduit en données numériques, la passerelle publie ces informations sans fil sur le réseau local. Elle offre deux protocoles de communication : un bus MQTT ou une interface de programmation API REST. Bien que la passerelle fonctionne techniquement dans Home Assistant, son utilisation nécessite des étapes de configuration manuelles supplémentaires. En effet, l'absence d'une intégration automatique clef en main impose à l'utilisateur de déclarer lui-même les entités sur le serveur MQTT pour que le système domotique puisse commencer à ingérer l'historique de consommation. À noter également : la configuration du broker MQTT doit autoriser l'authentification par compte (l'accès anonyme doit être désactivé), conformément aux exigences de l'implémentation.
Pourquoi le template YAML est-il indispensable au tableau de bord Énergie ?
L'intégration manuelle d'une passerelle de lecture via MQTT ou une API REST ne se limite pas à réceptionner une valeur brute. Le tableau de bord Énergie de Home Assistant impose un formatage très strict pour valider et afficher les données de consommation d'eau.
Les attributs obligatoires d'une entité
La création manuelle d'un capteur requiert impérativement la définition de trois variables d'architecture logicielle : `device_class`, `state_class` et `unit_of_measurement`. L'absence d'un seul de ces paramètres empêche le module Énergie de reconnaître la source de données comme un compteur valide.
L'ingénierie de la conversion mathématique
La traduction du langage brut de la passerelle vers le standard attendu par le système exige l'écriture d'un modèle d'évaluation (template) en code YAML.
La configuration de la passerelle expose une entité spécifique reflétant le volume mesuré. Pour que cette entité soit exploitée correctement, elle doit impérativement comporter l'attribut `state_class: total_increasing`, signalant au moteur de base de données que la valeur ne fait que s'accumuler au fil du temps (comme un odomètre).
Ensuite, le code YAML applique un `value_template` mathématique pour normaliser l'unité. Si la valeur brute publiée par la passerelle est en litres, elle doit être convertie en mètres cubes, car c'est l'unité de référence du module Énergie. Le template multiplie alors la valeur reçue par 0,001. Enfin, pour éviter une surcharge de la base de données liée à des nombres flottants infinis, le modèle intègre une fonction d'arrondi stricte fixée à 3 décimales (ce qui correspond précisément à un litre sur l'échelle du mètre cube). C'est cette chaîne de traitement qui qualifie la donnée pour son utilisation finale dans les graphiques domotiques.
Comment transformer une mesure de débit en alerte de fuite ?
La visualisation des volumes d'eau consommés constitue une première victoire, mais l'objectif central du retrofit est de générer des alarmes réactives. L'écosystème Home Assistant propose deux approches distinctes pour caractériser une anomalie : l'alerte matérielle directe et l'analyse logicielle heuristique.
Le déclenchement matériel direct
La méthode la plus immédiate repose sur les capacités internes de la passerelle de lecture. La configuration manuelle de la passerelle crée notamment une entité baptisée « Leak detected ». Cette entité binaire est physiquement branchée sur le canal MQTT `watermeter/reading/leak_detect`.
Pour que l'interface visuelle de Home Assistant traite cette information comme une véritable urgence (souvent matérialisée par une icône rouge spécifique), l'entité est configurée avec l'attribut `device_class: problem`. Cette catégorisation architecturale fournit une brique logicielle directement exploitable pour déclencher une alerte de fuite sur le smartphone de l'utilisateur ou pour fermer automatiquement une électrovanne principale, sans nécessiter d'algorithme supplémentaire.
L'analyse logicielle des sessions de débit
Si le matériel ne gère pas nativement la détection de problèmes continus, une alternative purement logicielle existe. L'intégration communautaire baptisée Water-Monitor, hébergée sur la plateforme GitHub par le développeur Markaggar (en développement continu), adopte une stratégie d'analyse comportementale.
Cette extension logicielle exploite n'importe quel capteur de débit d'eau existant et correctement configuré dans Home Assistant. Au lieu de se fier à une impulsion matérielle d'erreur, Water-Monitor suit mathématiquement les sessions de consommation d'eau (la durée et le volume d'un tirage continu). En comparant ces sessions aux habitudes normales d'un domicile, le système parvient à détecter des débits constants anormaux et à inférer la présence de fuites potentielles.
Foire aux Questions (FAQ)
Comment éviter de fausser les statistiques de fuite si j'ajoute des capteurs sur mes électroménagers ?
La plateforme permet d'affiner le suivi en intégrant la consommation d'eau appareil par appareil (machine à laver, lave-vaisselle, robinets individuels connectés). Il est possible de créer des hiérarchies logiques en déclarant le compteur principal comme « upstream device » (appareil en amont) d'un compteur individuel. Cette configuration stricte permet au système d'éviter le double comptage, garantissant que les volumes du lave-vaisselle ne s'ajoutent pas artificiellement au volume global, ce qui déclencherait de fausses alertes d'anomalie.Peut-on capter sans fil les données d'un compteur télérelevé européen ?
Oui, pour certains modèles. Les compteurs Itron EverBlu Cyble Enhanced diffusent leurs données via le protocole RADIAN, dont la fréquence d'opération varie selon les régions (souvent 868 MHz en Europe et 433 MHz sur d'autres marchés). Il est possible de les lire avec un microcontrôleur ESP32 ou ESP8266 couplé à un transceiver matériel CC1101 (via le projet everblu-meters-esp), ce qui permet une intégration automatique dans Home Assistant via MQTT AutoDiscovery. Cette méthode, utilisée au Royaume-Uni et en Europe, pourrait théoriquement fonctionner avec d'autres modèles de la gamme Cyble, bien qu'ils ne soient pas tous testés.Le remplacement physique de mon compteur par le gestionnaire d'eau va-t-il casser mon historique Home Assistant ?
Non. Si le capteur a été correctement configuré avec l'attribut `state_class: total_increasing`, une chute brutale de la valeur (due à une remise à zéro ou au remplacement physique du compteur) ne casse pas l'historique. L'algorithme du serveur domotique comprend l'événement, démarre un nouveau cycle de compteur à partir de zéro, tout en conservant intacte la consommation déjà accumulée dans ses statistiques à long terme.Ce qu'il faut retenir / prochaines étapes
Avec le déploiement progressif des compteurs communicants, l'approche du retrofit reste une excellente transition vers une domotique unifiée. Le remplacement physique d'un compteur traditionnel par votre gestionnaire d'eau, bien qu'il modifie l'interface de captation matérielle, ne cassera d'ailleurs pas l'historique à long terme dans Home Assistant, à condition de maintenir la rigueur de l'attribut `state_class: total_increasing`.
