AQUACONTROL32-PIO

This is a LED control app aimed at aquarium use. With this app you can program gradual sunrises and sunsets on 5 LED channels through a web interface. The moon phase cycle is simulated and can be adjusted from the web interface. All settings are saved to an SD card.

To use this project you need a esp32 board with a SD card slot, a LED dimming board and you will need VSCode with the PlatformIO plugin installed.

Supported devices are all esp32 devices with an SD card slot.
Predefined configs are included for M5Stack Grey/Fire and the ESP32-S3-BOX-Lite.

M5Stack grey LED dimming board with 2A LED channels and sensor connector

Edit channels with the web interface

• Add timers by click-dragging on the grid
• To adjust timers drag and drop a timer handle to another location
• The first timer can not be deleted but the intensity can be set
• No touch handlers are defined so it will not work on a touch device

How to setup this app

Hardware needed

• Supported esp32 board. (SD card slot is required)
• Led dimming board capable of handling 5 LED pwm inputs. (and optionally a i2c temperature sensor)
• ds18b20 temperature sensor. (optional)

Upgrading from aquacontrol32

This app is the successor to aquacontrol32 and is compatible with the file format used so you can easily upgrade and keep your current light settings. Just upload your existing default.aqu to the new device and done!

Software setup

1 - Download software

• Visual Studio Code
• PlatformIO
• The latest release of aquacontrol - unzip the file to a local folder.

Open this folder in PlatformIO File->Open Folder.

2 - Adjust user location and board setup

Open platformio.ini and adjust the [user]section to your location.

In the same file, you can adjust the gpio pins in the [env:headless] section by adjusting the following build_flags:

    -D SDCARD_SS=xx
    -D LEDPIN_0=xx
    -D LEDPIN_1=xx
    -D LEDPIN_2=xx
    -D LEDPIN_3=xx
    -D LEDPIN_4=xx

Note: The ds18b20 temperature sensor is not supported in the headless build.

3 - Setup your WiFi secrets in src/secrets.h

In the folder where you extracted the files, create a new file src/secrets.h.

Copy-paste the source below to src/secrets.h:

#ifndef _SECRETS_H_
#define _SECRETS_H_

const char *SSID = "wifi network";
const char *PSK = "wifi password";

const char *WEBIF_USER = "admin";
const char *WEBIF_PASSWORD = "admin";

#endif

Adjust the values as needed.

4 - Make sure you have a FAT32 formatted SD card inserted

• Timers are saved on the SD card as default.aqu.
• Moonlight setup is saved on the SD card as default.mnl.

Without SD card the app will seem to work but saving timers or moonlight settings is not possible.
Uploaded timers will be gone on a reboot without a SD card.

5 - Upload app and start editing

Select the PIO icon on the left, then open Project Tasks.
Click on your device to expand the menu and there select Upload and Monitor.

After uploading, the IP address of the webinterface is shown on the display.
Browse to this IP, then click on a channel bar and start editing timers.

Your WiFi has changed? - You can override your WiFi settings with the SD card

You can skip this when flashing your device.
With WiFi secrets on the SD card you dont need to reflash your device if you ever want or need to change the wifi settings at some point.
Just create or update default.net on the SD card with the new secrets and reboot.
There are two methods available.

First method - you can not access the 'old' WiFi network

Create a file named default.net with the secrets for the WiFi network:

SSID=wifi network
PSK=wifi password

1. Save this file on the SD card.
2. Insert the SD card in the aquarium controller.
3. Reboot.

Second method - you can still access the 'old' network

1. Upload default.net as described above to the controller through the /fileupload page.
2. Reboot.

Note: Settings found on the SD card override the compiled in settings.

URLs on the device

• /
  Current channel levels and temperature are shown.
  Click on a level bar to go to the /editor.

• /editor
  Edit channel timers and save these timers to an SD card.

• /moonsetup
  Setup full moon levels for the moon simulator.

• /fileupload
  Upload files to the controller.
  Uploaded files named default.aqu or default.mnl will be parsed and if valid light or moon settings are found, these will be applied directly after upload.

• /api/uptime
  Uptime in human readable format