BACnetClientSubscribeCOVProperty (FB)

FUNCTION_BLOCK PUBLIC FINAL BACnetClientSubscribeCOVProperty EXTENDS BACnetClientBase

Common Behaviour Model conform (ETrigA) FB to execute a Subscribe-COV-Property-Request in the BACnet-Network. If execution completed successfully and xDone is TRUE, the COV-Property-Subscription was successful. In any other case eStatus and errorResult may hold additional information of what failed.

InOut:

Scope

Name

Type

Initial

Comment

Inherited from

Input

xExecute

BOOL
Rising edge: Starts defined operation
FALSE: Resets the defined operation after ready condition was reached

ETrigATo

xAbort

BOOL

TRUE: Aborts the operation

ETrigATo

udiTimeOut

UDINT

Max. operating time for executing [µs], 0: No operating time limit

ETrigATo

Output

xDone

BOOL

TRUE: Ready condition reached

ETrigATo

xBusy

BOOL

TRUE: Operation is running

ETrigATo

xError

BOOL

TRUE: Error condition reached

ETrigATo

xAborted

BOOL

TRUE: Abort condition reached

ETrigATo

Input

dwTargetDeviceNumber

DWORD

The device number of the targeted device in the BACnet- Network.

BACnetClientBase

pTargetDeviceAddress

POINTER TO CmpBACnet.IEC_BACNET_ADDRESS

0

Optional: The device address of the targeted device in the BACnet-Network. If an adress is given the given device number is ignored.

BACnetClientBase

Output

eStatus

CmpBACnet.IEC_BACNET_STATUS

CmpBACnet.IEC_BACNET_STATUS.BACNET_STATUS_OK

If an error occured, the error state.

BACnetClientBase

errorResult

CmpBACnet.IEC_BACNET_ERROR

STRUCT(tag := CmpBACnet.IEC_BACNET_FAILURE_TYPE._FAILURE_MAX_SIZE)

If an error occured (this means eStatus <> BACNET_STATUS_OK), whereas the sent BACnet-Request was answered with an specific error information, the latter is contained in this structure.

BACnetClientBase

iState

DINT

0
The State in which the FB is during execution:

  • 0: No execution, resetted state

  • 1: Searching for the Target-Device and a valid address for it

  • 2: Sending the BACnet-Request into the network

  • 3: Waiting for the answer (if there is one) to the BACnet-Request made in 2

  • 4: Finishing the call, setting of the output variables

BACnetClientBase

Input

xSubscribe

BOOL

TRUE

Describes whether the COV subsciption shall be made/renewed or deleted.

xIssueConfirmedNotifications

BOOL

Describes whether confirmed or unconfirmed COV notification shall be send by the COV-Provider.

lifetime

CmpBACnet.IEC_BACNET_UNSIGNED

Lifetime of the COV-Subscription in seconds. Use 0 for infinite lifetime.

monitoredObjType

CmpBACnet.IEC_BACNET_OBJECT_TYPE

Object type of the monitored object under the targeted device.

monitoredObjInst

CmpBACnet.IEC_BACNET_DWORD

Object instance of the monitored object under the targeted device.

monitoredPropID

CmpBACnet.IEC_BACNET_PROPERTY_ID

Property-ID of the property under the targeted object the COV subcription shall be made for.

monitoredPropIndex

CmpBACnet.IEC_BACNET_SIGNED

Element index in the targeted property for which the COV subscription shall be made for.

covIncrement

CmpBACnet.IEC_BACNET_REAL

The COV increment the COV subscription shall use.

Properties:

Methods:

Structure: