Skip to main content

BACnet Interface - Analog Output Object - Control of Lamp, Group, and Channel

Analog Output Object - Control of Lamp, Group, and Channel

To control the intensity of the lamps, use the Analog Output objects. Lamps parameters can also be modified with these objects.

Lamp

List of available properties for these objects.

Property IdentifierProperty IDProperty DatatypeConformance Code
Object_Identifier75BACnetObjectIdentifierR
Object_Name77CharacterStringR
Object_Type79BACnetObjectTypeR
Present_Value85REALW
Description28CharacterStringR
Device_Type31CharacterStringR
Status_Flags111BACnetStatusFlagsR
Event_State36BACnetEventStateR
Reliability103BACnetReliabilityR
Out_Of_Service81BOOLEANW
Units117BACnetEngineeringUnitsR
Min_Pres_Value69REALR
Max_Pres_Value65REALW
Priority_Array87BACnetPriorityArrayR
Relinquish_Default104REALR
Current_Command_Priority431BACnetOptionalUnsignedR
Power_On_Level512REALW
System_Failure_Level513REALW
Fade_Time514REALW
Ramp_Rate515REALW
Min_Level516REALW
Groups517BIT STRINGW
Nominal_Power518REALW
Dim_Mode520EnumeratedW
Run_Hours527UnsignedR
Run_Hours_Reset_Time528UnsignedR
Colour_Temp567REALW
Command900UnsignedW
Device_Type_Supported925BIT STRINGR
Energy_Usage_Accumulated926REALW
Emergency_Time_Until_Next_Function_Test1010UnsignedW
Emergency_Time_Until_Next_Duration_Test1011UnsignedW
Emergency_Battery_Charge1012REALR
Emergency_Duration_Test_Result1013UnsignedR
Emergency_Emergency_Mode1014BIT STRINGR
Emergency_Failure_Status1015BIT STRINGR
Emergency_Emergency_Status1016BIT STRINGR
Emergency_Emergency_Level1020REALW
Emergency_Emergency_Minimum_Level1021REALR
Emergency_Emergency_Maximum_Level1022REALR
Emergency_Prolong1023UnsignedW
Emergency_Function_Test_Interval_Time1026UnsignedW
Emergency_Duration_Test_Interval_Time1027UnsignedW
Emergency_Test_Execution_Timeout1028UnsignedW
Emergency_Lamp_Emergency_Time1029UnsignedR
Emergency_Lamp_Total_Operation_Time1030UnsignedR
Emergency_Rated_Duration1031UnsignedR
Emergency_Features1032BIT STRINGR
Dimming_Curve6000EnumeratedW
Colour_Type8000EnumeratedW
Colour_XYC_X8010REALW
Colour_XYC_Y8011REALW
Colour_TC_TC8020REALW
Colour_PN_P08030REALW
Colour_PN_P18031REALW
Colour_PN_P28032REALW
Colour_PN_P38033REALW
Colour_PN_P48034REALW
Colour_PN_P58035REALW
Colour_RGBWAF_RED8040REALW
Colour_RGBWAF_GREEN8041REALW
Colour_RGBWAF_BLUE8042REALW
Colour_RGBWAF_WHITE8043REALW
Colour_RGBWAF_AMBER8044REALW
Colour_RGBWAF_FREECOLOUR8045REALW

Group

List of available properties for these objects.

Property IdentifierProperty IDProperty DatatypeConformance Code
Object_Identifier75BACnetObjectIdentifierR
Object_Name77CharacterStringR
Object_Type79BACnetObjectTypeR
Present_Value85REALW
Description28CharacterStringR
Device_Type31CharacterStringR
Status_Flags111BACnetStatusFlagsR
Event_State36BACnetEventStateR
Reliability103BACnetReliabilityR
Out_Of_Service81BOOLEANW
Units117BACnetEngineeringUnitsR
Min_Pres_Value69REALR
Max_Pres_Value65REALW
Priority_Array87BACnetPriorityArrayR
Relinquish_Default104REALR
Current_Command_Priority431BACnetOptionalUnsignedR
Power_On_Level512REALW
System_Failure_Level513REALW
Fade_Time514REALW
Ramp_Rate515REALW
Min_Level516REALW
Nominal_Power518REALW
Dim_Mode520EnumeratedW
Colour_Temp567REALW
Command900UnsignedW
Energy_Usage_Accumulated926REALW
Dimming_Curve6000EnumeratedW
Colour_Type8000EnumeratedW
Colour_XYC_X8010REALW
Colour_XYC_Y8011REALW
Colour_TC_TC8020REALW
Colour_PN_P08030REALW
Colour_PN_P18031REALW
Colour_PN_P28032REALW
Colour_PN_P38033REALW
Colour_PN_P48034REALW
Colour_PN_P58035REALW
Colour_RGBWAF_RED8040REALW
Colour_RGBWAF_GREEN8041REALW
Colour_RGBWAF_BLUE8042REALW
Colour_RGBWAF_WHITE8043REALW
Colour_RGBWAF_AMBER8044REALW
Colour_RGBWAF_FREECOLOUR8045REALW

