Description for the new pilight sensor component (#1212)

DavidLP · fabaff · commit 076b2fbde1e2 · 2016-10-18T23:22:31.000+02:00
* Description for the new pilight sensor component

* Changes after review
diff --git a/source/_components/sensor.pilight.markdown b/source/_components/sensor.pilight.markdown
@@ -0,0 +1,63 @@
+---
+layout: page
+title: "Pilight Sensor"
+description: "Instructions how to integrate pilight sensors within Home Assistant."
+date: 2016-10-08 23:21
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: pilight.png
+ha_category: Sensor
+ha_release: 0.31
+ha_iot_class: depends
+---
+
+
+This `pilight` sensor platform for 433 MHz devices uses a value in the message payload as the sensor value. Unique identifiers (e.g. _uuid_) can be set to distinguish between multile pilight devices. To use a pilight sensor the pilight home assistant hub has to be set up.
+
+To use your sensor via pilight, make sure it is [supported](https://wiki.pilight.org/doku.php/protocols)	 and add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yml entry
+sensor:
+  - platform: pilight
+    variable: temperature
+    payload:
+      uuid: '0000-b8-27-eb-f447d3'
+```
+
+Configuration variables:
+
+- **variable** (*Required*): The variable name in the data stream that defines the sensor value.
+- **payload** (*Required*): Message payload identifiers. Only if all identifiers are matched the sensor value is set.
+- **name** (*Optional*): Name of the sensor.
+- **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any.
+
+## {% linkable_title Example: Weather station %}
+
+This section shows a real life example how to use values of a weather station.
+
+
+```yaml
+# Example configuration.yml entry
+sensor:
+  - platform: pilight
+    name: 'Temperature'
+    variable: 'temperature'
+    payload:
+      uuid: 0000-b8-27-eb-f1f72e
+    unit_of_measurement: '°C'
+  - platform: pilight
+    name: 'Humidity'
+    variable: 'humidity'
+    payload:
+      uuid: 0000-b8-27-eb-f1f72e
+    unit_of_measurement: '%'
+  - platform: pilight
+    name: 'Battery'
+    variable: 'battery'
+    payload:
+      uuid: 0000-b8-27-eb-f1f72e
+    unit_of_measurement: '%'
+```
