Liebherr SmartDevice Smart-Home-Integration, kostenlos und Open Source
Liebherr-Kühl-, Gefrier- und Weingeräte: Temperaturen, Sollwerte, Modi, Alarme.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Verbindet die Liebherr-Kühlschränke, -Gefriergeräte und -Weinschränke der SmartDevice-App mit Gladys, über die offizielle Cloud-API von Liebherr (SmartDevice HomeAPI).
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde anhand der offiziellen API-Dokumentation und der Testdaten der Home-Assistant-Integration geschrieben, ohne Liebherr-Gerät. Sag uns, was funktioniert und was nicht, auf GitHub oder im Gladys-Forum.
Diese Integration steht in keiner Verbindung zu Liebherr. Liebherr und SmartDevice sind Marken ihrer Inhaber.
Überblick
- Ein Gladys-Gerät pro Liebherr-Gerät, seine Funktionen nach Bereichen gruppiert (Kühlteil, Gefrierteil, Weinfach).
- Für jeden Bereich: die gemessene Temperatur und die Solltemperatur, die du innerhalb des vom Gerät erlaubten Bereichs ändern kannst.
- Die Funktionen, die dein Gerät bietet: SuperCool, SuperFrost, PartyMode, NightMode, IceMaker, HydroBreeze, BioFresh-Plus, das Präsentationslicht und die Tür der AutoDoor-Modelle (nur lesend).
- Alarme, die die Integration ableitet: ein Bereich zu lange zu warm, eine offen gebliebene AutoDoor, ein Gerät offline. Damit startest du deine Szenen.
- Ein Dashboard-Widget: die Temperatur jedes Bereichs, die Alarme und die Tasten SuperCool, SuperFrost und PartyMode.
Voraussetzungen
- Gladys 5.1 oder neuer, mit Internetzugang: Die Geräte werden über die Liebherr-Cloud gelesen.
- Ein Liebherr-Gerät mit SmartDeviceBox oder eingebautem WLAN, in der SmartDevice-App verbunden. Ein nur registriertes, aber nicht verbundenes Gerät ist für die API nicht sichtbar.
- Ein API-Schlüssel der HomeAPI, in der SmartDevice-App erzeugt:
- öffne die SmartDevice-App, dann Einstellungen;
- öffne Beta-Tester werden (in älteren Versionen: Beta-Funktionen) und aktiviere die HomeAPI;
- tippe auf Neuen Schlüssel erzeugen und kopiere den Schlüssel sofort: Er wird nur einmal angezeigt. Ein neuer Schlüssel ersetzt den vorherigen.
Die Namen der Menüs hängen von der Version und der Sprache der App ab.
Konfiguration
Geh in Gladys zu Integrationen, öffne Liebherr SmartDevice und fülle aus:
- API-Schlüssel: der aus der SmartDevice-App kopierte Schlüssel.
- Aktualisierungsintervall: 1, 2 (Standard), 3 oder 5 Minuten. Liebherr veröffentlicht seine Grenzen nicht, sagt aber, dass es die Anzahl der Aufrufe beschränkt, und hat schon zu hartnäckige Clients gesperrt. Bleib bei mehreren Geräten bei 2 Minuten oder mehr.
- Toleranz des Temperaturalarms: wie weit ein Bereich über seinem Sollwert bleiben darf (standardmäßig 3 °C).
- Alarmverzögerung: wie lange die Temperatur oder das Gerät offline anhalten muss, bevor der Alarm kommt (standardmäßig 30 Minuten).
- Verzögerung des Türalarms (AutoDoor): wie lange eine AutoDoor offen bleiben darf (standardmäßig 5 Minuten).
- Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen der Geräte (standardmäßig Französisch).
Speichere, öffne dann den Tab Erkennung der Integration und füge deine Geräte hinzu. Die Taste Verbindung testen liest die Geräte sofort und zeigt ihre Temperaturen.
Was es die Liebherr-API kostet: ein Aufruf pro Gerät und Intervall, dazu die Geräteliste alle 5 Minuten. Ein abgelehnter Schlüssel wird nach 30 Minuten erneut versucht (oder sobald du einen neuen speicherst). Eine Antwort „zu viele Anfragen“ pausiert die Abfragen, jedes Mal etwas länger, bis zu 30 Minuten.
Geräte und Funktionen
Das Gerät trägt den Namen aus der SmartDevice-App (sonst sein Modell). Nur die Funktionen, die dein Gerät bietet, werden angelegt.
Jeder Bereich
| Funktion | In Gladys |
|---|---|
| Temperatur | Die gemessene Temperatur (°C oder °F, wie am Gerät eingestellt). |
| Solltemperatur | Die Zieltemperatur, im Bereich des Geräts. Ein Wert außerhalb wird abgelehnt, nie in den Bereich zurückgeholt. |
| SuperCool | An/Aus: kühlt das Kühlteil schnell herunter und schaltet sich dann selbst ab. |
| SuperFrost | An/Aus: friert schnell ein und schaltet sich dann selbst ab. |
| IceMaker | Aus, An, MaxIce (wenn das Gerät es hat). |
| HydroBreeze | Aus, Niedrig, Mittel, Hoch. |
| BioFresh-Plus | Die Temperaturen der beiden Schubladen, unter denen, die das Gerät anbietet (z. B. 0 °C / −2 °C). |
| Tür | Nur AutoDoor-Modelle: offen oder geschlossen. Nur lesend: Gladys öffnet die Tür nie. |
Ein Bereich heißt nach seiner Art: Kühlteil, Gefrierteil oder Weinfach, mit seiner Lage (oben, Mitte, unten), wenn das Gerät zwei Bereiche derselben Art hat. Die Art wird aus dem Gerätetyp und dem Einstellbereich abgeleitet: Die API gibt sie nicht an.
Jedes Gerät
| Funktion | In Gladys |
|---|---|
| PartyMode | An/Aus. |
| NightMode | An/Aus. |
| Präsentationslicht | Helligkeit, von 0 (aus) bis zum Maximum des Geräts (oft 5). |
Das Abzeichen des Geräts zeigt Cloud, solange das Gerät antwortet, nicht erreichbar, wenn es offline ist oder der Liebherr-Dienst nicht antwortet.
Alarme (Szenen-Auslöser)
Die Liebherr-API meldet keine Alarme: Die Integration leitet sie aus den Messwerten ab und löst zwei Szenen-Auslöser aus.
- Liebherr-Alarm: Ein Problem hat die eingestellte Verzögerung gedauert.
- Temperatur zu hoch: Ein Bereich blieb über seinem Sollwert plus Toleranz. Wenn du einen Sollwert senkst, bleibt der vorherige die Referenz, bis der Bereich abgekühlt ist: kein Fehlalarm.
- Tür zu lange offen (AutoDoor): Nur die AutoDoor-Modelle melden ihre Tür.
- Gerät offline: Ein Stromausfall und ein WLAN-Verlust sehen aus der Cloud gleich aus. Wenn der Liebherr-Dienst selbst nicht antwortet, ist nichts bekannt und kein Alarm ändert sich.
- Liebherr-Alarm vorbei: Der Bereich ist abgekühlt, die Tür zu, das Gerät wieder da.
Jeder Alarm wird einmal ausgelöst, und einmal an seinem Ende, auch wenn Gladys dazwischen neu
startet. Beide Auslöser lassen sich auf ein Gerät und auf bestimmte Alarme beschränken. Die
Variablen: {{triggerEvent.data.appliance}}, zone, kind (temperature, door, offline),
temperature, target, unit und minutes (seit Beginn des Problems).
Widget
Das Widget Liebherr zeigt alle Geräte oder das in seinen Einstellungen gewählte:
- eine Kachel pro Bereich mit seiner Temperatur, rot während eines Alarms;
- die laufenden Alarme (oder „Kein Alarm“), die Geräte offline, die eingeschalteten Modi;
- bei einem einzigen Gerät: die Tasten SuperCool, SuperFrost und PartyMode. Ein Haken zeigt einen eingeschalteten Modus; ein Tippen schaltet ihn um.
Konfigurationsaktionen
- Verbindung testen: liest die Geräte sofort und zeigt für jedes die Temperatur und den Sollwert seiner Bereiche, oder dass es offline ist.
Szenenbeispiele
- Gefrierteil-Alarm: Auslöser Liebherr-Alarm, Alarm Temperatur zu hoch; Aktion: eine Nachricht „{{triggerEvent.data.appliance}} — {{triggerEvent.data.zone}}: {{triggerEvent.data.temperature}} {{triggerEvent.data.unit}} seit {{triggerEvent.data.minutes}} min“ senden.
- Stromausfall: Auslöser Liebherr-Alarm, Alarm Gerät offline; Aktion: eine Benachrichtigung, und eine weitere bei Liebherr-Alarm vorbei.
- Einkauf: Schalte in der Szene „Zurück vom Einkauf“ die Funktion SuperFrost des Gefrierteils ein; sie schaltet sich selbst ab.
- Ruhige Nächte: Schalte jeden Abend um 22 Uhr NightMode ein, um 7 Uhr aus.
Fehlerbehebung
- „API-Schlüssel abgelehnt“: Der Schlüssel wurde falsch kopiert oder durch einen neuen ersetzt. Erzeuge einen neuen Schlüssel in der SmartDevice-App und füge ihn in der Konfiguration ein.
- „Schlüssel akzeptiert, aber kein verbundenes Gerät“: Das Gerät ist registriert, aber nicht verbunden. Prüfe sein WLAN in der SmartDevice-App.
- „Zu viele Anfragen an Liebherr“: Verlängere das Aktualisierungsintervall. Die Integration pausiert von selbst und macht dann weiter.
- Ein Gerät bleibt „nicht erreichbar“: Prüfe, ob es in der SmartDevice-App verbunden ist. Es bleibt mit seinen letzten Werten in Gladys.
- Ein Sollwert wird abgelehnt: Das Gerät nimmt nur seinen eigenen Bereich an (in der Meldung genannt), manche Modelle nur bestimmte Werte (die Tasten + und − folgen ihnen).
- Mehr Details in den Protokollen der Integration, mit
LOG_LEVEL=debug. Der API-Schlüssel steht nie in den Protokollen.
Grenzen
- Ohne die Hardware entwickelt: die Bereichsnamen, die AutoDoor und die Geräte in Fahrenheit sind an keinem echten Gerät erprobt.
- Die HomeAPI ist ein Beta-Dienst von Liebherr, der sich ändern oder eingestellt werden kann.
- Kein Türkontakt außer bei den AutoDoor-Modellen, kein Urlaubsmodus, kein Stromausfallalarm vom Gerät selbst: Die API stellt sie nicht bereit.
- Die AutoDoor lässt sich absichtlich nicht aus Gladys öffnen.
- Die Werte werden alle 1 bis 5 Minuten gelesen: Eine kurze Änderung zwischen zwei Abfragen wird nicht gesehen. Liebherr bietet auch einen Echtzeit-Stream (Beta), hier nicht genutzt.
- Die Temperaturen sind ganze Grad, wie die API sie liefert.
- Die Namen der Funktionen werden beim Hinzufügen des Geräts festgelegt: Eine spätere Sprachänderung benennt nur neue Geräte.
Konfigurationseinstellungen
Diese Einstellungen fragt Liebherr SmartDevice in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Liebherr-Konto | section | Nein | Die Geräte müssen in der SmartDevice-App verbunden sein. In der App: Einstellungen, Beta-Tester werden, HomeAPI aktivieren, Neuen Schlüssel erzeugen. Kopiere den Schlüssel sofort: Er wird nur einmal angezeigt. |
| API-Schlüssel | secret | Ja | Der in der SmartDevice-App erzeugte Schlüssel. Ein neuer Schlüssel ersetzt den vorherigen. |
| Aktualisierungsintervall | select | Nein | Wie oft die Liebherr-Cloud gelesen wird. Liebherr begrenzt die Anzahl der Aufrufe: Bleib bei mehreren Geräten bei 2 Minuten oder mehr. |
| Alarme | section | Nein | Die Liebherr-Cloud meldet keine Alarme: Die Integration leitet sie aus den Messwerten ab und löst die Szenen-Auslöser „Liebherr-Alarm“ aus. |
| Toleranz des Temperaturalarms | select | Nein | Alarm, wenn ein Bereich so weit über seinem Sollwert bleibt. |
| Alarmverzögerung | select | Nein | Wie lange die Temperatur (oder das Gerät offline) anhalten muss, bevor der Alarm kommt. |
| Verzögerung des Türalarms (AutoDoor) | select | Nein | Nur die AutoDoor-Modelle melden ihre Tür. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Anlegen der Geräte in Gladys. |
So installierst du Liebherr SmartDevice in Gladys
- Öffne in Gladys Integrationen: Liebherr SmartDevice erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-liebherr:1.0.1) 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/guim31/gladys-liebherr.
Liebherr SmartDevice 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
Liebherr SmartDevice 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.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation