FB_DALIV2QueryColourStatus
The variable COLOUR STATUS is read from the DALI control gear.
Bit | Description |
|---|---|
0 | xy-coordinate color point lies outside the valid range. |
1 | Color temperature Tc lies outside the valid range. |
2 | Automatic calibration is active. |
3 | Automatic calibration was successful. |
4 | Color representation xy-coordinate active. |
5 | Color representation colour temperature Tc active. |
6 | Color representation primary N active. |
7 | Color representation RGBWAF active. |
The function block supports the following 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(). From version 2.6.0 of the libraries TcDALIV2 and TcDALIV2AppExtCmds, however, the Enable Device Type 8 command is internally placed automatically before all application extended commands for lamps for color/color temperature control with DALI interface. |
VAR_INPUT
bStart : BOOL;
nAddr : BYTE;
eAddrType : E_DALIV2AddrType := eDALIV2AddrTypeShort;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
bStart: The block is activated by a rising edge at this input.
nAddr: The address of a participating device or of a group.
eAddrType: Short address, group address or broadcast.
eCommandPriority: The priority (high, middle, low) this command has when executed by the library.
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrorId : UDINT;
nColourStatus : BYTE;
bBusy: When the 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 if 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 an instruction at the inputs.
nErrorId: Contains the command-specific error code of the most recently executed command. Is reset to 0 by the execution of an instruction at the inputs. See Error codes.
nColourStatus: Colour status (see table above).
VAR_IN_OUT
stCommandBuffer : ST_DALIV2CommandBuffer;
stCommandBuffer: A reference to the structure for communication with the FB_DALIV2Communication() (KL6811) or FB_KL6821Communication() (KL6821) block.
Requirements
Development environment | Target system | Required libraries |
|---|---|---|
TwinCAT 2.11 R3/x64 from Build 2244 | PC/CX, BX or BC | TcDALIV2 library from V2.10.0 |