Saltar al contenido principal

Integración domótica ConnectLife, gratuita y de código abierto

Integración ConnectLife para Gladys Assistant

Aparatos Hisense, Gorenje y ASKO de la app ConnectLife: clima, ropa, vajilla, horno, frigorífico.

Presentación​

Esta integración trae a Gladys los aparatos Hisense, Gorenje y ASKO que usted controla con la aplicación ConnectLife: aires acondicionados, deshumidificadores, lavadoras, secadoras, lavavajillas, hornos y frigoríficos. Los lee en la nube de ConnectLife, la misma que usa la aplicación, y controla los aires acondicionados y los deshumidificadores.

Es una integración comunitaria, no afiliada a Hisense, Gorenje, ASKO ni ConnectLife. ConnectLife no tiene API pública: la integración habla el protocolo de la aplicación, tal como lo ha documentado la comunidad, y puede dejar de funcionar si el fabricante lo cambia.

Desarrollada sin el hardware: se ha escrito y probado con respuestas grabadas de la nube de ConnectLife, no con un aparato real. Sus comentarios son bienvenidos en el foro de Gladys.

Requisitos​

  • Gladys Assistant 5.1.0 o posterior.
  • Una cuenta ConnectLife (el correo y la contraseña de la aplicación), con sus aparatos ya añadidos en la aplicación. Una cuenta creada con Google, Apple o Facebook no tiene contraseña: añada una en la aplicación primero.
  • Acceso a Internet desde Gladys: todo pasa por la nube de ConnectLife.

Configuración​

  1. Instale la integración (Integraciones → Instalar desde GitHub si todavía no está en la tienda).
  2. En su pestaña Configuración, introduzca el correo y la contraseña de ConnectLife.
  3. Elija el intervalo de actualización (1, 2, 3 o 5 minutos; 2 por defecto). Una petición lee todos los aparatos de la cuenta, sea cual sea su número.
  4. Elija el idioma de los nombres de funciones (francés por defecto).
  5. Guarde: los aparatos aparecen en la pestaña Descubrimiento. Añada los que desee.

El botón Listar mis aparatos lee la cuenta en el acto e indica lo que ha encontrado la integración: cada aparato, su tipo, si Gladys puede controlarlo y si está sin conexión.

Aparatos​

Cada aparato tiene una función Conexión (en línea / sin conexión). Un aparato sin conexión solo actualiza esta: sus demás valores siguen siendo los de la última lectura.

Aires acondicionados​

Aires acondicionados split, portátiles y de ventana:

  • Encendido / apagado — orden.
  • Modo — automático, frío, calor, deshumidificación, ventilación, orden. Solo se ofrecen los modos del modelo (los de ventana no calientan).
  • Temperatura objetivo — de 16 a 32 °C (30 °C para los de ventana), orden.
  • Velocidad del ventilador — las velocidades del modelo, orden.
  • Temperatura de la estancia y humedad de la estancia, cuando el aparato las mide.

Un aparato configurado en Fahrenheit se muestra y se controla en Celsius en Gladys.

Deshumidificadores​

  • Encendido / apagado — orden.
  • Modo — continuo, manual, automático, secado de ropa, orden.
  • Velocidad del ventilador — baja, media, alta, automática, orden.
  • Humedad de la estancia y humedad objetivo (solo lectura: Gladys no tiene control de consigna de humedad).

Lavadoras, secadoras y lavavajillas​

En solo lectura:

  • Estado — apagado, en espera, inicio diferido, en marcha, en pausa, terminado, error.
  • Tiempo restante — en minutos, 0 fuera de un ciclo.
  • Programa y Fase — el código que da el aparato («Programa 9»). Sus nombres dependen del modelo y la integración no los conoce.
  • Puerta — abierta / cerrada.

No se ofrece iniciar un ciclo desde Gladys: una máquina se carga y se cierra delante de ella.

Hornos​

En solo lectura, a propósito (una fuente de calor): Estado, Temperatura del horno, Tiempo restante y Puerta.

Frigoríficos​

En solo lectura: Temperatura del frigorífico y Temperatura del congelador, con sus consignas, para los compartimentos del modelo. Las consignas no son órdenes: un valor erróneo estropearía los alimentos.

Otros aparatos​

Placas, campanas, bombas de calor, vinotecas y los tipos que la integración aún no conoce aparecen solo con su Conexión, en solo lectura. El botón Listar mis aparatos los indica como «aún no compatible».

