Files
hermes-ice/homelab/entities/home-assistant-connect-zbt-2.md
Hermes Agent e4d91aadf9 Initial commit: homelab infrastructure wiki
- Full Obsidian vault content
- Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte)
- Media stack documentation
- Traefik HA setup
- Automation scripts
- Bachelor party planning
2026-05-24 16:08:40 -07:00

3.3 KiB

title, created, updated, type, tags, confidence
title created updated type tags confidence
Home Assistant Connect ZBT-2 2026-05-10 2026-05-10 entity
hub
zigbee
thread
matter
smart-home
iot
high

Home Assistant Connect ZBT-2

Nabu Casa's official Zigbee + Thread coordinator dongle for Home Assistant. Plugged into panda, serves as the primary Zigbee and Thread border router for the smart home.

Overview

Field Value
Manufacturer Nabu Casa
Model Home Assistant Connect ZBT-2
Serial E072A1DC134C
Host panda (plugged into USB)
Protocols Zigbee 3.0 + Thread (IEEE 802.15.4)
HA Integration ZHA (Zigbee) + Thread (OpenThread Border Router)

Role in the Smart Home

The Connect ZBT-2 is the primary coordinator for all Zigbee and Thread devices in the home. It provides:

  1. Zigbee Coordinator — via ZHA integration, manages the Zigbee mesh network
  2. Thread Border Router — via Thread integration, provides IP connectivity for Thread devices
  3. Matter Controller — via Matter integration, commissions and controls Matter devices over Thread

Zigbee Devices (via ZHA)

All Zigbee devices are paired directly to the Connect ZBT-2 coordinator:

Device Location Model Type
Aqara Door/Window Sensor Rooftop Aqara Door and Window Sensor sensor
Aqara Vibration Sensor T1 Rooftop Aqara Vibration Sensor T1 sensor
Aqara Motion Sensor P1 Living Room Aqara Motion Sensor P1 sensor
Aqara Light Switch H2 US Baby Room Aqara Light Switch H2 US actuator
Aqara Light Switch H2 US Front Door Aqara Light Switch H2 US actuator
Aqara Light Switch H2 US Entrance Aqara Light Switch H2 US actuator
Aqara Light Switch H2 US 1st Floor Aqara Light Switch H2 US actuator
Aqara Colorful Ceiling Light 36W Baby Room Colorful Ceiling Light 36W actuator
Aqara Smart Lock U100 Front Door Aqara Smart Lock U100 actuator
IKEA STARKVIND STARKVIND Air purifier actuator

Thread Network

The Connect ZBT-2 runs an OpenThread Border Router, creating a Thread network that:

  • Provides IP connectivity to Thread-only devices
  • Acts as a Matter fabric gateway
  • Shares Thread credentials with other border routers (e.g., Apple TV, Nest Hub) for mesh redundancy

Multi-Fabric Position

In the matter-multi-fabric architecture, the ZBT-2 serves as:

  • HA's Matter fabric controller — primary commissioning point for new Matter devices
  • Thread credential source — other border routers should join this Thread network
  • Zigbee bridge — exposes Zigbee devices to Matter via HA's Matter Bridge feature

Relationships

  • Connected to panda via USB
  • Controls all Zigbee devices in the home
  • Provides Thread connectivity for matter-multi-fabric
  • Complements aqara-hub-m3 (which bridges Aqara-specific devices via Matter)

Notes

  • Thread credentials should be shared with aqara-hub-m3 and Apple TV to ensure a single unified Thread mesh
  • If adding more Thread border routers, export credentials from this OTBR and import them
  • The ZBT-2 is a dual-protocol radio — Zigbee and Thread cannot run simultaneously on the same radio; HAOS handles multiplexing