home-assistant.io/source/_components/plant.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Plant monitor	Instructions on how to setup plant monitoring with Home Assistant.	2016-05-7 23:00	true	false	true	true	home-assistant.png	Other	0.44

Thisplantcomponent 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:

# Example configuration.yaml entry
plant:
  name_of_your_plant:
    sensors:
      moisture: sensor.my_sensor_moisture
      battery: sensor.my_sensor_battery
      temperature: sensor.my_sensor_temperature
      conductivity: sensor.my_sensor_conductivity
      brightness: sensor.my_sensor_brightness
    min_moisture: 20

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. Measured in %. Can have a min and max value set optionally.
    • battery (Optional): Battery level of the plant sensor. Measured in %. Can only have a min level set optionally.
    • temperature: (Optional): Temperature of the plant. Measured in degrees Celsius. Can have a min and max value set optionally.
    • conductivity: (Optional): Conductivity of the plant. Measured in µS/cm. Can have a min and max value set optionally.
    • brightness: (Optional): Light exposure of the plant. Measured in Lux. Can have a min and max value set optionally.
  • min_moisture (Optional): Minimum moisture level before triggering a problem. Typical value: 20
  • max_moisture (Optional): Maximum moisture level before triggering a problem. Typical value: 60
  • min_battery (Optional): Minimum battery level before triggering a problem. Typical value: 20
  • min_conductivity (Optional): Minimum conductivity level before triggering a problem. Typical value: 500
  • max_conductivity (Optional): Maximum conductivity level before triggering a problem. Typical value: 3000
  • 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. In contrast to the other values, this check is not looking at the current situation, but rather at the last days. A problem is only reported if the maximum brightness over the last days was lower than min_brightness. You can use this to check if the plant gets enough light during the course of the day.
  • max_brightness (Optional): Maximum brightness before triggering a problem.
  • check_days (Optional): time interval (in days) used when checking min_brightness, if not set, the default value is 3

{% linkable_title Examples %}

Using plain MQTT sensor to get the data

This is a practical 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 component.

If the sensor data is within the min/max values the status will be ok, if not the status will be problem. You can use this to trigger a notification, if there is a problem with your plant. Of course you can only monitor attributes of your plant, where the sensor is configured and is providing the data.

Data Source

The main sources of the data will usually be a MiFlora sensor or a MQTT sensor receiving the data from a PlantGateway.

If you want to get the date via a PlantGateway, this is a typical configuration for the MQTT sensors:

{% raw %}

# 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: my_plant_moisture
    state_topic: my_plant_topic
    value_template: '{{ value_json.moisture }}'
  - platform: mqtt
    name: my_plant_battery
    state_topic: my_plant_topic
    value_template: '{{ value_json.battery }}'
  - platform: mqtt
    name: my_plant_temperature
    state_topic: my_plant_topic
    value_template: '{{ value_json.temperature }}'
  - platform: mqtt
    name: my_plant_conductivity
    state_topic: my_plant_topic
    value_template: '{{ value_json.conductivity }}'
  - platform: mqtt
    name: my_plant_brightness
    state_topic: my_plant_topic
    value_template: '{{ value_json.brightness }}'

{% endraw %}

You have to replace the state_topic with the value that you configured in the PlantGateway. It also depends on the global configuration of your MQTT server.