TrendLog(TL)
- Last UpdatedDec 14, 2020
- 3 minute read
Supported properties of the Trend Log object (TL)
|
Property |
Value Format |
Example |
|
OBJECT-IDENTIFIER |
String [ObjectNumber]: [Instance Number] String |
20:4194302 |
|
OBJECT-NAME |
ObjectName:TrendLogObject Type (TL) |
|
|
OBJECT-TYPE |
Integer |
20 |
|
DESCRIPTION |
String |
Description:TrendLogObject Type(TL) |
|
LOG-ENABLE |
Boolean |
This property,of type BOOLEAN, indicates and controls whether (TRUE) or not (FALSE) logging is enabled. For example:1 |
|
START-TIME |
String |
This property, of type BACnetDateTime, specifies the date and time at or after which logging shall be enabled by this property. For example:29-5-201417:6:24.78 |
|
STOP-TIME LOG-DEVICE-OBJECT-PROPERTY |
String String [OBJECT-IDENTIFIER] | [PROPERTY-IDENTIFIER] | [PROPERTY-ARRAY-INDEX (Optional)] | [DEVICE- IDENTIFIER (Optional)] |
This property, of type BACnetDateTime, specifies the date and time at or after which logging shall be disabled by this property. For example:29-5-201417:6:24.78 This property, of type BACnetDeviceObjectPropertyReference, specifies the Device Identifier, Object Identifier and Property Identifier of the property to be trend logged For example:29,4194303|29|786|30,4194303 |
|
LOG-INTERVAL COV-RESUBSCRIPTION-INTERVAL |
Unsigned Integer Unsigned Integer |
This property, of type Unsigned, specifies the periodic interval in hundredths of seconds for which the referenced property is to be logged For example:100 If the Trend Log is acquiring data from a remote device by COV subscription, this property, of type Unsigned, specifies the number of seconds between COV resubscriptions, provided that COV subscription is in effect For example:300 |
|
CLIENT-COV-INCREMENT |
Float |
If the Trend Log is acquiring COV data, this property, of type BACnetClientCOV, specifies the increment to be used in determining that a change of value has occurred. For example:1.44 |
|
STOP-WHEN-FULL |
Boolean |
This property, of type BOOLEAN, specifies whether (TRUE) or not (FALSE) logging should cease when the buffer is full. When logging ceases, Log Enable shall be set FALSE For example:1 |
|
BUFFER-SIZE |
Unsigned Integer32 |
This property, of type Unsigned32, shall specify the maximum number of records the buffer may hold. If writable, it may not be written when Log Enable is TRUE. The disposition of existing records when Buffer Size is written is a local matter For example:20 |
|
RECORD-COUNT |
Unsigned Integer32 |
This property, of type Unsigned32, shall represent the number of records currently resident in the log buffer. A write of the value zero to this property shall cause all records in the log buffer to be deleted and Records. Since Notification to be reset to zero. Upon completion, this event shall be reported in the log as the initial entry For example:20 |
|
TOTAL-RECORD-COUNT |
Unsigned Integer32 |
This property, of type Unsigned32, shall represent the total number of records collected by the Trend Log object since creation. For example:72 |
|
NOTIFICATION-THRESHOLD |
Unsigned Integer32 |
This property, of type Unsigned32, shall specify the value of Records Since Notification at which notification occurs. This property is required if intrinsic reporting is supported by this object. For example:100 |
|
RECORDS-SINCE-NOTIFICATION |
Unsigned Integer32 |
This property, of type Unsigned32, represents the number of records collected since the previous notification, or since the beginning of logging if no previous notification has occurred. This property is required if intrinsic reporting is supported by this object. For example:72 |
|
LAST-NOTIFY-RECORD |
Unsigned Integer32 |
This property, of type Unsigned32, represents the SequenceNumber associated with the most recently collected record whose collection triggered a notification. For example:0 |
|
EVENT-STATE |
Integer |
The Event State property, of type BACnetEventState, is included in order to provide a way to determine if this object has an active event state associated with it For example:0 |
|
NOTIFICATION-CLASS |
Unsigned Integer |
This property, of type Unsigned, shall specify the notification class to be used when handling and generating event notifications for this object. For example:0 |
|
EVENT-ENABLE |
3 Boolean values (1=true,0=false) encoded as a string {to-offnormal, to- fault, to-normal} |
This property, of type BACnetEventTransitionBits, shall convey three flags that separately enable and disable reporting of TO-FAULT and TO-NORMAL events. For example:010 |
|
ACKED-TRANSITIONS NOTIFY-TYPE |
3Booleanvalues(1=true,0=false)encodedasastring {to-offnormal, to- fault, to-normal} Integer |
This property, of type BACnetEventTransitionBits, shall convey three flags that separately indicate the receipt of acknowledgments for TO-OFFNORMAL, TO-FAULT and TO-NORMAL events For example:111 This property, of type BACnetNotifyType, shall convey whether the notifications generated by the object should be Events or Alarms. This property is required if intrinsic reporting is supported by this object. For example:2 |
|
EVENT-TIME-STAMPS PROFILE-NAME |
Sequence of time stamps encoded as a string String |
This optional property, of type BACnetARRAY [3] of BACnetTimeStamp, shall convey the times of the last event notifications for TO-OFFNORMAL, TO- FAULT, and TO-NORMAL events, respectively. For example:2|1-1-197011:0:0.0;2| 1-1-197011:0:0.0;2|1-1-197011:0:0.0 Profile Name:Trend Log Object Type(TL) |
Note: This Communication Driver supports Read-Property-Multiple, Read-Property-Single, and Write-Property-Single application services.