Update ZHA documentation for OTA providers (#34137)

The OTA provider configuration format has changed in zigpy and there are deprecation warnings in logs for users that currently use them.

I've removed example OTA YAML from ZHA's documentation and have created a separate page in zigpy's documentation that outlines it in depth.
This commit is contained in:
puddly 2024-10-25 19:02:42 -04:00 committed by GitHub
parent b5ea9daf3a
commit 3adc012aba
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -255,23 +255,9 @@ custom_quirks_path:
### Advanced OTA configuration
The default configuration for OTA firmware updates is chosen by ZHA developers, so normal users should not need to change any configuration. Most of the config options listed in the zigpy section are just meant for development or advanced users.
OTA for a few manufacturers is enabled by default, currently Ledvance, Sonoff, Inovelli, and ThirdReality. Other manufacturers are supported but disabled by default because their updates may change or remove device functionality, may require you to reconfigure devices, or are contributed by the community and may be minimally tested.
Further advanced configuration options are only provided in the [zigpy project's developers documentation](https://github.com/zigpy/zigpy).
However, if you want to disable OTA updates for a specific manufacturer, you can add the following lines to your `configuration.yaml` and restart Home Assistant.
```yaml
zha:
zigpy_config:
ota:
ikea_provider: false # Disable OTA update downloads for Trådfri devices
inovelli_provider: false # Disable OTA update downloads for INOVELLI devices
ledvance_provider: false # Disable OTA update downloads for LEDVANCE/OSRAM devices
salus_provider: false # Disable OTA update downloads for SALUS/Computime devices
sonoff_provider: false # Disable OTA update downloads for Sonoff (ITead) devices
thirdreality_provider: false # Disable OTA update downloads for 3REALITY devices
```
Refer to the [zigpy documentation for OTA configuration](https://github.com/zigpy/zigpy/wiki/OTA-Configuration) for more information on additional OTA providers.
### Defining Zigbee channel to use