Follow this guide if you have a deCONZ network running with a ConBee II or RaspBee II and want to migrate to SkyConnect and ZHA.
Note: this procedure only helps migrate basic network settings to your Home Assistant SkyConnect, 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.
Migrate a deCONZ network to SkyConnect using ZHA
Step 1View 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 2Follow the wizard
- Select Create backup and let the wizard guide you through the update process.
Step 3Update complete
- Once the update is complete, you will see the new firmware version.
Step 4Stop the deCONZ add-on
- In the deCONZ add-on, make sure the Start on boot option is disabled.
- Select Stop.
Step 5Remove the deCONZ integration
- Under Settings > Devices & Services, select the deCONZ integration.
- Select the three dots menu and select Delete.
Step 6Add 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 7Configure the new ZHA integration
- Once the ZHA integration has detected ConBee II, select Configure.
Step 8Set up ConBee II as ZHA integration
- Select Submit.
Step 9Choose the serial port
- Choose the serial port and select Submit.
Step 10Choose the network settings for the radio
- Select Keep radio network settings.
- Wait for the settings to be loaded.
Step 12Add the Zigbee coordinator to your area
- Once deCONZ has been recognized as your Zigbee coordinator, add it to your area.
- Select Finish.
Step 13Wait for the devices rejoin the network
- 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 14Open the network settings
- Under Integration entries, select Configure.
Step 15Migrate the network settings
- Under Network Settings, select Migrate radio.
Step 16Reconfigure ZHA
- Select Submit.
Step 17Migrate to a new radio
- Select Migrate to a new radio.
Step 18Start the automatic backup
- Make sure the ConBee firmware is running firmware version 26720700.
- When it is up-to-date, select Submit.
Step 19Unplug your old radio
- If you no longer need the old radio stick, you can now remove it.
- Before selecting Submit, connect SkyConnect, as described in the following step.
Step 20Plug the extension cable into SkyConnect
- Plug the Home Assistant SkyConnect 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 SkyConnect is mapped to the container.
- USB 3.0 ports and USB 3.0 drives can cause interference with 2.4 GHz protocols, including the ones provided by Home Assistant SkyConnect. It is important to use the USB extension cable and to position the Home Assistant SkyConnect away from possible interference sources. This video shows the effect of interference.
Step 21Confirm that SkyConnect is plugged in
- Now that SkyConnect is plugged in, select Submit.
Step 22Select the serial port
- Select the serial port for SkyConnect, then select Submit.
Step 23Start the backup restore process
- Select Restore an automatic backup.
Step 24Select the backup
- Choose the latest backup and select Submit.
Step 25Overwrite radio IEEE address
- Select the Permanently replace the radio IEEE address and select Submit.
- 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 on-wards 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.
- Overwriting the IEEE address may take a while. Wait.
Step 27Check the SkyConnect ZHA integration
- SkyConnect is now setup in the ZHA integration.
- To check whether the migration was successful, select the integration.
Step 28Check the radio type
- Under Network Settings, check the Radio type. It should say ezsp.
Step 29Start renaming ZHA integration
- To avoid confusion, rename the ZHA integration.
Step 30Change the name to SkyConnect
- Change the ZHA integration name to SkyConnect and select OK.
Step 31Reconfigure automations and dashboards
- All migrated devices have new entity IDs. This means you will need to manually reconfigure automations and dashboard cards.
- The names that you manually assigned to your devices won't have been migrated. You will have to rename the devices again.