Trend Log Multiple

A Trend Log Multiple object records several values together as one row, at the same moment. Each row holds one value from each property it logs, so the values line up in time. Use it when readings belong together, such as a set of temperatures taken at once.

Typical uses

• Supply, return and outdoor temperature in one row
• Voltage, current and power of one feed
• Several room temperatures logged together
• Daily snapshot of related meter values
• Data for a report that compares channels

Key properties

Property	What it holds
Log_DeviceObjectProperty	The list of properties to log, one per column of each row.
Logging_Type	How rows are taken: at a set interval or when a client triggers a reading. This type has no change-of-value logging.
Log_Buffer	The stored rows. A client reads them with ReadRange, not ReadProperty.
Buffer_Size	The most rows the buffer can hold.
Record_Count	How many rows are in the buffer now.
Enable	Switches logging on or off. Start_Time and Stop_Time can also bound it.

How it behaves

The object is not commandable. When it reports intrinsic events, the standard pairs it with the BUFFER_READY algorithm, which notifies a client once a chosen number of new rows has been logged since the last notice. A column that cannot be read is recorded as an error for that row.

With the CAS BACnet Stack

Enable it with the STACK_OPTION_T_VMMV_TRENDING_VIEWING_AND_MODIFYING_MULTIPLE_VALUES build option, which also enables STACK_OPTION_OBJECT_TYPE_TREND_LOG_MULTIPLE and the single Trend Log. Do not use BACnetStack_AddObject: add the object with BACnetStack_AddTrendLogMultipleObject, then choose the logging type with BACnetStack_SetTrendLogTypeToPolled or BACnetStack_SetTrendLogTypeToTriggered, and add each logged column with BACnetStack_AddLoggedObjectToTrendLogMultiple. BACnetStack_SetTrendLogStartStopTime bounds the logging window. The stack stores the logging properties itself, so a callback cannot override them. Register BACnetStack_RegisterCallbackGetSystemTime, or writes to the object abort. Add rows yourself with BACnetStack_InsertTrendLogMultipleRecord and read them with BACnetStack_ReadTrendLogMultipleRecord. For BUFFER_READY, enable alarms and call BACnetStack_SetIntrinsicBufferReadyAlgorithm.

Related object types

Trend Log, Event Log, Analog Input

Properties

The properties ASHRAE 135-2024 clause 12.30 defines for this object type.

How to read the table:

• Conformance is what the standard asks of every object of this type: R is required, W is required and writable by a client, O is optional. A digit after the letter marks a condition in the standard that decides when the property is present or writable, such as support for intrinsic reporting.
• Present by default: yes means the stack presents the property as soon as you add the object; no means it is optional and you turn it on with BACnetStack_SetPropertyEnabled. This is the stack’s starting setup, so it can differ from the conformance code.
• Writable is whether a client can write the property by default. Change it with BACnetStack_SetPropertyWritable.
• not in profile means the stack does not offer this property for this object type.
• Value when your callback does not answer: “Held by the stack” means the stack stores and serves the value itself and does not ask your callbacks. Otherwise it is the value the stack answers when your callback declines or is not registered.

Property	Datatype	Conformance	Present by default	Writable	Value when your callback does not answer
Object_Identifier	BACnetObjectIdentifier	R	yes	no	Held by the stack.
Object_Name	CharacterString	R	yes	no	"Object <type>,<instance>", such as "Object 0,1" for Analog Input 1.
Object_Type	BACnetObjectType	R	yes	no	Held by the stack.
Description	CharacterString	O	no	no	""
Status_Flags	BACnetStatusFlags	R	yes	no	Held by the stack.
Event_State	BACnetEventState	R	yes	no	NORMAL, or the alarm engine’s state once alarms are enabled.
Reliability	BACnetReliability	O	no	no	0
Enable	Boolean	W	yes	yes	Held by the stack.
Start_Time	BACnetDateTime	O1	no	yes	Held by the stack.
Stop_Time	BACnetDateTime	O1	no	yes	Held by the stack.
Log_DeviceObjectProperty	BACnetARRAY[N] of BACnetDeviceObjectPropertyReference	R	yes	no	Held by the stack.
Logging_Type	BACnetLoggingType	R	yes	no	Held by the stack.
Log_Interval	Unsigned	R2	yes	yes	Held by the stack.
Align_Intervals	Boolean	O3	no	yes	false
Interval_Offset	Unsigned	O3	no	yes	0
Trigger	Boolean	O	no	no	Held by the stack.
Stop_When_Full	Boolean	R	yes	no	Held by the stack.
Buffer_Size	Unsigned32	R	yes	no	Held by the stack.
Log_Buffer	BACnetLIST of BACnetLogMultipleRecord	R	yes	no	Held by the stack. Read it with ReadRange; a ReadProperty is refused.
Record_Count	Unsigned32	W	yes	yes	Held by the stack.
Total_Record_Count	Unsigned32	R	yes	no	Held by the stack.
Notification_Threshold	Unsigned32	O4,6	no	no	0
Records_Since_Notification	Unsigned32	O4,6	no	no	0
Last_Notify_Record	Unsigned32	O4,6	no	no	0
Notification_Class	Unsigned	O4,6	no	no	0
Event_Enable	BACnetEventTransitionBits	O4,6	no	no	An empty bit string.
Acked_Transitions	BACnetEventTransitionBits	O4,6	no	no	An empty bit string.
Notify_Type	BACnetNotifyType	O4,6	no	no	0
Event_Time_Stamps	BACnetARRAY[3] of BACnetTimeStamp	O4,6	no	no	No default: the read fails.
Event_Message_Texts	BACnetARRAY[3] of CharacterString	O6	no	no	""
Event_Message_Texts_Config	BACnetARRAY[3] of CharacterString	O6	no	no	""
Event_Detection_Enable	Boolean	O4,6	no	no	false
Event_Algorithm_Inhibit_Ref	BACnetObjectPropertyReference	O6	no	no	No default: the read fails.
Event_Algorithm_Inhibit	Boolean	O6,7	no	no	false
Reliability_Evaluation_Inhibit	Boolean	O8	no	no	false
Property_List	BACnetARRAY[N] of BACnetPropertyIdentifier	R	yes	no	Held by the stack.
Audit_Level	BACnetAuditLevel	O9	not in profile	not in profile	No default: the read fails.
Auditable_Operations	BACnetAuditOperationFlags	O9	not in profile	not in profile	No default: the read fails.
Tags	BACnetARRAY[N] of BACnetNameValue	O	no	no	No default: the read fails.
Profile_Location	CharacterString	O	no	no	""
Profile_Name	CharacterString	O	no	no	""