Aller au contenu principal

Intégration domotique TCL Home, gratuite et open source

Intégration TCL Home pour Gladys Assistant

Pilotez vos climatiseurs, déshumidificateurs et purificateurs TCL via le cloud TCL Home.

Cette intégration relie Gladys à votre compte TCL Home et pilote les appareils TCL qui y sont ajoutés : climatiseurs, déshumidificateurs et purificateurs d'air Breeva.

Avant de commencer​

  • Gladys 5.3 ou plus récent est nécessaire.
  • Vos appareils doivent d'abord fonctionner dans l'application mobile TCL Home : ajoutez-les là-bas, Gladys ne les appaire pas.
  • C'est une intégration cloud : Gladys passe par le cloud TCL Home, comme l'application. Gladys a besoin d'Internet, et rien ne marche quand le cloud TCL est en panne. Les appareils TCL n'offrent pas de commande locale.

TCL ne publie pas d'API officielle : cette intégration fait ce que fait l'application TCL Home. TCL peut la changer à tout moment. Elle n'est pas affiliée à TCL.

Configuration​

Dans Gladys, ouvrez Intégrations → TCL Home → Configuration :

ChampQue saisir
E-mail TCL HomeL'e-mail avec lequel vous vous connectez à l'application TCL Home
Mot de passe TCL HomeLe mot de passe de ce compte
Intervalle de rafraîchissement (s)Fréquence de lecture de chaque appareil, en secondes (60 à 3600, 60 par défaut)

Enregistrez, puis appuyez sur Tester la connexion : il liste les appareils trouvés, combien sont en ligne, et les appareils TCL que cette intégration ne pilote pas (une TV, par exemple).

Ouvrez ensuite l'onglet Découverte de l'intégration et ajoutez vos appareils.

Astuce : créez un second compte TCL Home, partagez-lui votre maison depuis l'application, et donnez celui-là à Gladys. Votre propre mot de passe reste ainsi le vôtre.

Appareils et fonctionnalités​

Une fonctionnalité n'apparaît que si votre appareil la signale : un modèle sans balayage horizontal n'a pas de commande de balayage horizontal.

Climatiseurs​

Splits, climatiseurs de fenêtre, mobiles, gainables, colonnes et à air neuf.

FonctionnalitéDans Gladys
AlimentationMarche / arrêt
ModeAuto, froid, déshumidification, ventilation, chaud (selon l'appareil)
Température de consigne16 à 31 °C, au degré près
VentilationAuto, silencieux, faible, moyen-faible, moyen, moyen-fort, fort, turbo
Balayage vertical / horizontalArrêt, balayage, ou une des 5 positions fixes
Température intérieureMesurée par l'appareil
Température de l'unité extérieureSi l'appareil la signale
Eco, sommeil, santé, séchage anti-moisissure, écran, bipInterrupteurs marche / arrêt

Sur un climatiseur mobile, le mode auto et la vitesse de ventilation n'existent que sur les modèles avec volet de balayage.

Déshumidificateurs​

Alimentation et humidité de la pièce.

Purificateurs d'air Breeva​

Alimentation, PM2.5, écran et sécurité enfant.

Rafraîchissement​

Gladys lit chaque appareil à l'intervalle choisi. Après un ordre, l'intégration relit l'appareil quelques secondes plus tard, pour que Gladys montre ce qu'il a vraiment fait.

Un appareil hors ligne affiche un badge injoignable ; en ligne, un badge cloud.

Scènes​

Déclencheurs​

DéclencheurQuandVariable
Appareil TCL en ligne / hors ligneUn appareil perd ou retrouve sa connexionstatus : online ou offline
Erreur d'un appareil TCLUn appareil signale un nouveau code d'erreurcode : le ou les codes, séparés par des virgules

Les deux peuvent être limités à un appareil. Ils se déclenchent sur un changement : un appareil déjà hors ligne, ou une erreur déjà présente au démarrage de Gladys, ne les déclenche pas.

Actions​

ActionCe qu'elle faitSortie
Régler un climatiseur TCLAllume l'appareil, avec le mode, la température et la ventilation choisis (vide : inchangé)applied (vrai/faux)
Éteindre tous les appareils TCLÉteint tous les appareils TCL alluméscount
Lancer l'autonettoyage TCLLance le cycle d'autonettoyage de l'appareil (il l'arrête), si le modèle en a unstarted (vrai/faux)

Un appareil hors ligne n'arrête pas la scène : la sortie vaut false, utilisez-la dans une condition si besoin.

Exemple : « Quand je quitte la maison, éteindre tous les appareils TCL », ou « À 18 h en été, mettre le climatiseur du salon en froid à 24 °C ».

Widget du tableau de bord​

Ajoutez le widget TCL Home à un tableau de bord. Il affiche :

  • l'état du compte TCL Home, puis chaque appareil : éteint, hors ligne, ou son mode et sa consigne ;
  • la température intérieure en direct des premiers climatiseurs ;
  • les boutons Régler un climatiseur (appareil, mode, température, ventilation), Tout éteindre et Actualiser.

Dépannage​

Message ou symptômeQue faire
« TCL Home refuse l'e-mail ou le mot de passe »Vérifiez-les en vous connectant à l'application TCL Home. Un compte créé avec Google ou Apple n'a pas de mot de passe : définissez-en un dans l'application, ou utilisez un second compte.
« TCL Home est injoignable »Vérifiez l'accès Internet de Gladys. L'intégration réessaie d'elle-même toutes les 5 minutes.
Un appareil manqueEst-il dans l'application TCL Home, sur le même compte ? « Tester la connexion » liste ceux non pris en charge.
Un ordre échoue avec « is offline »L'appareil n'est pas connecté au cloud TCL : vérifiez son Wi-Fi dans l'application TCL Home.
L'état change avec retardLe cloud est lu à l'intervalle de rafraîchissement : baissez-le (60 s minimum).

Passez le niveau de log à debug (variable d'environnement LOG_LEVEL) pour voir chaque appel. Les mots de passe et les jetons ne sont jamais écrits dans les logs.

Vie privée​

  • Le mot de passe est stocké par Gladys dans un champ secret et n'est envoyé qu'à TCL, sous forme de hachage MD5, comme le fait l'application.
  • Les jetons TCL et les accès AWS temporaires restent en mémoire, rien n'est écrit sur disque.
  • L'intégration ne parle qu'à TCL (*.tcl.com, *.tcljd.com) et à Amazon Web Services (*.amazonaws.com), en HTTPS.

Paramètres de configuration​

Voici les paramètres demandés par TCL Home dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonCette intégration passe par le cloud TCL Home, comme l'application mobile : vos appareils doivent d'abord être ajoutés dans l'application TCL Home. Saisissez ci-dessous l'e-mail et le mot de passe de ce compte. Gladys lit ensuite les appareils chaque minute (ou à l'intervalle choisi) et envoie vos ordres par le cloud : une connexion Internet est nécessaire.
E-mail TCL HomestringOuiL'e-mail avec lequel vous vous connectez à l'application TCL Home.
Mot de passe TCL HomesecretOuiLe mot de passe de ce compte. Il n'est envoyé qu'à TCL et n'est jamais journalisé.
Intervalle de rafraîchissement (s)numberNonFréquence de lecture de chaque appareil dans le cloud, en secondes (60 à 3600).

Comment installer TCL Home dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : TCL Home apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-tclhome:0.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-tclhome.

TCL Home nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

TCL Home est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