From 9ebca36b220a7ae6317e2cab7435bf78b15a247a Mon Sep 17 00:00:00 2001 From: Hedda Date: Thu, 21 Nov 2024 15:13:12 +0100 Subject: [PATCH 1/3] ZHA troubleshooting Zigbee OTA upgrading of device firmware Add new sections under troubleshooting about resolving ZHA problems with Zigbee OTA upgrading of device firmware not starting or failing. --- source/_integrations/zha.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index e1d6bddbb3ec..ffed6791115b 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -583,6 +583,14 @@ Since all Zigbee Coordinator radio adapters are very sensitive/susceptible to al - Place your Zigbee Coordinator away from any Wi-Fi access points and all other sources of WiFi. - Wi-Fi frequency ranges can overlap with Zigbee, see the section above on defining Zigbee channel use. +### Problems upgrading Zigbee device firmware via OTA + +Be aware that OTAU (Over-The-Air Upgrade) of Zigbee devices typically takes around 10 minutes. While a device is updating a lot of traffic is generated on the network, therefore it is recommended to not execute multiple updates at the same time. Always check that battery-powered devices have at least 70% of battery-life left before starting a firmware upgrade (a general tip is therefore to simply put new fresh batteries in before upgrading any OTA firmware upgrade), OTA updating of firmware is very power-consuming and while some devices do check for a minimum battery-level before starting the upgrade and might refuse to update unless have enough battery-life left, not all do so. + +If Zigbee firmware upgrades do not start on a battery-powered product then be aware that you usually need to "wake up the device" so that will will be able to receive commands, (because battery-powered products are sleepy devices so they normally only receive commands when the state of the device is changed). If the upgrade still does not start then try restarting the device by disconnecting the power/battery for a few seconds and try again, again make sure to activate the device by pressing a button on it right before sending the update request. Try to push a button on the device (if it has one) shortly before you start the firmware update to wake it up. Sometimes it also helps to try keeping the device awake by pushing a button repeatedly until you see the first "Updating... " message in the user interface. + +Another common reason for Zigbee firmware upgrades not starting or failing is poor reception or not having a stable Zigbee network mesh. Take some basic actions to try to optimize your Zigbee network by avoiding radio frequency interference and adding many Zigbee Router devices (repeaters/extenders) to extend range and coverage. Try to follow all the best practice tips above in the [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization) section under troubleshooting. + ### Zigbee network visualization in ZHA UI The ZHA configuration UI has a tab to visualize device links in your Zigbee network topology. From 0a9861ccc5ff507845095100bc70fe12a630cb23 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 30 Dec 2024 11:00:54 +0100 Subject: [PATCH 2/3] Update source/_integrations/zha.markdown Co-authored-by: Franck Nijhof --- source/_integrations/zha.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index ffed6791115b..38d1a633e6a0 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -589,7 +589,7 @@ Be aware that OTAU (Over-The-Air Upgrade) of Zigbee devices typically takes arou If Zigbee firmware upgrades do not start on a battery-powered product then be aware that you usually need to "wake up the device" so that will will be able to receive commands, (because battery-powered products are sleepy devices so they normally only receive commands when the state of the device is changed). If the upgrade still does not start then try restarting the device by disconnecting the power/battery for a few seconds and try again, again make sure to activate the device by pressing a button on it right before sending the update request. Try to push a button on the device (if it has one) shortly before you start the firmware update to wake it up. Sometimes it also helps to try keeping the device awake by pushing a button repeatedly until you see the first "Updating... " message in the user interface. -Another common reason for Zigbee firmware upgrades not starting or failing is poor reception or not having a stable Zigbee network mesh. Take some basic actions to try to optimize your Zigbee network by avoiding radio frequency interference and adding many Zigbee Router devices (repeaters/extenders) to extend range and coverage. Try to follow all the best practice tips above in the [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization) section under troubleshooting. +Another common reason for Zigbee firmware upgrades not starting or failing is poor reception or not having a stable Zigbee network mesh. Take action to try to optimize your Zigbee network by avoiding radio frequency interference and adding many Zigbee Router devices (repeaters/extenders) to extend range and coverage. Try to follow all the best practice tips above in the [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization) section under troubleshooting. ### Zigbee network visualization in ZHA UI From 2b436da39979606cc7686b7c694c2b0acce13874 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 30 Dec 2024 11:01:26 +0100 Subject: [PATCH 3/3] Update source/_integrations/zha.markdown Co-authored-by: Franck Nijhof --- source/_integrations/zha.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 38d1a633e6a0..f174a4a1f4b1 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -587,7 +587,7 @@ Since all Zigbee Coordinator radio adapters are very sensitive/susceptible to al Be aware that OTAU (Over-The-Air Upgrade) of Zigbee devices typically takes around 10 minutes. While a device is updating a lot of traffic is generated on the network, therefore it is recommended to not execute multiple updates at the same time. Always check that battery-powered devices have at least 70% of battery-life left before starting a firmware upgrade (a general tip is therefore to simply put new fresh batteries in before upgrading any OTA firmware upgrade), OTA updating of firmware is very power-consuming and while some devices do check for a minimum battery-level before starting the upgrade and might refuse to update unless have enough battery-life left, not all do so. -If Zigbee firmware upgrades do not start on a battery-powered product then be aware that you usually need to "wake up the device" so that will will be able to receive commands, (because battery-powered products are sleepy devices so they normally only receive commands when the state of the device is changed). If the upgrade still does not start then try restarting the device by disconnecting the power/battery for a few seconds and try again, again make sure to activate the device by pressing a button on it right before sending the update request. Try to push a button on the device (if it has one) shortly before you start the firmware update to wake it up. Sometimes it also helps to try keeping the device awake by pushing a button repeatedly until you see the first "Updating... " message in the user interface. +If Zigbee firmware upgrades do not start on a battery-powered product, then be aware that you usually need to "wake up the device" so that it will be able to receive commands (because battery-powered products are sleepy devices, so they normally only receive commands when the state of the device is changed). If the upgrade still does not start, then try restarting the device by disconnecting the power/battery for a few seconds and try again; make sure to activate the device by pressing a button on it right before sending the update request. Try to push a button on the device (if it has one) shortly before you start the firmware update to wake it up. Sometimes, it also helps to try keeping the device awake by repeatedly pushing a button until you see the first "Updating... " message in the user interface. Another common reason for Zigbee firmware upgrades not starting or failing is poor reception or not having a stable Zigbee network mesh. Take action to try to optimize your Zigbee network by avoiding radio frequency interference and adding many Zigbee Router devices (repeaters/extenders) to extend range and coverage. Try to follow all the best practice tips above in the [Zigbee interference avoidance and network range/coverage optimization)](#zigbee-interference-avoidance-and-network-rangecoverage-optimization) section under troubleshooting.