FB_DALIV2SetTemporaryPrimaryNDimlevel
Saves the value in the TEMPORARY PRIMARY N DIMLEVEL variable of the control gear. The value can be read with the function block FB_DALIV2QueryColourValue().
The value is expressed in units of 1 / 65536. The maximum value of the PRIMARY N DIMLEVEL is 0.99997 and is interpreted on a linear scale.
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;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
nPrimaryColour : BYTE;
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 TEMPORARY PRIMARY N DIMLEVEL 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 |