FB_DALIV2SetSettingsType01

FB_DALIV2SetSettingsType01 1:

This function-block initialises the variables (EMERGENCY LEVEL, FUNCTION TEST DELAY TIME, DURATION TEST DELAY TIME…) of all emergency lighting ballasts in a DALI line with the values that are stored in a structure of type ST_DALIV2DeviceSettingsType01.

Applying a positive edge to the bStart input starts the block, and the bBusy output goes TRUE. The system first checks whether the bPresent bit is set in the respective structure (see ST_DALIV2DeviceSettingsType01). If this is the case, all ballast variables that are not write-protected are initialised with the respective values of the structure. The structure index here reflects the address of the ballast. In other words, data for the device with short address 0 is located at arrDALIDeviceSettingsType01[0], and so on through to the ballast with short address 63 having its data at arrDALIDeviceSettingsType01[63]. If a write error occurs for a device, the nErrors element is set for the respective structure without the function block itself switching to error mode. The following table shows which bit is set in the nErrors variable when an error occurs during the writing of a variable to a ballast.

Bit	Error
5	Error whilst writing the variable EMERGENCY LEVEL
9	Error whilst writing the variable FUNCTION TEST DELAY TIME
10	Error whilst writing the variable DURATION TEST DELAY TIME
11	Error whilst writing the variable FUNCTION TEST INTERVAL
12	Error whilst writing the variable DURATION TEST INTERVAL
13	Error whilst writing the variable TEST EXECUTION TIMEOUT
14	Error whilst writing the variable PROLONG TIME

When the function block has been processed, the bBusy output changes from TRUE to FALSE. Processing this function block can take several seconds, depending on how many ballasts are attached.

VAR_INPUT

bStart              : BOOL;
bCancel             : BOOL;
eCommandPriority    : E_DALIV2CommandPriority := eDALIV2CommandPriorityHigh;
nOptions            : DWORD;

bStart: The block is activated by a rising edge at this input.

bCancel: A rising edge at this input will deactivate the block and hence abort the reading of the variable.

eCommandPriority: Priority (high, medium or low) with which the command is processed by the library.

nOptions: Options for reading the variables (see table). The individual constants must be linked with OR operators.

Constant	Description
DALIV2_OPTION_EMERGENCY_LEVEL	The variable EMERGENCY LEVEL
DALIV2_OPTION_NEXT_FUNCTION_TEST	The variable FUNCTION TEST DELAY TIME
DALIV2_OPTION_NEXT_DURATION_TEST	The variable DURATION TEST DELAY TIME
DALIV2_OPTION_FUNCTION_TEST_INTERVAL	The variable FUNCTION TEST INTERVAL
DALIV2_OPTION_DURATION_TEST_INTERVAL	The variable DURATION TEST INTERVAL
DALIV2_OPTION_TEST_EXECUTION_TIMEOUT	The variable TEST EXECUTION TIMEOUT
DALIV2_OPTION_PROLONG_TIME	The variable PROLONG TIME
DALIV2_OPTION_ALL	All variables are initialised.
DALIV2_OPTION_PUSH_DALI_COMMANDS	The buffer, which contains the feedback telegrams from the ballasts, among other things, is not read. Hence, writing becomes faster, but errors are not recognised.

VAR_OUTPUT

bBusy               : BOOL;
bError              : BOOL;
nErrorId            : UDINT;
nCurrentShortAddr   : BYTE;

bBusy: When the 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 an instruction at the inputs.

nErrorId: Contains the command-specific error code of the most recently executed command. Is reset to 0 by the execution of an instruction at the inputs. See Error codes.

nCurrentShortAddr: Short address of the ballast for which variables are being initialised.

VAR_IN_OUT

stCommandBuffer             : ST_DALIV2CommandBuffer;
arrDALIDeviceSettingsType01 : ARRAY[0..63] OF ST_DALIV2DeviceSettingsType01;

stCommandBuffer: A reference to the structure for communication with the FB_DALIV2Communication() (KL6811) or FB_KL6821Communication() (KL6821) block.

arrDALIDeviceSettingsType01: Reference to an array of 64 elements of type ST_DALIV2DeviceSettingsType01. The settings of each individual DALI ballast are stored in these variables.