ZBT-2: primera instalación Zigbee en HA

Publicado el 20-10-2026

Para añadir Zigbee a Home Assistant con el Connect ZBT-2 se conecta el adaptador a un puerto USB del servidor y se añade la integración Zigbee Home Automation (ZHA), que lo detecta sola y crea la red en 10-30 segundos ^[2]. Después se empareja cada dispositivo con «Añadir dispositivo». El ZBT-2 trabaja en Zigbee o en Thread, no en ambos a la vez ^[1].

Antes de empezar: necesitas un Home Assistant que ya esté en marcha y el Connect ZBT-2. Si aún no tienes el servidor instalado, la guía Home Assistant Green: primeros pasos te lleva desde cero hasta tener HA funcionando.

Requisitos previos

Home Assistant OS o Home Assistant Supervised: son las dos versiones con soporte para complementos (add-ons). Sin ellas, ZHA funciona igualmente pero no podrás instalar el add-on de Zigbee2MQTT ni el broker MQTT desde la propia interfaz de HA ^[1].
Puerto USB disponible en el equipo que corre HA. El ZBT-2 ocupa un USB-A estándar.
HA en versión reciente: el ZBT-2 es el adaptador oficial de Home Assistant y recibe soporte directo desde la interfaz; las versiones más antiguas pueden no reconocerlo automáticamente ^[1].

Conectar el ZBT-2 y verificar que HA lo detecta

Con HA encendido, conecta el ZBT-2 a un puerto USB del servidor.
En HA, ve a Ajustes → Sistema → Hardware. El ZBT-2 debe aparecer listado como dispositivo serial bajo el nombre «Home Assistant Connect ZBT-2» o similar.
Si no aparece, desconéctalo y vuelve a conectarlo. En algunos equipos hay que esperar unos 10 segundos a que el sistema operativo lo registre.

Si el servidor de HA es el Home Assistant Green, el ZBT-2 encaja directamente en el puerto USB trasero ^[1].

Elegir entre ZHA y Zigbee2MQTT

Antes de configurar, decide qué integración vas a usar. Ambas funcionan con el ZBT-2 ^[1]:

	ZHA	Zigbee2MQTT
Instalación	Integración nativa de HA, sin pasos extra	Requiere add-on Mosquitto broker + add-on Z2M
Compatibilidad de dispositivos	Alta; mejora con cada versión de HA	Mayor, con base de datos comunitaria extensa
Diagnóstico y datos	Básico	Extendido (LQI, consumo, OTA de dispositivos)
Actualizaciones OTA de dispositivos	Limitado	Sí en muchos dispositivos
Curva de aprendizaje	Baja	Media

Usa ZHA si estás empezando con Zigbee, tienes pocos dispositivos o no necesitas diagnóstico avanzado. Es la opción más directa ^[2].

Usa Zigbee2MQTT si ya conoces el sistema, tienes muchos dispositivos, o necesitas funciones avanzadas como exposición detallada de datos, OTA en dispositivos o grupos Zigbee ^[3].

Esta guía desarrolla el proceso con ZHA por ser la ruta más rápida para empezar.

Configurar ZHA con el ZBT-2

1. Añadir la integración ZHA

En HA, ve a Ajustes → Dispositivos e integraciones → Añadir integración y busca Zigbee Home Automation.
HA detecta automáticamente el ZBT-2. Si lo hace, selecciónalo y continúa. Si pide la ruta manual, introduce /dev/ttyUSB0 o la ruta que apareció en el panel de Hardware ^[2].
HA inicializa la red Zigbee. El proceso tarda entre 10 y 30 segundos. Cuando termine, aparece el panel de ZHA con la red lista.

Si tienes ya otro coordinador Zigbee en el mismo equipo (por ejemplo, un ZBDongle-E), asegúrate de que cada adaptador tiene su propia integración asignada a su ruta correcta ^[2].

2. Modo de emparejamiento

Para añadir dispositivos Zigbee, la red debe estar en modo de emparejamiento:

En el panel de ZHA, pulsa Añadir dispositivo.
La red entra en modo de emparejamiento durante 60 segundos (configurable).
En ese tiempo, pon en modo de emparejamiento el dispositivo Zigbee que quieres añadir.

3. Emparejar el primer dispositivo

El método de emparejamiento varía por fabricante, pero el más habitual es:

Mantén pulsado el botón de reset del dispositivo durante 3-5 segundos hasta que el LED parpadee rápidamente (normalmente 3 destellos cortos repetidos).
En HA, el dispositivo aparece en el panel de ZHA en cuestión de segundos con su nombre y sus entidades.

