From a953db09d10dc383ac13706cc2866493f3aa22a5 Mon Sep 17 00:00:00 2001
From: Daniel Matuschek <daniel@matuschek.net>
Date: Mon, 19 Sep 2016 14:07:38 +0200
Subject: [PATCH] Added documentation for MiFlora sensor

---
 source/_components/sensor.miflora.markdown | 43 ++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 source/_components/sensor.miflora.markdown

diff --git a/source/_components/sensor.miflora.markdown b/source/_components/sensor.miflora.markdown
new file mode 100644
index 000000000000..ca8c48e69bef
--- /dev/null
+++ b/source/_components/sensor.miflora.markdown
@@ -0,0 +1,43 @@
+---
+layout: page
+title: "Mi Flora plant sensor"
+description: "Instructions on how to integrate MiFlora BLE plant sensor with Home Assistant."
+date: 2016-09-19 12:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: DIY
+ha_release: 0.29
+---
+
+The Mi Flora plant sensor is a small Bluetooth Low Energy device that monitors not only the moisture, but also light, temperature and
+conductivity. 
+As only a single BLE device can be polled at the same time, the library implements locking to make sure this is the case.
+
+To use your PM sensor in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+sensor
+  platform: miflora
+  mac: xx:xx:xx:xx:xx:xx
+  name: Flower 1
+  force_update: false
+  median: 3
+  monitored_conditions:
+   - moisture
+   - light
+   - temperature
+   - conductivity
+```
+
+- **mac** (*Required*): The MAC address of your sensor. You can find this be running "hcitool lescan" from command line.
+- **name** (*Optional*): The name displayed in the frontend.
+- **force_update** (*Optional*): Sends update events even if the value hasn't changed.
+- **median** (*Optional*): Sometimes the sensor measurements show spikes. Using this parameter, the poller will report the median of the last 
+  3 (you can also use larger values) measurements. This filters out single spikes. Median: 5 will also filter double spikes.
+  If you never have problems with spikes, median=1 will work fine. 
+- **monitored_conditions** (*Required*): The paramaters that should be monitored.
+
+Note that by default the sensor is only polled once every 15 minutes. This means with the median=3 setting, it will take as least 30 minutes before the sensor will report a value after a Home Assistant restart. As the values usually change very slowly, this isn't a big problem. 
+Reducing polling intervals will have a negative effect on the battery life.