thomasloven / hass-plant_helper

🔹 Home Assistant Helper for monitoring plant health using MiFlora devices

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Plant Helper

WARNING: This is considered a beta version - expect significant functional and breaking changes

Helper for monitoring plant health using MiFlora devices

Summary

Go from this To this
default device entities plant status card

Description

Home Assistant normally registers MiFlora plant monitors through Xiaomi BLE as five separate entities.

This integration adds a new Helper which lets you combine those entities into a single binary sensor to indicate you plants health.

If you have installed the Plant Database it will also automatically set the environmental limits for your plant and select a picture for it.

Installation

  • Download the custom_components/plant_helper directory and place in your custom_components directory
  • Or: add this repo (thomasloven/hass-plant_helper) as a custom repository in HACS and install the integration from there.

Plant database

Xiaomi has created an extensive database of suitable conditions for a large variety of plants to use with their Flower Care apps. Unfortunately, those are very limited in functionality - which is why many choose to use Home Assistant for plant monitoring instead.

For copyright reasons, I cannot include the database in this repository, but it's easy to import this "MiFloraDB" yourself.

  • Find and download the file PlantDB_*.csv and place directly in your Home Assistant configuration directory. The * in the name can be anything, but the filename must start with PlantDB and end with .csv.
  • Optional: Download the plant photos and extract to a folder named exactly plant_photos which is placed directly in your Home Assistant configuration directory.

Usage:

  • Make sure you have at least one MiFlora Device set up and working. Going to the device settings you should see something like this:

default device entities

  • Go to "Settings" -> "Devices & Services" -> "Helpers" Open your Home Assistant instance and show your helper entities.

  • Click "Create Helper"

  • Select "Plant" from the list

  • Name your plant, select the MiFlora device, and (optionally) select the special of your plant.

plant helper configuration

  • You should now have a new binary_sensor entity which can be used in automations to e.g. alert you as soon as anything is wrong with your clorophyl babies. When the sensor is off everything is fine. If the sensor is on, the attributes of the sensor will tell you the problem.

  • This integration also patches the Plant Status card such that it accepts the newly created binary_sensor as an entity:

plant status card

Customization

If you have a plant that is not included in the database, or don't have the database installed. You can set max and min limits for any of the monitored conditions manually by going to the options for the new entity and deselecting the Species.

custom settings

About

🔹 Home Assistant Helper for monitoring plant health using MiFlora devices


Languages

Language:Python 97.5%Language:JavaScript 2.5%