Follow this guide if you have a deCONZ network running with a ConBee II or RaspBee II and want to migrate to Connect ZBT-1 and ZHA.
Note:
Not possible to migrate all settings and devices
This procedure only helps migrate basic network settings to Home Assistant Connect ZBT-1.
- Customizations like device names will be lost and automations will need to be updated.
- Most powered devices like lightbulbs will be re-discovered over time (you can speed this up by rebooting the device) but your battery-powered devices may need to be re-joined to the network for the migration to complete.
- There is currently no migration path to migrate all settings and devices.
To migrate a deCONZ network to Connect ZBT-1 using ZHA
Step 1
Viewing the firmware version of the stick
- In the deCONZ app, under Settings > Gateway, check the firmware version. It should be version 26720700 or newer.
- If the version is recent enough, skip the next two steps and continue with Step 4 (Stop the deCONZ add-on).
- If the version is not up-to-date, select Update to 26720700.
Step 2
Following the wizard
- Select Create backup and let the wizard guide you through the update process.
Step 3
Updating complete
- Once the update is complete, you will see the new firmware version.
Step 4
Stopping the deCONZ add-on
- In the deCONZ add-on, make sure the Start on boot option is disabled.
- Select Stop.
Step 5
Removing the deCONZ integration
- Under Settings > Devices & services, select the deCONZ integration.
- Select the three dots menu and select Delete.
Step 6
Adding a new ZHA integration
- In the top-right corner, make sure the checkboxes Show ignored integrations and Show disabled integrations are selected.
- Check if the ZHA integration shows up.
- If the ZHA integration does not show up, select Add integration, then select ZHA from the list.
Step 7
Select Configure
- Once the ZHA integration has detected ConBee II, select Configure.
Step 8
Submit
- To setting up ConBee II as ZHA integration, select Submit.
Step 9
Choosing the serial port
- Choose the serial port and select Submit.
Step 10
Choosing the network settings for the radio
- Select Keep radio network settings.
Step 11
Wait
- Wait for the settings to be loaded.
Step 12
Adding deCONZ to area
- Once deCONZ has been recognized as your Zigbee coordinator, add it to your area.
- Select Finish.
Step 13
Wait
- Wait for the devices to rejoin the network
- Normally, powered devices rejoin within one hour.
- You may be able to accelerate that process by power-cycling devices.
- Your battery-powered devices may need to be re-joined to the network manually.
- Once the devices show up in the integration, select the integration.
Step 14
Configuring settings
- To open the network settings, under Integration entries, select Configure.
Step 15
- Under Network Settings, select Migrate radio.
Step 16
Reconfigure ZHA
- Reconfigure ZHA: Select Submit.
Step 17
Migrating to a new radio
- Select Migrate to a new radio.
Step 18
Starting the automatic backup
- Start the automatic backup.
- Make sure the ConBee firmware is running firmware version 26720700.
- When it is up-to-date, select Submit.
Step 19
Unplugging your old radio
- If you no longer need the old radio stick, you can now remove it.
- Before selecting Submit, connect Connect ZBT-1, as described in the following step.
Step 20
Adding the extension cable
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 21
Submit
- Now that Connect ZBT-1 is plugged in, select Submit.
Step 22
- Select the serial port for Connect ZBT-1, then select Submit.
Step 23
Restore automatic backup
- Select Restore an automatic backup.
Step 24
Choosing the backup
- Choose the latest backup and select Submit.
Step 25
Overwriting radio IEEE address
- Overwrite radio IEEE address.
- Select the Permanently replace the radio IEEE address and select Submit.
- Info: This means that your old stick and your new stick will have the same IEEE address.
- This is required for the migration process to complete successfully.
- From this point onwards, you should not operate the old stick in the same area.
- If you do not migrate the IEEE address from your old stick, you'll have to repair many of your devices in order to keep them working.
Step 26
Wait
- Wait
- Overwriting the IEEE address may take a while. Wait.
Step 27
Checking the Connect ZBT-1 ZHA integration
- Connect ZBT-1 is now set up in the ZHA integration.
- To check whether the migration was successful, select the integration.
Step 28
Checking the radio type
- Under Network Settings, check the Radio type. It should say ezsp.
Step 29
Renaming the ZHA integration
- To avoid confusion, rename the ZHA integration.
Step 30
Changing the ZHA integration name
- Change the ZHA integration name to Connect ZBT-1 and select OK.
Step 31
Reconfiguring automations and dashboards
- Info: All migrated devices have new entity IDs. This means you will need to manually reconfigure automations and dashboard cards.
- Info: The names that you manually assigned to your devices won't have been migrated. You will have to rename the devices again.