Deux solutions permettent d’intégrer les appareils Tuya : l’intégration Tuya incluse dans Home Assistant, qui passe par le cloud, et l’intégration communautaire « Tuya Local » pour les modèles compatibles sur le réseau local. Ce guide reprend la procédure de Home Assistant 2025.12.2 et la confronte aux instructions actuelles des projets. Commencez par l’intégration incluse.
1. Préparation
Installez « Tuya Smart » ou « Smart Life » sur votre téléphone, connectez-vous et ajoutez au moins un appareil. Vérifiez qu’il fonctionne dans l’application. Pour lier le compte à Home Assistant, gardez l’application à portée de main et utilisez un second écran pour afficher le code QR.
2. Lier le compte Tuya
Dans l’application mobile, ouvrez « Moi » → roue dentée « Paramètres » → « Compte et sécurité » → « Code utilisateur ». Copiez ce code. Dans Home Assistant, ouvrez « Paramètres » → « Appareils et services » → « Ajouter une intégration », recherchez « Tuya » et saisissez le code utilisateur.
Un code QR apparaît dans Home Assistant. Dans « Tuya Smart » ou « Smart Life », ouvrez la fonction de scan avec « + » ou « Ajouter un appareil », scannez le code et confirmez la connexion. Revenez à Home Assistant, terminez la configuration et attribuez éventuellement les appareils aux pièces. Cette procédure officielle ne nécessite pas de créer un projet développeur Tuya personnel.
3. Vérifier et actualiser les appareils
Ouvrez l’intégration Tuya dans « Appareils et services » et testez les entités affichées. Toutes les fonctions de l’application mobile ne sont pas forcément exposées. Après avoir ajouté d’autres appareils dans l’application, rechargez l’intégration Tuya dans Home Assistant pour les faire apparaître.
4. Option de commande locale
« Tuya Local » est une intégration communautaire distincte qui nécessite HACS. Installez-la si vous avez besoin d’une commande locale ou de fonctions supplémentaires et si votre modèle est compatible. Après l’installation et le redémarrage de Home Assistant, ajoutez « Tuya Local » dans « Appareils et services ». Sa documentation indique que la connexion au compte Tuya/Smart Life peut récupérer les données nécessaires ; une configuration manuelle avec identifiant, adresse IP locale et clé locale est aussi possible. Traitez cette clé comme un mot de passe.
Dépannage
Si un appareil manque, vérifiez d’abord qu’il est en ligne dans l’application mobile, puis rechargez l’intégration Tuya. Une fonction absente peut provenir des limites de l’interface officielle ou du modèle. Avant de passer à « Tuya Local », vérifiez sa liste d’appareils compatibles et la connectivité réseau.
