Software
In this part of the instructions, we will go over installation of the eduROV software and program the microcontroller. Most steps are explained in the python documentation for the eduROV package found by clicking the button below.
Raspberry Pi setup
Components
-
Raspberry Pi
-
NOOBS SD card
Tools
-
Access to WiFi
-
HDMI monitor
-
USB Keyboars
-
USB Mouse
Procedure
We have two options when setting up our Raspberry Pi for the first time, either 1) use a screen, keyboard and mouse, or 2) we set it up for remote control using SSH. Only the first method is used here, feel free to go roaming online for a headless setup, as it is called when not using a screen.
​
Insert the SD-card with NOOBS into the Pi, plug in the screen, keyboard and mouse and start it by plugging in the power cable. This will then take you through the configuration and setup of the Raspberry Pi.
After the initial setup, you need to install the edurov program, for this we need access to the internet. Connect either to an available WiFi network, or connect the Pi to a router using the ethernet cable. During the setup procedure, make sure to activate SSH
It is always a good idea to update and upgrade any installed software when we have the chance, this is a safety measure. Use “sudo apt-get update” and “sudo apt-get upgrade” from a terminal window to do this. Then install edurov by running “sudo pip install edurov”.
​
Open Raspberry Pi Configuration from the start-menu.
Pi setup:
-
Locale, keyboard layout and wifi country to Norway and Norwegian keyboard layout
-
Activate SSH, SPI and camera
-
Change password! default is “raspberry”. Remember or write down the new password you set. This will also be used to log into the ROV later
-
Log in to the wifi and move the ethernet connector to your PC
-
To log into the Raspberry Pi you can either address "raspberrypi.local" or the IP-address of the Pi. For Mac and Linux users, the "raspberrypi.local" solution will work out of the box. For this solution to work on Windows, you need to install Bonjour services.
-
In windows: Use Putty, and open "raspberrypi.local"​​​​
-
In MacOS: from the terminal window type in: "ssh pi@raspberrypi.local"
-
-
Type in your password and get going!
​
​
Alternative method . Set static IP-address on the Raspberry Pi
-
Set a static IP-address for eht0, for example something like: 192.168.0.3
-
Check out this link for instructions
-
I’m only defining the “static ip_address=xxx.xxx.xxx.xxx” line, not writing any of the others
-
-
Log in to the Pi using SSH, using Putty from windows or directly from a terminal from Mac or Linux computer
​
​
-
Now we are ready to install the edurov program 😊
​​
​
Relevant links and resources:
Raspberry Pi website, how to find the IP address of your Pi
Bonjour services - install for Windows
Download the newest version of Raspbian
​
If you want to reinstall the Raspbian operating system, or you have an SD card without NOOBS or Raspbian installed. You will need these programs:
Etcher - for writing the operating system to the SD card - works on Mac, Windows and Linux
SD card formatter - for properly formatting old SD cards - works on Mac and Windows
Arduino installation
Components
-
Arduino Micro
-
Micro USB cable
Tools
-
PC with internet access
Procedure
After you have downloaded and installed the Arduino IDE on your computer, download the “Arduino code” folder from edurov’s github page. Plug the Arduino into the computer and upload the code. This is all you need to do, unless you want to change something in how the Arduino works. Use the file called "eduROV_v3_arduino_code", but make sure you download the whole folder.
EduROV software installation and startup
Components
-
Raspberry Pi - with finished initial setup
-
Raspberry Pi camera
Tools
-
PC with internet access
-
Router with internet acces (for the raspberry pi)
Procedure
Follow instructions from the video and the website link to the edurov documentation.
​
​
If you have trouble connecting to the Raspberry Pi using a Windows PC, you could try the method explained in the video below.
Disclaimer, this video is not made by eduROV, it is simply helpful to make it work.
Design files
All the code that is used to run the eduROV is of course also available open-source. We have a github repository which contains the Arduino code and the Python-script that is used. In order to see the camera feed from the ROV, we currently use screen-mirroring to view the desktop of the Raspberry Pi that is the brains of the ROV. Raspbian has VNC Server included, and all you need to do in order to view this from any computer, is to download the free VNC-Viewer.
​
You also need to install PyGame (a Python package) in order to make the script work.
VNC and ssh also needs to be activated on the Raspberry Pi.