Update Avi-On doc to clarify multiple-device usage (#7073)

* Update Avi-On doc to clarify multiple-device usage.

* Fix typo
This commit is contained in:
Anton Sarukhanov 2018-11-07 03:44:58 -05:00 committed by Fabian Affolter
parent 0f15043966
commit 88bf2a0a49

View File

@ -37,6 +37,8 @@ light:
- platform: avion
```
There are two ways to configure this component: username & password, or list of devices. You must choose one.
{% configuration %}
username:
description: The username used in the Avion app. If username and password are both provided, all associated switches will automatically be added to your configuration.
@ -59,6 +61,10 @@ devices:
description: The API Key.
required: true
type: string
id:
description: The ID of the dimmer switch. Only needed for independent control of multiple devices.
required: true
type: string
{% endconfiguration %}
## {% linkable_title Full example %}
@ -73,7 +79,21 @@ light:
00:21:4D:00:00:01:
name: Light 1
api_key: YOUR_API_KEY
00:21:3D:20:00:a1:
name: Light 2
api_key: YOUR_API_KEY
```
For independent control of multiple devices, you must specify each device's ID (integer starting with 1). Each switch's ID can be guessed or detected from the Avi-On API.
```yaml
# Manual device configuration.yaml entry
light:
- platform: avion
devices:
00:21:4D:00:00:01:
name: Light 1
api_key: YOUR_API_KEY
id: 1
00:21:4D:00:00:02:
name: Light 1
api_key: YOUR_API_KEY
id: 2
```