Pricing/Info    Download   
MENU 
 Home Products About Support Contact

SmartGridware® IEC61850 Client Command Tool

Logging data from IEC61850 Servers

Product Overview

The SmartGridware® IEC61850 Client Command Tool is an IEC61850 client application that allows the user to connect to and perform services against an IEC61850 server. It provides a simple command line interface the user can utilize to send services to the server and print out server data values.




 

Product Features

The client command tool has the following features:

  • Data model initialization via SCL or IED Discovery
  • Association control commands
  • User friendly data print format
  • Control operation interface
  • Report Control Block reservation commands
  • ACSI service interface: Get/Set/GetNameList
  • Under Development: web based interface

Supported Standards

 

The functionality provided by the SmartGridware® IEC61850 Client Command Tool is implemented in compliance with the following standards (click to view):

IEC61850 Standards

  • IEC 61850-7-1: Principles and models
  • IEC 61850-7-2: Abstract Communication Service Interface (ACSI)
  • IEC 61850-7-3: Common Data Classes
  • IEC 61850-7-4: Logical Node Classes
  • IEC 61850-8-1: Service Mapping: ACSI Mappings to MMS
  • IEC 61850-6-1: Configuration Description Language (SCL)

IEC61850 Upper Layer Protocol Support

  • IEC61850-8-1 Client/Server Services (MMS) (6.2.1)
  • IEC61850-8-1 Client/Server A-Profile (6.2.2)
  • IEC61850-8-1 TCP/IP T-Profile (RFC1006) (6.2.3)

Manufacturing Message Specification (MMS) Standards

  • ISO 9506-1: Manufacturing Message Specification - Service Definitions
  • ISO 9506-2: Manufacturing Message Specification - Protocol Definitions

OSI Stack and Lower Layer Standards

  • RFC 1006: OSI over TCPIP (CMIP/OSI over TCP/IP)
  • ITU-T X.214 | ISO/IEC 8072: OSI - Transport Service Definition
  • ITU-T X.224 | ISO/IEC 8073: OSI - Transport Protocol Specification
  • ITU-T X.215 | ISO/IEC 8326: OSI - Session Service Definition
  • ITU-T X.225 | ISO/IEC 8327: OSI - Session Protocol Specification
  • ITU-T X.216 | ISO/IEC 8822: OSI - Presentation Service Definition
  • ITU-T X.226 | ISO/IEC 8823-1: OSI - Presentation Protocol Specification
  • ITU-T X.217 | ISO/IEC 8649:   ACSE Service
  • ITU-T X.227 | ISO/IEC 8650-1: ACSE Protocol
  • ITU-T X.680 | ISO/IEC 8824-1..4: Abstract Syntax Notation One (ASN.1)
  • ITU-T X.690 | ISO/IEC 8825-1: ASN.1 Encoding Rules (BER/DER/CER)

 

Client and Server API Examples

The following examples show the command interface and output examples from the SmartGridware® IEC61850 Client Command Tool (click to view):



