Integración domótica FRITZ!Box, gratuita y de código abierto
Estado y velocidad de internet, Wi-Fi de invitados, presencia y llamadas de su FRITZ!Box.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Conecte su FRITZ!Box de AVM a Gladys: estado y velocidad de internet, IP externa, un Wi-Fi de invitados que puede activar y apagar desde Gladys, la presencia de los móviles y ordenadores que elija (quién está en casa) y, si lo desea, sus llamadas telefónicas como activadores de escena. Todo se queda en su red local: la integración habla con la box mediante TR-064, la interfaz oficial documentada por AVM, y mediante el monitor de llamadas de la box. Sin nube, sin cuenta MyFRITZ!.
Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración está cubierta por pruebas automáticas basadas en respuestas reales de FRITZ!Box (recogidas por la biblioteca fritzconnection y por Home Assistant), pero aún no ha funcionado con una box real. Cuéntenos en el foro de Gladys cómo se comporta con su modelo.
Lo que obtiene
-
Un dispositivo FRITZ!Box:
Función Tipo en Gladys Muestra Internet estado de entrada (On/Off) On cuando la box está conectada a internet Descarga velocidad, en Mbit/s tráfico entrante actual de la línea (gráfico histórico) Subida velocidad, en Mbit/s tráfico saliente actual Velocidades de la línea velocidad, en Mbit/s (dos funciones) velocidades máximas de bajada y subida de la línea (sincronización DSL…) IP externa texto dirección IPv4 pública de la box Tiempo de conexión duración, en minutos tiempo desde la última (re)conexión Wi-Fi de invitados interruptor activado/desactivado, controlable desde Gladys Reconectar pulsador una nueva conexión a internet (IP nueva en la mayoría de líneas DSL) -
Un dispositivo por cada equipo de red que elija (móvil, ordenador, tableta…), con una función Presencia: presente mientras la box lo ve conectado, fuera tras un retraso que usted ajusta.
-
Un widget de panel FRITZ!Box: velocidades, estado de internet, Wi-Fi de invitados con su botón, quién está en casa y un botón Reconectar internet.
-
Los activadores de escena Llamada entrante, Llamada perdida, Llamada finalizada (con el número y el nombre de la agenda de la box), Conexión a internet restablecida e IP externa cambiada.
-
Las acciones de escena Activar el Wi-Fi de invitados (durante un tiempo si lo desea, con su nombre y contraseña para un mensaje a sus invitados), Apagar el Wi-Fi de invitados y Reconectar internet.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Una FRITZ!Box con FRITZ!OS 7 o posterior (las box con FRITZ!OS 6.x también responden por TR-064, con menos detalles), accesible desde la máquina de Gladys. Los FRITZ!Repeater y las box usadas como repetidor mesh solo tienen el Wi-Fi de invitados y la presencia.
- Un usuario de FRITZ!Box con contraseña y el permiso Ajustes de FRITZ!Box (interfaz en alemán: FRITZ!Box Einstellungen). Para los nombres de quienes llaman, también el permiso Mensajes de voz, faxes, FRITZ!App Fon y lista de llamadas (Sprachnachrichten, Faxnachrichten, FRITZ!App Fon und Anrufliste).
- Durante la instalación, Gladys le pide autorizar la búsqueda SSDP de urn:dslforum-org:device:InternetGatewayDevice:1: permite a la integración encontrar la box sin su dirección.
Configuración
Preparar la FRITZ!Box
Abra la interfaz de la box (http://fritz.box):
- Red doméstica > Red > Ajustes de red (Heimnetz > Netzwerk > Netzwerkeinstellungen): marque Permitir el acceso a aplicaciones (Zugriff für Anwendungen zulassen) y Transmitir información de estado por UPnP (Statusinformationen über UPnP übertragen, necesario para las velocidades actuales). Aplique.
- Sistema > Usuarios de FRITZ!Box (System > FRITZ!Box-Benutzer): añada un usuario para Gladys, con contraseña y los permisos indicados arriba. Un usuario dedicado es mejor que el suyo: puede eliminarlo en cualquier momento.
- Solo para las llamadas: en un teléfono conectado a la box (analógico, DECT o IP), marque
#96*5*para activar el monitor de llamadas (#96*4*lo desactiva).
Ajustes
En Integraciones → FRITZ!Box → Configuración:
| Ajuste | Por defecto | Efecto |
|---|---|---|
| Dirección de la FRITZ!Box | vacío | Vacío: la box se busca en la red (después fritz.box). Si no, su dirección IP o su nombre. |
| Nombre de usuario de FRITZ!Box | — | El usuario creado arriba. |
| Contraseña | — | Su contraseña. |
| Conexión cifrada (HTTPS) | desactivado | Puerto 49443 en lugar de 49000. El certificado de la box no se comprueba. |
| Intervalo de actualización | 30 s | Con qué frecuencia se lee la box (de 10 s a 5 min). |
| Fuera tras | 3 min | Cuánto tiempo puede faltar un dispositivo en la box antes de mostrarse fuera. |
| Llamadas telefónicas (monitor de llamadas) | desactivado | Activa los activadores de llamadas (monitor de llamadas de la box, puerto 1012). |
| Idioma de los nombres de las funciones | Francés | Nombres de las funciones de los nuevos dispositivos e idioma de los mensajes. |
Después, ejecute Probar la conexión: muestra el modelo de la box, su FRITZ!OS, el estado de internet y el número de dispositivos conectados, o le indica qué corregir.
Añadir la box y sus dispositivos
Abra la pestaña Descubrir de la integración. Enumera la FRITZ!Box y los dispositivos conectados a ella en este momento (la box conoce muchos más, pero solo se proponen los conectados: un móvil aparece cuando está en el wifi). Haga clic en Añadir a Gladys en la box y en cada dispositivo que quiera seguir. El botón Buscar vuelve a leer la lista de la box.
Dispositivos
La FRITZ!Box
- Internet está en On cuando la conexión está establecida (Connected para la box), en Off si no.
- Descarga y Subida son el tráfico actual de la línea, en Mbit/s, leído en cada actualización. Necesitan Transmitir información de estado por UPnP: sin ella, la configuración lo indica y las dos funciones quedan vacías.
- Velocidad de bajada de la línea y Velocidad de subida de la línea son las velocidades máximas de la línea (la sincronización DSL, o las velocidades del contrato de cable o fibra).
- IP externa es la dirección IPv4 pública. Detrás de un CGNAT (algunos proveedores de fibra y cable, DS-Lite), es una dirección del proveedor, no accesible desde internet.
- Tiempo de conexión cuenta los minutos desde la última conexión (vuelve a cero en cada reconexión: la desconexión nocturna de muchas líneas DSL alemanas se ve aquí).
- Wi-Fi de invitados activa o apaga el acceso de invitados de la box (la última red wifi de la box, como hace Home Assistant). Configúrelo una vez en la box (Wi-Fi > Acceso de invitados, nombre y contraseña).
- Reconectar corta la conexión a internet; la box vuelve a conectarse enseguida. En DSL (PPPoE), el proveedor suele dar una IP nueva; en cable o fibra, la dirección suele ser la misma. Internet se corta unos segundos.
Solo se publican los cambios, y cada valor de nuevo cada 12 horas, para que un valor estable nunca muestre «Sin valor reciente».
Dispositivos de red (presencia)
Cada dispositivo añadido tiene una función Presencia: presente (1) en cuanto la box lo muestra conectado, fuera (0) cuando ha faltado durante el tiempo Fuera tras. Los móviles en reposo wifi salen de la lista unos minutos: deles de 3 a 10 minutos. Un ordenador conectado por cable se ve al instante.
Para marcar a una persona en casa, use la presencia de su móvil en una escena: Cambio de estado del dispositivo sobre Presencia → Usuario visto en casa, con Ejecutar solo cuando se supere el umbral marcado (el estado se reenvía cada 12 horas).
Widget del panel
Editar panel → añadir un widget → FRITZ!Box. El widget muestra las velocidades actuales de descarga y subida (mosaicos en directo una vez añadida la box a Gladys), cuántos dispositivos seguidos están en casa, el estado de internet con el tiempo de conexión, el Wi-Fi de invitados (con el tiempo restante cuando se activó durante un tiempo) y cada dispositivo seguido (en casa o fuera). Dispositivos mostrados elige cuáles (vacío: todos, 8 como máximo junto a las filas de internet y Wi-Fi de invitados). Dos botones: Activar / Apagar Wi-Fi invitados y Reconectar internet (que pide confirmación). El widget nunca muestra la IP pública ni direcciones MAC: un panel puede mostrarse a las visitas.
Activadores de escena
| Activador | Cuándo | Variables |
|---|---|---|
| Llamada entrante | suena el teléfono | Número de teléfono, Nombre (agenda), Su número |
| Llamada perdida | una llamada entrante terminó sin que nadie contestara (o la tomó el contestador) | las mismas, más Segundos de timbre y Contestador (1/0) |
| Llamada finalizada | una llamada contestada terminó, entrante o saliente | las mismas, más Sentido (incoming/outgoing) y Duración (s) |
| Conexión a internet restablecida | la box vuelve a estar conectada tras un corte | Corte (segundos), IP externa |
| IP externa cambiada | la dirección IPv4 pública ha cambiado | IP nueva, IP anterior |
Los activadores de llamadas necesitan el ajuste Llamadas telefónicas y el monitor de llamadas de
la box (#96*5*). Pueden limitarse a quien llama (Número de quien llama) o a uno de sus números
(Su número), escritos como los muestra la box (la lista de llamadas de la box muestra el
formato). El nombre viene de las agendas de la box; un número desconocido da el propio número, un
número oculto da «Número oculto» (en el idioma de la configuración).
Para «internet se ha caído», use el activador del núcleo Cambio de estado del dispositivo sobre la función Internet, valor Off, con la casilla del umbral marcada. Un mensaje enviado en ese momento quizá no salga de casa: envíelo cuando vuelva la conexión, con Conexión a internet restablecida y la duración del corte.
Acciones de escena
- Activar el Wi-Fi de invitados: Apagar tras (minutos) opcional (vacío o 0: permanece activado, como máximo 1440). La integración lo apaga al final, incluso tras un reinicio. Resultados: Nombre del Wi-Fi de invitados y Contraseña del Wi-Fi de invitados, para enviarlos a sus invitados en un mensaje. Activarlo o apagarlo a mano cancela el temporizador.
- Apagar el Wi-Fi de invitados.
- Reconectar internet: con Esperar a la reconexión, los pasos siguientes empiezan cuando la box vuelve a estar conectada o tras 100 segundos (Gladys concede como máximo 120 segundos a una acción). Resultados: Conectada (1/0), IP externa e IP nueva (1/0).
Los resultados son números (1/0) para que Condición sobre variables pueda compararlos: elija el
resultado, =, y escriba 1.
Ejemplos de escenas
- Llegan invitados: Activador programado el sábado a las 19:00 → Activar el Wi-Fi de invitados durante 300 minutos → Enviar mensaje «Wi-Fi de invitados: [nombre], contraseña [contraseña]» (inserte los dos resultados desde la lista de variables).
- No queda nadie en casa: Cambio de estado del dispositivo sobre la Presencia de cada móvil, valor Sin presencia, umbral marcado → Comprobar presencia del usuario → apagar las luces, bajar la calefacción.
- Llamada perdida: Llamada perdida → Enviar mensaje «Llamada perdida de [nombre] ([número de teléfono])».
- Informe de corte: Conexión a internet restablecida → Enviar mensaje «Internet estuvo cortado [corte] segundos».
Solución de problemas
- «La FRITZ!Box rechaza las aplicaciones»: marque Permitir el acceso a aplicaciones en Red doméstica > Red > Ajustes de red.
- «La FRITZ!Box ha rechazado el nombre o la contraseña»: compruebe el usuario y su contraseña en Sistema > Usuarios de FRITZ!Box. Tras un rechazo, la integración espera 15 minutos antes de volver a intentarlo (la box bloquea los inicios de sesión cada vez más tiempo tras los fallos), o hasta que cambie la configuración.
- «Al usuario de la FRITZ!Box le falta el permiso Ajustes de FRITZ!Box»: concédale ese permiso; sin él no se pueden leer el Wi-Fi de invitados ni la lista de dispositivos.
- «Velocidades actuales no disponibles»: marque Transmitir información de estado por UPnP.
- «No se ha encontrado ninguna FRITZ!Box» o «no responde»: introduzca la dirección IP de la box
(a menudo
192.168.178.1) en Dirección de la FRITZ!Box. La búsqueda en la red necesita el acceso SSDP aceptado en la instalación y no atraviesa routers ni VLAN. - «El monitor de llamadas está desactivado»: marque
#96*5*en un teléfono conectado a la box. - Un móvil aparece fuera aunque está en casa: duerme en el wifi; suba Fuera tras a 10 o 15 minutos. Los móviles recientes usan una dirección wifi privada: es la misma para una red determinada (iOS «Fija», Android «MAC aleatoria» por red), pero una dirección «Rotativa» crea un dispositivo nuevo cada pocos días: elija una dirección fija para el wifi de casa.
- El Wi-Fi de invitados no hace nada: configure una vez el acceso de invitados en la box (Wi-Fi > Acceso de invitados).
Límites
- Desarrollada sin el hardware: véase más arriba.
- Una FRITZ!Box por instalación de la integración. Los FRITZ!Repeater de una red mesh no se leen (los dispositivos a los que dan servicio aparecen igualmente en la lista de la box).
- FRITZ!SmartHome (enchufes y termostatos DECT) no está cubierto: será otra integración.
- Las velocidades actuales vienen del estado UPnP de la box, leído al intervalo elegido: son una instantánea, no una media.
- Solo IPv4 externa; el prefijo IPv6 no se muestra.
- La presencia de un dispositivo es lo que sabe la box: un móvil con el wifi apagado, o conectado a otra red, está fuera.
- Lo que guarda la integración, en
/data/state.jsonde su contenedor: la dirección de la box encontrada por la búsqueda, su número de serie, la última IP externa y el final de un temporizador del Wi-Fi de invitados. La contraseña se queda en la configuración de Gladys; los números y los nombres nunca se escriben en disco ni en los registros. - Ritmo de peticiones: cada actualización envía de 4 a 6 peticiones pequeñas a la box (cada 30 s por defecto).
Parámetros de configuración
Estos son los parámetros que FRITZ!Box te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar su FRITZ!Box | section | No | En la FRITZ!Box (http://fritz.box): active «Permitir el acceso a aplicaciones» y «Transmitir información de estado por UPnP» en Red doméstica > Red > Ajustes de red, y cree un usuario con el permiso «Ajustes de FRITZ!Box» en Sistema > Usuarios de FRITZ!Box. Después, ejecute «Probar la conexión» y añada la box y sus dispositivos en la pestaña Descubrir. |
| Dirección de la FRITZ!Box | string | No | Déjelo vacío para encontrarla automáticamente en la red. |
| Nombre de usuario de FRITZ!Box | string | Sí | Un usuario de Sistema > Usuarios de FRITZ!Box, con el permiso «Ajustes de FRITZ!Box». |
| Contraseña | secret | Sí | |
| Conexión cifrada (HTTPS) | boolean | No | Puerto 49443 en lugar de 49000. El certificado propio de la box no se comprueba. |
| Intervalo de actualización | select | No | Con qué frecuencia se lee la box (estado, velocidades, dispositivos conectados). |
| Fuera tras | select | No | Tiempo que un dispositivo puede faltar en la box antes de mostrarse fuera. Los móviles en reposo wifi desaparecen unos minutos. |
| Llamadas telefónicas (monitor de llamadas) | boolean | No | Activadores de escena para llamadas entrantes, perdidas y finalizadas. Marque antes #965 en un teléfono conectado a la FRITZ!Box. |
| 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 FRITZ!Box en Gladys
- En Gladys, abre Integraciones: FRITZ!Box 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-fritzbox: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-fritzbox.
FRITZ!Box 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
FRITZ!Box 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 externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación