FB_DALIV2StoreTYPrimaryN
Saves the value in the TY PRIMARY N variable 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 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.
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:
- 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;nPrimaryColour : 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).
nPrimaryColour: Primary color (0 - 5).
nValue : The value that is written into the TY PRIMARY N 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 |