Client Command Tool Interface


   alias [{alias-name}] | alias add {alias} {cmd} {args}* | alias del {alias}

   assoc (-auth {auth-info-regex} |-abort|-release|-accept|-reject|-noauth
   | -inhibit | -allow

   get  {object-ref}+   : perform a GetDataValues operation

   getnamelist [LD|DA|DS|LOG]   : perform a GetNameList operation

   help {command-name}

   info  [{ied-label}]   : print detailed info about the IED logging

   list {type} {regex}* : list elements. {type}= client|ld|ln|fc|vdo|da|ds|rcb

   listen (-r[egister]  {node-ref}* ) | -i[nhibit] | -a[llow] | -u[nregister]

   operate [-sbo|-sbow|-cancel] [options] {ctl-do} {ctl-value}:operate a control

   print   {data-name}+   : print out the specified data

   quit  : exit the application .

   rcb (-reserve {args} *) |  (-unreserve {rcb-name})

   set [{da-name} {da-value}]+ : one or more DA values.

   status

   usage {command-name}

   verbose  [true|false]   : change verbose output status

   - history operations -

   ! | h[istory]     : print command history

   !!                : exec last command

   !{cmd#}           : exec command # {cmd#}

   !{cmd#}  {alias}  : create an alias for command # {cmd#}

         

Example LN Printout

            
    
[CLIENT#SGWDeviceA1:0.0.0.0]> p LPHD1

[LN] LPHD1 (LPHD)
     [INS] PhyHealth (INS)                
          [DA] stVal       {i8}           0
          [DA] q           {Quality}      [0000000000000]
          [DA] t           {timestamp}    u09/30/2015_00:53:35.337[00000000]
          [DA] d           {vs255}        "OK"
     [SPS] Proxy (SPS)                    
          [DA] stVal       {bool}         false
          [DA] q           {Quality}      [0000000000000]
          [DA] t           {timestamp}    u09/30/2015_00:53:35.337[00000000]
     [DPL] PhyNam (DPL)                   
          [DA] vendor      {vs255}        "Monfox, LLC"
          [DA] hwRev       {vs255}        "R4.1-SmartGridware-61850-HW"
          [DA] swRev       {vs255}        "R4.1-SmartGridware-61850-SW"
          [DA] serNum      {vs255}        "123456789"


         

Example List Printout

           
[CLIENT#SGWDeviceA1:0.0.0.0]> list do


[DOs]:

   ExGGIO1.AnIn1
   ExGGIO1.AnOut1
   ExGGIO1.Alm1
   ExGGIO1.Beh
   ExGGIO1.CmdBlk
   ExGGIO1.CntRs1
   ExGGIO1.DPCS01
   ExGGIO1.Health
   ExGGIO1.ISCS01
   ExGGIO1.Ind1
   ExGGIO1.Loc
   ExGGIO1.Mod
   ExGGIO1.SPCS01
   ExGGIO1.Wrn1
   ExGGIO1.NamPlt
   LLN0.Beh
   LLN0.Health
   LLN0.Mod
   LLN0.NamPlt
   LLN0.URCB101
   LLN0.URCB102
   LLN0.URCB103
   LLN0.BRCB101
   LLN0.BRCB102
   LLN0.BRCB103
   LLN0.gocbSTATUS
   LPHD1.PhyHealth
   LPHD1.Proxy
   LPHD1.PhyNam
         

Example LLN0.Mod Get and Print


[CLIENT#SGWDeviceA1:0.0.0.0]> get LLN0.Mod
    
   LLN0$ST$Mod => { 1, [0000000000000], u09/30/2015_01:09:10.433[00000000] }
   LLN0$CO$Mod => { { 1, { 0, ''h }, 0, u01/01/1970_00:00:00.000[00000000], 
                     false, [00]() } }
   LLN0$CF$Mod => { 0 }

[CLIENT#SGWDeviceA1:0.0.0.0]> p LLN0.Mod

[ENC] Mod (ENC)                      
     [DA] stVal                {Mod}          on
     [DA] q                    {Quality}      [0000000000000]
     [DA] t                    {timestamp}    u09/30/2015_01:01:09:10.433[00000000]
     [DA] Oper                          
          [DA] ctlVal          {Mod}          on
          [DA] origin                   
               [DA] orCat      {orCat}        not-supported
               [DA] orIdent    {oct64}        ''h
          [DA] ctlNum          {i8u}          0
          [DA] T               {timestamp}    u01/01/1970_00:00:00.000[00000000]
          [DA] Test            {bool}         false
          [DA] Check           {Check}        [00]()
     [DA] ctlModel             {CtlModel}     status-only

[ready]: 


         

Time Activated Operate Example


[CLIENT#SGWDeviceA1:0.0.0.0]> operate -?

   usage: operate [-direct|-sbo|-sbow|-cancel] [OPTIONS] <control-DO> 
                                     <ctl-value> : operate a control

   OPTIONS

     -n | -check:none           : Check NONE
     -b | -check:both           : Check interlocking and synchro
     -i | -check:interlocking   : Check interlocking
     -s | -check:synchro        : Check synchro

     -t[est]                    : set the 'test' flag
     -ta     <delay>[h|m|s|ms]  : operate in >delay> time 



[CLIENT#SGWDeviceA1:0.0.0.0]> operate -b -ta 5s -direct ExGGIO1.AnOut1 850


[ready]: done
[CLIENT#SGWDeviceA1:0.0.0.0]> 
[ready]: 

   [TIME_ACTIVED_SUCCESS]: ExGGIO1.AnOut1


[CLIENT#SGWDeviceA1:0.0.0.0]> 
[ready]: 

   [COMMAND_TERMINATION_SUCCESS]: ExGGIO1.AnOut1


[CLIENT#SGWDeviceA1:0.0.0.0]> 
         

Platform Requirements

 

Java Platform Requirements:

The SmartGridware® IEC61850 Data Logger software requires the following Java Development Kit in order to develop applications:

In order to install or upgrade your installed JDK version, please visit the Oracle Java Developers page at:


Operating System Requirements:

The core Client API will work on any operating system which supports the Java versions listed in the Java Platform Requirements section above. Some of the operating systems commonly used with SmartGridware™ products are:

  • Microsoft Windows (95,98,XP,NT,2000,7,8)
  • Linux (Redhat, etc)
  • Hewlett Packard HP-UX
  • Sun Solaris (SPARC & x86)
  • IBM AIX
  • Apple MacOS X

Note that for GOOSE and Sampled Value support, only Windows, MacOSX and Linux are supported and require the use of the PCAP library as detailed above

Hardware Requirements:

Minimum Hardware
  • Physical memory (RAM): 256MB
  • Disk space: 30MB (distribution package size)