Function Description

The function block UA_MonitoredItemAddList is used to add multiple node handles to a subscription. It can define which variables will be subscribed to, and when a variable value will be refreshed according the IEC logic.

You can call this block only one time for one subscription.

Representation in FBD

Parameter Description

Input parameters:

Name

Type

Comment

EXECUTE

BOOL

FB performs its task on rising edge on this input.

SUBSCRIPTIONHDL

DWORD

Subscription handle.

NODEHDLCOUNT

UINT

Number of valid elements in the array to remove.

NODEHDLS

ANY_ARRAY_DWORD

Array of Monitored Node Handles

SYNCMODE

UINT

  • 0 = UAMSync_Unknown Default, this results into an error code – has to be set to one of the following options

  • 1 = UAMS_ControllerSync

  • 2 = UAMS_FwSync

For general concept of SyncModes see Monitoring Mode

NODEADDINFOS

AUANodeAdditionalInfo

Array of UANodeAdditionalInfo

TIMEOUT

TIME

Maximum time to response
Output parameters:

Name

Type

Comment

DONE

BOOL

FB has successfully completed its task

BUSY

BOOL

The FB is not finished and new output values are to be expected.

ERROR

BOOL

Signals that an error has occurred within the FB. Set to true is either ErrorID or any of the NodeErrorIDs indicates an error.

ERRORID

DWORD

Error code

NODEERRORIDS

ANY_ARRAY_DWORD

Array of DWORD. Contains an error code for each valid element of the NOEHDLS array.

MONITOREDITEMHDLS

ANY_ARRAY_DWORD

Array of monitored item handles.
Input / Output parameters:

Name

Type

Comment

VARIABLES

AUAMonitoredVariables

Array of UAMonitoredVariables

MONITORINGPARAMETERS

AUAMonitoringParameter

Array of UAMonitoringParameter

VALUESCHANGED

ANY_ARRAY_BOOL

Indicates that the values of the monitored item have been changed.

MINLOSTVALUECOUNT

ANY_ARRAY_UINT

Count the minimum lost values if queue size is > 1

Runtime Error

Refer to the Appendix for a list of OPC UA detected error codes.