Skip to content
Nicholas White edited this page Aug 1, 2024 · 10 revisions

<img ="left" src="https://github.com/TheRealFalseReality/aquapi/blob/5e4a82a5755e06d9029109c4bd55601596198b7c/assests/image/AquaPi%20Logo.png" alt="drawing" style="width:120px;"/>

The Aquarium meets the Smart Home!
Setup Guide
Build It Yourself

Join the conversation on Reef2Reef!

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.
PXL_20230529_200205979 PXL_20240224_022516268~2

UI

Screenshot 2024-02-22 000808 Screenshot 2024-02-22 001408

Home Assistant Dashboard & Card Examples

If you want to try some of the Dashboard or Cards I use, follow the link below. You may need additional 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

Sensors

Temperature

  • DS18B20 Waterproof Thermistor

Water Level

  • Food Grade Optical Infrared Water Liquid Level Sensor

Water Leak Sensor

  • Liquid Detection Sensor, 6ft Cable, 2 Mounting Screws w/Magnetic Mount

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

Dissolved Oxygen: Atlas Scientific DO: EZO-DO & Dissolved Oxygen Probe

  • EZO™ DO Embedded Circuit
  • Range: 0.00 - 100 mg/L (0 - 350% saturation)
  • Life Expectancy: ~4 Years

ORP: Atlas Scientific ORP: EZO-ORP & ORP Probe

  • EZO™ ORP Embedded Circuit
  • Range: -2000mV - 2000 mV
  • Life Expectancy: ~2 Years

Peristaltic Dosing Pump: Atlas Scientific Pump: EZO-PMP

  • EZO™ Pump Embedded Circuit
  • Flow Rate: 0.5ml to 105ml/min
  • 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:
Humidity, Temperature

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.

made-for-esphome-white-on-black

Setup AquaPi

See Wiki for Setup Guides that Include:

Setting up Home Assistant and Connecting AquaPi to your Wifi.

Updating the AquaPi.

Connecting to the AquaPi without Home Assistant.

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