org.openiec61850
Class ClientSAP

java.lang.Object
  extended by org.openiec61850.ClientSAP

public class ClientSAP
extends java.lang.Object


Constructor Summary
ClientSAP()
           
 
Method Summary
 ClientAssociation associate(java.lang.String serverAccessPointReference, java.lang.String authenticationParameter, int connectTimeout)
          For the MMS-Mapping the ServerAccessPointReference should be of the form "ip:port" or "domain:port" or simply "ip" or "domain".
 ClientAssociation associate(java.lang.String serverAccessPointReference, java.lang.String authenticationParameter, int connectTimeout, int messageTimeout, int messageFragmentTimeout)
           
 void setMaxPduSize(int maxPduSize)
          Set the maximum MMS Pdu size in bytes.
 void setMaxTpduSizeParam(int maxTpduSizeParam)
          Set the maxTpduSize.
 void setProposedDataStructureNestingLevel(int proposedDataStructureNestingLevel)
           
 void setProposedMaxServOutstandingCalled(int proposedMaxServOutstandingCalled)
           
 void setProposedMaxServOutstandingCalling(int proposedMaxServOutstandingCalling)
           
 void setTSelLocal(byte[] tSelLocal)
           
 void setTSelRemote(byte[] tSelRemote)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ClientSAP

public ClientSAP()
Method Detail

setMaxPduSize

public void setMaxPduSize(int maxPduSize)
Set the maximum MMS Pdu size in bytes. The default size is 65000.

Parameters:
maxPduSize - should be at least MINIMUM_PDU_SIZE

setProposedMaxServOutstandingCalling

public void setProposedMaxServOutstandingCalling(int proposedMaxServOutstandingCalling)

setProposedMaxServOutstandingCalled

public void setProposedMaxServOutstandingCalled(int proposedMaxServOutstandingCalled)

setProposedDataStructureNestingLevel

public void setProposedDataStructureNestingLevel(int proposedDataStructureNestingLevel)

setTSelRemote

public void setTSelRemote(byte[] tSelRemote)

setTSelLocal

public void setTSelLocal(byte[] tSelLocal)

setMaxTpduSizeParam

public void setMaxTpduSizeParam(int maxTpduSizeParam)
Set the maxTpduSize. The default maximum TPDU size is 65531 (see RFC 1006). Only use this function if you want to change this.

Parameters:
maxTpduSizeParam - The maximum length is equal to 2^(maxTPDUSizeParam) octets. Note that the actual TSDU size that can be transfered is equal to TPDUSize-3. Default is 65531 octets (see RFC 1006), 7 <= maxTPDUSizeParam <= 16, needs to be set before listening or connecting

associate

public ClientAssociation associate(java.lang.String serverAccessPointReference,
                                   java.lang.String authenticationParameter,
                                   int connectTimeout)
                            throws ServiceError,
                                   java.lang.IllegalArgumentException
For the MMS-Mapping the ServerAccessPointReference should be of the form "ip:port" or "domain:port" or simply "ip" or "domain". The default port is 102. The AuthenticationParamter has no effect for the MMS-Mapping because Version 1.0 of IEC61850-8-1 does not support authentication. The Associate service which tries to connect and build an association to an IEC 61850 server.

Parameters:
serverAccessPointReference - the syntax of this parameter is mapping specific
authenticationParameter - the syntax of this parameter is mapping specific
connectTimeout - the time in milliseconds after which the TCP/IP connection attempt shall be aborted and a service error is thrown
Throws:
ServiceError
java.lang.IllegalArgumentException

associate

public ClientAssociation associate(java.lang.String serverAccessPointReference,
                                   java.lang.String authenticationParameter,
                                   int connectTimeout,
                                   int messageTimeout,
                                   int messageFragmentTimeout)
                            throws ServiceError,
                                   java.lang.IllegalArgumentException
Throws:
ServiceError
java.lang.IllegalArgumentException