¿Cómo coordina Home Assistant Zigbee2MQTT con Core?

Eva Wong

IceWhale author

Eva Wong es la Redactora técnica y manitas residente en ZimaSpace. Una geek de toda la vida con pasión por los homelabs y el software de código abierto, se especializa en traducir conceptos técnicos complejos en guías accesibles y prácticas. Eva cree que el autoalojamiento debe ser divertido, no intimidante. A través de sus tutoriales, empodera a la comunidad para desmitificar las configuraciones de hardware, desde construir su primer NAS hasta dominar los contenedores Docker.

How Does Home Assistant Coordinate Zigbee2MQTT With Core?

Home Assistant coordina Zigbee2MQTT mediante MQTT, en lugar de tratar Zigbee2MQTT como parte del núcleo de Home Assistant. Zigbee2MQTT administra el coordinador Zigbee y la interacción con la red mallada, un broker MQTT transporta los mensajes y la integración MQTT de Home Assistant convierte los temas de descubrimiento y estado en entidades que pueden utilizar las automatizaciones.

Esta separación es potente porque el transporte Zigbee, la intermediación de mensajes y la lógica de automatización del hogar pueden reiniciarse o trasladarse de forma independiente. También crea una cadena de dependencias de tres servicios: un dispositivo Zigbee puede funcionar correctamente mientras Home Assistant lo muestra como no disponible si Zigbee2MQTT, el broker, el descubrimiento o los mensajes de disponibilidad presentan fallos.

Zigbee2MQTT administra la comunicación del dispositivo en el lado de radio

Zigbee2MQTT se comunica con el coordinador, mantiene las definiciones de los dispositivos Zigbee, recibe informes de la red mallada y los convierte en mensajes MQTT. Home Assistant no necesita acceso directo a ese coordinador cuando Zigbee2MQTT lo administra.

La guía de integración de Zigbee2MQTT con Home Assistant explica que el descubrimiento mediante MQTT es la vía estándar para crear automáticamente dispositivos y entidades de Zigbee2MQTT en Home Assistant.

Este límite de responsabilidades es importante durante la recuperación. Reiniciar Home Assistant no debería requerir reparar la red mallada Zigbee, y reiniciar Zigbee2MQTT no debería borrar las automatizaciones de Home Assistant que hacen referencia a identidades de entidad estables.

El broker MQTT es el límite de mensajes entre ambos servicios

Zigbee2MQTT publica el estado de los dispositivos y la información del puente en temas MQTT. Home Assistant se suscribe a los temas relevantes y publica comandos de vuelta cuando una automatización o un usuario cambia un dispositivo.

El broker MQTT es el límite de mensajes porque Zigbee2MQTT publica mensajes en temas, mientras Home Assistant se suscribe a los temas que necesita y publica comandos de vuelta mediante el mismo broker. Una guía actual sobre la arquitectura MQTT explica cómo los publicadores y suscriptores permanecen desacoplados mientras el broker enruta entre ellos los mensajes basados en temas.

Si el broker falla, la red mallada Zigbee puede seguir existiendo mientras la vista de Home Assistant deja de actualizarse. Diagnostica el broker por separado del coordinador y del núcleo.

El descubrimiento describe las entidades; los temas de estado las mantienen actualizadas

Los mensajes de descubrimiento indican a Home Assistant qué entidad debe existir, qué temas proporcionan el estado y los comandos, a qué dispositivo pertenece y cómo deben interpretarse los valores. Una vez creada la entidad, los mensajes de estado normales la mantienen actualizada.

Una recarga o un reinicio puede revelar errores en este proceso. Un caso de la comunidad de Home Assistant documenta cómo las entidades descubiertas mediante MQTT pueden permanecer no disponibles cuando la redescubierta esperada o la ruta del estado retenido no se reconstruyen correctamente.

Usa identificadores únicos estables y una estrategia de redescubrimiento planificada. Recrear entidades con nuevas identidades después de cada cambio del puente rompe los paneles, la continuidad del historial y las automatizaciones, aunque el dispositivo Zigbee físico no haya cambiado.

-15% OFF

ZimaBoard 2 - Mini servidor doméstico para tu gran idea

Single board computer zimaboard2

La disponibilidad es una señal independiente del estado del dispositivo

Un estado como ON indica a Home Assistant el último valor informado; no demuestra que Zigbee2MQTT o el dispositivo estén actualmente accesibles. Los temas de disponibilidad proporcionan un contrato de actividad independiente.

La disponibilidad de Zigbee2MQTT trata de forma diferente a los dispositivos alimentados y a los dispositivos con batería, porque los dispositivos pasivos no pueden recibir un ping bajo demanda. Su documentación actual especifica que los dispositivos activos utilizan ventanas de comprobación más cortas y una lógica de ping y retroceso, mientras que los dispositivos pasivos dependen de ventanas de comprobación mucho más largas. Por lo tanto, la disponibilidad debe interpretarse por separado del último estado retenido.

No actives acciones críticas para la seguridad a partir de un estado obsoleto sin tener en cuenta la disponibilidad. Un valor retenido puede ser útil para reconstruir el estado, pero aun así representar un dispositivo que actualmente está desconectado.

El orden de inicio debe reconstruir el contrato, no depender de la suerte

La secuencia de inicio correcta no consiste simplemente en «primero el broker, después Zigbee2MQTT y luego Home Assistant». Los servicios pueden iniciarse en órdenes diferentes, por lo que el contrato de mensajería debe tolerar las reconexiones. Zigbee2MQTT debe reconectarse al broker, el descubrimiento debe estar disponible, Home Assistant debe suscribirse y el estado actual debe volver a publicarse o conservarse según el diseño.

Los ejemplos de eventos de hogares inteligentes de ZimaSpace muestran cómo MQTT permite que los servicios del hogar inteligente intercambien eventos locales sin compartir un mismo proceso ni un mismo servidor físico. Zigbee2MQTT es un ejemplo concreto de ese desacoplamiento.

Capa	Responsabilidad principal	Síntoma de fallo
Zigbee2MQTT	Red mallada Zigbee y traducción de dispositivos	No llegan mensajes Zigbee nuevos
Broker MQTT	Entrega de mensajes entre servicios	Falla la ruta de publicación/suscripción
MQTT de Home Assistant	Descubrimiento de entidades y asignación de estados	Faltan entidades o aparecen como no disponibles
Automatizaciones/núcleo	Reglas y llamadas a servicios	La entidad funciona, pero falla la lógica de acción

Preguntas frecuentes

¿Zigbee2MQTT necesita que Home Assistant mantenga activa la red Zigbee?

No. Zigbee2MQTT administra la red Zigbee del lado del coordinador. Home Assistant es un consumidor y una fuente de comandos mediante MQTT. Home Assistant puede estar desconectado mientras el servicio Zigbee2MQTT y el broker siguen funcionando.

¿Por qué las entidades de Zigbee2MQTT aparecen como no disponibles después de reiniciar el broker o Home Assistant?

Por lo general, porque el descubrimiento, el estado retenido, la disponibilidad o los mensajes de reconexión todavía no han reconstruido el contrato MQTT completo. Comprueba el estado del puente de Zigbee2MQTT, la conectividad con el broker, los temas de descubrimiento y la disponibilidad de las entidades antes de volver a emparejar los dispositivos.