¡Damas y caballeros, bienvenidos! Después de varios meses sin publicar, vuelvo con un tema que varios clientes y entusiastas me han consultado: cómo agregar nuevos dispositivos Zigbee2MQTT a Apple HomeKit utilizando Home Assistant. Es un proceso que involucra varios pasos y conceptos, y precisamente por eso me pareció importante documentarlo de forma sencilla y práctica.
Historia breve de Zigbee2MQTT y Apple HomeKit
Primero hay que aclarar que, si bien Apple lanzó Apple HomeKit en iOS 8 en 2014, no fue hasta la publicación del Apple HomeKit Accessory Protocol (HAP) en 2017 cuando plataformas como Homebridge o nuestro favorito Home Assistant pudieron comenzar a integrar dispositivos no certificados dentro del ecosistema HomeKit.
Esto fue posible gracias al concepto de puentes (bridges), que actúan como intermediarios entre HomeKit y dispositivos de terceros.
¿Cómo llegó Zigbee2MQTT a Apple HomeKit?
Con el tiempo, y gracias a la flexibilidad de Home Assistant, fue posible integrar dispositivos que utilizan protocolos como Zigbee o Z-Wave a través de puentes, como el que ofrece Zigbee2MQTT. Sin embargo, muchos de estos dispositivos como los típicos pulsadores blancos redondos no son reconocidos de forma nativa por Apple HomeKit.
¿Cómo interpreta Apple HomeKit los dispositivos Zigbee2MQTT?
Cada dispositivo compatible con Zigbee2MQTT incluye sus propios exposes. Podemos entender un expose como la funcionalidad específica que ofrece un dispositivo, determinada por su hardware y/o el firmware instalado por el fabricante.
¿Quieres mejorar la seguridad de tu empresa?🚀
Ayudo a empresas a detectar riesgos de seguridad y proteger sus sistemas y soluciones de inteligencia artificial.
Por otro lado, el complemento MQTT que suele instalarse junto a Zigbee2MQTT dentro de Home Assistant permite que este interprete los exposes como entidades. Así, cada funcionalidad que ofrece un dispositivo Zigbee puede ser gestionada como una entidad dentro del sistema.
Ahora que ya explicamos los conceptos clave, podemos avanzar sin repetirlos constantemente. Como habrás notado, cada comunidad nombra las cosas a su manera (ni siquiera Matter, que nació para unificar dispositivos y fabricantes, ha logrado que todos hablen el mismo idioma)😂.
Volviendo al tema, el complemento Apple HomeKit Bridge de Home Assistant es el que permite que todas las entidades disponibles puedan mostrarse dentro de Apple HomeKit. Este complemento interpreta las entidades usando dominios, que no solo sirven para clasificarlas (como luces, sensores, interruptores, etc.), sino también para filtrar cuáles queremos exponer a HomeKit… y cuáles no.
Por ejemplo, en el caso de un sensor de apertura, personalmente solo me interesa que en Apple HomeKit se muestre si la puerta o ventana está abierta o cerrada. Otros datos como el nivel de batería o la temperatura interna del sensor pueden quedar ocultos.
¿Cómo agregar un dispositivo Zigbee2MQTT en Apple HomeKit?
Entendiendo ya qué es una entidad, un dominio y un expose, vamos ahora paso a paso con el proceso para agregar un dispositivo Zigbee2MQTT a Apple HomeKit usando Home Assistant.
El primer paso es emparejar el dispositivo dentro del apartado de Zigbee2MQTT en Home Assistant. Para ello, debemos colocar el dispositivo en modo de emparejamiento (pairing mode).
Es fundamental leer siempre la documentación específica del fabricante. No solo para saber cómo emparejar correctamente, sino especialmente cuando se trata de dispositivos que controlan corriente eléctrica o se integran con sistemas críticos del hogar.
Una vez el dispositivo esté en modo de emparejamiento (lo cual normalmente se indica con una luz parpadeando), abrimos el apartado de Zigbee2MQTT en Home Assistant y hacemos clic en Permitir unión. En unos segundos, el dispositivo aparecerá como añadido en la interfaz de Zigbee2MQTT.
Después del emparejamiento, es importante renombrar el dispositivo y marcar la opción Update Home Assistant entity ID. Esto facilitará su identificación más adelante.
El siguiente paso es revisar los exposes y posteriormente las entidades del dispositivo. Estos nos muestran qué funciones ha detectado MQTT y nos ayudan a entender cómo interpretará cada una Home Assistant. Esto será clave para decidir qué dominio expondremos más adelante a Apple HomeKit.
Ahora accedemos al complemento Apple HomeKit Bridge. En el puente configurado, debemos seleccionar el tipo de dominio que queremos exponer y asegurarnos de que el modo esté en bridge y con el filtro de inclusión (include) activado.
Una vez dentro, añadimos las entidades que queremos que aparezcan en Apple HomeKit, buscando por el nombre que le dimos al dispositivo y luego haciendo clic en Submit.
En cuestión de segundos, el dispositivo aparecerá disponible en la app Casa de Apple.
Para verificarlo desde Apple HomeKit, vamos a Ajustes de la casa → Centros de domótica y puentes, seleccionamos el puente correspondiente a Home Assistant, y ahí deberíamos ver el nuevo dispositivo Zigbee2MQTT ya disponible.
Curiosidades finales
- Aunque entre un dispositivo Zigbee2MQTT y Apple HomeKit hay varios intermediarios, la velocidad de funcionamiento suele ser sorprendentemente rápida. La comunicación es casi instantánea, lo que demuestra lo bien optimizados que están estos puentes.
- Aunque entre un dispositivo Zigbee2MQTT y Apple HomeKit hay varios intermediarios, la velocidad de funcionamiento suele ser sorprendentemente rápida. Apple HomeKit, al igual que Google Home, Alexa o SmartThings, actúa como un cliente final: ninguna de estas plataformas pretende ofrecer todas las funciones avanzadas de cada dispositivo, sino que buscan brindar una experiencia centrada en la sencillez, la seguridad y el control desde un solo lugar.
- Es cierto que Apple está apostando por el protocolo Thread como base para la próxima generación de dispositivos certificados de forma nativa para HomeKit. Pero gracias a Zigbee2MQTT, hoy podemos adquirir dispositivos económicos y sin certificación oficial, e integrarlos igualmente al ecosistema Apple.
- La combinación Zigbee2MQTT + Home Assistant nos libera de depender de las aplicaciones o puentes propietarios que cada fabricante quiere imponernos. Cualquier dispositivo compatible con Zigbee2MQTT o ZHA puede formar parte de nuestro sistema domótico, manteniendo independencia, flexibilidad y control total.