Channel

List of available properties for these objects.

Property IdentifierProperty IDProperty DatatypeConformance Code
Object_Identifier75BACnetObjectIdentifierR
Object_Name77CharacterStringR
Object_Type79BACnetObjectTypeR
Present_Value85REALW
Description28CharacterStringR
Device_Type31CharacterStringR
Status_Flags111BACnetStatusFlagsR
Event_State36BACnetEventStateR
Reliability103BACnetReliabilityR
Out_Of_Service81BOOLEANW
Units117BACnetEngineeringUnitsR
Min_Pres_Value69REALR
Max_Pres_Value65REALW
Priority_Array87BACnetPriorityArrayR
Relinquish_Default104REALR
Current_Command_Priority431BACnetOptionalUnsignedR
Power_On_Level512REALW
System_Failure_Level513REALW
Fade_Time514REALW
Ramp_Rate515REALW
Min_Level516REALW
Nominal_Power518REALW
Dim_Mode520EnumeratedW
Colour_Temp567REALW
Command900UnsignedW
Energy_Usage_Accumulated926REALW
Dimming_Curve6000EnumeratedW
Colour_Type8000EnumeratedW
Colour_XYC_X8010REALW
Colour_XYC_Y8011REALW
Colour_TC_TC8020REALW
Colour_PN_P08030REALW
Colour_PN_P18031REALW
Colour_PN_P28032REALW
Colour_PN_P38033REALW
Colour_PN_P48034REALW
Colour_PN_P58035REALW
Colour_RGBWAF_RED8040REALW
Colour_RGBWAF_GREEN8041REALW
Colour_RGBWAF_BLUE8042REALW
Colour_RGBWAF_WHITE8043REALW
Colour_RGBWAF_AMBER8044REALW
Colour_RGBWAF_FREECOLOUR8045REALW
Network_Mode923UnsignedW
Network_Command_Repeat_Count924UnsignedW

Object_Identifier

The object instance number is represented as TCLL.

  • "T" is the type of object as follows, 0 for DALI lamps, 1 for DALI groups and 2 for DALI channels.

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

  • "LL" represents for lamp objects, numbers 00-63, for group objects, numbers 00-15 and for channel objects, number 00.

Object_Name

The name of the DALI lamp, group or channel.

Object_Type

ANALOG_OUTPUT (1).

Present_Value

The light intensity in percentages for the DALI lamp, group or channel.

Description

A description of the DALI lamp, group or channel.

Device_Type

  • For lamp objects, it is DALI lamp.

  • For group objects, it is DALI group.

  • For channel objects, it is DALI channel.

Status_Flags

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

Reliability

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

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

  • NO_OUTPUT (6) - No DALI device is connected to the output object.

  • COMMUNICATION_FAILURE (12) - DALI device is offline.

  • UNRELIABLE_OTHER (7) - An error has been reported by the DALI lamp.

Out_Of_Service

This property indicates whether the physical device represented by the object is in service.

Units

The unit for the Present_Value is percent.

Min_Pres_Value

The minimum value is always zero (0). It represents the lowest value for the property Present_Value.

Max_Pres_Value

For lamp objects, this is the DALI variable "MAX LEVEL" of the lamp. It is writable for lamps, groups, and channels.

For groups and channels, the initial value of the property is 100 and it returns the last written value, which may differ from the actual value of the lamps.

Priority_Array

This property is a read-only array of prioritized values.

Relinquish_Default

