Part 3: Software installation & configuration.
Continuing on the reef-pi controller build thread. This is the last part on the build process. In previous two parts I have covered assembling the electronics and then building hosing/fixture for the electronics and electrical outlets. I'll go through the software installation and configuration related bits in this part.
reef-pi is built and tested on
Raspberry Pi, a tiny computer. Raspberry Pi website has extensive documentation. I am enlisting only the reef-pi specific relevant bits. We'll need a separate computer (or a laptop), a keyboard and a mouse for this steps. Some basic knowledge of how to update files will be required as well,
- Install & configure operating system: Follow raspberry pi official documentation to format the microSD card. I'll recommend using the latest pixel distribution as operating system. Attach microSD card, a mouse, keyboard (use the USB ports), and an HDMI based display (like TV) . Once Raspberry Pi is started change default password, configure internet (if you want to access reef-pi from internet connected devices, such as laptop, mobile) and update /boot/config.txt file to enable i2c, spi (example). Enable ssh. There are documentation on each of these step in raspberry pi website. There are several youtube videos as well. Let me know if you need any tutorial reference. I'm not repeating those steps here, to keep things concise.
- Configure official pi display (if you are using one)
- Install and configure reef-pi software: Download reef-pi software package from here. Run "sudo dpkg -i reef-pi-0.0.3.deb" to install reef-pi. Restart raspberry pi.Once restarted reef-pi should be running on raspberry pi. You can check the dashboard using the browser, by visiting "http://localhost:8080".
If you wire everything correctly, this will be all you need to get reef-pi running. After this, you can start using reef-pi controller software from the raspberry pi's display. reef-pi ships with configuration that does not allow the software to be used from other devices. You can change it (/etc/reef-pi/config.yaml), to allow access from other devices. Once configure, restart reef-pi (sudo systemctl restart reef-pi), or restart raspberry pi, and then you should be able to access reef-pi from any internet connected device (such as mobile, tablets, computers etc), using the device's browser. Just point it to reef-pi's IP address. reef-pi dashboard will show the IP address of the controller. (or run `ip a s` command on raspberry pi ).
reef-pi home page (or dashboard):
I'll go over the basic workflows in next post. Probably, cover how to configure equipment, automate day to day reef keeping chores with reef-pi etc.