zigpy-znp icon indicating copy to clipboard operation
zigpy-znp copied to clipboard

Published 20 hours ago • verified publisher icon zigpy

Readme Troubleshooting

Open dumpfheimer opened this issue 3 years ago • 3 comments

As discussed in https://github.com/zigpy/zigpy-znp/issues/76 I was able to greatly improve network stability by creating a network backup and restoring it. I have added a short troubleshooting section to the readme mentioning this and referring to zigbee2mqtt troubleshooting.

dumpfheimer avatar Jul 22 '21 14:07 dumpfheimer

Oh no looks like I messed up the branch.

dumpfheimer avatar Jul 22 '21 14:07 dumpfheimer

FYI, submitted some Zigbee pairing tips to Home Assistant ZHA troubleshooting docs -> https://github.com/home-assistant/home-assistant.io/pull/17466

Those are now available here -> https://www.home-assistant.io/integrations/zha#best-practices-for-avoiding-pairing-difficulties

Best practices for avoiding pairing difficulties

  • If possible try to pair your Zigbee devices in their intended final location, (and not pair it next to the Zigbee coordinator and then need to move it after).
    • Pairing a Zigbee device next to the Zigbee coordinator and then moving it later can result in dropped/lost connections or other issues.
      • If the device you want to add is not brand new and as such never paired before then you always have to make sure to first manually reset the device to its factory default settings before you will be able to add/pair it.
  • Some battery-operated Zigbee devices are known to have problems with pairing if they have Low battery voltage.
    • Some people have reported replacing the battery on their newly received Xiaomi/Aqara devices solved pairing issues.
  • Check that you have enough Zigbee router devices (also known as Zigbee signal repeaters or range extenders) and if you do not have any, invest and add some mains-powered devices that will work as Zigbee routers.
    • Aim to start out with mains-powered devices before adding battery-operated devices as a "weak" Zigbee network mesh (e.g., the device is too far from the Zigbee coordinator or a Zigbee router) may prevent some devices from being paired. Zigbee router devices are also needed to increase the maximum of devices that can be connected to your Zigbee mesh network.
    • Note that some Zigbee devices are not fully compatible with all brands of Zigbee router devices. Xiaomi/Aqara devices are for example known not to work with Zigbee router devices from Centralite, General Electrics, Iris, Ledvance/OSRAM/ LIGHTIFY/Sylvania, Orvibo, PEQ, Securifi, and SmartThings/Samsung. Better results can usually be achieved by using mains-powered devices IKEA and Nue/3A Home or dedicated DIY routing devices based on Texas Instruments CC253x/CC26x2 and XBee Series 2/3 Zigbee radios.
  • Be patient as the pairing of some Zigbee devices may require multiple attempts and you may sometimes need to try again and again.
    • Some devices, like example those from Xiaomi/Aqara, are known to not be 100% compliant with the standard Zigbee specifications and may therefore require many paring attempts over 10-20 minutes or longer.

Hedda avatar Sep 10 '21 10:09 Hedda

FYI, further troubleshooting tips to improve stability in this PR for ZHA docs-> https://github.com/home-assistant/home-assistant.io/pull/18864

General tips on improving Zigbee network range is also posted in zigpy wiki -> https://github.com/zigpy/zigpy/wiki/General-tips-on-improving-Zigbee-network-range

Hedda avatar Dec 06 '21 09:12 Hedda