BACnet Interface - Loop Object - Room Light Control
Loop Object - Room Light Control
To control the Room Light Control, use Loop objects. Visualise the states and configure the parameters with these objects.
Room Light Control
List of available properties for these objects.
| Property Identifier | Property ID | Property Datatype | Conformance Code |
|---|---|---|---|
| Object_Identifier | 75 | BACnetObjectIdentifier | R |
| Object_Name | 77 | CharacterString | R |
| Object_Type | 79 | BACnetObjectType | R |
| Present_Value | 85 | REAL | R |
| Description | 28 | CharacterString | R |
| Status_Flags | 111 | BACnetStatusFlags | R |
| Event_State | 36 | BACnetEventState | R |
| Reliability | 103 | BACnetReliability | R |
| Out_Of_Service | 81 | BOOLEAN | W |
| Output_Units | 117 | BACnetEngineeringUnits | R |
| Manipulated_Variable_Reference | 60 | BACnetObjectPropertyReference | R |
| Controlled_Variable_Reference | 19 | BACnetObjectPropertyReference | R |
| Controlled_Variable_Value | 21 | REAL | R |
| Controlled_Variable_Units | 20 | BACnetEngineeringUnits | R |
| Setpoint_Reference | 109 | BACnetSetpointReference | R |
| Setpoint | 108 | REAL | R |
| Action | 2 | BACnetAction | R |
| Priority_For_Writing | 88 | Unsigned(1..16) | W |
| Occupancy_Variable_Reference | 537 | BACnetObjectPropertyReference | R |
| Occupancy_Variable_Value | 538 | BOOLEAN | R |
| Mode | 539 | Unsigned | W |
| Hold_Time | 540 | Unsigned | W |
| Ignore_Time | 541 | Unsigned | W |
| Occupied_Level | 542 | REAL | W |
| Unoccupied_Level | 543 | REAL | W |
| Step_Value | 544 | REAL | W |
| Lamp_2_Offset | 550 | REAL | W |
| Lamp_2_Limit | 551 | REAL | W |
| Override | 560 | REAL | R |
| Auto_Mode | 561 | BACnetBinaryPV | R |
| Occupancy_State | 562 | BACnetBinaryPV | R |
| Manipulated_Variable_Value | 574 | REAL | R |
| Controlled_Variable_Value | 575 | REAL | R |
| Command | 900 | Unsigned | W |
| Setpoint_Occupied | 901 | REAL | W |
| Setpoint_Unoccupied | 902 | REAL | W |
| Deadband_Setpoint | 903 | REAL | W |
| Warning_Time | 907 | Unsigned | W |
| Warning_Command_Command | 908 | Unsigned | W |
| Warning_Command_Value | 909 | Unsigned | W |
| Occupied_Command_Command | 910 | Unsigned | W |
| Occupied_Command_Value | 911 | Unsigned | W |
| Unoccupied_Command_Command | 912 | Unsigned | W |
| Unoccupied_Command_Value | 913 | Unsigned | W |
| Minimum_Intensity | 914 | REAL | W |
| Maximum_Intensity | 915 | REAL | W |
| Daylight_Harvesting_Active | 916 | Unsigned | R |
| Occupied_Mode | 917 | Unsigned | W |
| Override_Timeout | 918 | Unsigned | W |
| Demand_Response_Value | 919 | REAL | W |
| Demand_Response_State | 920 | Unsigned | R |
| Occupied_Mode_Command_Enable | 921 | Unsigned | W |
Object_Identifier
The object instance number is represented as CRR.
-
"C" represents the DALI channel number, 0, 1, 2, or 3.
-
"RR" represents the Room Light Control, numbers 00-15.
Object_Name
The name of the Room Light Control.
Object_Type
LOOP (12).
Present_Value
The light intensity in percentages for the Room Light Control.
Description
A description of the Room Light Control.
Status_Flags
This property indicates the general "reliability" of a loop object.
Reliability
This property indicates whether the operation of the Room Light Control is reliable. The values are as follows:
-
NO_FAULT_DETECTED (0) - No fault has been detected.
-
OPEN_LOOP (4) - The value of the light sensor does not changes when the Room Light Control output changes.
-
COMMUNICATION_FAILURE (12) - The sensors or output devices are offline.
-
UNRELIABLE_OTHER (7) - Another error has been reported.
Out_Of_Service
It indicates whether the algorithm that the object represents is in service.
Output_Units
The unit for the Present_Value is percent.
Manipulated_Variable_Reference
The output (Present_Value) of the control loop is written to the object and property designated by this property.
Controlled_Variable_Reference
It indicates the object and property of the light sensor.
Controlled_Variable_Value
The current value of the light sensor.
Setpoint_Reference
It indicates the object and property of the setpoint. It is always empty, indicating that the setpoint is contained in the Setpoint property.
Setpoint
The value of the current setpoint in luxe.
Action
The action is DIRECT (0).
Priority_For_Writing
This property provides a priority to be used to write to the Manipulated_Variable_Reference that is controlled by this loop.
Valid values are between 1 and 16.
Occupancy_Variable_Reference
It indicates the object and property of the occupancy sensor.
Occupancy_Variable_Value
The current value of the occupancy sensor.
Mode
The current mode of the Room Light Control.
| Name | Value | Description |
|---|---|---|
| Disabled | 0 | The Room Light Control is disabled |
| Enabled | 1 | The Room Light Control is enabled |
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.
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.
Occupied_Level
The output light intensity when entering the occupied state.
Unoccupied_Level
The output light intensity when entering the unoccupied state.
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 %.
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 %.
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 %.
Override
The value of the output override in percent (0 - 100%). When the value is NaN the override is disabled.
Auto_Mode
Inactive (0): The Room Light Control is currently overridden or is disabled.
Active (1): The Room Light Control is not currently overridden and is active.
Occupancy_State
Indicates the current occupancy state of the Room Light Control.
Inactive (0): The occupancy state is unoccupied.
Active (1): The occupancy state is occupied.
Manipulated_Variable_Value
The value of the manipulated variable, used internally to track a value for Manipulated_Variable_Reference.
Controlled_Variable_Value
The value of the controlled variable, used internally to track a value for Controlled_Variable_Reference.
Command
Allows to execute commands on the Room Light Control.
NO COMMAND (1)
No command is executed.
START DEMAND RESPONSE (2)
Starts the demand response.
STOP DEMAND RESPONSE (3)
Stops the demand response.
START DAYLIGHT HARVESTING (4)
Starts the daylight harvesting.
STOP DAYLIGHT HARVESTING (5)
Stops the daylight harvesting.
START OVERRIDE (6)
Starts the override.
STOP OVERRIDE (7)
Stops the override.
ENABLE (8)
Enable the Rool Light Control.
DISABLE (9)
Disable the Rool Light Control.
OCCUPIED NO COMMAND (10)
Inhibits the occupied and unoccupied commands.
OCCUPIED UNOCCUPIED COMMAND (11)
Allows only the unoccupied commands.
OCCUPIED OCCUPIED COMMAND (12)
Allows only the occupied commands.
OCCUPIED ALL COMMAND (13)
Allows the occupied and unoccupied commands.
OCCUPIED MODE UNOCCUPIED (14)
Sets the occupied mode to unoccupied.
OCCUPIED MODE OCCUPIED (15)
Sets the occupied mode to occupied.
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.
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 %.
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.
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.
Warning_Command_Command, Occupied_Command_Command and Unoccupied_Command_Command
| Name | Value | Description |
|---|---|---|
| Disabled | 0 | The command is disabled. |
| Direct Value | 1 | Direct light value. |
| Max Level | 2 | Recall Max Level. |
| Off | 3 | Off. |
| Min Level | 4 | Recall Min Level. |
| Recall Scene | 5 | Recall Scene. |
| Start Daylight Harvesting | 6 | Start the Room Light Control daylight harvesting. |
| Stop Daylight Harvesting | 7 | Stop the Room Light Control daylight harvesting. |
| Relinquish | 8 | Relinquish the priority. |
Warning_Command_Value, Occupied_Command_Value and Unoccupied_Command_Value
| Name | Value Range | Unit |
|---|---|---|
| Disabled | 0 | |
| Direct Value | 0 - 100 | Percent |
| Max Level | ||
| Off | ||
| Min Level | ||
| Recall Scene | 0 - 15 | Scene number |
| Start Daylight Harvesting | ||
| Stop Daylight Harvesting | ||
| Relinquish |
Minimum_Intensity
Minimum intensity of the Room Light Control output.
Valid values are between 0 and 100 % with an interval of 0.5 %.
Maximum_Intensity
Maximum intensity of the Room Light Control output.
Valid values are between 0 and 100 % with an interval of 0.5 %.
Daylight_Harvesting_Active
This property indicates whether the daylight harvesting control is currently active or not.
| Name | Value | Description |
|---|---|---|
| Inactive | 0 | The daylight harvesting control is currently inactive. |
| Active | 1 | The daylight harvesting control is currently active. |
Occupied_Mode
The current occupancy mode.
Unoccupied (0): The Room Light Control is unoccupied.
Occupied (1): The Room Light Control is occupied.
Override_Timeout
The override timeout in seconds. The override remains active for this period.
Valid values are between 0 and 72 000 seconds (20 hours) with an interval of 300 seconds.
When the value is zero, this functionality is disabled.
Override is automatically initiated when the output of a Room Light Control is modified from another source than the Room Light Control itself.
For example, this allows a DALI button or a BACnet group command to temporarily override the output.
While the override timeout is active, Daylight Harvesting is suspended. When the override timeout ends, daylight harvesting is un-suspended and if it is in unoccupied state, the Warning and the Unoccupied commands are executed.
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.
Demand_Response_State
The current state of the demand response.
Inactive (0): The demand response is inactive.
Active (1): The demand response is active.
Occupied_Mode_Command_Enable
It allows enabling and disabling the execution of the occupancy command when Occupied_Mode is modified.
| Name | Value | Description |
|---|---|---|
| NO_COMMAND | 0 | No command is executed. |
| UNOCCUPIED_COMMAND | 1 | Only unoccupied command is executed. |
| OCCUPIED_COMMAND | 2 | Only occupied command is executed. |
| ALL | 3 | Both Unoccupied and Occupied commands are executed. |