BACnet_Device

The Device object type (WinCC OA data point type) defines a standardized object whose properties represent the externally visible characteristics of a BACnet Device. There should be exactly one Device object in each BACnet Device. A Device object is referenced by its Object_Identifier property, which is not only unique to the BACnet Device that maintains this object, but is also unique throughout the BACnet internetwork. Additionally, the alive interval, synchronization interval and the device password can be controlled in the Device faceplate.

Data Point Type Name

BACnet_Device

(Object/)Data Point Type Structure

DP_Name.State

Data Point Element (Property) Data Type Device-depending availability Description
online bool - Indicates whether the BACnet Device is online (TRUE =1) or offline (FALSE = 0).

DP_Name.property

Data Point Element (Property) Data Type Description
Location string Indicates the physical location of the BACnet Device.
Model_Name string This property is assigned by the vendor to represent the model of the BACnet Device.
Firmware_Revision string This property is assigned by the vendor to represent the level of firmware installed in the BACnet Device.
Application_Software_Version string Identifies the version of application software installed in the machine. The content of this string is a local matter, but it could be a date-and-time stamp, a programmer's name, a host file version number, etc.
Vendor_Name string Identifies the manufacturer of the BACnet Device.
Vendor_Identifier unsigned integer This property is a unique vendor identification code, assigned by ASHRAE, which is used to distinguish proprietary extensions to the protocol.
VT_Classes_Supported string The VT_Classes_Supported property is a List of BACnetVTClass each of which is an enumeration indicating a particular set of terminal characteristics.
Max_Segments_Accepted unsigned integer The Max_Segments_Accepted property indicates the maximum number of segments of an APDU that this device will accept.
Segmentation_Supported string

This property indicates whether the BACnet Device supports segmentation of messages and, if so, whether it supports segmented transmission, reception, or both:

{SEGMENTED_BOTH, SEGMENTED_TRANSMIT, SEGMENTED_RECEIVE, NO_SEGMENTATION}.

Max_APDU_Length_Accepted unsigned integer This property is the maximum number of octets that may be contained in a single, indivisible application layer protocol data unit. The value of this property is greater than or equal to 50.
Backup_Failure_Timeout unsigned integer This optional property is the time, in seconds, that the device being backed up or restored must wait before unilaterally ending the backup or restore procedure. This property must be writable with the intent that the device performing the backup, or the human operator, will configure this with an appropriate timeout.
Configuration_Files string This optional property is a BACnet Array of BACnetObjectIdentifier. Entries in the array identify the files within the device that define the device's image that can be backed up. The contents of this property are only required to be valid during the backup procedure.
Database_Revision unsigned integer This property is a logical revision number for the device's database. It is incremented when an object is created, an object is deleted, an object's name is changed, an object's Object_Identifier property is changed, or a restore is performed.
Device_Address_Binding string

The Device_Address_Binding property is a List of BACnetAddressBinding each of which consists of a BACnet

Object_Identifier of a BACnet Device object and a BACnet device address in the form of a BACnetAddress. Entries in the list identify the actual device addresses that will be used when the remote device must be accessed via a BACnet service request. A value of zero is used for the network-number portion of BACnetAddress entries for other devices residing on the same network as this device. The list may be empty if no device identifier-device address bindings are currently known to the device.

Max_Info_Frames unsigned integer

Is present if the device is a node on an MS/TP network. The value of Max_Info_Frames specifies the maximum number of information frames the node may send before it must pass the token.

If Max_Info_Frames is not writable or otherwise user configurable, its value is one.

Max_Master unsigned integer The Max_Master property is present if the device is a master node on an MS/TP network. The value of Max_Master specifies the highest possible address for master nodes and is less than or equal to 127. If the Max_Master property is not writable via BACnet services, its value will be 127.
Time_Synchronization_Recipients string The Time_Synchronization_Recipients property is used to control the restrictions placed on a device's use of the TimeSynchronization service. The value of this property is a list of zero or more BACnetRecipients. If the list is of length zero, a device is prohibited from automatically sending a TimeSynchronization request. If the list is of length one or more, a device may automatically send a TimeSynchronization request but only to the devices or addresses listed. If it is present, this property will be writable. If the PICS indicates that this device is a Time Master, then the Time_Synchronization_Recipients property will be present.
Number_Of_APDU_Retries unsigned integer The Number_Of_APDU_Retries property indicates the maximum number of times that an APDU is retransmitted. The default value for this property is 3. If this device does not perform retries, then this property is set to zero. If the value of this property is greater than zero, a non-zero value is placed in the Device object APDU_Timeout property.
APDU_Timeout unsigned integer The APDU_Timeout property indicates the amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received. The default value for this property is 3,000 milliseconds for devices that permit modification of this parameter. Otherwise, the default value is 60,000 milliseconds. This value is non-zero if the Device object property called Number_Of_APDU_Retries is non-zero.
APDU_Segment_Timeout unsigned integer

The APDU_Segment_Timeout property indicates the amount of time in milliseconds between retransmission of an APDU segment. The default value for this property is 2000 milliseconds. This value is non-zero if the Device object property called Number_Of_APDU_Retries is non-zero. If segmentation of any kind is supported, then the APDU_Segment_Timeout property will be present.

In order to achieve reliable communication, it is recommended that the values of the APDU_Segment_Timeout properties of the Device objects of all intercommunicating devices contain the same value.

