FB_DALIV2StoreColourTemperatureTcLimit
Saves the value in the variable COLOUR TEMPERATURE Tc COOLEST, COLOUR TEMPERATURE Tc WARMEST, COLOUR TEMPERATURE Tc PHYSICAL COOLEST or COLOUR TEMPERATURE Tc PHYSICAL WARMEST of the DALI control gear. The values can be read out using the function block FB_DALIV2QueryColourValue(). The nSelectLimitValue input defines the new limit value to be set:
Value | Limit value | Description |
|---|---|---|
0 | COLOUR TEMPERATURE Tc COOLEST | lowest possible value, but always equal to or warmer than the lowest possible physical value. |
1 | COLOUR TEMPERATURE Tc WARMEST | highest possible value, but always equal to or cooler than the highest possible physical value. |
2 | COLOUR TEMPERATURE Tc PHYSICAL COOLEST | lowest possible physical value. |
3 | COLOUR TEMPERATURE Tc PHYSICAL WARMEST | highest possible physical value. |
The functions KELVIN_TO_MIREK and MIREK_TO_KELVIN are available for converting from or to Kelvin.
The DTR (Data Transfer Register), DTR1 and DTR2 of all DALI control gears in the DALI line are changed by the function block.
The function block supports the following color representations:
- Color temperature Tc
 | 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;
nSelectLimitValue : BYTE;
nValue : UINT;
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.
nSelectLimitValue: Specifies the new limit value to be set (see table above).
nValue: The value that is written into the selected variable.
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrorId : UDINT;
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.
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 |