README.md formatting changes.
Markdown is not easy when you start!
This commit is contained in:
Romain Bazile
parent
bd03fcfdbe
commit
1a8ef38302
267
README.md
267
README.md
|
|
@ -1,12 +1,8 @@
|
||||||
PlanktonScope Installation
|
# PlanktonScope Installation
|
||||||
==========================
|
|
||||||
|
|
||||||
*************************************
|
## Install and setup Raspbian on your Raspberry Pi
|
||||||
Install Raspbian on your Raspberry Pi
|
|
||||||
*************************************
|
|
||||||
|
|
||||||
Download the image
|
### Download the image
|
||||||
==================
|
|
||||||
|
|
||||||
Download the .zip file of Raspbian Buster with desktop from the Raspberry Pi website Downloads page.
|
Download the .zip file of Raspbian Buster with desktop from the Raspberry Pi website Downloads page.
|
||||||
|
|
||||||
|
|
@ -22,213 +18,202 @@ 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.
|
Review your selections and click 'Flash!' to begin writing data to the SD card.
|
||||||
|
|
||||||
Prepare your Raspberry Pi
|
### Prepare your Raspberry Pi
|
||||||
-------------------------
|
[Getting Started with your Raspberry Pi](https://projects.raspberrypi.org/en/projects/raspberry-pi-getting-started/)
|
||||||
`Getting Started with your Raspberry Pi <https://projects.raspberrypi.org/en/projects/raspberry-pi-getting-started/>`_
|
|
||||||
|
|
||||||
Plug the SD Card in your Raspberry Pi
|
Plug the SD Card in your Raspberry Pi
|
||||||
|
|
||||||
Connect your Pi to a screen, mouse, keyboard and power
|
Connect your Pi to a screen, mouse, keyboard and power
|
||||||
|
|
||||||
Finish the setup
|
Finish the setup
|
||||||
|
|
||||||
Make sure you have access to internet and update/upgrade your fresh raspbian
|
Make sure you have access to internet and update/upgrade your fresh raspbian
|
||||||
|
|
||||||
Update your Pi first
|
Update your Pi first
|
||||||
::
|
```
|
||||||
sudo apt-get update -y
|
sudo apt-get update -y
|
||||||
sudo apt-get upgrade -y
|
sudo apt-get upgrade -y
|
||||||
|
```
|
||||||
Reboot your Pi safely
|
Reboot your Pi safely
|
||||||
::
|
```
|
||||||
sudo reboot now
|
sudo reboot now
|
||||||
|
```
|
||||||
|
|
||||||
***************************
|
### Raspberry Pi configurations
|
||||||
Raspberry Pi configurations
|
|
||||||
***************************
|
|
||||||
|
|
||||||
Enable Camera/SSH/I2C in raspi-config
|
Enable Camera/SSH/I2C in raspi-config
|
||||||
|
|
||||||
Open up the configuration page and select Interfacing Options by typing this command:
|
Open up the configuration page and select Interfacing Options by typing this command:
|
||||||
::
|
```
|
||||||
sudo raspi-config
|
sudo raspi-config
|
||||||
|
```
|
||||||
|
|
||||||
Select **Serial**
|
Select `Serial`
|
||||||
|
|
||||||
Select **NO**
|
Select `NO`
|
||||||
|
|
||||||
Keep the **Serial Port Hardware enabled**
|
Keep the `Serial Port Hardware enabled`
|
||||||
|
|
||||||
Reboot your Pi safely
|
Reboot your Pi safely
|
||||||
::
|
```
|
||||||
sudo reboot now
|
sudo reboot now
|
||||||
|
```
|
||||||
|
|
||||||
|
## Install the needed libraries for the PlanktonScope
|
||||||
|
|
||||||
**************************************************
|
### Install CircuitPython
|
||||||
Install the needed libraries for the PlanktonScope
|
[Installing CircuitPython on Raspberry Pi](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux/installing-circuitpython-on-raspberry-pi)
|
||||||
**************************************************
|
|
||||||
|
|
||||||
Install CircuitPython
|
|
||||||
=====================
|
|
||||||
`Installing CircuitPython on Raspberry Pi <https://learn.adafruit.com/circuitpython-on-raspberrypi-linux/installing-circuitpython-on-raspberry-pi>`_
|
|
||||||
|
|
||||||
Run the following command to install adafruit_blinka
|
Run the following command to install adafruit_blinka
|
||||||
::
|
```
|
||||||
pip3 install adafruit-blinka
|
pip3 install adafruit-blinka
|
||||||
sudo pip3 install adafruit-circuitpython-motorkit
|
sudo pip3 install adafruit-circuitpython-motorkit
|
||||||
|
```
|
||||||
|
|
||||||
Install RPi Cam Web Interface
|
### Install RPi Cam Web Interface
|
||||||
=============================
|
|
||||||
|
|
||||||
`RPi Cam Web Interface <https://elinux.org/RPi-Cam-Web-Interface>`_
|
[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
|
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
|
git clone https://github.com/silvanmelchior/RPi_Cam_Web_Interface.git
|
||||||
cd RPi_Cam_Web_Interface
|
cd RPi_Cam_Web_Interface
|
||||||
./install.sh
|
./install.sh
|
||||||
|
```
|
||||||
|
|
||||||
Press Enter to allow default setting of the installation
|
Press Enter to allow default setting of the installation
|
||||||
Press Enter to start RPi Cam Web Interface now
|
Press Enter to start RPi Cam Web Interface now
|
||||||
Found what is the IP of your Raspberry Pi
|
Found what is the IP of your Raspberry Pi
|
||||||
::
|
```
|
||||||
sudo ip addr show | grep 'inet 1'
|
sudo ip addr show | grep 'inet 1'
|
||||||
|
```
|
||||||
|
|
||||||
Reach the url on a local browser : http://127.0.0.1/html/
|
Reach the url on a local browser : http://127.0.0.1/html/
|
||||||
|
|
||||||
Install Ultimate GPS HAT
|
### Install Ultimate GPS HAT
|
||||||
========================
|
[Installing Adafruit GPS HAT](https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/pi-setup)
|
||||||
`Installing Adafruit GPS HAT <https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/pi-setup>`_
|
|
||||||
|
|
||||||
`Use Python Thread with GPS HAT <http://www.danmandle.com/blog/getting-gpsd-to-work-with-python/>`_
|
[Use Python Thread with GPS HAT](http://www.danmandle.com/blog/getting-gpsd-to-work-with-python/)
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo apt-get install python gpsd gpsd-clients
|
||||||
|
```
|
||||||
|
|
||||||
|
### Install RGB Cooling HAT
|
||||||
|
[Installing RGB Cooling HAT](https://www.yahboom.net/study/RGB_Cooling_HAT)
|
||||||
|
|
||||||
::
|
|
||||||
sudo apt-get install python gpsd gpsd-clients
|
|
||||||
|
|
||||||
Install RGB Cooling HAT
|
|
||||||
=======================
|
|
||||||
`Installing RGB Cooling HAT <https://www.yahboom.net/study/RGB_Cooling_HAT>`_
|
|
||||||
Type these command to install:
|
Type these command to install:
|
||||||
::
|
```
|
||||||
git clone https://github.com/WiringPi/WiringPi.git
|
git clone https://github.com/WiringPi/WiringPi.git
|
||||||
cd WiringPi
|
cd WiringPi
|
||||||
sudo ./build
|
sudo ./build
|
||||||
sudo apt-get install gcc
|
sudo apt-get install gcc
|
||||||
|
```
|
||||||
|
|
||||||
Install Node-RED
|
### Install Node-RED
|
||||||
==================
|
[Installing Node-RED on Raspberry Pi](https://nodered.org/docs/getting-started/raspberrypi)
|
||||||
`Installing Node-RED on Raspberry Pi <https://nodered.org/docs/getting-started/raspberrypi>`_
|
|
||||||
|
|
||||||
Prerequisites
|
#### Prerequisites
|
||||||
-------------
|
Ensure npm is able to build any binary modules it needs to install.
|
||||||
Ensure npm is able to build any binary modules it needs to install.
|
```
|
||||||
::
|
sudo apt-get install build-essential
|
||||||
sudo apt-get install build-essential
|
```
|
||||||
|
|
||||||
Download and installation
|
#### 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:
|
||||||
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)
|
||||||
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.
|
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
|
node-red-pi --max-old-space-size=256
|
||||||
|
```
|
||||||
|
|
||||||
Autostart on boot
|
#### Autostart on boot
|
||||||
-----------------
|
|
||||||
Run Node-RED when the Pi is turned on, or re-booted, enable the service to autostart by running the command:
|
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
|
sudo systemctl enable nodered.service
|
||||||
|
```
|
||||||
|
|
||||||
Check the installation
|
#### Check the installation
|
||||||
----------------------
|
Make sure NodeRed is correctly installed by reaching the following page from the broswer of your pi : http://localhost:1880.
|
||||||
Make sure NodeRed is correctly installed by reaching the following page from the broswer of your pi :
|
|
||||||
::
|
|
||||||
http://localhost:1880.
|
|
||||||
|
|
||||||
Install few nodes
|
#### Install few nodes
|
||||||
-----------------
|
|
||||||
These nodes will be used in Node-RED:
|
These nodes will be used in Node-RED:
|
||||||
::
|
```
|
||||||
cd .node-red/
|
cd .node-red/
|
||||||
npm install node-red-dashboard
|
npm install node-red-dashboard
|
||||||
npm install node-red-contrib-python3-function
|
npm install node-red-contrib-python3-function
|
||||||
npm install node-red-contrib-camerapi
|
npm install node-red-contrib-camerapi
|
||||||
npm install node-red-contrib-gpsd
|
npm install node-red-contrib-gpsd
|
||||||
npm install node-red-contrib-web-worldmap
|
npm install node-red-contrib-web-worldmap
|
||||||
|
```
|
||||||
|
|
||||||
Import the last GUI
|
#### Import the last GUI
|
||||||
-------------------
|
|
||||||
|
|
||||||
Import the `lastest version of the GUI <https://raw.githubusercontent.com/tpollina/PlanktonScope/master/scripts/flows_planktonscope.json>`_
|
Import the lastest version of the GUI from https://raw.githubusercontent.com/tpollina/PlanktonScope/master/scripts/flows_planktonscope.json>
|
||||||
|
|
||||||
Install Mosquitto MQTT
|
### Install Mosquitto MQTT
|
||||||
======================
|
|
||||||
|
|
||||||
In order to send and receive from Node-RED:
|
In order to send and receive from Node-RED:
|
||||||
::
|
```
|
||||||
sudo apt-get install mosquitto mosquitto-clients
|
sudo apt-get install mosquitto mosquitto-clients
|
||||||
|
|
||||||
|
|
||||||
Install mqtt-paho
|
```
|
||||||
=================
|
|
||||||
|
### Install mqtt-paho
|
||||||
|
|
||||||
In order to send and receive from python:
|
In order to send and receive from python:
|
||||||
::
|
```
|
||||||
pip3 install paho-mqtt
|
pip3 install paho-mqtt
|
||||||
|
```
|
||||||
Install OpenCV
|
|
||||||
=================
|
### Install OpenCV
|
||||||
|
|
||||||
Use the quick version without virtual env
|
Use the quick version without virtual env
|
||||||
https://www.pyimagesearch.com/2019/09/16/install-opencv-4-on-raspberry-pi-4-and-raspbian-buster/
|
https://www.pyimagesearch.com/2019/09/16/install-opencv-4-on-raspberry-pi-4-and-raspbian-buster/
|
||||||
|
|
||||||
|
|
||||||
Install MorphoCut
|
### Install MorphoCut
|
||||||
=================
|
|
||||||
|
|
||||||
`Installing MorphoCut <https://morphocut.readthedocs.io/en/stable/installation.html>`_
|
_Installing MorphoCut <https://morphocut.readthedocs.io/en/stable/installation.html>`_
|
||||||
|
|
||||||
MorphoCut is packaged on PyPI and can be installed with pip:
|
MorphoCut is packaged on PyPI and can be installed with pip:
|
||||||
::
|
```
|
||||||
sudo apt-get install python3-scipy
|
sudo apt-get install python3-scipy
|
||||||
pip3 install -U git+https://github.com/morphocut/morphocut.git@pyrocystis
|
pip3 install -U git+https://github.com/morphocut/morphocut.git@pyrocystis
|
||||||
|
```
|
||||||
|
|
||||||
Finishing the install
|
## Finishing the install
|
||||||
=====================
|
|
||||||
|
|
||||||
Make sure to update your Pi
|
Make sure to update your Pi
|
||||||
::
|
```
|
||||||
sudo apt-get update -y
|
sudo apt-get update -y
|
||||||
sudo apt-get full-upgrade -y
|
sudo apt-get full-upgrade -y
|
||||||
|
```
|
||||||
|
|
||||||
Reboot your Pi safely
|
Reboot your Pi safely
|
||||||
::
|
```
|
||||||
sudo reboot now
|
sudo reboot now
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
*******************
|
## Useful later maybe
|
||||||
Usefull later maybe
|
|
||||||
*******************
|
|
||||||
|
|
||||||
Download the GitHub repo
|
### Download the GitHub repo
|
||||||
========================
|
|
||||||
At this link : https://github.com/tpollina/PlanktonScope/archive/master.zip
|
At this link : https://github.com/tpollina/PlanktonScope/archive/master.zip
|
||||||
Unzip to a specific location:
|
Unzip to a specific location:
|
||||||
::
|
```
|
||||||
unzip /home/pi/Downloads/PlanktonScope-master.zip -d /home/pi/
|
unzip /home/pi/Downloads/PlanktonScope-master.zip -d /home/pi/
|
||||||
mv /home/pi/PlanktonScope-master /home/pi/PlanktonScope
|
mv /home/pi/PlanktonScope-master /home/pi/PlanktonScope
|
||||||
|
```
|
||||||
|
|
||||||
Update node-RED interface
|
### Update node-RED interface
|
||||||
=========================
|
|
||||||
To update the interface, you can just download the lastest .json file:
|
To update the interface, you can just download the lastest .json file:
|
||||||
::
|
```
|
||||||
wget -P $HOME/.node-red https://raw.githubusercontent.com/tpollina/PlanktonScope/master/scripts/flows_planktonscope.json
|
wget -P $HOME/.node-red https://raw.githubusercontent.com/tpollina/PlanktonScope/master/scripts/flows_planktonscope.json
|
||||||
|
```
|
||||||
|
|
||||||
Share WiFi via Ethernet
|
### Share WiFi via Ethernet
|
||||||
=======================
|
|
||||||
|
|
||||||
At this link : https://www.instructables.com/id/Share-WiFi-With-Ethernet-Port-on-a-Raspberry-Pi/
|
At this link : https://www.instructables.com/id/Share-WiFi-With-Ethernet-Port-on-a-Raspberry-Pi/
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue