Aller au contenu principal

Intégration domotique Lennox S30, gratuite et open source

Intégration Lennox S30 pour Gladys Assistant

Thermostats Lennox S30, E30 et M30 par leur API locale : zones, consignes, modes, alertes.

Voir sur GitHubToutes les intégrations

Cette intégration affiche votre thermostat Lennox S30, E30 ou M30 (iComfort) dans Gladys par son API locale, sans le cloud Lennox ni l'application Lennox. Elle s'appuie sur ce que fait la bibliothèque lennoxs30api (intégration Home Assistant), pour sa partie locale seulement.

Jamais testé avec un vrai thermostat : tout a été vérifié sur un thermostat simulé, construit d'après la bibliothèque lennoxs30api et ses captures. Sans lien avec Lennox.

Préparer le thermostat​

  1. Sur le thermostat : Paramètres, Paramètres avancés, activez Home Automation (l'API locale).
  2. Donnez au thermostat une adresse IP fixe dans votre box.
  3. Dans Gladys, saisissez cette adresse dans la configuration de l'intégration, enregistrez.
  4. Ajoutez les appareils depuis l'onglet Découverte.

Le thermostat est joint en HTTPS. Son certificat est autosigné : il est épinglé au premier contact (son empreinte est gardée dans /data) et vérifié à chaque connexion, avant tout envoi. S'il change (thermostat remplacé ou mis à jour), rien n'est plus envoyé et l'état le dit : le bouton Faire confiance au nouveau certificat (deux clics, 3 à 60 s d'écart) épingle exactement l'empreinte affichée.

L'API locale ne demande aucun identifiant : l'intégration n'en garde aucun.

Appareils​

  • Une zone (une par zone utilisée) : température, humidité, mode (arrêt, chauffage, climatisation, les deux), consigne de chauffage, consigne de climatisation, fonctionnement (au repos, chauffe, climatise), mode du ventilateur (automatique, marche, brassage), ventilateur en marche.
  • Le système : température extérieure, niveau d'alerte, nombre d'alertes actives, texte des alertes actives.

Les températures sont dans l'unité affichée par le thermostat (°F ou °C) au moment où l'appareil est ajouté. Une mesure en °F est convertie exactement en °C (puis au dixième). Une mesure dont le thermostat dit qu'elle n'est pas disponible n'est pas publiée. Le mode « chauffage d'urgence » s'affiche comme « chauffage ».

Commandes​

Le mode Arrêt​

