Integración domótica devolo Home Network, gratuita y de código abierto
Velocidad PLC, Wi-Fi, Wi-Fi de invitados, LED, firmware y presencia Wi-Fi de sus adaptadores devolo.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Supervise y controle sus adaptadores PLC devolo desde Gladys: devolo Magic, dLAN y WiFi Repeater. La integración se comunica con los adaptadores en su red local, a través de la misma API que la app devolo Home Network: sin nube, sin cuenta.
Desarrollada sin el hardware: sus comentarios son bienvenidos. El protocolo procede de la biblioteca de código abierto de devolo y de la integración de Home Assistant, y las pruebas se ejecutan contra una red simulada. Si algo no funciona con sus adaptadores, abra una issue en el repositorio de GitHub.
Esta integración no está afiliada a devolo.
Presentación
- Un dispositivo por adaptador: en línea o no, la velocidad PLC hacia cada otro adaptador de la red, el número de dispositivos Wi-Fi conectados, la versión del firmware y si devolo ofrece una más reciente.
- Órdenes: Wi-Fi de invitados encendida/apagada, LED encendidos/apagados, «Identificar» (el adaptador parpadea) y «Reiniciar» si lo permite en la configuración.
- Presencia: los dispositivos Wi-Fi que elija (móviles…) se convierten en sensores de presencia: en casa mientras están conectados a un adaptador devolo.
- Widget: el estado de la red PLC de un vistazo.
- Escenas: un activador cuando un dispositivo nunca visto se une a la Wi-Fi, y acciones para activar (durante un tiempo) o apagar la Wi-Fi de invitados.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Adaptadores devolo con la API de devolo Home Network: devolo Magic 1 y 2 (LAN y WiFi), dLAN 1200+/550+ WiFi y los devolo WiFi Repeater. Los dLAN muy antiguos sin esta API no se pueden leer, pero aparecen como vecinos de los demás (con sus velocidades).
- Los adaptadores en la misma red local que Gladys. Si están en otra red (VLAN, subred), introduzca sus direcciones en la configuración.
- La contraseña del dispositivo si definió una en la app devolo Home Network (Ajustes del adaptador). Si no, deje el campo vacío.
Configuración
- En Gladys, abra Integraciones → devolo Home Network → Configuración.
- Rellene los campos si es necesario:
- Direcciones de los adaptadores (opcional): solo para los adaptadores que la búsqueda no
encuentra, separadas por comas (p. ej.
192.168.1.20, 192.168.1.21). Asígneles una dirección fija en su router: la integración también los vuelve a encontrar tras un cambio de dirección. - Contraseña del dispositivo: la de la app devolo Home Network, la misma para todos los adaptadores. Algunos firmwares la esperan cifrada con hash: la integración prueba ambas.
- Intervalo de actualización: con qué frecuencia se leen los LED, la Wi-Fi de invitados y los dispositivos Wi-Fi (30 segundos por defecto). Las velocidades PLC se leen cada 5 minutos, la búsqueda de actualizaciones cada 6 horas.
- Fuera tras: tiempo que un dispositivo Wi-Fi puede faltar antes de mostrarse fuera (3 minutos por defecto).
- Permitir reiniciar los adaptadores: desactivado por defecto. Activado, añade un botón «Reiniciar» a los adaptadores (actualícelos en la pestaña Descubrir).
- Idioma de los nombres de las funciones: francés por defecto.
- Direcciones de los adaptadores (opcional): solo para los adaptadores que la búsqueda no
encuentra, separadas por comas (p. ej.
- Pulse Buscar los adaptadores: la integración enumera lo que ha encontrado y si cada adaptador responde.
- En la pestaña Descubrir, añada los adaptadores y los dispositivos Wi-Fi que desee seguir.
Tráfico y cuotas: todo permanece en su red local, devolo no fija ninguna cuota para esta API. La integración envía unas pocas peticiones pequeñas por adaptador en cada actualización, una tras otra, como Home Assistant. Solo la búsqueda de actualizaciones hace que el adaptador contacte con el servidor de devolo, cada 6 horas.
Dispositivos
Adaptador devolo
| Función | Tipo | Lo que indica |
|---|---|---|
| En línea | sensor | 1 cuando el adaptador responde, 0 tras dos lecturas fallidas |
| Velocidad PLC hacia/desde | velocidad, Mbit/s | velocidad física del enlace PLC hacia y desde otro |
| Dispositivos Wi-Fi | contador | dispositivos conectados a su Wi-Fi (principal e invitados) |
| Wi-Fi de invitados | interruptor | activa o apaga la Wi-Fi de invitados |
| LED | interruptor | enciende o apaga los LED del adaptador |
| Firmware | texto | versión del firmware instalado |
| Actualización disponible | sensor | 1 cuando devolo ofrece un firmware más reciente |
| Identificar (parpadear) | botón | el adaptador parpadea un rato |
| Reiniciar | botón, opcional | reinicia el adaptador (solo si está permitido) |
Las funciones siguen lo que anuncia cada adaptador: un Magic 2 LAN no tiene Wi-Fi, un repetidor Wi-Fi no tiene velocidades PLC. Las velocidades existen para los adaptadores de la red PLC conocidos al añadir el dispositivo; si un adaptador se une a la red más tarde, la pestaña Descubrir propone actualizar el dispositivo. La actualización del firmware no se instala desde Gladys: use la app devolo Home Network.
Dispositivo Wi-Fi
| Función | Tipo | Lo que indica |
|---|---|---|
| Presencia | presencia (0/1) | 1 mientras el dispositivo está conectado a un adaptador devolo |
Los adaptadores solo dan la dirección MAC de un dispositivo Wi-Fi: la pestaña Descubrir lo llama «Dispositivo Wi-Fi 00:00:5E:…». Cámbiele el nombre después de añadirlo. Un móvil que use una dirección Wi-Fi aleatoria («privada») debe usar su dirección real en su red para que la presencia funcione.
Widget
Red PLC devolo: cuántos adaptadores están en línea, cuántos dispositivos Wi-Fi atienden, el enlace PLC más lento hacia el adaptador conectado al router (el que limita la velocidad de internet de una habitación) y una fila por adaptador: sus velocidades hacia el adaptador del router (verde desde 100 Mbit/s, naranja desde 30 Mbit/s, rojo por debajo), «Conectado al router» o «Sin conexión». Una actualización pendiente se indica en la fila. Un botón activa o apaga la Wi-Fi de invitados de todos los adaptadores. Ni direcciones MAC ni contraseñas: el panel puede mostrarse a las visitas.
Activador de escena
Nuevo dispositivo Wi-Fi: un dispositivo nunca visto se conecta a la Wi-Fi de un adaptador
devolo. Los dispositivos conectados en la primera lectura de un adaptador se aprenden sin activar
nada, y la lista se conserva entre reinicios. Filtro opcional: Wi-Fi principal o de invitados.
Variables: mac, adapter (el adaptador), network (main o guest), band (2.4 GHz o
5 GHz).
Acciones de escena
- Activar la Wi-Fi de invitados: en un adaptador o en todos los adaptadores con Wi-Fi,
opcionalmente durante un número de minutos (como máximo 1440): después el adaptador la apaga
solo. Salidas:
ssid(nombre de la Wi-Fi de invitados) ypassword(contraseña), para enviarlas en un mensaje. - Apagar la Wi-Fi de invitados: en un adaptador o en todos los adaptadores con Wi-Fi.
Ejemplos de escenas
- Llegan invitados: al pulsar un botón, active la Wi-Fi de invitados durante 240 minutos y envíe «Wi-Fi {{ssid}}, contraseña {{password}}» al chat de la familia.
- Dispositivo desconocido: con «Nuevo dispositivo Wi-Fi» en la Wi-Fi principal, envíe una notificación con la dirección MAC y el adaptador.
- Nadie en casa: cuando la presencia de todos los móviles pasa a 0, apague los LED de los adaptadores y la Wi-Fi de invitados; vuelva a encender los LED cuando alguien llegue.
- Enlace débil: cuando la «Velocidad PLC hacia …» del adaptador del despacho sigue por debajo de 50 Mbit/s, envíe una notificación (una regleta o un cargador pueden perturbar la línea).
Solución de problemas
- «No se ha encontrado ningún adaptador devolo»: compruebe que los adaptadores están en la misma red que Gladys, vuelva a ejecutar «Buscar los adaptadores» o introduzca sus direcciones en la configuración.
- «ha rechazado la contraseña»: introduzca la contraseña del dispositivo de la app devolo Home Network; deje el campo vacío si no hay ninguna. El estado indica qué adaptador la rechaza.
- Un adaptador «no responde»: está desenchufado, en reposo o ha cambiado de dirección. La integración vuelve a buscar en la red tras varias lecturas fallidas.
- Sin velocidad para un adaptador: las velocidades PLC llegan cada 5 minutos; los repetidores solo Wi-Fi no tienen.
- Un dispositivo Wi-Fi sigue fuera: quizá esté conectado a la Wi-Fi de su router en lugar de a un adaptador devolo, o use una dirección Wi-Fi aleatoria.
- Registros: Integraciones → devolo Home Network → Logs.
LOG_LEVEL=debugmuestra cada lectura.
Límites
- La presencia solo ve los dispositivos conectados a una Wi-Fi devolo, no a su router ni a otro punto de acceso.
- Cuando ningún adaptador Wi-Fi responde, la presencia no cambia.
- El nombre y la contraseña de la Wi-Fi de invitados son los de la app devolo Home Network; no se pueden cambiar desde Gladys.
- Las actualizaciones de firmware, el emparejamiento, el WPS y los ajustes Wi-Fi quedan en la app devolo Home Network.
- Las centrales devolo Home Control no son compatibles (no son adaptadores de red).
- Las velocidades son las velocidades físicas que anuncian los adaptadores, no el caudal real.
- Desarrollada sin el hardware: el comportamiento con adaptadores reales aún no se ha comprobado.
Parámetros de configuración
Estos son los parámetros que devolo Home Network te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus adaptadores devolo | section | No | Gladys encuentra los adaptadores (Magic, dLAN, WiFi Repeater) en la red: ejecute «Buscar los adaptadores» y añádalos en la pestaña Descubrir. Introduzca sus direcciones solo si están en otra red, y la contraseña del dispositivo solo si definió una en la app devolo Home Network. |
| Direcciones de los adaptadores (opcional) | string | No | Solo para los adaptadores que la búsqueda no encuentra. Varias direcciones: sepárelas con comas. |
| Contraseña del dispositivo | secret | No | La definida en la app devolo Home Network, la misma para todos los adaptadores. Vacío: sin contraseña. |
| Intervalo de actualización | select | No | Con qué frecuencia se leen los LED, la Wi-Fi de invitados y los dispositivos Wi-Fi. Velocidades PLC: cada 5 minutos. |
| Fuera tras | select | No | Tiempo que un dispositivo Wi-Fi puede faltar antes de mostrarse fuera. Los móviles en reposo desaparecen unos minutos. |
| Permitir reiniciar los adaptadores | boolean | No | Añade un botón «Reiniciar» a los adaptadores. Un reinicio corta la red durante un minuto aproximadamente. |
| Idioma de los nombres de las funciones | select | No | Nombres de las funciones de los nuevos dispositivos e idioma de los mensajes. |
Cómo instalar devolo Home Network en Gladys
- En Gladys, abre Integraciones: devolo Home Network 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-devolo: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-devolo.
devolo Home Network 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
devolo Home Network 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