ZHA: Zigbee directo en Home Assistant, sin MQTT

Descripción general

ZHA (Zigbee Home Automation) conecta sensores, bombillas, enchufes y mandos Zigbee de cualquier marca directamente con Home Assistant, sin MQTT ni apps aparte. Solo necesitas un adaptador Zigbee USB. Los aparatos enchufados a la red hacen de routers y amplían el alcance: la red es una malla.

Esquema: los sensores Zigbee a pilas hablan con enchufes y bombillas, que hacen de routers y llevan la señal al adaptador Zigbee, conectado por USB a Home Assistant con ZHA — Una malla Zigbee y un adaptador USB.

Esquema: NODARA.

Requisitos

Un adaptador Zigbee. El recomendado para redes nuevas es el Connect ZBT-2. También funcionan el SONOFF ZBDongle-E, el SMLIGHT SLZB-07 o el ConBee III, entre otros. Más en Dispositivos.
Conéctalo con un alargador USB a un puerto USB 2.0, lejos de discos y puertos USB 3, que interfieren.
ZHA suele aparecer como descubierta: Ajustes → Dispositivos y servicios → Configurar. Si no, añádela y elige el puerto, mejor por su ruta /dev/serial/by-id.
Fuente: documentación oficial de ZHA.

Emparejar un dispositivo

Ajustes → Conectividad → Zigbee → Añadir dispositivo.
Resetea el dispositivo como diga el fabricante (pulsar un botón unos segundos, encender y apagar una bombilla varias veces…).
Espera a que aparezca, ponle nombre y asígnale un área.

Empareja primero los aparatos enchufados (son los routers) y hazlo en el sitio donde van a quedarse.

Ideas de uso

Luz del pasillo con sensor de movimiento. Es el ejemplo de abajo.
Grupos Zigbee de bombillas que se encienden a la vez, sin efecto «palomitas».
Vincular (binding) un mando con una bombilla para que funcione aunque Home Assistant esté apagado.
Sensores de puerta, agua y temperatura a pilas que duran años.
Actualizar el firmware de los dispositivos desde Home Assistant (entidades de actualización).
Migrar la red a un adaptador nuevo sin volver a emparejar nada.

Ejemplo de uso

alias: "Luz del pasillo con movimiento"
mode: restart
triggers:
  - trigger: state
    entity_id: binary_sensor.pasillo_movimiento
    to: "on"
actions:
  - action: light.turn_on
    target:
      entity_id: light.pasillo
    data:
      brightness_pct: 60
  - wait_for_trigger:
      - trigger: state
        entity_id: binary_sensor.pasillo_movimiento
        to: "off"
        for: "00:02:00"
  - action: light.turn_off
    target:
      entity_id: light.pasillo

Cómo funciona:

El sensor de movimiento Zigbee aparece como un binary_sensor normal: las automatizaciones son las mismas que con cualquier otra integración.
Con modo restart, cada nuevo movimiento reinicia la espera.
La luz se apaga tras 2 minutos sin movimiento.

Acción

binary_sensor.pasillo_movimiento = on

Resultado

light.pasillo = on (60 %)
se apaga 2 minutos después del último movimiento

Copias de la red: ZHA guarda copias automáticas de la red Zigbee. Si cambias de adaptador, usa Migrar en Ajustes → Conectividad → Zigbee: los dispositivos vuelven solos, aunque algunos tardan hasta una hora.