Introduction

The installation is a two-step process: We need to setup the hardware and then we need to setup the software. The following instructions are designed to get Mikapod Soil working on the Raspberry Pi.

Setup Raspbian

Please note these instructions were made from MacOS.

Start by downloading a copy of Raspbian from the following link. It is recommended to download the Raspbian Stretch Lite version.
Open up the app Balena Etcher and write the OS image to the SD card. If you've set everything up properly, you should see something like this:
Click start and you should see something like this.
Click start and you should see something like this.
Afterwords eject the SD Card and insert it into the Raspberry Pi.
On your monitor you should see the login prompt. This means you have successfully setup Raspbian.
Login using the following credentials:
```
Username: pi
Password: raspberry
```
Once you have successfully logged in, run the following command to enable SSH daemon. You will be able to remotely log into the raspberrypi from your computer afterwords.
```
$ sudo systemctl enable ssh
$ sudo systemctl start ssh
```

Update the software.

$ sudo apt update
$ sudo apt-get upgrade
$ sudo apt-get install libssl-dev

Configure Wifi

Check to see what USB devices are connected to your Raspberry Pi.
```
$ lsusb
```

The output you would get would look something like this. From the list you should see seomthing like WLAN Adapter, this is good! This is our Wifi.

Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. RTL8192CU 802.11n WLAN Adapter
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp. SMSC9512/9514 Fast Ethernet Adapter
Bus 001 Device 002: ID 0424:9514 Standard Microsystems Corp. SMC9514 Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Next run the command to scan all the available wifi signals.
```
$ sudo iwlist wlan0 scan
```
Search through the list of sign until you find the one you are looking for and write down the details somewhere. Please look at the ESSID line to find the name of the WIFI endpoint you are using.

Next, open wpa_supplicant.conf:

$ sudo vi /etc/wpa_supplicant/wpa_supplicant.conf

Append the file with the following contents - please change to suite your needs:
```
network={
    ssid="SSID"
    psk="WIFI PASSWORD"
}
```
Wireless connectivity should start immediately; if not, use
```
$ sudo ifdown wlan0
$ sudo ifup wlan0
```
Now disconnect the ethernet cable and restart the Raspberry Pi using the following command:
```
$ sudo reboot
```
(Optional) Now while you are running on your MacOS computer, run the following code which scan all the connect computers on the network. Once the command was run, look through and find the IP address of the Raspberry Pi.
```
$ arp -a
```
This may involve random guessing, but write the following command and change the IP address until you find the correct device.
```
$ ssh -l pi 192.160.0.29
```
If you finally find the correct one, congradulations! Your Raspberry Pi now has support for wifi.

Special Thanks:

https://www.makeuseof.com/tag/setup-wi-fi-bluetooth-raspberry-pi-3/

Setup Python 3

We want to support python3.

Run the following to install the pre-requisites.

$ sudo apt-get install build-essential checkinstall
$ sudo apt-get install libreadline-gplv2-dev libssl-dev libncursesw5-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev

Download and unzip Python3.

$ cd /usr/src
$ sudo wget https://www.python.org/ftp/python/3.6.0/Python-3.6.0.tgz
$ sudo tar xzf Python-3.6.0.tgz

Compile and install Python3.

$ sudo -s
$ cd /usr/src/Python-3.6.0
$ bash configure --enable-optimizations
$ make altinstall
$ exit

Setup Third Party Libraries

Install pip for Python3.
```
$ sudo apt-get install python3-pip
```
Install git.
```
$ sudo apt install git
```
Install virtualenv.
```
$ sudo apt install virtualenv
```
Install our generic USB library.
```
$ sudo apt install libusb-1.0-0-dev
```

Added extra.

$ sudo apt-get install python3-setuptools
$ sudo apt-get install python3-dbus

Setup our application

Finally we are ready to install and setup our application!

Before you begin, make sure you are logged in as the root user over SSH and Wifi. The command to run from your OS X computer is as follows (please replace the IP address with the IP address set by your wifi-router):
```
$ ssh -l pi 192.160.0.29
```

Run the following commands to setup our script which will get our project.

$ cd ~/
$ git clone https://github.com/mikaponics/mikapod-soil-rpi.git
$ cd mikapod-soil-rpi

You are ready to install the services. All services run as independent applications and they all communicate to each other using Pyro4 RPC library. Before we setup and run our applications we need to setup the RPC Nameservice - start by setting up the nameserver. You are now ready to go to each unique application to setup and run - please read the next section titled Services.