Home

AquaPi for ESPHome

The Aquarium meets the Smart Home!
Setup Guide

Monitor your Aquarium's Temperature and Water Level. With EZO Circuit Boards and Probe upgrades, you can also monitor your pH, Salinity, Dissolved Oxygen and other EZO circuits and probes.
Powered by an esp32 and Controlled by HomeAssistant. You can set alerts for anything, make automations for auto-top-off (see Blueprints), and make beautiful graphs of your aquarium's data (see screenshot).

Buy Now!

UI

Home Assistand Dashboard & Card Examples

If you want to try some of the Dashboard or Cards I use, follow the link below. You may need addtional integrations or custom cards for some of them!
Example HomeAssistant Cards & Templates

Hardware Used

ESP32 devkit
HomeAssistant using a Raspberry Pi 3 or above. The more RAM, the better.
Prerequisite!! A Raspberry Pi (or something similar) running HomeAssistant to communicate and interact with the ESP32 via homeassistant.local:8123. Get Raspberry Pi Imager

Probes

Temperature

• DS18B20 Waterproof Thermistor

Water Level

• Food Grade Optical Infrared Water Liquid Level Sensor

pH: Atlas Scientific pH: EZO-pH & Lab Grade pH Probe

• EZO™ pH Circuit, ISO 10523 Compliant
• Double junction silver / silver chloride Lab Grade pH Probe with Vanadium III, Gen 3
• Electrically Isolated EZO™ Carrier Board
• Range: 0 - 14
• Time Before Recalibration: 1 Year
• Life Expectancy: ~2.5+ Years

Salinity: Atlas Scientific Conductivity: EZO-EC & Conductivity Probe K 1.0

• EZO™ EC Circuit, ISO 7888 Compliant
• Conductivity Probe K 1.0, Graphite, Gen 3
• Electrically Isolated EZO™ Carrier Board
• Range: 0.07 − 500,000+ μS/cm
• Time Before Recalibration: ~10 Years
• Life Expectancy: ~10 Years

Pump: Atlas Scientific Pump: EZO-PMP

• EZO™ Pump Embedded Circuit
• Flow Rate: 0.5ml to 105ml/mins
• Tube Size: 5mm
• Head Height: 8.1m(26.5')

Carbon Dioxide Air: Atlas Scientific CO2: EZO-CO2

• EZO™ CO2 Embedded Circuit, Gaseous
• Range: 0 − 10,000 ppm
• Life Expectancy: ~5.5 Years

Other EZO probes that should work but not yet tested:
Dissolved Oxygen, Humidity, ORP, Temperture

Circuit Diagram

See Wiki for more details on the circuit.

See Diagram

Software Used

Home Assistant: Open source home automation that puts local control and privacy first.
ESPHome: A system to control your ESP8266/ESP32 and RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.

Setup AquaPi

See Wiki for Setup Guides that Include:

Home Assistant

Setting up Home Assistant and Connecting AquaPi to your Wifi.

Update Wirelessly

Updating the AquaPi.

Web Server

Connecting to the AquaPi without Home Assisstant.

Blueprints

See Wiki
These are scripts and automations I created to control other devices within Home Assistant.

Install

See Wiki for guides when installing on a non-configured ESP32 device.

Notable Substitutions

See Wiki for more information on customizing your device.

Useful Links:

See Links

HomeAssistant
ESPHome
EZO Raspberry Pi Sample Code
EZO pH Circuit Datasheet
EZO EC Circuit Datasheet
EZO Pump Circuit Datasheet