Colour/colour temperature control variables
Every DALI ballast for colour/colour 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.
Certain variables can be read out directly via DALI commands (e.g. FB_QueryColourStatus() or FB_QueryRGBWAFControl ()). The FB_QueryColourValue() function block can be used to read out further variables.
Name | Default value | Reset value | Valid range | Size | necessary colour 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 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 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 | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc WARMEST | ? | COLOUR TEMPERATURE Tc PHYSICAL WARMEST | COLOUR TEMPERATURE Tc COOLEST | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc PHYSICAL COOLEST | ? | No change | 1 - COLOUR TEMPERATURE Tc PHYSICAL WARMEST, | 2 bytes | 1 | read only |
COLOUR TEMPERATURE Tc PHYSICAL WARMEST | ? | No change | COLOUR TEMPERATURE Tc PHYSICAL COOLEST - 65534, | 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 | |
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 |
?: Not specified
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 colour representation that the DALI ballast must support so that it contains the appropriate variable:
Value | Description |
|---|---|
0 | xy coordinates |
1 | Colour temperature Tc |
2 | Primary (colour) N |
3 | RGBWAF |
ASSIGNED COLOUR
The assignment between output channel and colour is defined in ASSIGNED COLOUR. Each byte contains the colour of the corresponding channel.
The value can be read with the FB_DALIV2QueryAssignedColour() block.
Value | Description |
|---|---|
0 | No colour assigned |
1 | Red |
2 | Green |
3 | Blue |
4 | White |
5 | Amber |
6 | Free colour |
COLOUR TYPE
COLOUR TYPE defines the colour representations supported by the DALI ballast.
The values can be read out using the FB_DALIV2QueryColourValue() function block.
Value | Description |
|---|---|
0x10 | xy coordinates |
0x20 | Colour temperature Tc |
0x40 | Primary (colour) N |
0x80 | RGBWAF |
0xFF | No colour change |
COLOUR STATUS
COLOUR TYPE contains information about the current status of the DALI ballast.
The values can be read out using the FB_DALIV2QueryColourStatus() function block.
Bit | Description |
|---|---|
0 | xy-coordinate colour point lies outside the valid range. |
1 | Colour temperature Tc lies outside the valid range. |
2 | Automatic calibration is active. |
3 | Automatic calibration was successful. |
4 | Colour representation xy-coordinate active. |
5 | Colour representation colour temperature Tc active. |
6 | Colour representation primary N active. |
7 | Colour representation RGBWAF active. |
GEAR FEATURES/STATUS
GEAR FEATURES/STATUS contains information about the current status of the DALI ballast.
The values can be read out using the FB_DALIV2QueryGearFeaturesStatus() function block and written using the FB_DALIV2StoreGearFeaturesStatus() function block.
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 colour.
The values can be read out using the FB_DALIV2QueryColourValue() function block.
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 colour |
6 - 7 | 00 = channel control |
COLOUR TYPE FEATURES
COLOUR TYPE FEATURES defines the colour representations supported by the DALI ballast.
The values can be read out using the FB_DALIV2QueryColourTypeFeatures() function block.
Bit | Description |
|---|---|
0 | The ballast supports the colour representation by xy coordinates. |
1 | The ballast supports the colour representation by colour temperature Tc. |
2 - 4 | The number of primary colours supported by the ballast. A value of 0 means that this colour representation by primary colours is not supported. |
5 - 7 | The number of RGBWAF channels supported by the ballast. A value of 0 means that this colour representation by RGBWAF is not supported. |