FB_DALIV2QueryColourTypeFeatures

FB_DALIV2QueryColourTypeFeatures 1:

The COLOR TYPE FEATURES variable is read from the DALI control gear. This contains the color representations supported by the DALI control gear.

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.

VAR_INPUT

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

bStart: The function block is activated by a positive edge at this input.

nAddr: The address of a participating device or of a group.

eAddrType: Short address, group address or broadcast (see E_DALIV2AddrType).

eCommandPriority: Priority (high, medium or low) with which the command is processed by the library (see E_DALIV2CommandPriority).

VAR_OUTPUT

bBusy                        : BOOL;
bError                       : BOOL;
nErrorId                     : UDINT;
bSupportsXyCoordinate        : BOOL;
bSupportsColourTemperatureTc : BOOL;
nNumberOfPrimaryColors       : BYTE;
nNumberOfRGBWAFChannels      : BYTE;

bBusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed.

bError: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in nErrorId. Is reset to FALSE by the execution of a command at the inputs.

nErrorId: Contains the command-specific error code of the most recently executed command. Is reset to 0 by the execution of a command at the inputs. (See error codes)

bSupportsXyCoordinate: The control gear is xy-coordinate-capable.

bSupportsColorTemperatureTc: The control gear is Color temperature Tc-capable.

nNumberOfPrimaryColors: The number of primary colors supported by the control gear. A value of 0 means that this color representation is not supported.

nNumberOfRGBWAFChannels: The number of RGBWAF channels supported by the control gear. A value of 0 means that this color representation is not supported.

VAR_IN_OUT

stCommandBuffer : ST_DALIV2CommandBuffer;

stCommandBuffer: Reference to the internal structure for communication with the function block FB_KL6811Communication() (KL6811) or FB_KL6821Communication() (KL6821).

Requirements

Development environment

required PLC library

TwinCAT from v3.1.4020.14

Tc2_DALI from v3.4.3.0