This module represents the BACnet Confirmed COV Notification service.
The Confirmed COV Notification service is used to notify a subscriber of a changed value or changed values and requires an acknowledge by the subscriber of reception of this event notification.
Service Description (ASHRAE 135)
The ConfirmedCOVNotification service is used to notify subscribers about changes that may have occurred to the properties of a particular object. Subscriptions for COV notifications are made using the SubscribeCOV service or the SubscribeCOVProperty service.
Service Procedure (ASHRAE 135)
After verifying the validity of the request, the responding BACnet-user shall take whatever local actions have been assigned to the indicated COV and issue a 'Result(+)' service primitive. If the service request cannot be executed, a 'Result(-)' service primitive shall be issued indicating the error encountered.
Result(-) Errors (ASHRAE 135)
The 'Result(-)' parameter shall indicate that the service request has failed. The reason for failure shall be specified by the 'Error Type' parameter.
The 'Error Class' and 'Error Code' to be returned for specific situations are as follows:
| Situation | Error Class | Error Code |
|---|---|---|
| No subscription exists for the specified object, property, and process identifier. Devices may ignore this condition and return a BACnet-SimpleACK-PDU. | SERVICES | UNKNOWN_SUBSCRIPTION |
Summary
Functions
Whether the service is of type confirmed or unconfirmed.
Converts the given Confirmed Service Request into a Confirmed COV Notification Service.
Get the service name atom.
Get the Confirmed Service request for the given Confirmed COV Notification Service.
Types
@type t() :: %BACnet.Protocol.Services.ConfirmedCovNotification{ initiating_device: BACnet.Protocol.ObjectIdentifier.t(), monitored_object: BACnet.Protocol.ObjectIdentifier.t(), process_identifier: BACnet.Protocol.ApplicationTags.unsigned32(), property_values: [BACnet.Protocol.PropertyValue.t()], time_remaining: non_neg_integer() }
Parameters for the Confirmed COV Notification service.
Notifies a subscriber of property value changes on a monitored object. Includes the remaining subscription lifetime and the list of changed PropertyValues. Requires acknowledgment from the receiver.
Functions
@spec confirmed?() :: true
Whether the service is of type confirmed or unconfirmed.
@spec from_apdu(BACnet.Protocol.APDU.ConfirmedServiceRequest.t()) :: {:ok, t()} | {:error, term()}
Converts the given Confirmed Service Request into a Confirmed COV Notification Service.
@spec get_name() :: atom()
Get the service name atom.
@spec to_apdu(t(), Keyword.t()) :: {:ok, BACnet.Protocol.APDU.ConfirmedServiceRequest.t()} | {:error, term()}
Get the Confirmed Service request for the given Confirmed COV Notification Service.
See the BACnet.Protocol.Services.Protocol function documentation for more information.