passerelle Zigbee compatible Home Assistant pour appareils Tuya (cloud)

Une passerelle Tuya est un pont propriétaire : elle relie les appareils Zigbee au cloud du fabricant et à l’application Tuya Smart ou Smart Life. Un coordinateur Zigbee est une clé USB ou un adaptateur branché sur la machine qui exécute Home Assistant. Il crée et administre le réseau Zigbee localement.

Passerelle Tuya ou coordinateur Zigbee ?

Fonctionnement d’une passerelle Tuya

La passerelle Tuya reçoit les commandes et remonte les états des appareils Zigbee qui lui sont appairés. Elle transmet ces informations au cloud Tuya, qui sert d’intermédiaire entre l’application du fabricant et Home Assistant. Une commande envoyée à une ampoule passe donc par Internet, même lorsque l’appareil se trouve à quelques mètres de l’utilisateur.

Rôle du coordinateur dans un réseau Zigbee

Le coordinateur est le nœud qui forme le réseau Zigbee, attribue les adresses aux appareils et conserve les informations de sécurité du réseau. Chaque réseau Zigbee ne possède qu’un seul coordinateur. Home Assistant s’appuie dessus via l’intégration ZHA ou via Zigbee2MQTT.

Architecture : coordinateur, routeurs et end devices

Un réseau Zigbee repose sur trois rôles. Le coordinateur organise le réseau. Les routeurs, généralement alimentés sur secteur comme les prises, interrupteurs ou ampoules, relaient les messages vers les autres appareils. Les end devices, comme les capteurs et boutons sur pile, émettent et reçoivent sans relayer.

Comparaison des deux approches

La compatibilité réelle d’un appareil avec un coordinateur n’est pas garantie.

Une passerelle Tuya fonctionne-t-elle avec Home Assistant ?

Oui. L’intégration Tuya native de Home Assistant ne dialogue pas avec la passerelle sur le réseau local : elle se connecte aux serveurs Tuya et récupère les appareils rattachés à votre compte. Home Assistant (2026) la classe en Cloud Push.

Prérequis du compte et des appareils

Deux éléments doivent être réunis avant de lancer l’intégration :

Procédure de connexion de l’intégration Tuya

1. Dans Home Assistant, ouvrez Paramètres > Appareils et services, cliquez sur Ajouter une intégration, puis recherchez « Tuya ».
2. Sélectionnez la région correspondant à votre compte. Un décalage de région peut empêcher la récupération des appareils ; en cas de doute, vérifiez le pays associé au compte dans l’application Tuya.
3. Connectez-vous avec les identifiants du compte Tuya Smart ou Smart Life, en suivant les étapes affichées. La méthode de connexion peut varier selon la version de Home Assistant : consultez la documentation officielle de l’intégration Tuya si l’écran diffère.
4. Vérifiez que la passerelle et ses appareils figurent dans la liste des entités. Testez ensuite un appareil simple, comme une prise, pour confirmer que la commande arrive bien.

Les limites de l’intégration Tuya cloud

L’intégration Tuya de Home Assistant ne communique qu’avec le cloud Tuya. Elle est classée Cloud Push et n’offre aucun contrôle local. Chaque commande envoyée depuis Home Assistant transite donc par les serveurs du fabricant avant d’atteindre l’appareil, et chaque changement d’état remonte par le même chemin. Cette architecture conditionne la fiabilité, la confidentialité et le temps de réponse de l’ensemble du système.

Cloud Push : absence de contrôle local

Le mode Cloud Push signifie que l’intégration communique uniquement avec le cloud Tuya et n’offre aucun contrôle local. Il communique uniquement avec le cloud Tuya (Home Assistant, 2026). Une prise ou un interrupteur Tuya ajouté par cette intégration ne peut donc pas être piloté par le réseau local seul. Même si Home Assistant tourne sur une machine locale, la chaîne de commande reste externe.

Dépendance à la connexion Internet et aux serveurs

Puisque la commande suit le trajet Home Assistant, serveurs Tuya, puis appareil, une coupure de la connexion Internet domestique ou une indisponibilité côté fabricant interrompt le pilotage, même si Home Assistant fonctionne normalement.

Conséquences sur les automatisations critiques

