BACnetStack_SetTrendLogTypeToCOV

bool BACnetStack_SetTrendLogTypeToCOV(
  const uint32_t deviceInstance,
  const uint16_t objectType,
  const uint32_t objectInstance,
  const bool enable,
  const bool stopWhenFull,
  const bool useClientCOVIncrement,
  const float covIncrement);

Sets property values of an existing Trend Log object.

This function should only be called after the AddTrendLogObject.

This function sets the log object to used the cov (change of value) type of logging and users can specify some parameters like if it should be enabled, if logging should stop when full, and whether or not to use the default cov increment or to specify one.

BACnet reference: ANSI/ASHRAE 135-2024 clause 12.25 (Trend Log Object Type).

Parameters

Parameter	Direction	Description
`deviceInstance`	in	The instance of the device that contains the Trend Log object.
`objectType`	in	The BACnet object type of the Trend Log object to update. Must be Trend Log: a Trend Log Multiple has no COV logging type, so trendLogMultiple returns false. See CASBACnetStack::BACnetObjectType for more info. With objectInstance, this is one BACnet Object Identifier carried as two parameters (see the API conventions).
`objectInstance`	in	The instance of the Trend Log object to update.
`enable`	in	Whether to enable logging on the Trend Log object (true) or not (false).
`stopWhenFull`	in	Whether to stop logging when the log buffer is full (true) or not (false).
`useClientCOVIncrement`	in	Whether to use a user specified cov increment (true) or use the default (false).
`covIncrement`	in	The Client_COV_Increment, used only when useClientCOVIncrement is true (when it is false the monitored object’s own COV_Increment is used and this argument is ignored). Units are those of the monitored property itself - a magnitude of change in the logged value, not a time. 0.0 means log on ANY change. Negative values are meaningless and are not rejected here, so pass a non-negative value.

Returns

True if successful, otherwise false.

Topic: Schedules, calendars, trend logs and other object configuration. Declared in CASBACnetStackDLL.h.