UTC_Offset integer The UTC_Offset property indicates the number of minutes (-780 to +780) offset between local standard time and Universal Time Coordinated. The time zones to the west of the zero degree meridian are positive values, and those to the east are negative values. The value of the UTC_Offset property is subtracted from the UTC received in UTCTimeSynchronization service requests to calculate the correct local standard time.
Protocol_Services_Supported dyn bool This property indicates which standardized protocol services are supported by this device's protocol implementation.
Protocol_Revision unsigned integer

This property indicates the minor revision level of the BACnet standard. This value starts at 1 and is incremented for any substantive change(s) to the BACnet standard that affect device communication or behavior. This value will revert to zero upon each change to the Protocol_Version property. Changes to the values for Protocol_Version and Protocol_Revision are recorded in the History of Revisions at the end of this standard.

This property is required for all devices implementing BACnet Protocol_Version 1, Protocol_Revision 1 and above. Absence of this property will indicate a device implemented to a version of the standard prior to the definition of the Protocol_Revision property.

Protocol_Version unsigned integer This property represents the version of the BACnet protocol supported by this BACnet Device. Every major revision of BACnet increases this version number by one. The initial release of BACnet is version 1.
Local_Time string The Local_Time property indicates the time of day to the best of the device's knowledge.
Local_Date string The Local_Date property indicates the date to the best of the device's knowledge.
Object_List dyn unsigned integer This read only property is a BACnetARRAY of Object_Identifiers, one Object_Identifier for each object within the device that is accessible through BACnet services.
Daylight_Saving_Status bool The Daylight_Savings_Status property indicates whether daylight savings time is in effect (TRUE) or not (FALSE) at the BACnet Device's location.
Active_VT_Sessions string The Active_VT_Sessions property is a List of BACnetVTSession each of which consists of a Local VT Session Identifier, a Remote VT Session Identifier, and Remote VT Address. This property provides a network-visible indication of those virtual terminal sessions (VT-Sessions) that are active at any given time. Whenever a virtual terminal session is created with the VTOpen service, a new entry is added to the Active_VT_Sessions list. Similarly, whenever a VT-session is terminated, the corresponding entry is removed from the Active_VT_Sessions list.
Active_COV_Subscriptions string

The Active_COV_Subscriptions property is a list of BACnetCOVSubscription, each of which consists of a Recipient, a Monitored Property Reference, an Issue Confirmed Notifications flag, a Time Remaining value and an optional COV Increment. This property provides a network-visible indication of those COV subscriptions that are active at any given time.

Whenever a COV Subscription is created with the SubscribeCOV or SubscribeCOVProperty service, a new entry is added to the Active_COV_Subscriptions list. Similarly, whenever a COV Subscription is terminated, the corresponding entry is removed from the Active_COV_Subscriptions list.

This property is required if the device supports execution of either SubscribeCOV or SubscribeCOVProperty service.

System_Status integer

This property reflects the current physical and logical status of the BACnet Device. The values that may be taken on by this property are

{OPERATIONAL,OPERATIONAL_READ_ONLY,DOWNLOAD_REQUIRED, DOWNLOAD_IN_PROGRESS, NON_OPERATIONAL}.

The exact meaning of these states in a given device and their synchronization with other internal operations of the device or the execution of BACnet services by the device are local matters and are not defined by this standard.

Last_Restore_Time time This optional property is the time at which the device's image was last restored.
Protocol_Object_Types_Supported dyn bool This property indicates which standardized object types are supported by this device's protocol implementation.
Time_Of_Device_Restart string Time of the last device restart.
Last_Restart_Reason Integer

The last cause for a restart. Following states are available:

  • 0 - unknown

  • 1 - coldstart

  • 2 - warmstart

  • 3 - detected-power-lost

  • 4 - detected-powered-off

  • 5 - hardware-watchdog

  • 6 - software-watchdog

  • 7 - suspended

Restart_Notification_Recipients String List of recipients for the Restart_Notification

DP_Name.general

Data Point Element Data Type Description
detail dyn string Detail information on the BACnet. See also Editing Detail Names.
engineering integer Number of engineering processes.
TimeSpanMarkOldValues unsigned integer Time in seconds after which the shown values has to be checked for an update. If the values have not been checked for a longer time as here defined, they are displayed gray in the faceplate.

DP_Name.alarm

Data Point Element Data Type Description
sumalert bool Indicates whether a sum alert has been defined (TRUE(1)) or not (FALSE (0)).

Faceplate

Figure 1. Faceplate of "Device"

For restart of the BACnet Device the password is needed.

For general information on faceplates see Symbols and Faceplates - General or the external Standard Object Library documentation (<C:\Siemens\Automation\WinCC_OA\3.18\ _installation_path>\Stdlib_<version>\help).

Tabs

Figure 2.
Figure 3.

With the "Reset Properties" command the peripheral addresses marked with UNKNOWN_PROPERTY are reset.

With a click on Get Event Notificationthe display of the actual status after communication errors can be forced.

Mark old values defines the time in seconds for highlighting obsolete values in the color gray in the faceplates.

This indicates that they need to be checked for an update.

For more information on tabs see Tabs.

Available Symbol Types

Name Usage $ Parameter Symbol
Device Basic system parameter for description of the BACnet subscriber (AS, MBE or others). DP

V 3.18

Copyright © ETM professional control GmbH 2024