From 1058e3ddaaad675ef2d738c58053da6015871815 Mon Sep 17 00:00:00 2001
From: Klaas Schoute <klaas_schoute@hotmail.com>
Date: Sat, 17 Nov 2018 10:20:51 +0100
Subject: [PATCH] Update eddystone_temperature sensor component configuration
 (#7556)

---
 .../sensor.eddystone_temperature.markdown     | 41 +++++++++++++++----
 1 file changed, 32 insertions(+), 9 deletions(-)

diff --git a/source/_components/sensor.eddystone_temperature.markdown b/source/_components/sensor.eddystone_temperature.markdown
index 4d5aacbbc25..68fd13503c7 100644
--- a/source/_components/sensor.eddystone_temperature.markdown
+++ b/source/_components/sensor.eddystone_temperature.markdown
@@ -16,12 +16,12 @@ ha_iot_class: "Local Polling"
 The `eddystone_temperature` sensor platform reads temperature information from Bluetooth LE advertisements transmitted by [Eddystone](https://en.wikipedia.org/wiki/Eddystone_(Google)) beacons. Your beacons must be configured to transmit UID frames (for identification) and TLM frames (for temperature).
 All beacons that support the Eddystone protocol, have a temperature sensor and can transmit TLM frames are compatible with this platform. For example [Gimbal](https://store.gimbal.com/collections/beacons/), [Estimote](http://estimote.com/) or [kontakt.io](https://kontakt.io/). For more manufacturers see [this overview](https://developers.google.com/beacons/eddystone#beacon_manufacturers) by Google.
 
-## Requirements
+## {% linkable_title Requirements %}
 
 As this platform uses `bluez` to scan for Bluetooth LE devices **a Linux OS with bluez installed** is required. In addition to that, the `libbluetooth` headers need to be installed:
 
 ```bash
-$ sudo apt-get install libbluetooth-dev 
+$ sudo apt-get install libbluetooth-dev
 ```
 
 Scanning for Bluetooth LE devices also requires special permissions. To grant these to the python executable execute the following:
@@ -46,10 +46,33 @@ sensor:
         namespace: "112233445566778899AA"
         instance: "000000000002"
 ```
-Configuration variables:
-- **bt_device_id** (*Optional*): The id of the Bluetooth device that should be used for scanning (hci*X*). You can find the correct one using `hcitool dev` (default: 0). 
-- **beacons** array (*Required*): The beacons that should be monitored.
-  - **[entry]** (*Required*): Name of the beacon.
-    - **namespace** (*Required*): Namespace ID of the beacon in hexadecimal notation. Must be exactly 20 characters (10 bytes) long.
-    - **instance** (*Required*): Instance ID of the beacon in hexadecimal notation. Must be exactly 12 characters (6 bytes) long.
-    - **name** (*Optional*): Friendly name of the beacon.
+
+{% configuration %}
+bt_device_id:
+  description: The id of the Bluetooth device that should be used for scanning (hci*X*). You can find the correct one using `hcitool dev`.
+  required: false
+  default: 0
+  type: integer
+beacons:
+  description: The beacons that should be monitored.
+  required: true
+  type: list
+  keys:
+    entry:
+      description: Name of the beacon.
+      required: true
+      type: list
+      keys:
+        namespace:
+          description: Namespace ID of the beacon in hexadecimal notation. Must be exactly 20 characters (10 bytes) long.
+          required: true
+          type: string
+        instance:
+          description: Instance ID of the beacon in hexadecimal notation. Must be exactly 12 characters (6 bytes) long.
+          required: true
+          type: string
+        name:
+          description: Friendly name of the beacon.
+          required: false
+          type: string
+{% endconfiguration %}