IEC61850 Client

SmartGridware IEC 61850

IED View


Browser Based IED Client




 

Quick Start /User Guide

IEC61850 Client

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

Overview

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

Table Of Contents

Quick Start
  1. Start Viewer Application
    1. To Start: Click on the "IEC 61850 IED VIEW" Icon.

      IEDSim

    2. The application will attempt to open the TCP port configured at application installation.

             By default, this is port 8200.

    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.

      IEDView 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 IED Client View

    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 Client View  application using your username and password. The default (which are pre-populated in the evaluation) are:

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

    IED View Login

  5. IED Client View Main Window: The IED Client View main window has a top level toolbar used to configure the application, open a new SCL file for a server to connect to, or perform an IED server discovery without using an SCL file.

    IED View Main Window

  6. IED Discovery: One method of accessing an IED is through IED Discovery. This method is used if no SCL file is available for the IED. For the "Quick Start" guide, we will focus on this method of IED interaction. For more information on

    Click the Discovery  button at the top left corner of the screen. This will pop up the "Discovery Wizard". Just enter the IP address, port and OSI address for the IED the click "Start". In most cases, the IP address is the only field that needs to be entered since most IEDs use the default values for the other fields.

  7. IEDSim Login


  8. IED Control Panel: Once the discovery is complete, the IED Control Panel will be available. Just click on the Tab corresponding to the IED to display the control panel.


    IEDSim Login

  9. Tree View: Just click on the "Tree" Button to open the tree view. This will  display the simulator's LDs, LN, DOs and DAs.


  10. IEDSim Login

  11. Context Specific Help: For help on other functions of the IED Client View, just click on the help ('?') icon at the top right of the window.


IED Discovery Wizard

IED Discovery provides a quick and easy way to access and view IED data without using the IED's SCL. It simply connects to the IED, extracts the Data Definitions and the Data Values directly from the IED server.

Click the Discovery  button at the top left corner of the screen. This will pop up the "Discovery Wizard". Just enter the IP address, port and OSI address for the IED the click "Start". In most cases, the IP address is the only field that needs to be entered since most IEDs use the default values for the other fields. SCL File Upload

Main Panel: IED Communication Parameters

The main IED Discovery window takes the communication parameters required to connect to the IED. Once connected the client will build a local cached representation of the IED for use in view, setting and performing operations on the IED. See the IED discovery window below:

IEDSim Login

The available parameters are:

IED View - SCL Open Wizard

The Open SCL Wizard is used  to open an SCL (ICD,CID,etc)  for an IED then connect to the IED and retrieve IED data. 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 Configuration

The IED Configuration 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
Advanced Configuration

The Advanced Configuration pane allows the configuration of parameters that affect the client behavior but are not commonly used. Some of these parameters allow for interaction with 'non-compliant' devices or  implementation specific behaviors 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: In simulation and test environments, the IP Address and Port in the SCL file WILL NOT match an available IP Address/Port on the remote 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

IED  Discovery Panel

The IED Discovery Panel provides the user with a simple communications parameters interface for specifying the connection parameters for the remote system.

Once the address and other parameters are provided, just click the "Connect" button to connect to the IED and begin the data discovery process.

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 Client View 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 Client View Control Bar

The IED Client View 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 Client View 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 Client View 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 Restart

The Action menu provides access to Restart the IED Client View for this IED. This will close and reconnect.

IED Action Panel: IED Restart
OpenSCL Advanced Config
IED Client View Close

The "IED Close" action will shutdown the client access to the IED. It will terminate the association with the IED and clean up locally stored IED data.

IED Action Panel: IED Client View Close
IED Close
Status Panel

IED Close

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

IED Status

The Status panel icon shows Running or Stopped.

Status Panel: IED Status
IED Status
IED Start/Stop

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

Status Panel: IED Client Stop
IED Client Stop

Status Panel: IED Client Start
IED Client Start
Data View Panel

Data View Panel

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:

Cached Data View

The IED Tree View in the IED Client View provides a cached data view of the data objects in the remote IED. It is arrange in a hierarchical manner as found in the SCL definition: LD->LN->DO->DA. As data is retrieved or otherwise received from the IED via GetDataValues, Report or GOOSE messages, the values in the cached date view are dynamically updated. tThe 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

Setting IED Data Values (SetDataValues)

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. When in 'single-set' mode, clicking on the "Ok" (check) button will result in a SetDataValues operation (MMS-Write)  being sent to the IED for this new value.

See the section on 'multi-set' operations to see how to send a SetDataValues operation containing multiple values.

IED Tree View: Local Value Editor (Set Operation)

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

Refresh Data (GetDataValues) 

The Refresh button in the Tree View toolbar is used to issue one or more GetDataValues operations to retrieve data from the IED and refresh the local data cache.

IED Tree View: Refresh Data
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 sent together in the same SetDataValues (MMS-Write) Request. 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 in the toolbar, if the commit dialog is not already displayed. If all of the values look correct, then press the confirmation Commit button to send the SetDataValues (MMS-Write) to the IED.

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
Setting IED Data Values

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:

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 can be used 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,  the Logical Status and Physical Status of the Access Point can be configured and the Start and Stop the Association controller for the IED connection.

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

Network Control View: Access Point Detail
Access Point Detail
 
MMS Message Monitor

The MMS Message Monitor allows the user to log and view MMS and ACSE messages sent and received by the IED Client View. 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:

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

Control Panel


Association Control

The Control Panel provides a set of buttons for activating views for different Control Blocks in the IED. If an IEDhas 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 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 if they are properly configured. Double click an a block or select a report control block and press the Detail button to bring up the Details window.

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. You can select the DataSet value form a selector and configure the other writable RCB parameters.

Report Control Configure
Custom View With Attributes
Report Control Enabled
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 Detail View
Custom View With Attributes

Operation Control Detail View

The Operation Control Detail View provides a form to view controllable data values as well as build and send control operations including:

The control attributes  are reflected on this form. The "Operate Params" pane at the bottom of the form is used to construct operate parameters to send for the SBOw, Operate and Cancel control operations.

Operation Control Detail View
Custom View With Attributes