SmartGridware® Java MMS Stack SDK

• 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 TCP/IP T-Profile (RFC1006) (6.2.3)

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

   // --
   // -- Create the MMS API
   // --
   MMSAPI mms_api = new MMSAPI();

   //-- uri format: 
   //  rfc1006://host[:port]/tsel/ssel/psel/ap-title/aeq[?auth={auth-str}
   String remote_uri = 

      "rfc1006://" + host_port + 

          "/0x0001/0x0001/0x00000001/1,1,999,1,1/12"
        + "?auth=-user#me,-pass#mypass";

   System.out.println("CONNECTING TO: " + remote_uri);

   // --
   // -- connect to the remote MMS server
   // --
   MMS mms = mms_api.connect(remote_uri);
         

   List name_list = new Vector();

   // -- get the names of all LDs in the IED
   MMS_GetNameList_Req request = 
        new MMS_GetNameList_Req(ObjectClass.domain,
                                ObjectScope.vmdSpecific);


   do
   {
      // -- send the request
      MMS_GetNameList_PendingRequest pr = mms.send(request, 30);
	  
      // -- wait for the response and return it
      MMS_GetNameList_Rsp rsp = pr.rsp();
      
      // -- add names t
 	  name_list.addAll(rsp.getIdentifiers());
	        
      // -- returns a non-null request if isMore is true
      request = pr.newContinuationRequest(); 
   }
   while(request != null);
         

   // -- ObjectName target for LD/VariableName
   ObjectName obj_name = ObjectName.Domain("DynDevice", "LLN0$NamPlt");
 
   // -- create the MMS-Read request for the target LD/variable
   MMS_Read_Req read_req = new MMS_Read_Req(target);

   // -- send the request, 30 second timeout
   MMS_Read_PendingRequest pr = mms.send(read_req, 30);

   // -- block for and return the MMS-Read response
   MMS_Read_Rsp rsp = pr.rsp();

   // -- check for error
   if (!rsp.isResult())
   {
      // -- handle the error
      return;
   }
      
   // -- now get the actual Data instance from the response
   List<AccessResult> result_list = rsp.getAccessResultList();
   
   AccessResult result = result_list.get(0);
   
   Data data = result.getData();

   // -- Now you can access the data retrieved for tha variable	 
         

   // -- Create the target object name
   ObjectName target = ObjectName.Domain("DynDevice1", "LLN0");

   // -- Create the request to get the data definitions
   MMS_GetVariableAccessAttributes_Req var_request =
                  new MMS_GetVariableAccessAttributes_Req(target);

   // -- send the request, block, and return the response
   MMS_GetVariableAccessAttributes_Rsp var_rsp = 
                         mms.send(var_request, 30).rsp();
      
   // -- check to verify valid result
   if (!var_rsp.isResult())
   {
      System.out.println("ERROR: " + var_rsp);
      return;
   }
      
   // -- TypeDesc structure contains the type definition
   TypeDesc type_desc = var_rsp.getTypeDescription();

   System.out.println(target + " == " + type_desc);