Saltar al contenido principal

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

Integración TCL Home para Gladys Assistant

Controle sus aires acondicionados, deshumidificadores y purificadores TCL vía TCL Home.

Esta integración conecta Gladys con su cuenta TCL Home y controla los aparatos TCL añadidos a ella: aires acondicionados, deshumidificadores y purificadores de aire Breeva.

Antes de empezar​

  • Se necesita Gladys 5.3 o posterior.
  • Sus aparatos deben funcionar primero en la app móvil TCL Home: añádalos allí, Gladys no los empareja.
  • Es una integración en la nube: Gladys pasa por la nube TCL Home, como la app. Gladys necesita Internet, y nada funciona mientras la nube de TCL esté caída. Los aparatos TCL no ofrecen control local.

TCL no publica ninguna API oficial: esta integración hace lo que hace la app TCL Home. TCL puede cambiarla en cualquier momento. No está afiliada a TCL.

Configuración​

En Gladys, abra Integraciones → TCL Home → Configuración:

CampoQué introducir
Correo de TCL HomeEl correo con el que inicia sesión en la app TCL Home
Contraseña de TCL HomeLa contraseña de esa cuenta
Intervalo de actualización (s)Cada cuánto se lee cada dispositivo, en segundos (60 a 3600, 60 por defecto)

Guarde y pulse Probar la conexión: lista los dispositivos encontrados, cuántos están en línea y los dispositivos TCL que esta integración no controla (un televisor, por ejemplo).

Después abra la pestaña Descubrir de la integración y añada sus dispositivos.

Consejo: cree una segunda cuenta TCL Home, compártale su hogar desde la app y dé esa cuenta a Gladys. Así su propia contraseña sigue siendo solo suya.

Dispositivos y funciones​

Una función solo aparece si su equipo la indica: un modelo sin oscilación horizontal no tiene control de oscilación horizontal.

Aires acondicionados​

Split, de ventana, portátiles, por conductos, de columna y de aire fresco.

FunciónEn Gladys
EncendidoEncendido / apagado
ModoAutomático, frío, deshumidificar, ventilador, calor (según el equipo)
Temperatura objetivo16 a 31 °C, en grados enteros
Velocidad del ventiladorAutomático, silencioso, baja, media-baja, media, media-alta, alta, turbo
Oscilación vertical / horizontalApagada, oscilar o una de 5 posiciones fijas
Temperatura interiorMedida por el equipo
Temperatura de la unidad exteriorSi el equipo la indica
Eco, sueño, salud, secado antimoho, pantalla, pitidoInterruptores encendido / apagado

En un equipo portátil, el modo automático y la velocidad del ventilador solo existen en los modelos con lama oscilante.

Deshumidificadores​

Encendido y humedad de la habitación.

Purificadores de aire Breeva​

Encendido, PM2.5, pantalla y bloqueo infantil.

Actualización​

Gladys lee cada dispositivo al intervalo elegido. Tras una orden, la integración vuelve a leer el dispositivo unos segundos después, para que Gladys muestre lo que realmente hizo.

Un dispositivo sin conexión muestra una insignia inaccesible; en línea, una insignia nube.

Escenas​

Disparadores​

DisparadorCuándoVariable
Dispositivo TCL en línea / sin conexiónUn dispositivo pierde o recupera su conexiónstatus: online u offline
Error de un dispositivo TCLUn dispositivo informa de un nuevo código de errorcode: el o los códigos, separados por comas

Ambos pueden limitarse a un dispositivo. Se disparan con un cambio: un dispositivo ya sin conexión, o un error ya presente al arrancar Gladys, no los dispara.

Acciones​

AcciónQué haceSalida
Ajustar un aire acondicionado TCLEnciende el equipo con el modo, la temperatura y la velocidad elegidos (vacío: sin cambios)applied (verdadero/falso)
Apagar todos los dispositivos TCLApaga todos los dispositivos TCL encendidoscount
Iniciar autolimpieza TCLInicia el ciclo de autolimpieza del equipo (lo detiene), si el modelo lo tienestarted (verdadero/falso)

Un equipo sin conexión no detiene la escena: la salida vale false, úsela en una condición si hace falta.

Ejemplo: «Cuando salgo de casa, apagar todos los dispositivos TCL», o «A las 18 h en verano, poner el equipo del salón en frío a 24 °C».

Widget del panel​

Añada el widget TCL Home a un panel. Muestra:

  • el estado de la cuenta TCL Home y luego cada dispositivo: apagado, sin conexión, o su modo y temperatura objetivo;
  • la temperatura interior en directo de los primeros aires acondicionados;
  • los botones Ajustar un aire (equipo, modo, temperatura, ventilador), Apagar todo y Actualizar.

Solución de problemas​

Mensaje o síntomaQué hacer
«TCL Home rechaza el correo o la contraseña»Compruébelos iniciando sesión en la app TCL Home. Una cuenta creada con Google o Apple no tiene contraseña: defina una en la app, o use una segunda cuenta.
«No se puede contactar con TCL Home»Compruebe el acceso a Internet de Gladys. La integración lo reintenta sola cada 5 minutos.
Falta un dispositivo¿Está en la app TCL Home, en la misma cuenta? «Probar la conexión» lista los no compatibles.
Una orden falla con «is offline»El dispositivo no está conectado a la nube de TCL: compruebe su Wi-Fi en la app TCL Home.
El estado cambia con retrasoLa nube se lee al intervalo de actualización: redúzcalo (60 s como mínimo).

Ponga el nivel de registro en debug (variable de entorno LOG_LEVEL) para ver cada llamada. Las contraseñas y los tokens nunca se escriben en los registros.

Privacidad​

  • Gladys guarda la contraseña en un campo secreto y solo se envía a TCL, como hash MD5, igual que hace la app.
  • Los tokens de TCL y las credenciales temporales de AWS se quedan en memoria, no se escribe nada en disco.
  • La integración solo habla con TCL (*.tcl.com, *.tcljd.com) y Amazon Web Services (*.amazonaws.com), por HTTPS.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Primeros pasossectionNoEsta integración pasa por la nube TCL Home, como la app móvil: sus dispositivos deben añadirse primero en la app TCL Home. Introduzca abajo el correo y la contraseña de esa cuenta. Gladys lee entonces los dispositivos cada minuto (o al intervalo elegido) y envía sus órdenes por la nube: se necesita conexión a Internet.
Correo de TCL HomestringSíEl correo con el que inicia sesión en la app TCL Home.
Contraseña de TCL HomesecretSíLa contraseña de esa cuenta. Solo se envía a TCL y nunca se registra.
Intervalo de actualización (s)numberNoCada cuánto se lee cada dispositivo en la nube, en segundos (60 a 3600).

Cómo instalar TCL Home en Gladys​

  1. En Gladys, abre Integraciones: TCL Home 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/prohand/gladys-tclhome:0.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/prohand/gladys-tclhome.

TCL Home requiere Gladys >=5.3.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​

TCL Home 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 prohand, 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 🙂