Integración domótica Homematic IP, gratuita y de código abierto
Homematic IP por la nube: calefacción, contactos, sensores, enchufes, persianas, alarma.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Lleva sus dispositivos Homematic IP (eQ-3) a Gladys a través de la nube Homematic IP, como la aplicación oficial: termostatos de radiador y de pared, habitaciones con calefacción, contactos de ventana y de puerta, detectores de movimiento, de presencia, de humo y de agua, enchufes y actuadores con su potencia, reguladores, persianas y estores, pulsadores de pared y mandos a distancia, sensores meteorológicos y el sistema de alarma.
Developed without the hardware: feedback welcome. Esta integración se ha construido a partir del protocolo público y de respuestas grabadas de la nube Homematic IP, sin un punto de acceso a mano. Si algo está mal o falta, abra una issue: github.com/guim31/gladys-homematicip/issues. Sin relación con eQ-3 AG: Homematic IP es una marca de eQ-3.
Requisitos
- Un punto de acceso Homematic IP (HmIP-HAP, o el punto de acceso cableado HmIP-DRAP) configurado en la aplicación Homematic IP, con sus dispositivos ya emparejados.
- Su SGTIN: el código de 24 caracteres impreso debajo del punto de acceso
y en la pegatina incluida (por ejemplo
3014-F711-A000-0000-0000-0000). - Acceso a Internet para Gladys: todo pasa por la nube Homematic IP.
- Gladys 5.1 o posterior.
La Home Control Unit (HCU) y su «Connect API» local no son compatibles: esta integración habla con la nube del punto de acceso.
Configuración
Abra la pestaña Configuración de la integración.
- SGTIN del punto de acceso: introduzca el código impreso debajo del punto de acceso (se admiten guiones y espacios) y guarde.
- PIN del punto de acceso: solo si protegió su punto de acceso con un PIN en la aplicación. Solo sirve para el emparejamiento.
- Idioma de los nombres de los dispositivos: el idioma de los nombres de las funciones de los dispositivos que añada (Temperatura, Consigna, Apertura…). Francés por defecto.
- Control de la alarma: lo que Gladys puede hacer con el sistema de alarma (ver más abajo).
Emparejamiento
- Haga clic en Iniciar el emparejamiento. Gladys pide acceso a la nube, como un nuevo cliente llamado «Gladys».
- Pulse el botón azul de la parte superior del punto de acceso.
- Haga clic en He pulsado el botón. Gladys recibe su token, lee su casa y muestra los dispositivos en la pestaña Descubrir.
- Añada los dispositivos que desee desde la pestaña Descubrir.
El token se guarda en el volumen privado de la integración (/data), nunca
en los registros. «Gladys» aparece entonces entre los clientes de la
aplicación Homematic IP: si lo elimina allí, se retira el acceso y el estado
de la integración pide volver a emparejar.
Volver a leer la casa lee en el momento todos los dispositivos y habitaciones e indica cuántos se han encontrado (útil después de añadir un dispositivo en la aplicación).
Control de la alarma
Leer la alarma siempre es posible. Modificarla es decisión suya, en Control de la alarma:
- Solo lectura (por defecto): Gladys muestra el modo de alarma y la alarma, nada más;
- Solo armar: Gladys puede armar la alarma (protección perimetral o total), nunca desarmarla;
- Armar y desarmar: Gladys también puede desarmarla.
El modo de alarma nunca es un interruptor que un asistente de voz pudiera accionar por error: se cambia con su selector en el dispositivo, o con la acción de escena Ajustar la alarma Homematic IP, dentro de lo que este ajuste permite.
Dispositivos
En la pestaña Descubrir aparecen tres tipos de dispositivos.
Dispositivos Homematic IP
Un dispositivo Gladys por dispositivo Homematic IP, con el nombre de la aplicación. Sus funciones dependen de lo que tiene el dispositivo, sea cual sea su modelo:
| Función | Dispositivos | Valores |
|---|---|---|
| Temperatura | termostatos, sensores climáticos y meteorológicos, STE2 (×2) | °C |
| Humedad | termostatos de pared, sensores climáticos y meteorológicos | % |
| CO2 | sensores de CO2 | ppm |
| Iluminancia | detectores de movimiento y presencia, sensores de luz y tiempo | lux |
| Velocidad del viento | sensores meteorológicos | km/h |
| Lluvia | sensores meteorológicos pro/plus, sensor de lluvia | sí / no |
| Apertura | contactos de ventana y puerta, manillas, entradas de contacto | abierto / cerrado (oscilante = abierto) |
| Movimiento | detectores de movimiento | sí / no |
| Presencia | detectores de presencia | sí / no |
| Humo | detectores de humo (humo visto por este) | sí / no |
| Fuga de agua / Nivel de agua | detectores de agua | sí / no |
| Calefacción | termostatos de radiador (válvula abierta) | parado / calentando |
| Interruptor | enchufes, actuadores, interruptores empotrados | encendido / apagado, controlable |
| Potencia / Energía | enchufes y actuadores con medición | W / kWh |
| Luz / Brillo | reguladores | encendido / apagado, %, controlable |
| Posición / Abrir/cerrar | persianas, estores, protecciones solares | 0 % cerrado a 100 % abierto |
| Botón | pulsadores de pared, mandos a distancia, entradas de pulsador | pulsación corta, pulsación larga |
| Batería baja / Manipulación | dispositivos a pilas, dispositivos con contacto antisabotaje | sí / no |
Un dispositivo con varios canales (un actuador de 4 canales, un pulsador de pared de 6 teclas) tiene una función por canal, con el nombre del canal en la aplicación o su número. El punto de acceso en sí y los dispositivos que esta versión no conoce (cerraduras, sirenas, actuadores de suelo radiante…) no aparecen.
Botones: cada pulsación es un nuevo valor de la función Botón (pulsación corta, pulsación larga, soltar), utilizable en el disparador «estado de un dispositivo» de las escenas de Gladys. La nube solo informa de las pulsaciones de los dispositivos que las envían.
Habitaciones con calefacción
Un dispositivo por habitación con calefacción de la aplicación, llamado Calefacción seguido de la habitación:
- Temperatura y Humedad de la habitación (termostato de pared, o termostato de radiador);
- Consigna: la temperatura objetivo, por medios grados, dentro de los límites de la habitación;
- Modo: Automático (programa semanal), Manual o Eco;
- Boost: las válvulas totalmente abiertas durante el tiempo de boost ajustado en la aplicación;
- Ventana: abierta en cuanto un contacto o el termostato la ve abierta;
- Calefacción: si una válvula de la habitación está abierta.
Casa (modo eco y alarma)
Un dispositivo Homematic IP para toda la casa:
- Modo eco (ausencia): activado, todas las habitaciones están a su temperatura eco hasta que lo apague (un modo eco o unas vacaciones iniciados desde la aplicación también aparecen aquí);
- Modo de alarma: Desarmada, Protección perimetral o Protección total, modificable dentro de lo que Control de la alarma permite;
- Alarma: activada mientras la alarma suena.
Widget
El widget Calefacción Homematic IP muestra toda la casa de un vistazo: la temperatura Exterior que la nube conoce para su casa, cuántas habitaciones están Calentando, y luego cada habitación con su temperatura, su consigna y lo que está haciendo (ventana, boost, eco). Su botón inicia el Modo eco de toda la casa (con confirmación) o, cuando está activo, ofrece Fin del modo eco. En sus ajustes, elija las habitaciones que mostrar (todas si no elige ninguna).
Disparador de escena
Alarma Homematic IP disparada: el sistema de alarma armado se ha disparado. Filtre por el detector (cualquiera si está vacío) y por la causa: Intrusión, Humo, Agua, Sabotaje, Otra. La escena recibe el nombre del detector y la causa como variables. Una alarma que ya suena cuando Gladys arranca no lo dispara.
Todo lo demás (una ventana abierta, una tecla pulsada, la temperatura de una habitación) es una función de dispositivo: utilice el disparador «estado de un dispositivo» de Gladys.
Acciones de escena
- Iniciar el modo eco Homematic IP: todas las habitaciones a su temperatura eco, durante un número de horas o hasta que se termine (0).
- Iniciar el modo vacaciones Homematic IP: todas las habitaciones a una misma temperatura (5 a 30 °C) durante un número de días, luego vuelta al programa.
- Terminar el modo eco o vacaciones Homematic IP: vuelta al programa normal.
- Ajustar la alarma Homematic IP: desarmada, protección perimetral o total, dentro de lo que Control de la alarma permite. Indica a la escena si el modo se ha aplicado y qué detectores lo han bloqueado (una ventana abierta, por ejemplo).
Ejemplos de escenas
- Cuando la última persona sale de casa (presencia de Gladys): Iniciar el modo eco Homematic IP y luego Ajustar la alarma Homematic IP en protección total; si el modo no se ha aplicado, envíese un mensaje con los detectores que lo bloquean.
- Cuando Alarma Homematic IP disparada con la causa Intrusión: encender todas las luces y enviar un mensaje con el nombre del detector.
- Cuando la Apertura de la ventana del baño pasa a abierta: apagar el Boost de la habitación.
Actualización y límites de la nube
La nube envía cada cambio en cuanto ocurre (una conexión en directo, como la aplicación): los estados suelen aparecer en uno o dos segundos. Además, Gladys lee toda la casa al arrancar, cuando vuelve la conexión en directo y cada 30 minutos (cada 5 minutos mientras la conexión en directo está cortada). Gladys nunca consulta estos dispositivos por sí misma.
La nube Homematic IP frena a los clientes demasiado activos y no publica ninguna cuota: la integración envía como máximo 10 peticiones a la vez y luego una cada 8 segundos, el ritmo del cliente de referencia que utiliza Home Assistant. Una escena que controla muchos dispositivos a la vez puede ver rechazados los últimos comandos («Demasiados comandos Homematic IP seguidos»): espácielos o utilice un grupo de la aplicación.
Solución de problemas
- «Esto no es un SGTIN»: el código tiene 24 caracteres, cifras y letras de la A a la F. Cópielo de debajo del punto de acceso.
- «La nube Homematic IP ha rechazado la solicitud»: compruebe el SGTIN y, si su punto de acceso tiene un PIN, el campo PIN del punto de acceso.
- «El punto de acceso aún no ha confirmado»: pulse el botón azul del punto de acceso y vuelva a hacer clic en He pulsado el botón justo después.
- «La nube Homematic IP rechaza el acceso de Gladys»: Gladys se ha eliminado de los clientes en la aplicación. Vuelva a iniciar el emparejamiento.
- «El punto de acceso no está conectado»: la nube sigue respondiendo, pero con los últimos valores. Compruebe la alimentación y el cable de red del punto de acceso.
- Una pulsación de tecla no aparece: algunos dispositivos solo actúan sobre sus enlaces directos y no envían nada a la nube; compruebe en la aplicación que la tecla no está solo enlazada a un actuador.
- Los detalles están en los registros de la integración;
LOG_LEVEL=debugmuestra más.
Límites
- Solo nube: sin API local del punto de acceso (la HCU no es compatible), por lo que sin Internet no hay control.
- No incluidos en esta versión: cerraduras, sirenas, actuadores de suelo radiante, interfaces de contador (HmIP-ESI), luces RGB, módulos de puerta de garaje, lamas de los estores, perfiles de calefacción.
- La refrigeración no se gestiona.
- El disparador de alarma sigue la alarma que la nube indica para toda la casa; los detectores de humo conservan su propia función Humo.
- Los nombres de las funciones se fijan al añadir un dispositivo: cambie el idioma antes de añadir los dispositivos.
- El token se pierde con el volumen
/data: entonces hay que volver a emparejar.
Soporte
Developed without the hardware: feedback welcome. Preguntas, errores y dispositivos que faltan: github.com/guim31/gladys-homematicip/issues. Este proyecto no tiene relación con eQ-3 AG.
Parámetros de configuración
Estos son los parámetros que Homematic IP te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar su punto de acceso | section | No | Gladys llega a su punto de acceso Homematic IP (HmIP-HAP) a través de la nube Homematic IP, como la aplicación. 1. Introduzca su SGTIN (impreso debajo del punto de acceso) y guarde. 2. Haga clic en «Iniciar el emparejamiento». 3. Pulse el botón azul de la parte superior del punto de acceso y luego haga clic en «He pulsado el botón». 4. Añada los dispositivos desde la pestaña Descubrir. |
| SGTIN del punto de acceso | string | Sí | 24 caracteres impresos debajo del punto de acceso y en su pegatina, guiones permitidos. |
| PIN del punto de acceso | secret | No | Solo si ha definido un PIN en la aplicación Homematic IP. Solo sirve para el emparejamiento. |
| Idioma de los nombres de los dispositivos | select | No | Nombres dados a las funciones de los nuevos dispositivos (Temperatura, Consigna, Apertura…). |
| Control de la alarma | select | No | Lo que Gladys puede hacer con el sistema de alarma Homematic IP. Leerlo siempre es posible. |
Cómo instalar Homematic IP en Gladys
- En Gladys, abre Integraciones: Homematic IP 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-homematicip: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-homematicip.
Homematic IP 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
Homematic IP 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