Skip to content


Good to know

Best channel for a Zigbee network

According to this article by Metageek the best is to use channel 15 for Zigbee and channels 1,6 and 11 for your home WiFi networks.

Wifi and Zigbee Channels

The rule - make the networks as less overlaps as possible.
Have a look on other interesting topics at those web-resource, some of them are listed below:

mDNS Autodiscovery

  • if you do not know your XZG adapter's IP address, you can reach web-interface by following to xzg.local in your browser.
  • if you do not know your XZG adapter's IP address, you can set-up you Zigbee2MQTT autodiscovery by setting these parameters:

      port: mdns://xzg

Common errors

Zigbee2MQTT: Error Network Commissioning Timeout (panID or extendedPanID already exists nearby)

This error is discussed in these two threads: first and second.
According to the first thread, the most possible issue cause this error is: zigbee2mqtt will always use the same, default extendedPanId unless you set it to something else in the config file

  pan_id: GENERATE
  ext_pan_id: [0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08]
  network_key: GENERATE
According to the second thread, the users propose to start without antennas or routers nearby: Try unscrewing the antenna during startup. Or unplug any near by routers temporarily. Try to do above mentioned as well as start ZHA just to test your device:

  1. Go to Home Assistant
  2. Click Settings
  3. Go to Devices & Services
  4. Click Add integration (right bottom corner)
  5. Find «Zigbee Home Automation», click on it;
  6. Between two options «Add Zigbee device» and «Zigbee Home Automation» choose Zigbee Home Automation;
  7. Select serial port window - Enter manually
  8. Radio type window - ZNP = Texas Instruments Z-Stack ZNP …
  9. Serial port settings window:

    • Serial device path: « socket:// », where is IP address of your XZG;
    • port speed left by default 115200;
    • data flow control undefined (it does not matter for LAN adapters)
  10. Press Submit.

  11. Network formation window - Erase network settings and form a new network
  12. Wait for Zigbee network and try to add some Zigbee end-device (e.g. sensor etc)

If ZHA starts - means that the problem in communication between Zigbee2MQTT and Z-Stack firmware, flashed to the adapter. To solve it - try steps above ZHA part.


More to come