Intégration domotique InComfort (Intergas), gratuite et open source

Chaudières Intergas via la passerelle locale Lan2RF : températures, pression, état, pièces.

• Publiée par LM1LC3N7
• Appareils
• Version 0.1.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Vos chaudières Intergas dans Gladys, par la passerelle locale Lan2RF (InComfort / InTouch) sur votre réseau, sans cloud :

• chaque chaudière liée à la passerelle devient un appareil Gladys : température de l'eau du circuit, pression (bar), température de l'eau chaude sanitaire, brûleur allumé, pompe en marche, production d'eau chaude, défaut (verrouillage), et en texte son état (veille, chauffage, eau chaude…) et son défaut (code E… et libellé) ;
• chaque thermostat de pièce (deux au plus par chaudière) devient un appareil avec la température de la pièce, la consigne et chauffe (brûleur et pompe en marche).

Cette intégration n'a jamais été testée sur une vraie passerelle. Cette première version a été écrite à partir de la bibliothèque incomfort-client et de l'intégration incomfort de Home Assistant, et testée seulement contre une fausse passerelle. Dites sur le forum de Gladys ce qui marche et ce qui ne marche pas.

Intégration non officielle, sans lien avec Intergas.

Configuration

• Adresse de la passerelle : son adresse IP sur votre réseau (192.168.1.20) ; un port peut suivre (192.168.1.20:80). Préférez l'adresse IP : un nom en .local (mDNS) ne se résout pas dans le conteneur de l'intégration. Donnez-lui une adresse fixe dans votre box. La passerelle ne parle qu'en http simple : une adresse https:// est refusée avec un message clair.
• Identifiant et mot de passe : laissez-les vides pour une ancienne passerelle. Les passerelles récentes demandent ceux inscrits sur leur étiquette ou dans leur notice ; Gladys utilise alors les pages /protect/ de la passerelle. Le mot de passe est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à la passerelle, dans l'en-tête HTTP d'authentification (jamais dans une adresse, jamais dans un journal). Attention : la passerelle n'a pas de https, l'identifiant et le mot de passe traversent donc votre réseau local en clair, à chaque lecture.
• Autoriser le changement de la consigne de pièce : désactivé par défaut (voir Commande).
• Langue des appareils : français (par défaut) ou anglais, pour les noms des appareils et les textes d'état et de défaut.

Ouvrez ensuite l'onglet Découverte et créez les chaudières et les thermostats à suivre. Le bouton Tester la connexion lit la passerelle tout de suite et liste ce qu'elle voit.

Commande

• Seule la consigne de pièce peut être changée, et seulement après avoir coché Autoriser le changement de la consigne de pièce. Une fois l'option cochée, le tableau de bord, les scènes, les assistants vocaux (Siri / HomeKit…) et le service Thermostat de Gladys peuvent changer la consigne, de 5 à 30 °C. Rien n'allume ni n'éteint la chaudière et rien ne touche l'eau chaude : aucune fonctionnalité n'est un interrupteur, donc « éteins tout » ne peut pas agir sur la chaudière.
• La consigne va de 5 à 30 °C (les bornes de la passerelle), au dixième de degré : une valeur en dehors est refusée, jamais ramenée dans les bornes.
• Juste avant d'agir, Gladys relit la liste des chaudières et la chaudière elle-même : si la lecture échoue, si la chaudière n'est plus liée ou si le thermostat ne répond plus, rien n'est envoyé ; si le thermostat est déjà à cette consigne (et qu'aucune autre consigne à distance n'est en attente), rien n'est envoyé non plus. Quand la commande ne peut pas être vérifiée en 3,5 s, rien n'est envoyé et Gladys affiche un échec (jamais d'action après un échec affiché). Une fois envoyée, Gladys répond au plus 4,3 s après votre commande ; la consigne affichée suit la réponse de la passerelle.
• Les commandes passent une par une (une seule passerelle).
• La consigne affichée est, comme dans Home Assistant, la consigne envoyée à distance quand il y en a une, sinon celle du thermostat. Le thermostat reçoit la consigne par radio : elle peut mettre un moment à s'y afficher. Certains anciens thermostats gardent la consigne envoyée à distance même après un réglage à la main : la consigne affichée dans Gladys peut alors rester l'ancienne.

Rafraîchissement et limites

