Lab-SCADA IEC 60870-5-104 Master Simulator User Manuallab-scada.com/iec104_master_simulator_manual.pdfLab-SCADA IEC 60870-5-104 Master Simulator User Manual 2 Licensing 2.1 Evaluation

Lab-SCADA IEC 60870-5-104 Master Simulator User Manual

Lab-SCADA IEC 60870-5-104

Master Simulator

User Manual

Version 1.0214 September 2020

Table of Contents 1 Introduction........................................................................................................................3

1.1 Contact Information....................................................................................................3 1.2 Change History...........................................................................................................3 1.3 Terms and Abbreviations............................................................................................3 1.4 References..................................................................................................................3

2 Licensing............................................................................................................................5 2.1 Evaluation Mode and Full Mode.................................................................................5 2.2 Setting License Key....................................................................................................5 2.3 Software License Agreement......................................................................................6

3 Functional Description.......................................................................................................9 3.1 Overview.....................................................................................................................9 3.2 Features and Limitations............................................................................................9

3.2.1 Features..............................................................................................................9 3.2.2 Limitations.........................................................................................................10

4 Installation........................................................................................................................11 4.1 System Requirements...............................................................................................11

4.1.1 Requirements for Linux Daemon application (iec104msd)...............................11 4.1.2 Requirements for Windows version of iec104msd............................................11 4.1.3 Requirements for GUI control program (ls104msgui.exe).................................11

4.2 Delivery (release) Content........................................................................................11 4.3 Installation Procedure...............................................................................................11

5 Configuration....................................................................................................................13 5.1 Configuration File Structure and Example File.........................................................13 5.2 Description of Main Configuration Parameters.........................................................14 5.3 Description of Link Configuration Parameters..........................................................14 5.4 Using Linux utility iec104m_ui for Link Configuration...............................................17

5.4.1 Creating a new IEC104 link...............................................................................17 5.4.2 Deleting an IEC104 link.....................................................................................17 5.4.3 Modifying an IEC104 link...................................................................................17 5.4.4 Showing configured IEC104 links.....................................................................17

Sirius Network Software Page 1

http://www.sirius-sys.comhttp://www.lab-scada.com

[email protected]@lab-scada.com

http://www.sirius-sys.com/

http://www.lab-scada.com/

mailto:[email protected]



5.5 Using Windows GUI lsiec104msgui.exe for Link Configuration...............................18 5.5.1 Creating a new IEC104 link...............................................................................18 5.5.2 Deleting a IEC104 link.......................................................................................19 5.5.3 Modifying an IEC104 link...................................................................................20 5.5.4 Showing configured IEC104 links.....................................................................20

6 Operation.........................................................................................................................21 6.1 Overview...................................................................................................................21

6.1.1 Clock Synchronization.......................................................................................21 6.1.2 General Interrogation........................................................................................21 6.1.3 Test Procedure..................................................................................................22 6.1.4 Data and Event Acquisition...............................................................................22 6.1.5 Transmission of Commands..............................................................................22

6.2 Windows GUI Porgram.............................................................................................23 6.2.1 Connecting to iec104msd..................................................................................24 6.2.2 IEC104 Link Management.................................................................................24 6.2.3 IEC104 Outstation Data Points View................................................................24 6.2.4 IEC104 Commands View..................................................................................25 6.2.5 System Log View...............................................................................................25 6.2.6 IEC104 Statistics View......................................................................................27

6.3 Command Line Interface..........................................................................................28 6.3.1 Starting iec104msd............................................................................................28 6.3.2 Stopping iec104msd..........................................................................................28 6.3.3 Checking the software version..........................................................................28 6.3.4 IEC104 Link Configuration................................................................................28 6.3.5 Starting and Stopping IEC104 Links.................................................................28 6.3.6 Starting Clock Synchronization Procedure.......................................................28 6.3.7 Starting General Interrogation Procedure.........................................................29 6.3.8 Starting Test Procedure.....................................................................................29 6.3.9 Sending Read Command..................................................................................29 6.3.10 Sending Reset Process Command.................................................................29 6.3.11 Sending Digital Output Command...................................................................29 6.3.12 Sending Analog Output Command..................................................................30 6.3.13 Viewing System Log........................................................................................31



1 Introduction

1.1 Contact InformationDeveloped by Sirius Network Softwarehttp://[email protected]

Product description on the web: http://www.lab-scada/index.html

1.2 Change History

Date Revision Comment

02.08.20 “1.00” Initial version

30.08.20 “1.01” Minor proofing

14.09.20 “1.02” Added Description of Windows based server core – iec104msd.exe

1.3 Terms and Abbreviations

ASDU – Application Serivice Data Unit

CA – Common Address

GUI – Graphical User Interface

IEC - International Electrotechnical Commission

IOA – Information Object Address

IP – Internet Protocol