It is the default value used for the Present_Value property when all command priority values in the Priority_Array property have a NULL value.

Power_On_Level

It represents the DALI variable "POWER ON LEVEL" of the DALI lamp in percentages. A value of NaN represents the DALI "MASK" value. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

System_Failure_Level

It represents the DALI variable "SYSTEM FAILURE LEVEL" of the DALI lamp in percentages. A value of NaN represents the DALI "MASK" value. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Fade_Time

Represents the DALI variable "FADE TIME" in seconds for the DALI lamp. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Ramp_Rate

Represents the DALI variable "FADE RATE" in percent per second for the DALI lamp. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Min_Level

It represents the DALI variable "MIN LEVEL" of the DALI lamp in percentages. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Groups

Only available for lamp objects, it represents the DALI variables "GROUP_0_8" and "GROUP_9_15" concatenated in a 16 bit.

Nominal_Power

It represents the nominal power of the DALI lamp. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Dim_Mode

Indicates if fading (0) or ramping (1) is used when controlling the light intensity with the Present_Value.

Run_Hours

The number of seconds the lamp was On.

Run_Hours_Reset_Time

Indicates the last time the Run_Hours was reset.

Colour_Temp

For DALI Type 8 (DT8) lamps, whose colour control is colour temperature Tc, the current colour in Kelvin (K) can be modified. The objects for lamps, groups and channels can modify the colour temperature of lamps.

Command

Allows to execute commands on the lamps.

NO COMMAND (1)

No command is executed.

GO TO SCENE (2-17)

Recall the scenes 0-15.

STORE SCENE (18-33)

Store the scenes 0-15.

REMOVE SCENE (34-49)

Delete the scenes 0-15.

RESET RUN HOURS (52)

Reset the run hours to zero.

EMERGENCY FUNCTION TEST START (54)

Start the function test for the lamps of the type "Self-contained emergency lighting (device type 1)".

EMERGENCY DURATION TEST START (55)

Start the duration test for the lamps of the type "Self-contained emergency lighting (device type 1)".

EMERGENCY TESTS STOP (56)

Stop the current test for the lamps of the type "Self-contained emergency lighting (device type 1)".

GROUP ADD (67-82)

Add to the group 0-15.

GROUP REMOVE (83-98)

Remove from the group 0-15.

RECALL MIN LEVEL (200)

Recall Min Level.

RECALL MAX LEVEL (201)

Recall Max Level.

RECALL LAST LEVEL (202)

Recall Last Level.

EMERGENCY REST (203)

For the "Self-contained emergency lighting (device type 1)" only, starts the rest mode.

In this mode the lamp is intentionally off when it is powered from the battery.

Refer to the specification IEC 62386-202 for the complete details on the rest mode.

EMERGENCY INHIBIT (204)

For the "Self-contained emergency lighting (device type 1)" only, starts the inhibit mode.

In this mode the lamp is powered from the mains power supply but it is also prevented for 15 minutes from going into the emergency mode when an event of mains power failure occurs.

Refer to the specification IEC 62386-202 for the complete details on the inhibit mode.

EMERGENCY RESET INHIBIT (205)

For the "Self-contained emergency lighting (device type 1)" only, cancels the inhibit timer.

Refer to the specification IEC 62386-202 for the complete details on the inhibit mode.

EMERGENCY RESET FUNCTION TEST DONE FLAG (206)

For the "Self-contained emergency lighting (device type 1)" only, resets the function test done flag.

Refer to the specification IEC 62386-202 for the complete details on this command.

EMERGENCY RESET DURATION TEST DONE FLAG (207)

For the "Self-contained emergency lighting (device type 1)" only, resets the duration test done flag.

Refer to the specification IEC 62386-202 for the complete details on this command.

EMERGENCY START IDENTIFICATION (208)

For the "Self-contained emergency lighting (device type 1)" only, starts the identification.

Refer to the specification IEC 62386-202 for the complete details on this command.

Energy_Usage_Accumulated

It represents the accumulated energy consumption in watt-hours for the DALI lamp. This value is the result of a calculation based on the Nominal_Power property. It is writable for lamps, groups and channels. For groups and channels, it always read as NaN.

Device_Type_Supported

Indicates the supported DALI types for the physical DALI device connected to the object.