• La passerelle est lue toutes les 30 secondes : la liste des chaudières, puis chaque chaudière (ses thermostats viennent avec). Les états ont donc jusqu'à 30 secondes de retard. Seules les valeurs qui changent sont envoyées à Gladys (et chacune au moins toutes les 30 minutes).
• Une chaudière qui ne répond pas ne rend injoignables que ses propres appareils ; les autres continuent.
• Les températures de l'eau (circuit, eau chaude) sont des sondes : Gladys ne les compte pas dans la température de la pièce où se trouve la chaudière.
• Une passerelle Lan2RF gère 8 chaudières au plus, 2 thermostats de pièce par chaudière. Un thermostat n'apparaît que quand la passerelle en donne une température valide.
• Les chaudières sont reconnues par leur numéro de série (celui que la passerelle liste), pas par leur position dans la liste : une chaudière qui change de place garde son appareil, son historique et ses scènes.

Problèmes de connexion

• Passerelle injoignable : tous les appareils apparaissent injoignables ; nouvel essai après 30 s, puis de plus en plus rarement jusqu'à toutes les 10 min (jamais plus vite que la lecture normale).
• Identifiants demandés ou refusés (HTTP 401) : Gladys ne réessaie pas seul, même après une reconnexion à Gladys. Corrigez l'identifiant et le mot de passe puis enregistrez, ou appuyez sur Tester la connexion. Un redémarrage de l'intégration fait un seul nouvel essai.
• HTTP 404 avec un identifiant : la passerelle est ancienne et n'a pas de pages protégées : videz l'identifiant et le mot de passe.
• Passerelle surchargée (HTTP 429) : toutes les requêtes s'arrêtent de 1 minute à 6 heures ; enregistrer la configuration ou appuyer sur Tester la connexion lève la pause.
• Les journaux ne contiennent ni le mot de passe ni le texte des réponses de la passerelle, seulement des codes (HTTP 500, pas de connexion…).

Limites

• Une seule passerelle par intégration.
• Pas de commande d'eau chaude ni de mode de la chaudière : la passerelle ne les propose pas, et l'eau chaude est volontairement en lecture seule.
• Ni la force du signal radio ni le numéro de nœud ne sont publiés.
• Jamais testée sur une vraie passerelle, ni avec des identifiants réels.

Paramètres de configuration

Voici les paramètres demandés par InComfort (Intergas) dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Fonctionnement	section	Non	Gladys lit vos chaudières Intergas toutes les 30 secondes par la passerelle Lan2RF (InComfort), sur votre réseau local, sans cloud. Chaque chaudière devient un appareil Gladys (onglet Découverte) : température de l'eau du circuit, pression, température de l'eau chaude, brûleur, pompe, eau chaude, défaut, état ; chaque thermostat de pièce devient un appareil avec sa température et sa consigne. Intégration non officielle, sans lien avec Intergas. Jamais testée sur une vraie passerelle : voir la documentation.
Adresse de la passerelle	string	Oui	L'adresse IP (ou le nom) de la passerelle Lan2RF sur votre réseau. Donnez-lui une adresse fixe dans votre box. En http simple : la passerelle n'a pas de https.
Identifiants (passerelles récentes)	section	Non	Les anciennes passerelles répondent sans identifiants : laissez les deux champs vides. Les récentes demandent un identifiant et un mot de passe (ceux de la passerelle, voir son étiquette ou sa notice). Ils partent vers la passerelle dans un en-tête HTTP, en clair sur votre réseau local (la passerelle n'a pas de https).
Identifiant (facultatif)	string	Non
Mot de passe (facultatif)	secret	Non	Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à la passerelle.
Options	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, les assistants vocaux (Siri / HomeKit…) et le service Thermostat de Gladys peuvent changer la consigne des thermostats de pièce, de 5 à 30 °C. Rien n'allume ni n'éteint jamais la chaudière, et l'eau chaude n'est jamais commandée.
Autoriser le changement de la consigne de pièce	boolean	Non
Langue des appareils	select	Non	Noms des appareils et des fonctionnalités, textes d'état et de défaut.

Comment installer InComfort (Intergas) dans Gladys

1. Dans Gladys, ouvrez Intégrations : InComfort (Intergas) 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-incomfort: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-incomfort.

InComfort (Intergas) 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

InComfort (Intergas) 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

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 🙂