Zum Hauptinhalt springen

Ariston NET Smart-Home-Integration, kostenlos und Open Source

Ariston NET-Integration für Gladys Assistant

Heizkessel, Wärmepumpen und Warmwasserbereiter von Ariston, Chaffoteaux, Elco über Ariston NET.

Auf GitHub ansehenAlle Integrationen

Steuere von Gladys aus die Heizkessel, Wärmepumpen und Warmwasserbereiter der Ariston-Gruppe (Ariston, Chaffoteaux, Elco), die schon mit der App Ariston NET oder Chaffoteaux verbunden sind: Temperaturen, Sollwerte, Modi, Warmwasser, Störungen und, wenn das Gerät ihn misst, Gas- und Stromverbrauch.

Die Integration läuft über die Ariston-NET-Cloud (remotethermo), wie die offiziellen Apps: Du brauchst ein Konto und eine Internetverbindung. Die Integration ist nicht mit Ariston Group verbunden.

Ohne die Hardware entwickelt: Rückmeldungen sind willkommen (Gladys-Forum oder GitHub-Issue).

Voraussetzungen​

  • Gladys 5.1.0 oder neuer.
  • Ein Gerät, das schon installiert ist und in der App Ariston NET (oder Chaffoteaux) erscheint, mit dem Konto (E-Mail und Passwort) dieser App.
  • Unterstützte Geräte:
    • Heizkessel und Wärmepumpen mit vernetztem Thermostat (System „Galevo“): Genus One, Alteas One, Nimbus, Chaffoteaux INOA, Thision S…;
    • Warmwasserbereiter Velis Evo, Velis Lux / Lux 2, Lydos (WLAN), Lydos Hybrid, Nuos Split, Andris 2.

Konfiguration​

Unter Integrationen → Ariston NET → Konfiguration:

FeldZweck
E-Mail, PasswortDas Konto der App Ariston NET. Das Passwort ist geheim: Gladys zeigt es nie wieder an.
Sprache der NamenSprache der Geräte- und Funktionsnamen (standardmäßig Französisch), beim Hinzufügen fixiert.
Aktualisierungsintervall3, 5 (Standard), 10, 15 oder 30 Minuten.
Störungen lesenStörungscodes, alle 30 Minuten gelesen (standardmäßig an).
Verbrauch lesenGas und Strom des letzten Monats, alle 6 Stunden gelesen (standardmäßig aus).

Der Knopf Verbindung testen meldet sich neu an, listet die Geräte des Kontos (und die nicht unterstützten) und aktualisiert den Tab Erkennung. Füge dann die gewünschten Geräte aus diesem Tab hinzu.

Geräte​

Heizkessel oder Wärmepumpe​

Ein Gerät pro Anlage, mit dem, was die Anlage meldet:

  • Anlagenmodus (Auswahl, steuerbar): Sommer (nur Warmwasser), Winter, nur Heizung, Kühlen, Aus, Urlaub… nur die Modi, die die Anlage anbietet;
  • Warmwasser-Sollwert (steuerbar, in den Grenzen des Geräts) und Warmwassertemperatur, wenn ein Speicherfühler vorhanden ist;
  • Brenner an, Wärmepumpe läuft, Heizkreisdruck (bar), Außentemperatur, Vorlauftemperatur;
  • Störungen: „Keine Störung“ oder die Liste der Codes mit ihrer Beschreibung;
  • Verbrauch des letzten Monats (kWh): Gas und Strom, Heizung und Warmwasser, wenn die Option an ist und das Gerät ihn misst.

Heizzonen​

Ein Gerät pro Zone („Heizkessel – Zone 1“ oder der Name aus der App):

  • Temperatur, im Raum gemessen;
  • Sollwert (steuerbar): der Komfort-Sollwert, auf den Schritt des Geräts gerundet (oft 0,5 °C) und außerhalb seiner Grenzen abgelehnt;
  • Modus (steuerbar): Aus, Heizen (manuell), Kühlen bei einer reversiblen Wärmepumpe, Auto (= das Zeitprogramm der Ariston-App);
  • Wärmeanforderung: heizt, kühlt oder bereit.

Warmwasserbereiter​

  • Betrieb (steuerbar);
  • Wassertemperatur;
  • Sollwert (steuerbar, von 40 °C bis zum im Gerät eingestellten Maximum) — außer beim Velis Evo, der in der App in Anzahl Duschen eingestellt wird;
  • Modus (steuerbar), in die Gladys-Modi übersetzt: iMemory = Auto, Green = Eco, Zeitprogramm, Boost, Manuell; beim Velis Evo erscheint der Nachtmodus (Niedertarif) als Eco; beim Nuos Split ist Comfort = Manuell und Fast = Boost;
  • Heizt gerade und Verfügbare Duschen, wenn das Modell sie liefert;
  • bei Velis Lux, Evo und Modellen derselben Generation: Eco (ein Schalter, die Lernfunktion der App, neben dem Modus), Verbleibende Aufheizzeit (Minuten) und Anti-Legionellen-Zyklus (aktiv, solange der Zyklus läuft);
  • Störungen.

Widget​

Das Dashboard-Widget Ariston zeigt ein Gerät, das du in seinen Einstellungen auswählst:

  • eine Zone: Temperatur, Sollwert, Modus, Wärmeanforderung, Anlagenmodus, Störungen; Knöpfe Senken / Erhöhen (ein Schritt) und Zeitprogramm / Manuell (der aktuelle Modus hat ein Häkchen);
  • der Heizkessel: Warmwasser, Sollwert, Druck, Brenner, Störungen; Knöpfe für den Warmwasser-Sollwert;
  • ein Warmwasserbereiter: Temperatur, Sollwert, Duschen, Modus, Heizen, Störungen; Sollwert-Knöpfe, Boost (wenn das Modell ihn hat; ein zweiter Druck beendet den Boost und kehrt zum Modus davor zurück) und An/Aus.

