FB_DALIV2StoreTYPrimaryN

Saves the value in the variable TY PRIMARY N of the DALI control gear.

The value is expressed in units of 0.5 lm, which results in a possible range of TYmin = 0 lm to TYmax = 32767 lm. A value of 65535 (MASK) means "unknown". The nPrimaryColour parameter specifies the primary color and must be within the range of 0 to 5, depending on the available number of primary colors. The command is ignored for every other value.

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:

Primary (color) N

	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;
  nPrimaryColour   : 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.
nValue	UINT	The value that is written to the variable TY PRIMARY N.

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