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:
|
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
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
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