ZoneFlow

What each sensor adds

Only the valve switch is required. Each sensor below is optional and adds one capability. Each zone can use a different combination.

What each one adds

  • Valve switch (switch.*): required. It is the one thing ZoneFlow needs to water.
  • Rain sensor (counter.* or sensor.*): rain credit, the dry-down hold and the rain stop. It can be the tip counter of a tipping bucket, or a rain total, a rain rate or a per-reading amount from a weather station such as Ecowitt, Ambient Weather, Davis or Tempest. See Rain gauges and weather stations. A walk-through is in Use your weather station's rain sensor for irrigation. Without one, the zone waters as if it never rains. You can also type in rain you read by hand, or borrow it from weather stations near you. See Rain without a gauge.
  • Outdoor temperature sensor: automatic hot and cool tiers, the ET curve, the deficit-mode heat guard, and the frost guard. Without it, the Fallback / Manual Temperature slider picks the tier — move it by hand for a heat wave or cold spell — and the frost guard falls back to a weather entity's current temperature if you have one.
  • Soil-moisture probe (sensor.*, in %): dry soil waters early and wet soil skips. Without it, the modeled schedule decides alone. Not sure how far to trust a cheap probe, or whether to use tiers, ET or a probe? See ET, temperature tiers or a soil sensor for watering.
  • Pump power sensor: a per-pulse audit that the pump is really running. Without it, there is no low-power warning.
  • Flow meter (cumulative volume): measured water per cycle and a "pump ran but no water moved" alert. Without it, there is no measured delivery and no no-flow check.
  • Zone Flow setting (no sensor needed): the litres per minute your valve gives. It lets the zone card show each watering in litres as well as millimetres, and adds Water Used, Past 30 Days and Water Used This Year. A flow meter's own litres are used when there is one. Set it under Configure → Zone flow. See Calibration. These are estimates for display only and never change when a zone waters.
  • Weather entity (weather.*) with forecast: holds off before forecast rain, with a dry-spell override. Without it, the forecast never blocks a run.
  • Notify target (notify.*): phone alerts for faults and notable events, with per-zone notification levels. Without it, events go to the log only.

Greenhouse and indoor zones

These zones have no rain gauge and no forecast, because there is a roof. They use these instead, all optional except the first if you connect any climate device:

  • Inside temperature sensor: needed before ZoneFlow will switch any fan, vent, mister or heater. It is also used for watering.
  • Backup inside temperature sensors: if the main sensor stops, ZoneFlow carries on with the first backup that works and tells you.
  • Inside humidity sensor: for misting by humidity and for venting out damp air.
  • Light sensor: only for misting by light.
  • Outside temperature sensor: so ventilation never pulls in hotter air. Without it, that check is skipped.

See Greenhouse and indoor zones for what each one does.

Sharing sensors between zones

Sensors can be shared between zones, for example one rain gauge or weather entity for the whole garden. The valve and a soil probe belong to one zone.

When a sensor misbehaves

  • Temperature: a short dropout keeps using the last real days. After 3 days with no reading, the fallback slider decides until the sensor recovers.
  • Rain gauge: unreadable values are ignored, not recorded as zero, and a counter reset or glitch does not lose rain already counted. Moving the Rain Gauge mm per Tip setting, or a restart that reads the default value first, does not add rain that never fell: the stored rain is rescaled to the setting in use.
  • Soil moisture: the schedule decides whenever the reading cannot be used, meaning offline, impossible (outside 0 to 100%), or a dry reading with no report for 24 hours. A wet reading is still trusted, since probes often sit at 100% in soaked soil. If wet readings hold watering back for twice the routine interval you get an alert, and if the probe has also stopped reporting, the schedule waters once and the check starts over. A probe stuck on dry, because it was pulled out of the soil or has failed, cannot flood a zone: a watering that a dry reading brings forward gives only the share of the dose that the days since the last watering call for, never less than a quarter.
  • Pump power: you get a warning and the cycle still completes.
  • Flow meter: the no-flow check is skipped rather than raising a false alarm.
  • Weather: the forecast gate fails open and never blocks a run.