Le mode Arrêt d'une zone ne demande aucune option : il part même avec l'option des commandes désactivée. Il écrit « arrêt » dans le programme manuel de la zone, puis fait suivre ce programme à la zone (comme lennoxs30api) : rien ne démarre entre les deux. Il passe devant une lecture ou une commande en cours, et part pendant une pause demandée par le thermostat, avant la première lecture après un redémarrage, sans configuration lue (d'après /data), même si /data ne peut pas être écrit.

Il est refusé seulement :

  • sans adresse du thermostat (ni valable dans la configuration, ni dans /data) ;
  • quand /data ne peut pas être lu (le certificat épinglé est alors inconnu) ;
  • pour un appareil d'un autre thermostat que celui qui répond à l'adresse.

Tant que le thermostat n'est pas lu à l'arrêt, l'arrêt est gardé dans /data, sans limite de durée :

  • pas encore parti (thermostat injoignable, certificat changé) : renvoyé toutes les 30 secondes et au redémarrage ; après un 429 ou un 5xx répondu à l'arrêt, après le Retry-After demandé (5 minutes au plus) ; cela ne compte pas comme un essai ;
  • refusé par le thermostat (un 4xx, une réponse autre que « code 1 ») : après un 4xx, une nouvelle session et un renvoi aussitôt ; puis renvoyé 5 minutes plus tard, abandonné après trois refus de suite ;
  • accepté : relu 6 secondes après puis toutes les 30 secondes, pause ou non, et renvoyé si une lecture montre la zone en marche 5 secondes ou plus après l'envoi ; abandonné après trois envois acceptés jamais lus à l'arrêt.

Il prend fin quand une lecture montre la zone à l'arrêt après le clic (même si la zone est relancée au thermostat juste après : une relance au thermostat ou dans l'application Lennox n'est pas combattue), quand un autre mode de la zone, cliqué après lui depuis Gladys (avec l'option), est parti sans être refusé (un mode refusé par un 4xx, une autre réponse que « code 1 » ou un 429, redirigé (3xx), ou jamais parti, laisse l'arrêt gardé), ou si un autre thermostat répond à l'adresse (dit dans l'état). Un arrêt accepté avant un redémarrage du module n'est terminé que si deux lectures, à au moins un intervalle d'écart, montrent la zone dans un autre mode que celui d'avant le clic (changé au thermostat), ce que l'état dit ; dans le même mode qu'au clic, ou si ce mode n'était pas connu, il est renvoyé (dans le doute, l'arrêt part), même si la zone a été relancée au thermostat dans ce mode pendant le redémarrage. Une nouvelle adresse saisie garde les arrêts : ils partent dès que la nouvelle adresse montre le numéro de série du même thermostat. Un abandon est dit dans l'état, le badge de l'appareil et la réponse, jusqu'à une lecture de la zone à l'arrêt ou un nouveau clic. En mode absence, l'arrêt vise le programme manuel comme lennoxs30api, alors que le thermostat suit le programme d'absence : il risque d'être abandonné après trois envois (non vérifié sur un vrai thermostat).

Les autres commandes (option « Autoriser les commandes »)​

Désactivées par défaut. Activées : le mode (chauffage, climatisation, les deux), les consignes de chauffage et de climatisation et le mode du ventilateur.

  • Décidées sur la file du thermostat vidée juste après le clic ; refusées si une valeur nécessaire n'a pas été lue, en mode absence, pendant un arrêt en cours de la zone (sauf un mode, qui y met fin) et tant que la commande précédente de la zone n'est pas visible (90 s au plus). En mode consigne unique, les consignes sont refusées.
  • Les consignes sont arrondies au pas du thermostat (1 °F, 0,5 °C), l'autre unité est calculée exactement, et les deux valeurs doivent rester dans les limites de la zone lues sur le thermostat et dans les nôtres (chauffage 40 à 90 °F, climatisation 60 à 99 °F). Si la consigne de chauffage dépasserait la consigne de climatisation moins l'écart de la zone, l'autre consigne s'écarte dans le sens sûr (climatisation vers le haut, chauffage vers le bas), dans ses limites, sinon la commande est refusée.
  • Une zone qui suit un programme reçoit une dérogation (copie de la période en cours, puis maintien jusqu'à la période suivante), comme dans l'application Lennox. Un changement de mode fait suivre le programme manuel à la zone.
  • Une commande part dans les 3,5 s après le clic ou est refusée sans rien envoyer ; elle n'est un succès que si une lecture après l'envoi montre la valeur demandée. Sinon : « envoyée, sans confirmation » et relectures à 5 et 20 s.

Configuration​

ChampRôle
Adresse IP du thermostatIPv4 ou nom d'hôte, port 443 par défaut.
Autoriser les commandesDésactivé par défaut (voir plus haut).
Intervalle de rafraîchissement5 à 300 s (10 s par défaut) : lecture des changements mis en file.
LangueNoms des fonctionnalités, textes d'état, erreurs.

Tout est redemandé au thermostat toutes les 10 minutes. Un thermostat qui demande de ralentir (429) ou répond par une erreur serveur (5xx) met en pause les lectures et les commandes (1 minute à 6 heures), pas l'arrêt.

Limites connues​

  • Non vérifié sur un vrai thermostat ; le comportement en mode absence, en mode zoné central et la durée de l'attente de la file (LongPollingTimeout=1) viennent de lennoxs30api.
  • Le S40 n'est pas pris en charge (son identité diffère).
  • Pas de programmes, d'humidification ni de ventilation dans cette version.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre thermostat LennoxsectionNonAffiche votre thermostat Lennox S30, E30 ou M30 dans Gladys par son API locale, sans le cloud Lennox : un appareil par zone (température, humidité, mode, consignes de chauffage et de climatisation, fonctionnement, ventilateur) et un pour le système (température extérieure, alertes). Sur le thermostat, activez « Home Automation » (Paramètres, Paramètres avancés), donnez-lui une adresse fixe dans votre box, saisissez cette adresse ci-dessous, enregistrez, puis ajoutez les appareils depuis l'onglet Découverte. Le mode Arrêt ne demande aucune option ; les autres modes, les consignes et le mode du ventilateur seulement si vous les autorisez ci-dessous. Jamais testé avec un vrai thermostat. Sans lien avec Lennox.
Adresse IP du thermostatstringOuiUne adresse IPv4 ou un nom d'hôte, éventuellement suivi d'un port (443 par défaut). Le thermostat est joint en HTTPS ; son certificat est épinglé au premier contact.
Autoriser les commandesbooleanNonDésactivé par défaut. Activé : Gladys peut régler le mode d'une zone (chauffage, climatisation, les deux), ses consignes de chauffage et de climatisation (dans les limites que donne le thermostat) et le mode de son ventilateur. Désactivé : ces commandes sont refusées. Le mode Arrêt ne demande aucune option : il arrête le chauffage et la climatisation de la zone jusqu'à ce qu'un autre mode soit réglé (depuis Gladys avec cette option activée, depuis le thermostat ou l'application Lennox ; un arrêt accepté juste avant un redémarrage de l'intégration et pas encore lu est renvoyé si la zone tourne encore dans le mode d'avant).
Intervalle de rafraîchissement (s)numberNonFréquence de lecture des changements mis en file par le thermostat, en secondes.
Langue des noms des fonctionnalitésselectNonSert aux noms des fonctionnalités des appareils ajoutés désormais, aux textes d'état et aux erreurs des commandes.

Comment installer Lennox S30 dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Lennox S30 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-lennox-s30: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-lennox-s30.

Lennox S30 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​

Lennox S30 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