IEC61850 Client

SmartGridware IEC 61850

IED View


Browser Based IED Simulator




 

Quick Start /User Guide

IEC61850 Client

Copyright © 2000-2018, Monfox, LLC.
ALL RIGHTS RESERVED.



Overview

The SmartGridware IEC 61850 Server Simulator provides a graphical interface for viewing and modifying server data values as well as exercising control operations and manipulating control blocks. Features Include:

Table Of Contents

Quick Start
  1. Start Simulator Application
    1. To Start: Click on the "IEC 61850 IED SIM" Icon.

      IEDSim

    2. The simulator will attempt to open the TCP port configured at application installation. By default, this is port 8100.

    3. If the default port is already in use, the simulator will find the next open port and use that one.

    4. Once an available port is located, the simulator will start up and create a splash screen showing the URL to connect to from your Web Browser.

      IEDSim Info Dialog


    5. The application will also create a small info dialog displaying this URL and some action buttons:

      - Open Browser: This will open the default system browser.
      - Quit: Quit the simulator

    6. Connect to the URL displayed on the info window from your Chrome or Firefox browser. (Explorer is not supported). If Explorer is your default browser, you may want to change the default to one of these browsers.

      Browser URL



  2. License Manager:  If the license key was entered at installation, then this step can be skipped.

    You should have received a license key, that looks something like the following:
           
    ---- BEGIN LICENSE KEY ----
    
    7B0C2BBBF566584069BD9A05646118D2841BB7257C31D6EB
    24CA9326E658C2A18E049CF9D6676B64EAC11D1E0EDAED1F
    
    ...
    
    3CDDD806CE169A46D20EFA0CF9B567CC73869138AD4B42B1
    853DD678A776F468EEBE7F066074DE045956A61A6E2F9251
    04790371C1FBD91A5954A61A6E2F9251
    
    ---- END LICENSE KEY ---
            
    Upon connecting to the web server, the license manager dialog should be seen, if a login screen is shown, proceed to the next step. The license manager screen is shown below:

    IEDSim Login


    To enter the license key, just click the "Update License" button, then copy the license key, including the BEGIN and END LICENSE KEY lines and paste the key into the license key form as follows:


    IEDSim Login


  3. Then click the "Commit" button to update the license key.

  4. Login Dialog: Login to the IED Sim application using your username and password. The default (which are pre-populated in the evaluation) are:

    -  Username: "USER_1"
    -  Password:  "USER_1"

    IEDSim Login

  5. IED Sim Browser Main Window: The IED Sim main window has a top level toolbar used to configure the application and open a new SCL file to simulate

    IEDSim Main Windows

  6. Open SCL: Click the Open button at the top left corner of the screen. This will pop up the "Open SCL Wizard" that is used to start a simulator.

  7. IEDSim OpenSCL


  8. Upload your SCL File: If you have not already uploaded your ICD file to the server, you can select the "Upload SCL Files+" button on the wizard then select and upload your SCL file.

  9. Select the SCL file from the file list.

  10. Select the Open Mode. The available options are: Quick, Default and Advanced. Stick with "Quick" initially.

    See the Open SCL reference for more information on these options.


  11. Open the File: If all is well, the file will open and the simulator will be started, if there are SCL file errors or if the IP address/port in the file is unavailable, you will be directed to a screen that will allow you to view or correct the problems. 

    The  "Network Communications"screen allows you to change communications parameters such as IP Address,IP port, etc.Just double click on the value to edit.




  12. IEDSim Communications Params

    Once all parameters are entered correctly, just click "Start" to start the IED simulator.


  13. IED Control Panel: Once the SCL file is loaded and the IED simulator started, the IED Control Panel will be available. Just click on the Tab corresponding to the IED to display the control panel.


    IEDSim Control Panel

  14. Tree View: Open the tree view to see the simulator's LDs, LN, DOs and DAs.


    IEDSim Tree View

  15. Context Specific Help: For help on other functions of the IED Server Simulator, just click on the help ('?') icon at the top right of the window.
SCL Open Wizard

The Open SCL Wizard is used  to open and load SCL (ICD,CID,etc) files for simulation. The basic actions supported by the Open Wizard are:

Main Panel: Upload & Open File

The Open SCL Main Panel allows you to upload SCL files, delete SCL files, select a file to open. See below:


Open SCL: Main Panel
IEDSim Login


Here are the Fields and Functions available:

Advanced Configuration Panel

The Advanced Configuration Panel allows the user to configure:

Basic IED Properties

