Home Assistant Connect ZBT-2
Co to je: USB adaptér od Nabu Casa pro Home Assistant. Běží buď jako Zigbee coordinator, nebo jako Thread rádio, obojí naráz ne. Pro Zigbee funguje se ZHA i Zigbee2MQTT. Nástupce ZBT-1 (dříve SkyConnect), který je ukončený.1
Doporučená varianta pro zákazníky je síťový coordinator SLZB, viz Home Assistant Connect SLZB. Tahle stránka zůstává jako reference pro USB adaptér od Nabu Casa.
Specifikace
- SoC: Silicon Labs MG24. USB-serial bridge: ESP32-S3.1
- Protokoly: Zigbee 3.0 nebo Thread, vždy jen jeden. Bez Bluetooth a Z-Wave.1
- HW i SW jsou open source, kryt jde otevřít bez lepidla a klipů.1
- Napájení a data: USB-C, 5 V DC, 500 mA. Kabel USB-C → USB-A je v balení.2
- Rádio: 2400–2483,5 MHz, anténa 4,16 dBi, všesměrová, Ø 34 mm × 164 mm.2
- Rozměry: 125 × 125 × 315 mm, 350 g, polykarbonát. Provoz jen uvnitř, 0–65 °C.2
- Podle výrobce 4× rychlejší než ZBT-1.2 Syntéza: odpovídá to baudrate 460800 proti 115200 u ZBT-1 (viz tabulka níže).
Instalace a umístění
- Prerekvizity: HA OS s posledními updaty (Green, Yellow, Raspberry Pi), USB prodlužka z balení. U HA Container je potřeba adaptér namapovat do kontejneru.1 Hub potřebuje USB 2.0 port.2
- HA 2025.11+: od této verze HA adaptér spolehlivě objeví a nabízí aktualizace firmwaru.1
- Při přidání v HA zvolíš „Use as Zigbee adapter“ a pak Recommended (ZHA), nebo Custom (vlastní controller, např. Z2M).1
- Anténa svisle, šroubovat s citem, přetažení adaptér nevratně poškodí. Na zeď bokem ne. Pěnu uvnitř antény neodstraňuj, drží ji stabilní a výkon nezlepší.1
- Natrvalo upevni až po ověření, že na místě nic neruší. Zdroje rušení viz Zigbee.1
Zigbee2MQTT
Oficiálně podporovaná je ZHA, Z2M má oficiální kompatibilitu se Silicon Labs rádii s firmwarem EmberZNet.1 Konfigurace v Z2M:
serial:
adapter: ember
port: /dev/serial/by-id/usb-Nabu_Casa_ZBT-2_<usb-serial-number>-if00-port0
baudrate: 460800
rtscts: true
ZHA je v HA aktivní automaticky. Při použití Z2M objevenou ZHA integraci smaž a ignoruj, jinak se budou prát o adaptér.1
Stavová LED
| Vzor | Stav |
|---|---|
| nesvítí | normální provoz, připojeno k Zigbee nebo Thread síti (nebo vypnuto) |
| pulzuje | připojuje se k síti |
| rychle bliká | špatná orientace antény, přemontovat svisle (jen při úvodním nastavení) |
| 4× oranžově → červeně → modře pulzuje | průběh resetu tlačítkem |
Zdroj: Home Assistant Connect ZBT-2 (Nabu Casa Support)1.
Firmware
Zigbee (EmberZNet / EZSP) je předinstalovaný. Thread (OpenThread RCP) slouží jako border router s OTBR app. Instalace i aktualizace jde z integrační stránky ZBT-2 v HA, od HA 2025.11 nativně s notifikací.1
Pro pokročilé universal-silabs-flasher, obnova firmwaru přes Open Home Foundation Toolbox (web, Chrome).1
Repeater (router) firmware, experimentální: ZBT-2 jako samostatný Zigbee router napájený USB nabíječkou (5 V, ≥1 A). Funguje s libovolným coordinatorem. Na coordinatoru ho nepoužívej, zpět jde jen reflashem přes Toolbox.1
Data, reset a předání
- V Zigbee režimu ukládá informace o síti včetně privátního síťového klíče. V Thread režimu nic, data drží HA.1
- Nastavení coordinatoru jsou součástí záloh HA (při startu ZHA a pak každých 24 h).2 Viz Zigbee.
- Odebrání integrace adaptér neresetuje.2
- Reset tlačítkem: smaž integraci (případně nejdřív migruj síť), pak hrotem stiskni a drž tlačítko. Smaže celé NVRAM včetně síťového klíče, potom je adaptér bezpečné předat dál. V Thread režimu nemá reset efekt.1
Rozpor
2 (pre-release 2025) tvrdil, že reset proběhne jen automaticky při migraci a reset „na pár kliknutí“ přijde později.1 (2026) popisuje reset tlačítkem. Platí oficiální dokumentace.
Gotchas
- Dva ZBT-2 se ZHA naráz nejdou, ZHA je single instance. Jiný adaptér s deCONZ nebo Z2M vedle ZBT-2 se ZHA provozovat jde.1
- Po migraci převezme ZBT-2 IEEE adresu starého adaptéru. Starý adaptér proto už nepoužívej se stejným HA.1 Postup migrace: Migrace Zigbee coordinatoru.
- ZHA nepodporuje Zigbee Green Power (ZGP).1
- Bez routerů unese coordinator max. 32 end devices, viz Zigbee.1
Souvislosti
Zdroje
- Home Assistant Connect ZBT-2 (Nabu Casa Support) ↗ — oficiální dokumentace (primární).
- User Documentation for Home Assistant Connect ZBT-2 (DRAFT) ↗ — pre-release draft (superseded). Používá se jen pro specifikace, které oficiální dokumentace neuvádí v textu.
Intellihome