OA – Originator Address

RTU – Remote Terminal Unit

SCADA - Supervisory Control And Data Acquisition

SSH – Secure Shell Protocol

TCP – Transmission Control Protocol

UI – User Interface

1.4 References

[1] International Standard IEC 60870-5-104, second edition 2006-06. Telecontrol equipment and systems – Part 5-104: Transmission protocols – Network access for IEC 60870-5-101 using standard transport profiles

[2] International Standard IEC 60870-5-5, first edition 1995-06, Telecontrol equipment andsystems - Part 5: Transmission protocols - Section 5: Basic application functions


http://www.lab-scada.com/

http://www.lab-scada/index.html



[3] International Standard IEC 60870-5-101, Telecontrol equipment and systems – Part 5-101: Transmission protocols – Companion standard for basic telecontrol tasks



2 Licensing

2.1 Evaluation Mode and Full Mode

If you have not yet purchased the software, the iec104msd runs in evaluation mode, in which it will transfer a maximum of 20 IEC104 application layer messages before closing all IEC104 sessions.

You can set the license key and switch into full mode at any time either via GUI control application or using Linux command line utility iec104m_ui as explained in the following section.

2.2 Setting License Key

Using Windows GUI application:

Run ls104msgui.exe (From Start menu or directly from installation folder). Click “Connect” button. After the connection to iec104msd is established click “Set License Key” button., you will see the following dialog window:

Using Linux command line utility iec104m_ui, execute:

iec104m_ui show license

License ID: 7b1a963a867b1a94d1c61019a43449b5

Copy the LICENSE ID value from the GUI dialog window or from the terminal, Contact Sirius Network Software ([email protected]) and communicate the LICENSE ID value.

Sirius Network Software will issue you a License Key. If using GUI, Enter the received License key in the above dialog box in the file LICENSE KEY and click button “Set Key”. If using Linux command line, execute:

iec104m_ui set license key=<license key>




2.3 Software License Agreement

READ THIS BEFORE INSTALLING THE SOFTWARE AND BEFORE ACCEPTING THE LICENSE AGREEMENT

THIS SOFTWARE LICENSE AGREEMENT IS BEING PROVIDED TO YOU AS PART OF A TRIAL FOR REVIEW BEFORE PURCHASE. THE FOLLOWING LICENSE AGREEMENT IS A CLICKTHROUGH LICENSE AGREEMENT THAT IS SHOWN DURINGTHE INSTALLATION OF THE SOFTWARE. YOU MUST AGREE TO ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT IN ORDER TO INSTALL THE SOFTWARE.

THEREFORE, IF YOU DO NOT AGREE TO ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT, DO NOT INSTALL THE SOFTWARE.

Sirius Network Software. License Agreement

THIS IS A LEGAL AGREEMENT BETWEEN YOU (“YOU”) AND SIRIUS NETWORK SOFTWARE. SIRIUS NETWORK SOFTWARE IS WILLING TO LICENSE THE

SIRIUS NETWORK SOFTWARE SOFTWARE AND RELATED DOCUMENTATION PURCHASED BY YOU AND KNOWN AS LAB-SCADA IEC 60870-5-104 MASTER SIMULATOR (THE “SOFTWARE”) TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS LICENSE AGREEMENT (THE "AGREEMENT"). PLEASE READ THE TERMS AND CONDITIONS CAREFULLY BEFORE CLICKING ON THE “I AGREE” BUTTON, AS CLICKING ON THIS BUTTON

WILL INDICATE YOUR ASSENT TO THEM. IF YOU DO NOT AGREE TO THE BELOW TERMS AND CONDITIONS, THEN CLICK ON THE “I DO NOT AGREE” BUTTON. IF YOU DO NOT AGREE TO THE BELOW TERMS AND CONDITIONS, SIRIUS NETWORKSOFTWARE IS UNWILLING TO LICENSE THE SOFTWARE TO YOU.

1. Subject to the following terms and conditions, SIRIUS NETWORK SOFTWARE grants to you a nonexclusive, nontransferable limited license to install and use the Software solely for your internal business purposes and subject to the limitations in

this Agreement.

You are entitled to install and use server part of the Software (iec104msd Linux daemon oriec104msd.exe application) on a single server computer only.

You may install the Windows GUI controlling application ls104msgui.exe on any number ofcomputers.

2. You may not transfer the Software to another entity or person. You shall not modify, translate, reverse assemble or reverse compile in whole or in part the Software. You shall not rent, sell, time-share, lease, sublicense, transfer, copy, disclose, display or otherwise make available the Software or copies thereof to others, except as provided herein. Any

breach of the above terms and conditions shall immediately terminate your license under this Agreement.



3. You may not erase, delete or modify any copyright, trademark or other proprietary notices included on the Software.

