mirror of
https://git.rwth-aachen.de/acs/public/villas/node/
synced 2025-03-23 00:00:01 +01:00
Steffen Vogel
5dbd9667ee
git-svn-id: https://zerberus.eonerc.rwth-aachen.de:8443/svn/s2ss/trunk@121 8ec27952-4edc-4aab-86aa-e87bb2611832
83 lines
2 KiB
Markdown
83 lines
2 KiB
Markdown
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](www.acs.eonerc.rwth-aachen.de) (ACS) at the EON Energy Research Center (EONERC) at the [RWTH University](http://www.rwth-aachen.de) 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](http://www.linuxfoundation.org/collaborate/workgroups/networking/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](Configuration.md) 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
|