Une automatisation qui dépend d’un appareil en Cloud Push hérite de toutes ces limites. Les cas les plus sensibles sont ceux où un retard ou une absence de réponse a un effet concret : coupure d’un chauffage piloté par prise, éclairage programmé à heure fixe, alerte liée à un capteur. Aucune mesure de latence n’est disponible ici, il faut donc éviter de supposer une exécution immédiate et identique à celle d’un appareil piloté localement.

Pour limiter le risque :

• Consultez la notice du fabricant pour savoir si l’appareil accepte un contrôle hors cloud.
• Réservez les fonctions critiques aux appareils dont la documentation confirme ce contrôle local.
• Testez la routine lors d’un créneau sans conséquence, en simulant une coupure Internet, puis ajustez-la selon le comportement observé.

Quel coordinateur Zigbee choisir ?

Le coordinateur est le module, souvent une clé USB, qui crée le réseau Zigbee et relie les appareils Tuya à Home Assistant. Le choix dépend de deux critères : le logiciel utilisé (ZHA ou Zigbee2MQTT) et le statut de prise en charge de l’adaptateur par ses développeurs. Pour une nouvelle installation, Home Assistant (2026) recommande son propre matériel pour ZHA : la clé Home Assistant Connect ZBT-2, au format USB.

Home Assistant (2026) liste aussi plusieurs adaptateurs tiers testés, avec trois statuts de prise en charge :

Pour Zigbee2MQTT, la logique est différente. Zigbee2MQTT (2026) recommande trois familles d’adaptateurs : zStack (Texas Instruments), EmberZNet (Silicon Labs) et deCONZ (dresden elektronik). Le ZiGate est classé « non recommandé » car il n’est plus maintenu, et le ZBOSS est classé expérimental. Un adaptateur sans mises à jour de son logiciel embarqué risque de ne plus suivre les évolutions du protocole Zigbee.

En pratique, un achat neuf doit se faire parmi les adaptateurs recommandés ou testés par le logiciel retenu. Les modèles ConBee II, RaspBee II et CC2531 restent utilisables, mais ils ne sont pas recommandés pour un nouveau réseau.

ZHA ou Zigbee2MQTT ?

ZHA et Zigbee2MQTT sont deux manières de faire fonctionner un réseau Zigbee avec Home Assistant. La différence tient moins aux appareils pris en charge qu’à l’endroit où le réseau est géré : dans Home Assistant pour ZHA, dans un service séparé pour Zigbee2MQTT. Ce choix détermine l’intégration, la liste des adaptateurs utilisables et la façon dont on administre le réseau au quotidien.

Intégration native de ZHA dans Home Assistant

ZHA (Zigbee Home Automation) est intégré directement au cœur de Home Assistant. Il n’y a aucun composant supplémentaire à installer : l’adaptateur USB est branché sur l’hôte, ajouté depuis les paramètres de l’interface, et les appareils apparaissent sous forme d’entités natives. Les mises à jour de l’intégration suivent celles de Home Assistant.

Une fois le coordinateur en place, les appareils Tuya Zigbee compatibles peuvent être gérés par ZHA, sous réserve de vérifier chaque modèle.

Zigbee2MQTT : passerelle MQTT et interface web

Zigbee2MQTT fonctionne comme un service indépendant de Home Assistant. Il gère le réseau Zigbee, puis publie les états et reçoit les commandes via un courtier MQTT (le plus souvent Mosquitto). Home Assistant se connecte ensuite à ce courtier, généralement grâce à l’intégration MQTT, pour récupérer les entités.

Zigbee2MQTT dispose d’une interface web qui permet d’appairer les appareils, de les renommer, de consulter leur qualité de liaison et de modifier leurs paramètres. Cette séparation rend le réseau Zigbee indépendant de la version de Home Assistant : une mise à jour ou une réinstallation du système ne l’affecte pas directement, à condition de sauvegarder la configuration de Zigbee2MQTT.

Politique de prise en charge des adaptateurs

Avant tout achat, vérifiez la famille de puce indiquée sur la fiche du coordinateur et sa compatibilité dans la documentation de la solution choisie.

Les appareils Tuya sont-ils tous compatibles ?

Non. Il n’existe pas de liste officielle d’appareils Tuya compatibles avec ZHA. La documentation de Home Assistant l’indique : tous les fabricants ne respectent pas pleinement la norme Zigbee, si bien qu’un produit annoncé Zigbee peut fonctionner différemment d’un autre, même issu de la même marque. La compatibilité se vérifie donc modèle par modèle, avant l’achat ou avant d’intégrer un appareil au réseau.

