Control application

The main control application of Aquarium control implements the following features:

• Data acquisition of water temperature, pH and conductivity
• Data acquisition of ambient temperature and humidity
• Fresh water refill control
• Feed control
• Water temperature control using air ventilation and heater
• Calculation of refill tank content based on water level measurement
• Actuation of pump for water exchange

Additionally, the main control application implements the following supporting features:

• HW-Tests
• Text-To-Speech interface
• Logging
• Command interface to receive instructions from outside of the application
• Storage of recorded data in SQL database
• File-based communication to web application
• Monitoring and repair of relay board state
• Device Scheduling

The control application makes extensive use of the pigpio library.

The architecture of the application uses various threads.

The application is automatic start by using systemd.

Installation

for the installation of the operating system on the Raspberry Pi, please follow the instructions of the Raspberry Pi foundation. Use the 64-bit version.

Clone the repository, build and install the control SW

Create the folder with the usage rights:

sudo mkdir /usr/local/src/aquarium-ctrl

sudo chown pi /usrlocal/src/aquarium-ctrl

cd /usr/local/src/aquarium-ctrl

Next, clone the repository: git clone https://in-dubio@bitbucket.org/in-dubio/aquarium-ctrl.git

Install the required libraries: bash libinstall.sh

Enable I2C on Raspberry Pi

See detailed instructions how to use rasp-config.

Create a file for the message queue

The file is automatically created when running make install.

Alternatively, run the command sudo touch /var/local/aquarium-ctrl.mq.

The file is defined in the source file UsrIntrfc/MsgQu.h.

Create a ramdisk

Create the folder /mnt/ramdisk.

Add the following line to /etc/fstab: tmpfs /mnt/ramdisk tmpfs nodev,nosuid,size=50M 0 0.

Add a symbolic link using the command ln -s /mnt/ramdisk /var/local/aquarium-ctrl.

Automatic start of control application

Follow instructions for configuring automatic start of control application.

Create the website

In the folder /var/www/html, create the website using git clone https://in-dubio@bitbucket.org/in-dubio/aquarium-web.git.

Change the owner of the website to user pi and change the group of the website to www-data.

Create a symbolic link to the log file running ln -s /var/log/aquarium-ctrl-session.log /var/www/html/aquarium-web/logfile.txt.

Create the file /var/www/app.ini with the following content (set the correct password):

[database]

server = localhost

port = 3306

user = aquarium

password = YourPassword

database = aquarium

Download and install the node JavaScript libraries.

Setup of database

• Download or clone an SQL database dump: git clone https://in-dubio@bitbucket.org/in-dubio/aquarium-database.git
• Import a database.
• Create the user aquarium and assign access rights to the aquarium database.
• Check the user rights using phpmyadmin