mlegner / adrians-scionlab-apps

Software for supporting SCIONLab

scionlab

This repo contains software for supporting SCIONLab.

The repo currently contains two applications: camerapp and sensorapp. Both applications are written in Go, with some supporting code in Python. A SCION Internet connection (for instance via SCIONLab) is required to run these applications.

More information on SCION, and tutorials on how to set up SCION and SCIONLab.

---

camerapp

Camerapp contains image fetcher and server applications, using the SCION network. Documentation on the code is available in the README.md

imagefetcher

To install imagefetcher:

go get github.com/perrig/scionlab/camerapp/imagefetcher

To use the image fetcher, you will need to express your local host's address as a SCION address (in the format ISD-AS,[IPv4]:port) and know the address of an image server, for instance 1-1011,[192.33.93.166]:42002

The client address is passed with -c and the server address with -s:

imagefetcher -s 1-1011,[192.33.93.166]:42002 -c 1-1006,[10.0.2.15]:42001

The fetched image is then saved in the local directory.

imageserver

To install imageserver:

go get github.com/perrig/scionlab/camerapp/imageserver

The imageserver application keeps looking for .jpg files in the current directory, and offers them for download to clients on the SCION network. The assumption is that the application is used in conjunction with an application that periodically writes an image to the file system. After an amount of time (currently 10 minutes), the image files are deleted to limit the amount of storage needed.

Included is a simple paparazzi.py application, which reads the camera image on a Raspberry Pi. The system is launched as follows:

python3 ${GOPATH}/src/github.com/perrig/scionlab/camerapp/imageserver/paparazzi.py > /dev/null &
imageserver -s 1-1011,[192.33.93.166]:42002 &

---

sensorapp

Sensorapp contains fetcher and server applications for sensor readings, using the SCION network.

sensorfetcher

To install sensorfetcher:

go get github.com/perrig/scionlab/sensorapp/sensorfetcher

The sensorfetcher application sends a 0-length SCION UDP packet to the sensorserver application to fetch the sensor readings. A string is returned containing all the sensor readings. To keep the application as simple as possible, no reliability is built in -- in case of packet loss, the user needs to abort and re-try. An example server is at 1-6,[192.33.93.173]:42003, its readings can be fetched as follows (need to replace client address with actual client address, with an arbitrary free port):

sensorfetcher -s 1-6,[192.33.93.173]:42003 -c 1-1006,[10.0.2.15]:42001

sensorserver

To install sensorserver:

go get github.com/perrig/scionlab/sensorapp/sensorserver

We use sensors from Tinkerforge, and the sensorreader.py Python application fetches the sensor values and writes them to stdout. The sensorserver application collects the readings, and serves them as a string to client requests. To start, we use the following command:

python3 ${GOPATH}/src/github.com/perrig/scionlab/sensorapp/sensorserver/sensorreader.py | sensorserver -s 1-6,[192.33.93.173]:42003 &

---

bwtester

The bandwidth testing application bwtester enables a variety of bandwidth tests on the SCION network. Installation and usage are described below. Documentation of the code and protocol are described in the bwtester's README.md.

bwtestclient

To install bwtestclient:

go get github.com/perrig/scionlab/bwtester/bwtestclient

bwtestserver

To install bwtestserver:

go get github.com/perrig/scionlab/bwtester/bwtestserver

---