Vérifier le retour d’un modèle précis

Home Assistant renvoie vers le dépôt blakadder, un recensement non officiel qui regroupe les retours d’utilisateurs par modèle. La démarche consiste à :

1. Relever la référence exacte du produit, inscrite sur l’étiquette de l’appareil ou dans sa notice. Un même nom commercial peut couvrir plusieurs versions matérielles.
2. Rechercher cette référence dans le dépôt et lire les notes concernant l’appairage et les fonctions prises en charge.
3. Vérifier que la version recensée correspond bien à celle que vous possédez.

Distinguer un appareil Tuya Zigbee d’un appareil Tuya Wi-Fi

Tuya commercialise des produits sur les deux protocoles, qui ne se gèrent pas de la même façon. Un appareil Wi-Fi se connecte directement au réseau domestique depuis l’application Smart Life ou Tuya Smart. Il n’emprunte donc pas la pile Zigbee et n’apparaît pas dans ZHA ou Zigbee2MQTT.

Comment migrer ses appareils Tuya ?

La migration se fait en cinq temps : retirer l’appareil du compte Tuya, le réinitialiser au niveau Zigbee, l’appairer au coordinateur local, renommer ses entités, puis mettre à jour les automatisations dans Home Assistant. Le principe est de ne réinitialiser que les appareils concernés et de garder l’ordre des opérations. Tant que l’appareil reste rattaché au cloud, il n’est pas migré.

Retrait du compte Tuya

Supprimez l’appareil dans l’application Tuya avant toute réinitialisation. Un appareil encore enregistré dans le cloud peut réapparaître dans l’intégration Tuya et créer un doublon avec l’appareil Zigbee.

Réinitialisation et appairage

La réinitialisation Zigbee efface la configuration réseau de l’appareil. Elle est distincte de la réinitialisation cloud, et la notice du fabricant indique la séquence exacte. Une fois l’appareil remis à zéro, activez le appairage sur le coordinateur, puis lancez la recherche d’appareils. Si l’appareil n’apparaît pas, rapprochez-le du coordinateur avant de recommencer.

Renommage des entités

Home Assistant crée un identifiant d’entité distinct de l’identifiant d’origine. Avant de modifier les automatisations, attribuez à chaque entité un nom explicite (par exemple « Lampe salon ») et notez son nouvel identifiant. Ce relevé évite les erreurs lors de la mise à jour des routines.

Mise à jour des automatisations

Parcourez chaque automatisation et chaque scène qui référence une ancienne entité Tuya, puis remplacez-la par la nouvelle.

Questions fréquentes

Une passerelle Tuya suffit-elle pour utiliser mes appareils Zigbee avec Home Assistant ?

Oui, mais uniquement par l’intermédiaire du cloud Tuya, sans contrôle local. L’intégration Tuya de Home Assistant (Home Assistant, 2026) exige un compte Tuya Smart ou Smart Life et des appareils déjà ajoutés à ce compte.

Quel coordinateur choisir pour créer un nouveau réseau Zigbee avec ZHA ?

Home Assistant (2026) recommande la Home Assistant Connect ZBT-2, un adaptateur USB, pour un nouveau réseau. Si vous préférez un autre modèle, ZHA liste des adaptateurs tiers testés, comme le SONOFF ZBDongle-E ou le SMLIGHT SLZB-07, ainsi que des adaptateurs CC2652 ou CC1352 flashés en Z-Stack.

Comment vérifier qu’un appareil Tuya Zigbee est compatible avec ZHA ou Zigbee2MQTT ?

Il n’existe pas de liste officielle des appareils compatibles avec ZHA (Home Assistant, 2026), donc la compatibilité modèle par modèle est la seule méthode fiable. Recherchez la référence exacte, indiquée sur l’étiquette ou dans la notice du fabricant, dans le dépôt non officiel blakadder. Pour Zigbee2MQTT, vérifiez aussi que votre adaptateur appartient à une famille recommandée : zStack, EmberZNet ou deCONZ (Zigbee2MQTT, 2026).

À lire aussi

• Capteur ouverture porte fenêtre Zigbee pour alarme maison
• Couper les veilles la nuit avec une prise connectée Tuya
• Prise connectée Wi-Fi sans hub : compatible box France
• Passerelle Matter Thread : quelle différence avec Zigbee ?