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.

The command starts a 15-minute timer or initiates it again. Bit 2 of the COLOUR STATUS variable is 1 as long as the timer is active (see FB_DALIV2QueryColourStatus()). On expiry of the timer the last color representation, the last color value and the last lamp power level are directly saved again.

During the timer period the DALI control gear carries out a calibration procedure in order to measure the x-coordinate, the y-coordinate and the TY value of all supported primary colors. Whilst the calibration procedure is running, the DALI control gear does not react to any commands apart from TERMINATE, QUERY COLOUR STATUS and START AUTO CALIBRATION. In addition, bit 3 in the variable COLOUR STATUS is set to 0 at the start of the calibration. The TERMINATE command ends the procedure and stops the timer.

If the calibration was successful, bit 3 in COLOUR STATUS is set to 1 and the timer is stopped. If the calibration was not successful, then the last successful calibration data are restored if the DALI control gear is able to do so. Subsequently, bit 3 of COLOUR STATUS is set to 1. The ability to restore the last successful calibration data is a feature of the operating device (see QUERY GEAR FEATURES/STATUS command).

Due to the fact that the calibration can take longer than 15 minutes, the status of the automatic calibration should be checked periodically using the QUERY COLOUR STATUS command and the calibration timer restarted with the START AUTO CALIBRATION command (if necessary).

The function block supports the following color representations:

• xy coordinates
• Color temperature Tc
• Primary (color) N
• RGBWAF

This command belongs 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.

bStart            : BOOL;
nAddr             : BYTE;
eAddrType         : E_DALIV2AddrType := eDALIV2AddrTypeShort;
eCommandPriority  : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;

bBusy         : BOOL;
bError        : BOOL;
nErrorId      : UDINT;

stCommandBuffer   : ST_DALIV2CommandBuffer;