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

Necessary color representation

Comment

temporaryXCoordinate

65535

0…65535

2 bytes

0, 2

 

reportXCoordinate

65535

0…65535

2 bytes

0

 

xCoordinate

No change

0…65535

2 bytes

0

 

temporaryYCoordinate

65535

0…65535

2 bytes

0, 2

 

reportYCoordinate

65535

0…65535

2 bytes

0

 

yCoordinate

No change

0…65535

2 bytes

0

 

temporaryColourTemperatureTc

65535

1…65535

2 bytes

1

 

reportColourTemperatureTc

65535

1…65535

2 bytes

1

 

colourTemperatureTc

No change

1…65535

2 bytes

1

 

colourTemperatureTcCoolest

colourTemperatureTcPhysicalCoolest

colourTemperatureTcPhysicalCoolest

colourTemperatureTcWarmest,
65535

2 bytes

1

 

colourTemperatureTcWarmest

colourTemperatureTcPhysicalWarmest

colourTemperatureTcCoolest

colourTemperatureTcPhysicalWarmest,
65535

2 bytes

1

 

colourTemperatureTcPhysicalCoolest

No change

1

colourTemperatureTcPhysicalWarmest,
65535

2 bytes

1

 

colourTemperatureTcPhysicalWarmest

No change

colourTemperatureTcPhysicalCoolest

65534, 65535

2 bytes

1

 

temporaryPrimaryNDimLevel

65535

0...65535

2 bytes

2

 

reportPrimaryNDimLevel

65535

0…65535

2 bytes

2

 

primaryNDimLevel

No change

0…65535

2 bytes

2

 

xCoordinatePrimaryN

No change

0…65535

2 bytes

0, 2

Read only

yCoordinatePrimaryN

No change

0…65535

2 bytes

0, 2

Read only

tyPrimaryN

No change

0…65535

2 bytes

0, 2

Read only

temporaryRedDimLevel

255

0…255

1 byte

3

 

reportRedDimLevel

255

0…255

1 byte

3

 

redDimLevel

No change

0…255

1 byte

3

 

temporaryGreenDimLevel

255

0…255

1 byte

3

 

reportGreenDimLevel

255

0…255

1 byte

3

 

greenDimLevel

No change

0…255

1 byte

3

 

temporaryBlueDimLevel

255

0…255

1 byte

3

 

reportBlueDimLevel

255

0…255

1 byte

3

 

blueDimLevel

No change

0…255

1 byte

3

 

temporaryWhiteDimLevel

255

0…255

1 byte

3

 

reportWhiteDimLevel

255

0…255

1 byte

3

 

whiteDimLevel

No change

0…255

1 byte

3

 

temporaryAmberDimLevel

255

0…255

1 byte

3

 

reportAmberDimLevel

255

0…255

1 byte

3

 

amberDimLevel

No change

0…255

1 byte

3

 

temporaryFreeColourDimLevel

255

0…255

1 byte

3

 

reportFreeColourDimLevel

255

0…255

1 byte

3

 

freeColourDimLevel

No change

0…255

1 byte

3

 

temporaryRGBWAFControl

255

0…255

1 byte

3

 

reportRGBWAFControl

255

0…255

1 byte

3

 

RGBWAFControl

No change

0…255

1 byte

3

 

assignedColour

16#0102_0304_0506

16#0000_0000_0000

16#0606_0606_0606

6 bytes

3

Read only

MSB: channel 0

LSB: channel 5

temporaryColourType

255

16#10, 16#20, 16#40, 16#80, 16#FF

1 byte

0, 1, 2, 3

 

reportColourType

255

16#10, 16#20, 16#40, 16#80, 16#FF

1 byte

0, 1, 2, 3

 

scene0-15ColourType

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

powerOnColourType

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

systemFailureColourType

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

gearFeatures/Status

2#XX00_0001

2#XX00_0000, 2#XX00_0001

1 byte

0, 1, 2, 3

 

colourStatus

No change

0…255

1 byte

0, 1, 2, 3

 

colourTypeFeatures

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.

E_DALIColourType

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
01 = color control
10 = standardized color control
11 = reserved

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.