.. _install:

========================== PlanktonScope Installation

---

Install Raspbian on your Raspberry Pi

---

Download the image

Download the .zip file of Raspbian Buster with desktop from the Raspberry Pi website Downloads page.

Writing an image to the SD card

Download the latest version of balenaEtcher and install it.

Connect an SD card reader with the micro SD card inside.

Open balenaEtcher and select from your hard drive the Raspberry Pi .zip file you wish to write to the SD card.

Select the SD card you wish to write your image to.

Review your selections and click 'Flash!' to begin writing data to the SD card.

Prepare your Raspberry Pi

https://projects.raspberrypi.org/en/projects/raspberry-pi-getting-started/

Plug the SD Card in your Raspberry Pi

Connect your Pi to a screen, mouse, keyboard and power

Finish the setup

Make sure you have access to internet and update/upgrade your fresh raspbian

Update your Pi first :: sudo apt-get update -y sudo apt-get upgrade -y

Reboot your Pi safely :: sudo reboot now

---

Raspberry Pi configurations

---

Enable Camera/SSH/I2C in raspi-config

Open up the configuration page and select Interfacing Options by typing this command: :: sudo raspi-config

Select Serial

Select NO

Keep the Serial Port Hardware enabled

Reboot your Pi safely :: sudo reboot now

---

Install the needed libraries for the PlanktonScope

---

Install CircuitPython

https://learn.adafruit.com/circuitpython-on-raspberrypi-linux/installing-circuitpython-on-raspberry-pi

Run the following command to install adafruit_blinka :: pip3 install adafruit-blinka sudo pip3 install adafruit-circuitpython-motorkit

Install RPi Cam Web Interface

https://elinux.org/RPi-Cam-Web-Interface

Clone the code from github and enable and run the install script with the following commands :: git clone https://github.com/silvanmelchior/RPi_Cam_Web_Interface.git cd RPi_Cam_Web_Interface ./install.sh

Press Enter to allow default setting of the installation Press Enter to start RPi Cam Web Interface now Found what is the IP of your Raspberry Pi :: sudo ip addr show | grep 'inet 1'

Reach the url on a local browser : http://127.0.0.1/html/

Install Ultimate GPS HAT

https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/pi-setup http://www.danmandle.com/blog/getting-gpsd-to-work-with-python/

Install RGB Cooling HAT

https://www.yahboom.net/study/RGB_Cooling_HAT https://github.com/YahboomTechnology/Raspberry-Pi-RGB-Cooling-HAT :: git clone https://github.com/WiringPi/WiringPi.git cd WiringPi sudo ./build sudo apt-get install gcc

Install Node-RED

https://nodered.org/docs/getting-started/raspberrypi Prerequisites

Ensure npm is able to build any binary modules it needs to install. :: sudo apt-get install build-essential Download and installation

To install Node.js, npm and Node-RED onto a Raspberry Pi, run the following command will that download and install them: :: bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)

Due to the limited memory of the Raspberry Pi, you will need to start Node-RED with an additional argument to tell the underlying Node.js process to free up unused memory sooner than it would otherwise. :: node-red-pi --max-old-space-size=256 Autostart on boot

Run Node-RED when the Pi is turned on, or re-booted, enable the service to autostart by running the command: :: sudo systemctl enable nodered.service Check the installation

Make sure NodeRed is correctly installed by reaching the following page from the broswer of your pi : :: http://localhost:1880.

Install few nodes

These nodes will be used in Node-RED: ::
cd .node-red/ npm install node-red-dashboard npm install node-red-contrib-multipart-stream-decoder npm install node-red-node-base64 npm install node-red-contrib-interval npm install node-red-contrib-python3-function npm install node-red-contrib-camerapi npm install node-red-node-mysql npm install node-red-contrib-calc

Install MorphoCut

https://morphocut.readthedocs.io/en/stable/installation.html MorphoCut is packaged on PyPI and can be installed with pip :: pip install morphocut