Setting up Zigbee/Thread Multi-protocol on Home Assistant

Nico Writing by Nico
  8 min of reading

This page has been visited ... times

Setting up Zigbee/Thread Multi-protocol on Home Assistant

After a tutorial on installing the Thread/Matter protocol on Home Assistant, let’s continue now and tackle a sensitive subject, the thread/zigbee multi-protocol on the same key. Why sensitive, this integration is still in the development phase and not recommended by the Nabu Casa team.

They still recommend installing only one protocol per key, which is a shame because as a reminder, Zigbee and Thread both use the same frequency, i.e. 802.15.4Mhz.

Nabu Casa Home Assistant key compatible with Zigbee or Thread

Zigbee Key and Thread ZBT 1 Skyconnect

By Nabucasa

Nabu Casa Home Assistant key compatible with Zigbee or Thread

To understand the multi-protocol mode here are three Home Assistant links that will provide you with a maximum of explanation

Home Assistant and the Thread Protocol

Multiprotocol mode Home Assistant Silicon Labs Multipan

Explanation firmware ezsp home assistant

1st step Backup and Deletion

First of all, especially if you are starting from an existing installation, remember to make backups as a reminder the Silabs multi-protocol module is in Experimental phase in short I warned you 😁. Remember to delete the integrated ZHA modules as well as the associated coordinator. Remember to delete the Thread and Openthread border router if you use it.

2nd preparation of the Zigbee key

It is imperative that the Zigbee key has a Zigbee firmware installed. If this is not the case and if you are using the Skyconnect/ZBT-1 Zigbee key it is quite simple. go to settings > system > hardware > Home assistant skyconnect > configure

You can also use the online application provided by home assistant

If you have another Sonoff type key, go to the darkxst page which also uses the online firmware modification application

In short, the key must be configured in Zigbee

3rd step installation

Nothing could be simpler download and install the official Silabs multi-protocol module by clicking on the link below

Download the Silabs multi-protocol application by home Assistant

Installation of the multi-protocol thread zigbee module by silabs

Then before starting the application you have to configure it, nothing too complicated:

  • Select the key that will be configured
  • set the baudrate to 460800
  • and finish by saving
  • start the application
Configuration of multi-protocol thread zigbee module by silabs

At this stage the module will send the appropriate multi-protocol firmware, it is not the latest available but the one that has been tested by the HA team, i.e. 4.3.1, to finish it will configure the Openthread server.

By consulting the log you will be able to verify the installation that went well, with a message in red with encryption disabled, but which does not pose a problem for operation however the encryption of the border router Thread will be non-functional.

Multi-protocol installation log

Here is the installation complete

If you do not have a Matter server available and yes as a reminder thread works with Matter, there is no need to mess around installing the server, it will be done automatically when discovering the first module.

4th step adding devices

Adding the Thread device

Now go to Settings > Devices and service and add the Thread discovery

discovery thread

Once the device is added you will now go back to it and click on configure

verify configuration thread

We will display the configuration in order to know on which channel the thread network is configured, press the i in my case it is the channel 20 configured by default.

information border router thread

Tricky process of multi-protocol is the fact that you can’t manually change the thread and zigbee channel, the choice is made automatically

automatic thread and zigbee channel selection.
Tado° X thermostatic faucet, probably the most advanced faucet on the market, matter over thread compatible

Tado°

By Tado°

Tado° X thermostatic faucet, probably the most advanced faucet on the market, matter over thread compatible

Adding the Zigbee device

Now we will have to add the Zigbee coordinator via the Zigpy ZHA library. Nothing complicated, go to Settings > Devices and services > Add an integration and choose Zigbee home automation

add zigbee coordinator

Select the dongle, note that it is socket://core-silabs-multiprotocol:9999

choosing zigbee socket for silabs multi-protocol installation

To finish select create a new network or delete an existing network

create new network for silabs multi-protocol installation

As for Thread we will check the network information to see if the automatic installation has chosen the same channel as the Thread network. Go directly to the link below.

Zigbee ZHA network configuration

create new network for silabs multi-protocol installation

In my case the two channels are identical Jackpot!

If this is not the case do not panic, click on migrate radio and select reconfigure current radio then it should be good

reconfigure a new network for the silabs multi-protocol installation
Nabu Casa Home Assistant key compatible with Zigbee or Thread

Zigbee Key and Thread ZBT 1 Skyconnect

By Nabucasa

Nabu Casa Home Assistant key compatible with Zigbee or Thread

To finish Let’s add Matter

When discovering a Matter module on the network or when creating an Openthread network the device will automatically come up in the device discovery

discovery Matter device

As a reminder if you have not yet installed Matter servers, no problem when discovering the first Matter device, you just need to leave the box checked: use the official Matter server add-on in the supervisor

create new network on first add matter

Checking the whole

Here is a screenshot of the whole installed system, you will be able to see that I installed a product in Zigbee ZHA, it is a Lidl bulb as well as a module in Matter it is the very good Tado-X thermostatic faucet compatible with Thread.

full installation overview
Tado° X thermostatic faucet, probably the most advanced faucet on the market, matter over thread compatible

Tado°

By Tado°

Tado° X thermostatic faucet, probably the most advanced faucet on the market, matter over thread compatible

Below is the integration of the Tado-X thermostatic faucet in multi-protocol in Home Assistant

integration of tado-x thermostatic faucet in home assistant in multi-protocol

Below is the integration of the Lidl Zigbee bulb in multi-protocol in Home Assistant

integration of tado-x thermostatic faucet in home assistant in multi-protocol

Key step summary

  1. With a silabs chip Zigbee key with a Zigbee firmware installed.
  2. Be sure to have completely removed ZHA, Thread and Openthread integration from devices on Home Assistant.
  3. Install the Official Silabs Multi-protocol module.
  4. Select the zigbee key in the settings and save.
  5. Start the module launch.
  6. Go to settings > Devices and services and add Thread in discovery.
  7. Always check in Devices and services the Openthread entry configured.
  8. Go to the Thread entry and press configure.
  9. Check the existence of the ha-thread-xxxx border router and press i to check the info Channel in my case 20.
  10. Then Add the device Zigbee Home Automation
  11. Select the entry: socket://core-silabs-multiprotocol:9999
  12. Select Clear network settings and create a new network
  13. Go to Zigbee devices and click on configure
  14. Check the Channel it must be the same as Threasd for me, channel 20
  15. If different click on migrate radio and reconfigure current radio

Multi-protocle and Zigbee2mqtt library

The latest version of the silabs multi-protocol module and the version 2 of Zigbee2mqtt do not allow to work together.

There is no point in trying to configure

port: socket://core-silabs-multiprotocol:9999 ou port: tcp://core-silabs-multiprotocol:9999
adapter: ember ou ezsp

Unfortunately the Zigbee2mqtt library is non-functional in Multi-Protocol mode

Error installing multiprotocol zigbee and thread for zigbee2mqtt in home assistant

Conclusion

If you follow the installation process well you will have managed to make it work on a single key in this case the Skyconnect in multi-protocol Silabs Zigbee/Thread/Matter mode, without too much difficulty and you will be able to run a panel of Thread and Zigbee modules. However, this is an experimental mode, it should be used with caution, and everything is not perfect yet.

Nabu Casa Home Assistant key compatible with Zigbee or Thread

Zigbee Key and Thread ZBT 1 Skyconnect

By Nabucasa

Nabu Casa Home Assistant key compatible with Zigbee or Thread

Nico

Nico

Founding member of the Haade site, a home automation enthusiast with all the tricks that go well.

Comments