You agree that if you infringe SIRIUS NETWORK SOFTWARE intellectual property rights or exceed the scope of permitted use of this license, SIRIUS NETWORK SOFTWARE will be irreparably injured and may obtain a court order to enjoin you from further use of the Software.

4. This license is not a sale. Title, ownership rights, and intellectual property rights in and to the Software shall remain in SIRIUS NETWORK SOFTWARE. You agree to abide by the copyright laws and all other applicable laws of the Republic of Ireland and the European Union and international treaties. You acknowledge that the Software in source code form remains a confidential trade secret of SIRIUS NETWORK SOFTWARE. Failure to comply with the above restrictions will result in automatic termination of this Agreement and will make available to SIRIUS NETWORK SOFTWARE other legal remedies.

5. Notwithstanding anything herein to the contrary, you acknowledge and agree that SIRIUS NETWORK SOFTWARE may terminate your license to the Software if you have failed to comply with any of your obligations under this Agreement.

You shall not be entitled to a refund in the event of termination by SIRIUS NETWORK SOFTWARE pursuant the foregoing sentence.

6. The Software is distributed "AS IS" and you assume full responsibility for determining the suitability of The Software and for results obtained.

Sirius Network Software makes no warranty that all errors have been or can be eliminated from the Software and, with respect thereto, Sirius Network Software shall not be responsible for losses, damages, costs, or expenses of any kind resulting from using or misusing The Software including without limitation, any liability for business expenses, machine downtime, damages experienced by you or any third person as a result of any deficiency, defect, bug, error or malfunction. Sirius Network Software shall not be liable for any indirect, special, incidental, or consequential damages relating to or arising out of the subject matter of this notice or actions taken thereunder

NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE THE SOFTWARE AT YOUR OWN RISK. Sirius Network Software DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. NOBODY WILL BELIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.

7. You may terminate the license granted under this Agreement at any time by destroying or deleting all copies of the Software in your possession or control. In the event of termination of this Agreement for any reason, all the sections of this Agreement will surviveexcept for Sections 1 and 2.

8. This Agreement shall be governed by and construed in accordance with the laws of the Republic of Ireland, without regard to the choice of law provisions thereof.

9. This Agreement sets forth the entire agreement between you and SIRIUS NETWORK SOFTWARE pertaining to the licensing of the Software and supersedes in its entirety any and all written or oral agreements previously existing between the parties with respect to



such subject matter. If any provision of this Agreement is held invalid or unenforceable, such provision shall be revised to the extent necessary to cure the invalidity or unenforceability, and the remainder of this

Agreement shall continue in full force and effect. In the event of any conflict between any provision of this Agreement and any applicable law, the provision or provisions of this Agreement affected shall be modified to remove such

conflict and permit compliance with such law and as so modified this Agreement shall continue in full force and effect.

This Agreement may not be assigned without the consent of SIRIUS NETWORK SOFTWARE.



3 Functional Description

3.1 Overview

Lab-SCADA IEC104 Master Simulator implements master station role of the IEC 60870-5-104 communication protocol [1].

The software consists of the following components:

Component Description

iec104msd Server daemon application for Linux OS, implements the core communication services of the IEC 60870-5-104 Master station protocol

Iec104msd.exe Windows console style application which implements the same functionality as Linux based iec104msd daemon.

iec104m_ui Command line UI front end for Linux OS, used for communicating to the Linux iec104msd daemon application

ls104msgui.exe GUI control application for Windows OS, used for communicating to the iec104msd application (either Linux daemon or Windows iec104msd.exe)

The Linux iec104msd server application can be configured and operated using either the Linux command line interface (iec104m_ui) or the Windows GUI program (ls104msgui.exe).

The Windows version of iec104msd server application (iec104msd.exe) can be configuredvia the same Windows GUI program (ls104msgui.exe).

3.2 Features and Limitations

3.2.1 Features

• Implements IEC 60870-5-104 [1] Master Station communication protocol and Application Functions (IEC 60870-5-5) [2]

◦ Station initialization

◦ Clock Synchronization

◦ Test Procedure

◦ Data Acquisition

◦ Acquisition of Events

◦ Cyclic Data Transmission



◦ General Interrogation

◦ Command Transmission

◦ Transmission of Integrated Totals

◦ Parameter Loading

• Support for simultaneous communication to multiple remote slaves (IEC 104 controlled stations).

◦ Linux version of iec104msd : Up to 65534 sessions are supported concurrently, depending on available memory and system configuration.

◦ Windows version of iec104msd (iec104msd.exe) Up to 60 sessions are supported concurrently.

• User Interface

◦ Windows GUI control program

◦ Linux command line front end (for Linux version of iec104msd)

◦ On-the-fly configuration of link parameters (no applicatoin restart needed): Adding, Removing, Modifying link properties

◦ Built-in protocol analyzer / Protocol Trace

