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
To form a new Zigbee network
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
- In the dialog, select Use as Zigbee adapter.
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.