Integración domótica TP-Link Deco, gratuita y de código abierto
Wi-Fi mallado TP-Link Deco: presencia, estado de los Deco, Wi-Fi de invitados y reinicios.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Lleva su Wi-Fi mallado TP-Link Deco a Gladys: quién está en casa (los teléfonos en el Wi-Fi), el estado de cada Deco de la red y dos comandos para sus escenas: el Wi-Fi de invitados y el reinicio de un Deco. Todo se queda en su red local: la integración habla directamente con el Deco principal, nunca con la nube de TP-Link.
Sin relación con TP-Link. Desarrollada sin el hardware: sus comentarios son bienvenidos — la integración se prueba contra un Deco simulado que habla el verdadero protocolo cifrado, construido a partir de respuestas publicadas de Deco reales, todavía no contra uno real.
Presentación
- Presencia: cada teléfono, ordenador o dispositivo conectado a la red puede convertirse en un sensor de presencia, con un retardo de salida para que un teléfono en reposo no «se vaya» cada pocos minutos.
- Un dispositivo por Deco: en línea, Internet, clientes conectados, clientes invitados, función (Deco principal o satélite), versión del firmware y, para un satélite, la velocidad de su enlace con la red.
- Disparadores de escena: un dispositivo desconocido se conecta a la red, un Deco pasa a estar fuera de línea.
- Comandos (desactivados por defecto): activar o desactivar el Wi-Fi de invitados, reiniciar un Deco.
- Widget del panel: clientes, invitados, el estado de cada Deco y quién está en casa.
Modelos: la gama Deco que gestiona la app Deco y que tiene una página web local (X20, X50, X55, X60, X68, M4, M5, M9 Plus, BE65, BE85…). Gladys 5.1 o posterior.
Requisitos previos
- Una red Deco instalada con la app Deco, y la dirección IP del Deco principal — el conectado
a su router de Internet. La app Deco la muestra: Red → el Deco principal → Dirección IP (a menudo
192.168.68.1en modo router). En modo punto de acceso, es la dirección que le dio su router. - La contraseña del ID de TP-Link propietario de la red en la app Deco: la API web local del Deco
solo acepta la cuenta propietaria, con el usuario
admin, no una cuenta de administrador secundario. - El Deco solo admite una sola sesión de administración a la vez. La integración inicia sesión en cada lectura y la cierra enseguida, pero mientras lee, un inicio de sesión en otro lugar termina una de las dos sesiones. TP-Link recomienda un segundo ID de TP-Link, añadido como administrador en la app Deco, para su propio uso de la app.
Configuración
En Gladys, Integraciones → Instalar desde GitHub con la dirección de este repositorio, y luego Integraciones → TP-Link Deco → Configuración:
| Campo | Qué introducir |
|---|---|
| Dirección del Deco principal | Su dirección IP, p. ej. 192.168.68.1. Añada https:// solo si http no responde. |
| Contraseña de la app Deco | La contraseña del ID de TP-Link propietario. Nunca se muestra ni se registra. |
| Ofrecer los clientes de la red en Descubrir | Activado por defecto: los clientes en línea aparecen en la pestaña Descubrir. |
| Retardo de salida (minutos) | 5 por defecto: tiempo de ausencia antes de que un cliente se considere fuera (0 a 120). |
| Intervalo de actualización | 1 minuto por defecto; 30 segundos, 2 o 5 minutos. Cada lectura es un inicio de sesión. |
| Permitir el control del Wi-Fi de invitados | Desactivado por defecto. Pone el interruptor del Wi-Fi de invitados en el Deco principal. |
| Permitir los reinicios | Desactivado por defecto. Permite la acción y la acción de escena «Reiniciar un Deco». |
| Idioma de los nombres de las funciones | Francés por defecto; inglés, alemán o español. Se fijan al añadir un dispositivo. |
Ejecute después Probar la conexión (pantalla Configuración): inicia sesión, cuenta los Deco y los clientes, y cierra la sesión. El Deco cuenta las contraseñas erróneas y bloquea el acceso tras varias de ellas: una contraseña rechazada pone en pausa la lectura hasta que la corrija, para que la integración nunca bloquee su cuenta.
Con qué frecuencia se lee el Deco: al intervalo elegido, por la propia integración (Gladys 5.2 no consulta los dispositivos externos de forma fiable). Una lectura es una sesión: las claves, el inicio de sesión, la lista de los Deco, una lista de clientes por Deco, la red de invitados cuando su control está permitido, y el cierre de sesión — unas diez peticiones pequeñas. El Deco no tiene cuota publicada; una vez por minuto es el ritmo de la integración de Home Assistant (30 segundos en ella). Abrir un panel nunca lee el Deco.
Dispositivos
Vaya a Integraciones → TP-Link Deco → Descubrir y añada lo que desee seguir.
Un Deco (un dispositivo por Deco de la red):
| Función | Valor |
|---|---|
| En línea | 1 cuando el Deco forma parte de la red, 0 cuando se ha desconectado. |
| Internet | 1 cuando el Deco alcanza Internet. |
| Clientes conectados | Los clientes conectados a través de este Deco (Wi-Fi y por cable). |
| Clientes invitados | Los de ellos en la red de invitados. |
| Función | Deco principal o Satélite. |
| Versión del firmware | Tal como la indica el Deco, p. ej. 1.8.0 Build 25102213 Rel. 43970. |
| Velocidad del enlace | Solo satélites: la velocidad del enlace con la red, en Mbit/s (Wi-Fi o Ethernet). |
| Wi-Fi de invitados | Solo el Deco principal, una vez activado «Permitir el control del Wi-Fi de invitados»: un interruptor. |
Un cliente de la red (un teléfono, un ordenador…): una función Presencia, a 1 cuando el cliente está conectado a la red (o se fue hace menos que el retardo de salida), a 0 en caso contrario. Un cliente añadido a Gladys permanece en la lista de Descubrir cuando está ausente.
Tras activar «Permitir el control del Wi-Fi de invitados», abra la pestaña Descubrir y haga clic en Actualizar en el Deco principal: aparece el interruptor.
Widget
Añada el widget Red Deco a un panel. Muestra tres mosaicos (clientes conectados, invitados, Deco en línea), los clientes que ha añadido a Gladys con En casa o Ausente, y el estado de cada Deco: su número de clientes, Sin Internet o Fuera de línea. Se construye a partir de la última lectura del Deco y no le cuesta nada.
Disparadores de escena
| Disparador | Cuándo | Variables |
|---|---|---|
| Dispositivo desconocido conectado | Un dispositivo nunca visto en la red se une a ella. Filtros: conexión, red de invitados. | nombre, dirección MAC, dirección IP, conexión, banda Wi-Fi, conectado a |
| Deco fuera de línea | Un Deco se desconecta de la red: desenchufado, fuera de alcance, reiniciándose. Filtro: Deco. | nombre del Deco, modelo |
La primera lectura solo aprende los dispositivos ya presentes: instalar la integración o reiniciarla no
dispara nada. Los dispositivos vistos se guardan en /data (solo direcciones MAC).
Comandos
Ambos están desactivados por defecto: active primero su opción en la configuración.
- Wi-Fi de invitados: el interruptor del Deco principal activa o desactiva la red de invitados en cada banda que tenga una. La red de invitados debe existir (créela en la app Deco). Úselo en una escena como cualquier interruptor.
- Reiniciar un Deco: una acción de la pantalla Configuración y una acción de escena, nunca un interruptor. La zona de ese Deco pierde el Wi-Fi unos minutos; reiniciar el Deco principal corta toda la red, Gladys incluido si pasa por él.
Ejemplos de escenas
- Bienvenida: cuando la «Presencia» de un teléfono pasa a 1 después de las 18:00, encender la luz de la entrada.
- Intruso en la red: con «Dispositivo desconocido conectado» y red de invitados «No», enviar un mensaje con el nombre y la dirección MAC del dispositivo.
- Invitados: cada sábado a las 14:00 activar el Wi-Fi de invitados, a las 23:00 desactivarlo.
- Reinicio semanal: cada lunes a las 4:00, «Reiniciar un Deco» en un satélite que tiende a ir más lento.
Solución de problemas
- «Contraseña rechazada»: compruebe la contraseña del ID de TP-Link propietario (no un administrador secundario). La lectura está en pausa: corrija la contraseña o ejecute «Probar la conexión».
- «Inicio de sesión rechazado»: el Deco bloquea el acceso un tiempo tras contraseñas erróneas. Espere unos minutos.
- «Otra conexión ha tomado la sesión»: alguien inició sesión en la página web del Deco durante una lectura. La siguiente lectura vuelve a conectarse; cierre la página web cuando termine.
- La app Deco cierra su sesión: la cuenta propietaria de la app y la integración comparten el mismo administrador. Use una cuenta de administrador secundario en la app, como recomienda TP-Link.
- «Sin respuesta»: compruebe la dirección IP del Deco principal (app Deco) y que Gladys lo alcanza.
Algunos firmwares solo responden en
https://: la integración sigue esa redirección por sí misma. - «No responde como el Deco principal»: la dirección no es la del Deco principal, o el firmware usa un inicio de sesión antiguo (Deco S7, algunos firmwares viejos) que la integración no admite.
- Registros: Integraciones → TP-Link Deco → Registros;
LOG_LEVEL=debugmuestra cada lectura.
Limitaciones
- Desarrollada sin el hardware: el protocolo sigue la integración de Home Assistant
tplink_deco; informe de cualquier diferencia con su modelo. - El Deco admite una sesión de administración: la integración y la página web del Deco se interrumpen mutuamente mientras una de ellas lee.
- Los firmwares con el inicio de sesión cifrado antiguo (HTTP 401 en las claves, Deco S7) no se admiten.
- La pérdida del propio Deco principal aparece como «Deco principal inaccesible» en la integración, no como un disparador «Deco fuera de línea»: los satélites solo se ven a través de él.
- La presencia depende de que el teléfono siga en el Wi-Fi: los teléfonos que cambian su dirección MAC necesitan una dirección fija (dirección privada desactivada) para esta red.
- Sin nube: el Deco debe ser accesible en la red local; la nube de TP-Link nunca se usa.
Parámetros de configuración
Estos son los parámetros que TP-Link Deco te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Deco principal | section | No | El Deco conectado a su router de Internet. Su API web local solo admite una sesión de administración a la vez: la integración cierra la sesión tras cada lectura, y un inicio de sesión en la página web del Deco interrumpe la integración. |
| Dirección del Deco principal | string | Sí | Su dirección IP en la red, visible en la app Deco (Red > el Deco principal). Añada https:// solo si http no responde. |
| Contraseña de la app Deco | secret | Sí | La contraseña del ID de TP-Link propietario de la red en la app Deco (el propietario, no un administrador). El Deco bloquea el acceso tras varias contraseñas erróneas. |
| Presencia y actualización | section | No | Los clientes en línea aparecen en la pestaña Descubrir: añada los teléfonos que desea seguir, cada uno se convierte en un sensor de presencia. |
| Ofrecer los clientes de la red en Descubrir | boolean | No | |
| Retardo de salida (minutos) | number | No | Tiempo de ausencia antes de que un cliente se considere fuera (un teléfono en reposo deja el Wi-Fi un rato). |
| Intervalo de actualización | select | No | Cada lectura es un inicio de sesión en el Deco. Cada 30 segundos para una presencia rápida; cada 2 o 5 minutos para no cargar el Deco. |
| Comandos (desactivados por defecto) | section | No | Reiniciar un Deco corta el Wi-Fi de su zona unos minutos, el Deco principal toda la red: active solo lo que necesiten sus escenas. El interruptor del Wi-Fi de invitados aparece en el Deco principal una vez permitido (Descubrir > Actualizar). |
| Permitir el control del Wi-Fi de invitados | boolean | No | |
| Permitir los reinicios | boolean | No | |
| Idioma de los nombres de las funciones | select | No | También se usa para los mensajes de la integración. Los nombres se fijan al añadir un dispositivo. |
Cómo instalar TP-Link Deco en Gladys
- En Gladys, abre Integraciones: TP-Link Deco 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-deco: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-deco.
TP-Link Deco 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
TP-Link Deco 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