This guide will walk you through the process of installing and configuring reef-pi on a Raspberry Pi. A beginner friendly installation guide is also available on adafruit.com.
The entire installation process involves three main stages.
This guide assume some prior familiarity with computers, but no programming knowledge is required.
We recommend a microSD card of Class10 and at least 8Gb capacity for reef-pi. reef-pi is tested on raspbian, but it should work on most other linux OS, on Raspberry Pi. Follow the official raspberry pi guide for details instructions: - Download and write raspbian image to micro SD card
If you are using Pi zero for your build, we strongly recommend not using graphical user interface and install Raspbian lite. If you are not comfortable with headless or termnial based Raspbian, then consider going with Pi 3 instead.
You can either use console cable or an HDMI based display (monitor or TV) to access raspberry pi.
For console access setup follow this adafruit tutorial. HDMI based access is fairly easy, just hook up any HDMI enabled display (monitor or TV) to raspberry pi using an HDMI cable.
Once raspbian image is written on microSD card, plug it in Raspberry Pi and power it. Once Raspbian OS is started, configure following things internet, date and ssh access.
Configure wifi: Enabling wifi or ethernet based internet connection allows reef-pi to be accessible from any web browser (mobile, tablet or computers). Note, this is not a mandatory requirement, reef-pi can run without any internet connectivity. This is for convenience, to allow accessing reef-pi web interface from any other devices, such as laptop, tablets or mobile phones. Detailed steps for wifi configuration is available here
Use the terminal window to perform a system update with the following command. Note: Skip this step if internet is not enabled. Also install i2c-tools which helps in diagnosing i2c based electronics components (such as pH sensor)
sudo apt-get update -y sudo apt-get upgrade -y sudo apt-get install i2c-tools
/boot/config.txtto load these modules
dtparam=i2c_arm=on dtoverlay=w1-gpio dtoverlay=pwm-2chan
sudo systemctl start ssh.service sudo systemctl enable ssh.service
sudo systemctl start systemd-timesyncd.service sudo systemctl enable systemd-timesyncd.service sudo dpkg-reconfigure tzdata
Finally, reboot Raspberry Pi to apply all the kernel configuration changes
Most of these steps can be done using graphical interface as well,
wget -c https://github.com/reef-pi/reef-pi/releases/download/2.0/reef-pi-2.0-pi3.deb sudo dpkg -i reef-pi-1.0-pi3.deb
Use reef-pi-2.0-pi0.deb package for Raspberry Pi Zero or Model B,
sudo systemctl status reef-pi.service
Thats it, after this, you should be able to access reef-pi from the browser
Default reef-pi login username and password both is set as reef-pi. Update these from the settings section under conifiguration tab. You can play areound with the UI to get familiar with it. Next, use the electronics & wiring guide to setup all the electronics components.