BitName
0Fluorescent
1Self-contained emergency
2Discharge HID
3Low-voltage halogen
4Incandescent lamp
5Conversion to DC voltage
6LED
7Switching relay
8Colour

Emergency_Time_Until_Next_Function_Test

For the "Self-contained emergency lighting (device type 1)" only, represents the time until the next function test in minutes.

The valid values are from 0 to 983 025 minutes.

DALI lamps calculate this value in 15 minutes intervals.

Emergency_Time_Until_Next_Duration_Test

For the "Self-contained emergency lighting (device type 1)" only, represents the time until the next duration test in minutes.

The valid values are from 0 to 983 025 minutes.

DALI lamps calculate this value in 15 minutes intervals.

Emergency_Battery_Charge

For the "Self-contained emergency lighting (device type 1)" only, represents the battery charge in percentages.

The valid values are from 0 to 100 percent and a value of NaN represents the DALI "MASK" value. "MASK" means that the lamp cannot perform this functionality.

Emergency_Duration_Test_Result

For the "Self-contained emergency lighting (device type 1)" only, represents the duration test result in minutes.

The valid values are from 0 to 510 minutes.

Emergency_Emergency_Mode

For the "Self-contained emergency lighting (device type 1)" only, represents the emergency mode.

BitNameValue
0reset mode is active0 = No
1normal mode is active0 = No
2emergency mode is active0 = No
3extended emergency mode is active0 = No
4function test is in progress0 = No
5duration test is in progress0 = No
6hardwired inhibit is active0 = Not active / not present
7hardwired switch is on0 = Off

Emergency_Failure_Status

For the "Self-contained emergency lighting (device type 1)" only, represents the failure status.

BitNameValue
0circuit failure0 = No
1battery duration failure0 = No
2battery failure0 = No
3emergency lamp failure0 = No
4function test maximum delay exceeded0 = No
5duration test maximum delay exceeded0 = No
6function test failed0 = No
7duration test failed0 = No

Emergency_Emergency_Status

For the "Self-contained emergency lighting (device type 1)" only, represents the emergency status.

BitNameValue
0inhibit mode0 = No
1function test done and result valid0 = No
2duration test done and result valid0 = No
3battery fully charged0 = In progress
4function test request pending0 = No
5duration test request pending0 = No
6identification active0 = No
7physically selected0 = No

Emergency_Emergency_Level

For the "Self-contained emergency lighting (device type 1)" only, represents the emergency level in percentages.

The valid values are from 0 to 100 percent and a value of NaN represents the DALI "MASK" value. "MASK" means that the value is unknown.

Emergency_Emergency_Minimum_Level

For the "Self-contained emergency lighting (device type 1)" only, represents the emergency minimum level in percentages.

The valid values are from 0 to 100 percent and a value of NaN represents the DALI "MASK" value. "MASK" means that the value is unknown.

Emergency_Emergency_Maximum_Level

For the "Self-contained emergency lighting (device type 1)" only, represents the emergency maximum level in percentages.

The valid values are from 0 to 100 percent and a value of NaN represents the DALI "MASK" value. "MASK" means that the value is unknown.

Emergency_Prolong

For the "Self-contained emergency lighting (device type 1)" only, represents the prolong time in seconds.

Valid values are between 0 and 7 650 seconds (127 minutes).

DALI lamps calculate this value in 30 second intervals.

Emergency_Function_Test_Interval_Time

For the "Self-contained emergency lighting (device type 1)" only, represents the function test interval time in days.

Valid values are between 0 and 255 days. The value 0 means that the automatic testing is not supported.

Emergency_Duration_Test_Interval_Time

For the "Self-contained emergency lighting (device type 1)" only, represents the duration test interval time in weeks.

Valid values are between 0 and 97 weeks. The value 0 means that the automatic testing is not supported.

Emergency_Test_Execution_Timeout

For the "Self-contained emergency lighting (device type 1)" only, represents the test execution timeout in days.

Valid values are between 0 and 255 days. A value of 0 means a 15 minutes execution timeout.

Emergency_Lamp_Emergency_Time

For the "Self-contained emergency lighting (device type 1)" only, represents the lamp emergency time in hours.

The valid values are from 0 to 254 hours and a value of 255 represents the maximum value of 254 hours or more.

Emergency_Lamp_Total_Operation_Time

For the "Self-contained emergency lighting (device type 1)" only, represents the lamp total operation time in hours.