◦ Extensive logging with configurable severity

◦ Protocol / communication statistic counters

3.2.2 Limitations

The Linux version of Lab-SCADA IEC 60870-5-104 Master Simulator is capable of supporting up to 65534 sessions to remote controlled stations at the same time, however the exact number of sessions possible is limited by the amount of RAM installed in host server.

The follwing table gives estimated memory requirements by the number of concurrent connections:

Number of remote IEC 104 stations Amount of RAM used by iec104msd

1000 ~0,5 GB

10000 ~5GB

65534 ~32GB

The Windows version of iec104msd (iec104msd.exe) supports a maximum of 60 sessions at the same time.



4 Installation

4.1 System Requirements

4.1.1 Requirements for Linux Daemon application (iec104msd)

• Linux server OS (Debian / Ubuntu 14.04, 16.04, 18.04)

• RAM: See Section 3.2.2 (Limitations)

4.1.2 Requirements for Windows version of iec104msd

• Windows 7 and later.

4.1.3 Requirements for GUI control program (ls104msgui.exe)

• Windows 7 and later.

4.2 Delivery (release) Content

The Lab-SCADA IEC 60870-5-104 Master simulator is delievered as an installation executable: lab-scada-iec104ms_setup.exe containing the following files:

• iec104msd-x.x.x.deb – Debian package (x.x.x is the release version number) for installation onto Linux server.

• ls104msgui.exe – Windows based GUI control program for managing the iec104msd daemon server application

• iec104msd.exe – Windows version of the iec104msd daemon.

• iec104_master_simulator_manual.pdf – this user manual

4.3 Installation Procedure

1. Download lab-scada-iec104ms_setup.exe to your Windows PC.

2. Run the installation program lab-scada-iec104ms_setup.exe

3. During the installaiton, read and accept the Software License Agreement and click Next. At the end of installation, click “Finish”.

4. By default, the release delivery files are installed in c:\Lab-SCADA-Iec104Ms

5. The Windows version of iec104msd (iec104msd.exe) is automatically installed into installation folder (see item 4) By default iec104msd.exe starts automatically when the GUI application is started.

6. To install the Linux version of iec104msd go to the installation folder (see above). Copy / transfer file iec104msd-x.x.x.deb to your Linux server PC.

7. Go to / Log in to your Linux server PC. To install or upgrade the iec104msd server



application use dpkg utility as follows (use sudo before the command or run as root):

8. dpkg -i iec104msd-x.x.x.deb

As a result of completed installation:

• Executable file iec104msd is then located in /usr/sbin

• Executable file iec104m_ui is located in /usr/bin

• Configuration files are located in /etc/iec104msd

• The user manual is also located in /etc/iec104msd

The installation process writes data to cron.d so that the iec104msd starts automatically onboot. To start iec104msd manually after installation, execute as root:

/usr/sbin/iec104msd /etc/iec104msd/iec104msd.cfg

Check that iec104msd is running:

iec104m_ui show version

IEC104MSD ver: 1.0.0, Tue Jul 28 15:58:51 UTC 2020, Copyright (C) 2020 Sirius Network Software

IEC104M Library Version: 1.0.0

Check connectivity between the Windows control GUI application and the iec104msd:

Run ls104msgui.exe (From Start menu or directly from installation folder). Click “Connect” button.

You will see dialog box “Connect to LabScada IEC104 Master”.

Enter the IP address of your Linux server on which the iec104msd is running and specify the TCP port number configured for GUI access in the iec104msd configuration (by defaultport 3344).

To connect to the locally running Windows version of iec104msd (iec104msd.exe) specify remote IP address 127.0.0.1.

Click “Connect”. Connection to iec104msd should get established. You can then manage the IEC104 links and perform other control tasks.



5 ConfigurationThe configuration file of iec104msd Linux daemon application is located at /etc/iec104msd/iec104msd.cfg

Configuration is possible in one of the following ways:

• Open configuration file with any text editor (e.g, nano or vi), change the settings, save and restart iec104msd

• Change configuration using command line front end utility iec104m_ui. In this case, no application restart is needed. Using this method it is possible to add, remove andchange parameters of IEC104 links.

• Change configuration using Windows control GUI program lsiec104msgui.exe. This is equivalent to using the Linux command line iec104m_ui. No application restart is needed.

To configure the Windows version of iec104msd (iec104msd.exe) either edit the configuration file iec104msd.cfg located at c:\Lab-SCADA-Iec104ms or use GUI control application for configuration.

5.1 Configuration File Structure and Example File

The configuration file is a text file having the following general structure:

<main parameters>

<link ca=x [link parameters]>

<link ca=y [link parameters]>

<link ca=z [link parameters]>

….

<link ca=z+i [link parameters]>

ca tag identifies the Common ASDU address of remote IEC104 controlled station.

