Skip to main content

BACnet Interface - Analog Value - Room Light Control

Analog Value - Room Light Control

Some Room Light Control parameters are also available via these objects. Those values are also available via the proprietary properties of the associated Loop object.

Room Light Control

List of available properties for these objects.

Property IdentifierProperty IDProperty DatatypeConformance Code
Object_Identifier75BACnetObjectIdentifierR
Object_Name77CharacterStringR
Object_Type79BACnetObjectTypeR
Present_Value85REALR
Description28CharacterStringR
Status_Flags111BACnetStatusFlagsR
Event_State36BACnetEventStateR
Reliability103BACnetReliabilityR
Out_Of_Service81BOOLEANW
Units117BACnetEngineeringUnitsR
Min_Pres_Value69REALR
Max_Pres_Value65REALR
Resolution106REALR

Object_Identifier

The object instance number is represented as 9CRRII.

  • "9" the prefix is the number 9.

  • "C" represents the DALI channel number, 0, 1, 2, or 3.

  • "RR" represents the Room Light Control, numbers 00-15.

  • "II" represents the parameter, numbers 00-99.

NumberName
00Value
01Controlled_Variable_Value
02Setpoint
03Hold_Time
04Ignore_Time
05Occupied_Level
06Unoccupied_Level
07Step_Value
08Lamp_2_Offset
09Lamp_2_Limit
10Override
11Setpoint_Occupied
12Setpoint_Unoccupied
13Deadband_Setpoint
14Warning_Time
15Warning_Command_Value
16Occupied_Command_Value
17Unoccupied_Command_Value
18Minimum_Intensity
19Maximum_Intensity
20Override_Timeout
21Demand_Response_Value

Object_Name

The name of the parameter with the name of the Room Light Control as a prefix.

Object_Type

ANALOG VALUE (2).

Present_Value

The value of the parameter.

Value

The light intensity in percentages for the Room Light Control.

Same value as the property Present_Value of the associated Loop object.

Controlled_Variable_Value

The current value of the light sensor.

Same value as the property Controlled_Variable_Value of the associated Loop object.

Setpoint

The value of the current setpoint in luxe.

Same value as the property Setpoint of the associated Loop object.

Hold_Time

The hold time in seconds used for the occupancy state. The occupancy state remains in the occupied state for the hold time when the value of Occupancy_Variable_Value changes to be unoccupied.

Valid values are between 0 and 2 400 seconds (40 minutes) with an interval of 10 seconds.

Same value as the property Hold_Time of the associated Loop object.

Ignore_Time

The ignore time in seconds used for the occupancy state. Once the occupancy state changes to unoccupied the ignore time is used to temporarily ignore the occupied change of the Occupancy_Variable_Value.

Valid values are between 0 and 2 400 seconds (40 minutes) with an interval of 10 seconds.

Same value as the property Ignore_Time of the associated Loop object.

Occupied_Level

The output light intensity when entering the occupied state.

Same value as the property Occupied_Level of the associated Loop object.

Unoccupied_Level

The output light intensity when entering the unoccupied state.

Same value as the property Unoccupied_Level of the associated Loop object.

Step_Value

The maximum value in percent that the Room Light Control can change its output per second, during constant light control.

Valid values are between 0 and 100 % with an interval of 0.5 %.

Same value as the property Step_Value of the associated Loop object.

Lamp_2_Offset

The offset between the primary and the secondary output.

Valid values are between 0 and 100 % with an interval of 0.5 %.

Same value as the property Lamp_2_Offset of the associated Loop object.

Lamp_2_Limit

The value where the secondary output becomes the same as the primary output.

Valid values are between 0 and 100 % with an interval of 0.5 %.

Same value as the property Lamp_2_Limit of the associated Loop object.

Override

The value of the output override in percent (0 - 100%). When the value is NaN the override is disabled.

Same value as the property Override of the associated Loop object.

Setpoint_Occupied

The setpoint of desired light illuminance of the room when the occupancy state is occupied.

Valid values are between 0 and 65 534 lux with an interval of 1 lux.

Same value as the property Setpoint_Occupied of the associated Loop object.

Setpoint_Unoccupied

