User manual

IEC61131 User and Reference Manual
April 22, 2008
265
dnpunsol
Trigger a DNP unsolicited response message
Description
The dnpunsol function triggers a DNP unsolicited response message of the specified class
or classes.
The unsolicited response for the specified Classes (Cls0, Cls1, Cls2, Cls3) is triggered when
the enable input changes from OFF to ON. The error output is set to false if the message
was triggered successfully.
The error output is set to true if the unsolicited response message failed. The error output
indicates master addresses have not been configured in the DNP Routing Table, or the DNP
configuration has not been created.
dnpunsol
error
enable
Cls0
Cls1
Cls2
Cls3
Arguments
Inputs
Type
Description
enable
Boolean
Set to TRUE to trigger an unsolicited response message.
Cls0
Boolean
Enable Class 0 data in unsolicited response
Cls1
Boolean
Enable Class 0 data in unsolicited response
Cls2
Boolean
Enable Class 0 data in unsolicited response
Cls3
Boolean
Enable Class 0 data in unsolicited response
Outputs
Type
Description
error
Boolean
Returned error status.
Notes
The function sets internal flags to trigger a DNP unsolicited message, and returns
immediately. The DNP message will be sent some time after the function call.
DNP unsolicited messages do not have to be enabled in the Application Layer configuration
for events to be sent with this function. Unsolicited messages at Start Up must be enabled,
or the master must enable unsolicited messages before the first message can be sent.
If no events are pending an empty unsolicited message will be sent.
The message will be sent to the configured DNP master station or stations.