|
The Language of BACnet - Objects, Properties and Services
Bill Swan Alerton Technologies, Inc.
BACnet™ (Building
Automation and Control Network) is the open data communications protocol which
has been developed over the past nine years by ASHRAE. In December of 1995,
BACnet was adopted by ANSI and is now an American National Standard (ANSI/ASHRAE
135-1995) and is under review by the International Standards Organization (ISO).
BACnet was created to end the frustration caused by the inability of proprietary
control systems to communicate with other systems within a building or other
manufacturers' systems.
BACnet provides the method by which computer-based control equipment from
different manufacturers can work together, or "interoperate." It allows
you to expand, mix and match equipment to better fit any size of building's
needs for the present and future. BACnet is designed to handle many types of
building controls, including HVAC, lighting, security, fire, access control,
maintenance, waste management and so forth.
BACnet provides a sophisticated model for describing building automation
systems of all types. This model is based on the ideas that for systems to be
truly interoperable, there must be agreement about various aspects of the
overall operation and the individual systems themselves. For the equipment to
work together, components must be able to exchange and understand BACnet
messages. BACnet specifies four types of local-area networks and a serial
(EIA-232) interface along with networking protocols to get the messages from one
device to another. The content of the messages, the BACnet language, is the
focus of the major portion of the BACnet standard.
Objects BACnet departs from traditional industry conventions with
its object-oriented nomenclature. The industry has long used the general-purpose
term "points", which could refer to sensor inputs, control outputs or control
values, with different characteristics according to manufacturer. BACnet instead
defines a standard set of "Objects", each of which has a standard set of
"Properties"; that describe the Object and its current status to other
devices on the BACnet internetwork. It is through these properties that the
Object may be controlled by other BACnet devices.
One of the standard BACnet objects is the Analog Input Object, which
represents an analog sensor input such as a thermistor. Figure 1 shows a diagram
of just such an Analog Input Object as it might be seen over the network through
five of its properties. Some of the properties-such as Description, Device_Type
and Units-are set during installation. Others, including Present_Value and
Out_Of_Service, provide status about the sensor input represented by the Analog
Input Object. Yet others (an Analog Input Object can have up to 25 Properties)
may be set by the equipment manufacturer. All may be read; in this example, a
query about the Present_Value Property of this Analog Input Object would get the
reply "68.0".
Figure 1. An Analog Input Object.
BACnet defines 18 standard types of Objects, listed in Table 1. The list is
intended to be comprehensive; each element of a complete building control system
is represented by one or more of the Objects, whether Analog Input for a sensor,
a Schedule for scheduling, or Notification Class for distributing alarms.
The choice of which Objects are present in a BACnet device is determined by
the device's function and capabilities. The BACnet standard does not require all
Objects in all BACnet devices. A device that controls a VAV box is likely to
have several Analog Input and Analog Output Objects while a Windows® workstation
that has neither sensor inputs nor control outputs will not.
Every BACnet device must have a Device Object, the Properties of which fully
describe the BACnet device to the network. The Object_List Property of the
Device Object, for example, provides a list of every Object contained within the
BACnet device. The Vendor_Name, Vendor_Identifier and Model_Name Properties
provide the manufacturer name and model of the device.
In addition, BACnet allows manufacturers to provide proprietary Objects,
which will not necessarily be accessible or understood by equipment from other
manufacturers. However, they will not interfere with standard BACnet objects.
Table 1. Standard BACnet Objects.
| OBJECT |
EXAMPLE OF USE |
| Analog Input |
Sensor input |
| Analog Output |
Control output |
| Analog Value |
Setpoint or other analog control system parameter |
| Binary Input |
Switch input |
| Binary Output |
Relay output |
| Binary Value |
Binary (digital) control system parameter |
| Calendar |
Defines a list of dates, such as holidays or special events, for
scheduling. |
| Command |
Writes multiple values to multiple objects in multiple devices to
accomplish a specific purpose, such as day-mode to night-mode, or
emergency mode. |
| Device |
Properties tell what objects and services the device supports, and
other device-specific information such as vendor, firmware revision,
etc. |
| Event Enrollment |
Describes an event that might be an error condition (e.g., "Input out
of range") or an alarm that other devices to know about. It can directly
tell one device or use a Notification Class object to tell multiple
devices. |
| File |
Allows read and write access to data files supported by the
device. |
| Group |
Provides access to multiple properties of multiple objects in a read
single operation. |
| Loop |
Provides standardized access to a "control loop." |
| Multi-state Input |
Represents the status of a multiple-state process, such as a
refrigerator's On, Off, and Defrost cycles. |
| Multi-state Output |
Represents the desired state of a multiple-state process (such as It's
Time to Cool, It's Cold Enough and it's Time to Defrost). |
| Notification Class |
Contains a list of devices to be informed if an Event Enrollment
object determines that a warning or alarm message needs to be sent. |
| Program |
Allows a program running in the device to be started, stopped, loaded
and unloaded, and reports the present status of the program. |
| Schedule |
Defines a weekly schedule of operations (performed by writing to
specified list of objects with exceptions such as holidays. Can use a
Calendar object for the exceptions. |
Properties The BACnet standard identifies 123 different Properties
of Objects. A different subset of these Properties is specified for each type of
Object. The BACnet specification requires that certain Properties must be
present for each Object; other specified Properties are optional. In either
case, the implemented Properties have specific behaviors defined by the
specification particularly those involved in alarm or event notifications and
those that have an effect upon control values or states.
A few of the standard Properties are required by the BACnet specification to
be writable while others may be writable at the manufacturer's discretion. All
may be read over the network.
BACnet does allow vendors to add proprietary Properties but, as with
proprietary Objects, the proprietary Properties may not be understood or
accessible by equipment from other manufacturers.
The Analog Input Object is representative of the Objects involved directly
with control elements and many of its Properties reflect this. Table 2 lists the
defined Properties of the Analog Input Object, along with typical or example
values for each property. For example, the Status_Flags, Event_State,
Reliability, Out_Of_Service, Min_Pres_Value, Max_Pres_Value, Notification_Class,
High_Limit, Low_Limit, Limit_Enable, Event_Enable, Acked_Transitions and
Notify_Type Properties all deal with the detecting of unusual and possibly
dangerous conditions at the sensor and generating the appropriate notifications
or alarms in response.
Table 2. Properties of the Analog Input Object.
| PROPERTY |
BACnet |
EXAMPLE |
| Object_Identifier |
Required |
Analog Input #1 |
| Object_Name |
Required |
"AI 01" |
| Object_Type |
Required |
Analog Input |
| Present_Value |
Required |
68.0 |
| Description |
Optional |
"Outside Air Temperature" |
| Device_Type |
Optional |
"10k Thermistor" |
| Status_Flags |
Required |
In_Alarm, Fault, Overridden,
Out_Of_Service flags |
| Event_State |
Required |
Normal (plus various problem-reporting states) |
| Reliability |
Optional |
No_Fault_Detected (plus various fault conditions) |
| Out_Of_Service |
Required |
False |
| Update_Interval |
Optional |
1.00 (seconds) |
| Units |
Required |
Degrees-Fahrenheit |
| Min_Pres_Value |
Optional |
-100.0, minimum reliably read value |
| Max_Pres_Value |
Optional |
+300.0, maximum reliably read value |
| Resolution |
Optional |
0.1 |
| COV_Increment |
Optional |
Notify if Present_Value changes by increment: 0.5 |
| Time_Delay |
Optional |
Seconds to wait before detecting out-of-range: 5 |
| Notification_Class |
Optional |
Send COV notification to Notification Class Object: 2 |
| High_Limit |
Optional |
+215.0, Upper normal range |
| Low_Limit |
Optional |
-45.0, Lower normal range |
| Deadband |
Optional |
0.1 |
| Limit_Enable |
Optional |
Enable High-limit-reporting, Low-limit-reporting. |
| Event_Enable |
Optional |
Enable To_Offnormal, To_Fault, To_Normal change
reporting. |
| Acked_Transitions |
Optional |
Flags indicating received acknowledgments for above changes. |
| Notify_Type |
Optional |
Events or Alarms |
The first three Properties listed-Object_Identifier, Object_Name and
Object_Type-must be present in every Object in a BACnet device.
The Object_Identifier is a 32-bit code that identifies the type of Object
(also identified by the Object_Type Property) and its "Instance" number,
which together uniquely identify the Object within its BACnet device.
Theoretically, a BACnet device could have over four million Objects of a
particular type. The Object_Name is a text string, which has a unique
capability. BACnet devices may broadcast queries for devices that contain
Objects with a specific Object_Name. This can greatly simplify project setup.
BACnet requires one Device Object to be present in every BACnet
device. The Device Object makes information about the device and its
capabilities available to other devices on the networks. Before one BACnet
device starts controls related communications with another, it needs to obtain
some of the information presented by the other device's Device Object. Table 3
gives an example of a Device Object for a BACnet Dual-Duct VAV controller.
Although the list of Properties is imposing, most are fixed by the manufacturer
and are read only by other BACnet devices.
Unlike other Objects, the Device Object's Instance number must be unique
across the entire BACnet internetwork because it is used to uniquely identify
the BACnet devices. It may be used to conveniently identify the BACnet device
from other devices during installation.
Table 3. Properties of the Device Object.
| PROPERTY |
BACnet |
EXAMPLE |
| Object_Identifier |
Required |
Device #1076 |
| Object_Name |
Required |
"Office 36 DD Control" |
| Object_Type |
Required |
Device |
| System_Status |
Required |
Operational (plus others) |
| Vendor_Name |
Required |
"Alerton Technologies, Inc." |
| Vendor_Identifier |
Required |
Alerton |
| Model_Name |
Required |
"VAV-DD Controller" |
| Firmware_Revision |
Required |
"1.0" |
| Application_Software_Version |
Required |
"Dual-Duct DDC" |
| Location |
Optional |
"Office 36, Floor 3" |
| Description |
Optional |
"(on network 5)" |
| Protocol_Version |
Required |
1 (BACnet protocol version) |
| Protocol_Conformance_Class |
Required |
2 |
| Protocol_Services_Supported |
Required |
readProperty, writeProperty, atomicWriteFile,... |
| Protocol_Object_Types_Supported |
Required |
Analog Input, Analog Output,... |
| Object_List |
Required |
Analog Input #1, Analog Input #2, ... |
| Max_APDU_Length_Supported |
Required |
50 (bytes or characters) |
| Segmentation_Supported |
Required |
No |
| VT_Classes_Supported |
Optional |
n/a |
| Active_VT_Sessions |
Optional |
n/a |
| Local_Time |
Optional |
12:30:15.22 |
| Local_Date |
Optional |
Tuesday, March 12, 1996 |
| UTC_Offset |
Optional |
+480 (minutes from GMT/UTM) |
| Daylight_Savings_Status |
Optional |
False (not in effect) |
| APDU_Segment_Timeout |
Optional |
n/a |
| APDU_Timeout |
Required |
3000 milliseconds |
| Number_Of_APDU_Retries |
Required |
0 |
| List_Of_Session_Keys |
Optional |
n/a |
| Time_Synchronization_Recipients |
Optional |
n/a |
| Max_Master |
Optional |
n/a |
| Max_Info_Frames |
Optional |
n/a |
| Device_Address_Binding |
Required |
None |
Services Services are the means by which one BACnet device
acquires information from another device, commands another device to perform
some actions, or announces to one or more devices that some event has taken
place. Each service request issued and service acknowledgment
(reply) returned becomes a message packet transferred over the network from the
sending to the receiving device.
An "application program" running on the BACnet device issues service
requests and processes them upon receipt. The application program is the actual
software that performs the operations of the device. In the case of an operator
workstation, the software might maintain a display of several sensor inputs for
the operator nad would periodically issue service requests to the appropriate
Objects in the target devices to obtain the latest value of the inputs. In the
monitored device, the service request would be processed in its application
program and the reply containing the requested data returned. This is depicted
in Figure 2.
Figure 2. Service Requests and Replies.
BACnet defines 32 Services and classifies them into five categories. These
Service categories are the Alarm and Event, File Access, Object Access, Remote
Device Management and Virtual Terminal Services. For each of the "Confirmed"
services (a reply, typically with data, is expected), labeled "C" in the
tables following, the BACnet device may have the ability to initiate the Service
request, or the ability to process and respond to a received request of that
type, or both. For each of the "Unconfirmed" (no reply is expected) services,
labeled "U" in the tables following, the BACnet device may have the
capability to initiate the Service request, or the ability to process a received
request of that type, or both.
BACnet devices are not required to implement every single Service. Just one
Service, ReadProperty, is required to be processed by all BACnet devices.
Depending upon the function and complexity of the device, additional Services
may be initiated or executed.
The Alarm and Event Services deal with changes in conditions seen by a BACnet
device including alarms. Alarms and events changes which might indicate problems
or error conditions, such as a sensor reading out of normal range or, for that
matter, returning to normal operation ("Events"); or a change in a reading (of
some increment since the previous report) termed "Change Of Value" or COV.
COV reporting is a useful alternative to repeatedly polling an Object for
some monitored value. A device containing a monitored Object could be subject to
network traffic congestion if many other devices were monitoring it; COV
reporting allows it to send out notices when a change occurs.
Alarm, Event and COV notifications are generated by the application program
monitoring Objects directly related to control operations: specifically, the
various Input, Output and Value Objects, as well as the Loop Object.
Table 4. Alarm and Event Services.
| SERVICE |
BACnet |
DESCRIPTION |
| AcknowledgeAlarm |
C |
Used to tell sender of alarm that a human has seen the alarm. |
| ConfirmedCOVNotification |
C |
Tells subscribing devices of the COV that occurred in a
property. |
| ConfirmedEventNotification |
C |
Used to tell sender of a possible error condition. |
| GetAlarmSummary |
C |
Requests from a device a list of "active alarms," if any. |
| GenEnrollmentSummary |
C |
Requests a list of "event" (possible error) generating objects. |
| SubscribeCOV |
C |
Sent by a device to request that it be told of COVs in an
object. |
| UnconfirmedCOVNotification |
U |
Tells subscribing devices that a change has occurred to one or more
properties of a particular object. |
File Access Services in BACnet are used to read and manipulate files in
BACnet devices. In BACnet, files represent group databytes of arbitrary length
and meaning; they do not necessarily relate to any kind of mass storage device.
Every BACnet-accessible file has a File Object associated with it.
The word "Atomic" in the service name merely means that only one read or
write operation can take place at a time. Other attempts to access the file
during an access will either fail or be held off.
At present there are no standard BACnet-defined files; by definition, all
file accesses are vendor proprietary though BACnet has reserved the EVENTLOG and
VALUELOG file types for file structures to be defined at a later date.
Table 5. File Access Services.
| SERVICE |
BACnet |
DESCRIPTION |
| AtomicReadFile |
C |
Requests part or all of a File object's file. |
| AtomicWriteFile |
C |
Writes to part or all of a File object's file. |
The Object Access Services provide the means to read, modify and write
Properties, and to add and delete Objects. Multiple Services are provided for
reading and writing properties; the purpose of the more complex Services
(ReadPropertyMultiple and WritePropertyMultiple) is to combine as many reads of
or writes to Properties of Objects within a BACnet device into a single message,
thus reducing network overhead. The ReadPropertyConditional Service goes a step
further; the device processing the request tests each referenced Property
according to criteria included in the request and returns the value only if the
criteria are met.
Although the CreateObject and DeleteObject Services are defined, they will
apply to a limited set of Objects. Objects attached to some physical device, for
instance, are not likely to be either creatable or deleteable. The Group and
Event Enrollment Objects, and possibly the File Object, are likely to be the
usual subjects of the CreateObject and DeleteObject Services.
Table 6. Object Access Services.
| SERVICE |
BACnet |
DESCRIPTION |
| AddListElement |
C |
Adds one or more items to a property that is a list. |
| RemoveListElement |
C |
Removes one or more items from a property that is a list. |
| CreateObject |
C |
Used to create a new instance of an object in the serving
device. |
| DeleteObject |
C |
Used to delete a particular object in the serving device. |
| ReadProperty |
C |
Returns a value of one property of one object. |
| ReadPropertyConditional |
C |
Returns the values of multiple properties in multiple objects. |
| ReadPropertyMultiple |
C |
Returns the values of multiple properties of multiple objects. |
| WriteProperty |
C |
Writes a value to one property of one object. |
| WritePropertyMultiple |
C |
Writes values to multiple properties of multiple
objects. |
The Remote Device Management Services, listed in Table 7, provide a number of
disparate functions, including operator control, specialized message transfer,
and addressing/auto-configuring functions.
The DeviceCommunicationControl and ReinitializeDevice Services are intended
to provide a human operator with diagnostic tools which may be invoked remotely.
With them a BACnet device can be ordered to ignore all BACnet messages (except
for the DeviceCommunicationControl and ReinitializeDevice Services), or either
warm-started or cold-started.
The ConfirmedPrivateTransfer and UnconfirmedPrivateTransfer Services are used
to convey messages outside the BACnet standard, effectively invoking
non-standard Services. These Services bear both the Vendor ID Code and the
Service Code in standard BACnet form; the rest of the content is entirely up to
the vendor and not likely to be interpretable by other manufacturers' devices.
The ConfirmedTextMessage and UnconfirmedTextMessage Services transport text
messages to other devices, such as printers.
The TimeSynchronization Service is transmitted by designated devices which
have clocks to other devices, or broadcast, so that the devices may be
synchronized
The Who-Is and I-Am Services are used to obtain the network addresses of
BACnet devices on a BACnet internetwork; they can make life much easier for the
installer by reducing or eliminating the need to program other devices'
internetwork addresses into each BACnet device. Instead, a BACnet device that
needs to know the address of one or more devices can broadcast a Who-Is Service
request (message) on the internetwork specifying a Device Object Instance Number
or a range of Instance Numbers. The responses do not come back as a reply.
Instead, the devices that have the specified Device Objects broadcast an I-Am
Service request either on the local network, on a remote network, or on the
entire internetwork, so that the requesting device will see the response, which
carries with it the address information of the responder. This allows other
devices that may need to know about the responders to acquire the address
information without creating more network traffic.
The Who-Has and I-Have Services are similar to the Who-Is and I-Am, but the
Who-Has adds either an Object Identifier (Object type plus Instance number,
unique within each device) or an Object Name (a Property of every Object, unique
within each device). Receiving devices which contain an Object matching the
request broadcast the I-Have Service request.
Table 7. Remote Device Management Services.
| SERVICE |
BACnet |
DESCRIPTION |
| DeviceCommunicationControl |
C |
Tells a device to stop (and start!) accepting network messages.
|
| ConfirmedPrivateTransfer |
C |
Sends a vendor-proprietary message to a device.
|
| UnconfirmedPrivateTransfer |
U |
Sends a vendor-proprietary message to one or more devices. |
| ReinitializeDevice |
C |
Orders the receiving device to cold- or warm-boot itself. |
| ConfirmedTextMessage |
C |
Conveys a text message to another device. |
| UnconfirmedTextMessage |
U |
Sends a text message to one or more devices. |
| TimeSynchronization |
U |
Sends the current time to one or more devices. |
| Who-Has |
U |
Asks which BACnet devices contain a particular Object. |
| I-Have |
U |
Affirmative response to Who-Has, broadcast. |
| Who-Is |
U |
Asks about the presence of specified BACnet devices. |
| I-Am |
U |
Affirmative response to Who-Is, broadcast. |
The Virtual Terminal (VT) Services can be used by an operator to establish a
bi-directional text-based connection with an application program executing in a
remote device. In effect, for the duration of a VT session established with the
remote device, the operator's device looks like a terminal connected to the
remote application program.
Table 8. Virtual Terminal Services.
| SERVICE |
BACnet |
DESCRIPTION |
| VT-Open |
C |
Establishes a virtual terminal session with a remote BACnet device. |
| VT-Close |
C |
Closes an established virtual terminal session. |
| VT-Data |
C |
Sends text from one device to the other participating in a
session. |
Conformance Classes, Function Groups and the PICS:
Evaluating the capabilities of a BACnet device is potentially a formidable
task, given the great choice of Objects, Properties and Services which can be
implemented, as well as the fact that it is not necessary for every BACnet
device to have a full BACnet implementation in order to carry out its task.
ASHRAE's BACnet Committee recognized this problem and responded with aids to
evaluation in the form of "Conformance Classes," "Function Groups" and the
"Protocol Implementation Conformance Statement" (PICS).
The BACnet protocol defines six levels of Conformance Classes, each of which
specifies the minimum subset of Services implemented on the device. The lowest
level, Conformance Class 1, requires only that the BACnet device contain a
Device Object and that it be able to execute (respond to) a ReadProperty Service
request. Each successive Conformance Class level adds Service Requests that must
be executable by the device, as well as the Service Requests it must be able to
initiate. Conformance Class 6 requires 21 types of Service Requests (of the 32
overall) to be implemented, of which 20 must be initiatable and 17 executable.
Conformance Class thus provides a measure of the device's ability to
communicate.
Function Groups specify a combination of Objects and Services necessary to
carry out certain building automation functions. They are specified
independently of Conformance Class, though the implementation of some of the
Function Groups automatically confers some Conformance Class higher than 1. The
Function Groups specified by BACnet are listed in Table 9, with brief
descriptions.
Table 9. Function Groups.
| FUNCTION GROUP |
DESCRIPTION |
| Clock |
Capabilities generally associated with having a clock. |
| Hand-held Workstation |
Hand-held or portable workstation capabilities. |
| Personal Computer Workstation |
Main operator workstation capabilities. |
| Event Initiation |
Detect and generate alarms and events. |
| Event Response |
Ability to respond to alarms and events. |
| COV Event Initiation |
Ability to initiate change-of-value notifications. |
| COV Event Response |
Subscribe to and receive change-of-value notifications. |
| Files |
Capability to read, write, upload and download files. |
| Reinitialize |
Ability to be reinitialized from remote device. |
| Virtual Operator |
Capable of providing operator side of virtual terminal session. |
| Virtual Terminal |
Capable of providing server side of virtual terminal session. |
| Device Communications |
DeviceCommunicationControl Service request execution supported. |
| Time Master |
Able to initiate TimeSynchronization Service
request. |
In order to best facilitate evaluations of BACnet devices, the BACnet
specification also provides a standard Protocol Implementation Conformance
Statement (PICS), created by the manufacturer, which provides in detail the
options implemented in the particular device. It identifies the vendor, briefly
describes the device, and details of the implementation. Included in the PICS
are:
- the Conformance Class of the device,
- the supported Function Groups,
- standard and proprietary Services executed and initiated,
- standard and proprietary Objects with any optional, writable, creatable,
or deleteable Properties
and a number of other aspects of the device pertaining to its implementation
per the BACnet standard. The Standard provides a pro forma PICS to simplify the
effort of specification.
BACnet spent nine years under development by a committee drawn from
manufacturers, universities, government agencies and consulting firms in an
effort to produce a truly open protocol whereby equipment from different
manufacturers can interoperate in a complete, integrated building automation
control system. The result is a standard that defines all the elements of
communication between devices, from the abstract language of Objects and
Services right down to the physical LANs. With its adoption as an ANSI standard
and the interest shown by GSA and others, it is safe to say that BACnet points
the way to the future of building automation controls.
|