From ed2fc13d6feeca1ccbc7234480758b8cf77749f3 Mon Sep 17 00:00:00 2001 From: Hedda Date: Mon, 22 Jun 2020 15:29:36 +0200 Subject: [PATCH] Update zha.markdown with configuration for OTA firmware update in ZHA (#13621) Co-authored-by: Franck Nijhof --- source/_integrations/zha.markdown | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index dac7ff28553..da3390c27c5 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -140,6 +140,25 @@ enable_quirks: To add new devices to the network, call the `permit` service on the `zha` domain. Do this by clicking the Service icon in Developer tools and typing `zha.permit` in the **Service** dropdown box. Next, follow the device instructions for adding, scanning or factory reset. +### OTA firmware updates + +ZHA component does have the ability to automatically download and perform OTA (Over-The-Air) firmware updates of Zigbee devices if the OTA firmware provider source URL for updates is available. OTA firmware updating is set to disabled (`false`) in the configuration by default. + +Currently, OTA providers for firmware updates are only available for IKEA and LEDVANCE devices. OTA updates for device of other manufactures could possible also be supported by ZHA dependencies in the future, if these manufacturers publish their firmware publicly. + +To enable OTA firmware updates for the ZHA integration you need to add the following configuration to your `configuration.yaml` and restart Home Assistant: + +```yaml +ota: + ikea_provider: true. # Auto update Trådfri devices + ledvance_provider: true # Auto update LEDVANCE devices + #otau_directory: /path/to/your/ota/folder # Utilize .ota files to update everything else +``` + +You can choose if the IKEA or LEDVANCE provider should be set to enabled (`true`) or disabled (`false`) individually. After the OTA firmware upgrades are finished, you can set these to `false` again if you do not want ZHA to automatically download and perform OTA firmware upgrades in the future. + +Note that the `otau_directory` setting is optional and can be used for any firmware files you have downloaded yourself. + ## Adding devices Go to the **Configuration** page and select the **ZHA** integration that was added by the configuration steps above.