Saltar a contenido

ZHA (Zigbee Home Automation)

Integration built-in de Home Assistant que habla Zigbee directamente sin pasar por MQTT. ~2,000 devices soportados, más simple de configurar, menor maintenance burden, pero menos flexible y con diagnostics más limitados que Z2M. Mejor opción si tenés <20 devices y querés la menor complejidad posible.

Contexto

Para el setup del usuario, ZHA no es la elección recomendada hoy — pero importa conocer su existencia y sus trade-offs. Si Z2M sigue rompiéndose tras HA upgrades con cierta frecuencia, ZHA es el plan B (con el costo de re-pair de todo).

Contenido

Stack

  • Parte del HA core (no es add-on, no es container separado).
  • Habla directamente con el coordinator USB stick (mismo hardware que Z2M).
  • Storage propio dentro de HA (config/zigbee.db u similar).

Características

  • ~2,000 devices soportados (2026).
  • Quirks system para custom devices — más técnico que el converters de Z2M.
  • OTA: cobertura limitada de brands.
  • Network map: básico, sin LQI detallado ni packet logs.

Setup

3 pasos vs los 8 de Z2M: 1. Settings → Devices & Services → Add Integration. 2. Seleccionar coordinator USB stick. 3. Confirmar serial port.

Sin Mosquitto, sin add-on aparte, sin YAML config inicial.

Reliability profile

  • No external broker dependency: si HA está vivo, ZHA está vivo. No hay "Mosquitto down".
  • Restarts limpios dentro del HA core update cycle.
  • Update path predecible: ZHA upgrade coupled con HA core, backward compat más estable.
  • Soporte del HA team direct: issues del core team, no community-driven third-party.

Costo de cambiar a ZHA desde Z2M

  • Re-pair de cada device desde cero (no hay tool automático).
  • ~30 minutos mínimo para red mediana, más según device count.
  • Mismo coordinator funciona (no hay que comprar hardware nuevo).

Cuándo elegir ZHA

  • Setup nuevo desde cero con <20 devices.
  • Marcas mainstream (Hue, IKEA, Aqara core line).
  • Priorizá simplicidad sobre flexibility/diagnostics.
  • HA Yellow / Green con SkyConnect o ZBT-1.

Cuándo NO elegir ZHA

  • Tenés Z2M funcionando con >20 devices (no migres).
  • Usás Tuya / Sonoff / Chinese OEM (cobertura insuficiente).
  • Querés network diagnostics detallados o OTA agresivo.

Relaciones

Citas / evidencia

Abierto / gaps

  • Documentar caso límite: ¿alguien ha hecho un coordinator dual-running de ZHA + Z2M con dos coordinators distintos? Para essentials/experimental partition.
  • Validar update behavior real: cuántos releases de HA en 2025-2026 introdujeron breaking changes en ZHA. ¿Es realmente más estable o sólo se "siente" así?