Bonjour à tous,
Je viens d’intégrer mon réfrigérateur Liebherr dans Jeedom et j’en ai fait une passerelle réutilisable, autant la partager.
De quoi il s’agit
Liebherr a ouvert en 2025 une API cloud pour ses appareils équipés d’une SmartDeviceBox, la HomeAPI SmartDevice, toujours en bêta. La passerelle fait le pont entre cette API et MQTT, au format MQTT Discovery : le plugin MQTT Discovery crée l’équipement et toutes ses commandes tout seul, il n’y a rien à déclarer à la main.
Précision tout de suite : c’est un conteneur Docker, pas un plugin Jeedom. Si ça intéresse du monde, je peux en sortir une version plugin — dites-le moi ici, je verrai en fonction de la demande.
Ce que ça remonte
Sur mon IRBci 5151 : la température, la consigne (réglable depuis Jeedom), SuperCool, le Mode Party, le Mode Nuit et un témoin de liaison.
Le code gère aussi SuperFrost, la machine à glaçons, HydroBreeze, BioFresh-Plus, l’éclairage de présentation et la porte automatique. La liste des commandes est construite à partir de ce que l’appareil déclare lui-même, donc ça devrait s’adapter à vos modèles sans rien changer, y compris ceux à plusieurs zones.
Prérequis
Un broker MQTT, le plugin MQTT Discovery, et une clé API à générer dans l’application mobile SmartDevice : Paramètres > Devenir bêta testeur > Activer l’interface HomeAPI. Attention, elle ne peut être copiee qu’une seule fois.
Il faut aussi que liebherr figure dans les « topics de données » du plugin MQTT Discovery, sinon rien n’apparaît. Pas besoin de le taper à la main : démarrez le démon, attendez une minute et rafraîchissez la page de configuration du plugin — il propose lui-même les racines qu’il a découvertes, avec un bouton +. C’est expliqué dans la doc du plugin.
Deux choses à savoir
Pas de polling : la passerelle utilise l’endpoint SSE de l’API, qui pousse les changements en temps réel. Ce n’est pas un détail, Liebherr limite le débit de son API et a déjà blacklisté l’IP d’un membre du forum qui l’interrogeait toutes les 5 minutes.
Pas d’état de porte ni d’alarme, en revanche : ce n’est pas exposé par la HomeAPI, l’application mobile passe par une autre API interne. Et la LocalAPI existe bien dans la SmartDeviceBox, mais Liebherr la désactive à distance sur les appareils grand public — elle n’est ouverte que sur les gammes pro.
Le pont s’appuie sur pyliebherrhomeapi, la bibliothèque de l’intégration officielle Home Assistant, plutôt que sur du code maison, comme ça il suivra les évolutions de l’API.
La discussion d’origine sur le sujet est là : Frigo Liebherr smartdevice box
Bonne journée à tous.
Richard
