Skip to content

Setup AquaPi

Nicholas White edited this page Mar 12, 2024 · 14 revisions

Setup Instructions

Connect Sensors

All sensors and their respective connectors are color-coded:
Green is for the Dallas Temperature Probe(s), up to 2 with an additional Y-cable.
Blue/Yellow is for the Optical Sensors, each connected to the supplied Y-cable.
Red is for all I2C sensors, all EZO sensors will connect to this, multiple via additional Y-cables.
White is for optional sensors, such as additional optical sensors. Also connected to DAC Pins for other/future uses.

Home Assistant

  1. Install and power on the Home Assistant device. Connect it via an ethernet cable.

  2. Navigate to the following URL, via your favorite browser:

homeassistant.local:8123
  1. Go through the Home Assistant Onboarding.
    Follow the link above to see more detail on Onboarding Home Assistant
username onboarding_devices

Connect AquaPi to Wifi

  1. Power on the AquaPi and connect to Wifi:
    On your Phone, connect to the Wifi Network aquapi-xxxxxx
    Note the name of the wifi, it macthes your devices name
    Select your Wifi ID, and enter your Wifi password
Screenshot_20230812-234153EDIT Screenshot_20230812-234744EDIT
  1. Back in Home Assistant, you should see a notification saying a New Devices Discovered. (Settings -> Devices & Services)
    You can click the buttom below to go there automatically:

Open your Home Assistant instance and show your integrations.

Screenshot_20230813-141349

  1. Choose Configure under the device named AquaPi XXXXXX and follow to promts to add it your Home Assistant frontend.
    Notice the name matches the Wifi name you connected to earlier
    The Blue LED on the AquaPi should stop flashing when connected to Home Assistant.
Screenshot_20230813-141640 AScreenshot_20230813SD144346
  1. To get updates, install the Home Assistant Add-On named ESPHome. Once installed, launch the add-on and navigate to the User-Interface by using OPEN WEB UI.
    Add On Store:

Open your Home Assistant instance and show the Supervisor add-on store.

Screenshot_20230813-144240 Screenshot_20230813-144513
  1. In ESPHome, you should see the name of you AquaPi with a green button named Adopt.
    Click on it, follow the promts and enter your Wifi credentials, and click Install and choose Wirelessly to install the most current AquaPi firmware.
Screenshot_20230813-144723 Screenshot_20230813-153752

Update

Update AquaPi Firmware by Using ESPHome, clicking on the 3-dots under your device, and choosing Install. It will pull the latest code from the GitHub respository.

NOTE: Depending on your Wifi congestion, you may need to put your device in Safe Mode by using the Restart in Safe Mode button in the device's configuration.

See Screenshot

Screenshot 2023-09-03 134530

Screenshot_20230813-153815 Screenshot_20230813-153825

Web Server

Alternatively, after connecting to Wifi, you can access the AquaPi web server without Home Assistant by navigating to:

<hostname>.local/

Replace <hostname> with the hostname of the AquaPi. This is the ESP32's web server.
Hostname is the name of the device. (In this example: aquapi-6734b0.local/)

Screenshot 2024-02-22 000808 PXL_20230529_200205979 PXL_20240224_022516268~2

AquaPi for ESPHome

The Aquarium meets the Smart Home!

Clone this wiki locally