Hallo zusammen,

ich möchte euch den neuen ioBroker-Adapter Liebherr SmartDevice / HomeAPI zum Testen vorstellen.

Der Adapter verbindet ioBroker mit der offiziellen, cloudbasierten Liebherr SmartDevice HomeAPI. Er erkennt die mit dem API-Schlüssel verbundenen Kühl- und Gefriergeräte automatisch und legt die von den Geräten tatsächlich gemeldeten Funktionen dynamisch als ioBroker-Objekte an.

Der Adapter befindet sich noch in einer frühen Testphase. Auch die offizielle Liebherr HomeAPI wird derzeit noch als Beta angeboten.

Getestetes Gerät

Die Entwicklung und der erste Test erfolgten mit:

• Liebherr CBNsda 572i-22
• Kühl-/Gefrierkombination
• Temperaturzonen für Kühl- und Gefrierteil
• NightMode
• PartyMode
• SuperCool
• SuperFrost

Andere Liebherr-Modelle und weitere Kombinationen von Funktionen und Temperaturzonen sind ausdrücklich für den Test gesucht.

Aktueller Funktionsumfang

• Automatische Erkennung aller Geräte des HomeAPI-Kontos
• Dynamische Anlage der Geräte, Temperaturzonen und Bedienelemente
• Regelmäßige Aktualisierung über ein konfigurierbares Abfrageintervall
• Aktuelle, gewünschte, minimale und maximale Temperaturen
• Temperaturzone, Position, Einheit und Schrittweiteninformationen
• Anzeige unbekannter oder zukünftiger Funktionen ohne Adapterabsturz
• Verschlüsselte und geschützte Speicherung des API-Schlüssels
• Behandlung von API- und Netzwerkfehlern einschließlich Rate-Limiting

Folgende Zustände sind schreibbar, sofern das jeweilige Gerät die Funktion meldet:

• Zieltemperatur
• NightMode
• PartyMode
• SuperCool
• SuperFrost

Schreibvorgänge werden validiert. Ein neuer Wert wird in ioBroker erst bestätigt, nachdem er nach dem Schreiben wieder erfolgreich von der HomeAPI zurückgelesen wurde.

Noch nicht umgesetzt

- Server-Sent Events beziehungsweise Echtzeitaktualisierung Umgesetzt in 0.0.3

• Weitere schreibbare Funktionen wie IceMaker, HydroBreeze, BioFreshPlus, PresentationLight oder AutoDoor
• Lokale Kommunikation ohne Liebherr-Cloud

Voraussetzungen

• Node.js 22 oder neuer
• ioBroker js-controller 7.0.4 oder neuer
• ioBroker Admin 7.6.20 oder neuer
• Kompatibles Liebherr-Gerät in der SmartDevice HomeAPI
• HomeAPI-API-Schlüssel
• Internetverbindung des ioBroker-Hosts

API-Schlüssel

Der API-Schlüssel kann in der offiziellen Liebherr SmartDevice App erzeugt werden:

1. SmartDevice App öffnen
2. Einstellungen öffnen
3. HomeAPI auswählen
4. API-Schlüssel erzeugen
5. Schlüssel sicher speichern und in der Adapterkonfiguration eintragen

Der Schlüssel wird nur einmal angezeigt. Das Erzeugen eines neuen Schlüssels macht den vorherigen Schlüssel ungültig.

Bitte den API-Schlüssel niemals in Forumbeiträgen, Screenshots, Logs oder GitHub-Issues veröffentlichen.

Installation

Bis der Adapter in das ioBroker-Repository latest aufgenommen wurde:

1. ioBroker Admin öffnen
2. Zu Adapter wechseln
3. Falls erforderlich den Expertenmodus aktivieren
4. Adapter aus eigener URL installieren auswählen
5. Zum Reiter NPM wechseln
6. Folgendes eingeben:

iobroker.liebherr

7. Installation starten
8. Anschließend eine Instanz des Liebherr-Adapters anlegen
9. HomeAPI-Schlüssel eintragen und Konfiguration speichern

Rückmeldungen

Bei einer Rückmeldung bitte möglichst folgende Angaben mitsenden:

• Adapterversion
• Node.js-Version
• js-controller-Version
• Admin-Version
• Genaue Liebherr-Modellbezeichnung
• Erkannte Gerätetypen
• Erkannte Controls und Temperaturzonen
• Funktionieren Lesen und Schreiben der Zustände?
• Relevante Logauszüge, selbstverständlich ohne API-Schlüssel

Besonders interessant sind Geräte, die andere Funktionen oder Zonen als der bisher getestete CBNsda 572i-22 melden.

Fehler und reproduzierbare Probleme können auch über GitHub gemeldet werden:

https://github.com/Gaspode69/ioBroker.liebherr/issues

Quellcode:

https://github.com/Gaspode69/ioBroker.liebherr

npm:

https://www.npmjs.com/package/iobroker.liebherr

Offizielle Liebherr HomeAPI-Dokumentation:

https://developer.liebherr.com/apis/smartdevice-homeapi

Hinweis zur Entwicklung

Dieses Projekt ist zugleich ein persönlicher Test für KI-unterstützte ioBroker-Adapterentwicklung mit OpenAI Codex/ChatGPT. Der erzeugte Code wurde nicht ungeprüft übernommen, sondern anhand der aktuellen ioBroker-Vorgaben strukturiert, getestet und korrigiert.

Vielen Dank an alle, die den Adapter mit weiteren Liebherr-Geräten testen und Rückmeldung geben!