Arrêt automatique de l’eau avec Home Assistant : intégration
Ce détecteur de fuites et cette vanne de fermeture sont contrôlés via l’application Smart Life, qui fonctionne sur la plateforme de Tuya. Or, les appareils Tuya sont précisément ceux que l’intégration officielle Tuya de Home Assistant est conçue pour prendre en charge. Il existe donc un chemin documenté pour intégrer cette catégorie d’appareils à Home Assistant : associez le même compte Smart Life, et Home Assistant pourra détecter les appareils qui y sont enregistrés. En revanche, rien ne précise si toutes les fonctionnalités proposées par cette vanne dans l’application — surveillance du débit, alertes et fermeture de la vanne — apparaissent sous la forme d’entités utilisables une fois le compte associé, ni si une solution locale uniquement prend en charge ce produit et son micrologiciel exacts. Il vaut la peine de vérifier ces deux points avant de concevoir une automatisation autour de la vanne.
- La vanne s’intègre à Home Assistant par le même mécanisme « Powered by Tuya » que les autres appareils Smart Life, et non au moyen d’un module spécifique à cet appareil. L’association du compte donc davantage que le produit lui-même.
- L’intégration officielle Tuya de Home Assistant fonctionne via le cloud de Tuya, tandis qu’un projet communautaire distinct, appelé tuya-local, commande directement les appareils pris en charge sur le réseau domestique. Ces deux solutions ont des exigences et des limites différentes.
- Dans Home Assistant, une automatisation qui relie une fuite à la vanne se compose d’un déclencheur, d’une condition facultative et d’une action. Le type d’entité vanne prend en charge les commandes d’ouverture, de fermeture, d’arrêt et de réglage de la position.
- Le fabricant indique que la batterie rechargeable de secours permet de fonctionner en cas de panne de courant, mais ne précise pas dans quelle position reste la vanne si l’alimentation secteur et la batterie finissent toutes deux par être épuisées. C’est un point important dès lors qu’une automatisation vient s’ajouter au dispositif.
- Rien ici ne confirme que cet appareil a été testé en interne avec Home Assistant. Considérez les sections ci-dessous comme une explication du fonctionnement général de l’intégration, et non comme une garantie de compatibilité pour ce modèle précis.
Comment cette vanne s’intègre à une configuration Home Assistant
L’appareil se connecte à l’application Smart Life via le Wi-Fi 2.4G ou 5G, un détail plus important qu’il n’y paraît. Smart Life est l’application grand public de Tuya, et la mention « Powered by Tuya » détermine si un appareil peut être intégré à l’intégration officielle Tuya de Home Assistant. Home Assistant n’associe pas cette vanne en tant que produit nommé : il se connecte au compte Tuya ou Smart Life auquel elle a été ajoutée, puis récupère les appareils et les fonctionnalités que ce compte met à sa disposition.
C’est pourquoi la compatibilité au niveau du compte et celle des fonctionnalités sont deux questions distinctes. La réponse à la première est presque certaine : un appareil basé sur Tuya et ajouté à Smart Life est bien le type d’appareil auquel cette intégration est destinée. La seconde dépend des plateformes d’entités actuellement prises en charge par l’intégration Tuya de Home Assistant. Elle couvre la plupart des types d’appareils, notamment les interrupteurs et les vannes, mais exclut explicitement quelques plateformes, comme les serrures et les télécommandes. Pour savoir si les mesures propres à cette vanne (débit, température, historique d’utilisation) sont accessibles sous forme d’entités de capteur ou si seule la commande d’ouverture et de fermeture est disponible, il faut associer le compte et vérifier : la fiche produit ne suffit pas.
Deux façons d’intégrer une vanne Tuya à Home Assistant
Une fois que vous savez que l’appareil est basé sur Tuya, il existe deux façons fondamentalement différentes de l’intégrer à Home Assistant, qui privilégient soit la simplicité d’utilisation, soit le contrôle.
L’intégration officielle Tuya basée sur le cloud
L’intégration Tuya intégrée à Home Assistant se configure directement dans Home Assistant : connectez-vous à votre compte Tuya Smart ou Smart Life, auquel la vanne a déjà été ajoutée, puis scannez un code QR à l’aide d’un code utilisateur généré dans l’application. Home Assistant peut alors détecter les appareils associés et les entités prises en charge. Le compromis se situe dans son fonctionnement au quotidien : cette intégration est classée « Cloud Push », ce qui signifie que les commandes et les mises à jour d’état transitent généralement par les serveurs cloud de Tuya au lieu de rester sur votre réseau domestique. Si votre connexion Internet est interrompue, l’échange avec le cloud est également coupé, même si la vanne se trouve à quelques mètres de votre routeur.
Les intégrations locales communautaires et leurs limites
Un projet distinct géré par la communauté, appelé tuya-local, adopte une autre approche : il communique directement sur le réseau local avec les appareils dotés d’un micrologiciel Tuya qu’il prend en charge, au moyen d’une clé locale propre à chaque appareil. Le contrôle au quotidien continue ainsi de fonctionner sans connexion Internet. Ce projet n’est pas officiel et est maintenu en dehors du projet principal de Home Assistant. Sa documentation précise qu’il n’empêche pas l’appareil d’envoyer également des données au cloud de Tuya en arrière-plan : les deux voies coexistent au lieu de se remplacer.
Le point délicat, c’est que les projets fonctionnant uniquement en local publient leurs propres listes d’appareils pris en charge, établies à partir de produits spécifiques qui ont été testés. Les différences de micrologiciel entre des appareils d’un même modèle peuvent toutefois déterminer si un appareil donné est effectivement reconnu. Il faut donc vérifier l’appareil concerné dans la liste à jour ; on ne peut pas le déduire de son nom ou de sa catégorie. C’est précisément le type de vérification qui n’a pas été effectué ici pour cette vanne.
Les éléments d’une automatisation reliant une fuite à une vanne
Une fois les entités d’un appareil visibles dans Home Assistant, l’automatisation qui les utilise suit la structure de base de toutes les automatisations Home Assistant : un déclencheur, une condition facultative et une action qui appelle un service sur une entité déjà connue de Home Assistant. En cas de fuite, le déclencheur est généralement un capteur qui change d’état — un détecteur de fuite qui s’active ou une mesure de débit qui dépasse un seuil que vous avez défini — et l’action appelle un service sur l’entité de la vanne.
Le type d’entité vanne de Home Assistant est un domaine défini, doté de ses propres états — ouverte, fermée, en cours d’ouverture, en cours de fermeture, à l’arrêt, indisponible et inconnu — et de ses propres actions prises en charge, notamment ouvrir, fermer, arrêter et définir la position, ainsi que basculer. Une condition peut ainsi attendre que la vanne soit effectivement à l’état fermé avant de faire quoi que ce soit d’autre, au lieu de supposer que la commande de fermeture a fonctionné. Un scénario réaliste associe l’action de fermeture à une action de notification distincte dans la même automatisation, afin que la fermeture de la vanne et l’alerte du foyer soient déclenchées par un seul événement, plutôt que de compter sur la vanne pour communiquer quoi que ce soit par elle-même. En effet, une entité de vanne ne peut pas envoyer de notification push ni passer d’appel téléphonique par elle-même ; ces alertes sont déjà gérées par l’application et le système d’alerte propres au fabricant, indépendamment de Home Assistant.
La question de la sécurité à poser avant de compter sur une automatisation
Dans le domaine des vannes, la position dite « de sécurité » est, en règle générale, celle vers laquelle une vanne motorisée est conçue pour se déplacer ou dans laquelle elle est conçue pour rester en cas de perte d’alimentation ou du signal de commande : ouverte, fermée ou simplement dans sa position actuelle. La position considérée comme sûre dépend entièrement du système. Pour l’alimentation en eau de toute une maison, la plupart des gens supposeraient que la position « fermée » est la plus sûre par défaut, mais il faut tout de même vérifier cette hypothèse pour le produit concerné plutôt que de se fier à ce qui semble intuitif.
Pour cet appareil, le fabricant indique qu’une batterie rechargeable de secours permet à l’unité de fonctionner en cas de panne de courant : une information utile et une véritable caractéristique de conception. En revanche, il ne précise pas dans quelle position la vanne se place par défaut si la panne dure assez longtemps pour épuiser à la fois l’alimentation secteur et la batterie. Cette lacune devient d’autant plus importante lorsqu’une automatisation Home Assistant s’ajoute au dispositif, car une automatisation qui suppose que « la vanne va simplement se fermer toute seule » en cas de panne prolongée repose sur une hypothèse que la documentation ne confirme pas réellement. Lorsqu’il s’agit d’un élément aussi important que l’alimentation en eau de toute une maison, il est raisonnable de poser directement la question au fabricant plutôt que de faire des suppositions.
Ce qu’il faut vérifier avant de baser une configuration sur cette vanne
Aucun des éléments ci-dessus ne constitue une confirmation de compatibilité pour ce produit précis : ils décrivent le fonctionnement général de l’intégration Tuya à Home Assistant en prenant cette vanne comme exemple. Avant de créer une automatisation autour d’elle, il vaut la peine d’effectuer quelques vérifications, dans l’ordre :
- Associez le compte Smart Life dans l’intégration Tuya de Home Assistant et vérifiez que l’appareil apparaît bien sous la forme d’une entité de vanne ou d’interrupteur, car l’intégration ne garantit pas que toutes les fonctionnalités visibles dans l’application seront exposées.
- Si le contrôle uniquement local est important pour vous — par exemple, si vous voulez que la vanne continue de réagir en cas de coupure Internet — vérifiez que ce produit précis et sa version de micrologiciel figurent dans la liste actuelle des appareils pris en charge par tuya-local, avant de supposer que c’est le cas.
- Conservez la vanne d’arrêt manuelle du foyer et les alertes de l’application de l’appareil (notification push, SMS, appel téléphonique) comme principales mesures de sécurité. Considérez toute automatisation Home Assistant comme une commodité supplémentaire qui s’y ajoute, et non comme un remplacement.
Si vous n’avez pas encore installé la vanne, il vaut la peine de commencer par là : les étapes d’installation et la liste des outils pour cette vanne de fermeture sont présentées séparément, avant de planifier des automatisations autour d’un appareil qui n’est pas encore installé sur la conduite. Si Alexa ou Google Home convient mieux à votre foyer qu’une configuration reposant sur un hub, la configuration de cette vanne avec Alexa et Google Home présente directement ces intégrations. Et si l’appareil ou l’application apparaît comme étant hors ligne pendant la configuration, les solutions aux problèmes de Wi-Fi d’un appareil Smart Life affiché hors ligne règlent généralement le problème. Il vaut la peine de garder ce lien, car une automatisation basée sur le cloud dépend du maintien de cette connexion.
Pour comprendre d’abord comment le capteur et la vanne de fermeture fonctionnent ensemble, avant même de faire intervenir une plateforme domotique, le fonctionnement des détecteurs intelligents de fuites d’eau et des vannes de fermeture automatique explique en détail la détection et la fermeture.
En bref : cette vanne dispose d’une voie documentée pour s’intégrer à Home Assistant via l’intégration officielle Tuya, ainsi que d’une seconde voie possible via une intégration locale communautaire, à condition que l’appareil précis figure dans sa liste de produits pris en charge. Aucune de ces deux solutions n’a encore été vérifiée en interne pour ce produit. Le plus honnête est donc de commencer par vérifier l’association de votre compte et la liste de vos entités, puis de décider quelle part de votre plan de réponse aux fuites vous souhaitez confier à une automatisation.