The links can be specified in any other of CA values

All tag/values belonging to the same link definition must remain on the same line.

The following gives an example of configuration file, defining five IEC 60870-5-104 links. Note that all link parameters are in fact located on the same line. Line is terminated with CR/LF or LF. Here lines are shown broken due to page space limitation:

netui_port=3344

key=c3a5e2c0afd60bcaf49365b098acd24976c7a212

link ca=65 oa=1 name=test0 locip1=0.0.0.0 locip2=0.0.0.0 remip1=1.2.3.4 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600



gi_sec=3600 ts_sec=0 dbgf=0x01 loglevel=0

link ca=2 oa=0 name=Test1 locip1=0.0.0.0 locip2=0.0.0.0 remip1=10.100.235.38 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600 gi_sec=3600 ts_sec=3000 dbgf=0x01 loglevel=7

link ca=28 oa=0 name=Test2 locip1=0.0.0.0 locip2=0.0.0.0 remip1=192.168.0.28 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600 gi_sec=3600 ts_sec=0 dbgf=0x09 loglevel=7

link ca=66 oa=1 name=Test-3 locip1=0.0.0.0 locip2=0.0.0.0 remip1=1.2.3.9 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600 gi_sec=3600 ts_sec=0 dbgf=0x01 loglevel=0

5.2 Description of Main Configuration Parameters

Tag name Type and Range Default Description

netui_port Integer (1..65535)

3344 TCP port number on which the iec104msd daemon listens for connection from Window GUI control application lsiec104msgui.exe.

key Hexadecimal string, 40 characters

none When the software is licensed, thisparameter holds the license key given to the customer after the purchase.

5.3 Description of Link Configuration Parameters

Tag name Type and Range Default Description

ca Integer (1..65534)

none ASDU CA (common address) of the remote IEC104 controlled station

oa Integer (0..255) 0 Originator address

name String (max 15 chars)

none Descriptive name of remote IEC104 controlled station

locip1 IPv4 address string

“0.0.0.0” Local IP address used by first link in the redundancy group

locip2 IPv4 address string

“0.0.0.0” Local IP address used by second link in the redundancy group

remip1 IPv4 address string

“0.0.0.0” IP address of remote IEC104 controlled station for first link of redundancy group

remport1 Integer 2404 TCP port number of remote



(1..65535) IEC104 controlled station for first link of redundancy group

remip2 IPv4 address string

IP address of remote IEC104 controlled station for second link ofredundancy group

remport2 Integer (1..65535)

2404 TCP port number of remote IEC104 controlled station for second link of redundancy group

k Integer (1..32767)

12 IEC104 K parameter

(Maximum number of

outstanding I format

APDUs), number of frames

w Integer (1..32767)

9 IEC104 W parameter(Receiver acknowledges sender frames after at most W frames), number of frames

t0 Integer(1..255)

30 IEC104 T0 parameter

t1 Integer(1..255)


t2 Integer(1..255)


t3 Integer (1..172800)


cs_sec Integer(0..4294967295)

3600 IEC104 Clock Synchronization procedure period seconds

gi_sec Integer(0..4294967295)

3600 IEC104 General Interrogation procedure period seconds

ts_sec Integer(0..4294967295)

30 IEC104 Test procedure period seconds

dbgf Hexadecimal Integer(0x00..0xff)

0x00 Debugging and Logging flags0x01 – Protocol Tracing0x02 – Dump of packet content0x04 – Extended debug info

loglevel Integer (0..7) 5 Logging level:0-Emergency1-Alert2-Critical3-Error4-Warning



5-Notice6-Info7-Debug



5.4 Using Linux utility iec104m_ui for Link Configuration

To manage IEC104 link configuration using Linux command line front end, execute the commands described below while iec104msd is running. The changes take effect immediately, daemon restart is not required. The changes are saved automatically to the configuration file

5.4.1 Creating a new IEC104 link

iec104m_ui add link - add link ca=<ASDU CA> [link parameters, see table below]

See “5.3 Description of Link Configuration Parameters” where each possible link parameter is explained.

Example:

iec104m_ui add link ca=695 oa=1 name=test332 locip1=0.0.0.0 locip2=0.0.0.0 remip1=1.2.3.239 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600 gi_sec=3600 ts_sec=30 dbgf=0x01 logLevel=7

IEC104 session CA=695: Add OK

5.4.2 Deleting an IEC104 link

iec104m_ui delete link - delete link ca=<ASDU CA>


Example:

iec104m_ui delete link ca=65531

5.4.3 Modifying an IEC104 link

iec104m_ui update link - add link ca=<ASDU CA> [link parameters, see table below]


Example:

