Aller au contenu principal

Intégration domotique Roth Touchline SL, gratuite et open source

Intégration Roth Touchline SL pour Gladys Assistant

Plancher chauffant Roth Touchline SL : pièces, températures, consignes et programmes en option.

Voir sur GitHubToutes les intégrations

Cette intégration affiche les zones (pièces) de votre plancher chauffant Roth Touchline SL dans Gladys, par l'API publique Roth Touchline SL (le cloud qu'utilise l'application Roth Touchline SL), avec l'adresse e-mail et le mot de passe de votre compte Roth.

Jamais testé avec un vrai régulateur ni un vrai compte : elle suit la bibliothèque pytouchlinesl (celle de l'intégration Home Assistant), sans avoir pu être essayée sur une installation réelle. Dites-nous sur le forum si elle fonctionne chez vous. Sans lien avec Roth.

Ce qu'elle fait​

Pour chaque zone allumée de chaque régulateur du compte, un appareil « Nom de la pièce (Touchline SL) » avec :

  • température et humidité de la pièce ;
  • consigne (thermostat) ;
  • chauffe en cours (repos, chauffe ou rafraîchissement, en lecture seule) ;
  • programme (liste : température constante ou l'un des programmes du régulateur) et mode lu (« Programme « Salon » », « Température constante », « Consigne temporaire »…) ;
  • état de la zone (OK, capteur endommagé, pas de communication…) ;
  • fenêtre ouverte (si des capteurs de fenêtre sont reliés), batterie du thermostat d'ambiance.

Les zones éteintes dans le régulateur ne sont pas proposées.

Installation​

  1. Installez l'intégration depuis le store de Gladys.
  2. Saisissez l'adresse e-mail et le mot de passe de votre compte Roth Touchline SL, puis enregistrez. Le mot de passe est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Roth (roth-touchlinesl.com, en https).
  3. Ouvrez l'onglet Découverte et ajoutez les zones voulues.

Le bouton Tester la connexion lit Roth une fois et affiche son état.

Commandes (désactivées par défaut)​

Par défaut, Gladys ne fait que lire. Deux options séparées :

  • Autoriser les commandes de consigne : le tableau de bord, les scènes et les assistants vocaux peuvent changer la consigne d'une zone. La zone passe alors en température constante (elle quitte son programme, comme dans l'application Roth).
  • Autoriser les commandes de programme : la liste « Programme » peut mettre une zone sur l'un des programmes du régulateur, ou en température constante (avec la consigne qu'elle a).

Bornes de sécurité :

  • une consigne va de 5 °C au plafond des consignes, 24 °C par défaut, réglable de 16 à 30 °C, jamais plus de 30 °C ;
  • un programme n'est choisi que si toutes ses températures restent dans ces bornes (sinon la commande est refusée) ;
  • le plafond est revérifié juste avant l'envoi : s'il a été baissé pendant la commande, rien ne part ;
  • un programme mal lu (intervalle à moitié vide, zone au mode illisible) n'est jamais renvoyé ;
  • une zone en rafraîchissement, éteinte ou inconnue n'est jamais commandée ;
  • une zone sur son propre programme ou en consigne temporaire peut être mise sur un programme depuis la liste (la liste affiche alors le dernier programme lu, le mode lu dit la vérité) ;
  • aucune commande ne passe par un interrupteur : un « éteins tout » d'un assistant vocal ne touche jamais le chauffage. L'API de Roth n'a pas de commande d'arrêt du chauffage.

Chaque commande relit la zone juste avant d'agir et décide sur cette lecture ; elle part dans les 3,5 s ou est refusée sans rien envoyer. Si Roth ne répond pas à temps après l'envoi, Gladys affiche « envoyée, sans confirmation » et relit la zone 5 s et 20 s plus tard. Une commande à la fois. Pour choisir un programme, Roth demande de renvoyer le programme entier : l'intégration le renvoie tel qu'elle vient de le lire, sans rien y changer.

Limites et sécurité​

  • Lecture toutes les 60 s (de 30 s à 10 min).
  • Identifiants refusés : arrêt gardé dans /data, nouvel essai après 15 min, 1 h, 6 h puis toutes les 24 h, jamais en boucle ; enregistrer d'autres identifiants ou presser « Tester la connexion » réessaie.
  • Jeton de Roth refusé : une seule nouvelle connexion, jamais deux connexions en moins d'une minute (même après un redémarrage) ; un jeton refusé juste après une connexion, ou trois renouvellements sans aucune lecture réussie, donnent l'arrêt ci-dessus.
  • Roth occupé (HTTP 429) ou en panne (5xx) : pause de 1 min à 6 h, gardée dans /data, pour les lectures comme pour les commandes.
  • /data ne contient jamais l'adresse e-mail, le mot de passe ni le jeton.
  • Une commande ne se connecte jamais à Roth elle-même : si le jeton vient d'être refusé, elle répond « réessayez dans une minute ».

Crédits​

L'API de Roth et la forme de ses réponses viennent de pytouchlinesl (jnsgruk, Apache-2.0), la bibliothèque de l'intégration Home Assistant. Voir THIRD_PARTY_NOTICES.md.

Paramètres de configuration​

Voici les paramètres demandés par Roth Touchline SL dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre compte Roth Touchline SLsectionNonAffiche chaque zone (pièce) de votre plancher chauffant Roth Touchline SL dans Gladys, par l'API publique Roth Touchline SL (le cloud de l'application Roth) : température, humidité, consigne, chauffe en cours, programme, batterie du thermostat d'ambiance. Saisissez l'adresse e-mail et le mot de passe de votre compte Roth Touchline SL, enregistrez, puis ajoutez les zones depuis l'onglet Découverte. Jamais testé avec un vrai régulateur ni un vrai compte. Sans lien avec Roth.
Adresse e-mail du compte RothstringOui
Mot de passe du compte RothsecretOuiGardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Roth (roth-touchlinesl.com, en https).
CommandessectionNonPar défaut Gladys ne fait que lire. Chaque type de commande a sa propre option. Une fois autorisés, le tableau de bord, les scènes et les assistants vocaux peuvent changer la consigne d'une zone (de 5 °C au plafond ci-dessous) ou mettre une zone sur l'un des programmes du régulateur (seulement un programme dont toutes les températures restent dans les mêmes bornes). Une zone en rafraîchissement n'est jamais commandée.
Autoriser les commandes de consignebooleanNonDésactivé par défaut. Désactivé : toute commande de consigne est refusée. Une consigne met la zone en température constante (elle quitte son programme).
Autoriser les commandes de programmebooleanNonDésactivé par défaut. Désactivé : tout changement de programme est refusé.
Plafond des consignes (°C)numberNonGladys ne règle jamais une zone au-dessus de cette température, ni ne la met sur un programme qui la dépasse. 24 °C par défaut, de 16 à 30 °C (jamais plus de 30 °C, quoi qu'on saisisse).
Intervalle de rafraîchissement (s)numberNonFréquence de lecture de Roth, en secondes.
Langue des noms des fonctionnalitésselectNonSert aux noms des appareils et des fonctionnalités ajoutés désormais, aux textes des modes et aux erreurs des commandes.

Comment installer Roth Touchline SL dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Roth Touchline SL 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/lm1lc3n7/gladys-touchline-sl: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).
  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/LM1LC3N7/gladys-touchline-sl.

Roth Touchline SL 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​

Roth Touchline SL 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.

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 🙂
Dernière mise à jour le