Irrigation Component V4 providing support for a custom card

Overview

Irrigation Component V4

This release sees the delivery of a custom card https://github.com/petergridge/irrigation_card to render the program options specified in the configuration.

The driver for this project is to provide an easy to configure user interface for the gardener of the house. The goal is that once the inital configuration is done all the features can be modified lovelace cards.

The provided working test harness is self contained with dummy switches and rain sensor that can be used to become familiar with the capabilities of the component.

irrigation|690x469,50% Image 1: All attributes rendered using the companion custom card

All the inputs of the platform are Home Assistant entities for example the start time is provided via a input_datetime entity. The information is evaluated to trigger the irrigation action according to the inputs provided.

Watering can occur in an Eco mode where a water/wait/repeat cycle is run to minimise run off by letting water soak in using several short watering cycles. The wait and repeat configuration is optional.

The rain sensor is implemented as a binary_sensor, this allows practically any combination of sensors to suspend the irrigation. This can be defined at the zone level to allow for covered ares to continue watering while exposed areas are suspended.

Implemented as a switch, you can start a program manually or using an automation. Manually starting a program by turning the switch on will not evaluate the rain sensorany rules it will just run the shedule, as there is an assumption that there is an intent to run the program.

Only one program can run at a time by default to prevent multiple solenoids being activated. If program start times result in an overlap the running program will be stopped. This can be modified with the allow_multiple attribute to achieve the required outcome you need to set this on each defined program.

INSTALLATION

To create a working sample

  • Copy the irrigationprogram folder to the ‘config/custom components/’ directory
  • Restart Home Assistant
  • Copy the 'irrigationtest.yaml' file to the packages directory or into configuration.yaml
  • Restart Home Assistant
  • Install irrigation_custom_card from this repository https://github.com/petergridge/irrigation_card
  • Follow the custom card instructions to add a card for each of: switch.morning, switch.afternoon and switch.night

Important

  • Make sure that all of the objects you reference i.e. input_boolean, switch etc are defined or you will get errors when the irrigationprogram is triggered. Check the log for errors.

Pre-requisite

  • The time_date integration is required
sensor:
  - platform: time_date
    display_options:
      - 'time'
      - 'date'

Debug

Add the following to your logger section configuration.yaml

logger:
    default: warning
    logs:
        custom_components.irrigationprogram: debug

Rain Sensor feature

If a rain sensor is not defined the zone will always run at the nominated start time.

If the irrigation program is run manually the rain sensor value is ignored and all zones will run.

The rain sensor can be optionally defined in each zone. You can:

  • Define the same sensor for each zone
  • Have a different sensor for different areas
  • Configure the ability to ignore the rain sensor

Monitor Controller feature

If this binary sensor is defined it will not execute a schedule if the controller is offline. This is ideal for ESP Home implementations.

Watering Adjuster feature

As an alternative to the rain sensor you can also use the watering adjustment. With this feature the integrator is responsible to provide the value using a input_number component. I imagine that this would be based on weather data or a moisture sensor.

See the https://github.com/petergridge/openweathremaphistory for a companion custom comsensor that may be useful.

Setting water_adjustment attribute allows a factor to be applied to the watering time.

  • If the factor is 0 no watering will occur
  • If the factor is 0.5 watering will run for only half the configured watering time. Wait and repeat attributes are unaffected.

The following automation is an example of how the input_number.adjust_run_time could be maintained

automation:
- id: '1553507967550'
  alias: rain adjuster
  mode: restart
  trigger:
  - platform: time_pattern
    minutes: "/1"
  action:
    - service: input_number.set_value
      entity_id: input_number.rain_adjuster
      data:
        value: "{{ value template calculation }}"

Run Days and Run Frequency

Run frequency allows the definition of when the program will run.