iec104m_ui update link ca=66 oa=1 name=test-3 locip1=0.0.0.0 locip2=0.0.0.0 remip1=1.2.3.9 remport1=2404 remip2=0.0.0.0 remport2=2404 k=12 w=8 t0=30 t1=15 t2=10 t3=20 cs_sec=3600 gi_sec=3600 ts_sec=0 dbgf=0x01 logLevel=7

5.4.4 Showing configured IEC104 links

iec104m_ui show links - show IEC104 sessions



/iec104m_ui show links

IEC104 links:

==================

link# 1: ca= 695, name= test332, remip1= 1.2.3.239: 2404, remip2= 0.0.0.0: 2404 - DOWN

link# 2: ca= 66, name= test-3, remip1= 1.2.3.9: 2404, remip2= 0.0.0.0: 2404 - DOWN

link# 3: ca= 28, name= test-4, remip1= 192.168.0.28: 2404, remip2= 0.0.0.0: 2404 - UP



5.5 Using Windows GUI lsiec104msgui.exe for Link Configuration

You can perform IEC104 master link management from within Windows GUI application while connected to the iec104msd Linux daemon as shown in the following sections.

5.5.1 Creating a new IEC104 link

To add a new link, set new ASDU CA field, fill in other link parameters on the right and click“Add NEW” button.



5.5.2 Deleting a IEC104 link

To delete an existing link, select a link in the “IEC104 Master Sessions” view, then click “Delete” button.



5.5.3 Modifying an IEC104 link

To change existing link parameters, select a link in the “IEC104 Master Sessions” view, then change the required link parameters on the right of the view, then click “Update Cfg”

5.5.4 Showing configured IEC104 links

While connected to the iec104msd Linux daemon all configured IEC104 links are shown inthe “IEC104 Master Sessions” view



6 Operation

6.1 Overview

iec104msd is a server application that runs on a Linux server and acts as an IEC 60870-5-104 Master station simulator supporting simultaneous independent IEC 104 sessions over TCP/IP to remote IEC 104 controlled stations (RTUs).

Iec104msd is managed remotely either from a Windows PC using ls104msgui.exe application or from Linux shell using iec104m_ui command line utility

iec104msd can potentially support thousands of concurrent connections, see section 3.3.3 “Limitations”

6.1.1 Clock Synchronization

IEC 60870-5-5 [2] Clock synchronization procedure is performed automatically by iec104msd:

• At each IEC104 data link layer establishment

• Repeated periodically at intervals specified in cs_sec parameter of the link configuration

Clock Synchronization can be initiated on demand using iec104m_ui command line or using Windows GUI application lsiec104msgui.exe.

6.1.2 General Interrogation

IEC 60870-5-5 [2] General interrogation procedure is performed automatically by iec104msd:



• At each IEC104 data link layer establishment

• Repeated periodically at intervals specified in gi_sec parameter of the link configuration

General Interrogation can be initiated on demand using iec104m_ui command line or usingWindows GUI application lsiec104msgui.exe.

6.1.3 Test Procedure

IEC 60870-5-5 [2] Test procedure is performed automatically and periodically by iec104msd at intervals specified in ts_sec parameter of the link configuration

Test procedure can be initiated on demand using iec104m_ui command line or using Windows GUI application lsiec104msgui.exe.

6.1.4 Data and Event Acquisition

Acquisition of Events (IEC 60870-5-5 [2]) is performed when connected controlled stations send Spontaneous events or respond to READ command or send data points during General Interrogation procedure.

For each IEC104 controlled station, the iec104msd keeps a list of received data points which could be viewed either by using iec104m Linux command line utility or Windows GUIcontrol program lsiec104msgui.exe. Spontaneous events are always sent as they are received to the GUI program if it is connected.

6.1.5 Transmission of Commands

Command Transmission (IEC 60870-5-5 [2]) procedures can be initiated by using either iec104m Linux command line utility or Windows GUI control program lsiec104msgui.exe.



6.2 Windows GUI Porgram

Windows GUI control program is used to manage IEC104MSD IEC104 Simulator. Main program's views and control areas are shown below:

(1) List of remote IEC104 controlled stations. It is possible to select a station, view its status and IP address, stop and resume IEC104 session.

(2) Link Management group of controls. This area is used to view, add and remove or update the IEC104 links.

(3) Outstation data points. This view displays the information objects received from the selected IEC104 controlled station, either during General Interrogations, Spontaneous transmissions (event transmission), Backrgound Scan or Cyclic transmissions.

(4) System log. This view shows the events logged by iec104msd. Beside viewing the log, it is also possible to pause, resume and export the log.

(5) IEC104 Commands. This control area is used to send commands to the selected remote IEC104 controlled station.

(6) IEC104 Protocol Statistics view. This view shows IEC104 data link and application layer statistic counters of the selected controlled station



6.2.1 Connecting to iec104msd

Click “CONNECT” button.You will see dialog box “Connect to LabScada IEC104 Master”.

