Integración domótica FRITZ!SmartHome, gratuita y de código abierto
Enchufes, termostatos, persianas, lámparas y botones de su FRITZ!Box (DECT).
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conecte a Gladys los dispositivos domóticos de AVM de su FRITZ!Box: enchufes FRITZ!DECT 200 y 210 (encendido/apagado, potencia, energía), termostatos de radiador FRITZ!DECT 301 y 302 y Comet DECT (temperatura objetivo, calefacción encendida/apagada, temperatura medida, batería, ventana abierta, boost), persianas en DECT ULE (Rollotron), lámparas FRITZ!DECT 500, detectores HAN-FUN y los botones FRITZ!DECT 400 y 440 como activadores de escena. Todo se queda en su red local: la integración habla con la box a través de su interfaz AHA-HTTP, documentada por AVM. Sin nube ni cuenta MyFRITZ!.
Esta integración no sustituye a la integración FRITZ!Box (internet, Wi-Fi de invitados, presencia, llamadas): ambas se complementan y pueden funcionar a la vez.
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 pyfritzhome), y los métodos de inicio de sesión se han comprobado con los ejemplos de AVM, pero todavía no ha funcionado con una box real. Cuéntenos en el foro de Gladys cómo funciona con sus dispositivos.
Lo que obtiene
- Un dispositivo Gladys por cada dispositivo Smart Home de la box, con las funciones que tiene (vea Dispositivos): interruptor y medidor de un enchufe, temperatura objetivo y modo de calefacción de un termostato, posición de una persiana, encendido, brillo y color de una lámpara, estado de un detector, temperatura, humedad y batería.
- Un widget de panel: potencia de los enchufes, termostatos que calientan, ventanas abiertas y una línea por dispositivo.
- Tres activadores de escena: un botón FRITZ!DECT pulsado (qué tecla, pulsación corta o larga), un termostato que detecta una ventana abierta, una batería que se agota.
- Una acción de escena: poner un termostato en su temperatura de confort o eco, iniciar un boost o el modo «ventana abierta» durante un tiempo, o terminarlos.
Requisitos
- Una FRITZ!Box con FRITZ!OS 7 o posterior (se recomienda FRITZ!OS 7.24 o posterior: inicio de sesión seguro PBKDF2) y dispositivos Smart Home emparejados (Smart Home > Dispositivos).
- Un usuario de la FRITZ!Box con el permiso Smart Home.
- Gladys Assistant 5.1.0 o posterior.
- Gladys en la misma red local que la box.
Configuración
Preparar la FRITZ!Box
- Abra la interfaz de la box (http://fritz.box).
- En Sistema > Usuarios de FRITZ!Box, cree un usuario para Gladys (p. ej.
gladys) con una contraseña robusta y marque el permiso Smart Home. Los demás permisos no son necesarios. - Compruebe que sus dispositivos aparecen en Smart Home > Dispositivos.
Ajustes
| Ajuste | Descripción |
|---|---|
| Dirección | dirección IP o nombre de la box. Vacío: se busca en la red (SSDP), después fritz.box. |
| Nombre de usuario | el usuario creado arriba. |
| Contraseña | su contraseña, guardada por Gladys, nunca escrita en los registros. |
| Conexión cifrada (HTTPS) | puerto 443 en lugar de 80. El certificado propio de la box no se comprueba. |
| Intervalo | frecuencia de lectura: 10 s, 30 s (por defecto), 1 min o 2 min. Las pulsaciones de botones lo siguen. |
| Idioma de los nombres | idioma de los nombres de las funciones de los dispositivos añadidos y de los mensajes (francés por defecto). |
Ejecute Probar la conexión: inicia sesión, cuenta los dispositivos y los enumera en la pestaña Descubrir.
Añadir sus dispositivos
Abra la pestaña Descubrir de la integración y añada los dispositivos que desee. Un dispositivo fuera del alcance de la box también se propone (muestra sus valores en cuanto vuelve). Un dispositivo emparejado más tarde aparece en la siguiente lectura.
Dispositivos
La integración lee los dispositivos ella misma, con el intervalo elegido: una sola petición a la box para todos los dispositivos. Solo se envían a Gladys los valores que cambian.
Enchufes
FRITZ!DECT 200, 210 y enchufes HAN-FUN de otras marcas:
| Función | Tipo en Gladys | Notas |
|---|---|---|
| Alimentación | interruptor | encendido/apagado, controlable |
| Potencia consumida | potencia, en W | |
| Energía | energía, en kWh | total medido por el enchufe |
| Tensión | tensión, en V | cuando la box la proporciona |
| Temperatura | temperatura, en °C | medida por el enchufe, desfase de la box |
Un enchufe bloqueado en la box («bloqueo de conmutación») rechaza las órdenes con un mensaje.
Termostatos de radiador
FRITZ!DECT 301, 302 y Comet DECT:
| Función | Tipo en Gladys | Notas |
|---|---|---|
| Temperatura objetivo | consigna de termostato, en °C | controlable, de 8 a 28 °C por medios grados |
| Calefacción | modo del termostato (apagado/calefacción) | apagado cierra la válvula; calefacción vuelve al programa semanal |
| Ventana (modo ventana abierta) | sensor de apertura | «abierta» mientras el termostato mantiene la válvula cerrada |
| Boost | entrada (sí/no) | sí durante un boost |
| Temperatura | temperatura, en °C | medida |
| Batería | batería, en % |
Las órdenes están limitadas a propósito: una temperatura objetivo por debajo de 8 °C o por encima de 28 °C se devuelve a ese rango, y «calefacción» vuelve a la temperatura de confort o eco del programa de la box, nunca al «encendido» permanente (válvula abierta sea cual sea la temperatura). Un termostato bloqueado en la box, en modo verano o que sigue el programa de vacaciones rechaza las órdenes con un mensaje. Las funciones ventana y boost solo existen en los termostatos recientes (no en los primeros Comet DECT).
Persianas
Rollotron y otras persianas en DECT ULE / HAN-FUN:
| Función | Tipo en Gladys | Notas |
|---|---|---|
| Posición | posición de persiana, % | 100 = abierta, 0 = cerrada; controlable |
| Persiana | estado de persiana | abrir, parar, cerrar |
Lámparas
FRITZ!DECT 500 y otras lámparas HAN-FUN:
| Función | Tipo en Gladys | Notas |
|---|---|---|
| Luz | luz encendida/apagada | controlable |
| Brillo | brillo, en % | controlable |
| Color | color | controlable (FRITZ!OS 7.39 o posterior); vacío en blanco |
Detectores
Detectores HAN-FUN emparejados con la box: un contacto de puerta o ventana es un sensor de apertura, un detector de humo un sensor de humo, un detector de movimiento un sensor de movimiento, un detector de agua un sensor de fugas; los demás una entrada (sí = alarma).
Botones y sensores
Los botones FRITZ!DECT 400 y 440 muestran su batería (y la temperatura y la humedad medidas por el 440). Sus pulsaciones son el activador Botón pulsado. Un repetidor FRITZ!DECT muestra su temperatura.
Widget de panel
FRITZ!SmartHome: tres mosaicos (potencia de los enchufes, termostatos que calientan sobre el total, ventanas abiertas) y luego hasta diez líneas: termostatos (temperatura medida → objetivo, o apagado, boost, ventana abierta, verano, vacaciones), enchufes (encendido y potencia), lámparas, persianas, detectores, una batería baja, un dispositivo fuera de alcance. Ajuste: los dispositivos que se muestran; vacío, los dispositivos añadidos (o todos los de la box si todavía no hay ninguno añadido). El widget solo muestra: controle los dispositivos desde sus propias tarjetas del panel o con escenas.
Activadores de escena
| Activador | Filtros (opcionales) | Variables |
|---|---|---|
| Botón FRITZ!DECT pulsado | botón, qué tecla (400, o una de las cuatro del 440), pulsación corta o larga (400) | nombre del dispositivo, tecla, pulsación |
| Ventana abierta detectada | termostato | nombre del dispositivo, minutos hasta volver a calentar |
| Batería baja | dispositivo | nombre del dispositivo, nivel de batería (%) |
La box da la hora de la última pulsación de cada tecla: la integración ve una pulsación en su siguiente lectura (de 10 s a 2 min después, según el intervalo), y dos pulsaciones de la misma tecla entre dos lecturas cuentan como una. Los eventos anteriores a un arranque de la integración no se reproducen.
Acciones de escena
Ajustar un termostato de radiador: termostato, modo, duración.
- Temperatura de confort / Temperatura eco: las temperaturas configuradas en la box para este termostato.
- Boost: válvula totalmente abierta durante el tiempo indicado (30 min por defecto).
- «Ventana abierta»: válvula cerrada durante el tiempo indicado (15 min por defecto), por ejemplo mientras ventila.
- Fin del boost y de «ventana abierta».
La duración es de 24 horas como máximo, el límite de la box: el boost y el modo «ventana abierta» siempre terminan solos.
Ejemplos de escenas
- Ventilar el dormitorio: cuando se abre el contacto de la ventana del dormitorio, «Ajustar un termostato de radiador» → «Ventana abierta» durante 20 minutos; cuando se cierra, «Fin del boost y de ventana abierta».
- Un botón para el baño: pulsación corta en el FRITZ!DECT 400 del baño, boost del termostato del baño durante 30 minutos; pulsación larga, apagar el enchufe del toallero.
- Aviso de batería: cuando una batería se agota, enviar un mensaje «Batería de {{triggerEvent.data.device_name}}: {{triggerEvent.data.battery}} %».
Solución de problemas
- «ha rechazado el nombre o la contraseña»: compruébelos en Sistema > Usuarios de FRITZ!Box. Tras un fallo, la integración espera 15 minutos, después cada vez más hasta 4 horas (o un cambio de configuración), antes de volver a intentarlo: la box bloquea los inicios de sesión cada vez más tiempo tras varios fallos.
- «bloquea los inicios de sesión durante … s»: la box rechaza los inicios de sesión tras varios fallos; la integración espera.
- «le falta el permiso Smart Home»: márquelo para el usuario en Sistema > Usuarios de FRITZ!Box.
- «No se ha encontrado ninguna FRITZ!Box»: introduzca la dirección de la box en la configuración.
- Un dispositivo muestra «Fuera de alcance»: ha perdido la conexión DECT con la box (batería, distancia).
- Órdenes rechazadas: el dispositivo está bloqueado en la box, o el termostato está en modo verano o vacaciones.
- Más detalles: configure
LOG_LEVEL=debugen el contenedor de la integración.
Límites
- Los grupos y las plantillas de la box no se proponen: un grupo duplicaría los dispositivos que contiene. Controle los dispositivos uno a uno, o con una escena de Gladys.
- Una pulsación de botón se ve en la siguiente lectura de la box, no al instante; dos pulsaciones entre dos lecturas cuentan como una.
- La temperatura de color (tonos de blanco) de las lámparas no se ofrece, solo el color.
- Los periodos de vacaciones y verano, las temperaturas de confort y eco y el programa semanal se configuran en la box, no desde Gladys.
- Desarrollada sin el hardware: basada en la documentación de AVM y en respuestas reales recogidas por pyfritzhome; los dispositivos que esas respuestas no cubren pueden comportarse de otra manera.
Parámetros de configuración
Estos son los parámetros que FRITZ!SmartHome te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar su FRITZ!Box | section | No | Sus dispositivos domóticos DECT (enchufes, termostatos de radiador, persianas, lámparas, botones, detectores) se leen en la FRITZ!Box. En la FRITZ!Box (http://fritz.box), cree un usuario con el permiso «Smart Home» en Sistema > Usuarios de FRITZ!Box. Después, ejecute «Probar la conexión» y añada 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 «Smart Home». |
| Contraseña | secret | Sí | |
| Conexión cifrada (HTTPS) | boolean | No | Puerto 443 en lugar de 80. El certificado propio de la box no se comprueba. |
| Intervalo de actualización | select | No | Con qué frecuencia se leen los dispositivos de la box. Las pulsaciones de botones se ven a este ritmo. |
| 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!SmartHome en Gladys
- En Gladys, abre Integraciones: FRITZ!SmartHome 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-fritz-smarthome:1.0.0), 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-fritz-smarthome.
FRITZ!SmartHome 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!SmartHome 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