Colour/colour temperature control function blocks

The function blocks and variables for lamps for color/color temperature control with DALI interface are described below. All function blocks described below call 'application extended commands'. According to the DALI standard (IEC 62386) these commands are within the range 224 to 255. Because of the existence of a variety of application extended commands, it is necessary to use the FB_DALIV2EnableDeviceType() function block to specify which type of control gears (emergency lighting, discharge lamps, ...) should react to the extension commands. A precise description of the individual DALI commands and the variables for lamps for color/color temperature control with DALI interface can be found in IEC 62386 part 209.

Colour/colour temperature control function blocks 1:

Name

Description

FB_DALIV2Activate

Starts a new cross-fade. A running cross-fade will be ended beforehand.

FB_DALIV2AssignColourToLinkedChannel

Linked output channels are assigned to the defined color.

FB_DALIV2ColourTemperatureTcStepCooler

The value COLOUR TEMPERATURE Tc is decremented by 1 Mirek.

FB_DALIV2ColourTemperatureTcStepWarmer

The value COLOUR TEMPERATURE Tc is incremented by 1 Mirek.

FB_DALIV2CopyReportToTemporary

The color settings report is copied to the temporary color settings.

FB_DALIV2QueryAssignedColour

Reads the assigned color of the specified output channel.

FB_DALIV2QueryColourStatus

The variable COLOUR STATUS is read from the control gear.

FB_DALIV2QueryColourTypeFeatures

The color representations supported by the control gear are read out.

FB_DALIV2QueryColourValue

The specified color value is read from the control gear.

FB_DALIV2QueryGearFeaturesStatus

The variable GEAR FEATURES/STATUS is read from the control gear.

FB_DALIV2QueryRGBWAFControl

The variable RGBWAF CONTROL is read from the control gear.

FB_DALIV2SetTemporaryColourTemperatureTc

Saves the value in the variable TEMPORARY COLOUR TEMPERATURE Tc of the control gear.

FB_DALIV2SetTemporaryPrimaryNDimlevel

Saves the value in the variable TEMPORARY PRIMARY N DIMLEVEL of the control gear.

FB_DALIV2SetTemporaryRGBDimlevel

Saves the values in the variables TEMPORARY RED DIMLEVEL, TEMPORARY GREEN DIMLEVEL and TEMPORARY BLUE DIMLEVEL of the control gear.

FB_DALIV2SetTemporaryRGBWAFControl

Saves the value in the variable TEMPORARY RGBWAF CONTROL of the control gear.

FB_DALIV2SetTemporaryWAFDimlevel

Saves the values in the variables TEMPORARY WHITE DIMLEVEL, TEMPORARY AMBER DIMLEVEL and TEMPORARY FREECOLOUR DIMLEVEL of the control gear.

FB_DALIV2SetTemporaryXCoordinate

Saves the value in the variable TEMPORARY x-COORDINATE of the control gear.

FB_DALIV2SetTemporaryYCoordinate

Saves the value in the variable TEMPORARY y-COORDINATE of the control gear.

FB_DALIV2StartAutoCalibration

The calibration procedure is started in order to measure the x-coordinate, the y-coordinate and the TY value of all supported primary colors.

FB_DALIV2StoreColourTemperatureTcLimit

Saves the value in the variable COLOUR TEMPERATURE Tc COOLEST, COLOUR TEMPERATURE Tc WARMEST, COLOUR TEMPERATURE Tc PHYSICAL COOLEST or COLOUR TEMPERATURE Tc PHYSICAL WARMEST of the control gear.

FB_DALIV2StoreGearFeaturesStatus

Saves the value in the variable GEAR FEATURES/STATUS of the control gear.

FB_DALIV2StoreTYPrimaryN

Saves the value in the variable TY PRIMARY N of the control gear.

FB_DALIV2StoreXyCoordinatePrimaryN

Copies the value from the variables TEMPORARY x-COORDINATE and TEMPORARY y-COORDINATE to the variables x-COORDINATE PRIMARY N and y-COORDINATE PRIMARY N.

FB_DALIV2XCoordinateStepDown

The variable x-COORDINATE is reduced by 256 steps (256 / 65536) without cross-fading.

FB_DALIV2XCoordinateStepUp

The variable x-COORDINATE is increased by 256 steps (256 / 65536) without cross-fading.

FB_DALIV2YCoordinateStepDown

The variable y-COORDINATE is reduced by 256 steps (256 / 65536) without cross-fading.

FB_DALIV2YCoordinateStepUp

The variable y-COORDINATE is increased by 256 steps (256 / 65536) without cross-fading.

Colour/colour temperature control function blocks 2:

These commands belong to the application extended commands for lamps for the color/color temperature control with DALI interface. These only work if they are preceded by the Enable Device Type 8 command, which can be sent with the function block FB_DALIV2EnableDeviceType(). From version 2.6.0 of the libraries TcDALIV2 and TcDALIV2AppExtCmds, however, the Enable Device Type 8 command is internally placed automatically before all application extended commands for lamps for color/color temperature control with DALI interface.