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 with 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 function block changes the DTR (Data Transfer Register), DTR1 and DTR2 for all DALI control gears of the DALI line.

The function block supports the 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. 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;
  nSelectLimitValue : BYTE;
  nValue            : UINT;
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.
nSelectLimitValue	BYTE	Specifies the new limit value to be set (see table above).
nValue	UINT	The value that is written to the selected variable.

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;
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).

Requirements

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