Intégration domotique tado°, gratuite et open source
Connecteur non officiel : thermostats tado°, eau chaude, présence, fenêtres, scènes et widgets.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.2
- Nécessite Gladys >=5.1.0
- ★ 0
Connecteur non officiel, sans lien avec tado. Il amène votre chauffage tado° dans Gladys : les thermostats et têtes thermostatiques des générations V3+, V3 et V2, l'eau chaude, la climatisation, et les pièces de tado X. tado est une marque de tado GmbH.
Ce que vous obtenez
| Surface | Contenu |
|---|---|
| Un appareil par maison | à la maison (capteur de présence), mode de présence (automatique / maison / absent), température extérieure, intensité solaire, météo |
| Un appareil par zone de chauffage | consigne, mode (arrêt / manuel / programmation), état et puissance de chauffe, température, humidité, fenêtre ouverte détectée, batterie faible |
| Un appareil par zone eau chaude | marche/arrêt, mode, consigne si le système le permet |
| Un appareil par zone climatisation | marche/arrêt, mode (auto, froid, chaud, déshumidification, ventilation), consigne, température, humidité |
| En option : un appareil par téléphone géolocalisé | à la maison / absent |
| Déclencheurs de scène | présence modifiée, fenêtre ouverte détectée, chauffe démarrée / arrêtée, batterie faible |
| Actions de scène | régler une température (jusqu'au prochain bloc, pour une durée, ou jusqu'à modification), retour à la programmation, régler la présence, lire une zone |
| Widgets | Maison tado° (présence, extérieur, toutes les zones, boutons Maison / Absent / Auto) et Zone tado° (température, humidité, consigne, jauge de chauffe, mode, +/− 0,5 °C, programmation, arrêt) |
Installation
- Installez l'intégration et ouvrez son écran Configuration.
- Cliquez sur Lier mon compte tado° : une page de connexion tado s'ouvre dans un nouvel onglet. Connectez-vous et approuvez l'accès. Aucun mot de passe n'est stocké dans Gladys : tado remet à l'intégration une session qu'elle renouvelle elle-même.
- De retour dans Gladys, l'état passe au vert en quelques secondes et les maisons et zones apparaissent dans Découverte : ajoutez les appareils voulus.
- Placez les widgets sur un tableau de bord, choisissez la maison ou la zone.
La session reste valable tant que l'intégration tourne au moins une fois par mois. Après un long arrêt, l'état vous demande de lier à nouveau le compte.
Consignes
Une consigne envoyée depuis Gladys (le widget thermostat, une scène, le widget de zone) est un réglage manuel dans tado, comme sur l'appareil. L'option Une consigne manuelle dure décide quand il se termine : au prochain bloc de la programmation tado (par défaut), après une durée fixe, ou à la prochaine modification. L'action de scène régler une température peut le changer scène par scène.
Passer le mode sur Programmation termine le réglage manuel (tado reprend son programme) ; Arrêt éteint la zone (la protection hors gel reste du côté de tado).
Scènes
- Présence modifiée : la maison est passée Maison → Absent ou Absent → Maison, par géolocalisation ou changement manuel. Baisser les lumières, armer l'alarme.
- Fenêtre ouverte détectée : tado a mis en pause le chauffage d'une zone parce qu'une fenêtre est ouverte. Envoyer une notification.
- Chauffe démarrée / arrêtée : la puissance de chauffe est passée au-dessus de zéro ou revenue à zéro. Piloter un circulateur, compter les heures de chauffe.
- Batterie faible : un thermostat ou une tête de la zone signale une batterie faible.
Les actions régler une température et retour à la programmation
renvoient les valeurs de la zone ; lire une zone les donne pour une
condition qui suit (temperature, heating, open_window…). Les actions
suivantes de la scène les trouvent dans leur liste de variables (écrites
{{<étape>.<action>.<clé>}}, par exemple {{0.0.temperature}} quand cette
action est la première de la scène).
La limite quotidienne de requêtes de tado
tado limite le nombre de requêtes de chaque compte par jour : 100 par jour sur un compte gratuit, 20 000 avec un abonnement Auto-Assist ou AI-Assist. Le compteur repart à zéro vers 12 h (heure de Berlin). Toutes les requêtes comptent, y compris celles des autres applications et intégrations qui utilisent le même compte.
L'intégration lit le budget restant que tado renvoie et règle son rythme :
- elle garde environ un cinquième du quota (20 requêtes sur un compte gratuit) pour vos commandes (consignes depuis un widget ou une scène), qui ne sont jamais retardées ;
- elle répartit le reste du budget sur la journée : sur un compte gratuit avec une maison, une lecture environ toutes les 40 minutes (environ une heure avec les capteurs de présence des téléphones) ; la météo toutes les 3 heures, la liste des piles deux fois par jour ;
- avec un abonnement, l'option Intervalle de rafraîchissement s'applique telle quelle (2 minutes par défaut), la météo toutes les 15 minutes.
Si le quota est malgré tout épuisé (une autre application sur le même compte, beaucoup de commandes), l'état indique « Quota quotidien de l'API tado° épuisé » avec l'heure de reprise des lectures ; les commandes échouent avec un message clair jusqu'à la remise à zéro de tado, puis tout reprend tout seul. Quand tado demande seulement de ralentir un moment, l'état l'indique (« pour le moment ») et les lectures reprennent après quelques minutes ; une remise à zéro de tado un peu après midi est elle aussi repérée en quelques minutes. Enregistrer la configuration ou redémarrer Gladys ne consomme pas de requêtes : les lectures gardent leur rythme. Si tado est injoignable (réseau coupé), l'intégration réessaie après l'intervalle de rafraîchissement, puis de moins en moins souvent (au plus toutes les 30 minutes).
Confidentialité
L'intégration ne parle qu'aux serveurs de tado (login.tado.com,
my.tado.com, hops.tado.com). Les capteurs de présence des téléphones
sont désactivés par défaut : ils exposent où se trouvent les membres du
foyer.
Dépannage
- « tado° a refusé la session enregistrée » : la session a expiré (30 jours sans usage) ou a été révoquée dans l'application tado. Cliquez à nouveau sur Lier mon compte tado°.
- L'état dit « en attente de votre approbation » : terminez la connexion dans l'onglet ouvert ; le lien est valable 5 minutes.
- Les valeurs bougent lentement : sur un compte tado gratuit, les lectures sont réparties sur la journée à cause de la limite quotidienne de tado (voir plus haut) ; avec un abonnement, tado est lu toutes les 2 minutes par défaut (option Intervalle de rafraîchissement). Après une commande, Gladys affiche aussitôt la valeur demandée ; la maison est relue juste après si le budget le permet, sinon à la lecture suivante. Programmation est toujours suivie d'une lecture : seul tado sait ce que le programme applique.
- Une zone eau chaude n'a pas de consigne : votre installation ne gère que marche/arrêt (tado le signale).
- tado X : construit d'après la documentation publique de l'API hops, sans le matériel ; signalez ce qui ne correspond pas dans le fil du forum.
Paramètres de configuration
Voici les paramètres demandés par tado° dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte tado° | section | Non | Connecteur non officiel, sans lien avec tado. Cliquez sur « Lier mon compte tado° » : une page de connexion tado s'ouvre, approuvez l'accès, et l'intégration découvre vos maisons et zones (thermostats et têtes V3+, V3, V2, eau chaude, climatisation, et pièces tado X). Le lien reste valable tant que l'intégration tourne au moins une fois par mois ; sinon, liez à nouveau le compte. tado est une marque de tado GmbH. |
| Lier mon compte tado° | account_link | Non | Ouvre la page de connexion tado dans un nouvel onglet. Revenez ici une fois l'accès approuvé : l'état ci-dessous passe au vert en quelques secondes. |
| Options | section | Non | Comment se termine une consigne manuelle envoyée depuis Gladys, et à quelle fréquence tado est lu. tado répond depuis le cloud : lire plus vite qu'une fois par minute n'apporte rien. |
| Une consigne manuelle dure | select | Non | |
| Durée fixe (minutes) | number | Non | |
| Intervalle de rafraîchissement (s) | number | Non | Le délai minimal entre deux lectures. tado limite chaque compte à 100 requêtes par jour sans abonnement : l'intégration répartit alors ses lectures sur la journée, l'intervalle réel peut donc être bien plus long (environ 40 minutes pour une maison). |
| Un capteur de présence par téléphone géolocalisé | boolean | Non | Crée un appareil par téléphone dont la géolocalisation tado est active, avec un capteur « à la maison ». Désactivé par défaut : ce sont des données de localisation personnelles. |
Comment installer tado° dans Gladys
- Dans Gladys, ouvrez Intégrations : tado° apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-tado:0.1.2), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-tado.
tado° nécessite Gladys >=5.1.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
tado° 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 LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation