Forming a new Zigbee network with Home Assistant Connect ZBT-1 – Nabu Casa Support

Prerequisites

Home Assistant Operating System installed on your smart home hub. For example:
- on a Home Assistant Green, where Home Assistant OS is preinstalled
- on a Home Assistant Yellow or on a Raspberry Pi
have the latest updates installed
Home Assistant Connect ZBT-1 adapter and USB extension cable
Zigbee devices

Step 1

Plugging the extension cable into Home Assistant Connect ZBT-1

Notice

USB 3.0 ports and USB 3.0 drives can cause interference with 2.4 GHz protocols, including the ones provided by Home Assistant Connect ZBT-1.

It is important to use the USB extension cable and to position the Home Assistant Connect ZBT-1 away from possible interference sources.
This video shows the effect of interference.

Plug the Home Assistant Connect ZBT-1 into the USB extension cable.
Plug the extension cable into your Home Assistant instance.
If you are using the standalone Home Assistant Container installation method, make sure Connect ZBT-1 is mapped to the container.

Step 2

Locating the Home Assistant Connect ZBT-1 integration

Go to Settings > Devices & services.
Connect ZBT-1 should now have been discovered.
- Troubleshooting: If the device is not discovered, check the troubleshooting steps.
Select Add.

Step 3

Picking your protocol

Step 4

Select installation type

Option 1: If you are a new user, select Recommended installation.
- This adds the device to Home Assistant and configures Zigbee with the Zigbee Home Automation integration that was developed specifically for Home Assistant.
Option 2: If you have your own controller, for example Zigbee2MQTT, select Custom.
- This option adds the device to Home Assistant, but you will need to manually install the controller of your choice on your own.
- Those custom steps are not covered in this documentation.

Step 5

Adding devices to an area

Follow the steps on screen, and when prompted, add the Zigbee adapter to an area.
Select Finish.

Step 6

Adding Zigbee devices

Notice

USB 3.0 ports and USB 3.0 drives can cause interference with 2.4 GHz protocols, including the ones provided by Home Assistant Connect ZBT-1.

It is important to use the USB extension cable and to position the Home Assistant Connect ZBT-1 away from possible interference sources.
This video shows the effect of interference.

You can now add your Zigbee devices to the Zigbee network.
- Select 1 device and select Add devices via this device. ZHA will now search for Zigbee devices in pairing mode.
- Put your Zigbee device into pairing mode.