Home Assistant Connect ZBT-1 + ZHA The most brainless native Zigbee gateway connects (almost) all Zigbee devices – Home Assistant Step-by-Step Tutorial EP 16

Following the previous article Plug and Play Home Assistant Green Setup Tutorial After that, today we will introduce Home Assistant Connect ZBT-1 with ZHA (Zigbee Home Automation), a native Zigbee connection solution that is also beginner-friendly.

With the combination of Home Assistant Green + Connect ZBT-1, you no longer need to be afraid of using Home Assistant as your smart home central system because "setting up Home Assistant seems complicated", nor do you have to succumb to other cloud central systems. "You want to HA after all, why not do it from the beginning?" Right🤣

If you want to know about Home Assistant Green installation-free plug-and-play Home Assistant, you can refer to:

Even if you don't use Home Assistant Green to set up Home Assistant, Connect ZBT-1 is also a good choice. Let's take a look at how to use Connect ZBT-1 to connect the Zigbee device in Home Assistant!

Glossary

After writing the preface, I found that there are many similar nouns. Considering that this article may be the first few that you come into contact with smart home, you will be confused. I will first make a simple explanation of the nouns and attach reference materials. I hope it can help you learn more. Understand soon😁

  • Home Assistant: HA for short, an open source smart home hub system. Different from the common HomeKit and Google Home, Home Assistant provides a completely local construction solution and provides a high degree of privacy and customization. Related references:
  • Home Assistant Green: Home Assistant officially launches a plug-and-play HA host that requires no self-installation system. Related introduction:
  • Home Assistant ZBT-1:Old name Home Assistant SkyConnect, since 2024/06/13 announcementRenamed "ZBT-1" to allow Home Assistant to connect to Zigbee and Thread devices, commonly known as "gateway".
  • Zigbee: A smart home device connection method, characterized by the ability to expand network coverage between devices through mesh topology. With proper configuration, a single gateway can open up a whole building.
  • ZHA: Zigbee Home Automation is one of the Zigbee connection solutions in the Home Assistant environment. In addition to ZHA, Zigbee2MQTT is also a common connection solution choice. Reference:

The difference between ZHA and Zigbee2MQTT

ZHA and Zigbee2MQTT are both ways to connect Zigbee devices in Home Assistant:

  • ZHA: It is part of Home Assistant and is jointly maintained by the Home Assistant development team and open source contributors. It prefers the official, built-in stable integration solution and mainly relies on the core technology and architecture of Home Assistant.
  • Zigbee2MQTT: An independent open source project, also maintained by open source contributors and led by the open source community. It is powerful and flexible, but requires more manual settings and learning curve.

特性

ZHA

Zigbee2MQTT

安裝與設定

Native to Home Assistant, no need to install additional services.

Additional installation of Mosquitto (MQTT Broker) and Zigbee2MQTT tools is required.

易用性

The user interface is simple and you can start using it directly through Home Assistant settings.

需要更多手動設定,適合進階使用者。

裝置支持

Supported devices are limited and depend on the integration provided by Home Assistant.

Supports more devices, almost all Zigbee devices can be supported (need to check官方支援清單)。

If you want to learn more about the devices supported by ZHA and Z2M, you can refer to the unofficial information jointly maintained by netizens:https://zigbee.blakadder.com/

※ 注意!因為是非官方資訊,所以資訊更新未必即時。

協議靈活性

Using the standard Zigbee protocol, functionality is limited by Home Assistant.

提供更多細緻的功能,如固件升級、自定義裝置名稱、細節參數調整等。

穩定性

穩定性較高,適合家庭使用者和初學者。

Relies on MQTT and external services, stability depends on environment, but powerful.

操作界面

Manage directly from the Home Assistant interface.

Through Zigbee2MQTT's web interface or command line management, the functions are more diverse.

社群支持

官方社群提供基本支持,但資源相對較少。

擁有活躍的開源社群,提供詳細文檔和問題解決支持。

進階功能

The functions are basic and mainly suitable for general Zigbee automation needs.

支援進階功能(如群組控制、裝置指令測試、自定義訊息處理等)。

Home Assistant Connect ZBT-1 unboxing

Home Assistant Connect ZBT-1 盒裝
Home Assistant Connect ZBT-1 盒裝

I'd like to apologize first, I only took the boxed version and forgot to take the actual one😅 But it's easy to imagine that what's inside is actually the Connect ZBT-1 body plus a transmission line. I'll explain why the transmission line is needed later.

