Water tank monitoring with ESPHome

Water tank monitoring with ESPHome

· 5 min read

Watering your lawn and plants around the house wasn't one of my favourite things to do. Especially when we bought a robot lawnmower, watering the lawn became quite a hassle since we had to always put away the sprinklers and hoses after each irrigation.

An automatic irrigation system was needed. Inspired by this thread on the HA Community I started looking into building a DIY solution. Which includes controlling the individual irrigation zones, monitoring the water level of the cistern and, if necessary, automatically filling the cistern. We end up with a mixed setup using a Hunter Hydrawise as the irrigation controller and a custom made solution to monitor and refill the water tank.

I'm splitting this into two posts. Part 1 is about the ESPHome solution to monitor the water level of our garden cistern. Part 2 will cover the Home Assistant integration of Hydrawise, valves, the ESPHome water tank sensor and automations for the entire garden irrigation setup.

The cistern plays a central role in our garden irrigation. Since the pump can deliver a higher pressure than the house water connection, the entire system is connected to it. For us, no water in the cistern means no watering of the plants or the lawn.

A few tries to get it right


I've been working for quite a while on a simple & reliable monitoring solution for our garden cistern. Today's ESPHome base solution is the 3rd and most stable iteration.

The way the sensor works is very simple. The ultrasonic sensor is mounted inside the cistern above the water. It measures the distance to the water surface. The higher the water level, the smaller the distance between the water and the sensor. When we consume water, the water surface sinks and the distance increases. If it rains or we manually refill the cistern, the distance decreases again. I measured the full and empty levels of our cistern and can interpolate the intermediates. Using a volume formula, I can convert the distance (in cm) to litres.

schematic drawing cistern

This concept is still used for the current version of the water level sensor.

The first version of my cistern water level sensor consisted of a particle.io Photon microcontroller chip, a HC-SR04 ultrasonic sensor, a rechargeable battery incl. charging controller, all together in a waterproof enclosure. I was already familiar with Arduino microcontrollers, so programming the Photon chip was not a problem. The initial version of the source code is available GitHub. Looks super complicated because of the extra logic for average measurement calculation, deep sleep mode and sending the values to MQTT and the particle.io cloud in parallel.

The two main problems of this setup were the Wifi connectivity and the battery management. Since the cistern is completely underground and made of reinforced concrete there is no good wifi coverage inside. Getting a wifi connection required usually 3-5 retries. This drained the battery a lot. To get a long battery life I put the Photon chip into sleep mode most of the time. It took a distance reading every 15 minutes, compared it with the previous measurement and only connected to wifi to send and update if there are any changes. This could mean I did not get an updated measurement for some days and could not be sure that the battery was still charged.

The second iteration was also based on the Photon microcontroller chip. But this time I split the hardware into two units. The sensor box was still inside the water tank. In fact, the microcontroller was now outside, connected to a sensor via cables, and powered by a USB adapter permanently. This setup had way better reliability and no wifi connection problems.

Unfortunately, the HC-SR04 ultrasonic sensor still caused problems. It is simply not made to be placed in a cistern with permanent moisture around.

All good things come in three


After two HC-SR04 ultrasonic sensors died because of corrosion, I began looking for an alternative. For the third, and hopefully the final, version of the water tank sensor two changes have been implemented:

  1. the sensor device got a waterproof upgrade to a JSN SR04T ultrasonic sensor
  2. the microcontroller was changed to an ESP8266 based Wemos D1 mini pro running EPSHome

So far the JSN SR04T ultrasonic sensor is pretty reliable. The setup has been running super stable for more than a year now.

microcontroller watertank sensor

The hardware setup for the water tank sensor is simple. JSN SR04T is connected via the helper module to the Wemos D1 mini microcontroller. Only 4 pins are required: 5V, GND, Trigger pin and echo pin.

fritzing diagram of water tank sensor setup

No further electronic components are required. The setup is powered by a USB power adapter.



If you are not familiar with ESPHome getting started is not complicated, especially if you already use Home Assistant and the step-by-step install guide.

The ESPHome configuration for the water tank sensor is relativly simple. Only 80 lines of YAML config ... and these already include the setup boilerplate and some comments.

name: watertank
platform: ESP8266
board: d1_mini_pro

ssid: !secret esphome_wifi_ssid
password: !secret esphome_wifi_password

ssid: esp01



password: !secret esphome_api_password

password: !secret esphome_ota_password

# Wifi signal sensor.
- platform: wifi_signal
name: garden_watertank_wifi
update_interval: 600s
unit_of_measurement: "%"
- lambda: |-
if (x <= -100) {
return 0;
} else {
if (x >= -50) {
return 100;
} else {
return 2 * (x + 100);

# Templates for calculated liter & percent
- platform: template
name: garden_watertank_liter
id: garden_watertank_liter
icon: "mdi:water"
unit_of_measurement: "l"
accuracy_decimals: 0

- platform: template
name: garden_watertank_percent
id: garden_watertank_percent
icon: "mdi:water-percent"
unit_of_measurement: "%"

# The actual distance sensor
- platform: ultrasonic
trigger_pin: D1
echo_pin: D2
name: garden_watertank_distance
update_interval: 600s
pulse_time: 50us
- filter_out: nan
- median:
window_size: 7
send_every: 4
send_first_at: 3
- calibrate_linear:
- 0.23 -> 1.86
- 2.41 -> 0.0
- sensor.template.publish:
id: garden_watertank_liter
state: !lambda 'return x * 3141.592653589793238;'

- sensor.template.publish:
id: garden_watertank_percent
state: !lambda 'return x * 53.979255216319471;'

The most crucial parts of the code config start in line 56 with the setup of the ultra sonic sensor.

I decided to send updated measurements every 10 minutes only. The water level does not vary that much during most of the year, so there are not many updates. But if we consume water quickly and there is heavy rain filling the cistern the 10 minutes interval still results in a smooth graph.

The measuring and calculation of litre and percent happens in two steps. In a first step some filters are applied to the measured distance values to filter out invalid readings and get a smooth median value. Via calibrate_linear the measured distance, from the sensor to water surface, is transformed into the actual height of the water within our cistern.

The values for litre and percent are calculated based on the water height using two lambda functions. The magic factors in the formulas are multiplied out factors for volume of our cistern.

In our case the cistern is a round cylinder, the volume formula for that is:

V = π * r² * h

With h = x in the lambda function. The diameter of the cistern is exactly 2 meter, hence a radius of 1 meter. To formula for me is π * 1² * x which will return the volume in square meters. That multiplied by 1000 results in the returned value in litres.

The percentage calculation is similar, based on the max volume of 5.500 litres of our cistern.

Is it accurate?


The way the sensor works it can not be super accurate and it is not really important for our use case but let's check. I'm comparing the measurements with an older flow meter I had lying around:

Compare ESPHome sensor & flow meter

The readings from the distance sensor are in centimetres. The minimum change it recognizes is 1cm. If we put that into our formula (in meters) π * 1² * 0,01 we get 0,03141m³ which is ~ 31 liter. That is the minimum accuracy we can get.

Into Home Assistant


To use the water tank sensor in Home Assistant I use the ESPHome integration. Setup is super easy via the UI and all exposed sensor data from the ESPHome sketch is automatically available in Home Assistant.

Screenshot ESPHome integration

In the next post I will explain how the water tank data of the ESPHome sensor is used in Home Assistant. The automations I have set up to control the water tank pump & Hydrawise irrigation controller for the garden and lawn watering.

Hero image photo by Daniel van den Berg on Unsplash