Szenen​

Auslöser​

Ariston-Störung erkannt: Ein Gerät meldet einen Störungscode, den es bei der vorigen Abfrage nicht gemeldet hat. Filtere nach Gerät und Code; die Aktionen der Szene erhalten das Gerät, den Code, die Beschreibung und die Angabe „blockierende Störung“. Eine Störung, die beim Start der Integration schon besteht, löst nichts aus (kein Alarm bei jedem Neustart).

Sollwerte und Modi steuerst du mit der Standardaktion Gerät steuern von Gladys.

Szenen-Ideen​

  • Störungsalarm: „Ariston-Störung erkannt“ → Nachricht „Heizkessel-Störung {{code}}: {{description}}“ senden.
  • Urlaubsbeginn: Wenn die letzte Person das Haus verlässt → Anlagenmodus auf Urlaub und Warmwasserbereiter auf Eco.
  • Niedertarif: um 22:30 Uhr → Warmwasserbereiter auf Boost; um 6 Uhr → zurück auf Auto.
  • Offenes Fenster: Öffnungssensor länger als 5 Minuten offen → Zone aus; wieder geschlossen → Auto.

Aktualisierung und Grenzen des Dienstes​

Ariston NET hat keine dokumentierte öffentliche API: Die Integration nutzt die der Apps, wie die Home-Assistant-Integration. Seit 2024 antwortet die Cloud Konten, die zu oft fragen, mit „Requests are blocked for N seconds“ (HTTP 429), und der Ariston-Support erklärt, die Nutzung seiner API durch Drittsoftware nicht zu unterstützen. Die Integration bleibt deshalb sparsam:

  • eine Anfrage pro Gerät und Aktualisierung (Zonen und Warmwasser inklusive), standardmäßig alle 5 Minuten, nie öfter als alle 3 Minuten;
  • Störungen alle 30 Minuten, Einstellungen der Warmwasserbereiter und Verbrauch alle 6 Stunden;
  • eine Anfrage nach der anderen, mindestens eine Sekunde Abstand;
  • bei einer Sperre keine Anfrage mehr, bis die von Ariston angekündigte Frist abgelaufen ist;
  • nur die zu Gladys hinzugefügten Geräte werden gelesen;
  • das Anmelde-Token wird in /data aufbewahrt, damit ein Neustart keine neue Anmeldung braucht.

Nutze nicht gleichzeitig ein anderes Smart-Home-System mit demselben Konto: Die Anfragen addieren sich.

Fehlerbehebung​

  • „Ariston NET lehnt E-Mail oder Passwort ab“: Prüfe sie in der App Ariston NET; ein in der App geändertes Passwort musst du auch in Gladys ändern.
  • „Ariston NET begrenzt die Anfragen“: Die Integration wartet und macht von selbst weiter. Passiert das oft, erhöhe das Aktualisierungsintervall oder stoppe andere Werkzeuge am selben Konto.
  • Ein Gerät erscheint nicht: Klicke auf Verbindung testen; die Meldung listet auch die nicht unterstützten Geräte.
  • Ein Wert bleibt leer: Das Gerät schickt ihn nicht an die Cloud oder wurde noch nicht gelesen (warte eine Aktualisierung ab).
  • Ein Befehl springt zurück: Die Cloud bestätigt manchmal vor dem Gerät; die nächste Abfrage zeigt den echten Wert.
  • Ausführliche Logs: Umgebungsvariable LOG_LEVEL=debug am Container.

Grenzen​

  • Ohne die Hardware und ohne echtes Konto entwickelt und getestet: Verhalten geprüft an Antworten, die nach der Referenzbibliothek nachgebaut sind.
  • Die Wärmepumpen Elco / Remocon des Systems „BSB“ werden noch nicht unterstützt (sie werden als solche gemeldet).
  • Keine Zeitprogramm-Bearbeitung aus Gladys: Das Programm bleibt das der App; der Modus Auto folgt ihm.
  • Keine Einstellung der Duschanzahl des Velis Evo und keine erweiterten Einstellungen (Legionellenschutz, Nachtmodus des Lydos Hybrid, Heizkurve).
  • Der Verbrauch ist der des letzten Monats, wie die Cloud ihn veröffentlicht, kein Echtzeitzähler.
  • Abhängig von der Ariston-NET-Cloud: ohne Internet oder bei einem Ausfall des Dienstes kein Lesen und kein Steuern.

Konfigurationseinstellungen​

Diese Einstellungen fragt Ariston NET in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein Ariston-NET-KontosectionNeinDas Konto der App Ariston NET (oder Chaffoteaux), in der dein Gerät schon läuft. Ariston begrenzt die Anfragen eines Kontos: Lass ein paar Minuten zwischen zwei Aktualisierungen. Nicht mit Ariston Group verbunden.
E-MailstringJa
PasswortsecretJa
Sprache der NamenselectNeinSprache der Geräte- und Funktionsnamen, festgelegt beim Hinzufügen eines Geräts zu Gladys.
AktualisierungsintervallselectNeinWie oft die Geräte gelesen werden: eine Anfrage pro Gerät. Ariston sperrt Konten, die zu oft fragen.
Störungen lesenbooleanNeinStörungscodes der Geräte, alle 30 Minuten gelesen, mit einem Szenenauslöser.
Verbrauch lesenbooleanNeinGas und Strom des letzten Monats (Kessel und Wärmepumpen mit Messung), alle 6 Stunden gelesen.

So installierst du Ariston NET in Gladys​

  1. Öffne in Gladys Integrationen: Ariston NET erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-ariston:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-ariston.

Ariston NET benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Ariston NET ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am