IEC 61131-3 C Tools User Manual

IEC 61131-3 C Tools Structures and Types



The DNP_MESSAGE_TIMEOUT event indicates that DNP has attempted to send an unsolicited message but did not receive confirmation after all attempts. This usually means there is a communication problem. DNP sends this event to the application. The application should process this event by disconnecting.

dnpConfiguration

The dnpConfiguration type describes the DNP parameters. typedef struct dnpConfiguration_type

{

UINT16 masterAddress;

UINT16 rtuAddress;

CHAR datalinkConfirm;

CHAR datalinkRetries;

UINT16 datalinkTimeout;

UINT16 operateTimeout;

UCHAR applicationConfirm;

UINT16 maximumResponse;

UCHAR applicationRetries;

UINT16 applicationTimeout;

INT16 timeSynchronization;

UINT16 BI_number;

UINT16 BI_startAddress;

CHAR BI_reportingMethod;

UINT16 BI_soebufferSize;

UINT16 BO_number;

UINT16 BO_startAddress;

UINT16 CI16_number;

UINT16 CI16_startAddress;

CHAR CI16_reportingMethod;

UINT16 CI16_bufferSize;

UINT16 CI32_number;

UINT16 CI32_startAddress;

CHAR CI32_reportingMethod;

UINT16 CI32_bufferSize;

CHAR CI32_wordOrder;

UINT16 AI16_number;

UINT16 AI16_startAddress;

CHAR AI16_reportingMethod;

UINT16 AI16_bufferSize;

UINT16 AI32_number;

UINT16 AI32_startAddress;

CHAR AI32_reportingMethod;

UINT16 AI32_bufferSize;

CHAR AI32_wordOrder;

UINT16 AISF_number;

UINT16 AISF_startAddress;

CHAR AISF_reportingMethod;

UINT16 AISF_bufferSize;

CHAR AISF_wordOrder;

UINT16 AO16_number;

UINT16 AO16_startAddress;

UINT16 AO32_number;

UINT16 AO32_startAddress;

Document (Version 2.50) 5/12/2011 475 475

IEC 61131-3 C Tools Structures and Types

CHAR AO32_wordOrder;

UINT16 AOSF_number;

UINT16 AOSF_startAddress;

CHAR AOSF_wordOrder;

UINT16 autoUnsolicitedClass1;

UINT16 holdTimeClass1;

UINT16 holdCountClass1;

UINT16 autoUnsolicitedClass2;

UINT16 holdTimeClass2;

UINT16 holdCountClass2;

UINT16 autoUnsolicitedClass3;

UINT16 holdTimeClass3;

UINT16 holdCountClass3;

} dnpConfiguration;

 masterAddress is the address of the master station. Unsolicited messages are sent to this station. Solicited messages must come from this station.

Valid values are 0 to 65534.

 rtuAddress is the address of the RTU. The master station must send messages to this address. Valid values are 0 to 65534.

 datalinkConfirm enables requesting data link layer confirmations. Valid values are TRUE and FALSE.

 datalinkRetries is the number of times the data link layer will retry a failed message. Valid values are 0 to 255.

 datalinkTimeout is the length of time the data link layer will wait for a response before trying again or aborting the transmission. The value is measured in milliseconds. Valid values are 100 to 60000 in multiples of 100 milliseconds.

 operateTimeout is the length of time an operate command is valid after receiving a select command. The value is measured in seconds. Valid values are 1 to 6500.

 applicationConfirm enables requesting application layer confirmations. Valid values are TRUE and FALSE.

 maximumResponse is the maximum length of an application layer response.

Valid values are 20 to 2048. The recommended value is 2048 unless the master cannot handle responses this large.

 applicationRetries is the number of times the application layer will retry a transmission. Valid values are 0 to 255.

 applicationTimeout is the length of time the application layer will wait for a response before trying again or aborting the transmission. The value is measured in milliseconds. Valid values are 100 to 60000 in multiples of 100 milliseconds. This value must be larger than the data link timeout.

 timeSynchronization defines how often the RTU will request a time synchronization from the master.

