Integración domótica Liebherr SmartDevice, gratuita y de código abierto
Frigoríficos, congeladores y vinotecas Liebherr: temperaturas, consignas, modos, alarmas.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Conecta con Gladys los frigoríficos, congeladores y vinotecas Liebherr de la aplicación SmartDevice, mediante la API oficial en la nube de Liebherr (SmartDevice HomeAPI).
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se escribió a partir de la documentación oficial de la API y de los datos de prueba de la integración de Home Assistant, sin un aparato Liebherr. Cuéntenos qué funciona y qué no en GitHub o en el foro de Gladys.
Esta integración no está afiliada a Liebherr. Liebherr y SmartDevice son marcas de sus propietarios.
Presentación
- Un dispositivo de Gladys por aparato Liebherr, con sus funciones agrupadas por zona (frigorífico, congelador, vinoteca).
- Para cada zona: la temperatura medida y la consigna, que puede cambiar dentro del rango que acepta el aparato.
- Las funciones que ofrece su aparato: SuperCool, SuperFrost, PartyMode, NightMode, IceMaker, HydroBreeze, BioFresh-Plus, la luz de presentación y la puerta de los modelos AutoDoor (solo lectura).
- Alarmas deducidas por la integración: una zona demasiado caliente durante demasiado tiempo, una AutoDoor abierta, un aparato sin conexión. Activan sus escenas.
- Un widget del panel: la temperatura de cada zona, las alarmas y los botones SuperCool, SuperFrost y PartyMode.
Requisitos previos
- Gladys 5.1 o posterior, con acceso a Internet: los aparatos se leen a través de la nube de Liebherr.
- Un aparato Liebherr con caja SmartDevice o Wi-Fi integrado, conectado en la aplicación SmartDevice. Un aparato solo registrado, pero no conectado, no es visible para la API.
- Una clave de API de la HomeAPI, generada en la aplicación SmartDevice:
- abra la aplicación SmartDevice y luego Ajustes;
- abra Ser beta tester (en versiones antiguas: Funciones beta) y active la HomeAPI;
- pulse Generar nueva clave y copie la clave enseguida: solo se muestra una vez. Una clave nueva sustituye a la anterior.
Los nombres de los menús dependen de la versión y del idioma de la aplicación.
Configuración
En Gladys, vaya a Integraciones, abra Liebherr SmartDevice y complete:
- Clave de API: la clave copiada de la aplicación SmartDevice.
- Intervalo de actualización: 1, 2 (por defecto), 3 o 5 minutos. Liebherr no publica sus límites, pero dice que restringe el número de llamadas, y ya ha bloqueado clientes demasiado insistentes. Con varios aparatos, mantenga 2 minutos o más.
- Margen de la alarma de temperatura: cuánto puede mantenerse una zona por encima de su consigna (3 °C por defecto).
- Retardo de la alarma: cuánto tiempo debe durar la temperatura, o el aparato sin conexión, antes de la alarma (30 minutos por defecto).
- Retardo de la alarma de puerta (AutoDoor): cuánto tiempo puede quedarse abierta una AutoDoor (5 minutos por defecto).
- Idioma de los nombres de funciones: los nombres dados a las funciones al añadir los dispositivos (francés por defecto).
Guarde, abra la pestaña Descubrimiento de la integración y añada sus aparatos. El botón Probar la conexión lee los aparatos al momento y muestra sus temperaturas.
Lo que cuesta a la API de Liebherr: una llamada por aparato en cada intervalo, más la lista de aparatos cada 5 minutos. Una clave rechazada se vuelve a probar a los 30 minutos (o en cuanto guarde una nueva). Una respuesta «demasiadas solicitudes» pausa las lecturas, un poco más cada vez, hasta 30 minutos.
Dispositivos y funciones
El dispositivo toma el nombre del aparato en la aplicación SmartDevice (si no, su modelo). Solo se crean las funciones que ofrece su aparato.
Cada zona
| Función | En Gladys |
|---|---|
| Temperatura | La temperatura medida (°C o °F, según el ajuste del aparato). |
| Consigna | La temperatura objetivo, dentro del rango del aparato. Un valor fuera de rango se rechaza, nunca se ajusta al rango. |
| SuperCool | Encendido/apagado: enfría rápido el frigorífico y se apaga solo. |
| SuperFrost | Encendido/apagado: congela rápido y se apaga solo. |
| IceMaker | Apagado, Encendido, MaxIce (si el aparato lo tiene). |
| HydroBreeze | Apagado, Bajo, Medio, Alto. |
| BioFresh-Plus | Las temperaturas de los dos cajones, entre las que ofrece el aparato (p. ej. 0 °C / −2 °C). |
| Puerta | Solo modelos AutoDoor: abierta o cerrada. Solo lectura: Gladys nunca abre la puerta. |
Una zona lleva el nombre de su tipo: Frigorífico, Congelador o Vinoteca, con su posición (arriba, centro, abajo) cuando el aparato tiene dos zonas del mismo tipo. El tipo se deduce del tipo de aparato y del rango de ajuste: la API no lo indica.
Cada aparato
| Función | En Gladys |
|---|---|
| PartyMode | Encendido/apagado. |
| NightMode | Encendido/apagado. |
| Luz de presentación | Intensidad, de 0 (apagada) al máximo del aparato (a menudo 5). |
La insignia del dispositivo indica nube mientras el aparato responde, inaccesible cuando está sin conexión o cuando el servicio de Liebherr no responde.
Alarmas (disparadores de escena)
La API de Liebherr no informa de alarmas: la integración las deduce de las lecturas y activa dos disparadores de escena.
- Alarma Liebherr: un problema ha durado el retardo elegido.
- Temperatura demasiado alta: una zona se ha mantenido por encima de su consigna más el margen. Cuando baja una consigna, la anterior sigue siendo la referencia hasta que la zona se haya enfriado: sin falsa alarma.
- Puerta abierta demasiado tiempo (AutoDoor): solo los modelos AutoDoor informan de su puerta.
- Aparato sin conexión: un corte de luz y una pérdida del Wi-Fi se ven igual desde la nube. Cuando el propio servicio de Liebherr no responde, no se sabe nada y ninguna alarma cambia.
- Fin de alarma Liebherr: la zona se ha enfriado, la puerta está cerrada, el aparato ha vuelto.
Cada alarma se activa una vez, y una vez al terminar, aunque Gladys se reinicie entretanto. Ambos
disparadores se pueden limitar a un aparato y a ciertas alarmas. Sus variables:
{{triggerEvent.data.appliance}}, zone, kind (temperature, door, offline), temperature,
target, unit y minutes (desde el inicio del problema).
Widget
El widget Liebherr muestra todos los aparatos, o el elegido en su configuración:
- una casilla por zona con su temperatura, en rojo durante una alarma;
- las alarmas en curso (o «Sin alarmas»), los aparatos sin conexión, los modos activos;
- con un solo aparato: los botones SuperCool, SuperFrost y PartyMode. Una marca indica un modo activo; una pulsación lo cambia.
Acciones de configuración
- Probar la conexión: lee los aparatos al momento y muestra, para cada uno, la temperatura y la consigna de sus zonas, o que está sin conexión.
Ejemplos de escenas
- Alarma del congelador: disparador Alarma Liebherr, alarma Temperatura demasiado alta; acción: enviar un mensaje «{{triggerEvent.data.appliance}} — {{triggerEvent.data.zone}}: {{triggerEvent.data.temperature}} {{triggerEvent.data.unit}} desde hace {{triggerEvent.data.minutes}} min».
- Corte de luz: disparador Alarma Liebherr, alarma Aparato sin conexión; acción: una notificación, y otra con Fin de alarma Liebherr.
- Compras: en la escena «Vuelta de la compra», encienda la función SuperFrost del congelador; se apaga sola.
- Noches tranquilas: cada noche a las 22:00, encienda NightMode; a las 7:00, apáguelo.
Solución de problemas
- «Clave de API rechazada»: la clave se copió mal o se sustituyó por otra. Genere una nueva clave en la aplicación SmartDevice y péguela en la configuración.
- «Clave aceptada, pero ningún aparato conectado»: el aparato está registrado pero no conectado. Compruebe su Wi-Fi en la aplicación SmartDevice.
- «Demasiadas solicitudes a Liebherr»: alargue el intervalo de actualización. La integración hace una pausa por sí sola y vuelve a empezar.
- Un aparato sigue «inaccesible»: compruebe que está conectado en la aplicación SmartDevice. Se queda en Gladys con sus últimos valores.
- Se rechaza una consigna: el aparato solo acepta su propio rango (indicado en el mensaje), y algunos modelos solo ciertos valores (los botones + y − los siguen).
- Más detalles en los registros de la integración, con
LOG_LEVEL=debug. La clave de API nunca aparece en los registros.
Limitaciones
- Desarrollada sin el hardware: los nombres de zonas, la AutoDoor y los aparatos en Fahrenheit no se han probado en un aparato real.
- La HomeAPI es un servicio beta de Liebherr: puede cambiar o desaparecer.
- Sin contacto de puerta salvo en los modelos AutoDoor, sin modo Vacaciones, sin alarma de corte de luz del propio aparato: la API no los ofrece.
- La AutoDoor no se puede abrir desde Gladys, a propósito.
- Los valores se leen cada 1 a 5 minutos: un cambio breve entre dos lecturas no se ve. Liebherr también ofrece un flujo en tiempo real (beta), no usado aquí.
- Las temperaturas son grados enteros, como los da la API.
- Los nombres de las funciones se fijan al añadir el dispositivo: cambiar el idioma después solo da nombre a los dispositivos nuevos.
Parámetros de configuración
Estos son los parámetros que Liebherr SmartDevice te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Liebherr | section | No | Los aparatos deben estar conectados en la aplicación SmartDevice. En la aplicación: Ajustes, Ser beta tester, active la HomeAPI, Generar nueva clave. Copie la clave enseguida: solo se muestra una vez. |
| Clave de API | secret | Sí | La clave generada en la aplicación SmartDevice. Una clave nueva sustituye a la anterior. |
| Intervalo de actualización | select | No | Frecuencia de lectura de la nube de Liebherr. Liebherr limita el número de llamadas: mantenga 2 minutos o más con varios aparatos. |
| Alarmas | section | No | La nube de Liebherr no informa de alarmas: la integración las deduce de las lecturas y activa los disparadores «Alarma Liebherr». |
| Margen de la alarma de temperatura | select | No | Alarma cuando una zona se mantiene así de por encima de su consigna. |
| Retardo de la alarma | select | No | Cuánto tiempo debe durar la temperatura (o el aparato sin conexión) antes de la alarma. |
| Retardo de la alarma de puerta (AutoDoor) | select | No | Solo los modelos AutoDoor informan de su puerta. |
| Idioma de los nombres de funciones | select | No | Nombres dados a las funciones al crear los dispositivos en Gladys. |
Cómo instalar Liebherr SmartDevice en Gladys
- En Gladys, abre Integraciones: Liebherr SmartDevice aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-liebherr:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-liebherr.
Liebherr SmartDevice requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Liebherr SmartDevice es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación