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 contains image fetcher and server applications, using the SCION network. Documentation on the code is available in the README.md
To install imagefetcher:
go get github.com/perrig/scionlab/camerapp/imagefetcherTo 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]:42001The fetched image is then saved in the local directory.
To install imageserver:
go get github.com/perrig/scionlab/camerapp/imageserverThe 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 contains fetcher and server applications for sensor readings, using the SCION network.
To install sensorfetcher:
go get github.com/perrig/scionlab/sensorapp/sensorfetcherThe 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]:42001To install sensorserver:
go get github.com/perrig/scionlab/sensorapp/sensorserverWe 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 &If you do not have any sensors information you can report, then you can use a simple time application that reports the current time on your system:
python3 ${GOPATH}/src/github.com/perrig/scionlab/sensorapp/sensorserver/timereader.py | sensorserver -s 1-6,[192.33.93.173]:42003 &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.
To install bwtestclient:
go get github.com/perrig/scionlab/bwtester/bwtestclientYou can test the application as follows, replacing the client address with your own address after the -c option (you can select any available port number for the client):
bwtestclient -s 1-6,[192.33.93.173]:30100 -c 1-1006,[10.0.2.15]:30102The application supports specification of the test duration (up to 10 seconds), the packet size to be used (at least 4 bytes), and the total number of packets that will be sent. For instance, 5,100,10 specifies that 10 packets of size 100 bytes will be sent over 5 seconds. The parameters for the test in the client-to-server direction are specified with -cs, and the server-to-client direction with -sc. So for instance to send 1 Mbps for 10 seconds from the client to the server, and 10 Mbps from the server to the client, you can use this command:
bwtestclient -s 1-6,[192.33.93.173]:30100 -c 1-1006,[10.0.2.15]:30102 -cs 10,1000,1250 -sc 10,1000,12500To install bwtestserver:
go get github.com/perrig/scionlab/bwtester/bwtestserverThe server is started as follows, where the address needs to be adjusted as for other applications:
bwtestserver -s 1-6,[192.33.93.173]:30100 &