Document (Version 2.50) 5/12/2011 476 476

IEC 61131-3 C Tools Structures and Types



Set this to NO_TIME_SYNC to disable time synchronization requests.



Set this to STARTUP_TIME_SYNC to request time synchronization at start up only.



Set this to 1 to 32767 to set the time synchronization period in seconds.



BI_number is the number of binary input points. Valid values are 0 to 9999.



BI_startAddress is the DNP address of the first Binary Input point.



BI_reportingMethod determines how binary inputs are reported either

Change Of State or Log All Events.



BI_bufferSize is the Binary Input Change Event Buffer Size.



BO_number is the number of binary output points. Valid values are 0 to

9999.



BO_startAddress is the DNP address of the first Binary Output point.



CI16_number is the number of 16-bit counter input points. Valid values are 0 to 9999.



CI16_startAddress is the DNP address of the first CI16 point.



CI16_reportingMethod determines how CI16 inputs are reported either

Change Of State or Log All Events.



CI16_bufferSize is the number of events in the 16-bit counter change buffer.

Valid values are 0 to 9999.



CI32_number is the number of 32-bit counter input points. Valid values are 0 to 9999.



CI32_startAddress is the DNP address of the first CI32 point.



CI32_reportingMethod determines how CI32 inputs are reported either

Change Of State or Log All Events.



CI32_bufferSize is the number of events in the 32-bit counter change buffer.

Valid values are 0 to 9999.



CI32_wordOrder is the Word Order of CI32 points (0=LSW first, 1=MSW first).



AI16_number is the number of 16-bit analog input points. Valid values are 0 to 9999.



AI16_startAddress is the DNP address of the first AI16 point.



AI16_reportingMethod determines how 16-bit analog changes are reported.



Set this to FIRST_VALUE to report the value of the first change event measured.



Set this to CURRENT_VALUE to report the value of the latest change event measured.

Document (Version 2.50) 5/12/2011 477 477

IEC 61131-3 C Tools Structures and Types



AI16_bufferSize is the number of events in the 16-bit analog input change buffer. Valid values are 0 to 9999.



AI32_number is the number of 32-bit analog input points. Valid values are 0 to 9999.



AI32_startAddress is the DNP address of the first AI32 point.



AI32_reportingMethod determines how 32-bit analog changes are reported.



Set this to FIRST_VALUE to report the value of the first change event measured.



Set this to CURRENT_VALUE to report the value of the latest change event measured.



AI32_bufferSize is the number of events in the 32-bit analog input change buffer. Valid values are 0 to 9999.



AI32_wordOrder is the Word Order of AI32 points (0=LSW first, 1=MSW first)



AO16_number is the number of 16-bit analog output points. Valid values are

0 to 9999.



AO16_startAddress is the DNP address of the first AO16 point.



AO32_number is the number of 32-bit analog output points. Valid values are

0 to 9999.



AO32_startAddress is the DNP address of the first AO32 point.



AO32_wordOrder is the Word Order of AO32 points (0=LSW first, 1=MSW first)



AOSF_number is the number of short float Analog Outputs.



AOSF_startAddress is the DNP address of first AOSF point.



AOSF_wordOrder is the Word Order of AOSF points (0=LSW first, 1=MSW first).

 autoUnsolicitedClass1 enables or disables automatic Unsolicited reporting of

Class 1 events.

 holdTimeClass1 is the maximum period to hold Class 1 events before reporting

 holdCountClass1 is the maximum number of Class 1 events to hold before reporting.

 autoUnsolicitedClass2 enables or disables automatic Unsolicited reporting of

Class 2 events.

 holdTimeClass2 is the maximum period to hold Class 2 events before reporting

 holdCountClass2 is the maximum number of Class 2 events to hold before reporting.

Document (Version 2.50) 5/12/2011 478 478