Widget​

El widget Aparatos ConnectLife muestra una línea por aparato (diez como máximo): la lavadora en marcha con el tiempo restante, el lavavajillas terminado, el aire acondicionado encendido, las temperaturas del frigorífico, un aparato sin conexión. Sigue el idioma del panel.

Disparador de escena​

Ciclo de un aparato terminado inicia una escena cuando una lavadora, una secadora o un lavavajillas termina su ciclo. Elija opcionalmente el aparato o los tipos de aparato; si se dejan vacíos, todos coinciden.

Las acciones siguientes de la escena pueden usar:

  • {{triggerEvent.data.device_name}} — el nombre del aparato;
  • {{triggerEvent.data.appliance_type}} — washing_machine, tumble_dryer o dishwasher;
  • {{triggerEvent.data.duration_minutes}} — la duración durante la que la integración vio funcionar el ciclo;
  • {{triggerEvent.data.program}} — el código del programa, cuando el aparato lo da.

Un ciclo detenido a mano antes del final no lo dispara. El final se detecta en la siguiente lectura de la nube, es decir, con un intervalo de actualización de retraso como máximo.

Ejemplos de escenas​

  • La ropa está lista: disparador «Ciclo de un aparato terminado», tipo «Lavadora» → enviar un mensaje «La ropa está lista ({{triggerEvent.data.duration_minutes}} min)».
  • Refrescar el dormitorio antes de acostarse: a las 21:30, si el dormitorio supera los 26 °C → poner el aire acondicionado del dormitorio en frío, 24 °C, encendido.
  • No queda nadie en casa: cuando sale la última persona → apagar los aires acondicionados.

Solución de problemas​

  • «ConnectLife ha rechazado el correo o la contraseña»: compruébelos en la aplicación. La integración deja entonces de intentarlo hasta que vuelva a guardar la configuración: los fallos repetidos bloquean la cuenta.
  • «Acepte sus nuevas condiciones»: abra la aplicación ConnectLife y acepte las nuevas condiciones; la integración lo vuelve a intentar cada 30 minutos.
  • «La nube de ConnectLife no responde»: la nube o su acceso a Internet no funcionan. La integración lo vuelve a intentar en cada actualización.
  • Falta un aparato: compruébelo en la aplicación y pulse Listar mis aparatos.
  • Un valor parece erróneo: el significado de algunos códigos depende del modelo. Abra una incidencia con el modelo del aparato y lo que muestra la aplicación.
  • Los registros permanecen tranquilos en funcionamiento normal; defina LOG_LEVEL=debug en el contenedor para ver cada lectura.

Limitaciones​

  • Solo nube: sin control local. Los valores tienen como máximo un intervalo de actualización de retraso.
  • La nube de ConnectLife no publica ninguna cuota; la integración la lee una vez por intervalo (una petición para todos los aparatos) y conserva sus tokens de sesión para no volver a iniciar sesión.
  • No se conocen los nombres de los programas ni de las fases: solo códigos.
  • Sin inicio remoto de lavadoras, secadoras, lavavajillas u hornos, ni orden de consigna del frigorífico.
  • Solo la nube europea de ConnectLife (las cuentas de la aplicación en Europa).

Datos y privacidad​

El correo y la contraseña permanecen en la configuración de Gladys. Los tokens de sesión de la nube se guardan en el volumen /data de la integración (archivo connectlife-tokens.json, legible solo por la integración), marcados con una huella del correo, nunca con la contraseña. No se almacena nada más, y no se envía nada a ningún otro sitio que a la nube de ConnectLife.

Parámetros de configuración​

Estos son los parámetros que ConnectLife te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Su cuenta ConnectLifesectionNoUtilice el correo y la contraseña de la aplicación ConnectLife. La integración lee sus aparatos en la nube de ConnectLife; no está afiliada a Hisense, Gorenje ni ASKO.
Correo de ConnectLifestringSí
Contraseña de ConnectLifesecretSí
Intervalo de actualizaciónselectNoFrecuencia de lectura de la nube de ConnectLife. Una petición lista todos los aparatos.
Idioma de los nombres de funcionesselectNoNombres de las funciones de los aparatos nuevos y textos como el estado.

Cómo instalar ConnectLife en Gladys​

  1. En Gladys, abre Integraciones: ConnectLife aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-connectlife: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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-connectlife.

ConnectLife 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​

ConnectLife 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