Aller au contenu principal

Intégration domotique STIEBEL ELTRON, gratuite et open source

Intégration STIEBEL ELTRON pour Gladys Assistant

PAC STIEBEL ELTRON par l'ISG, Modbus local : températures, énergie, commandes en option.

Voir sur GitHubToutes les intégrations

Affiche votre pompe à chaleur STIEBEL ELTRON dans Gladys par l'ISG (Internet Service Gateway, « ISG web ») et son interface Modbus TCP : sans cloud, sans compte, directement sur votre réseau.

Module jamais testé avec une vraie ISG. Sans lien avec STIEBEL ELTRON. Il lit les registres Modbus de l'ISG comme la bibliothèque pystiebeleltron (utilisée par Home Assistant).

Sécurité : Modbus n'a ni mot de passe ni chiffrement. Toute machine de votre réseau peut lire l'ISG et changer les réglages de la pompe à chaleur. Gardez l'ISG sur un réseau de confiance (jamais exposée sur Internet, idéalement sur un réseau séparé pour les objets connectés).

Régulateurs pris en charge​

L'intégration lit l'identification du régulateur et choisit ses registres :

  • WPM : WPM 3, WPM 3i, WPMsystem (pompes WPL, WPF, WPE…) ;
  • LWZ / LWA : centrales double flux LWZ 304/404/504, LWZ x04 SOL ;
  • LWZ R290 (THZ avec ISG Connect) : il sert les registres des WPM et il est lu comme un WPM (modes, consignes et adresses WPM).

Un autre régulateur est nommé dans l'écran de configuration (« Régulateur inconnu ») et relu toutes les 30 minutes.

Ce que vous obtenez​

Un appareil « Pompe à chaleur STIEBEL ELTRON ». Chaque fonctionnalité n'apparaît que si l'ISG en donne la valeur :

FonctionnalitéContenu
Mode de fonctionnementListe (commandes autorisées seulement), voir plus bas
Mode de fonctionnement (lu)Texte : le mode réel, y compris secours et manuel
Consigne de chauffage (confort)Thermostat, circuit 1, en °C (commande)
Consigne de chauffage (éco)En °C, lecture seule (WPM : éco ; LWZ : nuit)
Consigne d'eau chaude (confort)Chauffe-eau, en °C (commande, plafonnée)
Consigne d'eau chaude (éco)En °C, lecture seule (WPM : éco ; LWZ : nuit)
Consigne d'eau chaude en coursEn °C, la consigne que le régulateur applique maintenant
TempératuresExtérieure, départ, retour, eau chaude, pièce (FE7, FEK, FET ou LWZ), en °C
Humidité de la pièceEn % (commande à distance FEK, LWZ)
Compresseur en marche0 ou 1
Chauffage d'appoint en marche0 ou 1 (résistance électrique, « NHZ »)
Défaut0 ou 1
Électricité consommée, chaleur produiteEn kWh, aujourd'hui et total, chauffage et eau chaude ; chaleur de l'appoint

Les températures d'eau, la température extérieure et les consignes sont des « sondes » : elles ne comptent pas comme température de la pièce dans Gladys. Lecture toutes les 30 secondes par défaut (de 10 s à 10 min, réglable).

Énergie : de simples valeurs, pas un compteur facturé​

