Skip to main content

Arrosage conseillé smart home integration, free and open source

Arrosage conseillé integration for Gladys Assistant

Water to bring to each garden zone from evapotranspiration and rain (Open-Meteo).

How much water each zone of your garden needs today, from the water balance of the soil: the reference evapotranspiration (ET0, FAO-56) minus the rain, at the location of your house. The data comes from Open-Meteo, free and without an account. The integration advises: it controls no valve itself, your scenes start the irrigation controller.

What you get​

One device per zone, with read-only sensors:

  • Water to bring (mm): the deficit of the balance, 0 when the soil has enough or when rain is forecast;
  • Advised watering time (minutes): the water to bring divided by the application rate of the zone (only when a rate, or a flow and an area, are configured);
  • Soil water balance (mm): negative = water missing, positive = water kept in reserve;
  • Yesterday's ET0 and Today's ET0 (mm/day), and the Rain forecast today (mm/day).

How the advice is computed​

Every day at the computation hour, yesterday is added to the balance of every zone:

balance = min(reserve cap, balance of the day before + rain − Kc × ET0)

  • ET0 is the reference evapotranspiration of a well-watered grass (FAO-56 Penman-Monteith), computed by Open-Meteo from temperature, wind, humidity and sunshine.
  • Kc, the crop coefficient, adapts it to the planting: lawn 0.85, vegetable garden 1, flower beds 0.75, hedges and shrubs 0.5, or the value you type.
  • The reserve cap is the surplus water the soil keeps after a heavy rain; it is spent before any watering is advised.
  • Water to bring = −balance when the balance is negative. When the rain forecast for the day reaches the threshold, the advice is 0 (the deficit stays in the balance, and the rain will be counted tomorrow).
  • Time = water to bring ÷ application rate × 60. The rate in mm/h is typed, or computed from the flow and the area (1 L on 1 m² = 1 mm).

The balance is kept in /data across restarts. After a stop, the missing days are counted on the next computation (up to 7 days back). Mark a watering with the "Zone watered" scene action or the widget button: without an amount, the balance goes back to 0 (a full ration).

Configuration​

Set the coordinates of your house in Gladys (Settings → Houses): the integration reads them.

  • Language of names and texts: the names of the features (frozen when the device is added) and the texts of the widget.
  • Rain that cancels watering: in mm, decimals accepted (2,5); 0 disables it.
  • Hour of the daily computation (0-23, 5 by default): pick it before your watering time.
  • Zones 1 to 4: a zone exists once it has a name. Then its type of planting (or a Kc), its application rate in mm/h, or its flow in L/min and its watered area in m², and its reserve cap in mm (25 by default, 0 for no carry-over, e.g. pots).

Rates of thumb: oscillating sprinkler 5 to 10 mm/h, pop-up spray 25 to 40 mm/h, drip line: flow of the drippers × number ÷ area.

Actions​

Show the advice now reads Open-Meteo if needed and shows the water and time of every zone.

Scenes​

  • Trigger Watering advised: once a day, at the computation hour, for each zone that needs water (filter on a zone or not). Its variables: zone, water to bring (mm), advised time (minutes, 0 if unknown). Typical scene: "Watering advised" on the lawn → open the valve of the irrigation controller (OpenSprinkler, Rain Bird, a smart plug…) → wait the advised time → close it → "Zone watered".
  • Action Zone watered: counts a watering in the balance, the amount given in mm or a full ration when empty. Without a zone, every zone.
  • The usual Gladys triggers on the device values also work, e.g. "Advised watering time above 0" combined with a time condition.

Dashboard​

The Irrigation advice widget shows today's ET0 and rain, the water and time of every zone, and a "watered" button per zone. Its settings hide the weather line or the buttons. The device sensors can also be added to the dashboard, with their history.

Limits and troubleshooting​

  • An estimate, not a measure: the soil type, the slope, the shade or the wind are not known. Adjust the Kc or the reserve cap after a few weeks if the lawn turns yellow (Kc up) or stays soaked (Kc down).
  • The rain counted is the rain modelled by Open-Meteo at your coordinates, not your rain gauge. A local storm may be missed.
  • Open-Meteo is free for non-commercial use (fewer than 10,000 requests a day): the integration reads it every 3 hours. Data under CC BY 4.0, by Open-Meteo.com.
  • "No house location": set the coordinates of your house. "Open-Meteo cannot be reached": the advice keeps the last forecast and the integration retries every 15 minutes.
  • Details in the logs: set LOG_LEVEL=debug.

Configuration settings​

These are the settings Arrosage conseillé asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
How it workssectionNoEvery day, the water balance of each zone adds the rain and subtracts the evapotranspiration (ET0 × crop coefficient), read from Open-Meteo at the location of your house in Gladys. One device per zone.
Language of names and textsselectNo
Rain that cancels watering (mm)stringNoWhen the rain forecast for the day reaches this amount, the advice is no watering. 0 to disable. Decimals accepted (2,5).
Hour of the daily computationnumberNoAt this hour (0-23), yesterday is added to the balances and the 'Watering advised' trigger fires. Choose it before your watering time.
Zone 1sectionNoA zone exists once it has a name. The rate, or the flow and the area, give the advised watering time.
NamestringNo
Type of plantingselectNo
Crop coefficient Kc (optional)stringNoReplaces the coefficient of the type, from 0 to 2.
Application rate (mm/h)stringNoWater depth the sprinkler or drip line brings in one hour. Takes precedence over flow and area.
Flow (L/min)stringNo
Watered area (m²)stringNo
Soil reserve cap (mm)numberNoSurplus water the soil keeps after heavy rain, counted against the next days. 0: no carry-over.
Zone 2sectionNo
NamestringNo
Type of plantingselectNo
Crop coefficient Kc (optional)stringNoReplaces the coefficient of the type, from 0 to 2.
Application rate (mm/h)stringNoWater depth the sprinkler or drip line brings in one hour. Takes precedence over flow and area.
Flow (L/min)stringNo
Watered area (m²)stringNo
Soil reserve cap (mm)numberNoSurplus water the soil keeps after heavy rain, counted against the next days. 0: no carry-over.
Zone 3sectionNo
NamestringNo
Type of plantingselectNo
Crop coefficient Kc (optional)stringNoReplaces the coefficient of the type, from 0 to 2.
Application rate (mm/h)stringNoWater depth the sprinkler or drip line brings in one hour. Takes precedence over flow and area.
Flow (L/min)stringNo
Watered area (m²)stringNo
Soil reserve cap (mm)numberNoSurplus water the soil keeps after heavy rain, counted against the next days. 0: no carry-over.
Zone 4sectionNo
NamestringNo
Type of plantingselectNo
Crop coefficient Kc (optional)stringNoReplaces the coefficient of the type, from 0 to 2.
Application rate (mm/h)stringNoWater depth the sprinkler or drip line brings in one hour. Takes precedence over flow and area.
Flow (L/min)stringNo
Watered area (m²)stringNo
Soil reserve cap (mm)numberNoSurplus water the soil keeps after heavy rain, counted against the next days. 0: no carry-over.

How to install Arrosage conseillé in Gladys​

  1. In Gladys, open Integrations: Arrosage conseillé appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/guim31/gladys-arrosage:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/guim31/gladys-arrosage.

Arrosage conseillé requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Arrosage conseillé is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