Variables
Every DALI control gear for color/color temperature control has a certain number of variables (parameters ) from which it is possible to read a variety of information or to modify individual parameters.
Some variables can be read directly by DALI commands (e.g. FB_DALI209QueryColourStatus). The function block FB_DALI209QueryColourValue can be used to read out further variables.
Name | Reset value | Scope | Size | Comment | |
---|---|---|---|---|---|
65535 | 0…65535 | 2 bytes | 0, 2 |
| |
reportXCoordinate | 65535 | 0…65535 | 2 bytes | 0 |
|
No change | 0…65535 | 2 bytes | 0 |
| |
65535 | 0…65535 | 2 bytes | 0, 2 |
| |
reportYCoordinate | 65535 | 0…65535 | 2 bytes | 0 |
|
No change | 0…65535 | 2 bytes | 0 |
| |
65535 | 1…65535 | 2 bytes | 1 |
| |
reportColourTemperatureTc | 65535 | 1…65535 | 2 bytes | 1 |
|
No change | 1…65535 | 2 bytes | 1 |
| |
colourTemperatureTcCoolest | colourTemperatureTcPhysicalCoolest | colourTemperatureTcPhysicalCoolest | 2 bytes | 1 |
|
colourTemperatureTcWarmest | colourTemperatureTcPhysicalWarmest | colourTemperatureTcCoolest | 2 bytes | 1 |
|
colourTemperatureTcPhysicalCoolest | No change | 1 | 2 bytes | 1 |
|
colourTemperatureTcPhysicalWarmest | No change | colourTemperatureTcPhysicalCoolest | 2 bytes | 1 |
|
65535 | 0...65535 | 2 bytes | 2 |
| |
reportPrimaryNDimLevel | 65535 | 0…65535 | 2 bytes | 2 |
|
No change | 0…65535 | 2 bytes | 2 |
| |
No change | 0…65535 | 2 bytes | 0, 2 | Read only | |
No change | 0…65535 | 2 bytes | 0, 2 | Read only | |
No change | 0…65535 | 2 bytes | 0, 2 | Read only | |
255 | 0…255 | 1 byte | 3 |
| |
reportRedDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportGreenDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportBlueDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportWhiteDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportAmberDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportFreeColourDimLevel | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
255 | 0…255 | 1 byte | 3 |
| |
reportRGBWAFControl | 255 | 0…255 | 1 byte | 3 |
|
No change | 0…255 | 1 byte | 3 |
| |
16#0102_0304_0506 | 16#0000_0000_0000 | 6 bytes | 3 | Read only MSB: channel 0 LSB: channel 5 | |
255 | 16#10, 16#20, 16#40, 16#80, 16#FF | 1 byte | 0, 1, 2, 3 |
| |
255 | 16#10, 16#20, 16#40, 16#80, 16#FF | 1 byte | 0, 1, 2, 3 |
| |
65535 | 16#10, 16#20, 16#40, 16#80, 16#FF | 1 byte | 0, 1, 2, 3 | Read only | |
scene0-15ColourValue | 65535 | 0…65535 | 32 bytes…192 bytes | 0, 1, 2, 3 | Read only |
Manufacturer-dependent | 16#10, 16#20, 16#40, 16#80, 16#FF | 1 byte | 0, 1, 2, 3 | Read only | |
powerOnColourValue | Manufacturer-dependent | 0…65535 | 2 bytes…12 bytes | 0, 1, 2, 3 | Read only |
Manufacturer-dependent | 16#10, 16#20, 16#40, 16#80, 16#FF | 1 byte | 0, 1, 2, 3 | Read only | |
systemFailureColourValue | Manufacturer-dependent | 0…65535 | 2 bytes…12 bytes | 0, 1, 2, 3 | Read only |
2#XX00_0001 | 2#XX00_0000, 2#XX00_0001 | 1 byte | 0, 1, 2, 3 |
| |
No change | 0…255 | 1 byte | 0, 1, 2, 3 |
| |
No change | 0…255 | 1 byte | 0, 1, 2, 3 | Read only |
X: undetermined
In the case of 1-byte values the value 255 is also called MASK.
In the case of 2-byte values the value 65,535 is also called MASK.
Necessary color representation
Specifies the color representation that the DALI control gear must support so that it contains the appropriate variables:
Value | Description |
---|---|
0 | xy coordinates |
1 | Color temperature Tc |
2 | Primary (color) N |
3 | RGBWAF |
xCoordinate / temporaryXCoordinate
Chromaticity coordinate x in the xy color type.
The x-Coordinate is specified in Mirek.
It can vary from 0 Mirek (0 K) to 65534 Mirek (15.26 K).
At a value of 65535 (MASK), the value is not defined.
yCoordinate / temporaryYCoordinate
Chromaticity coordinate y in the xy color type.
The y-Coordinate is specified in Mirek.
It can vary from 0 Mirek (0 K) to 65534 Mirek (15.26 K).
At a value of 65535 (MASK), the value is not defined.
colourTemperatureTc / temporaryColourTemperatureTc
The variable colourTemperatureTc / temporaryColourTemperatureTc defines the color temperature. It is adjustable in the range between colourTemperatureTcWarmest and colourTemperatureTcCoolest.
The colourTemperatureTc is specified in Mirek.
It can vary from 1 Mirek (1000000 K) to 65534 Mirek (15.26 K).
colourTemperatureTcCoolest / colourTemperatureTcWarmest
dimLevel / temporaryDimLevel
Setting of the dimming level of the corresponding color (red, green, blue, white, amber or a freely selectable color) from 0 to 255.
primaryNDimLevel / temporary primaryNDimLevel
assignedColour
The association between output channel and color is defined in the variable assignedColour. Each byte contains the color of the corresponding channel. The function block FB_DALI209QueryAssignedColour can be used to read out the value.
Value | Description |
---|---|
0 | No color assigned |
1 | Red |
2 | Green |
3 | Blue |
4 | White |
5 | Amber |
6 | Freely selectable color |
colourType
The variable colourType defines the color representations supported by the DALI control gear. The values can be read out with the function block FB_DALI209QueryColourValue.
Description | |
---|---|
XyCoordinate | xy coordinates |
ColourTemperatureTc | Color temperature Tc |
PrimaryNDimLevel | Primary (color) N |
RGBWAFControl | RGBWAF |
MASK | No color change |
colourStatus
colourStatus contains information about the current status of the DALI control gear.
The function block FB_DALI209QueryColourStatus can be used to read out the values
Bit | Description |
---|---|
0 | xy coordinate color point is outside the valid range. |
1 | Color temperature Tc lies outside the valid range |
2 | Automatic calibration is active. |
3 | Automatic calibration was successful. |
4 | Color representation xy-coordinate active. |
5 | Color representation color temperature Tc active. |
6 | Color representation primary N active. |
7 | Color representation RGBWAF active. |
gearFeatures / Status
gearFeatures / Status contains information about the current status of the DALI control gear.
The values can be read with the function block FB_DALI209QueryGearFeaturesStatus and written with the function block FB_DALI209StoreGearFeaturesStatus.
Bit | Description |
---|---|
0 | Automatic activation |
1…5 | reserved |
6 | Automatic calibration is supported |
7 | Restoration of the automatic calibration is supported |
RGBWAFControl / temporaryRGBWAFControl
RGBWAFControl contains further information about the assignment between output channel and color.
Bit | Description |
---|---|
0 | Output channel 0 / red |
1 | Output channel 1 / green |
2 | Output channel 2 / blue |
3 | Output channel 3 / white |
4 | Output channel 4 / amber |
5 | Output channel 5 / free selectable color |
6…7 | 00 = channel control |
colourTypeFeatures
colourTypeFeatures defines the color representations supported by the DALI control gear.
The values can be read out with the function block FB_DALI209QueryColourTypeFeatures.
Bit | Description |
---|---|
0 | The DALI control gear supports color representation through xy coordinates. |
1 | The DALI control gear supports color representation through color temperature Tc. |
2…4 | Number of primary colors supported by the DALI control gear. A value of 0 means that this color representation by primary colors is not supported. |
5…7 | Number of RGBWAF channels supported by the DALI control gear. A value of 0 means that this color representation by RGBWAF is not supported. |