TSN Reservation Protocol

This repository contains the implementation of a minimalistic reservation protocol for real-time network streams in non-TSN networks. Included are APIs for the talker- and listeners in such an environment, as well as a controller script that implements the protocol on an OpenFlow-supporting network switch (NEC PF5420). Whereas the APIs are of a generic nature, the controller script is, in large parts, adapted to that particular switch's telnet control interface.

The foundation upon which this protocol has been created is the paper Technical report on bridge-local guaranteed latency with strict priority scheduling by Grigorjew et al., which presents the theoretical model that allows for the deployment of real-time network streams without global knowledge of the network.

An evaluation of this protocol in a hardware testbed has been made with the talker-, listener- and controller software each running on a seperate Raspberry Pi 3B device. The scripts used for generating measurements, their preprocessing and visualization are also included in this repository in the evaluation directory.

Requirements

• PyYAML for parsing the talker configuration file
• ryu framework used to interface with the OpenFlow switch
• scapy used for implementing the custom data plane protocol

Usage

Talker

python src/run_talker.py [-h] [--iface IFACE] [--ip IP]
                         [--broadcast-ip BROADCAST_IP] [--mac MAC]
                         [--stream-file STREAM_FILE] [--timeout TIMEOUT]
                         [--resends RESENDS] [--load-test LOAD_TEST]

optional arguments:
  --iface IFACE         The interface from which to send the requests from
  --ip IP               Source IP address to put into advertisements
  --broadcast-ip BROADCAST_IP
                        The Broadcast IPv4 address of the used subnet.
  --mac MAC             Source MAC address to put into advertisements
  --stream-file STREAM_FILE
                        Path to .yaml with stream specifications
  --timeout TIMEOUT     The time in seconds until an advertisement is resent
  --resends RESENDS     The number of times an advertisement would be resent
  --load-test LOAD_TEST
                        Use this to send n advertisements for random port-
                        combinations of the given streams

Listener

python src/run_listener.py [--iface IFACE] [--ip IP] [--mac MAC]

optional arguments:
  --iface IFACE  The interfaceo on which to listen for Advertisements
  --ip IP        The IP address to set as the destination address in
                 subscriptions
  --mac MAC      The MAC address used as the MAC source address in answers

SDN-Controller

ryu-manager src/controller.py