IEC_BACNET_COV_SUBSCRIPTION (STRUCT)

TYPE IEC_BACNET_COV_SUBSCRIPTION : STRUCT

This is a data structure representing value of a PROP_ACTIVE_COV_SUBSCRIPTIONS property in the device object. A Property Contents containing data of this type will have its tag equal to DATA_TYPE_COV_SUBSCRIPTION. The data type consists of a Recipient (which has the BACNET_RECIPIENT_PROCESS data type), a Monitored Property Reference (BACNET_OBJ_PROP_REFERENCE), an Issue Confirmed Notifications flag, a Time Remaining value (which is the number seconds of seconds before the subscription is expired), and an optional COV Increment (which is used for subscription to properties that have the Real data type). The BACNET_INFINITE_LIFETIME constant is used as a Time Remaining value for subscriptions that never expire.

InOut:

Name	Type	Comment
recipient	IEC_BACNET_RECIPIENT_PROCESS	The destination device(s) to receive notifications.
monitoredProperty	IEC_BACNET_OBJ_PROP_REFERENCE	This parameter, of type BACnetPropertyReference, contains the property identifier and optional array index for which a subscription is desired. If COV reporting is supported for a property that has an array datatype, it is a local matter to determine whether to support COV subscriptions for all elements of the array or only for particular elements in the array.
issueConfirmedNotifications	IEC_BACNET_BOOLEAN	The issueConfirmedNotifications attribute indicates whether the COV-server device shall issue ConfirmedCovNotification (TRUE) or UnconfirmedCovNotification (FALSE).
timeRemaining	IEC_BACNET_UNSIGNED	This parameter, of type Unsigned, contains the remaining lifetime of the subscription in seconds. A value of zero shall indicate an indefinite lifetime without automatic cancellation.
fCovIncrementPresent	IEC_BACNET_BOOLEAN	If set to True the covIncrement parameter is valid.
covIncrement	IEC_BACNET_REAL	This parameter, of type REAL, specifies the minimum change in the monitored property that will cause a COVNotification to be issued to subscriber COV-clients. This parameter is ignored if the datatype of the monitored property is not numeric. If the monitored property is Present_Value, its datatype is numeric, this parameter is not present, and the monitored object has a COV_Increment property, then the COV increment to use is taken from the COV_Increment property of the monitored object. The intent is to allow the subscriber to use a previously established COV increment from another subscription or to allow use of the COV_Increment property in the monitored object.