Step 1. Installation

There is only one important point in the installation part (maybe one of the few shortcomings of Connect ZBT-1), which is that you cannot directly plug ZBT-1 into the host. Instead, you need to use an extension cable to keep ZBT-1 as far away from the host and the host as possible. Any WiFi 2.4 GHz device will cause mutual interference and is specifically noted in the enclosed manual.

Home Assistant Connect ZBT-1 安裝注意事項
Image credit: Home Assistant

Step 2. Configure Connect ZBT-1

  1. Go to "Settings > Devices and Services"
  2. Find "Connect ZBT-1" and click "Add"
image 2
  1. Click "Zigbee" (I won't introduce the Thread connection today, I'll talk about it later😜)
image 3
  1. Click "Send" and "Finish"
image 6
  1. Added "ZBT-1" to the integration
image 7
  1. Click "Create Network" (if you want to restore the original Zigbee network, select "Upload Manual Backup")
image 5

That’s it!

Step 3. Add Zigbee device

There are two paths to operate:

  1. Settings > Devices & Services > Integration > Zigbee Home Automation > Add Device
  2. Settings > Devices & Services > Devices > Add new device

Remember to switch the Zigbee device to pairing mode, and then you can see the Zigbee devices that have not yet joined the network~

image 8

Conclusion

Although ZHA does not support as many devices as Zigbee2MQTT, the installation steps are much simpler, and it is officially supported by HA. Newly launched Zigbee devices are also adding support quickly. If you are not very confident in installing software and debugging yourself, Connect ZBT-1 would be a good choice.

Then you are welcome to join the smart home!

Recommend you to watch

3 COMMENTS
  1. Neil大大,
    想請教,目前將 HA 透過 VirtualBox 設置在 NAS上,
    因家中屬於透天,想要實現的智慧家居皆在不同樓層
    目前NAS放置於某一樓層,與 中華電信的數據機座連接,
    而由中華電信其他網孔接到Switch上,拉網路線到其他樓層,
    其他樓層皆有自己的Wifi Router,和自有的Wifi
    而目前我只想先針對某一樓層 實現智慧家居
    想請教,
    1.) Z2M的網關,需要每一個樓層都購買一個對應的網關嗎?!
    所需接的位置是在NAS (有安裝HAOS) 上?! 還是每一樓層自己的Router(皆屬同一網域) 上?!
    2.) 有購買 Aqara M2 和 G3,主要是希望透過 M2 / G3 的紅外線功能控制 家電 (如 : 電扇、冷氣、電視…等等),
    那這部分”紅外線控制的部分”及”G3監控及AI辨識”等等的部分,如何整合進入HA呢?!
    再請您指引明燈,十分感謝 ! ^^

  2. How to use zha or even z2m to access the device into HA
    Will there be fewer functions?

    For example, after my switch (Aqara z1) is connected to zha
    The switch function cannot be set to lock the relay to switch to wireless switch mode, and the extra wireless switch cannot be used.

    Is there anything else to set?

    Thanks

LEAVE A REPLY

Please enter your comment!
Please enter your name here

