Integración domótica HomeKit Controller, gratuita y de código abierto

Empareje y controle sus accesorios HomeKit Wi-Fi/Ethernet desde Gladys, sin hub de Apple.

• Publicado por prohand
• Dispositivos
• Versión 1.1.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Esta integración convierte Gladys en un controlador HomeKit: se empareja directamente con sus accesorios HomeKit Wi-Fi / Ethernet y los controla en local, sin iPhone, Apple TV ni HomePod, y sin ninguna nube.

Antes de empezar

• Un accesorio HomeKit solo acepta un controlador a la vez. Si ya está en la app Casa de Apple (o en Home Assistant…), elimínelo allí primero. Si no, restablezca el accesorio a los valores de fábrica.
• Tenga a mano el código de configuración de 8 cifras (123-45-678): está impreso en el accesorio, en su caja o en su manual.
• El accesorio debe estar en la misma red local que Gladys.
• Solo se admiten accesorios IP (Wi-Fi, Ethernet). Los accesorios Bluetooth y Thread no.
• Se requiere Gladys 5.1.0 o posterior.

Emparejar un accesorio

1. Abra la pestaña Configuración de la integración.
2. Pulse Buscar accesorios. La lista muestra, para cada accesorio: su nombre, su tipo, su ID de HomeKit, su dirección IP y su estado (listo para emparejar, emparejado en otro sitio, emparejado con Gladys).
3. Pulse Emparejar un accesorio y rellene:
   • Accesorio: el nombre, el ID o la dirección IP mostrados por la búsqueda. Si la búsqueda no lo encuentra, escriba su dirección como IP:port (por ejemplo 192.168.1.20:51826);
   • Código de configuración: las 8 cifras, con o sin guiones.
4. El emparejamiento tarda unos segundos (hasta un minuto en módulos pequeños). Después abra la pestaña Descubrir: los dispositivos del accesorio están listos para añadirse.

Un puente HomeKit da un dispositivo de Gladys por cada accesorio conectado al puente.

Dispositivos compatibles

Servicio HomeKit	En Gladys
Bombilla	Encendido/apagado, brillo, color, temperatura de color
Interruptor, enchufe, válvula	Encendido/apagado
Ventilador	Encendido/apagado, velocidad
Termostato	Temperatura, temperatura objetivo, humedad
Persiana, ventana, puerta	Posición, abrir / parar / cerrar
Cerradura	Bloqueada / desbloqueada
Sensores	Temperatura, humedad, luminosidad, movimiento,
	ocupación, contacto, fuga, humo, CO, CO2,
	partículas PM2.5 / PM10
Batería	Nivel, batería baja

Los botones programables y los timbres no son dispositivos: sus pulsaciones activan escenas (ver más abajo).

Los demás servicios (cámaras, televisores…) se ignoran por ahora.

Ajustes

• Intervalo de actualización: HomeKit envía los cambios en tiempo real. Gladys también vuelve a leer todo el accesorio con este intervalo, como red de seguridad (60 s por defecto).
• Duración de la búsqueda: cuánto tiempo se escucha la red durante una búsqueda (10 s por defecto).

Acciones

• Buscar accesorios: enumera los accesorios HomeKit de la red.
• Emparejar un accesorio: ver más arriba.
• Identificar un dispositivo: el accesorio se hace notar (parpadea, emite un pitido…), útil para localizarlo.
• Desemparejar un accesorio: elimina el emparejamiento del accesorio y de Gladys. En un puente, afecta a todos sus dispositivos. Después elimine los dispositivos en Gladys.

Escenas

Activadores (en una escena, Añadir activador → Integraciones):

• Botón HomeKit pulsado: se ha pulsado un botón o un timbre. Filtros opcionales: el dispositivo, el tipo de pulsación (simple, doble, larga) y el número del botón (para un mando con varios botones). Variables: accesorio, botón, número del botón, pulsación, timbre.
• Accesorio HomeKit desconectado / de vuelta: un accesorio ha dejado de estar accesible o ha vuelto. Filtros opcionales: el dispositivo y el estado. En un puente, cada dispositivo conectado envía su propio evento.

Para elegir un botón en el filtro «Dispositivo», el accesorio debe haber creado un dispositivo en Gladys (por ejemplo a través de su batería). Si no, deje el filtro vacío.

Acciones (en una escena, Nueva acción → Integraciones):

• Identificar un dispositivo HomeKit: el accesorio se hace notar.
• Releer un dispositivo HomeKit: lee al instante todos sus valores (útil antes de una condición).

Widget del panel

El widget Accesorios HomeKit muestra cuántos accesorios están en línea y desconectados, la lista de accesorios (primero los inaccesibles) y, cuando uno está desconectado, un botón Reconectar.

Solución de problemas

• La búsqueda no encuentra el accesorio: asegúrese de que está encendido y en la misma red (misma VLAN) que Gladys. Pruebe una duración de búsqueda más larga, o empareje con IP:port.
• «emparejado en otro sitio»: elimínelo de la app Casa o restablézcalo a los valores de fábrica.
• Accesorio inaccesible: la pestaña Configuración de la integración muestra qué accesorios están desconectados. La integración vuelve a intentarlo por sí sola y encuentra de nuevo el accesorio si su dirección IP ha cambiado. Para evitarlo, asigne al accesorio una dirección IP fija (reserva DHCP).
• Los emparejamientos se guardan en el volumen /data de la integración: se conservan entre actualizaciones.
• Para más detalles, consulte los registros de la integración (LOG_LEVEL=debug).

Parámetros de configuración

Estos son los parámetros que HomeKit Controller te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Primeros pasos	section	No	1. Elimine el accesorio de la app Casa de Apple (un accesorio HomeKit solo acepta un controlador). 2. Pulse «Buscar accesorios» más abajo. 3. Pulse «Emparejar un accesorio» con su nombre y el código de configuración de 8 cifras impreso en él. 4. Añada sus dispositivos desde la pestaña «Descubrir».
Intervalo de actualización (s)	number	No	HomeKit envía los cambios en tiempo real; esta actualización completa es solo una red de seguridad.
Duración de la búsqueda (s)	number	No	Tiempo durante el que Gladys escucha los accesorios HomeKit en la red.

Cómo instalar HomeKit Controller en Gladys

1. En Gladys, abre Integraciones: HomeKit Controller aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/prohand/gladys-homekitcontroller:1.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-homekitcontroller.

HomeKit Controller 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

HomeKit Controller 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 prohand, 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

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