The valid values are from 0 to 1 016 hours and a value of 1 020 represents the maximum value of 1 016 hours or more.

Emergency_Rated_Duration

For the "Self-contained emergency lighting (device type 1)" only, represents the rated duration.

The valid values are from 0 to 510 minutes.

Emergency_Features

For the "Self-contained emergency lighting (device type 1)" only, represents the features information describing the type of lamp.

BitNameValue
0integral emergency control gear0 = No
1maintained control gear0 = No
2switched maintained control gear0 = No
3auto test capability0 = No
4adjustable emergency level0 = No
5hardwired inhibit supported0 = No
6physical selection supported0 = No
7re-light in rest mode supported0 = No

Dimming_Curve

The dimming curve determines how the DALI level should be translated into light output. The standard dimming curve is logarithmic. Some lamps allow modifying to dimming curve between logarithmic and a linear one.

The DALION automatically translates the requested light output of a percentage to the dimming curve configured in the lamp with the following formulas.

Logarithmic

Image of dimming curve logarithmic formula

Linear

Image of dimming curve linear formula

It is important to note that sending a dimming command to a group consisting of lamps of different dimming curves may not produce the expected result. Ideally, only group lamps configured with the same dimming curve.

It is recommended to configure the dimming curve before programming the other levels such as scenes, minimum level, maximum level, power on level, etc.

LOGARITHMIC (1)

Standard logarithmic dimming curve.

LINEAR (2)

Linear dimming curve.

Colour_Type

The current or requested colour control type.

The supported colour types are as follows.

NameValue
xy-coordinate1
colour temperature Tc2
primary N3
RGBWAF4

Colour_XYC_X

For DALI Type 8 (DT8) lamps, whose colour control is xy-Coordinate, the x-coordinate of the current colour can be modified. The objects for lamps, groups and channels can modify the colour of lamps.

The valid values are from 0 to 65534 and a value of NaN represents the DALI "MASK" value.

The unit of the value is 1 / 65536. Therefore the maximum corresponding x-coordinate is 0.99997.

Colour_XYC_Y

For DALI Type 8 (DT8) lamps, whose colour control is xy-Coordinate, the y-coordinate of the current colour can be modified. The objects for lamps, groups and channels can modify the colour of lamps.

The valid values are from 0 to 65534 and a value of NaN represents the DALI "MASK" value.

The unit of the value is 1 / 65536. Therefore the maximum corresponding y-coordinate is 0.99997.

Colour_TC_TC

For DALI Type 8 (DT8) lamps, whose colour control is colour temperature Tc, the current colour temperature can be modified. The objects for lamps, groups and channels can modify the colour of lamps.

The valid values are from 1 to 65534 and a value of NaN represents the DALI "MASK" value.

The unit of the value is 1 Mirek. Therefore the minimum value is 1 Mirek (1000000 Kelvin) and the maximum value is 65534 Mirek (15.26 Kelvin).

Mirek = 1 000 000 / [Colour Temperature in Kelvin]

Kelvin = 1 000 000 / [value of Mirek]

Colour_PN_P0 to Colour_PN_P5

For DALI Type 8 (DT8) lamps, whose colour control is primary N, the current colour can be modified. The objects for lamps, groups and channels can modify the colour of lamps.

The valid values are from 0 to 65534 and a value of NaN represents the DALI "MASK" value.

The unit of the value is 1 / 65536. Therefore the maximum corresponding primary value is 0.99997.

Colour_RGBWAF_RED

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current red colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Colour_RGBWAF_GREEN

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current green colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Colour_RGBWAF_BLUE

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current blue colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Colour_RGBWAF_WHITE

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current white colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Colour_RGBWAF_AMBER

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current amber colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Colour_RGBWAF_FREECOLOUR

For the lamps DALI Type 8 (DT8), whose colour control is RGBWAF, the current freecolour colour can be modified. The objects for lamps, groups and channels can modify lamp colour.

The valid values are from 0 to 254 and a value of NaN represents the DALI "MASK" value.

Network_Mode

NameValueDescription
NORMAL0The controller is operating normally.
DISABLE1The controller is not authorized to communicate on the DALI channel.

Network_Command_Repeat_Count

The number of repeats of the DALI commands that affect the light intensity of the lamps.