you might like
recent discussions
  • Lokous 2025/05/15Neil, I would like to ask you, I have set up HA on NAS through VirtualBox. Because my home is a townhouse, the smart home I want to realize is on different floors. The NAS is currently placed on one floor and connected to the data base of Chunghwa Telecom. The other mesh ports of Chunghwa Telecom are connected to the Switch, and the network routes are pulled to other floors. The other floors all have their own Wifi Routers and their own Wifi. At present, I only want to realize the smart home for a certain floor. I would like to ask, 1.) Do I need to buy a corresponding gateway for each floor for the Z2M gateway?! Is the required location to connect to the NAS (with HAOS installed)?! Or is it on the Router of each floor (all belong to the same domain)?! 2.) I have purchased Aqara M2 and G3, mainly hoping to control home appliances (such as fans, air conditioners, TVs, etc.) through the infrared function of M2 / G3. How can the "infrared control part" and "G3 monitoring and AI recognition" and other parts be integrated into HA?! Please guide me again, thank you very much! ^^Home Assistant Connect ZBT-1 + ZHA The most brainless native Zigbee gateway connects (almost) all Zigbee devices – Home Assistant Step-by-Step Tutorial EP 16
  • Neil 2025/05/15Hi Willson, 1. First confirm whether the NAS detects the USB: Use dmesg or lsusb to see if there is a new device. If not, try another USB port or check if there is any problem with the driver. 2. Check whether the NAS has passed USB passthrough to HA: This depends on how you set up HA. If you use Docker, try adding –device=/dev/ttyUSB0 –privileged to the container settings, or manually mount it in the devices section of docker-compose.How to connect Home Assistant to (almost) all Zigbee devices through Zigbee2MQTT – Home Assistant Step-by-Step Tutorial EP 2
  • Willson 2025/05/14Hello Neil, I use NAS to set up HA. I bought the USB version and plugged it into the NAS. However, when I checked all the hardware in the system, I did not see any new devices. What could be the possible cause of this problem?How to connect Home Assistant to (almost) all Zigbee devices through Zigbee2MQTT – Home Assistant Step-by-Step Tutorial EP 2
  • V3 game 2025/05/12Thanks for sharing such detailed installation steps! I’ve always wanted to try building a smart home, and this article gave me more confidence to start. Looking forward to ep 2!Home Assistant installation steps detailed, quickly build a smart home – step-by-step tutorial EP 1
  • Neil 2025/05/07Hi Lulu, it depends on whether you want to control the switch intelligently. I usually don't recommend using traditional switches with smart lamps, because in this case the traditional switch can only be always on so that the lamp can be powered and connected to the line. In short, if you want to use smart lamps, it is recommended that the switch be equipped with a neutral line. After the neutral line is pulled, there are two ways: 1. Use a zero-fire switch with a decoupling function with smart lamps, set the switch to decoupling mode (the lamp is always powered, only for remote control), and set the switch to link the lamp in HA. 2. Use a zero-fire switch with smart lamps, directly connect the live wire and the control wire at the switch (the control wire does not enter the switch), and finally set the switch to link the lamp in HA.A complete analysis of smart home lighting control solutions: smart switches, smart bulbs, smart relays, there is always one that suits you!
  • Lulu 2025/05/05Hello Neil, I would like to ask, the current smart lamps already have recessed lamp types, do I still need to pull a neutral wire?A complete analysis of smart home lighting control solutions: smart switches, smart bulbs, smart relays, there is always one that suits you!
  • MINECRAFT APK 2025/04/26Very detailed installation steps! This article helped me successfully complete the setup of Home Assistant. I look forward to the follow-up tutorials! Thanks for sharing!Home Assistant installation steps detailed, quickly build a smart home – step-by-step tutorial EP 1
  • Jerry 2025/04/14Thank you very much Neil for your selfless sharing. The websites you provided are of great help to me. I will save it first and digest it slowly^^ I also look forward to Neil's industry news and teaching articles in the futureHome Assistant Floor plan A new experience in smart home control with visual floor plan! – Home Assistant step-by-step tutorial EP 6
  • Neil 2025/04/13Hi Jerry, I usually get information about HA from these places: Website: – Home Assistant official Release notes – Automata – Home Automation Community – Weijia Home Intelligence FB Group: – Taiwan Home Assistant enthusiasts exchange – Home Assistant YouTube channel: – Smart Home Solver – Everything Smart Home – Home Assistant Programming language: Strictly speaking, YAML is not really a programming language (let me make this clear in case some people mind 🤣), but if we include these data formats or style languages that “look like” programming languages, and sort them by depth of use in HA (the deeper the bottom, the deeper the bottom): – YAML (data format): a language for configuration files used in many places in the HA environment. – CSS (style language): used to adjust the interface style (font size, color, image, position, etc.). – JSON (data format): If you use Node-RED, you will probably come across it. – Jinja2 (Python template syntax): You may encounter it when you explore automation or Dashboard in depth. ※ But in fact, even if HA does not know the above, it can still make a smart home complete. You don’t have to put so much pressure on yourself, but if you are interested, it is also good to know more. It is actually difficult to generalize about the support of devices. Now, even if the home appliances themselves do not support it, there are still many different ways to connect traditional home appliances to HA. In addition, cases like Haier do require in-depth research. What I usually do is to crawl a lot of information on the Internet, and usually find attempts made by others. It just so happens that when I was looking up other information recently, I saw someone sharing how Haier water heaters were connected to HA. But it is indeed like what you said, if you get involved for a while, you will understand these details more and more. 🤣Home Assistant Floor plan A new experience in smart home control with visual floor plan! – Home Assistant step-by-step tutorial EP 6
you might like