FB_DALIV2QueryColourTypeFeatures

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

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.

Inputs

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

Name	Type	Description
bStart	BOOL	The function block is activated by a positive edge at this input.
nAddr	BYTE	The address of a device or of a group
eAddrType	E_DALIV2AddrType	Short address, group address or broadcast
eCommandPriority	E_DALIV2CommandPriority	Priority (high, medium or low) with which the command is processed by the library.

Inputs/outputs

VAR_IN_OUT
  stCommandBuffer : ST_DALIV2CommandBuffer;
END_VAR

Name	Type	Description
stCommandBuffer	ST_DALIV2CommandBuffer	Reference to the internal structure for communication with FB_KL6811Communication (KL6811) or FB_KL6821Communication (KL6821).

Outputs

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

Name	Type	Description
bBusy	BOOL	When the function block is activated the output is set, and it remains active until execution of the command has been completed.
bError	BOOL	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	UDINT	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	BOOL	The control gear supports xy-coordinate.
bSupportsColourTemperatureTc	BOOL	The control gear supports Color temperature Tc.
nNumberOfPrimaryColors	BYTE	The number of primary colors supported by the control gear. A value of 0 means that this color representation is not supported.
nNumberOfRGBWAFChannels	BYTE	The number of RGBWAF channels supported by the control gear. A value of 0 means that this color representation is not supported.

Requirements

Development Environment	PLC library to include
TwinCAT from v3.1.4020.14	Tc2_DALI from v3.4.3.0