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 via DALI commands (e.g. FB_DALIV2QueryColourStatus or FB_DALIV2QueryRGBWAFControl). The function block FB_DALIV2QueryColourValue can be used to read additional variables.
Name | Default value | Reset value | Scope | Size | necessary color representation (1) | Comment |
|---|---|---|---|---|---|---|
TEMPORARY x-COORDINATE | 65535 | 65535 | 0 ...65535 | 2 bytes | 0, 2 |
|
REPORT x-COORDINATE | 65535 | 65535 | 0 ...65535 | 2 bytes | 0 |
|
x-COORDINATE | ? | No change | 0 ...65535 | 2 bytes | 0 |
|
TEMPORARY y-COORDINATE | 65535 | 65535 | 0 ...65535 | 2 bytes | 0.2 |
|
REPORT y-COORDINATE | 65535 | 65535 | 0 ...65535 | 2 bytes | 0 |
|
y-COORDINATE | ? | No change | 0 ...65535 | 2 bytes | 0 |
|
TEMPORARY COLOUR TEMPERATURE Tc | 65535 | 65535 | 1 ... 65535 | 2 bytes | 1 |
|
REPORT COLOUR TEMPERATURE Tc | 65535 | 65535 | 1 ... 65535 | 2 bytes | 1 |
|
COLOUR TEMPERATURE Tc | ? | No change | 1 ... 65535 | 2 bytes | 1 |
|
COLOUR TEMPERATURE Tc COOLEST | ? | COLOUR TEMPERATURE Tc PHYSICAL COOLEST | COLOUR TEMPERATURE Tc PHYSICAL COOLEST … COLOUR TEMPERATURE Tc WARMEST, 65535 | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc WARMEST | ? | COLOUR TEMPERATURE Tc PHYSICAL WARMEST | COLOUR TEMPERATURE Tc COOLEST ... COLOUR TEMPERATURE Tc PHYSICAL WARMEST, 65535 | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc PHYSICAL COOLEST | ? | No change | 1 - COLOUR TEMPERATURE Tc PHYSICAL WARMEST, 65535 | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc PHYSICAL WARMEST | ? | No change | COLOUR TEMPERATURE Tc PHYSICAL COOLEST - 65534, 65535 | 2 bytes | 1 | read only |
TEMPORARY PRIMARY N DIMLEVEL | 65535 | 65535 | 0 ...65535 | up to 12 bytes | 2 |
|
REPORT PRIMARY N DIMLEVEL | 65535 | 65535 | 0 ...65535 | up to 12 bytes | 2 |
|
PRIMARY N DIMLEVEL | ? | No change | 0 ...65535 | up to 12 bytes | 2 |
|
x-COORDINATE PRIMARY N | ? | No change | 0 ...65535 | up to 12 bytes | 0.2 | read only |
y-COORDINATE PRIMARY N | ? | No change | 0 ...65535 | up to 12 bytes | 0.2 | read only |
TY PRIMARY N | ? | No change | 0 ...65535 | up to 12 bytes | 0.2 | read only |
TEMPORARY RED DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT RED DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
RED DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY GREEN DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT GREEN DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
GREEN DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY BLUE DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT BLUE DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
BLUE DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY WHITE DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT WHITE DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
WHITE DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY AMBER DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT AMBER DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
AMBER DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY FREECOLOUR DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT FREECOLOUR DIMLEVEL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
FREECOLOUR DIMLEVEL | ? | No change | 0 ... 255 | 1 byte | 3 |
|
TEMPORARY RGBWAF CONTROL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
REPORT RGBWAF CONTROL | 255 | 255 | 0 ... 255 | 1 byte | 3 |
|
63 | No change | 0 ... 255 | 1 byte | 3 |
| |
0x0102 0304 0506 | 0x0102 0304 0506 | 0x0000 0000 0000 | 6 bytes | 3 | read only MSB: channel 0 LSB: channel 5 | |
255 | 255 | 0x10, 0x20, 0x40, 0x80, 0xFF | 1 byte | 0, 1, 2, 3 |
| |
255 | 255 | 0x10, 0x20, 0x40, 0x80, 0xFF | 1 byte | 0, 1, 2, 3 |
| |
65535 | 65535 | 0x10, 0x20, 0x40, 0x80, 0xFF | 16 bytes | 0, 1, 2, 3 | read only | |
SCENE 0–15 COLOUR VALUE | 65535 | 65535 | 0 ... 65535 | 32 bytes ... 192 bytes | 0, 1, 2, 3 | read only |
Manufacturer dependent | Manufacturer dependent | 0x10, 0x20, 0x40, 0x80, 0xFF | 1 byte | 0, 1, 2, 3 | read only | |
POWER ON COLOUR VALUE | Manufacturer dependent | Manufacturer dependent | 0 ...65535 | 2 bytes ... 12 bytes | 0, 1, 2, 3 | read only |
Manufacturer dependent | Manufacturer dependent | 0x10, 0x20, 0x40, 0x80, 0xFF | 1 byte | 0, 1, 2, 3 | read only | |
SYSTEM FAILURE COLOUR VALUE | Manufacturer dependent | Manufacturer dependent | 0 ...65535 | 2 bytes ... 12 bytes | 0, 1, 2, 3 | read only |
??00 0001b | ??00 0001b | ??00 0000b, ??00 0001b | 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 |
?: undetermined
In the case of 1-byte values the value 255 is also called MASK.
In the case of 2-byte values the value 65535 is also called MASK.
(1): Specifies the color representation that the DALI control gear must support so that it contains the appropriate variable:
Value | Description |
|---|---|
0 | xy coordinates |
1 | Color temperature Tc |
2 | Primary (color) N |
3 | RGBWAF |
ASSIGNED COLOUR
The assignment between output channel and color is defined in ASSIGNED COLOR. Each byte contains the color of the corresponding channel.
The function block FB_DALIV2QueryAssignedColour can be used to read the value.
Value | Description |
|---|---|
0 | No color assigned |
1 | Red |
2 | Green |
3 | Blue |
4 | White |
5 | Amber |
6 | Freely selectable color |
COLOUR TYPE
COLOR TYPE defines the color representations supported by the DALI control gear.
The values can be read using the function block FB_DALIV2QueryColorValue.
Values | Description |
|---|---|
0x10 | xy coordinates |
0x20 | Color temperature Tc |
0x40 | Primary (color) N |
0x80 | RGBWAF |
0xFF | no color change |
COLOUR STATUS
COLOUR STATUS contains information about the current status of the DALI control gear.
The values can be read using the function block FB_DALIV2QueryColorStatus.
Bit | Description |
|---|---|
0 | xy-coordinate color point lies outside of the valid range. |
1 | Color temperature Tc lies outside of the valid range. |
2 | Automatic calibration is active. |
3 | Automatic calibration was successful. |
4 | Color representation xy-coordinate active. |
5 | Color representation colour temperature Tc active. |
6 | Color representation primary N active. |
7 | Color representation RGBWAF active. |
GEAR FEATURES/STATUS
GEAR FEATURES/STATUS contains information about the current status of the DALI control gear.
The values can be read using the function block FB_DALIV2QueryGearFeaturesStatus and written using the function block FB_DALIV2StoreGearFeaturesStatus.
Bit | Description |
|---|---|
0 | Automatic activation. |
1 - 5 | Reserved. |
6 | Automatic calibration is supported. |
7 | Restoration of the automatic calibration is supported. |
RGBWAF CONTROL
RGBWAF CONTROL contains further information about the assignment between output channel and color.
The values can be read using the function block FB_DALIV2QueryColorValue.
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 01 = color control 10 = standardized color control 11 = reserved |
COLOUR TYPE FEATURES
COLOUR TYPE FEATURES contains the color representations supported by the DALI control gear.
The values can be read using the function block FB_DALIV2QueryColourTypeFeatures.
Bit | Description |
|---|---|
0 | The control gear supports the color representation by xy coordinates. |
1 | The control gear supports the color representation by color temperature Tc. |
2 - 4 | The number of primary colors supported by the control gear. A value of 0 means that this color representation by primary colors is not supported. |
5 - 7 | The number of RGBWAF channels supported by the control gear. A value of 0 means that this color representation by RGBWAF is not supported. |