FAQ ans Lifehacks¶

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.

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:

• ZigBee and Wi-Fi Coexistence;
• Choosing a WiFi Channel;
• Why Channels 1, 6, and 11? (video);

mDNS Autodiscovery¶

• if you do not know your UZG-01 adapter's IP address, you can reach web-interface by following to uzg-01.local in your browser.

• if you do not know your UZG-01 adapter's IP address, you can set-up you Zigbee2MQTT autodiscovery by setting these parameters:

  serial:
    port: mdns://uzg-01
  

Type-A to Type-C cables support¶

• In case of USB connection or flashing over USB - please use Type-A (your PC) to Type-C (UZG-01) cables. Flashing and Zigbee bridge does not work with Type-C to Type-C cables.

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

advanced:
  pan_id: GENERATE
  ext_pan_id: [0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08]
  network_key: GENERATE

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://192.168.1.105:6638 », where 192.168.1.105 is IP address of your UZG-01;
   • 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.

Add some functionality¶

UZG-01 & ESPHome firmware¶

You can run ESPHome firmware on your UZG-01 device. Follow this to BTProxy for the latest ESPHome YAML, bin and WebInstaller

• ESPHome Bluetooth Proxy, follow this manual.
• ESPHome Bluetooth Low Energy Tracker Hub.
• ESPHome BLE CLient.

Run UZG-01 as a Zigbee router¶

Simple.

1. Download a router firmware - you have to use _launchpad_router_ tag.
2. Flash it using the manual in section Flashing and Updating;
3. Power the device On. It will start in a pairing mode so add it to your current zigbee network. If you want to re-pair it, go to the web-interface, section System and Tools and press Router reconnect at the System control tab.