FB_DALIV2StoreColourTemperatureTcLimit
Saves the value in the COLOR TEMPERATURE Tc COOLEST, COLOR TEMPERATURE Tc WARMEST, COLOR TEMPERATURE Tc PHYSICAL COOLEST or COLOR TEMPERATURE Tc PHYSICAL WARMEST variable of the DALI control gear. The values can be read with function block FB_DALIV2QueryColourValue(). The nSelectLimitValue input defines the new limit value to be set:
Value | Limit value | Description |
|---|---|---|
0 | COLOR TEMPERATURE Tc COOLEST | lowest possible value, but always equal to or warmer than the lowest possible physical value. |
1 | COLOR TEMPERATURE Tc WARMEST | highest possible value, but always equal to or cooler than the highest possible physical value. |
2 | COLOR TEMPERATURE Tc PHYSICAL COOLEST | lowest possible physical value. |
3 | COLOR 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 function block changes the DTR (data transfer registers), DTR1 and DTR2 for all DALI control gears of the DALI line.
The function block supports the following color representations:
- Color temperature Tc
 | 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;nSelectLimitValue : BYTE;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
nValue : UINT;
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).
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 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)
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 |