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 variable COLOUR STATUS 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 calibration can take longer than 15 minutes, the status of the automatic calibration should be checked periodically with the QUERY COLOUR STATUS command and the calibration timer should be restarted with the START AUTO CALIBRATION command (if necessary).

The function block supports the 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. The command Enable Device Type 8 is internally placed automatically before all application extended commands for lamps for the color/color temperature control with DALI interface.

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

VAR_IN_OUT
  stCommandBuffer : ST_DALIV2CommandBuffer;
END_VAR

VAR_OUTPUT
  bBusy    : BOOL;
  bError   : BOOL;
  nErrorId : UDINT;
END_VAR