L'ISG donne, pour le chauffage et l'eau chaude, un compteur du jour et un total. D'après la documentation, le total n'inclut pas le jour et se met à jour vers minuit ; rien ne garantit qu'il ne fasse jamais un saut ou un retour en arrière. Gladys compterait chaque hausse d'un index comme une consommation facturée : ces valeurs sont donc publiées comme de simples capteurs (l'unité est dans leur nom), jamais comme un index d'énergie. Elles n'apparaissent pas dans le suivi de consommation de Gladys.

Installation​

  1. Faites activer le module Modbus de votre ISG (le support STIEBEL ELTRON le fait, souvent gratuitement).
  2. Donnez à l'ISG une adresse IP fixe dans votre box internet ou routeur.
  3. Installez l'intégration depuis le store de Gladys.
  4. Dans sa configuration, saisissez l'adresse IP de l'ISG (port 502 par défaut ; ajoutez :port s'il est différent).
  5. Enregistrez, puis ajoutez la pompe à chaleur depuis l'onglet Découverte.

Le bouton Tester la connexion lit l'ISG une fois (au plus toutes les 10 secondes).

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

Tant que l'option Autoriser les commandes est désactivée, toute commande est refusée. Activée, Gladys peut changer :

  • le mode de fonctionnement : WPM : programme (automatique), confort, éco, eau chaude seule, veille ; LWZ : automatique, jour, réduit (nuit), eau chaude seule, veille ;
  • la consigne de chauffage (confort) du circuit 1 : de 5 à 30 °C (WPM) ou de 10 à 30 °C (LWZ), au dixième de degré ;
  • la consigne d'eau chaude (confort) : en degrés entiers, de 10 °C jusqu'au plafond.

Plafond de l'eau chaude : 55 °C par défaut​

Une eau à 60 °C brûle en quelques secondes. Gladys ne règle donc jamais l'eau chaude au-dessus de 55 °C par défaut. Le réglage Plafond de l'eau chaude le change de 40 à 60 °C ; il n'est jamais possible de dépasser 60 °C, quoi qu'on saisisse (même si certaines LWZ acceptent 65 °C). Une consigne au-dessus du plafond est refusée sans être envoyée, et le plafond est revérifié juste avant l'envoi (un plafond abaissé pendant une commande l'arrête). La consigne éco et le programme anti-légionelles du régulateur ne sont jamais modifiés.

Ce que Gladys ne fait jamais​

  • Choisir le mode secours (réglé par l'installateur quand le compresseur est en panne) ou le mode manuel des LWZ (mode de service).
  • Quitter l'un de ces modes, ou un mode inconnu : la commande est refusée, le régulateur garde la main.
  • Proposer un interrupteur : le mode est une liste, les consignes sont des thermostats ; un « éteins tout » (Gladys, Google Home, Alexa, HomeKit) ne touche pas la pompe à chaleur. Une scène peut changer le mode ou une consigne, seulement par une action explicite et si les commandes sont autorisées. Attention : le chat IA de Gladys (MCP) peut créer et lancer une telle scène.

Quand la pompe à chaleur est en mode secours, manuel ou dans un mode inconnu, la liste garde sa dernière valeur (ces modes n'y figurent pas) : regardez « Mode de fonctionnement (lu) », qui affiche toujours le mode réel.

Comment une commande part​

Avant chaque commande, l'intégration relit les réglages de la pompe à chaleur et décide sur cette lecture seule ; aucune autre requête ne passe entre cette relecture et l'écriture, et l'option (et le plafond) est revérifiée juste avant l'envoi. Une valeur déjà en place n'est pas renvoyée. Une commande qui ne peut pas partir dans les 3,5 secondes est refusée sans être envoyée ; Gladys reçoit la réponse dans ses 5 secondes. L'ISG confirme une écriture en la renvoyant à l'identique ; sans cette confirmation (silence, connexion coupée, réponse différente, erreur Modbus qui ne dit pas que l'écriture a été rejetée), Gladys affiche « Commande envoyée, sans confirmation » : vérifiez la valeur, relue 5 puis 20 secondes plus tard (l'ISG met quelques secondes à l'afficher). Seule une erreur Modbus nette (fonction, adresse ou valeur refusée, ISG occupée) donne « L'ISG a refusé la commande ». Une commande à la fois, et 3 secondes au moins entre deux écritures (sinon « encore en cours »).

Erreurs et limites​

  • ISG injoignable : « Mode de fonctionnement (lu) » affiche « ISG injoignable », l'appareil passe en injoignable, les autres valeurs gardent leur dernière valeur. Nouvel essai après 30 s, 1, 2 puis 5 minutes, jamais plus vite que l'intervalle.
  • Registres absents : un bloc que le régulateur ne sert pas (par exemple l'énergie sur certains modèles) n'est plus demandé jusqu'au redémarrage ; un bloc qui échoue ponctuellement est signalé dans l'écran de configuration, les autres valeurs sont publiées quand même.
  • Un seul ISG par intégration ; l'appareil est identifié par la famille du régulateur (WPM ou LWZ), Modbus ne donnant ni numéro de série ni adresse MAC.
  • Les requêtes Modbus partent une à la fois ; chaque réponse est vérifiée (numéro de transaction, unité, fonction, taille).
  • Pas encore : circuits de chauffage 2 à 5, rafraîchissement, ventilation des LWZ, SG Ready, pompes à chaleur individuelles d'un WPMsystem.
  • Les journaux ne contiennent jamais les valeurs des registres.

Crédits​

Portage de pystiebeleltron (Martin Fuchs et contributeurs, MIT, version 0.9.2), la bibliothèque de l'intégration STIEBEL ELTRON de Home Assistant. Licence Apache-2.0.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre ISGsectionNonAffiche votre pompe à chaleur STIEBEL ELTRON (régulateur WPM 3, WPM 3i, WPMsystem ou LWZ/LWA) dans Gladys par l'interface Modbus TCP de son ISG (Internet Service Gateway), sans cloud : températures, consignes, mode de fonctionnement, compresseur et appoint, énergie. Le module Modbus de l'ISG doit être activé (demandez au support STIEBEL ELTRON). Saisissez l'adresse IP de l'ISG (donnez-lui une adresse fixe dans votre routeur), enregistrez, puis ajoutez la pompe à chaleur depuis l'onglet Découverte. Modbus n'a pas de mot de passe : gardez l'ISG sur un réseau de confiance. Jamais testé avec une vraie ISG. Sans lien avec STIEBEL ELTRON.
Adresse IP de l'ISGstringOuiUne adresse IPv4 ou un nom d'hôte (port Modbus 502 sauf si vous en ajoutez un, par exemple 192.168.1.70:5020).
Autoriser les commandesbooleanNonDésactivé par défaut. Activé : Gladys peut changer le mode de fonctionnement, la consigne de chauffage (confort, circuit 1) et la consigne d'eau chaude (confort), jusqu'au plafond ci-dessous. Désactivé : toute commande est refusée.
Plafond de l'eau chaude (°C)numberNonRisque de brûlure : Gladys ne règle jamais l'eau chaude au-dessus de cette température. 55 °C par défaut, de 40 à 60 °C (jamais plus de 60 °C, quoi qu'on saisisse).
Intervalle de rafraîchissement (s)numberNonFréquence de lecture de l'ISG, en secondes.
Langue des noms des fonctionnalitésselectNonSert aux noms de l'appareil et des fonctionnalités ajoutés désormais, aux textes des modes et aux erreurs des commandes.

Comment installer STIEBEL ELTRON dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : STIEBEL ELTRON 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-stiebel-eltron: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-stiebel-eltron.

STIEBEL ELTRON 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​

STIEBEL ELTRON 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