FB_DALI209StartAutoCalibration

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 colourStatus variable is 1 as long as the timer is active (see FB_DALI209QueryColourStatus). 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 colourStatus 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 colourStatus 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. Bit 3 of colorStatus is then set to 1. The ability to restore the last successful calibration data is a feature of the operating device (see FB_DALI209QueryGearFeaturesStatus 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. 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 colourStatus variable is 1 as long as the timer is active (see FB_DALI209QueryColourStatus). 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 colourStatus 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 colourStatus 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. Bit 3 of colorStatus is then set to 1. The ability to restore the last successful calibration data is a feature of the operating device (see FB_DALI209QueryGearFeaturesStatus 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).

Inputs

VAR_INPUT
  bStart            : BOOL;
  nAddress          : BYTE;
  eAddressType      : E_DALIAddressType := E_DALIAddressType.Short;
  eCommandPriority  : E_DALICommandPriority := E_DALICommandPriority.MiddleLow;
END_VAR

eCommandPriority has no function with the KL6811. The DALI command priorities are supported by the KL6821 from the firmware version BD.

Outputs

VAR_OUTPUT
  bError                  : BOOL;
  ipResultMessage         : I_TcMessage;
  bBusy                   : BOOL;
END_VAR

 Properties

Requirements