From 88bf2a0a49a1a2c3813775c1a07b0ee7669ff5ae Mon Sep 17 00:00:00 2001
From: Anton Sarukhanov <code@ant.sr>
Date: Wed, 7 Nov 2018 03:44:58 -0500
Subject: [PATCH] Update Avi-On doc to clarify multiple-device usage (#7073)

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

* Fix typo
---
 source/_components/light.avion.markdown | 26 ++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/source/_components/light.avion.markdown b/source/_components/light.avion.markdown
index 7290fcedb01..6abf6e2fd61 100644
--- a/source/_components/light.avion.markdown
+++ b/source/_components/light.avion.markdown
@@ -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
 ```