Software Installation

Jump to bottom

Michael J. Kidd edited this page Apr 21, 2020 · 17 revisions

<< Previous: Parts List	Physical Installation :Next >>

Data usage warning

The installation of EV4RV requires several downloads, including flashing software, the base OS, all OS updates, underlying software and finally, the small amount of code that is specific to EV4RV. All in, somewhere in the neighborhood of 500mb or more may be possible. Be cautious of the download limits on your hotspot or other internet access method.

Further, some of the steps may take quite a while to complete as the download could take a considerable amount of time on slower internet links. Please be patient.

David's Software Installation Walk through

Davids Software Installation Walk through video thumbnail

Software Installation Procedure

Insert the microSD card into your computer
- You may need either a USB adapter, or a microSD to SD adapter depending on if your computer has a built in SD card reader.
- If Windows asks to format the card, just ignore it and close the dialog.
Download the following:
- Etcher from Balena
- Raspbian Lite from Raspbian Download
  Note: Currently, the Raspbian version is 'Buster', thus the download is titiled 'Raspbian Buster Lite', but this will change over time.
  - Use the 'Download ZIP' link
- If using Windows, also download Putty.exe
Install and Launch Etcher by running the downloaded etcher file
In Etcher, select the raspbian-lite zip file to flash
Ensure your microSD card is selected
Click 'Flash!' in Etcher
- Monitor and wait for the flash to complete.
Remove the microSD card, then re-insert it
If using Windows, it may prompt you to format part of the SD card, ignore it and close the format dialog.
Create two files on the 'boot' partition of the SD card:
1. First, create an empty file named 'ssh'. This enables us to connect into the Raspberry Pi over the network instead of using a monitor and keyboard.
  Note: On Windows, the easiest way to accomplish this is to open 'notepad', then click 'File' -> 'Save as', browse to the 'boot' partition and in the 'Filename' area, type "ssh" (including the double quotes), otherwise, the file will end up having a .txt extension if you do not use the double-quotes.
2. Second, create a file named wpa_supplicant.conf on the 'boot' partition of the SD card.
  - Place the following contents into the wpa_supplicant.conf file:
```
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US
network={
  ssid="Name of your WiFi"
  psk="Password for your WiFi"
}
```
  - Ensure you provide the correct WiFi network name and password in the 'ssid' and 'psk' fields respectively.
  - The WiFi network name and password must match exactly, otherwise the Raspberry Pi will not join the network.
  - Once the file is saved, close the editor
Safely remove the microSD card from your computer
Insert the microSD card into the Raspberry Pi
Power up the Raspberry Pi
After a couple of minutes, look for the Raspberry Pi on your network and write down the IP address
- The easiest method is to log into your WiFi router or Hotspot and look at the 'Clients' list.
- For Linux, Mac OS, or Windows, you may also use AngryIP Scanner software for free. Before you scan:
  - From the menu, click Tools -> Fetchers
  - Select MAC Vendor under Available fetchers
  - Then click the left arrow button between the two sections to move it under the Selected fetchers
  - Then click OK and begin the scan by clicking the green Start button.
  - After the scan completes, look for Raspberry Pi Foundation in the MAC Vendor column.

SSH to the Raspberry Pi

On Windows, launch 'Putty', and enter the IP address from step 13, and click 'Connect'
NOTE: You will be presented with a warning dialog similar to:

The server's host key is not cached in the registry. You
have no guarantee that the server is the computer you
think it is.
The server's ssh-ed25519 key fingerprint is:
ssh-ed25519 256 15:8a:1c:23:9f:7a:91:49:ea:55:3a:70:a7:01:4e:1f
If you trust this host, hit Yes to add the key to
PuTTY's cache and carry on connecting.
If you want to carry on connecting just once, without
adding the key to the cache, hit No.
If you do not trust this host, hit Cancel to abandon the
connection.

Click 'Yes' to continue.

On Linux or Mac, launch 'Terminal', then type: ssh pi@IP and press 'Enter'
- Where 'IP' is the ip from step 13 or the hostname raspberrypi.local.
  Example: ssh [email protected]
NOTE: You will be presented with a warning similar to:
```
The authenticity of host '192.168.1.5' can't be established.
ECDSA key fingerprint is SHA256:JUY+7Gasdf4aIoiLK8asdfasd4535ga.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
```
Type: yes and press 'Enter'
Use the Username: pi
Use the Password: raspberry

You should now be at a command prompt, like:

Linux raspberrypi 4.19.75+ #1270 Tue Sep 24 18:38:54 BST 2019 armv6l
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
SSH is enabled and the default password for the 'pi' user has not been changed.
This is a security risk - please login as the 'pi' user and type 'passwd' to set a new password.
pi@raspberrypi:~ $

If you used raspberrypi.local to connect to the Pi, now is the time to find the actual assigned IP address and write it down. To do so, type:
ip a s wlan0
Press 'Enter' and look for the inet line to identify the address
Example:

pi@raspberrypi:~ $ ip a s wlan0
2: wlan0:  mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
    link/ether b8:27:eb:ff:ff:ff brd ff:ff:ff:ff:ff:ff
    inet 192.168.1.5/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0
       valid_lft 1414sec preferred_lft 1234sec
    inet6 fe80::5652:5c8d:743b:c292/64 scope link 
       valid_lft forever preferred_lft forever

The IP is 192.168.1.5

Update the Raspbian OS using the following commands:
sudo apt update && sudo apt -y upgrade
Install EV4RV by copying/pasting each line below and pressing 'Enter' after each line:
```
wget https://github.com/linuxkidd/ev4rv/raw/master/Install_EV4RV_base.sh
chmod 755 Install_EV4RV_base.sh
./Install_EV4RV_base.sh
```
Note: This step will take a while and may produce warnings from time to time. Please be patient.
Once complete, wait about 3 minutes, then point your web browser to the Pi's IP address determined by step 13 (or 14).
Example: http://192.168.1.5
If all went well, after a moment, your browser should display the EV4RV screen, like this!

<< Previous: Parts List	Physical Installation :Next >>