The setpoint of desired light illuminance of the room when the occupancy state is unoccupied. It is also possible to use a relative setpoint to the Setpoint_Occupied, for this a negative is used that will represent a percentage to reduce from the Setpoint_Occupied.

Valid values are between 0 and 65 534 lux with an interval of 1 lux. When relative setpoint is used the valid values are between -100 and 0 % with an interval of 1 %.

Same value as the property Setpoint_Unoccupied of the associated Loop object.

Deadband_Setpoint

The dead band in luxe used by the current setpoint.

Valid values are between 0 and 65 534 lux with an interval of 1 lux.

Same value as the property Deadband_Setpoint of the associated Loop object.

Warning_Time

The warning time in seconds used for the occupancy state. The Warning_Command is executed before the Unoccupied_Command which is executed after the Warning_Time, when the value of Occupancy_Variable_Value changes to be unoccupied.
Valid values are between 0 and 2 400 seconds (40 minutes) with an interval of 10 seconds.

Same value as the property Warning_Time of the associated Loop object.

Warning_Command_Value, Occupied_Command_Value, Unoccupied_Command_Value
NameValue RangeUnit
Disabled0
Direct Value0 - 100Percent
Max Level
Off
Min Level
Recall Scene0 - 15Scene number
Start Daylight Harvesting
Stop Daylight Harvesting
Relinquish

Same value as the property Warning_Command_Value, Occupied_Command_Value or Unoccupied_Command_Value of the associated Loop object.

Minimum_Intensity

Minimum intensity of the Room Light Control output.

Valid values are between 0 and 100 % with an interval of 0.5 %.

Same value as the property Minimum_Intensity of the associated Loop object.

Maximum_Intensity

Maximum intensity of the Room Light Control output.

Valid values are between 0 and 100 % with an interval of 0.5 %.

Same value as the property Maximum_Intensity of the associated Loop object.

Override_Timeout

The override timeout in seconds used when unoccupied. The override remains active for this time, before returning to the unoccupied state.

Valid values are between 0 and 72 000 seconds (20 hours) with an interval of 300 seconds.

Same value as the property Override_Timeout of the associated Loop object.

Demand_Response_Value

The demand response allows limiting the illuminance of the room. A negative value reduces the illuminance of the room by this value in percentages. A positive value increases the illuminance of the room by this value in percentages. When daylight harvesting is active, the setpoint is decreased or increased by this value in percentages.

Valid values are between -100 and 100 percent with an interval of 1 percent.

Same value as the property Demand_Response_Value of the associated Loop object.

Description

A description of the object.

Status_Flags

This property indicates the general "reliability" of the object.

Reliability

This property indicates whether the operation of the object is reliable. The values are as follows:

  • NO_FAULT_DETECTED (0) - No fault has been detected.

Out_Of_Service

It indicates whether the algorithm that the object represents is in service.

Units, Min_Pres_Value, Max_Pres_Value, Resolution

The Units, Min_Pres_Value, Max_Pres_Value and Resolution for the Present_Value.

NameUnitsMin_Pres_ValueMax_Pres_ValueResolution
Valueno-units0REAL MAXIMUMREAL EPSILON
Controlled_Variable_Valueno-units0REAL MAXIMUMREAL EPSILON
Setpointno-units0REAL MAXIMUMREAL EPSILON
Hold_Timeseconds0240010
Ignore_Timeseconds0240010
Occupied_Levelno-units0REAL MAXIMUMREAL EPSILON
Unoccupied_Levelno-units0REAL MAXIMUMREAL EPSILON
Step_Valuepercent01000.5
Lamp_2_Offsetpercent01000.5
Lamp_2_Limitpercent01000.5
Overridepercent01REAL EPSILON
Setpoint_Occupiedluxes0655341
Setpoint_Unoccupiedno-units-100655341
Deadband_Setpointluxes0655341
Warning_Timeseconds0240010
Warning_Command_Valueno-units02551
Occupied_Command_Valueno-units02551
Unoccupied_Command_Valueno-units02551
Minimum_Intensitypercent01000.5
Maximum_Intensitypercent01000.5
Override_Timeoutseconds072000300
Demand_Response_Valuepercent-1001001