This can be a specific set of days or the number of days between watering events. This can be defined at the Program or zone level. Application at the zone level allows different zones to execute at the same time but using varying frquencies. for example: Vege Patch every two days and the Lawn once a week.

  • Run Freq allows the water to occur at a specified frequency, for example, every 3 days or only on Monday, Wednesday and Saturday.
  • Run Days DEPRECATED in this version, if you used this in version 3 simply rename Run Days to Run Freq to retain the same behaviour.

Defining a selection list to use with the run_freq attribute.

input_select:
  irrigation_freq:
    name: Zone1 Frequency
    options:
      - "1"
      - "2"
      - "3"
      - "4"
      - "5"
      - "6"
      - "7"
      - "['Wed','Sat']"
      - "['Sun','Thu']"
      - "['Mon','Fri']"
      - "['Tue','Sat']"
      - "['Sun','Wed']"
      - "['Mon','Thu']"
      - "['Tue','Fri']"
      - "['Mon','Wed','Fri']"
      - "['Mon','Tue','Wed','Thu','Fri','Sat','Sun']"

ECO feature

The ECO feature allows multiple short watering cycles to be configure for a zone in the program to minimise run off and wastage. Setting the optional configuration of the Wait, Repeat attributes of a zone will enable the feature.

  • wait sets the length of time to wait between watering cycles
  • repeat defines the number of watering cycles to run

CONFIGURATION

A self contained working sample configuration is provided in the packages directory of this repository.

Example configuration.yaml entry

  switch:
  - platform: irrigationprogram
    switches: 
      morning:
        name: Morning
        irrigation_on: input_boolean.irrigation_on
        start_time: input_datetime.irrigation_morning_start_time
        run_freq: input_select.irrigation_freq
        icon: mdi:fountain
        zones:
        # Adjust watering time used 
        # Watering time adjusted to water * adjust_watering_time
          - zone: switch.irrigation_solenoid_01
            name: Pot Plants
            water: input_number.irrigation_pot_plants_run
            water_adjustment: input_number.adjust_run_time
            wait: input_number.irrigation_pot_plants_wait
            repeat: input_number.irrigation_pot_plants_repeat
            icon: 'mdi:flower'
        # No rain sensor defined, will always water to the schedule
          - zone: switch.irrigation_solenoid_03
            name: Greenhouse
            water: input_number.irrigation_greenhouse_run
            wait: input_number.irrigation_greenhouse_wait
            repeat: input_number.irrigation_greenhouse_repeat
            icon: 'mdi:flower'
        # Rain sensor used, watering time only
          - zone: switch.irrigation_solenoid_02
            name: Front Lawn
            water: input_number.irrigation_lawn_run
            rain_sensor: binary_sensor.irrigation_rain_sensor
            ignore_rain_sensor: switch.ignore_rain_sensor

    # minimal configuration, will run everyday at the time specified
      afternoon:
        name: Afternoon
        start_time: input_datetime.irrigation_afternoon_start_time
        zones:
          - zone: switch.irrigation_solenoid_01
            name: Pot Plants
            water: input_number.irrigation_pot_plants_run
          - zone: switch.irrigation_solenoid_02
            name: Front Lawn
            water: input_number.irrigation_lawn_run

CONFIGURATION VARIABLES

program

(string)(Required) the switch entity.

name

(string)(Optional) display name for the irrigation program switch.

start_time

(input_datetime)(Required) the local time for the program to start.

run_freq

(input_select)(optional) Indicate how often to run. If not provided will run every day.

controller_monitor

(binary_sensor)(optional) Detect if the irrigation controller is online. Autoated schedule will not execute if offline.

irrigation_on

(input_boolean)(Optional) Attribute to temporarily disable the watering schedule

icon

(icon)(Optional) The icon displayed for the program. (default: mdi:fountain)

allow_multiple

(boolean)(Optional) Allow multiple zones to be active at the same time (default: false)

unique_id

(string)(Optional) An ID that uniquely identifies this switch. Set this to an unique value to allow customisation trough the UI.

Zones

(list)(Required) The list of zones to water.

zone

(entity)(Required) This is the switch that represents the solenoid to be triggered.

name

