Variables

actualLevel

The variable contains the current output value of the DALI control gear.

The value of the variable can be read out with the function block FB_DALI102QueryActualLevel.

powerOnLevel

When the supply voltage is applied to the DALI control gear, the lamp is controlled with the output value stored in the variable powerOnLevel. A prerequisite is that the DALI bus is supplied with power and that the quiescent level is maintained. If powerOnLevel is set to 255 (MASK), then after applying the supply voltage the output value is set to the last active output value (minLevel...maxLevel) before the supply voltage is switched off. If the output value is to be set to 0 after applying the supply voltage, powerOnLevel must also be 0. If powerOnLevel is greater than 0 and less than 255, the output value after applying the supply voltage is always limited by the variables minLevel and maxLevel.

The value of the variable can be queried with the function block FB_DALI102QueryPowerOnLevel and changed with the function block FB_DALI102SetPowerOnLevel.

systemFailureLevel

If an error occurs on the DALI bus (open-circuit voltage below the permissible level range for more than 500 ms), the DALI control gear is controlled with the output value from the systemFailureLevel variable. If the variable value is 255 (MASK), the output value does not change. The value range is limited by the variables minLevel and maxLevel.

The value of the variable can be queried with the function block FB_DALI102QuerySystemFailureLevel and changed with the function block FB_DALI102SetSystemFailureLevel.

minLevel / maxLevel

The output value is limited within the DALI control gear by the variables minLevel and maxLevel. Exceptions are the output values 0 (OFF) and 255 (MASK).

The value of the respective variable can be read out with the function blocks FB_DALI102QueryMinLevel / FB_DALI102QueryMaxLevel and changed with the function blocks FB_DALI102SetMinLevel / FB_DALI102SetMaxLevel.

fadeRate

The fadeRate determines the rate of change (in steps per second) of the output value. The variable has an effect on the DALI commands FB_DALI102Up and FB_DALI102Down.

The value of the variable can be read with the function block FB_DALI102QueryFadeTimeFadeRate and changed with the function block FB_DALI102SetFadeRate.

The following values can be specified via E_DALIFadeRate:

fadeTime

The fadeTime defines the time the current output value takes to reach the required value. If the lamp is switched on, the preheating and ignition times are not included in the fade time. The variable has an effect on the commands FB_DALI102DirectArcPowerControl, FB_DALI102GoToScene and FB_DALI102GoToLastActiveLevel.

The value of the variable can be read with the function block FB_DALI102QueryFadeTimeFadeRate and changed with the function block FB_DALI102SetFadeTime.

The following values can be specified via E_DALIFadeTime:

extendedFadeTimeBase

This variable is the basic value for the calculation of the Extended Fade Time (0 ms to 16 min). The Extended Fade Time is used if fadeTime was set to E_DALIFadeTime.Disabled and, if present, fastFadeTime is equal to E_DALIFastFadeTime.Disabled.

The value of the variable can be read with the function block FB_DALI102QueryExtendedFadeTime and changed with the function block FB_DALI102SetExtendedFadeTime.

The Extended Fade Time is calculated as follows:

Extended Fade Time = extendedFadeTimeBase x extendedFadeTimeMultiplier

The following basic values are available:

extendedFadeTimeMultiplier

This variable is the multiplier for the calculation of the Extended Fade Time (0 ms to 16 min). The Extended Fade Time is used if fadeTime was set to E_DALIFadeTime.Disabled and, if present, fastFadeTime is equal to E_DALIFastFadeTime.Disabled.

If extendedFadeTimeMultiplier assumes the value E_DALIExtendeFadeTimeMultiplier.Disabled, the desired illuminance is reached as soon as possible.

The value of the variable can be read with the function block FB_DALI102QueryExtendedFadeTime and changed with the function block FB_DALI102SetExtendedFadeTime.

The Extended Fade Time is calculated as follows:

Extended Fade Time = extendedFadeTimeBase x extendedFadeTimeMultiplier

The following multiplication values are available:

shortAddress

The short address is stored in this variable. A valid short address lies in the range between 0 and 63. With a value of 255 (MASK), the short address is considered deleted.

The short address is set with the function block FB_DALI102SetShortAddress.

searchAddress

The search address is only required for the assignment of short addresses.

The value of the variable can be changed with the function block FB_DALI102SetSearchAddress.

randomAddress

The random address, also known as the long address, is only required when short addresses are assigned.

With the help of the function block FB_DALI102QueryRandomAddress the 3 bytes long random address can be read.

controlGearFailure

The variable indicates whether the DALI control gear operates as intended.

In the event of an error, the bit is set to TRUE after 30 s at the latest.

The bit is reset once the device works properly again.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

lampFailure

The variable indicates whether the lamp is working correctly.

In the event of an error, the bit is set to TRUE after 30 s at the latest.

The fault may mean that the connection is faulty or that the lamp is defective.

The error state can only be detected when the lamp is switched on.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

lampOn

The variable indicates whether the lamp is switched on.

This bit is set to FALSE when the lamp is off, during the startup phase and in the event of a total lamp failure.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

limitError

The variable indicates whether the desired output value (targetLevel) lies within the limits of minLevel and maxLevel, or whether the targetLevel was changed by the values minLevel or maxLevel.

The bit is set to TRUE if one of the described cases occurs.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

fadeRunning

This variable indicates whether dimming is active.

The bit is TRUE when dimming starts (after the start phase of the light) until the expiry of fadeTime.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

resetState

The variable indicates whether all device and instance variables have been set to their reset value (see table above).

In this case, the bit is TRUE.

Variables that show no change in the Reset Value column are not taken into account.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

powerCycleSeen

The variable indicates whether the DALI control gear has been supplied with power without a command having been executed to change the output value.

In this case, the bit is TRUE.

The variable can be read out with the aid of the function block FB_DALI102QueryStatus.

gearGroups

The variable indicates whether a particular DALI control gear is assigned to groups 0 to 15. If the bit is set, the control gear belongs to the corresponding group.

The value of the variables can be read with the function block FB_DALI102QueryGroups and changed with the function blocks FB_DALI102AddToGroup and FB_DALI102RemoveFromGroup.

scene0…scene15

Each DALI control gear can store output values for 16 different scenes. There is one output value per scene. If the command for calling a scene FB_DALI102GoToScene is called for a device, a group or all devices (broadcast), the output value of the corresponding DALI control gear is set to the stored value. The output is limited by the values of maxLevel, minLevel and physicalMinLevel.

The value of the variable can be read from the function block FB_DALI102QuerySceneLevel and changed with the function blocks FB_DALI102SetScene and FB_DALI102RemoveFromScene.

DTR0…DTR2

Data Transfer Registers (DTR) 0 to 2 serve as buffer for the execution of various DALI commands.

The DTRs are used by different function blocks. The description of the respective function block indicates which DTRs are used.

The values of the DTRs can be read out with the function blocks FB_DALI102QueryContentDTRx and changed with the function blocks FB_DALI102SetDTRx.

physicalMinLevel

The physically smallest possible output value is stored by the vendor in the variable physicalMinLevel.

The value can be read out with the function block FB_DALI102QueryPhysicalMinimum.

deviceTypes

The variable contains the respective device types of a DALI control gear.

The device types (see E_DALIDeviceType) of a DALI control gear can be read using the function block FB_DALI102QueryDeviceTypes.