FB_DALIV2xChangeAddressList

This function block can be used to change the short addresses of several control units.

A list of the control units for which the short address is to be changed is transferred in the array arrChangeAddressList of type ST_DALIV2ChangeAddressList. The list has 64 entries from 0 to 63. Each entry contains a variable nOldAddress and nNewAddress with which the address assignment is parameterized. The list end is programmed with a 255 entry at nOldAddress, so that the whole list does not necessarily have to be filled in. If this entry is missing, however, then all entries are accepted. When the function block is started (rising edge on bStart), the list end is first determined based on the above-described entry and afterwards the valid list range is examined for the following false entries:

• Address entries > 63
• Double address entry on the original page nOldAddress (would not make sense)
• Double address entry on the target page nNewAddress (leads to double assignment of an address and, hence, to errors)

The function block then determines the internal long addresses of the DALI devices on the basis of the short addresses and enters them respectively to the parameters nRandomAddressHigh, nRandomAddressMiddle and nRandomAddressLow in the list. If an error occurs during this query, this leads to a false entry for the respective device in the list element nErrors (see ST_DALIV2ChangeAddressList). The further sequence in the function block now depends on the option DALIV2_OPTION_SAFE_ADDRESSING (nOptions input). If it is set, then safe new addressing takes place: first of all, all short addresses of the selected DALI devices are deleted. Afterwards, status queries are sent to all desired new addresses in the DALI line. 2 cases are now possible:

• If a device responds to this query, then this desired new address is already otherwise assigned. The previously “deleted” DALI devices are programmed with their old addresses and an error message is output.
• If no devices respond to this status query, then the previously “deleted” DALI devices are programmed with the desired new addresses.

The reprogramming is checked afterwards in both cases. If an error occurs during deletion, during the status query or during the reprogramming, this leads to a false entry for the respective device in the list element nErrors (see ST_DALIV2ChangeAddressList).

If the option DALIV2_OPTION_SAFE_ADDRESSING (nOptions input) is not set, then the deletion of the short addresses and the status query for the presence of desired new addresses are omitted and the new addresses are programmed directly. This is possible because programming takes place via the long address determined beforehand. Reprogramming is not verified in this case.

The individual bits in the list element nErrors have the following meaning:

bStart            : BOOL;
eCommandPriority  : E_DALIV2CommandPriority := eDALIV2CommandPriorityHigh;
nOptions          : DWORD := 0;
eDataFrameType    : E_DALIV2DataFrameType := eDALIV2DataFrameType24Bit;

bBusy         : BOOL;
bError        : BOOL;
nErrorId      : UDINT;

arrChangeAddressList  : ARRAY [0..63] OF ST_DALIV2ChangeAddressList;
stCommandBuffer       : ST_DALIV2CommandBuffer;