Enter the IP address of your Linux server on which the iec104msd is running and specify the TCP port number configured for GUI access in the iec104msd configuration (by defaultport 3344)

Click “Connect”. Connection to iec104msd should get established. You can then manage the IEC104 links and perform other control tasks.

The TCP port on which iec104msd is listening is configured in the iec104msd configurationfile in the option netui_port (stored by default at /etc/iec104msd/iec104msd.cfg):

To disconnect from iec104msd you can click “DISCONNECT” button.

6.2.2 IEC104 Link Management

See section 5.5 “Using Windows GUI lsiec104msgui.exe for Link Configuration”

6.2.3 IEC104 Outstation Data Points View

This view displays the information objects received from the selected IEC104 controlled station, either during General Interrogations, Spontaneous transmissions (event transmission), Backrgound Scan or Cyclic transmissions.



6.2.4 IEC104 Commands View

IEC104 Commands View is used to send commands to the selected remote IEC104 controlled station.

To send a Command, select the required command on the left, then fill in the required fields on the right. The content and constitution of fields differs depending on the selected command. Most important fields are ASDU CA which addresses the specific controlled station and IOA which addresses a specific data control point within the controlled station.

The fields are described in IEC 60870-5-101 [3] and IEC 60870-5-104 [1]

When all required fields are set, click “Send” button.

6.2.5 System Log View

System Log view shows the events logged by iec104msd during operation. These include events about:

• the application starting and stopping,

• IEC104 link connection and disconnection

• performance of IEC 101 application layer functions (IEC 60870-5-5 [2])

• IEC 60870-5-104 protocol tracing

• various debug events, such as state machine events and transitions.



Possible log operations:

• Export Log button is used to export the collected log into a text file

• Clear log button clears the log view

• Log Pause button pauses transmission of log events from iec104msd to the GUI application.

Note that when iec104msd genetrates an event, it goes to two destinations:

• Linux syslog

• Windows GUI program if it is connected to iec104msd.

The event log level and Logging Options are selectable on per IEC104 link basis. The logging options (configurable in the Links Management area) include:

• Protocol Trace- generation of decoded IEC 60870-5-104 protocol trace events

• Hex Dump – enables logging of hexadecimal dump of received and transmitted IEC104 frames

• Expert – enables debug level logging of various functions of iec104msd.



6.2.6 IEC104 Statistics View

IEC104 Protocol Statistics view shows IEC104 data link and application layer statistic counters of the selected controlled station.

Description of statistic counters:

Counter name Description

ASDUs RX Number of IEC 104/IEC101 application level messages received

ASDUs TX Number of IEC 104/IEC101 application level messages transmitted

ASDU RX Bad CA Number of IEC 104/IEC101 application level messages received and discarded as having ASDU CA value mismatching the configured ASDU CA.

ASDU RX Malformed Number of IEC 104/IEC101 application level messages received that were considered malformed and discarded

ASDU TX Errors Number of IEC 104/IEC101 application level messages discarded due to transmission error

Pkts RX Number of IEC 104 data link frames received

Pkts TX Number of IEC 104 data link frames transmitted

TxQ Overflows Number of IEC 104 data link frames discarded at transmission due to transmit queue being full



6.3 Command Line Interface

6.3.1 Starting iec104msd

After installation iec104msd is normally started automatically at boot by cron.

To start the application manually, from the Linux server command line, execute as root:

/usr/sbin/iec104msd /etc/iec104msd/iec104msd.cfg

6.3.2 Stopping iec104msd

To stop the iec104msd application, execute:

iec104msd quit

6.3.3 Checking the software version

To check the software version, execute:

./iec104m_ui show version

IEC104MSD ver: 1.0.0, Tue Jul 28 15:58:51 UTC 2020, Copyright (C) 2020 Sirius NetworkSoftware

IEC104M Library Version: 1.0.0

6.3.4 IEC104 Link Configuration

See 5.4 Using Linux utility iec104m_ui for Link Configuration.

6.3.5 Starting and Stopping IEC104 Links

Normally once an IEC104 link is configured the iec104msd application always attempts to connect the link. However it is possible to stop the link disconnects the connected IEC104 session and puts it into a “stopped” state in which it won't attempt to connect again. It is also possible to “start” the stopped link, which again connects the IEC104 session. Use thefollowing commands to perform these operations:

iec104m_ui stop link ca=<ASDU CA>

iec104m_ui start link ca=<ASDU CA>

ASDU CA is the destination controlled station common address.

6.3.6 Starting Clock Synchronization Procedure

To start Clock Synchronization procedure on a given IEC104 link, execute:

iec104m_ui send cs ca=<ASDU CA>




6.3.7 Starting General Interrogation Procedure

To start General Interrogation procedure on a given IEC104 link, execute:

iec104m_ui send gi ca=<ASDU CA>


