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

4 COMMENTS
  1. Dear Neil,
    I would like to ask, currently HA is set up on NAS via VirtualBox,
    Because the house is a detached building, the smart home that we want to realize is on different floors.
    Currently, the NAS is placed on a certain floor and connected to the data center of Chunghwa Telecom.
    The other cells of Chunghwa Telecom are connected to the Switch, and the network lines are extended to other floors.
    Other floors have their own Wifi Router and Wifi
    At present, I just want to realize smart home for a certain floor
    I want to ask,
    1.) For Z2M gateway, do I need to buy a corresponding gateway for each floor?!
    Should the connection location be on the NAS (with HAOS installed)?! Or on each floor’s own router (all belong to the same network 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.
    So how do we integrate the “infrared control part” and “G3 monitoring and AI recognition” into HA?!
    Please guide me again, thank you very much! ^^

  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
  • Neil 2025/07/09Hi Victor, it won't affect you much. You can test it after the network is connected in the new house. Regarding the switch, I personally don't recommend changing to 86 boxes. Although it will change your choices, you need to consider the future resale of the house and the possible maintenance and purchase of materials. Besides, 118 is not without good options.Home Assistant installation steps detailed, quickly build a smart home – step-by-step tutorial EP 1
  • Victor 2025/07/09Hello, I expect to finish the decoration by the end of this year, and I want to learn to build a smart home. Regarding the 5th point of setting up the Raspberry Pi, do I need to wait until the new house to connect to the wired network? Or it will not affect, can I build the Raspberry Pi first, and it will not affect the use after the move? (I have been studying the things to prepare for the decoration. In addition to the neutral wire of the switch, I am also hesitant about whether I need to use an 86-spec box, or use vizo) Very newbie question, sorry Ethernet cable: Although the Raspberry Pi you bought may support WiFi connection, in order to allow Home Assistant to have a stable network and considering the need for a fixed IP for future remote control, it is recommended to use a wired network.Home Assistant installation steps detailed, quickly build a smart home – step-by-step tutorial EP 1
  • salvia 2025/07/04Script execution from MQTT sequence: – data: payload: >- {“ir_code_to_send”: “Fill in IR code”} topic: zigbee2mqtt/Tuya ZS06 IR Remote/set action: mqtt.publish alias: “AC Remote: Turn off” mode: single description: “”How to connect Home Assistant to (almost) all Zigbee devices through Zigbee2MQTT – Home Assistant Step-by-Step Tutorial EP 2
  • yc 2025/07/03I would like to ask, I have studied Tuya ZS06 for several days but still don't know how to send messages. I read the article https://www.zigbee2mqtt.io/devices/ZS06.html and it says to publish the following through zigbee2mqtt/FRIENDLY_NAME/set, but I don't know how to enter the following code. Currently, I can search for devices after clicking on zigbee2mqtt, and I can also learn on the page, and I can manually test sending by double-clicking, but I can't set it to send automatically. Do you have any relevant experience to share? Thank youHow to connect Home Assistant to (almost) all Zigbee devices through Zigbee2MQTT – Home Assistant Step-by-Step Tutorial EP 2
  • bdg game 2025/07/03This article is very detailed! For beginners, the installation steps of Home Assistant are clear at a glance, and I believe it will make it easier for many people to get started in the world of smart homes. Looking forward to the follow-up tutorials!Home Assistant installation steps detailed, quickly build a smart home – step-by-step tutorial EP 1
  • Loïc 2025/06/27Thank you for your response, sorry for the late reply. I will plan with Zigbee first, and share with you if there is any switch on Taobao! Thank you!2025 Home Assistant Complete Guide – SMART HOME Smart Home EP 7
  • Neil 2025/06/25Hi Frank, 1. The circuit breaker is not really needed when using a neutral switch, but I still keep it in case the new owner needs it when moving to a new house in the future. 2. The combination of smart switches and smart lamps is more complicated. There must be a neutral line at the lamp. If your lamp is controlled individually, you only need to connect the live wire and the load line directly at the switch (and connect them to the switch at the same time. At this time, the switch does not actually affect the lamp). In this way, the lamp will always have power, and then control the brightness and color temperature of each lamp through the smart hub, and set the switch to switch the linked lamp. My current choice is a smart switch with a traditional recessed lamp, because our family does not have much need to control the brightness and color temperature. Of course, it is good to have it, but whether the usage rate is high enough, you need to evaluate it yourself according to your usage needs~Zero fire switch multi-cut setting tutorial – Home Assistant step-by-step tutorial EP 8
  • Frank 2025/06/25Hello Neil, my family is planning to build a smart home recently. The designer has given me a quote, but I am currently having problems with lamps and switches. The quote includes the switching circuit, switch circuit, and light circuit. After I asked someone, I was told that there is no need to switch the switch circuit because it can be set up through the background of the smart switch, but other circuits (switch circuit, light circuit) are still necessary. In addition to the neutral wire required for the smart switch, each smart lamp must also have a neutral wire so that the brightness, switch, and color temperature of each lamp can be controlled individually. Otherwise, traditional lamps that support color temperature and brightness control must be used, and the controller must be hidden in the ceiling. This method is more cost-effective and can control lamps in an entire circuit at once, but there is no way to control them individually. Is the above understanding correct? How did you choose the lamps in your home? Thanks for clearing up my doubts.Zero fire switch multi-cut setting tutorial – Home Assistant step-by-step tutorial EP 8
  • Neil 2025/06/09Hi Loïc, I would still recommend Zigbee for now. I haven’t done much research on switches from Taobao. If you want something cheaper, you can consider Aqara.2025 Home Assistant Complete Guide – SMART HOME Smart Home EP 7
you might like