Les appareils Tuya ont envahi les catalogues en ligne : prises connectées, ampoules, interrupteurs, capteurs, thermostats, robots aspirateurs… Le choix est vaste, les prix souvent intéressants, mais l’écosystème Tuya peut rapidement devenir un peu dispersé entre plusieurs applications et différents comptes fabricants.
Avec Home Assistant, il est possible de réunir tout ce petit monde dans une seule interface, puis de créer des automatismes réellement adaptés à la maison. Une prise Tuya peut ainsi couper un chauffage, un capteur peut déclencher une lumière et un interrupteur peut continuer à fonctionner même si l’application du fabricant reste sagement fermée.
La méthode la plus simple passe par l’intégration officielle Tuya. Les utilisateurs qui souhaitent davantage de rapidité, de confidentialité et de fonctionnement local pourront ensuite se tourner vers LocalTuya ou Tuya Local. Voici les différentes options, leurs limites et la méthode à suivre.
Tuya, Smart Life et Home Assistant : qui fait quoi ?
Avant de connecter un appareil, il faut clarifier un point souvent source de confusion. Tuya fournit une plateforme logicielle et matérielle utilisée par de nombreuses marques. Un même produit peut donc être vendu sous plusieurs noms, avec une électronique quasiment identique.
Les applications Tuya Smart et Smart Life servent généralement à configurer les équipements. Dans la plupart des cas, un appareil ajouté dans Tuya Smart n’apparaîtra pas automatiquement dans Smart Life, même si les deux applications reposent sur la même infrastructure. Il faut donc choisir une application et s’y tenir.
Home Assistant, lui, devient la couche de pilotage centrale. Il récupère les informations depuis Tuya ou directement depuis le réseau local, puis les expose sous forme d’entités :
- interrupteurs et prises ;
- ampoules et variateurs ;
- température, humidité et qualité de l’air ;
- détecteurs d’ouverture, de mouvement ou de fuite ;
- volets roulants et stores ;
- consommation électrique ;
- thermostats et appareils de chauffage.
Le résultat dépend toutefois du modèle exact. Deux prises Tuya visuellement identiques peuvent exposer des fonctions différentes dans Home Assistant. C’est un grand classique de la domotique : le boîtier est le même, mais l’intérieur réserve parfois quelques surprises.
Les trois méthodes pour intégrer un appareil Tuya
Il existe aujourd’hui trois approches principales. Elles ne répondent pas exactement aux mêmes besoins.
L’intégration officielle Tuya
C’est la méthode la plus accessible. Home Assistant communique avec le cloud Tuya, qui transmet les états et les commandes. L’installation est rapide et ne demande généralement pas de modifier le firmware de l’appareil.
Ses avantages sont clairs :
- configuration relativement simple ;
- bonne compatibilité avec les appareils récents ;
- aucune soudure ni manipulation matérielle ;
- fonctionnement possible même sans adresse IP fixe sur le réseau local.
En contrepartie, les commandes passent par Internet. Une panne de connexion ou une indisponibilité du cloud peut donc empêcher le pilotage. La réactivité dépend également de la liaison entre Home Assistant, les serveurs Tuya et l’appareil.
LocalTuya
LocalTuya permet de contrôler les équipements directement sur le réseau local, sans faire transiter chaque ordre par le cloud. La latence est souvent meilleure et les automatismes critiques peuvent continuer à fonctionner lorsque l’accès Internet est coupé.
Cette solution demande cependant davantage de travail. Il faut récupérer l’identifiant local de l’appareil, sa clé locale et les identifiants de données, appelés souvent DP ou Data Points. Selon le produit, cette opération peut être simple… ou demander quelques essais.
Tuya Local
Tuya Local est une autre intégration communautaire orientée vers le fonctionnement local. Elle propose parfois une découverte plus pratique et une prise en charge plus précise de certains appareils. Son installation passe généralement par HACS, le gestionnaire d’intégrations communautaires de Home Assistant.
Il faut garder en tête que ces intégrations ne sont pas toujours compatibles avec tous les modèles. Avant de changer une configuration qui fonctionne, mieux vaut vérifier la référence exacte de l’appareil et consulter la documentation de l’intégration.
Préparer les appareils Tuya avant la connexion
La première étape consiste à installer chaque appareil dans l’application officielle du fabricant. Pour un produit compatible Tuya, il s’agit le plus souvent de Tuya Smart ou de Smart Life.
Procédez de manière méthodique :
- installez Tuya Smart ou Smart Life sur votre smartphone ;
- créez un compte ou connectez-vous à votre compte existant ;
- vérifiez que le téléphone est connecté au réseau Wi-Fi de la maison ;
- réinitialisez l’appareil si nécessaire ;
- ajoutez-le dans l’application ;
- testez son fonctionnement depuis l’application ;
- notez son nom et sa pièce d’installation.
Pour les équipements Wi-Fi en 2,4 GHz, il peut être nécessaire de désactiver temporairement le réseau 5 GHz ou de séparer les deux bandes. Beaucoup de produits Tuya refusent encore l’association sur un réseau exclusivement 5 GHz.
Testez aussi les fonctions principales avant de passer à Home Assistant. Une ampoule doit pouvoir être allumée, éteinte et varier en intensité. Un volet doit répondre dans les deux sens. Cela évite de chercher un problème dans Home Assistant alors que l’appareil n’est pas correctement configuré dans son application d’origine.
Installer l’intégration officielle Tuya dans Home Assistant
Une fois les appareils fonctionnels dans Smart Life ou Tuya Smart, ouvrez Home Assistant avec un compte administrateur.
La procédure se déroule depuis l’interface :
- ouvrez Paramètres ;
- allez dans Appareils et services ;
- cliquez sur Ajouter une intégration ;
- recherchez Tuya ;
- sélectionnez l’intégration officielle ;
- suivez le lien ou le QR code proposé par Home Assistant.
Selon la version utilisée, Home Assistant peut demander de confirmer l’association depuis l’application Tuya. Il faut alors ouvrir l’application mobile, accéder à la section de scan et lire le QR code affiché dans Home Assistant.
Cette liaison associe généralement le compte Tuya à Home Assistant. Les appareils déjà présents dans l’application remontent ensuite automatiquement, parfois après quelques secondes. Si rien n’apparaît, redémarrez l’intégration depuis la page Appareils et services, puis vérifiez que le compte utilisé est bien le même.
Identifier et organiser les appareils détectés
Après l’intégration, Home Assistant crée un appareil et plusieurs entités associées. Une prise peut par exemple exposer une entité de type interrupteur, une mesure de puissance, une tension et une intensité.
Commencez par renommer clairement chaque élément. Évitez les noms comme « Smart Plug 01 » ou « Device 7 ». Préférez des appellations directement compréhensibles :
- Prise lave-linge ;
- Lumière entrée ;
- Température chambre ;
- Volet bureau ;
- Détecteur ouverture garage.
Attribuez ensuite chaque appareil à la bonne pièce. Cette organisation facilite la création des tableaux de bord et des automatismes. Elle permet aussi de lancer des actions par zone, par exemple éteindre toutes les lumières du rez-de-chaussée en quittant la maison.
Certaines fonctions peuvent être désactivées par défaut. Dans la page de l’appareil, vérifiez les entités désactivées et activez celles qui vous intéressent. Attention toutefois à ne pas afficher toutes les données disponibles sans réfléchir : un tableau de bord rempli de tension, courant, puissance, qualité Wi-Fi et codes internes devient rapidement illisible.
Créer un premier automatisme utile
Une fois l’intégration terminée, le plus simple est de commencer par un automatisme concret. Par exemple, allumer une lampe Tuya lorsqu’un détecteur de mouvement est activé.
La logique est la suivante :
- déclencheur : le capteur de mouvement détecte une présence ;
- condition : la luminosité extérieure est faible ou la période correspond à la nuit ;
- action : allumer la lampe ;
- temporisation : attendre quelques minutes ;
- action finale : éteindre la lampe.
Un autre exemple pratique concerne une prise avec mesure de consommation. Vous pouvez recevoir une notification lorsque le lave-linge a terminé son cycle, en détectant une baisse durable de la puissance consommée. Ce type d’automatisme est plus intéressant qu’un simple calendrier, car il s’adapte au programme réellement lancé.
Pour un chauffage d’appoint, une prise Tuya peut être activée lorsque la température descend sous un seuil. Ajoutez impérativement des conditions de sécurité : température maximale, plage horaire, présence à domicile et éventuellement durée maximale de fonctionnement. Une automatisation domotique doit éviter de transformer un petit radiateur en sculpture incandescente.
Passer au pilotage local avec LocalTuya
Si vous souhaitez limiter la dépendance au cloud, LocalTuya est une piste intéressante. Avant de l’installer, il est conseillé de conserver l’intégration officielle fonctionnelle. Elle servira de solution de secours et pourra aider à identifier le modèle de l’appareil.
LocalTuya s’installe généralement via HACS. HACS n’est pas intégré par défaut à Home Assistant : il faut donc l’installer séparément en suivant la procédure officielle correspondant à votre méthode d’installation.
Une fois LocalTuya disponible :
- ouvrez Paramètres, puis Appareils et services ;
- ajoutez l’intégration LocalTuya ;
- sélectionnez l’appareil détecté sur le réseau ;
- indiquez les informations demandées ;
- choisissez le type d’entité à créer ;
- associez les bons Data Points aux fonctions de l’appareil ;
- testez chaque commande avant de supprimer l’intégration cloud.
La difficulté principale vient des Data Points. Le numéro correspondant à l’allumage n’est pas forcément le même d’un appareil à l’autre. Pour une prise, on trouve souvent un Data Point pour le relais, un autre pour le mode de fonctionnement et plusieurs autres pour les mesures électriques. Il ne faut donc pas recopier aveuglément une configuration trouvée pour un modèle voisin.
Les problèmes les plus fréquents
L’appareil n’apparaît pas
Vérifiez d’abord le compte utilisé et l’application dans laquelle le produit a été ajouté. Un appareil présent dans Smart Life ne remontera pas forcément avec un compte Tuya Smart différent.
Contrôlez également la région du compte. Tuya utilise plusieurs zones géographiques et un appareil peut être invisible si le compte Home Assistant ne correspond pas à la région sélectionnée dans l’application.
Les commandes sont lentes
Avec l’intégration cloud, une latence de quelques secondes peut être normale. Si le délai devient important, testez le Wi-Fi de l’appareil et vérifiez la qualité du réseau. Les petits modules installés dans un tableau électrique ou au fond d’une boîte d’encastrement peuvent être mal couverts.
Pour les automatismes sensibles à la rapidité, comme l’éclairage sur détection, le fonctionnement local est souvent préférable.
Certaines fonctions manquent
L’intégration ne récupère pas nécessairement toutes les options visibles dans l’application Tuya. Cela dépend du profil exposé par le fabricant et de la façon dont le produit a été déclaré dans le cloud.
Une mise à jour de Home Assistant ou de l’intégration peut améliorer la prise en charge. Dans d’autres cas, il faudra passer par LocalTuya, Tuya Local ou rechercher une intégration spécifique au fabricant.
L’appareil change d’adresse IP
Pour un pilotage local fiable, attribuez une réservation DHCP à chaque appareil Tuya dans l’interface de votre routeur. L’équipement conservera ainsi la même adresse IP après un redémarrage.
Cette précaution est particulièrement utile pour les prises, relais et modules encastrés qui doivent répondre à des automatismes quotidiens. Une adresse qui change au mauvais moment, et voilà la lumière du couloir transformée en dispositif aléatoire.
Cloud ou local : quelle solution choisir ?
Pour débuter, l’intégration officielle Tuya est le meilleur choix. Elle permet de valider la compatibilité du matériel et de construire ses premiers tableaux de bord sans passer des heures à rechercher des clés locales.
Le fonctionnement local devient pertinent dans les situations suivantes :
- vous voulez continuer à piloter les appareils en cas de panne Internet ;
- vous recherchez une meilleure réactivité ;
- vous souhaitez réduire les échanges avec les serveurs du fabricant ;
- vous utilisez des automatismes liés à la sécurité ou au chauffage ;
- vous aimez garder la maîtrise de votre installation.
Dans la pratique, une installation mixte fonctionne très bien. Les appareils simples et peu critiques peuvent rester sur l’intégration officielle, tandis que les éclairages, capteurs et prises utilisés dans des automatismes importants passent en local.
Quelques précautions avant de généraliser Tuya
Évitez de confier une fonction de sécurité essentielle à un appareil dont le comportement dépend uniquement d’un cloud externe. Une serrure, une alarme ou un détecteur de fumée mérite une réflexion particulière, voire une solution conçue dès le départ pour fonctionner localement.
Vérifiez également la qualité électrique des modules. Pour un appareil puissant, respectez la charge maximale du relais et les recommandations du fabricant. Une prise connectée bon marché n’est pas automatiquement adaptée à un chauffage de forte puissance ou à un moteur.
Enfin, documentez votre installation. Notez les références des produits, leur adresse IP, leur application d’origine et les automatismes qui les utilisent. Le jour où un appareil est remplacé, ces quelques informations feront gagner un temps précieux.
Home Assistant transforme ainsi une collection parfois disparate d’appareils Tuya en une installation cohérente et personnalisable. Commencez par l’intégration officielle, validez chaque équipement, puis migrez progressivement les appareils importants vers le local. C’est la méthode la plus sûre pour obtenir une domotique fiable sans passer son week-end à déboguer une prise connectée.