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

76 lines
3.3 KiB
Markdown

---
title: Home Assistant Connect ZBT-2
created: 2026-05-10
updated: 2026-05-10
type: entity
tags: [hub, zigbee, thread, matter, smart-home, iot]
confidence: 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