https://github.com/celliesprojects/aquacontrol32-pio
This is a 5 channel LED aqua controller to program gradual sunrises and sunsets. Also has a moon phase simulator.
https://github.com/celliesprojects/aquacontrol32-pio
aquarium-controller aquarium-lights ds18b20 esp32-arduino led-controller lovyangfx m5stack-grey moon-phase web-interface
Last synced: 24 days ago
JSON representation
This is a 5 channel LED aqua controller to program gradual sunrises and sunsets. Also has a moon phase simulator.
- Host: GitHub
- URL: https://github.com/celliesprojects/aquacontrol32-pio
- Owner: CelliesProjects
- License: mit
- Created: 2024-10-15T18:37:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-25T15:48:39.000Z (4 months ago)
- Last Synced: 2026-02-25T19:19:15.461Z (4 months ago)
- Topics: aquarium-controller, aquarium-lights, ds18b20, esp32-arduino, led-controller, lovyangfx, m5stack-grey, moon-phase, web-interface
- Language: C++
- Homepage:
- Size: 146 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://code.visualstudio.com/) with the [PlatformIO](https://platformio.org/) plugin installed.
Supported devices are all esp32 devices with an SD card slot.
A predefined config is included for esp32 M5Stack Core and Core2 devices.
M5Stack CoreS3 devices are not supported.
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
- Optional ds18b20 temperature sensor
### 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](https://github.com/CelliesProjects/aquacontrol32-pio/releases/latest) - 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`:
```bash
-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`:
```c++
#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:
```bash
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