README.md

sv-pcap-generator

sv-pcap-generator is a tool used to generate IEC61850 Sample Values PCAP (Packet Capture) files. You can then replicate IEC61850 SV trafic on a network using tools such as bittwist or tcpreplay.

Table of Contents

• Introduction
• Features
• Installation
• Usage
• Release notes

Introduction

Features

• Generation of SV PCAP files along various IEC61850 parameters (frequency, appid, number of streams, etc)
• IEC61850 compliant pacing (250µs for 50Hz electrical network, 208µs for 60Hz electrical network)
• Supports pcap loopback to make longer trafic generation

Installation

Requirements

Following Python packages are needed:

pip install numpy

To run merge_pcap script, wireshark package is needed.

Usage

To generate a IEC61850 SV pcap on 8 streams, with 4000 SV for each streams, for a 50Hz electrical network, run:

python3 generate_pcap.py -n 8 -l 4000 -f 50 output.pcap

Optionally, you can run merge_sv_pcap.py script to merged multiple SV pcap file. This is useful to generate discontinuity to test electrical lines protections.

To do so, run:

./merge_sv_pcap.py 1.pcap 2.pcap 3.pcap -o merged.pcap -f 50

The merge_sv_pcap.py can be also used to repeat a pcap multiple time with -n argument

./merge_sv_pcap.py my_sv_recored.pcap -o 10_interations.pcap -n 10 -f 50

In both case a delay between the merged pcap is inserted base on the current frequency.

Release notes

Version v0.1

• Initial release

Version v1.0.0

• Rewrite merge_pcap in Python
• Improve merge_pcap to support multiple pcap with different duration
• Add VLAN ID, Priority and MAC addresses options