Fuzzy IEC61850 Simulator

This simulator is a helpful tool that can be used for testing of various IED integration scenarios. It supports IEC61850 based communication and acts as a MMS server.

Simulation is meant to be run as a (docker) container, as it makes it underlying system agnostic (i.e. laptop, bare-metal, cloud, ...) and brings flexibility when scaling is required (i.e. simulating 200 IEDs).

As an input, the simulation takes a model file that is in any of the formats supported by Substation Configuration Language (SCL): ICD (IED Capability Description), CID (Configured IED Description) or IID (Instantiated IED Description). Based on this model, a runtime is generated dynamically, and simulation is commenced.

Features

Some of the features that are currently implemented (and some that are 'work in progress'):

• takes ICD, CID, and IID type of model files as input
• applies simulation logic
• configurable simulation frequency
• exposes MMS server endpoint
• configurable MMS port
• configurable logging granularity
• fuzzification/defuzzification 🚧
• TLS support 🚧
• authentication (password)
• authorization 🚧

Simulation

The simulation value is calculated based on the combination of the functions , where but with a salt of 'randomization' for each of the coefficients (, , and ) at the time of the simulation initialization, and in every simulation iteration for the time horizon parameter ().

After each time quant (determined by simulation frequency parameter) new simulation values are calculated, and following fuzzification/defuzzification steps, a random data point (from the model) is assigned a new simulation value.

Pull it

The simulation (docker) image is automaticaly build and published to (docker) repository and available under stinging/61850-sim and you get it simply by:

docker pull stinging/61850-sim

Backup/mirror repository is available under harbor.sting.dev/library/61850-sim and you get it simply by:

docker pull harbor.sting.dev/library/61850-sim

... or build it

It is also possible to do a manual build. In order to build the simulator docker image, use the following or similiar commad:

docker build -t 61850-sim .

Configure it

The behaviour of the simulator can be configured using environmental variables. The overview is given in the following table:

Environment Variable	Description	Default value
IED_NAME	Name of the IED device	IED
MMS_PORT	IEC61850 MMS server listening port	102
internal
IEC_61850_EDITION	Edition of IEC61850 (1.0, 2.0, 2.1) /respectivly 0, 1, 2/	1
MAX_MMS_CONNECTIONS	Maximum number of MMS client connections	10
MAX_DATA_POINTS	Modeling logging enabled	10000
security
AUTH_PASSWORD	Authentication password
logging
LOG_MODELING	Modeling logging enabled	false
LOG_SIMULATION	Simulation logging enabled	false
LOG_DIAGNOSTICS_INTERVAL	Diagnostics logging interval [min]	5
simulation
SIMULATION_FREQUENCY	Frequency of signal change (overall) [Hz]	1

The simulation for each individual data point can be additionally configure in coefficients configuration file:

<?xml version="1.0" encoding="UTF-8"?>
<DataPointsCoefficients>
   ...  
   <DataPoint i="<I>" name="<NAME>" type="<TYPE>">
    ...
    <Coefficient name="<COEFFICIENT>" randomness="<RANDOMNESS>"><VALUE></Coefficient>
    ...
  </DataPoint>
 ...
</DataPointsCoefficients>

where <I> is the unique identifier for the datapoint, <NAME> is name/path of the data point and <TYPE> is type; <COEFFICIENT> is a coefficient , <RANDOMNESS> is randomness factor (i.e. 0.1 (10%)) and <VALUE> is the value of the coefficient.

The coefficients configuration file is (re)generated on every run and can be exposed by mapping - see examples bellow.

Run it

In order to run the simulation use the following or similiar command:

docker run \
    -p 102:102 \
    -v <PATH_TO_SCL_FILE>:/model.cid \
    stinging/61850-sim

where <PATH_TO_SCL_FILE> is path to IED model in any of ICD, CID, or IID formats.

Examples

ABB CoreTec 4

(port 102, frequency 10Hz / 0.1s, modeling logging, simulation logging)

docker run -it --rm \
    -p 102:102 \
    -e SIMULATION_FREQUENCY=10 \
    -e LOG_MODELING=true \
    -e LOG_SIMULATION=true \
    -v $(pwd)/res/TEC.scd:/model.cid \
    stinging/61850-sim

Hitachi Energy MSM (Modular Switchgear Monitoring)

(port 55555 (on host), specific IED name 'MSM_Test_1', frequency 100Hz / 10ms, coefficient configuration)

docker run -it --rm \
    --network=host \
    -e IED_NAME=MSM_Test_1 \
    -e MMS_PORT=55555 \
    -e SIMULATION_FREQUENCY=100 \
    -v $(pwd)/res/MSM.scd:/model.cid \
    -v $(pwd)/res/MSM.config.xml:/config.xml \
    stinging/61850-sim

Schneider Electric PowerLogic ION7550

(port 1000, frequency 1kHz / 1ms, authentication with password 'abcd123', coefficient configuration)

docker run -it --rm \
    -p 1000:102 \
    -e SIMULATION_FREQUENCY=1000 \
    -e LOG_MODELING=true \
    -e AUTH_PASSWORD=abc123 \
    -v $(pwd)/res/ION.icd:/model.cid \
    -v $(pwd)/res/ION.config.xml:/config.xml:ro \
    stinging/61850-sim

Schneider Electric PowerLogic PM8000

(frequency 1Hz / 1s, simulation logging)

docker run -it --rm \
    -e SIMULATION_FREQUENCY=1 \
    -e LOG_SIMULATION=true \
    -v $(pwd)/res/PM.icd:/model.cid \
    stinging/61850-sim

As a part of docker compose:

(specific IED name 'DEV03', frequency 5Hz / 200ms, modeling logging, simulation logging, internal network and specific IP 10.10.0.201)

    iec61850-sim-node-03:
      image: stinging/61850-sim
      container_name: iec61850-sim-node-03
      tty: true
      restart: unless-stopped
      volumes:
        - /opt/61850-sim/DEV.scd:/model.cid
      environment:
        IED_NAME: DEV03
        LOG_MODELING: "true"
        LOG_SIMULATION: "true"
        SIMULATION_FREQUENCY: 5
      networks:
        iec61850-sim-net:
          ipv4_address: 10.10.0.201

Demo servers

• Schneider Electric PowerLogic PM8000

  server fuzzy-61850-sim.sting.dev

  port 1001

  (docker run -d --name=61850-sim-1001 --restart=unless-stopped -p 1001:102 -e LOG_SIMULATION=true -e SIMULATION_FREQUENCY=1 -v ~/61850-sim-res/PM.icd:/model.cid:ro stinging/61850-sim:1.0)

• Schneider Electric PowerLogic ION7550

  server fuzzy-61850-sim.sting.dev

  port 1002

  password Kr0j@c

  (docker run -d --name=61850-sim-1002 --restart=unless-stopped -p 1002:102 -e AUTH_PASSWORD=Kr0j@c -e SIMULATION_FREQUENCY=5 -v ~/61850-sim-res/ION.icd:/model.cid:ro stinging/61850-sim:1.0)

Third-party components

This code base uses libIEC61850 library. More documentation can be found online at http://libiec61850.com.

Future ideas

• introduction of FML (https://en.wikipedia.org/wiki/Fuzzy_markup_language) based simulation definition
• support for Data Sets, Reporting, ... (https://www.beanit.com/iec-61850/tutorial/)