Intégration domotique Ariston NET, gratuite et open source
Chaudières, PAC et chauffe-eau Ariston, Chaffoteaux et Elco via le cloud Ariston NET.
Publiée par guim31
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez depuis Gladys les chaudières, pompes à chaleur et chauffe-eau du groupe Ariston (Ariston, Chaffoteaux, Elco) déjà connectés à l'appli Ariston NET ou Chaffoteaux : températures, consignes, modes, eau chaude, défauts et, si l'appareil la mesure, consommation de gaz et d'électricité.
L'intégration passe par le cloud Ariston NET (remotethermo), comme les applis officielles : il faut un compte et une connexion internet. Elle n'est pas affiliée à Ariston Group.
Développée sans le matériel : vos retours sont les bienvenus (forum Gladys ou issue GitHub).
Prérequis
- Gladys 5.1.0 ou plus récent.
- Un appareil déjà installé et visible dans l'appli Ariston NET (ou Chaffoteaux), avec le compte (e-mail et mot de passe) de cette appli.
- Appareils visés :
- chaudières et pompes à chaleur avec thermostat connecté (système « Galevo ») : Genus One, Alteas One, Nimbus, Chaffoteaux INOA, Thision S… ;
- chauffe-eau Velis Evo, Velis Lux / Lux 2, Lydos (Wi-Fi), Lydos Hybrid, Nuos Split, Andris 2.
Configuration
Dans Intégrations → Ariston NET → Configuration :
| Champ | Rôle |
|---|---|
| E-mail, Mot de passe | Le compte de l'appli Ariston NET. Le mot de passe est un secret : Gladys ne le réaffiche jamais. |
| Langue des noms | Langue des noms d'appareils et de fonctionnalités (français par défaut), fixée à leur ajout. |
| Intervalle de rafraîchissement | 3, 5 (par défaut), 10, 15 ou 30 minutes. |
| Lire les défauts | Codes de défaut, lus toutes les 30 minutes (activé par défaut). |
| Lire la consommation | Gaz et électricité du mois dernier, lus toutes les 6 heures (désactivé par défaut). |
Le bouton Tester la connexion se reconnecte, liste les appareils du compte (et ceux non pris en charge) et met à jour l'onglet Découverte. Ajoutez ensuite les appareils voulus depuis cet onglet.
Appareils
Chaudière ou pompe à chaleur
Un appareil par installation, avec ce que l'installation signale :
- Mode de l'installation (sélection, pilotable) : été (eau chaude seule), hiver, chauffage seul, rafraîchissement, arrêt, vacances… seulement les modes que l'installation propose ;
- Consigne eau chaude (pilotable, dans les bornes de l'appareil) et Température eau chaude si une sonde de ballon est présente ;
- Brûleur allumé, Pompe à chaleur en marche, Pression du circuit (bar), Température extérieure, Température de départ ;
- Défauts : « Aucun défaut » ou la liste des codes avec leur description ;
- consommation du mois dernier (kWh) : gaz et électricité, chauffage et eau chaude, si l'option est active et que l'appareil la mesure.
Zones de chauffage
Un appareil par zone (« Chaudière – Zone 1 », ou le nom donné dans l'appli) :
- Température mesurée dans la pièce ;
- Consigne (pilotable) : la consigne de confort, arrondie au pas de l'appareil (souvent 0,5 °C) et refusée hors de ses bornes ;
- Mode (pilotable) : Arrêt, Chauffage (manuel), Rafraîchissement sur une PAC réversible, Auto (= le programme horaire de l'appli Ariston) ;
- Demande de chauffe : en chauffe, en rafraîchissement ou au repos.
Chauffe-eau
- Marche (pilotable) ;
- Température de l'eau ;
- Consigne (pilotable, de 40 °C au maximum réglé dans l'appareil) — sauf sur le Velis Evo, qui se règle en nombre de douches dans l'appli ;
- Mode (pilotable), traduit dans les modes de Gladys : iMemory = Auto, Green = Éco, Programme, Boost, Manuel ; sur le Velis Evo, le mode Nuit (heures creuses) apparaît comme Éco ; sur le Nuos Split, Comfort = Manuel et Fast = Boost ;
- Chauffe en cours et Douches disponibles quand le modèle les fournit ;
- sur les Velis Lux, Evo et modèles de la même génération : Éco (un interrupteur, la fonction d'apprentissage de l'appli, à côté du mode), Temps de chauffe restant (minutes) et Cycle anti-légionellose (actif pendant le cycle) ;
- Défauts.
Widget
Le widget Ariston du tableau de bord affiche un appareil choisi dans ses réglages :
- une zone : température, consigne, mode, demande de chauffe, mode de l'installation, défauts ; boutons Baisser / Monter (d'un pas) et Programme / Manuel (le mode en cours porte une coche) ;
- la chaudière : eau chaude, consigne, pression, brûleur, défauts ; boutons de consigne eau chaude ;
- un chauffe-eau : température, consigne, douches, mode, chauffe, défauts ; boutons de consigne, Boost (si le modèle l'a ; un second appui arrête le boost et revient au mode d'avant) et marche/arrêt.
Scènes
Déclencheur
Défaut Ariston détecté : un appareil signale un code de défaut qu'il ne signalait pas à la lecture précédente. Filtrez par appareil et par code ; les actions de la scène disposent de l'appareil, du code, de la description et de l'indication « défaut bloquant ». Un défaut déjà présent au démarrage de l'intégration ne déclenche rien (pas d'alerte à chaque redémarrage).
Les consignes et modes se pilotent avec l'action standard Contrôler un appareil de Gladys.
Idées de scènes
- Alerte panne : « Défaut Ariston détecté » → envoyer un message « Chaudière en défaut {{code}} : {{description}} ».
- Départ en vacances : quand le dernier occupant quitte la maison → mode de l'installation sur Vacances et chauffe-eau en Éco.
- Heures creuses : à 22 h 30 → chauffe-eau en Boost ; à 6 h → retour en Auto.
- Fenêtre ouverte : capteur d'ouverture ouvert plus de 5 minutes → zone en Arrêt ; refermée → Auto.
Rafraîchissement et limites du service
Ariston NET n'a pas d'API publique documentée : l'intégration utilise celle des applis, comme l'intégration Home Assistant. Depuis 2024, le cloud répond « Requests are blocked for N seconds » (HTTP 429) aux comptes qui interrogent trop souvent, et le support Ariston indique ne pas prendre en charge l'usage de son API par des logiciels tiers. L'intégration reste donc sobre :
- une seule requête par appareil et par rafraîchissement (zones et eau chaude comprises), toutes les 5 minutes par défaut, jamais plus souvent que toutes les 3 minutes ;
- défauts toutes les 30 minutes, réglages des chauffe-eau et consommation toutes les 6 heures ;
- une requête à la fois, au moins une seconde d'écart ;
- en cas de blocage, plus aucune requête jusqu'à la fin du délai annoncé par Ariston ;
- seuls les appareils ajoutés à Gladys sont lus ;
- le jeton de connexion est conservé dans
/datapour ne pas se reconnecter à chaque redémarrage.
N'utilisez pas en même temps une autre domotique sur le même compte : les requêtes s'additionnent.
Dépannage
- « Ariston NET refuse l'e-mail ou le mot de passe » : vérifiez-les dans l'appli Ariston NET ; un mot de passe changé dans l'appli doit l'être aussi dans Gladys.
- « Ariston NET limite les requêtes » : l'intégration attend et reprend seule. Si cela revient souvent, augmentez l'intervalle de rafraîchissement ou arrêtez les autres outils branchés sur le même compte.
- Un appareil n'apparaît pas : cliquez sur Tester la connexion ; le message liste aussi les appareils non pris en charge.
- Une valeur reste vide : l'appareil ne la fournit pas au cloud, ou n'a pas encore été lu (attendez un rafraîchissement).
- Une commande revient en arrière : le cloud confirme parfois avant l'appareil ; la lecture suivante affiche la valeur réelle.
- Journaux détaillés : variable d'environnement
LOG_LEVEL=debugsur le conteneur.
Limites
- Développée et testée sans le matériel ni un compte réel : comportement vérifié sur des réponses reconstituées d'après la bibliothèque de référence.
- Les pompes à chaleur Elco / Remocon du système « BSB » ne sont pas encore prises en charge (elles sont signalées comme telles).
- Pas de programmation horaire depuis Gladys : le programme reste celui de l'appli ; le mode Auto le suit.
- Pas de réglage du nombre de douches du Velis Evo, ni des réglages avancés (anti-légionelle, mode nuit du Lydos Hybrid, courbe de chauffe).
- La consommation est celle du mois dernier telle que le cloud la publie, pas un compteur en temps réel.
- Dépend du cloud Ariston NET : sans internet ou en cas de panne du service, plus de lecture ni de commande.
Paramètres de configuration
Voici les paramètres demandés par Ariston NET dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Ariston NET | section | Non | Le compte de l'appli Ariston NET (ou Chaffoteaux), où votre appareil fonctionne déjà. Ariston limite les requêtes d'un compte : gardez quelques minutes entre deux rafraîchissements. Non affilié à Ariston Group. |
string | Oui | ||
| Mot de passe | secret | Oui | |
| Langue des noms | select | Non | Langue des noms des appareils et fonctionnalités, fixée quand un appareil est ajouté à Gladys. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture des appareils : une requête par appareil. Ariston bloque les comptes trop pressants. |
| Lire les défauts | boolean | Non | Codes de défaut des appareils, lus toutes les 30 minutes, avec un déclencheur de scène. |
| Lire la consommation | boolean | Non | Gaz et électricité du mois dernier (chaudières et PAC qui la mesurent), lus toutes les 6 heures. |
Comment installer Ariston NET dans Gladys
- Dans Gladys, ouvrez Intégrations : Ariston NET 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/guim31/gladys-ariston: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/guim31/gladys-ariston.
Ariston NET 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
Ariston NET 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 guim31, 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