(string)(Required) This is the name displayed when the zone is active.

rain_sensor

(binary_sensor)(Optional) A binary sensor - True or On will prevent the irrigation starting. e.g. rain sensor, greenhouse moisture sensor or template sensor that checks the weather

ignore_rain_sensor

(input_boolean)(Optional) Attribute to allow the zone to run regardless of the state of the rain sensor. Useful for a greenhouse zone that never gets rain.

water

(input_number)(Required) This it the period that the zone will turn the switch_entity on for.

water_adjustment

(input_number)(Optional) This is a factor to apply to the watering time that can be used as an alternative to using a rain sensor. The watering time will be multiplied by this factor to adjust the run time of the zone.

wait

(input_number)(Optional) This provides for an Eco capability implementing a cycle of water/wait/repeat to allow water to soak into the soil.

repeat

(input_number)(Optional) This is the number of cycles to run water/wait/repeat.

run_freq

(input_select)(optional) Indicate how often to run. If not provided will run every day.

icon

(icon)(Optional) This will replace the default mdi:water icon shown when the zone is running.

SERVICES

irrigationprogram.stop_programs:
    description: Stop any running program.

REVISION HISTORY

4.0.0

  • New repository for Version 4 with improvements and support for custom card support
  • Allow definition for run frequency at the zone level - feature request
  • DEPRECATED the run_days attribute. Simply rename this attribute to run_freq to maintain the functionality
  • Optionally allow multiple programs to run simultaneously use allow_multiple config option
  • Allow monitoring of the irrigation controller hardware if supported, will not run schedule if controller is offline

3.0.3

  • Update to validate the referenced objects after HASS has started.

3.0.2

  • Update to fix bug in last run date attribute. Impacted Programs that run on the Frequency option.

3.0.0

  • BREAKING CHANGE: deprecate the irrigationzone component
  • Move zone details into the irrigationprogram component - feature request
  • Move rain sensor to the zone definition - feature request
  • Move ignore rain sensor into the zone definition - feature request
  • Improve validation of components to warn when HA objects are not found
  • Add run time adjustment - feature request
  • improved async behavior when automatically starting the program

1.1.0

  • add version to manifest.json files
  • tweak how the program turns off zones
  • remove validation for time.sensor

0.2

• Remove requirement for HA time sensor

You might also like...
A small script I made that takes any standard Decklist of magic the gathering cards and pulls all card images from scryfall at once!

A small script I made that takes any standard Decklist of magic the gathering cards and pulls all card images from scryfall at once!

Master Duel Card Translator Project

Master Duel Card Translator Project A tool for translating card effects in Yu-Gi-Oh! Master Duel. Quick Start (for Chinese version only) Download the

Providing a working, flexible, easier and faster installer than the one officially provided by Arch Linux
Providing a working, flexible, easier and faster installer than the one officially provided by Arch Linux

Purpose The purpose is to bring more people to Arch Linux by providing a working, flexible, easier and faster installer than the one officially provid

These are the scripts used for the project of ‘Assembly of a pan-genome for global cattle reveals missing sequence and novel structural variation, providing new insights into their diversity and evolution history’

script-SV-genotyping These are the scripts used for the project of ‘Assembly of a pan-genome for global cattle reveals missing sequence and novel stru

A web-based analysis toolkit for the System Usability Scale providing calculation, plotting, interpretation and contextualization utility
A web-based analysis toolkit for the System Usability Scale providing calculation, plotting, interpretation and contextualization utility

System Usability Scale Analysis Toolkit The System Usability Scale (SUS) Analysis Toolkit is a web-based python application that provides a compilatio

MeepoBenchmark - This project aims at providing the scripts, logs, and analytic results for Meepo Blockchain
MeepoBenchmark - This project aims at providing the scripts, logs, and analytic results for Meepo Blockchain

MeepoBenchmark - This project aims at providing the scripts, logs, and analytic results for Meepo Blockchain

