Intégration domotique Saunier Duval, gratuite et open source

Pilotez votre chaudière Saunier Duval via votre compte MiGo / MiGo Link.
Cette intégration relie votre chaudière Saunier Duval à Gladys Assistant : températures, consignes, modes de chauffage et eau chaude sanitaire deviennent des appareils Gladys, utilisables dans vos scènes et vos graphiques. Elle apporte aussi un widget pour le tableau de bord, des déclencheurs de scène (défaut, passerelle hors ligne) et des actions de scène (forçage temporaire d'une zone).
Elle passe par le cloud Saunier Duval, celui de l'application mobile MiGo / MiGo Link. Il n'existe pas d'accès local à ces chaudières : tout transite par Internet, et votre passerelle doit donc être en ligne.
Ce dont vous avez besoin
- Une chaudière Saunier Duval reliée à une passerelle MiGo ou MiGo Link (ou un thermostat connecté MiPro Sense / Exacontrol relié à une passerelle).
- Le compte que vous utilisez déjà dans l'application mobile : la même adresse e-mail et le même mot de passe.
- Le pays dans lequel ce compte a été créé.
- Gladys Assistant 5.1.0 ou plus récent : le widget et les déclencheurs et actions de scène n'existent pas dans les versions antérieures.
Vous n'avez rien à installer sur la chaudière, ni à demander de clé d'API.
Installation
- Dans Gladys, ouvrez Intégrations → Installer une intégration et installez Saunier Duval.
- Ouvrez l'écran de configuration de l'intégration et renseignez :
- E-mail : l'adresse de votre compte MiGo / MiGo Link ;
- Mot de passe : celui du même compte. Gladys le stocke chiffré et ne le renvoie jamais au navigateur ;
- Pays du compte : celui dans lequel le compte a été créé. C'est important : un compte créé en France ne peut pas se connecter via un autre pays, la connexion serait refusée sans autre explication ;
- Intervalle de rafraîchissement : toutes les combien de secondes la chaudière est interrogée. 300 s (5 minutes) est un bon réglage — une chaudière est un système lent, et la plateforme Saunier Duval limite le nombre d'appels ;
- Durée de forçage par défaut : la durée d'où part chaque zone. Vous la réglez ensuite zone par zone, voir « Changer une température » plus bas.
- Cliquez sur Tester la connexion. Le message vous indique le nombre d'installations trouvées sur votre compte.
- Ouvrez l'onglet Appareils de l'intégration : vos appareils y sont déjà listés. Choisissez ceux que vous souhaitez créer dans Gladys.
Les appareils créés
Pour chaque installation, l'intégration crée :
| Appareil | Ce qu'il expose |
|---|---|
| Chaudière | Température extérieure (instantanée et moyenne 24 h), pression d'eau du circuit de chauffage, activité en cours (chauffage, eau chaude, veille), nombre de codes de défaut et leur détail, bouton Boost ventilation |
| Zone (une par zone de chauffage) | Température ambiante, humidité (si votre thermostat la mesure), consigne de température, mode, durée du forçage, et si le chauffage tourne actuellement |
| Circuit (un par circuit hydraulique) | Température de départ réellement produite, consigne de départ calculée par la loi d'eau, état du circuit |
| Eau chaude | Température de l'eau, consigne, mode, bouton Boost, et si la chaudière est en train de chauffer l'eau |
Les zones portent le nom que vous leur avez donné dans la chaudière (« Salon », « Étage »…). Une zone déclarée inactive dans la chaudière est ignorée : elle ne renvoie aucune valeur.
La pression d'eau est la valeur à surveiller : si elle descend sous ~1 bar, l'installation demande un appoint. Une scène Gladys peut vous prévenir.
Changer une température
La valeur affichée dans le champ « Température de consigne » est celle que vous éditez : la température manuelle, celle que montre l'application Saunier Duval — ou la température du forçage temporaire tant qu'il est en cours.
Ce n'est volontairement pas la « demande du moment » de la chaudière : celle-ci tombe à 0 dès que le chauffage n'a rien à faire (zone programmée hors de ses plages, mode été), et un champ de saisie initialisé à 0 ne servirait à rien.
La chaudière n'a pas une consigne unique : ce qui est écrit dépend du mode dans lequel se trouve la zone.
- Zone en mode programmé (« Auto ») : changer la température déclenche un forçage temporaire. La nouvelle consigne s'applique pendant la durée que vous avez choisie, puis le programme horaire reprend la main. C'est exactement ce que fait l'application mobile quand vous tournez la molette sur une zone programmée : votre programmation n'est jamais écrasée.
- Zone en mode manuel : la consigne est écrite durablement, jusqu'au prochain changement.
- Zone à l'arrêt : la commande est refusée avec un message clair. Changez d'abord le mode de la zone.
Durée du forçage
Chaque zone porte une commande « Durée du forçage », réglable de 30 minutes à 24 heures, comme dans l'application. Vous la réglez avant de changer la température : c'est cette durée que le forçage suivant utilisera.
Elle est exprimée en minutes et non en heures, pour une raison précise : le curseur de Gladys avance par pas d'une unité, donc en heures les demi-heures seraient hors d'atteinte. En minutes, toutes les valeurs de l'application restent accessibles. Une valeur qui ne tombe pas juste est ramenée à la demi-heure la plus proche (100 minutes → 1 h 30), exactement comme le fait la chaudière.
Cette commande ne parle pas à la chaudière : la plateforme n'accepte la durée qu'au moment où le forçage démarre, avec la température. C'est donc un réglage de l'intégration, que Gladys mémorise et qui est relu après un redémarrage. La valeur de départ d'une zone est celle de l'écran de configuration.
Correspondance des modes
| Mode Gladys | Zone de chauffage | Eau chaude |
|---|---|---|
| Arrêt | Arrêt | Arrêt |
| Chauffage | Manuel (ou « Jour » sur les régulateurs MiPro / Exacontrol) | Manuel / « Jour » |
| Auto | Programmé | Programmé |
Ce sont les trois seuls modes proposés, sur la zone de chauffage comme sur l'eau chaude : les mêmes que dans l'application Saunier Duval, et dans le même ordre. Gladys connaît d'autres valeurs — « Refroidissement » pour un thermostat, « Éco », « Absence », « Boost » pour un chauffe-eau — mais l'intégration lui déclare les modes que votre chaudière accepte réellement, donc ces boutons n'apparaissent pas.
En revanche, les mots ne sont pas les mêmes des deux côtés, et cela ne dépend pas de l'intégration : chaque catégorie a son vocabulaire dans Gladys. Ce sont pourtant bien les trois mêmes notions.
| Application Saunier Duval | Zone de chauffage (Gladys) | Eau chaude (Gladys) |
|---|---|---|
| Manuel | Chauffage | Manuel |
| Programmation | Auto | Programmation |
| Chauffage éteint / Arrêt | Arrêt | Arrêt |
Sur les anciens régulateurs, le mode « Abaissement » (chauffage permanent à la température réduite) est lu comme « Chauffage » lui aussi — Gladys n'a pas de valeur qui lui corresponde exactement.
Boost eau chaude
Le Boost demande à la chaudière de chauffer le ballon tout de suite, en dehors du programme. La chaudière l'arrête d'elle-même une fois le ballon chaud : Gladys repassera l'état à « désactivé » au rafraîchissement suivant.
Sur les versions de Gladys antérieures au correctif #2815, le bouton grisé du couple affiche l'état inverse de la réalité (« Boost actif » alors que le boost est éteint). Le bouton cliquable, lui, est correct. C'est un défaut d'affichage du cœur de Gladys, pas de l'intégration : mettre Gladys à jour le corrige.
Boost ventilation
L'appareil Chaudière porte un interrupteur Boost ventilation : c'est le bouton du même nom de l'application Saunier Duval. Il s'adresse à l'installation entière, pas à une zone — d'où sa place sur la chaudière.
C'est la fonction « aération » du régulateur : d'après la documentation des régulateurs du groupe Vaillant, le chauffage des zones est suspendu pendant une trentaine de minutes, le temps d'ouvrir les fenêtres sans chauffer pour rien, et une ventilation double flux raccordée au régulateur, s'il y en a une, passe à son débit maximal. La fonction s'arrête d'elle-même ; l'interrupteur permet aussi de l'arrêter avant.
Le bouton est proposé sur toutes les installations, avec ou sans ventilation, comme dans l'application. Si votre régulateur ne connaît pas la fonction, la plateforme refuse la commande, ou l'accepte sans effet : dans ce cas l'interrupteur revient sur « désactivé » quelques secondes plus tard.
Widget du tableau de bord
Sur un tableau de bord, ajoutez le widget Chaudière Saunier Duval (il figure dans la liste des widgets une fois l'intégration installée). Il réunit sur une seule carte :
- les températures qui comptent : jusqu'à deux zones, l'eau chaude, la température extérieure, et la pression d'eau, qui passe à l'orange sous 1 bar et au rouge sous 0,6 bar ;
- l'activité de la chaudière, le mode et la consigne de chaque zone — avec les mots de l'application : Manuel, Programmation, Arrêt — et la mention « forçage » quand un forçage temporaire est en cours ;
- l'état de la passerelle et les codes de défaut actifs ;
- trois boutons : Boost eau chaude, Boost ventilation (chacun propose l'inverse de l'état actuel) et Actualiser.
Si votre compte porte plusieurs installations, le réglage Installation du widget choisit celle qui est affichée ; sans réglage, c'est la première.
Afficher le widget n'interroge jamais la plateforme Saunier Duval : il montre la dernière lecture, et se met à jour à chaque nouveau cycle. Seul le bouton Actualiser déclenche une lecture — une requête.
Scènes
Toutes les valeurs de la chaudière sont des fonctionnalités d'appareil : une scène les surveille avec le déclencheur standard de Gladys (« quand la pression passe sous 1 bar… ») et les pilote avec l'action standard « Contrôler un appareil ». L'intégration ajoute ce que ces deux mécanismes ne savent pas exprimer.
Déclencheurs
| Déclencheur | Quand il se produit | Variables disponibles |
|---|---|---|
| Défaut chaudière détecté | Un nouveau code de défaut ou de maintenance apparaît | Code, intitulé, description, type de code, nombre de codes actifs |
| Défauts chaudière résolus | La chaudière ne signale plus aucun code | — |
| Passerelle hors ligne | La passerelle MiGo ne répond plus à la plateforme | — |
| Passerelle de nouveau en ligne | La passerelle répond de nouveau après une interruption | — |
Chacun accepte un filtre Chaudière, utile si votre compte porte plusieurs installations. Les variables du premier se glissent dans un message : « La chaudière signale F.28 — Défaut d'allumage ».
Trois choses à savoir :
- Un déclencheur signale un changement. Un défaut déjà présent au démarrage de l'intégration ne déclenche rien, et un défaut qui dure ne déclenche qu'une fois. S'il disparaît puis revient, c'est un nouveau défaut.
- Les codes de défaut et l'état de la passerelle sont relus toutes les 30 minutes (voir « Limitation d'appels ») : une scène peut donc réagir avec jusqu'à une demi-heure de retard. Le bouton Actualiser maintenant de l'intégration force une relecture.
- Si la chaudière signale une rafale de codes d'un coup, cinq événements au plus sont émis ; la variable « nombre de codes actifs » donne le total.
Actions
| Action | Ce qu'elle fait | Résultat utilisable dans la suite de la scène |
|---|---|---|
| Forcer la température d'une zone | Applique une température (5 à 30 °C) pendant une durée sur une zone programmée, puis le programme reprend | Forçage démarré : faux si la zone ne suit pas de programme |
| Annuler le forçage d'une zone | Met fin au forçage en cours : la zone revient à son programme | Forçage annulé : faux si aucun forçage n'était en cours |
La première existe parce qu'une commande d'appareil ne porte qu'une valeur : ici, la température et la durée partent ensemble, sans toucher au réglage « Durée du forçage » de la zone. La durée est en minutes, de 30 à 1440 ; si vous la laissez vide, c'est celle de la zone qui s'applique. Si un forçage est déjà en cours, il est remplacé et sa durée repart de zéro.
« Rien à faire » n'est pas une erreur : sur une zone en mode manuel ou à l'arrêt, l'action répond « faux » et la scène continue. Une condition placée ensuite peut tester ce résultat.
Dans le sélecteur de zone, Gladys liste tous les appareils de l'intégration : choisissez bien une zone. Sur un autre appareil, l'action échoue avec un message explicite.
Points d'attention
- Confirmation des commandes. Après une commande, Gladys affiche immédiatement la valeur demandée ; quelques secondes plus tard, l'intégration relit la chaudière (une requête) et publie ce qu'elle a réellement retenu. Une valeur qui revient en arrière signifie donc que la chaudière ne l'a pas prise en compte.
- Limitation d'appels. La plateforme Saunier Duval limite le nombre de requêtes, et vous la partagez avec l'application mobile. Un cycle de rafraîchissement coûte une seule requête par installation : toutes les valeurs publiées viennent d'une même réponse. La liste des installations, l'état de la passerelle et les codes de défaut sont relus séparément, toutes les 30 minutes seulement — c'est pourquoi une passerelle qui vient de passer hors ligne peut mettre jusqu'à une demi-heure à être signalée comme telle. Ne descendez pas l'intervalle sans raison : 60 secondes est le minimum autorisé, 300 secondes le réglage recommandé.
- Un seul compte. L'intégration lit toutes les installations rattachées au compte. Si vous en avez plusieurs, chaque installation produit son propre jeu d'appareils, préfixés par son nom.
- API non officielle. Saunier Duval ne documente ni ne soutient cette API : c'est celle de son application mobile. Elle peut changer sans préavis. Cette intégration n'est ni affiliée ni approuvée par Saunier Duval ou le groupe Vaillant.
Après une mise à jour de l'intégration
Un appareil déjà créé ne change pas tout seul. L'onglet Découverte affiche un bouton Mettre à jour sur les appareils dont la structure a bougé, et c'est ce bouton qui réapplique tout : nouvelles fonctionnalités, unités, et liste des modes proposés. C'est le cas de l'appareil Chaudière après la mise à jour qui apporte le Boost ventilation.
Attention à un cas particulier : Gladys détecte une « structure modifiée » en comparant les fonctionnalités, leurs unités et leurs bornes — pas la liste des modes. Si une mise à jour de l'intégration ne change que les modes proposés, aucun bouton Mettre à jour n'apparaît, et l'appareil garde son ancienne liste. Dans ce cas, supprimez l'appareil et recréez-le depuis l'onglet Découverte : il n'y a pas d'autre moyen.
En cas de problème
- « Connexion refusée » : vérifiez l'e-mail, le mot de passe et surtout le pays du compte. Vérifiez aussi que vous arrivez à vous connecter avec ces identifiants dans l'application mobile.
- Aucune installation trouvée : le compte n'a pas de chaudière rattachée, ou la passerelle a été associée à un autre compte.
- Valeurs figées : la passerelle est probablement hors ligne. Vérifiez-le dans l'application mobile ; l'intégration ne peut lire que ce que la plateforme connaît.
- Diagnostic détaillé : passez la variable d'environnement
LOG_LEVELde l'intégration àdebugpour voir chaque appel dans les logs du conteneur.
Paramètres de configuration
Voici les paramètres demandés par Saunier Duval dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Utilisez l'e-mail et le mot de passe du compte MiGo ou MiGo Link dont vous vous servez déjà dans l'application mobile. Votre chaudière doit être reliée à une passerelle MiGo ou MiGo Link : tout passe par le cloud Saunier Duval, il n'y a pas d'accès local. |
string | Oui | Adresse e-mail de votre compte MiGo / MiGo Link. | |
| Mot de passe | secret | Oui | Mot de passe de votre compte MiGo / MiGo Link. Stocké chiffré par Gladys et jamais renvoyé au navigateur. |
| Pays du compte | select | Oui | Le pays dans lequel votre compte a été créé. Un compte créé en France ne peut pas se connecter via un autre pays. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de la chaudière, en secondes. La plateforme Saunier Duval limite le nombre d'appels : gardez un intervalle confortable, une chaudière est un système lent. |
| Durée de forçage par défaut (h) | number | Non | Lorsqu'une zone suit son programme horaire, changer sa température déclenche un forçage temporaire, puis le programme reprend la main. Ceci est la durée initiale d'une zone : chaque zone dispose ensuite de sa propre commande « Durée du forçage », de 30 minutes à 24 heures par pas de 30 minutes. Demi-heures uniquement. |
Comment installer Saunier Duval dans Gladys
- Dans Gladys, ouvrez Intégrations : Saunier Duval 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/philippema/gladys-vaillant-saunierduval:1.1.0), 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/PhilippeMA/gladys-Vaillant-SaunierDuval.
Saunier Duval 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
Saunier Duval 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 PhilippeMA, 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