SmartGridware IEC 61850

IED View

Browser Based IED Client

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

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:

1. Start Viewer Application
1. To Start: Click on the "IEC 61850 IED VIEW" Icon.
   
   
   
   
   
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.
   
   
   
   
   
   
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.
   
   
   
   
   
   
   
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:
   
   
   
   
   
   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:
   
   
   
   


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


3. 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"
   
   
   
   
   
4. 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.
   
   
   
   
   
5. 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.






6. 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.
   
   
   
   
   
   
7. Tree View: Just click on the "Tree" Button to open the tree view. This will  display the simulator's LDs, LN, DOs and DAs.
   
   
   



8. 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 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

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:

The available parameters are:

• IP-Address: IP address of the IED
  
• IP-Port: IP port of the IED
  
• TSEL: Transport Selector for the IED
  
• SSEL: Session Selector for the IED
  
• PSEL: Presentation Selector for the IED
  
• AP-Title: AP Title of the IED
  
• AEQ: AE Qualifier of the IED
• Auth OID: The mechanism OID for authentication
• Auth Value: Character string for authentication in ACSE-Associate-Request
• Discovery Level: Level at which GetDataValues commands should be issued
  
• IED Name: Ignored currently
• Connect Timeout: timeout for TCP connect
  
• Discovery Timeout: timeout for actual discovery function

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:

• SCL File Upload
• SCL File Open
• SCL File Compilation
• IED Communication Config
• IED Data Discovery

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

Here are the Fields and Functions available:

• Uploading: Click on the Upload SCL Files button, then select the file to upload. The filename and upload status will be shown in the upload status box just below the upload button.


• User Group: The selector button to the right of the 'Cancel' button allows the user to select the User Group to assign to this simulator instance. Any "logged-in" Users that are assigned to this user group will be able to view, access and control this simulator if they have the sufficient access permission (read/write).


• Open Mode: The Open Mode is selected using the selector to the left of the "Open" button at the bottom right of the wizard.
  
  There are 3 main Open Modes:
  1. Quick: This mode will attempt to load and start the simulator using the default parameters in the SCL file. This doesn not give the user options to change parameters or view SCL parsing status and warnings unless there are parse errors in the SCL file. If successful, this mode will not require any further input from the user in order to start the a simulator for the SCL file.
  
  
  
  2. Basic: The Basic mode will bring the user to the SCL load results panel that will display any warnings and errors resulting from the load of the SCL file. By selecting the 'Next' button, the user will go to the network configuration screen where changes may be made to IP address, port numbers and other network related configuration parameters before starting the simulator.
  3. Advanced: The Advanced mode will bring the user to the Advanced Configuration Panel. This panel allows the user to configure:
     • Validation: Lax or Strict. This affects the syntax and contextual checking of the SCL file. Lax mode is the default and will ignore common syntax issues found between Edition 1 and Edition 2 SCL version.
     • Edition: Selects the edition of the SCL file to load. Any will attempt to auto determine the SCL version from the file.
     • GOOSE and Sampled Value (SV) parameters: For example: the network interface, MAC address, and Sync flag
     • Client SCL File(s): For applications requiring interaction with another IED.
     • 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.
     
     Once the advanced configuration parameters have been selected, the 'Next' button will load the SCL file and take the user to the SCL results screen just like the 'Basic' mode.
• Delete File: The 'trash can' button to the right of a file name is used to delete the file from the user's directory.

The Advanced Configuration Panel allows the user to configure:

• Basic IED Configuration
• Advanced Configuration Parameters

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:

• Validation: Lax or Strict. This affects the syntax and contextual checking of the SCL file. Lax mode is the default and will ignore common syntax issues found between Edition 1 and Edition 2 SCL version.


• Edition: Selects the edition of the SCL file to load. Any will attempt to auto determine the SCL version from the file.


• IED:: If an SCL file contains multiple IED definitions, this field will allow you to select which IED to load for simulation.


• GOOSE and Sampled Value (SV) parameters: For example: the network interface, MAC address, and Sync flag

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.

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.

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.

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

