From 1a8ef383029d3ac169573e2227c171f9749045e7 Mon Sep 17 00:00:00 2001 From: Romain Bazile Date: Fri, 29 May 2020 20:00:59 +0200 Subject: [PATCH] README.md formatting changes. Markdown is not easy when you start! --- README.md | 267 ++++++++++++++++++++++++++---------------------------- 1 file changed, 126 insertions(+), 141 deletions(-) diff --git a/README.md b/README.md index c0dcd74..5d90a67 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,8 @@ -PlanktonScope Installation -========================== +# PlanktonScope Installation -************************************* -Install Raspbian on your Raspberry Pi -************************************* +## Install and setup 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. @@ -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. -Prepare your Raspberry Pi -------------------------- -`Getting Started with your Raspberry Pi `_ +### Prepare your Raspberry Pi +[Getting Started with 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 +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 - +Update your Pi first +``` +sudo apt-get update -y +sudo apt-get upgrade -y +``` Reboot your Pi safely -:: - sudo reboot now +``` +sudo reboot now +``` -*************************** -Raspberry Pi configurations -*************************** +### 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 +``` +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 -:: - sudo reboot now +``` +sudo reboot now +``` +## Install the needed libraries for the PlanktonScope -************************************************** -Install the needed libraries for the PlanktonScope -************************************************** - -Install CircuitPython -===================== -`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 -:: - pip3 install adafruit-blinka - sudo pip3 install adafruit-circuitpython-motorkit +``` +pip3 install adafruit-blinka +sudo pip3 install adafruit-circuitpython-motorkit +``` -Install RPi Cam Web Interface -============================= +### Install RPi Cam Web Interface -`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 -:: - git clone https://github.com/silvanmelchior/RPi_Cam_Web_Interface.git - cd RPi_Cam_Web_Interface - ./install.sh +``` +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' +``` +sudo ip addr show | grep 'inet 1' +``` Reach the url on a local browser : http://127.0.0.1/html/ -Install Ultimate GPS HAT -======================== -`Installing Adafruit GPS HAT `_ +### Install Ultimate GPS HAT +[Installing Adafruit GPS HAT](https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/pi-setup) -`Use Python Thread with GPS HAT `_ +[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 `_ Type these command to install: -:: - git clone https://github.com/WiringPi/WiringPi.git - cd WiringPi - sudo ./build - sudo apt-get install gcc +``` +git clone https://github.com/WiringPi/WiringPi.git +cd WiringPi +sudo ./build +sudo apt-get install gcc +``` -Install Node-RED -================== -`Installing Node-RED on Raspberry Pi `_ +### Install Node-RED +[Installing Node-RED on Raspberry Pi](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 +#### 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) - +#### 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 +``` +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: -:: - sudo systemctl enable nodered.service +``` +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. +#### 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 ------------------ +#### Install few nodes These nodes will be used in Node-RED: -:: - cd .node-red/ - npm install node-red-dashboard - npm install node-red-contrib-python3-function - npm install node-red-contrib-camerapi - npm install node-red-contrib-gpsd - npm install node-red-contrib-web-worldmap +``` +cd .node-red/ +npm install node-red-dashboard +npm install node-red-contrib-python3-function +npm install node-red-contrib-camerapi +npm install node-red-contrib-gpsd +npm install node-red-contrib-web-worldmap +``` -Import the last GUI -------------------- +#### Import the last GUI -Import the `lastest version of the GUI `_ +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: -:: - 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: -:: - pip3 install paho-mqtt - -Install OpenCV -================= +``` +pip3 install paho-mqtt +``` + +### Install OpenCV Use the quick version without virtual env https://www.pyimagesearch.com/2019/09/16/install-opencv-4-on-raspberry-pi-4-and-raspbian-buster/ -Install MorphoCut -================= +### Install MorphoCut -`Installing MorphoCut `_ +_Installing MorphoCut `_ MorphoCut is packaged on PyPI and can be installed with pip: -:: - sudo apt-get install python3-scipy - pip3 install -U git+https://github.com/morphocut/morphocut.git@pyrocystis +``` +sudo apt-get install python3-scipy +pip3 install -U git+https://github.com/morphocut/morphocut.git@pyrocystis +``` -Finishing the install -===================== +## Finishing the install -Make sure to update your Pi -:: - sudo apt-get update -y - sudo apt-get full-upgrade -y +Make sure to update your Pi +``` +sudo apt-get update -y +sudo apt-get full-upgrade -y +``` Reboot your Pi safely -:: - sudo reboot now +``` +sudo reboot now +``` -******************* -Usefull later maybe -******************* +## Useful later maybe -Download the GitHub repo -======================== +### Download the GitHub repo At this link : https://github.com/tpollina/PlanktonScope/archive/master.zip Unzip to a specific location: -:: - unzip /home/pi/Downloads/PlanktonScope-master.zip -d /home/pi/ - mv /home/pi/PlanktonScope-master /home/pi/PlanktonScope +``` +unzip /home/pi/Downloads/PlanktonScope-master.zip -d /home/pi/ +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: -:: - 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/ -