A python script providing an idea of how a MindSphere application, e.g., a dashboard, can be displayed around the clock without the need of manual re-authentication on enforced session expiration

A python script providing an idea of how a MindSphere application, e.g., a dashboard, can be displayed around the clock without the need of manual re-authentication on enforced session expiration

JLC2KICAD_lib is a python script that generate a component library for KiCad from the JLCPCB/easyEDA library.

JLC2KiCad_lib is a python script that generate a component library (schematic, footprint and 3D model) for KiCad from the JLCPCB/easyEDA library. This script requires Python 3.6 or higher.

Comments
  • Flow / liters based approach

    Flow / liters based approach

    Hi, I really love this component!

    Instead of relying on TIME - I generally found FLOW meter based approaches be more reliable. This way you say - measure 10 Liters of water - no matter how long it takes.

    There's flow meters for 10$ on the internet https://www.amazon.com/HiLetgo-1-75MPa-Flowmeter-Control-Arduino/dp/B01N2NJQHD/ref=zg_bs_306928011_5/147-3589379-9778044?pd_rd_i=B01N2NJQHD&psc=1

    That can be integrated into HASS via EasyESP or RPIEasy (https://tutorials-raspberrypi.com/reading-out-the-flow-meter-water-flow-sensor-on-the-raspberry-pi/)

    Now of course I wonder... Would your component allow to switch to FLOW based as an alternative option to the existing TIME BASED?

    Thx!

    opened by knom 3
  • Delay between zones?

    Delay between zones?

    Is there a way of adding a 'wait' between the zones in a program? From what i've seen the wait only works if having the wait repeat cycle. Is there a quick hacky way of adding a slider for a wait time between when zone 1 finishes and zone 2 starts?

    Thanks!

    opened by pdavid345 2
Releases(V4.0.14)
  • V4.0.14(Aug 10, 2022)

  • V4.0.13(Aug 8, 2022)

    New Features

    • Improved Documentation
    • Add inter zone delay to provide a delay between zones starting.
    • Add zone grouping to allow groups of zones to run concurrently, corrected in V4.0.13. Prerequisite
    • Requires Custom Card version 4.0.12 Breaking change:
    • DEPRECATED icon attributes
    • DEPRECATED allow_multiple option as this is replaced by zone groups.
    Source code(tar.gz)
    Source code(zip)
  • 4.0.12(Aug 5, 2022)

    Add inter zone delay to provide a delay between zones starting. Add zone grouping to allow groups of zones to run concurrently. Requires Custom Card version 4.0.12 Breaking change: Remove ICON attributes Remove allow_multiple option as this is replaced by zone groups.

    Source code(tar.gz)
    Source code(zip)
  • v4.0.11(Apr 24, 2022)

  • 4.0.10(Apr 23, 2022)

    • Add volume based watering option. Watering can occur using a flow meter instead of based on time
    • Add capability to turn on a pump or other switch when starting a zone
    • fix error in remaining time presentation
    Source code(tar.gz)
    Source code(zip)
  • 4.0.9(Feb 21, 2022)

  • V4.0.8(Feb 17, 2022)

  • V4.0.7(Jan 6, 2022)

  • v4.0.6(Dec 27, 2021)

Simple utlity for sniffing decrypted HTTP/HTTPS traffic on a jailbroken iOS device into an HAR format.

Description iOS devices contain a hidden feature for sniffing decrypted HTTP/HTTPS traffic from all processes using the CFNetwork framework into an HA

83 Dec 25, 2022
Project aims to map out common user behavior on the computer

User-Behavior-Mapping-Tool Project aims to map out common user behavior on the computer. Most of the code is based on the research by kacos2000 found

trustedsec 136 Dec 23, 2022
An execution framework for systematic strategies

WAGMI is an execution framework for systematic strategies. It is very much a work in progress, please don't expect it to work! Architecture The Django

Rich Atkinson 10 Mar 28, 2022
Transparently load variables from environment or JSON/YAML file.

A thin wrapper over Pydantic's settings management. Allows you to define configuration variables and load them from environment or JSON/YAML file. Also generates initial configuration files and docum

Lincoln Loop 90 Dec 14, 2022
Two predictive attributes (Speed and Angle) and one attribute target (Power)

Two predictive attributes (Speed and Angle) and one attribute target (Power). A container crane has the function of transporting containers from one point to another point. The difficulty of this tas

Astitva Veer Garg 1 Jan 11, 2022
Packaging tools for shanty services.

parcel Packaging tools for shanty services. What? Services are docker containers deployed by shanty on a hosting appliance. Each service consists of t

0 Jan 20, 2022
This repository contains Python Projects for Beginners as well as for Intermediate Developers built by Contributors.

Python Projects {Open Source} Introduction The repository was built with a tree-like structure in mind, it contains collections of Python Projects. Mo

Gaurav Pandey 115 Apr 30, 2022
Rock 💎 Paper 📝 Scissors ✂️ Lizard 🦎 Spock 🖖

Rock 💎 Paper 📝 Scissors ✂️ Lizard 🦎 Spock 🖖 If you’ve seen The Big Bang Theory, you’ve heard of a game called “Rock, Paper, Scissors, Lizard, Spoc

AmirHossein Mohammadi 16 Jun 19, 2022
pyshell is a Linux subprocess module

pyshell A Linux subprocess module, An easier way to interact with the Linux shell pyshell should be cross platform but has only been tested with linux

4 Mar 02, 2022
Python script that automates the tasks involved in starting a new coding project

Auto Project Builder Automates the repetitive tasks while starting a new project Installation Use the REQUIREMENTS.txt file to install the dependencie

Prathap S S 1 Feb 03, 2022
Tensorboard plugin 3d with python

tensorboard-plugin-3d Overview In this example, we render a run selector dropdown component. When the user selects a run, it shows a preview of all sc

KitwareMedical 26 Nov 14, 2022
This is a Docker-based pipeline for preparing sextractor-ready multiwavelength images

Pipeline for creating NB422-detected (ODI) catalog The repository contains a Docker-based pipeline for preprocessing observational data. The pipeline

1 Sep 01, 2022
dotfiles - Cristian Valero Abundio

In this repository you can find various configurations to configure your Linux operating system, preferably ArchLinux and its derivatives.

Cristian Valero Abundio 1 Jan 09, 2022
An open letter in support of Richard Matthew Stallman being reinstated by the Free Software Foundation

An open letter in support of RMS. To sign, click here and name the file username.yaml (replace username with your name) with the following content

2.4k Jan 07, 2023
samples of neat code

NEAT-samples Some samples of code and config files for use with the NEAT-Python package These samples are largely copy and pasted, so if you

Harrison 50 Sep 28, 2022
API Rate Limit Decorator

ratelimit APIs are a very common way to interact with web services. As the need to consume data grows, so does the number of API calls necessary to re

Tomas Basham 574 Dec 26, 2022
Blender Add-on That Provides Quick Access to Render Controls

Blender Render Buttons Blender Add-on That Provides Quick Access to Render Controls A Blender 3.0 compatablity update of Blender2.8x-RenderButton v0.0

Don Schnitzius 3 Oct 18, 2022
Customisable coding font with alternates, ligatures and contextual positioning

Guide Ligature Support Links Log License Guide Live Preview + Download larsenwork.com/monoid Install Quit your editor/program. Unzip and open the fold

Andreas Larsen 7.6k Dec 30, 2022
A tool for fixing inconsistent timestamp metadata (atime, ctime, and mtime).

Mtime Fixer Mtime Fixer is a tool for fixing inconsistent timestamp metadata (atime, ctime, and mtime). Sometimes timestamp metadata of folders are in

Halit Şimşek 2 Jan 11, 2022
Monitoring of lake dynamics

slamcore_utils Description This repo contains the slamcore-setup-dataset script. It can be used for installing a sample dataset for offline testing an

10 Jun 23, 2022