ZigBeeForDomoticZ plugin Wiki

Change the Zigbee channel

Introduction

A Zigbee network uses one channel of the 2.4 GHz band, from 11 to 26. Choose a channel away from your Wi-Fi: see Zigbee and Wi-Fi, and measure the radio activity with Network > Interference level or a real-time interference scan.

When a zigpy coordinator (Texas Instruments, Silicon Labs, ConBee/RaspBee…) forms a new network with the channel setting left to default, it runs an energy scan and picks the quietest of the channels 11, 15, 20 and 25.

Some devices were reported to need a specific channel (findings from the ZiGate era):

There are two ways to change the channel.

The coordinator moves to the new channel and broadcasts the change to the whole network. The paired devices are kept. From plugin 9.1.009:

  1. Go to Admin > Coordinator and look at Change channel: the bars show the energy the routers measured on each channel at the last energy scan, lower is quieter. Without a scan yet, run one from Network > Interference level.
  2. Click the number of the new channel, then Move to channel N, and confirm.

Change the Zigbee channel

Before plugin 9.1.009:

  1. Go to Admin > Coordinator (see WebUI Admin).
  2. In the Coordinator change channel panel, select the new channel.
  3. Click Change channel.

The routers (mains-powered devices) receive the broadcast and follow. End devices (battery devices) sleep and miss it:

Wait a while, then check in Management > Devices which devices don’t report any more.

Method 2: form a new network on the chosen channel

The channel setting (WebUI Settings, Coordinator settings, in the Handle with care card from plugin 9.1.010, advanced before) is only applied when the coordinator forms a new network. Forming a new network erases it: all the devices must be paired again. Use this method only when you start a network from scratch.

  1. Set channel to the channel you want and click Save, and from plugin 9.1.010 confirm with Save anyway (Validate before plugin 9.1.009).

    Channel setting

  2. Turn the autoRestore setting off (Zigpy CIE specific configuration, advanced): otherwise the plugin restores the last coordinator backup, on the old channel, instead of forming a new network.
  3. Form a new network: in Domoticz, Setup > Hardware, set Initialize Coordinator to True on the plugin hardware and click Update (see Plugin settings). The plugin sets it back to False and restarts by itself once the network is formed.
  4. Pair the devices again, then turn autoRestore back on.

With a ZiGate, the channel setting is applied with a coordinator restart (Admin > Coordinator, Soft reset) instead.

Check the channel

The Channel card at the top of the Admin page, and the Coordinator card of Admin > Coordinator, give the current channel. You can also look at Tools > Data, Coordinator information (Tools > Tools, Coordinator info, before plugin 9.1.009): the Channel field. See Use the plugin tools.