FB_DALIV2StoreXyCoordinatePrimaryN

FB_DALIV2StoreXyCoordinatePrimaryN 1:

Copies the value from the TEMPORARY x-COORDINATE and TEMPORARY y-COORDINATE variables to the x-COORDINATE PRIMARY N and y-COORDINATE PRIMARY N variables.

The nPrimaryColor 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.

This command can be used to store the current xy coordinates associated with the primary color. xy coordinates outside the color space chromaticity diagram are not meaningful and should therefore be avoided.

The function block changes the DTR2 (data transfer registers) for all DALI control gears of the DALI line.

The function block supports the following color representations:

  • Primary (color) N

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;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
nPrimaryColour   : BYTE;

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

nPrimaryColour: Primary color (0 - 5).

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