The IED Properties panel allows the user to configure basic parameters such as SCL validation mode, SCL edition, IED To Select (if SCL has multiple IED's defined), GOOSE and SV network device configuration (MAC Address), etc). See the open IED Properties panel below:

Open SCL: IED Parameters Panel
OpenSCL Advanced Config
Client SCL File(s):

For applications requiring interaction with another IED, you can load a client SCL file containing the SCL structure of the other server


Open SCL: Client SCL File
OpenSCL Advanced Config
Advanced Configuration

Parameters that affect the simulator behavior but are not commonly used. Some of these parameters allow for simulation of 'non-compliant' devices or control implementation specific behaviours at the protocol or encoding level.

Open SCL: Advanced Configuration Panel
OpenSCL Advanced Config

SCL Load Results Panel

The SCL Load Results Panel shows and SCL errors and warnings along with the number of instances of the LDs, LNs, DOs and DA's created for simulation.Any SCL errors should include a line number and give some detail as to the error. Note that errors are not necessarily fatal and many times you can continue with a simulation even if errors are found in the SCL load.

Open SCL:SCL Load Results Panel
OpenSCL Advanced Config

SCL Network Configuration Panel

The SCL Network Configuration Panel provides an editable tree view of the Network configuration parameters for each Access Point in the loaded SCL file.

Editing: In order to edit a parameter, simply double click on the value column of the parameter and a value editor will appear. For IP addresses, the editor will provide a selector containing the available IP addresses for the current host.

NOTE: Very often the IP Address and Port in the SCL file WILL NOT match an available IP Address/Port on the local system. In these cases you WILL NEED TO SPECIFY A DIFFERENT IP ADDRESS and PORT. The editor for the IP address should list the available IP addresses for this host.

Open SCL: IED Communications Parameters
OpenSCL Advanced Config


User Admin Window

The User Admin Window provides admin users the ability to administer users and user groups. See below:

User Admin Window
OpenSCL Advanced Config

The functionality provided by this window consist of:

Color Palette

The IED Sim application allows you to set color preferences for:

It also has predefined 'theme's you can chose from.

To set the color preferences select the 'palette' icon in the top toolbar. You will get a popup shown below:


Color Palette & Theme Configuration
Color Palette


IED Sim Control Bar

The IED Sim Control Bar is a 'ribbon' bar just below the top level toolbar.

IED Tabs: At the top of the bar will be a list of 'tabs' , one for each IED currently active in the simulator.

IED Nicknames: The IEDs are identified by a Nickname composed of the first few characters of the IED name followed by an instance identifier if applicable.

Active IED Control: When an IED tab is selected, that IED's control panel is activated just below the Tabs. All of these actions then apply to the active IED. See the panel below:

IED Sim Control Bar
IED Control Panel

Icon Form: If the screen dimensions are reduced, the control panel will drop the action names and just display the icons. Tooltips are supported so you can 'mouse-over' the icons to see the action names. See below:

IED Sim Control Bar: Icons Only
OpenSCL Advanced Config

As shown in the above examples, the IED Control Bar is divided into several 'panels' each having a related set of functions. These are:

IED Action Panel


IED Close

The Action Panel contains IED level operations for initiating specific functions, restarting the IED or closing the IED. In addition to the operations, the Action Panel displays the IED Nickname in the main area of the panel and the full IED name along with the IP Address and IP Port in the label.

Action Menu

The Action Menu provides access to the IED Control Bar functions for the IED.

IED Action Panel: Action Menu
OpenSCL Advanced Config

IED Simulator Restart

The IED Restart button will restart the IED Simulator for this IED.

IED Action Panel: IED Restart
OpenSCL Advanced Config
IED Simulator Close

The IED Close action will shutdown the simulation for this IED. It will shutdown the network listeners, terminate any associations and clean up the IED simulation.

IED Action Panel: IED Close
IED Close

Status Panel

IED Close

The IED Status panel shows the current status of the IED simulator for the IED.It also allows the user to Start or Stop the IED simulator by just clicking on the status icon.



IED Status

The Status panel icon shows Running or Stopped.

Status Panel: IED Status
IED Close
IED Start/Stop

To Start or Stop the IED simulator by just clicking on the status icon.

Status Panel: IED Simulator Stop
IED Close

Status Panel: IED Simulator Start
IED Close
Data View Panel

IED Close

The Data View Panel contains 3 different view options:

Tree View

The IED Tree View provides a dynamic, tree-based view of the entire contents of the IED's data structure. It provides a logical view rather than a 'functional' view. This means that the FC elements are not part of the tree structure. This provides a more concise view of the IED data. The basic functions supported by the tree view are:



Live Data View

The IEDTree View in the IEDSimulator provides a live data view of the data objects in the simulator. It is arrange in a hierarchical manner as found in the SCL definition: LD->LN->DO->DA. As data values in the IED change, the updated values are instantly updated in the Tree View.

IED Tree View: Live Data View
IED Close
Tree View Icons

The IEDTree View indicates behavior/mode, quality state, changed state and health using icons. These indicators are propagated up to the LN and LD levels to alert the user to lower level information so they can easily drill down to the actual attribute causing the icon state. See the following example:

IED Tree View: Tree Icon Example
IED Tree View Icons

The following Icon legend describes the meaning of the different tree icons:

IED Tree View: Icon Legend
IED Tree View Icons

Local Data 'Set' Operations

Double-clicking on the value field of any leaf Data Attribute (DA), will bring up the value editor for that DA. There are different value editors for the different data types supported by SCL.

IED Tree View: Local Value Editor (Set Operation)
IED Close

When setting values there are 2 different 'modes' to take into account:

Processing Mode

Specifies whether the local 'set' operation should trigger the normal processing of the value as through is came in through a protocol (MMS) operation. The mode is indicated on the 'Mode' toolbar button. The icon with the 'gear' in the middle means 'process', if the gear is not shown, then it is in direct/pass-thru mode.

IED Tree View: Process Mode
IED Close
IED Tree View: Pass-thru Mode
IED Close
Multi-set Mode

Multi-set mode specifies whether a value set operation should be executed immediately on confirmation or grouped with multiple set operations such that they are all executed together. When in multi-set mode, the value editor will only 'stage' the value to be committed at a later point.

IED Tree View: MultiSet Mode
MultiSet Mode

Once all of the desired values are 'staged', just press the 'commit' button, if the commit dialog is not already displayed' then hit the commit button to perform the group of set operations.

IED Tree View: Multi-set Commit
MultiSet Mode Commit

IED Custom View

The IED Custom View is a flat data attribute view created by dragging and dropping nodes from the IED Tree View into the custom view window. You an drag any node from the treeview from the Logical Node (LN) down to a Data Attribute (DA). The Custom view will display only the leaf DA instances with their values in a table format. See below:

IED Custom View: Empty
MultiSet Mode Commit

To populate, just drag and drop from a tree view.

IED Custom View: Dragging from IEDTree View
MultiSet Mode Commit

IED Custom View: After Dragging Health Object
Custom View With Attributes
Filtering

Functional Constraint Filtering: You can filter the attributes by Function Constraint using the filter function. The filter button pops up an FC selection pane so you can select the specific FCs you want to see in the view.

IED Custom View: FC Filtering
Custom View With Attributes

Column Filtering: You can also filter by column. Just type in a character string in the associated column and the visible entries will be filtered.

IED Custom View: Column Filtering
Custom View With Attributes
Column Visibility

You can choose the visibility of the LD, FC and Type columns using the corresponding buttons in the toolbar.

IED Custom View: Column Views
Custom View With Attributes
Value Set Operations

As with the IED Tree View, you can modify values one by one or using a multi-set operation. See the IED Tree View Local Data Set section.


Dataset View

The IED Dataset View is a flat table view like the IED Custom View. It contains the values for each DA in each dataset as shown below:

IED Dataset View
Custom View With Attributes

The Dataset View supports the same functionality as the Custom View including:

See the IED Custom View for mode information on how to use these functions.

Network Panel

Custom View With Attributes

The Network Panel contains network related IED functions, including:

Access Control

The Access Control View is used to filter incoming connections based on the following criteria when in the "Validate All" mode:

The  default "Accept All" or "Reject All" modes are self explanatory.

Access Control View
Custom View With Attributes

When in "Validate All" mode, the rules are validated from the top down so the first matching rule will be applied.

Network Control

The Network Control View is used to view the status of the configured network interfaces for the IED as well as to configure or control any configurable parameters of the Access Point.

The main network control window to Start and Stop the network interface for the IED's Access Points.

Network Control View
Custom View With Attributes

Access Point Detail

Click on the "Detail" button to see the Access Point detailed information. When the interface is UP, you can configure the Logical Status and Physical Status of the Access Point as well as start and stop the Access Point's network interface.

After stopping the Access Point's network interface, the IP and OSI stack parameters can be modified as well.

Network Control View: Access Point Detail
Custom View With Attributes
Association Control

The Association Control View is used to view and control the associations with the IED's access point(s). This view allows you to "Release" or "Abort" and association.

Association Control View
Association Control
Control Panel


Association Control

The Control Panel provides a set of buttons for activating views for different Control Blocks in the IED. If an IED has no control blocks of a specific type, then the button for that type will be disabled. These control blocks include:

  • GOOSE Control
  • SV Control
  • Report Control
  • Setting Control
  • Log Control
  • Operation Control
GOOSE Control

The GOOSE Control View provides configuration and control capability for the GOOSE control blocks in the IED. There is a List View and a Detail View available as shown below:

GOOSE List View

The GOOSE List View contains a table of all available GOOSE control blocks in the IED. From this view, you can  Start, Stop, Enable and Disable Goose control blocks.

GOOSE Control List View
Custom View With Attributes

GOOSE Detail View

The GOOSE Control View provides configuration and control capability for the GOOSE control blocks in the IED. From this view, you can  Configure, Start, Stop, Enable and Disable GOOSE control blocks.

GOOSE Control Detail View
Custom View With Attributes

From the detail view you can perform these functions:

Sampled Value (SV) Control

The SV Control View provides configuration and control capability for the SV control blocks in the IED. There is a List View and a Detail View available as shown below:

SV List View

The SV List View contains a table of all available SV control blocks in the IED. From this view, you can  Configure, Start, Stop, Enable and Disable SV control blocks.

SV Control List View
Custom View With Attributes

SV Detail View

The SV Control View provides configuration and control capability for the SV control blocks in the IED. From this view, you can  Start, Stop, Enable and Disable SV control blocks.

SV Control Detail View
Custom View With Attributes

From the detail view you can perform these functions:

Report Control

The Report Control View provides configuration and control capability for the Report control blocks in the IED. There is a List View and a Detail View available as shown below:

Report List View

The Report List View contains a table of all available Report control blocks in the IED. From this view, you can  Enable and Disable Report control blocks

Report Control List View
Custom View With Attributes

Report Detail View

The Report Detail View provides a form to view and configure the Report Control parameters. From this view, you can  Configure, Enable and Disable Report control blocks as well as force a General Interrogation (GI) operation.

Report Control Detail View
Custom View With Attributes

From the detail view you can perform these functions:

Setting Group Control

The Setting Group Control View provides configuration and control capability for the Setting Group control block in the IED. There is a List View and a Detail View available as shown below:

Setting Group List View

The Setting Group List View contains a table showing the IED's setting group. You can then view the details of the setting group.

Setting Group Control List View
Custom View With Attributes

Setting Group Detail View

The Setting Group Detail View provides a form to view and configure the Setting Group Control parameters.

Setting Group Control Detail View
Custom View With Attributes

From the detail view you can perform these functions:

Log Control

The Log Control View provides configuration and control capability for the Log control blocks in the IED. There is a List View and a Detail View available as shown below:

Log List View

The Log List View contains a table of all available Log control blocks in the IED. From this view, you can  Enable and Disable Log control blocks

Log Control List View
Custom View With Attributes

Log Detail View

The Log Detail View provides a form to view and configure the Log Control parameters. From this view, you can  Configure, Enable and Disable Log control blocks.

Log Control Detail View
Custom View With Attributes

From the detail view you can perform these functions:

Operation Control

The Operation Control View provides configuration and control capability for controllable Data Objects in the IED. There is a List View and a Detail View available as shown below:

Operation Control List View

The Control List View contains a table of all available Controllable Data objects in the IED.

Operation Control List View
Custom View With Attributes

Operation Control Detail View

The Operation Control Detail View provides a form to view and configure the Control parameters. The control attributes and current control state are reflected on this form. There is also Control Behavior Simulation supported through this view.

Log Control Detail View
Custom View With Attributes

Control Behavior Simulation

Control behavior may be simulated by providing the following:

Command Tools Panel


Association Control

The Command Panel contains the utility operations for accessing, modifying and exporting data from the simulator. The following utility functions are supported.

  • Message Viewer
  • Script Interface
  • Exporter
MMS Message Monitor

The MMS Message Monitor allows the user to log and view MMS and ACSE messages sent and received by the IED simulator. In order to use the message Monitor you just need to click the "Start" button. See the Message Monitor window below:

MMS Message Monitor
Custom View With Attributes

The available toolbar buttons are as follows:

Script Console

The Script Console is a javascript command tool that allows programatic access to IED data through javascript. There are 2 static objects available to the javascript:

The API object provides high level functions for printing, getting the list of available IEDs, etc.

The IED object refers to the IED instance. It has methods for getting named lists of objects, accessing data values and setting data values. See the script console below:


Script Console
Custom View With Attributes

NOTE: There is a separate guide for the scripting interfacing coming soon.

SCL & JSON  Export Tool

The Export tool is used to export the current IED state either as an ICD (SCL) file or as a JSON values file. See the Export Tool window below:

IED Export Tool
Custom View With Attributes