1. TwinCAT 3 PLC Lib: Tc2_DALI
2. Programming
3. POUs
4. Low-Level commands
5. Part 209 (color/color temperature control)
6. FB_DALIV2StartAutoCalibration

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 COLOR STATUS variable is 1 as long as the timer is active (see FB_DALIV2QueryColorStatus()). 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 COLOR STATUS and START AUTO CALIBRATION. In addition, bit 3 in the COLOR STATUS variable 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 COLOR 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 COLOR 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 COLOR 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-related expansion commands for lamps for the color/color temperature control with DALI interface. They function only if they are preceded by the Enable Device Type 8 command, which can be sent with the FB_DALIV2EnableDeviceType() function block. The Enable Device Type 8 command is internally placed automatically before all application-related expansion commands for lamps for the 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;