Intégration domotique Liebherr SmartDevice, gratuite et open source
Réfrigérateurs, congélateurs et caves Liebherr : températures, consignes, modes, alarmes.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Relie à Gladys les réfrigérateurs, congélateurs et caves à vin Liebherr de l'application SmartDevice, par l'API cloud officielle de Liebherr (SmartDevice HomeAPI).
Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été écrite d'après la documentation officielle de l'API et les données de test de l'intégration Home Assistant, sans appareil Liebherr. Dites-nous ce qui marche et ce qui ne marche pas sur GitHub ou sur le forum Gladys.
Cette intégration n'est pas affiliée à Liebherr. Liebherr et SmartDevice sont des marques de leurs propriétaires.
Présentation
- Un appareil Gladys par appareil Liebherr, ses fonctionnalités regroupées par zone (réfrigérateur, congélateur, cave à vin).
- Pour chaque zone : la température mesurée et la consigne, que vous pouvez changer dans la plage acceptée par l'appareil.
- Les fonctions que propose votre appareil : SuperCool, SuperFrost, PartyMode, NightMode, IceMaker, HydroBreeze, BioFresh-Plus, l'éclairage de présentation, et la porte des modèles AutoDoor (en lecture seule).
- Des alarmes déduites par l'intégration : une zone trop chaude trop longtemps, une AutoDoor restée ouverte, un appareil hors ligne. Elles déclenchent vos scènes.
- Un widget de tableau de bord : la température de chaque zone, les alarmes, et les boutons SuperCool, SuperFrost et PartyMode.
Prérequis
- Gladys 5.1 ou plus récent, avec un accès à Internet : les appareils sont lus par le cloud Liebherr.
- Un appareil Liebherr avec un boîtier SmartDevice ou le Wi-Fi intégré, connecté dans l'application SmartDevice. Un appareil seulement enregistré, mais pas connecté, n'est pas visible par l'API.
- Une clé d'API de la HomeAPI, générée dans l'application SmartDevice :
- ouvrez l'application SmartDevice, puis Réglages ;
- ouvrez Devenir bêta-testeur (dans les anciennes versions : Fonctions bêta) et activez la HomeAPI ;
- touchez Générer une nouvelle clé et copiez la clé tout de suite : elle ne s'affiche qu'une fois. Une nouvelle clé remplace la précédente.
Le nom des menus dépend de la version et de la langue de l'application.
Configuration
Dans Gladys, allez dans Intégrations, ouvrez Liebherr SmartDevice, puis renseignez :
- Clé d'API : la clé copiée depuis l'application SmartDevice.
- Intervalle de rafraîchissement : 1, 2 (par défaut), 3 ou 5 minutes. Liebherr ne publie pas ses limites, mais dit restreindre le nombre d'appels, et a déjà bloqué des clients trop insistants. Avec plusieurs appareils, restez à 2 minutes ou plus.
- Marge de l'alarme de température : l'écart au-dessus de sa consigne qu'une zone peut garder (3 °C par défaut).
- Délai d'alarme : la durée pendant laquelle la température, ou l'appareil hors ligne, doit durer avant l'alarme (30 minutes par défaut).
- Délai de l'alarme de porte (AutoDoor) : la durée pendant laquelle une AutoDoor peut rester ouverte (5 minutes par défaut).
- Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités quand vous ajoutez les appareils (français par défaut).
Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et ajoutez vos appareils. Le bouton Tester la connexion lit les appareils tout de suite et affiche leurs températures.
Ce que cela coûte à l'API Liebherr : un appel par appareil à chaque intervalle, plus la liste des appareils toutes les 5 minutes. Une clé refusée est réessayée au bout de 30 minutes (ou dès que vous en enregistrez une nouvelle). Une réponse « trop de requêtes » met les lectures en pause, un peu plus longtemps à chaque fois, jusqu'à 30 minutes.
Appareils et fonctionnalités
L'appareil prend le nom donné dans l'application SmartDevice (sinon son modèle). Seules les fonctionnalités que propose votre appareil sont créées.
Chaque zone
| Fonctionnalité | Dans Gladys |
|---|---|
| Température | La température mesurée (°C ou °F, selon le réglage de l'appareil). |
| Consigne | La température visée, dans la plage de l'appareil. Une valeur hors plage est refusée, jamais ramenée dans la plage. |
| SuperCool | Marche/arrêt : refroidit vite le réfrigérateur, puis s'arrête seul. |
| SuperFrost | Marche/arrêt : congèle vite, puis s'arrête seul. |
| IceMaker | Arrêt, Marche, MaxIce (si l'appareil l'a). |
| HydroBreeze | Arrêt, Faible, Moyen, Fort. |
| BioFresh-Plus | Les températures des deux tiroirs, parmi celles que propose l'appareil (ex. 0 °C / −2 °C). |
| Porte | Modèles AutoDoor seulement : ouverte ou fermée. En lecture seule : Gladys n'ouvre jamais la porte. |
Une zone porte le nom de son type : Réfrigérateur, Congélateur ou Cave à vin, avec sa position (haut, milieu, bas) quand l'appareil a deux zones du même type. Le type est déduit du type d'appareil et de la plage de réglage : l'API ne le donne pas.
Chaque appareil
| Fonctionnalité | Dans Gladys |
|---|---|
| PartyMode | Marche/arrêt. |
| NightMode | Marche/arrêt. |
| Éclairage de présentation | Intensité, de 0 (éteint) au maximum de l'appareil (souvent 5). |
Le badge de l'appareil indique cloud tant que l'appareil répond, injoignable quand il est hors ligne ou que le service Liebherr ne répond pas.
Alarmes (déclencheurs de scène)
L'API Liebherr ne signale aucune alarme : l'intégration les déduit des relevés et déclenche deux déclencheurs de scène.
- Alarme Liebherr : un problème a duré le délai réglé.
- Température trop haute : une zone est restée au-dessus de sa consigne plus la marge. Quand vous baissez une consigne, l'ancienne reste la référence jusqu'à ce que la zone ait refroidi : pas de fausse alarme.
- Porte ouverte trop longtemps (AutoDoor) : seuls les modèles AutoDoor signalent leur porte.
- Appareil hors ligne : une coupure de courant et une perte du Wi-Fi se ressemblent vues du cloud. Quand le service Liebherr lui-même ne répond pas, rien n'est connu et aucune alarme ne bouge.
- Fin d'alarme Liebherr : la zone a refroidi, la porte est fermée, l'appareil est revenu.
Chaque alarme est déclenchée une fois, et une fois à sa fin, même si Gladys redémarre entre-temps.
Les deux déclencheurs peuvent se limiter à un appareil et à certaines alarmes. Leurs variables :
{{triggerEvent.data.appliance}}, zone, kind (temperature, door, offline), temperature,
target, unit et minutes (depuis le début du problème).
Widget
Le widget Liebherr montre tous les appareils, ou celui choisi dans ses réglages :
- une tuile par zone avec sa température, en rouge pendant une alarme ;
- les alarmes en cours (ou « Aucune alarme »), les appareils hors ligne, les modes actifs ;
- avec un seul appareil : les boutons SuperCool, SuperFrost et PartyMode. Une coche signale un mode actif ; un appui le bascule.
Actions de configuration
- Tester la connexion : lit les appareils tout de suite et affiche, pour chacun, la température et la consigne de ses zones, ou qu'il est hors ligne.
Exemples de scènes
- Alarme congélateur : déclencheur Alarme Liebherr, alarme Température trop haute ; action : envoyer un message « {{triggerEvent.data.appliance}} — {{triggerEvent.data.zone}} : {{triggerEvent.data.temperature}} {{triggerEvent.data.unit}} depuis {{triggerEvent.data.minutes}} min ».
- Coupure de courant : déclencheur Alarme Liebherr, alarme Appareil hors ligne ; action : une notification, et une autre sur Fin d'alarme Liebherr.
- Courses : dans la scène « Retour des courses », allumez la fonctionnalité SuperFrost du congélateur ; elle s'arrête seule.
- Nuits calmes : chaque soir à 22 h, allumez NightMode ; à 7 h, éteignez-le.
Dépannage
- « Clé d'API refusée » : la clé a été mal copiée, ou remplacée par une nouvelle. Générez une nouvelle clé dans l'application SmartDevice et collez-la dans la configuration.
- « Clé acceptée, mais aucun appareil connecté » : l'appareil est enregistré mais pas connecté. Vérifiez son Wi-Fi dans l'application SmartDevice.
- « Trop de requêtes vers Liebherr » : allongez l'intervalle de rafraîchissement. L'intégration fait une pause d'elle-même et repart.
- Un appareil reste « injoignable » : vérifiez qu'il est connecté dans l'application SmartDevice. Il reste dans Gladys avec ses dernières valeurs.
- Une consigne est refusée : l'appareil n'accepte que sa propre plage (indiquée dans le message), et certains modèles seulement certaines valeurs (les boutons + et − les suivent).
- Plus de détails dans les journaux de l'intégration, avec
LOG_LEVEL=debug. La clé d'API n'est jamais écrite dans les journaux.
Limites
- Développée sans le matériel : les noms de zones, l'AutoDoor et les appareils en Fahrenheit n'ont pas été essayés sur un vrai appareil.
- La HomeAPI est un service bêta de Liebherr : elle peut changer ou s'arrêter.
- Pas de contact de porte hors modèles AutoDoor, pas de mode Vacances, pas d'alarme de coupure de courant venant de l'appareil lui-même : l'API ne les expose pas.
- L'AutoDoor ne peut pas être ouverte depuis Gladys, volontairement.
- Les valeurs sont lues toutes les 1 à 5 minutes : un changement bref entre deux lectures n'est pas vu. Liebherr propose aussi un flux en temps réel (bêta), non utilisé ici.
- Les températures sont en degrés entiers, comme l'API les donne.
- Les noms des fonctionnalités sont fixés à l'ajout de l'appareil : changer la langue ensuite ne renomme que les nouveaux appareils.
Paramètres de configuration
Voici les paramètres demandés par Liebherr SmartDevice dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Liebherr | section | Non | Les appareils doivent être connectés dans l'application SmartDevice. Dans l'application : Réglages, Devenir bêta-testeur, activez la HomeAPI, Générer une nouvelle clé. Copiez la clé tout de suite : elle ne s'affiche qu'une fois. |
| Clé d'API | secret | Oui | La clé générée dans l'application SmartDevice. Une nouvelle clé remplace la précédente. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture du cloud Liebherr. Liebherr limite le nombre d'appels : restez à 2 minutes ou plus avec plusieurs appareils. |
| Alarmes | section | Non | Le cloud Liebherr ne signale aucune alarme : l'intégration les déduit des relevés et déclenche les scènes « Alarme Liebherr ». |
| Marge de l'alarme de température | select | Non | Alarme quand une zone reste à cet écart au-dessus de sa consigne. |
| Délai d'alarme | select | Non | Durée pendant laquelle la température (ou l'appareil hors ligne) doit durer avant l'alarme. |
| Délai de l'alarme de porte (AutoDoor) | select | Non | Seuls les modèles AutoDoor signalent leur porte. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités à la création des appareils dans Gladys. |
Comment installer Liebherr SmartDevice dans Gladys
- Dans Gladys, ouvrez Intégrations : Liebherr SmartDevice apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-liebherr:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-liebherr.
Liebherr SmartDevice nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Liebherr SmartDevice est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation