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

Controla tus equipos Delta Dore Tydom (persianas, luces, portones, termostatos) con tydom2mqtt.
Controla tus dispositivos Delta Dore Tydom desde Gladys: persianas, luces, portones y puertas de garaje, termostatos, además de sus sensores de batería y de temperatura.
Funcionamiento
Pasarela Tydom <──> tydom2mqtt <──> Broker MQTT <──> Gladys (esta integración)
La integración ejecuta tydom2mqtt en un subcontenedor gestionado por Gladys. tydom2mqtt se conecta a tu pasarela Tydom y publica tus dispositivos en tu broker MQTT. La integración los lee en el broker y envía tus órdenes a través de él.
Necesitas un broker MQTT accesible desde Gladys, por ejemplo el broker Mosquitto instalado por la integración MQTT de Gladys.
Configuración
- Abre la pestaña Configuración de la integración.
- Pasarela Tydom
- Dirección MAC: impresa debajo de la pasarela, empieza por
001A25. - Contraseña: la impresa debajo de la pasarela. Puedes dejarla vacía e indicar en su lugar tu cuenta Delta Dore (correo + contraseña): tydom2mqtt obtiene entonces él mismo la contraseña de la pasarela.
- Dirección IP: la IP local de la pasarela (recomendado, asígnale una
IP fija en tu router). Deja
mediation.tydom.compara pasar por la nube de Delta Dore.
- Dirección MAC: impresa debajo de la pasarela, empieza por
- Broker MQTT: host, puerto, usuario y contraseña de tu broker. Usa la
dirección IP local de la máquina que ejecuta el broker —
localhostapuntaría al interior de los contenedores. - Guarda. Gladys inicia tydom2mqtt con estos parámetros; tus dispositivos aparecen en la pestaña Descubrimiento en menos de un minuto, listos para ser añadidos.
Cada cambio de configuración reinicia tydom2mqtt con los nuevos valores.
¿Ya usas tydom2mqtt?
Si ya ejecutas tydom2mqtt por tu cuenta (docker-compose, complemento de Home Assistant…) en el mismo broker, desactiva Ejecutar tydom2mqtt desde Gladys: la integración se limita entonces a leer sus topics. Solo se necesitan los campos MQTT.
Dispositivos compatibles
| Dispositivo Tydom | En Gladys |
|---|---|
| Persiana | Abrir / cerrar / parar + posición (0 = cerrada) |
| Puerta de garaje | Abrir / cerrar / parar + posición |
| Luz | Encender/apagar + brillo |
| Portón, puerta (impulso) | Interruptor: cada orden envía un impulso TOGGLE |
| Termostato / caldera | Temperatura de consigna + temperatura actual |
| Sensores | Batería, temperatura, humedad, potencia, energía |
Aún no compatible: alarma, modos y preajustes de calefacción, inclinación de las lamas.
Acciones
- Resincronizar los dispositivos Tydom — pide a tydom2mqtt que recargue la configuración Tydom y vuelva a publicar todos los dispositivos. Úsala después de añadir un dispositivo a tu instalación Tydom.
Widgets del panel
Requiere Gladys 5.1.0 o posterior. En Panel → Editar → Añadir un widget, elige uno de los widgets Tydom. Solo muestran los dispositivos Tydom añadidos en Gladys, con el nombre que les diste.
- Dispositivo Tydom — un dispositivo a elegir: sus valores en directo (posición, brillo, consigna, temperatura, potencia, pila…), un gráfico del historial de 24 h y sus mandos (abrir / parar / cerrar una persiana, encender o apagar una luz o un portón, consigna ±0,5 °C en un termostato).
- Persianas Tydom — la posición de cada persiana, cuántas están abiertas o cerradas, y los botones Abrir todo / Parar todo / Cerrar todo (cerrar pide una confirmación). Se puede limitar a algunas persianas.
- Pilas Tydom — el nivel de pila de cada sensor Tydom, las más bajas primero: en rojo al 15 % o menos (o si el dispositivo indica un fallo de pila), en naranja al 30 % o menos. El ajuste Solo pilas bajas oculta las que están bien.
Solución de problemas
- Ningún dispositivo en Descubrimiento: consulta los registros del
subcontenedor tydom2mqtt en la página de la integración. Deben aparecer
Connected to mqtt brokery dispositivoscreated / updated. Una dirección MAC o una contraseña incorrecta se traduce en un error de autenticación frente a la pasarela. - «Broker MQTT inaccesible»: el host debe ser accesible desde los
contenedores de Gladys (IP local, no
localhost), y el usuario/contraseña aceptados por el broker. - Las persianas ya no responden (
ConnectionClosedOKen los registros de tydom2mqtt): la pasarela Tydom cerró su conexión y tydom2mqtt no se reconectó. La integración lo detecta (sin respuesta tras un comando, o un largo silencio) y reinicia tydom2mqtt automáticamente en menos de un minuto. Vuelve a enviar el comando cuando los dispositivos se hayan actualizado. - Un portón hace lo contrario de lo que se muestra: los portones se controlan por impulsos, el estado mostrado es el último comunicado por la pasarela Tydom.
Define LOG_LEVEL=debug para obtener todo el detalle de los registros de la
integración.
Parámetros de configuración
Estos son los parámetros que Tydom te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | Esta integración ejecuta tydom2mqtt junto a Gladys: se conecta a tu pasarela Tydom y publica tus dispositivos en tu broker MQTT. Gladys los lee y los controla a través de ese broker. Necesitas un broker MQTT accesible desde Gladys (por ejemplo, el de la integración MQTT de Gladys). |
| Pasarela Tydom | section | No | La dirección MAC está impresa debajo de la pasarela (empieza por 001A25). La contraseña es la impresa debajo de la pasarela; también puedes dejarla vacía e indicar tu cuenta Delta Dore para que tydom2mqtt la obtenga. |
| Dirección MAC de la Tydom | string | Sí | |
| Contraseña de la Tydom | secret | No | |
| Dirección IP de la Tydom | string | Sí | Dirección IP local de la pasarela (recomendado). Deja mediation.tydom.com para pasar por la nube de Delta Dore. |
| Correo de la cuenta Delta Dore | string | No | Opcional: solo es necesario si la contraseña de la Tydom se deja vacía. |
| Contraseña de la cuenta Delta Dore | secret | No | |
| Intervalo de consulta de la Tydom (s) | number | No | |
| Broker MQTT | section | No | Usa la dirección IP local de la máquina del broker: localhost apuntaría al interior de los contenedores. |
| Host MQTT | string | Sí | |
| Puerto MQTT | number | No | |
| Usuario MQTT | string | No | |
| Contraseña MQTT | secret | No | |
| Ejecutar tydom2mqtt desde Gladys | boolean | No | Desactívalo si ya ejecutas tydom2mqtt por tu cuenta en el mismo broker: Gladys solo leerá sus topics. |
Cómo instalar Tydom en Gladys
- En Gladys, abre Integraciones: Tydom 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/quentinlegay/gladys-tydom:2.1.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/quentinlegay/gladys-tydom.
Tydom 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
Tydom 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 quentinlegay, 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