6.3.8 Starting Test Procedure

To start Test Procedure on a given IEC104 link, execute:

iec104m_ui send test ca=<ASDU CA>


6.3.9 Sending Read Command

To send Read command on a given IEC104 link, execute:

iec104m_ui send read ca=<ASDU CA> ioa=<IOA>


IOA is the requested information object address

6.3.10 Sending Reset Process Command

To send Reset Process command on a given IEC104 link, execute:

iec104m_ui send rp ca=<ASDU CA>


6.3.11 Sending Digital Output Command

To send a Digital Output setting command on a given IEC104 link, execute:

iec104m_ui send digital output ca=<ASDU CA> typeid=<TYPEID> ioa=<IOA> value=<VALUE> qu=<QU> select=<S/E>

Parameter Explanation

ASDU CA the destination controlled station common address.

IOA The addessed control point's Information Object Address

TYPEID IEC101 type ID, specifies the IEC101 command to send, one of the following:45 – Single Command58 – Single Command with time tag46 – Double Command59 – Double Command with time tag47 – Regulating Step Command60 – Regulating Step Command with time tag



VALUE Specifies the output value. This is a decimal integer, the allowed values are specied in IEC 60870-5-101 for each command type ID.

S/E This is a decimal integer 0 or 1.1=Command is a Select operation0=Command is an Execute operation

QU Qualifier of command. This is a decimal integer. The allowed values are specied in IEC 60870-5-101 for each command type ID. Default value is 0.

Example:/iec104m_ui send digital output ca=28 typeid=45 ioa=100 value=1 qu=0 select=0

Sending cmd request for linkNo=28, typeId=45, cot=6, IOA=100 S/E=0 u8val=1, QU=0

6.3.12 Sending Analog Output Command

To send an Analog Output setting command on a given IEC104 link, execute:

iec104m_ui send analog output ca=<ASDU CA> typeid=<TYPEID> ioa=<IOA> value=<VALUE> ql=<QL> select=<S/E>

Parameter Explanation

ASDU CA the destination controlled station common address.

IOA The addessed control point's Information Object Address

TYPEID IEC101 type ID, specifies the IEC101 command to send, one of the following:48 – set point command normalized value49 – set point command scaled value61 – set point command normalized value with time tag62 – set point command scaled value with time tag50 – set point command short floating point number63 – set point command short floating point number with tag time

VALUE Specifies the output value. The format of the value depends on the typeid. The allowed values are specied in IEC 60870-5-101 for eachcommand type ID.For type Ids 48, 49, 61, 62 the value is a signed short integer (16 bit)For type Ids 50, 63 the value is a floating point number, e.g “1.5”

S/E This is a decimal integer 0 or 1.1=Command is a Select operation0=Command is an Execute operation

QL Qualifier of command. This is a decimal integer. The allowed values



are specied in IEC 60870-5-101 for each command type ID. Default value is 0.

Example:/iec104m_ui send analog output ca=28 typeid=48 ioa=200 value=32000 qu=0 select=0

6.3.13 Viewing System Log

The Windows version of iec104msd (iec104msd) writes system log events to the text file iec104msd.log located at c:\Lab-SCADA=Iec104Ms

The Linux version of iec104msd generates syslog events. To view the syslog events in realtime you can use the following command:

tail -f /var/log/syslog

To view all syslog events:

cat /var/log/syslog| grep iec104msd

Example output:

Aug 2 18:21:53 host1 iec104msd: 18:21:53.705: TRC-IEC104M DL: L28(0): TX (6): U TESTFR Act

Aug 2 18:21:53 host1 iec104msd: 18:21:53.706: TRC-IEC104M DL: L28(0): RX (6): U TESTFR Act

Aug 2 18:21:53 host1 iec104msd: 18:21:53.706: TRC-IEC104M DL: L28(0): TX (6): U TESTFR Con

Aug 2 18:21:53 host1 iec104msd: 18:21:53.709: TRC-IEC104M DL: L28(0): RX (6): U TESTFR Con

Aug 2 18:22:07 host1 iec104msd: IEC104M DL: L2(0): TCP connect timeout

Aug 2 18:22:07 host1 iec104msd: IEC104M DL: L2(0): Connecting TCP to 10.110.225.38:2404 fd=77

Aug 2 18:22:13 host1 iec104msd: 18:22:13.709: TRC-IEC104M DL: L28(0): TX (6): U TESTFR Act

Aug 2 18:22:13 host1 iec104msd: 18:22:13.712: TRC-IEC104M DL: L28(0): RX (6): U TESTFR Con


Documents

Lab-SCADA IEC 60870-5-104 Master Simulator User Manuallab-scada.com/iec104_master_simulator_manual.pdfLab-SCADA IEC 60870-5-104 Master Simulator User Manual 2 Licensing 2.1 Evaluation