Danfoss Ally Smart-Home-Integration, kostenlos und Open Source
Danfoss-Ally-Heizkörperthermostate und Icon: Solltemperatur, Modi, Fenster, Batterie, Szenen.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Überblick
Diese Integration bringt Ihre Danfoss-Ally-Heizung in Gladys: Danfoss-Ally-Heizkörperthermostate (eTRV), Danfoss-Ally-Raumsensoren und Danfoss-Icon-/Icon2-Raumthermostate für die Fußbodenheizung. Sie nutzt die offizielle Danfoss-Ally-API mit Consumer Key und Consumer Secret Ihrer eigenen App im Danfoss-Entwicklerportal.
- Ein Gladys-Gerät pro Raum: Solltemperatur, Heizmodus, Raum- und Bodentemperatur, Luftfeuchtigkeit, Batterie, offenes Fenster, Heizzustand, Kindersicherung.
- Szenenauslöser (Fenster geöffnet, Batterie schwach, Gerät offline, Störung, Modus in der Ally-App geändert…) und Szenenaktionen (Modus Zuhause / Abwesend für das ganze Zuhause, Solltemperatur eines Modus, Raumtemperatur für einen verdeckten Heizkörper, sofort abfragen).
- Zwei Dashboard-Widgets: die beheizten Räume mit den Schaltflächen „Modus Zuhause“ und „Modus Abwesend“, und die Verbindung.
Transport: Cloud. Gladys spricht nie direkt mit Ihren Thermostaten: Sie liest und schreibt in der Danfoss-Cloud, die die Änderungen an das Ally-Gateway weitergibt. Eine Änderung in Gladys erreicht den Heizkörper, und eine Änderung in der Ally-App oder am Gerät erreicht Gladys, innerhalb weniger Minuten — nicht sofort. Die Daten Ihrer Geräte verlassen Ihr Zuhause (das tun sie mit der Ally-App bereits).
Nicht mit Danfoss verbunden. Noch nicht mit einem echten Danfoss-Konto getestet: Bitte melden Sie, was funktioniert und was nicht.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Eine in der Danfoss-Ally-App eingerichtete Danfoss-Ally-Anlage (Gateway und Geräte) mit einem Konto, das mit einer E-Mail-Adresse angelegt wurde.
- Ein Konto im Danfoss-Entwicklerportal, developer.danfoss.com, angelegt mit genau derselben E-Mail-Adresse wie die Ally-App (Groß-/Kleinschreibung beachten). Sonst antwortet die API, listet aber kein Gerät.
- Im Portal: Apps → eine App erstellen, dort das Produkt Danfoss Ally API aktivieren und die Schlüssel öffnen: Sie brauchen den Consumer Key und das Consumer Secret. Die API ist für den privaten Gebrauch kostenlos; Danfoss bietet dafür keinen Support.
Konfiguration
Öffnen Sie in Gladys Integrationen → Danfoss Ally:
| Feld | Beschreibung |
|---|---|
| Consumer Key | Der Schlüssel Ihrer App im Entwicklerportal. |
| Consumer Secret | Ihr Geheimnis: nur an Danfoss gesendet, nie wieder angezeigt, nie protokolliert. |
| Abfrageintervall | Alle 1, 2, 5 oder 10 Minuten (standardmäßig 2). Eine Anfrage liest das ganze Zuhause. |
| Schwelle schwache Batterie (%) | Unter diesem Wert löst „Eine Batterie ist schwach“ aus (standardmäßig 20 %). |
| Sprache der Gerätetexte | Namen der Funktionen und Meldungen der Schaltfläche; standardmäßig automatisch. |
Klicken Sie auf Verbindung testen: Die Integration liest Ihre Geräte und listet sie mit Modell und Anzahl der Funktionen auf. Öffnen Sie dann den Reiter Entdecken und fügen Sie die gewünschten Räume hinzu: Ohne Sie wird nichts angelegt.
Verwendung
Geräte
Jedes Gerät bietet die Funktionen, die sein Status erlaubt:
| Funktion | Gladys-Typ | Hinweise |
|---|---|---|
| Solltemperatur | Thermostat-Sollwert, 5 bis 35 °C in 0,5-°C-Schritten | Die Solltemperatur des aktuellen Modus: Im Modus „Zuhause“ ändert sie die Zuhause-Temperatur des Zeitplans. Ein Thermostat mit nur einem Sollwert (erstes Icon) schreibt diesen. |
| Heizmodus | Thermostatmodus: aus, heizen, auto | Aus = Pause (Frostschutz), heizen = Manuell, auto = der Zeitplan (Zuhause / Abwesend / Urlaub). |
| Voreinstellung | Thermostat-Preset: Frostschutz, Abwesend, Komfort | Frostschutz = Pause, Abwesend = Abwesend (auch im Urlaub angezeigt), Komfort = Zuhause. Im Modus Manuell unverändert. |
| Heizt | Betriebszustand: inaktiv oder heizt | Aus der Ventilöffnung eines Heizkörperthermostats oder dem Ausgang eines Icon-Thermostats. |
| Raumtemperatur, Bodentemperatur | Temperatursensor | Die Bodentemperatur nur mit Bodenfühler (Icon). |
| Luftfeuchtigkeit | Feuchtigkeitssensor | Icon2 und Raumsensoren. |
| Batterie | Batteriestand | Alle batteriebetriebenen Geräte. |
| Offenes Fenster | Öffnungssensor (nur lesen) | Vom Thermostat selbst erkannt (Temperatursturz). |
| Kindersicherung | Kindersicherung | An oder aus. |
Das Dashboard-Widget Thermostat von Gladys funktioniert mit der Solltemperatur. Die genaue Ventilöffnung (in %) hat keine Gladys-Kategorie: Sie erscheint in den Details des Raum-Widgets.
Nach einem Befehl liest die Integration dieses Gerät 5 Minuten lang mehrmals erneut und behält inzwischen den angeforderten Wert, damit das Dashboard nicht auf den alten Wert zurückspringt, den die Cloud noch kurz liefert.
Dashboard-Widgets
- Beheizte Räume: jeder Raum mit Temperatur, Solltemperatur und Modus sowie einem Badge für das, was Aufmerksamkeit braucht (offline, Störung, Fenster offen, Batterie schwach, Heizen mit Ventilöffnung). Tippen Sie auf einen Raum für die Details (Sollwerte aller Modi, Luftfeuchtigkeit, Bodentemperatur, externer Sensor…). Die Schaltflächen Modus Zuhause und Modus Abwesend schalten alle Thermostate auf einmal um (nach einer Bestätigung); Aktualisieren fragt sofort ab. Wählen Sie die Räume in den Widget-Einstellungen (höchstens 8).
- Danfoss Ally: der Zustand der Verbindung zur API, die Geräte online, die Anfragen der letzten Stunde, eine Schaltfläche Aktualisieren.
Szenen
Auslöser (jeder lässt sich auf ein Gerät beschränken):
- Ein Fenster wird geöffnet / Ein Fenster wird geschlossen.
- Eine Batterie ist schwach: einmal, bis die Batterie ersetzt wird.
- Ein Gerät geht offline / Ein Gerät ist wieder online.
- Ein Gerät meldet eine Störung: eine Störung oder ein Fehlercode, einmal je neuem Code.
- Der Modus ändert sich: in der Ally-App, am Gerät oder durch den Zeitplan — nie durch Gladys selbst. Filter nach neuem Modus.
Aktionen:
- Heizmodus ändern: Zuhause, Abwesend, Pause, Manuell oder Urlaub, für ein Thermostat oder für alle (Ausgaben: umgeschaltet, fehlgeschlagen).
- Solltemperatur eines Modus einstellen: die Temperatur des Modus Zuhause, Abwesend, Pause, Manuell oder Urlaub (oder des aktuellen), ohne den Modus zu wechseln.
- Raumtemperatur senden: Für einen hinter einer Verkleidung oder einem Vorhang verdeckten Heizkörper regelt das Thermostat nach der Temperatur eines anderen Sensors. Geben Sie eine Zahl oder eine Szenenvariable ein (den Wert eines Sensors); „off“ beendet es. Danfoss erwartet alle 5 bis 30 Minuten einen Wert: Ein Wert, der weniger als 5 Minuten nach dem vorherigen kommt, wird übersprungen (Ausgabe
sent= false). - Thermostate jetzt abfragen.
Beispiele:
- Wenn ein Fenster geöffnet wird → eine Benachrichtigung „Fenster offen in {{triggerEvent.data.device_name}}“ senden.
- Werktags um 8:00, wenn das Haus leer ist → alle Thermostate auf Abwesend schalten; bei der Rückkehr → Zuhause.
- Alle 10 Minuten → den Wohnzimmersensor lesen und seinen Wert als Raumtemperatur an das Thermostat des Heizkörpers hinter dem Sofa senden.
Transport
Der Katalog zeigt das Badge Cloud: Jede Anfrage geht an api.danfoss.com, mit Ihren Zugangsdaten. Einen lokalen Modus gibt es nicht: Danfoss bietet keine lokale API für das Ally-Gateway.
Fehlerbehebung
- „Danfoss lehnt die Zugangsdaten ab“: Kopieren Sie Consumer Key und Secret erneut aus dem Portal (Apps → Ihre App) und prüfen Sie, ob die Danfoss-Ally-API für diese App aktiviert ist.
- Verbunden, aber kein Gerät: Das Portalkonto muss genau dieselbe E-Mail-Adresse wie die Ally-App verwenden, Groß-/Kleinschreibung inklusive. Legen Sie bei Bedarf ein anderes Portalkonto mit der richtigen Adresse an.
- Eine Änderung braucht Minuten: So funktioniert die Danfoss-Cloud; die Integration liest das Gerät nach einem Befehl 5 Minuten lang erneut. Ein kürzeres Intervall macht die Geräte nicht schneller.
- „Danfoss bittet um weniger Anfragen“: Die API hat „zu viele Anfragen“ (429) geantwortet. Die Integration fragt seltener ab und kehrt dann von selbst zum normalen Takt zurück. Wählen Sie lieber 2 Minuten oder mehr.
- Das Gateway wird nicht angeboten: Es meldet nichts Anzeigbares; „Verbindung testen“ listet es als „nicht angeboten“.
- Melden Sie ein Problem auf GitHub mit Ihrer Gladys-Version, der Version der Integration und dem Ergebnis von „Verbindung testen“.
Konfigurationseinstellungen
Diese Einstellungen fragt Danfoss Ally in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Danfoss Ally | section | Nein | So verbinden Sie sich: 1. Richten Sie Ihre Thermostate in der Danfoss-Ally-App mit einem E-Mail-Konto ein. 2. Legen Sie auf developer.danfoss.com ein Konto mit genau derselben E-Mail-Adresse an (Groß-/Kleinschreibung beachten). 3. Erstellen Sie unter „Apps“ eine App, aktivieren Sie dort die „Danfoss Ally API“ und kopieren Sie Consumer Key und Consumer Secret unten hinein. 4. Fügen Sie im Reiter Entdecken Ihre Räume hinzu. Die Integration nutzt die Danfoss-Cloud: Eine Änderung erreicht die Geräte, und eine Änderung an den Geräten erreicht Gladys, innerhalb weniger Minuten. |
| Consumer Key | string | Ja | Der Schlüssel Ihrer App auf developer.danfoss.com (Apps → Ihre App → Keys). |
| Consumer Secret | secret | Ja | Das Geheimnis derselben App. Wird nur an Danfoss gesendet und nie wieder angezeigt. |
| Abfrageintervall | select | Nein | Eine Anfrage liest das ganze Zuhause. Danfoss nennt kein Kontingent, bremst aber zu häufige Anfragen: 2 Minuten sind ein guter Kompromiss. |
| Schwelle schwache Batterie (%) | number | Nein | Der Szenenauslöser „Batterie schwach“ löst aus, wenn eine Batterie unter diesen Wert fällt (5 bis 50). |
| Sprache der Gerätetexte | select | Nein | Namen der Funktionen und Meldungen der Schaltfläche unten. Automatisch: die Sprache des Dashboards, sobald ein Widget angezeigt wird. |
So installierst du Danfoss Ally in Gladys
- Öffne in Gladys Integrationen: Danfoss Ally erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-danfoss-ally:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-danfoss-ally.
Danfoss Ally benötigt Gladys >=5.3.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
Danfoss Ally 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 William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation