AquaPi for ESPHome

The Aquarium meets the Smart Home!
Setup Guide

AquaPi for ESPHome is a project that helps you build a powerful aquarium monitoring and automation system using affordable ESPHome devices and Home Assistant. Make endless automations and monitor temperature, water level, and upgrade for advanced aquarium monitoring: pH, salinity, dissolved oxygen, and more (using EZO circuits and probes).

Why use AquaPi?

• Open-source: Freely available for anyone to access, modify, and contribute to.
• Modular: Designed to be easily expanded and customized based on your specific needs.
• Modernized: Utilizes the latest technologies and tools for a seamless user experience.
• Customizable: Adapt the system to fit your unique aquarium setup and monitoring preferences.
• Versatile: Expand the system's capabilities with your own compatible sensors and equipment.
• Affordable: Offers a cost-effective alternative to many high-end monitoring solutions.
• Powerful: Provides comprehensive monitoring capabilities for various water parameters.

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

Peristaltic Dosing 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.

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-pH Circuit Datasheet
EZO-EC Circuit Datasheet
EZO-PMP Circuit Datasheet
EZO-CO2 Circuit Datasheet