Si el dispositivo no aparece en 60 segundos:

Comprueba que está dentro del alcance del ZBT-2 (empareja siempre cerca del coordinador; puedes acercarlo más tarde).
Repite el reset más tiempo; algunos dispositivos necesitan un reset de fábrica completo (5-10 segundos).
Verifica que el dispositivo es Zigbee 3.0 o anterior (no Thread ni Z-Wave).

4. Verificar las entidades en HA

Una vez emparejado, el dispositivo aparece en Ajustes → Dispositivos e integraciones → Zigbee Home Automation → Dispositivos. Cada dispositivo tiene sus entidades: switch, binary_sensor, sensor, light… según el tipo. Las entidades están disponibles de inmediato en paneles, automatizaciones y scripts.

Nota importante: Zigbee o Thread, no ambos

El ZBT-2 puede funcionar en modo Zigbee (con ZHA o Zigbee2MQTT) o en modo Thread (como border router OpenThread), pero no en los dos a la vez ^[1]. Si tienes dispositivos Matter sobre Thread (cerraduras, bombillas certificadas Thread) y también dispositivos Zigbee, necesitas dos adaptadores: uno en cada modo.

La buena noticia es que el equipo del Home Assistant Green tiene dos puertos USB y puede alojar el ZBT-2 (Zigbee) y el Connect ZWA-2 (Z-Wave) simultáneamente, cada uno con su integración separada ^[1].

Actualizar el firmware del ZBT-2 desde HA

El ZBT-2 es el adaptador oficial de Home Assistant y HA puede actualizar su firmware directamente desde la interfaz, sin herramientas externas ^[1]:

Ve a Ajustes → Sistema → Hardware.
En la entrada del ZBT-2, pulsa el botón de configuración o los tres puntos.
Si hay una actualización de firmware disponible, aparece la opción de instalarla. HA descarga y aplica el firmware en unos minutos sin desconectar el adaptador.

Mantener el firmware del ZBT-2 actualizado mejora la compatibilidad con dispositivos nuevos y la estabilidad de la red Zigbee ^[1].

Preguntas frecuentes

¿Necesito HA OS obligatoriamente?

Para ZHA no: ZHA es una integración nativa de HA y funciona en todas las versiones (OS, Supervised, Container y Core). Para el add-on de Zigbee2MQTT sí hace falta HA OS o Supervised, ya que los add-ons solo están disponibles en esas versiones ^[1]^[3].

¿El ZBT-2 sirve para Thread además de Zigbee?

Sí, pero en modos separados. El mismo dongle puede configurarse como border router Thread para dispositivos Matter-Thread, pero en ese modo no funciona como coordinador Zigbee. Decide qué protocolo necesitas y asigna el ZBT-2 a ese modo ^[1].

¿Puedo migrar desde un ZBDongle-E sin volver a emparejar todos los dispositivos?

Home Assistant incluye herramientas de migración de red Zigbee para los adaptadores más habituales. El proceso depende del adaptador de origen y puede no ser 100% automático; consulta la documentación oficial del ZBT-2 en home-assistant.io para el procedimiento actualizado ^[1].

¿Cuántos dispositivos Zigbee puede gestionar el ZBT-2?

El límite teórico del chip (Silicon Labs EFR32MG21) es similar a otros adaptadores basados en el mismo hardware: en torno a 200 dispositivos directos. Con una malla bien construida (dispositivos enchufados actúan de routers Zigbee), se pueden gestionar más dispositivos finales. En redes domésticas de hasta 50-80 dispositivos el ZBT-2 funciona sin limitaciones prácticas ^[1].

¿Necesito alargador USB?

HA y los fabricantes de dongles recomiendan usar un cable alargador USB 2.0 de 15-30 cm para reducir interferencias electromagnéticas del propio equipo sobre la radio del dongle. No es obligatorio, pero mejora la estabilidad en instalaciones con equipos que generan interferencias en la banda de 2,4 GHz ^[1]^[2].

Fuentes

Home Assistant, Connect ZBT-2 — https://www.home-assistant.io/connect/zbt-2/ (2026-10-01)
Home Assistant, ZHA — https://www.home-assistant.io/integrations/zha/ (2026-10-02)
Zigbee2MQTT — https://www.zigbee2mqtt.io/ (2026-10-16)

Este artículo se ha elaborado con inteligencia artificial y puede contener errores. Si ves alguno, escríbenos a info@comfortek.es y lo corregimos.