From 639c78baf10c83c51aff2383f8f34ddf7ac893b6 Mon Sep 17 00:00:00 2001 From: Fredrik Lindqvist Date: Sun, 7 May 2017 22:54:10 +0200 Subject: [PATCH] [WIP]Update plant.markdown (#2593) * Update plant.markdown Add further information to the plant sensor. * Update plant.markdown * Update plant.markdown --- source/_components/plant.markdown | 47 +++++++++++++++++++++++++++++-- 1 file changed, 45 insertions(+), 2 deletions(-) diff --git a/source/_components/plant.markdown b/source/_components/plant.markdown index e78f946c382..f6c509acb36 100644 --- a/source/_components/plant.markdown +++ b/source/_components/plant.markdown @@ -11,9 +11,14 @@ ha_category: Other ha_release: 0.44 --- +This`plant`component lets you merge moisture, conductivity, light intensity, temperature and battery level for a plant into a single UI element. It also supports setting minimum and maximum values for each measurement and will change its state to "problem" if it is not within those limits. + +To use your `plant` sensor in your installation, add the following to your `configuration.yaml` file: + ```yaml +# Example configuration.yaml entry plant: - simulated_plant: + sunflower: sensors: moisture: sensor.mqtt_plant_moisture battery: sensor.mqtt_plant_battery @@ -27,9 +32,47 @@ plant: min_temperature: 15 ``` -## Using plain MQTT sensor to get the data +Configuration variables: + +- **entity_id** (*Required*): Set by you and is used by the component as the `entity_id`. + - **sensors** (*Required*): + - **moisture** (*Optional*): Moisture of the plant. Meassured in %. Can have a min and max value set optionally. + - **battery** (*Optional*): Battery level of the plant sensor. Meassured in %. Can only have a min level set optionally. + - **temperature:** (*Optional*): Temperaure of the plant. Meassured in degrees Celcius. Can have a min and max value set optionally. + - **conductivity:** (*Optional*): Conductivity of the plant. Meassured in µS/cm. Can have a min and max value set optionally. + - **brightness:** (*Optional*): Light exposure of the plant. Meassured in Lux. Can have a min and max value set optionally. + - **min_moisture** (*Optional*): Minimum moisture level before triggering a problem. + - **max_moisture** (*Optional*): Maximum moisture level before triggering a problem. + - **min_battery** (*Optional*): Minimum battery level before triggering a problem. + - **min_conductivity** (*Optional*): Minimum conductivity level before triggering a problem. + - **max_conductivity** (*Optional*): Maximum conductivity level before triggering a problem. + - **min_temperature** (*Optional*): Minimum temperature before triggering a problem. + - **max_temperature** (*Optional*): Maximum temperature before triggering a problem. + - **min_brightness** (*Optional*): Minimum brightness before triggering a problem. + - **max_brightness** (*Optional*): Maximum brightness before triggering a problem. + +## {% linkable_title Examples %} +### Using plain MQTT sensor to get the data +This is a practial example that uses a multiple of `MQTT sensors` to supply the readings used by the `plant` sensor. +Another good source of this data would be the [Mi Flora](https://home-assistant.io/components/sensor.miflora/) component. + ```yaml +# Example configuration.yaml entry +plant: + simulated_plant: + sensors: + moisture: sensor.mqtt_plant_moisture + battery: sensor.mqtt_plant_battery + temperature: sensor.mqtt_plant_temperature + conductivity: sensor.mqtt_plant_conductivity + brightness: sensor.mqtt_plant_brightness + min_moisture: 20 + max_moisture: 60 + min_battery: 17 + min_conductivity: 500 + min_temperature: 15 + sensor: - platform: mqtt name: mqtt_plant_moisture