Skip to content

Commit 639c78b

Browse files
authored
[WIP]Update plant.markdown (home-assistant#2593)
* Update plant.markdown Add further information to the plant sensor. * Update plant.markdown * Update plant.markdown
1 parent 33051a0 commit 639c78b

File tree

1 file changed

+45
-2
lines changed

1 file changed

+45
-2
lines changed

source/_components/plant.markdown

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,14 @@ ha_category: Other
1111
ha_release: 0.44
1212
---
1313

14+
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.
15+
16+
To use your `plant` sensor in your installation, add the following to your `configuration.yaml` file:
17+
1418
```yaml
19+
# Example configuration.yaml entry
1520
plant:
16-
simulated_plant:
21+
sunflower:
1722
sensors:
1823
moisture: sensor.mqtt_plant_moisture
1924
battery: sensor.mqtt_plant_battery
@@ -27,9 +32,47 @@ plant:
2732
min_temperature: 15
2833
```
2934
30-
## Using plain MQTT sensor to get the data
35+
Configuration variables:
36+
37+
- **entity_id** (*Required*): Set by you and is used by the component as the `entity_id`.
38+
- **sensors** (*Required*):
39+
- **moisture** (*Optional*): Moisture of the plant. Meassured in %. Can have a min and max value set optionally.
40+
- **battery** (*Optional*): Battery level of the plant sensor. Meassured in %. Can only have a min level set optionally.
41+
- **temperature:** (*Optional*): Temperaure of the plant. Meassured in degrees Celcius. Can have a min and max value set optionally.
42+
- **conductivity:** (*Optional*): Conductivity of the plant. Meassured in µS/cm. Can have a min and max value set optionally.
43+
- **brightness:** (*Optional*): Light exposure of the plant. Meassured in Lux. Can have a min and max value set optionally.
44+
- **min_moisture** (*Optional*): Minimum moisture level before triggering a problem.
45+
- **max_moisture** (*Optional*): Maximum moisture level before triggering a problem.
46+
- **min_battery** (*Optional*): Minimum battery level before triggering a problem.
47+
- **min_conductivity** (*Optional*): Minimum conductivity level before triggering a problem.
48+
- **max_conductivity** (*Optional*): Maximum conductivity level before triggering a problem.
49+
- **min_temperature** (*Optional*): Minimum temperature before triggering a problem.
50+
- **max_temperature** (*Optional*): Maximum temperature before triggering a problem.
51+
- **min_brightness** (*Optional*): Minimum brightness before triggering a problem.
52+
- **max_brightness** (*Optional*): Maximum brightness before triggering a problem.
53+
54+
## {% linkable_title Examples %}
55+
### Using plain MQTT sensor to get the data
56+
This is a practial example that uses a multiple of `MQTT sensors` to supply the readings used by the `plant` sensor.
57+
Another good source of this data would be the [Mi Flora](https://home-assistant.io/components/sensor.miflora/) component.
58+
3159

3260
```yaml
61+
# Example configuration.yaml entry
62+
plant:
63+
simulated_plant:
64+
sensors:
65+
moisture: sensor.mqtt_plant_moisture
66+
battery: sensor.mqtt_plant_battery
67+
temperature: sensor.mqtt_plant_temperature
68+
conductivity: sensor.mqtt_plant_conductivity
69+
brightness: sensor.mqtt_plant_brightness
70+
min_moisture: 20
71+
max_moisture: 60
72+
min_battery: 17
73+
min_conductivity: 500
74+
min_temperature: 15
75+
3376
sensor:
3477
- platform: mqtt
3578
name: mqtt_plant_moisture

0 commit comments

Comments
 (0)