SmartGridware® Java Mini61850™ Client/Server SDK

• 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 & GOOSE
• IEC 61850-6: Configuration Description Language (SCL)

• IEC 61850-8-1 Client/Server Services (MMS) (6.2.1)
• IEC 61850-8-1 Client/Server A-Profile (6.2.2)
• IEC 61850-8-1 GOOSE/GSE A-Profile (6.2.2)
• IEC 61850-8-1 TCP/IP T-Profile (RFC1006) (6.2.3)
• IEC 61850-8-1 GOOSE over ISO/IEC 8802-3 (No link redundancy)

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

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

  Mini61850Api api = new Mini61850Api();


   // -- 
   // -- Create a new server instance with the provided options... 
   // -- 
   Mini61850Server server = api.newServer("-scl:strict SGWDeviceA1.icd -xt MySim ;

   server.startServer();
         

   // -- Attach an association listener to handle new associations 
   // -- and association changes

   server.setAssocHandler(new AssocHandler()
   {
      // -- authenticate an incoming association request using authentication 
      // -- info if provided. throw an exception to deny an association request.
     public String authenticate(AssocHandle assoc, 
                                String auth_info) throws MiniServiceException
      {
         System.out.println("[authenticate]:"+assoc+",auth-info:"+auth_info);
         return null;
      }

      // -- invoked when an association state changes. 
      public void associationChanged(AssocHandle assoc)
      {
         System.out.println("[association]["+assoc.getStatus()+"]:"+assoc);
      }
   });

         

      // -- 
  // -- Set an Operation handler to process test/operate states on controls
  // -- 
  server.setOpHandler(new OpHandler()
  {
     // -- performTest is invoked for PARAMETER, INTERLOCKING, SYNCHRO tests. 
     // --
     public boolean performTest(Op op, Object ctl_val, 
                                OPTEST op_test) throws MiniControlException
     {
        System.out.println(op+"[perform-test]:"+op_test+"/ctl-val="+ctl_val);
        // -- May throw a MiniControlException for failed tests
        return false; // tell the API to also perform default tests
     }

     // -- performOperate is invoked to operate the control once all tests 
     // -- have passed. If the operate fails, the MiniControlException may 
     // -- be thrown to notify the failure for enhanced security operations. 
     public Object performOperate(Op op, Object ctl_val) 
                                  throws MiniControlException
  
     {
        System.out.println(op+"[perform-operate]OPERATE/ctl-val="+ctl_val);

        // -- perform actual output control here... 
        return ctl_val;
     }
     // -- Setting the control handler for multiple controls
  }, "ExGGIO1.AnOut1", "ExGGIO1.SPCS01");

         

   // -- Get a NodeHandle that represents the ExGGIO1 LN
   NodeHandle exggio1_handle = server.getNodeHandle("ExGGIO1");

   // -- print out ExGGIO1 structure
   System.out.println(exggio1_handle);

   // -- get and print the instMag value
   int current_mx_val = server.getNumber("ExGGIO1.AnIn1.instMag").intValue();
   System.out.println("ExGGIO1.AnIn1.instMag: " + current_mx_val);

   NodeHandle lln0_handle = server.getNodeHandle("SGWDeviceA1/LLN0");
   NodeHandle alm1_handle = server.getNodeHandle("ExGGIO1.Alm1");
   // -- iterate over Alm1's children and print out child value
   for (NodeHandle child : alm1_handle.getChildren())
   {
      System.out.println("  child[" + child.getName() + "] == " 
                          + child.getValueNotation());
   }
         

   Mini61850Api api = new Mini61850Api();

   // -- Create a new Client initialized from the provided ICD file. This will
   // -- populate the data structures in the local memory for API access. 
   // --    -scl <scl-filename> : The SCL filename
   // --    -retry <period>    : set the association retry period 
   Mini61850Client client =  api.newClient(
            "-scl SGWDeviceA1.icd -retry 5s -cli -a 'user#admin passwd#pass'");

         

   // -- Get list of all data names from the Server
   List<String> data_names = client.performGetDirectory(DIRTYPE.DATA);
   System.out.println("DATA: " + data_names);


   // -- perform a GetDataValues on all LNs in the Server
   // -- to refresh the values in the local model 
   client.performGet);

         

   // -- Attach a listener to the client to receive changes in association status
   // -- The listener will be invoked immediately if the association is already up.
   client.setAssocListener(new AssocListener()
   {
      public void associationChanged(AssocHandle assoc)
      {
         if (assoc.getStatus() == ASSOC_STATUS.UP)
         {
            // -- refresh the local data and reserve RCB(s)
            try
            {
               // -- refresh ALL the local data mode through GetDataValues
               // -- requests again the server
               assoc.getClient().performGet();

               // -- reserve RCBs to get events. 
               String rcb = assoc.getClient().performReserveRCB(true,
                                               "ExGGIO1.IOValues");
            }
            catch (Exception ex)
            {
               System.out.println("Cannot refresh/reserve RCB: " + ex);
            }
         }
      }
   });

         

   // -- Attach a change listener to the client for the specified LD. 
   client.addChangeListener(new StringChangeListener()
   {
      // -- invoked for each leaf node change received from server
      public void valueChanged(NodeHandle reg_node,
                               NodeHandle chg_node,
                               String old_value,
                               String new_value)
      {
         System.out.println("[changed][" + chg_node.getReference()+"]: "
                 + old_value + " ==> " + new_value);
      }
   }, "SGWDeviceA1");
         

   NodeHandle exggio1 = client.getNodeHandle("ExGGIO1");

   // -- set some values on the server
   Map<String, Object> set_result = exggio1.performSet(
           "AnOut1.minVal", 90,
           "AnOut1.maxVal", 1000,
           "AnOut1.stepSize", 80);

         

   // -- Use the NodeHandle API to get some values and print them out. 

   NodeHandle lln0 = client.getNodeHandle("LLN0");

   String beh = lln0.getString("Beh.stVal");
   int beh_int = lln0.getNumber("Beh.stVal").intValue();

   String health = lln0.getString("Health.stVal");
   int health_int = lln0.getNumber("Health.stVal").intValue();

   System.out.println("\nLLN0.Beh:   "+beh+"("+beh_int+")\n");
   System.out.println("\nLLN0.Health:"+health+"("+health_int+")\n");

         

   try
   {
      // -- operate the AnOut1 control to change the mxVal
      exggio1.performOperate("AnOut1", 100,
                              OPFLAG.INTERLOCKING, OPFLAG.SYNCHRO);
   }
   catch (MiniException ex)
   {
      System.out.println("ERROR: " + ex);
   }
         

  <DOI name="CntRs1">
    <Private type="MySim">
       <!-- To enable simulation use option '-xt MySim' -->
       <SvXt:CounterSim ref="actVal" maxVal="1000" 
                        minVal="0" inc="1" sample="5/m" 
                        updateTime="true" inhibitChange="false" />
    </Private>
    <DAI name="frPd">
       <Val>5000</Val>
       </DAI>
       <DAI name="frRs">
       <Val>false</Val>
    </DAI>
  </DOI>

  <DOI name="AnIn1">
     <Private type="MySim">
        <!-- To enable simulation use option '-xt MySim' -->
        <SvXt:FunctionSim ref="instMag" maxVal="100" minVal="0" 
                          freq="1/m" sample="0" function="sine" 
                          updateTime="false" inhibitChange="true" />
        </Private>
         

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

         

available commands:
            
   alias [{alias-name}]  |  alias add {alias} {cmd} {args}*  
                   |  alias del {alias} 
            
   assoc (-auth {auth-info-regex} | -abort | -release | -accept 
        | -reject | -noauth | -inhibit | -allow 
            
   control [OPTIONS] {control-DO}  :  configure a control
           
   help {command-name}

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

   list {type} {regex}* : list. {type}= server|ld|ln|fc|vdo|da|ds|rcb|
   
   listen (-r[egister]  {ref}* ) | -i[nhibit] | -a[llow] | -u[nregister]

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

   quit  : exit the application .

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