Skip to content

Latest commit

 

History

History
186 lines (148 loc) · 10 KB

README.md

File metadata and controls

186 lines (148 loc) · 10 KB
Raw

HaVpdChart for Home Assistant

HaVpdChart Image

HaVpdChart Image

HaVpdChart Image

HaVpdChart Image

HaVpdChart is a custom card component for Home Assistant that allows for visual representations of VPD (Vapour Pressure Deficit) based on temperature and humidity sensors. It's ideal for monitoring environmental conditions in tents or rooms.

Prerequisites

  • Home Assistant installation
  • Basic knowledge of YAML and Home Assistant configuration

Installation

HACS Easy Installation

  1. Currently not available - still wait for accept pull request

HACS Installation

If you have HACS installed, you can add this repository to HACS as a custom repository. Otherwise you can easily install it

sudo docker exec -it [dockername] bash
wget -O - https://get.hacs.xyz | bash -

  1. Add Repository

    Click HACS -> Three Dot Menu upper right -> Custom Repository -> Category: Lovelace | Repositury Url: https://github.com/mentalilll/ha-vpd-chart

  2. Install Plugin

    Search for VPD within Integrations and install ha-vpd-chart

From GitHub

  1. Clone the repository

    Clone the repository to your local machine

  2. Incorporate the file into Home Assistant Docker

    1. Navigate to the directory that is mapped to /config in your Docker setup.
    2. Create 2 new directory's named www/community/ha-vpd-chart/ within /config folder.
    3. Copy the contents of the dist directory from the repository into the <config>/www/community/ha-vpd-chart/ directory.

  3. Add the resource in Home Assistant

    Add the resource through the Home Assistant UI under Configuration -> Lovelace Dashboards -> Resource\

    If you don't have the menu than go to http://<your_homeassistant_instance:8123>/config/lovelace/resources
    and add the following:

    url: /local/community/ha-vpd-chart/ha-vpd-chart.js
    type: module

Note: After adding the resource, you may need to restart Home Assistant.

Usage

Easy start as Chart View:

type: custom:ha-vpd-chart
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2

Easy start as Bar View:

type: custom:ha-vpd-chart
is_bar_view: true
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2

To use the HaVpdChart in your Lovelace dashboard, add the following configuration to your dashboard. Adjust the sensors and other options according to your setup:

type: custom:ha-vpd-chart
air_text: Temp. #optional "" for Empty
rh_text: r.H. #optional "" for Empty
min_temperature: 5 #optional
max_temperature: 35 #optional
min_humidity: 10 #optional
max_humidity: 100 #optional
min_height: 200 #optional (minimum height of the chart as px)
is_bar_view: false #optional
enable_tooltip: true #optional
enable_axes: true #optional
enable_ghostmap: true #optional
enable_triangle: true #optional
enable_crosshair: true #optional
enable_fahrenheit: false #optional
enable_zoom: true #optional
enable_show_always_informations: true #optional
enable_legend: true #optional
leaf_temperature_offset: 2 || input_number.leaf_offset_example #optional
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    leaf_temperature: sensor.infrared_sensor #optional
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2
vpd_phases: #optional
  - upper: 0.0
    className: gray-danger-zone
    color: #999999
  - lower: 0.0
    upper: 0.4
    className: under-transpiration
    color: #0000FF
  - lower: 0.4
    upper: 0.8
    className: early-veg
  - lower: 0.8
    upper: 1.2
    className: late-veg
  - lower: 1.2
    upper: 1.6
    className: mid-late-flower
  - lower: 1.6
    className: danger-zone
calculateVPD: |2-
          const VPleaf = 610.7 * Math.exp(17.27 * Tleaf / (Tleaf + 237.3)) / 1000; 
          const VPair = 610.7 * Math.exp(17.27 * Tair / (Tair + 237.3)) / 1000 * RH / 100;
          return VPleaf - VPair;

Configuration Parameters

Name Type Required Default Description
type string required Must be custom:ha-vpd-chart.
air_text string optional Air The text used for temperature readings. Default is "Air".
rh_text string optional RH The text used for humidity readings. Default is "RH".
kpa_text string optional kPa The text used for kPa readings. Default is "kPa".
min_temperature number optional 5 Minimum temperature in the chart. Default is 5.
min_humidity number optional 10 Minimum humidity in the chart. Default is 10.
max_temperature number optional 35 Maximum temperature in the chart. Default is 35.
max_humidity number optional 90 Maximum humidity in the chart. Default is 90.
min_height number optional 200 Minimum height of the chart as px. Default is 200.
leaf_temperature_offset number|string optional 2|input_number.leaf_offset_example Sets the Temperature Offset of the Leaf
sensors list required A list of sensors with their temperature and humidity entity IDs, and an optional name for display.
vpd_phases list optional See description A list of VPD phases and their classes for visual representation. See below for defaults.
enable_tooltip boolean optional true Tooltip enabled by default.
is_bar_view boolean optional true Enable Bar view of this chart for fast information of sensors
enable_axes boolean optional true Enable Axes on the Chart
enable_ghostmap boolean optional true Enable Ghostmap on the Chart
enable_triangle boolean optional true Enable Triangle instead of Circle for tooltip marker
enable_crosshair boolean optional true Enable MouseHover Crosshair
enable_fahrenheit boolean optional false Enable Fahrenheit instead of Celsius
enable_zoom boolean optional true Enable zoom function for chart
enable_show_always_informations boolean optional true Enable show always tooltip informations for chart
enable_legend boolean optional true Enable Legend function for chart
calculateVPD string optional See description Custom function to calculate VPD.

Default vpd_phases Configuration:

  • under-transpiration: VPD < 0.4
  • early-veg: 0.4 ≤ VPD < 0.8
  • late-veg: 0.8 ≤ VPD < 1.2
  • mid-late-flower: 1.2 ≤ VPD < 1.6
  • danger-zone: VPD ≥ 1.6