• IED: The target IED from the SCL File
• AP: The target AP from the IED definition
• Address: The address pane has fields for all of the protocol parameters needed to connect to a remote system.
• Discovery: The discovery pane has the following parameters
1. Level: The highest level at which to issue GetDataValues requests, default is Logical Node (LN)
2. DataSets: If checked, perform a retrieval and sync of DataSet definitions
3. DataDefs: if checked, perform a data definition retrieval and sync with the SCL model.
   
   
• Timeouts:The timeout values for establishing a connection and performing the discovery operation.

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

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

The functionality provided by this window consist of:

• Add User: Add a new user. This will prompt for a new user name.
• Remove User: Remove an existing user. This will provide a selector of existing user names.
• Edit User Fields: Any user field, except the username can be modified by double clicking on the field in the user table.
• Change User Permission: Select whether the user has Read, Admin and File Access privilege
• Add Group: Add a new group. This will prompt for a group name.
• Remove Group: Remove an existing group. This will provide a selector of existing group names.

The IED Client View application allows you to set color preferences for:

• Icon Colors
• Background Colors>
• Title Color

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:

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:

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:

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: Action menu, Restart and Close Functionality
• Status Panel: IED Status + Start/Stop Operation
• Data View Panel: Tree, Dataset and Custom IED data Views
• Network Panel: Network Control, MMS Message Monitor, Data Export
• Control Blocks : Control block specific configuration and control screens.

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.

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

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

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.

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.

The Status panel icon shows Running or Stopped.

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

The Data View Panel contains 3 different view options:

• IED Tree View
• Custom View
• Dataset 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:

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.

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:

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

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.

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

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.

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.

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.

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:

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

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.

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.

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

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.

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:

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

• FC Filtering
• Column Filtering
• Column Visibility
• Set IED Data Values Operations

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

The Network Panel contains network related IED functions, including:

• Network Control
• Message Monitoring
• Data Export.

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.

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.

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:

The available toolbar buttons are as follows:

• Start: start logging and displaying messages
• Stop: stop message logging
• Pretty: pretty-print format the message detail pane
• Download: download the selected message (not all messages)
• Max Messages Slider: specifies the max number of messages in log.
• Clear: clear the message list.

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:

• Filtering: When exporting an SCL or JSON file, the tool provides data value filtering based on Function Constraints(FC). Note that for SCL, the full structure is still exported however the instance data will be filtered by the provide FC filters.

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

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 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.

From the detail view you can perform these functions:

• Start: Start the communication processing for the GOOSE control
• Stop: stop the communication processing for the GOOSE control
• Enabled/Disabled: Toggle button for changing the enabled state, this will send a SetDataValues to the IED.
• Refresh: Perform a GetDataValues against the GOCB to refresh the local data cache.

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 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.

From the detail view you can perform these functions:

• Start: Start the communication processing for the SV control
• Stop: stop the communication processing for the SV control
• Enabled/Disabled: Toggle button for changing the enabled state.
• Refresh: Perform a GetDataValues against the control block to refresh the local data cache.

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 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

Report Control Enabled

From the detail view you can perform these functions:

• Enabled/Disabled: Toggle button for changing the enabled state.
• Simulated: Set the simulated flag in outgoing Report messages
• General Interrogation (GI): Force a GI report to be sent.
• Purge: Force a Purge buffer operation.
• Refresh: issue GetDataValues to update the local cache for this control block

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 Detail View

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

From the detail view you can perform these functions:

• ActSG:Change the Active Setting Group, this will send a SetDataValues to the IED
• EditSG: Change the Edit Setting Group, this will send a SetDataValues to the IED
• Refresh: issue GetDataValues to update the local cache for this control block

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 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.

From the detail view you can perform these functions:

• Enabled/Disabled: Toggle button for changing the enabled state.
• Refresh: issue GetDataValues to update the local cache for this control block

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

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

• Select Before Operate (SBO)
• Select Before Operate with Value (SBOw)
• Operate
• Cancel

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.