VILLASnode/documentation/Mainpage.md

S2SS is a client server application based on UDP/IP to connect simulation equipment.

Contact

This project is developed at the Institute for Automation of Complex Power Systems (ACS) at the EON Energy Research Center (EONERC) at the RWTH University in Aachen.

• Steffen Vogel StVogel@eonerc.rwth-aachen.de
• Marija Stevic MStevic@eonerc.rwth-aachen.de

Compilation

Install libraries including developement headers for:

• libconfig

Start the compilation with:

$ make

Add V=5 for a more verbose debugging output.

Installation

Install the server by executing:

$ sudo make install

Add PREFIX=/usr/local/ to specify a non-standard installation destination.

Important: Please note that the server requires the iproute2 tools to setup the network emulation and interfaces.

Install these via:

$ sudo yum install iproute2

or:

$ sudo apt-get install iproute2

Configuration

See configuration for more information.

Usage

The S2SS server (server) expects the path to a configuration file as a single argument.

Usage: ./server CONFIG
  CONFIG is a required path to a configuration file

Simulator2Simulator Server 0.1-d7de19c (Jun  4 2014 02:50:13)
 Copyright 2014, Institute for Automation of Complex Power Systems, EONERC
   Steffen Vogel <stvogel@eonerc.rwth-aachen.de>

The server requires root privileges for:

• Enable the realtime fifo scheduler
• Increase the task priority
• Configure the network emulator (netem)
• Change the SMP affinity of threads and network interrupts

Examples

1. Start server:

   $ ./server etc/example.conf

2. Receive/dump data to file

   $ ./receive *:10200 > dump.csv

3. Replay recorded data:

   $ ./send 4 192.168.1.12:10200 < dump.csv

4. Send random generated values:

   $ ./random 1 4 100 | ./send 4 192.168.1.12:10200

5. Test ping/pong latency:

   $ ./test latency 192.168.1.12:10200