FB_DALI209SetPowerOnValues

FB_DALI209SetPowerOnValues 1:

The function block saves the values nPowerOnLevel and eColourType in the variables powerOnLevel and powerOnColourType of the DALI control gear. In addition, depending on the value of eColourType, the values of the inputs are written to the corresponding variables.

FB_DALI209SetPowerOnValues 2:

Prior to the DALI command SET POWER ON LEVEL, the function block sends the DALI command ENABLE DEVICE TYPE 8, as is necessary for application extended commands (see also FB_DALI102EnableDeviceType).

FB_DALI209SetPowerOnValues 3:

The function block changes the DTR0 and the DTR1 of all connected DALI control gears.

FB_DALI209SetPowerOnValues 4: Inputs

VAR_INPUT
  bStart                         : BOOL;
  nAddress                       : BYTE;
  eAddressType                   : E_DALIAddressType := E_DALIAddressType.Short;
  eCommandPriority               : E_DALICommandPriority := E_DALICommandPriority.MiddleLow;
  nPowerOnLevel                  : USINT := 254;
  eColourType                    : E_DALIColourType := E_DALIColourType.MASK;
  nXCoordinate                   : UINT;
  nYCoordinate                   : UINT;
  nColourTemperatureTc           : UINT := 65534;
  nPrimaryColour0                : UINT;
  nPrimaryColour1                : UINT;
  nPrimaryColour2                : UINT;
  nPrimaryColour3                : UINT;
  nPrimaryColour4                : UINT;
  nPrimaryColour5                : UINT;
  nRedDimLevel                   : USINT;
  nGreenDimLevel                 : USINT;
  nBlueDimLevel                  : USINT;
  nWhiteDimLevel                 : USINT;
  nAmberDimLevel                 : USINT;
  nFreeColourDimLevel            : USINT;
END_VAR

Name

Type

Description

bStart

BOOL

Execution of the DALI commands is triggered via a positive edge at this input.

nAddress

BYTE

Address of a DALI control gear or a DALI group.

eAddressType

E_DALIAddressType

Defines whether the input nAddress contains a short address (0…63) or a group address (0…15). The input nAddress has no meaning if a broadcast or a broadcast to unaddressed devices (BroadcastUnaddr) has been selected.

eCommandPriority

E_DALICommandPriority

Priority (low, middle low, middle, middle high, high) with which the DALI commands are sent.

FB_DALI209SetPowerOnValues 5:

eCommandPriority has no function with the KL6811. The DALI command priorities are supported by the KL6821 from the firmware version BD.

Name

Type

Description

nPowerOnLevel

USINT

Switch-on value (0…255)

eColourType

E_DALIColourType

Defines the color setting with which the function block is operated (see colourType). MASK prevents the color representation from being changed.

nXCoordinate

UINT

Input of the x-value of the color representation according to xy color type (see X-coordinate) in the color setting Xy coordinates (see color representation).

nYCoordinate

UINT

Input of the y-value of the color representation according to xy color type (see Y-coordinate) in the color setting Xy coordinates (see color representation).

nColourTemperatureTc

UINT

Input of the desired color temperature (see colourTemperatureTc) in the setting Color temperature Tc (see color representation).

nPrimaryColourN

UINT

Input of the color representation on the corresponding output channel on the operating device in the color setting Primary color N (see color representation).

nRedDimLevel

USINT

Setting of the red dimming level (see DimLevel) in the color setting RGBWAF (see color representation).

nGreenDimLevel

USINT

Setting of the green dimming level (see DimLevel) in the color setting RGBWAF (see color representation).

nBlueDimLevel

USINT

Setting of the blue dimming level (see DimLevel) in the color setting RGBWAF (see color representation).

nWhiteDimLevel

USINT

Setting of the white dimming level (see DimLevel) in the color setting RGBWAF (see color representation).

nAmberDimLevel

USINT

Setting of the amber dimming level (see DimLevel) in the color setting RGBWAF (see color representation).

nFreeColourDimLevel

USINT

Setting of the dimming level of the freely selectable color (see DimLevel) in the color setting RGBWAF (see color representation).

FB_DALI209SetPowerOnValues 6: Outputs

VAR_OUTPUT
  bError                  : BOOL;
  ipResultMessage         : I_TcMessage;
  bBusy                   : BOOL;
END_VAR

Name

Type

Description

bError

BOOL

This output is switched to TRUE if an error occurs during the execution. Further information about the error can be queried via the variable ipResultMessage. The output is set to FALSE again as soon as bBusy switches to TRUE.

ipResultMessage

I_TcMessage

Interface pointer (see error evaluation) that can be used to obtain detailed information about the processing of the function block (see runtime messages). The interface pointer is valid after bBusy has changed from TRUE to FALSE.

bBusy

BOOL

The output is set as soon as execution of the DALI commands has commenced. It remains active until all DALI commands have been processed.

FB_DALI209SetPowerOnValues 7: Properties

Name

Type

Access

Initial value

Description

ipDALICommunication

I_DALICommunication

Get,Set

0

Interface Pointer to the communication block (see Transfer of the reference to the communication block).

Requirements

Development environment

Required PLC library

TwinCAT from v3.1.4024.11

Tc3_DALI from v3.5.0.0