Intégration domotique Nexia / Trane / Am. Standard, gratuite et open source
Thermostats Trane Nexia, Trane Home et American Standard Home : zones, consignes, modes.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Les thermostats de Trane Technologies (série Trane XL, American Standard Gold / Platinum, UX360…) dans Gladys, par le cloud de leur application : Nexia (mynexia.com), Trane Home (tranehome.com) ou American Standard Home (asairhome.com, appelée aussi Asair).
Intégration non officielle, sans lien avec Trane Technologies. Elle utilise l’API non officielle de l’application mobile (celle de la bibliothèque nexia et de Home Assistant), qui peut changer sans prévenir. Elle n’a jamais été testée avec un vrai compte : seulement avec les réponses enregistrées par la bibliothèque nexia. Merci de signaler ce que vous observez.
Configuration
- Marque (application) : l’application où vous vous connectez. Les trois sont le même cloud sous trois adresses.
- Adresse e-mail et mot de passe de ce compte. Le mot de passe est gardé par Gladys dans sa base (non chiffré, jamais réaffiché) et envoyé seulement au cloud de la marque choisie.
- Enregistrez. L’état indique combien de thermostats et de zones ont été trouvés ; les appareils sont dans l’onglet Découverte.
Tester la connexion se reconnecte et liste thermostats et zones.
Mot de passe refusé
Plusieurs mauvais mots de passe de suite peuvent bloquer le compte. Quand le cloud refuse l’e-mail ou le mot de passe, Gladys s’arrête ; il ne réessaie seul que deux fois, 6 heures puis 24 heures plus tard (même après un redémarrage), puis vous attend : corrigez le mot de passe et enregistrez, ou appuyez sur Tester la connexion.
Appareils
Un appareil par thermostat (le système) :
- humidité intérieure (%) ;
- température extérieure, si le système a une sonde (tenue à l’écart de la température de la pièce dans Gladys) ;
- état du système (texte du cloud : « Cooling », « System Idle »…) ;
- ventilation (auto, marche, circulation : les choix du thermostat) ;
- consignes d’humidification / de déshumidification (%), si un humidificateur ou un déshumidificateur est installé (lecture seule).
Un appareil par zone (un système sans zones a une zone, au nom du thermostat) :
- température ;
- consigne de chauffage et consigne de refroidissement ;
- mode : arrêt, chauffage, refroidissement, auto (le chauffage de secours apparaît comme chauffage) ;
- fonctionnement : au repos, chauffe, refroidit ;
- programme ou maintien (texte du cloud).
Les températures sont dans l’unité du compte (°F ou °C) à la création de l’appareil ; Gladys les convertit si le compte change d’unité ensuite.
Les valeurs sont lues toutes les deux minutes (le cloud répond le plus souvent « rien de nouveau », ce qui ne coûte presque rien). Un thermostat que le cloud signale hors ligne apparaît injoignable, et ses valeurs ne sont pas publiées.
Commandes (désactivées par défaut)
Par défaut Gladys ne fait que lire. Cochez Autoriser les commandes pour que le tableau de bord, les scènes, HomeKit (le seul assistant vocal de Gladys qui atteint un thermostat) et le service Thermostat de Gladys puissent changer :
- les consignes de chauffage et de refroidissement d’une zone. Une valeur est d’abord vérifiée (40 à 99 °F, ou 4,5 à 37 °C, dans l’unité de la fonctionnalité Gladys) : hors de ces bornes elle est refusée, jamais ajustée. Elle est ensuite arrondie comme dans l’application (1 °F, 0,5 °C) et vérifiée contre les limites du thermostat ; l’autre consigne se décale pour garder l’écart que demande le thermostat (la « zone morte »), comme dans l’application. Un thermostat qui n’indique pas de zone morte refuse les commandes de consigne ;
- le mode d’une zone (arrêt, chauffage, refroidissement, auto). Arrêt coupe le chauffage et le refroidissement, sans hors-gel, et peut venir de HomeKit (« éteins le thermostat ») ou du service Thermostat de Gladys, pas seulement de vous ;
- la ventilation.
Avant chaque commande, Gladys relit le thermostat : s’il est hors ligne, si la zone a disparu ou si la valeur est déjà la bonne, rien n’est envoyé. Une commande à la fois : un cloud lent peut mettre jusqu’à 20 secondes ; Gladys affiche la commande comme envoyée au bout de 4 secondes, et une commande arrivée entre-temps est refusée tout de suite (réessayez quelques secondes plus tard). Une connexion coupée pendant une commande est signalée comme « n’a peut-être pas atteint le cloud », et le thermostat est relu. Il n’y a jamais d’interrupteur pour couper le chauffage : « tout éteindre » dans Gladys ne touche pas aux thermostats.
Une consigne changée ainsi peut ne tenir que jusqu’au prochain créneau du programme du thermostat, comme dans l’application.
Limites
- HTTP 429 (trop de requêtes) : toutes les requêtes attendent (2 minutes à 6 heures), même après un redémarrage.
- Cloud injoignable : nouvel essai après 2 minutes, puis de moins en moins souvent (jusqu’à 30 minutes).
- Seulement la première maison du compte.
- Pas encore : préréglages (maison, absent, nuit), reprise du programme, chauffage de secours, commandes des consignes d’humidité, purificateur d’air, capteurs RoomIQ.
Vie privée
L’adresse e-mail et le mot de passe ne partent que vers le cloud de la marque
choisie. La clé de session reste en mémoire. Le dossier /data du conteneur
ne contient qu’un identifiant aléatoire de cette installation (l’application
en envoie un), la fin d’une pause 429 et l’état d’un refus (une empreinte de
la marque et de l’e-mail, jamais le mot de passe). Si /data n’est pas
inscriptible, cet identifiant change à chaque redémarrage, et le compte peut
lister un « téléphone » de plus à chaque fois (supprimables dans
l’application).
Paramètres de configuration
Voici les paramètres demandés par Nexia / Trane / Am. Standard dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Gladys lit les thermostats de votre compte toutes les deux minutes dans le cloud de l'application (Nexia, Trane Home ou American Standard Home). Chaque thermostat devient un appareil Gladys (onglet Découverte) avec son humidité, sa température extérieure, son état et sa ventilation ; chaque zone devient un appareil avec sa température, ses consignes de chauffage et de refroidissement, son mode et son fonctionnement. Intégration non officielle, sans lien avec Trane Technologies : elle utilise l'API non officielle de l'application, et n'a jamais été testée avec un vrai compte (voir la documentation). |
| Marque (application) | select | Oui | L'application où vous vous connectez : le même cloud sous trois noms. |
| Adresse e-mail du compte | string | Oui | |
| Mot de passe du compte | secret | Oui | Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement au cloud de la marque choisie. Plusieurs mauvais mots de passe de suite peuvent bloquer le compte : après un refus, Gladys ne réessaie que deux fois (6 h, puis 24 h plus tard). |
| Commandes | section | Non | Par défaut Gladys ne fait que lire. Une fois l'option ci-dessous cochée, le tableau de bord, les scènes, HomeKit (le seul assistant vocal qui atteint les thermostats) et le service Thermostat de Gladys peuvent changer les consignes de chauffage et de refroidissement, le mode d'une zone (arrêt, chauffage, refroidissement, auto) et la ventilation. Le mode Arrêt coupe le chauffage ET le refroidissement, sans hors-gel, et peut venir de HomeKit (« éteins ») ou du service Thermostat. Les consignes sont vérifiées contre les limites du thermostat ; il n'y a jamais d'interrupteur pour couper le chauffage. |
| Autoriser les commandes | boolean | Non | |
| Langue des appareils | select | Non | Noms des appareils, des fonctionnalités et des options. |
Comment installer Nexia / Trane / Am. Standard dans Gladys
- Dans Gladys, ouvrez Intégrations : Nexia / Trane / Am. Standard 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-nexia:0.1.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). - 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-nexia.
Nexia / Trane / Am. Standard 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
Nexia / Trane / Am. Standard 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