# Reliable Networking Atom (RNA)

## Network Setup

* Subnet: `10.8.0.0/24`
* Hosts:
    * Gateway: `10.8.0.1`
    * Master: `10.8.0.1`
    * Hosts: `10.8.0.10` - `10.8.0.50`

## RNA-Master Virtual Machine

### Idea

We administer the network using a master-machine, which includes DHCP, DNS and a SaltStack master.

The virtual machine is bridged to the physical interface where the hosts are attached to.

### Usage
* Start using `vagrant up`.

### Deploying Files

* Execute e.g. `salt '*' state.sls video.deploy`.
* Make sure to run `salt-run fileserver.clear_file_list_cache()` if files are not found.

### States

#### Common

##### WLAN

* Execute `common.wlan` to setup wireless LAN on the RNAs. The devices automatically connect to the LARN network.
* Check for present WLAN networks: `sudo iwlist wlan0 scan | grep ESSID`

#### Demo

* Execute `demo.control` to deploy the control demo.
* Execute `demo.video` to deploy the video demo.

#### Gstreamer

Gstreamer is installed from the sources, which are fetched from GitHub. We are using `gst-uninstalled`, a environment system much as virtualenv for Python. As we are using many different gstreamer elements, we build all plugins together with Gstreamer.

#### Video

Contains everything for the video demonstrations.

* `video.apps` (Gstreamer application, featuring a fully synced split-screen).
* `video.deploy` (Sets up everything for demonstrations).
* `video` (Create directory, copy files, build PRRT, plugin etc.).
* `video.scripts` (Copies scripts for send/recv the demonstration streams).
* `video.videos` (Copies all video files to the host).

## Odroid

### Images

* Images are built based on `ubuntu-16.04.2-minimal-odroid-xu4-20170516.img`.
* The latest image can be found under "Pipelines."
* Deploy image on eMMC module.

### Initial Setup

* The RNA comes with SaltStack and SSH installed.
* You can login using the `rna` user with the same password.
* Upon first startup:
  * Make sure that the hostname is updated (edit `/etc/hostname`) and the Salt `minion_id` is set appropriately (edit `/etc/salt/minion_id`).
  * Enter root mode with `sudo -i`
  * Run `salt-call test.ping` once.
  * Inside the RNA-Master, accept the key using `salt-key -L` and afterwards `salt-key -a` for the specific key.
* Afterwards, the system can be administered from the RNA-Master.


### eMMC Recovery

1. Flash emmc_recovery.img to a MicroSD card.
2. Connect both the eMMC and MicroSD to XU4.
3. Set the dip-switchs near the ethernet Jack to "SD boot mode".
4. Connect Power and watch the LED status
5. One the Blue led goes out and only RED is on. This may take 40seconds ~ 3minutes. And remove the power supply.
6. Set the dip switchs back to eMMC.
7. Remove the microSD card.
8. Proceed with normal power up with your peripherals attached.
9. After checking the eMMC, you can install other Linux OS images on the eMMC later.