Skip to content

Latest commit

 

History

History
83 lines (48 loc) · 4.42 KB

Pre-Requisites_Read_Me.md

File metadata and controls

83 lines (48 loc) · 4.42 KB

Prerequisites

This package will not work on any version of Home Assistant less than 0.113.2

Some things need to be in your config outside of this package.

I have detailed them here and provided example yaml code in prerequisites.yaml.

(please let me know if you come across anything I have forgotten so that I can update this readme).

Folder Structure: There are two elements to this project, the functional code (automations, scripts etc.) and the Lovelace UI.

The folder named 'lovelace' should be copied in its entirety into your config folder. If you already have a 'lovelace' folder in your config folder then just copy the contents there. This is not optional unless you edit the code as there are a lot of references to absolute file locations.

The folder named 'package' is the functional code. The files within this folder can be copied anywhere you like (individually or within a folder with any name) so long as it is in HA recognises that location as its location for packages.

Scenes are used in this package. If you use default_config: there is no need to add anything as it is included automatically (see - https://www.home-assistant.io/integrations/default_config/) if not then somewhere (usually in your configuration.yaml) you must include the line scene:

sensor.time is needed somewhere in your config

sun2. This is a custom component (installable through HACS) that provides lots of solar information and creates binary_sensor.above_horizon which is used in the graphs.

However, if you prefer, you could easily provide your own binary_sensor using the core Sun component. The state of sun.sun is either above_horizon or below_horizon.

Recorder. In order to show the irrigation times on the 'History' page you must have the recorder component installed. This is included in Home Assistant by default.

If you have configured recorder to include entities you will need to include the eight sensors:

irrigation_sensor_zone1_switch, irrigation_sensor_zone2_switch... irrigation_sensor_zone8_switch

Notifications. Functionality is included but it makes use of a subsystem that I wrote for use throughout my system. I use it in this case so that when I am away on holiday it tells me when irrigation starts and ends. In order for you to be able to adapt this to your own use you will need to define two extra 'helpers' somewhere in your config:

input_text.notifications_user1_name and input_text.notifications_user2_name

Mine are not in this package because they are part of my notification system. The actual notifications are also handled outside the package so some changes will be needed to suit whatever notification methods you choose to use.

(@http_edo13 has posted how they use Telegram here: https://community.home-assistant.io/t/my-garden-irrigation/99686/404)

The Lovelace interface makes use of many custom integrations/cards (all installable using HACS https://github.com/hacs):

Fonts You can change the font used via the UI. It defaults to whatever is used in your current theme but a condensed font will display better as there is a lot squeezed onto the screen.

I have had good success with Oswald and Dosis but you can experiment with any font you like. To use these fonts add the following lines to your Lovelace resources section:

#=== FONTS
- url: https://fonts.googleapis.com/css?family=Oswald
  type: css
- url: https://fonts.googleapis.com/css?family=Dosis
  type: css

I use a theme called dark_teal (available here https://github.com/aFFekopp/dark_teal and via HACS) but it works with the default HA theme and should do with any other 'well behaved' theme as well.

Weather sensors: See https://github.com/kloggy/HA-Irrigation-Version2/blob/master/Weather%20Sensors.md