Update zha.markdown with configuration for OTA firmware update in ZHA (#13621)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Hedda 2020-06-22 15:29:36 +02:00 committed by GitHub
parent cbda2589e7
commit ed2fc13d6f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -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.