BACnetStack_SetLiftHigherLowerDeck

bool BACnetStack_SetLiftHigherLowerDeck(
  const uint32_t deviceInstance,
  const uint32_t objectInstance,
  const uint32_t higherDeckObjectInstance,
  const uint32_t lowerDeckObjectInstance);

Sets BOTH the Higher_Deck and Lower_Deck properties of a Lift object (135-2024 cl. 12.59.34 and cl. 12.59.35), enabling them if they were not already enabled.

This is how a Lift object is declared to be part of a multi-deck lift car. Lift objects only - Escalator objects are not accepted.

There is no way to set just one of the two properties; both are written on every call. If this Lift object is the highest deck, set higherDeckObjectInstance to 4194303. If it is the lowest deck, set lowerDeckObjectInstance to 4194303.

SIDE EFFECT - THIS CALL CAN REMOVE THE LIFT FROM ITS ELEVATOR GROUP. If higherDeckObjectInstance is not 4194303 (that is, this deck is not the top of the chain) and the Lift references an Elevator Group, the Lift is DELETED from that group’s Group_Members property, undoing what BACnetStack_AddLiftOrEscalatorObject() put there. That is deliberate: cl. 12.58.7 says only one Lift object out of a multi-deck chain is referenced by the group. Call this AFTER BACnetStack_AddLiftOrEscalatorObject(), and set the decks so that the topmost deck - the one with higherDeckObjectInstance 4194303 - is the one left in Group_Members.

BACnet reference: ANSI/ASHRAE 135-2024 clause 12.59 (Lift Object Type).

Parameters

Parameter	Direction	Description
`deviceInstance`	in	The instance of the device that contains the Lift object.
`objectInstance`	in	The instance of the Lift object to update.
`higherDeckObjectInstance`	in	The instance of a Lift object that is a higher deck to this Lift object. If this Lift Object is the highest deck, then set this to 4194303.
`lowerDeckObjectInstance`	in	The instance of a Lift object that is a lower deck to this Lift object. If this Lift Object is the lowest deck, then set this to 4194303.

Returns

True if successful, otherwise false.

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