FB_DALIV2xAddToDeviceGroups

The function block FB_DALIV2xAddToDeviceGroups assigns one or more groups to the control device.

A total of 32 groups are available to which a control device can be assigned. Each bit of the variable nDeviceGroups corresponds to one of these groups. If the bit is set, the control device is assigned to the respective group. Bit 0 corresponds to group 0, bit 31 to group 31.

The function block FB_DALIV2xRemoveFromDeviceGroups can be used to remove a control device from a group.

Inputs

VAR_INPUT
  bStart            : BOOL;
  nAddr             : BYTE;
  eAddrType         : E_DALIV2AddrType := eDALIV2AddrTypeShort;
  eCommandPriority  : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
  nDeviceGroups     : DWORD;
END_VAR

Name	Type	Description
bStart	BOOL	The function block is activated by a positive edge at this input.
nAddr	BYTE	The address of a device or of a group
eAddrType	E_DALIV2AddrType	Short address, group address or broadcast
eCommandPriority	E_DALIV2CommandPriority	Priority (high, medium or low) with which the command is processed by the library.
nDeviceGroups	DWORD	32-bit variable where each bit represents the corresponding group to which the control device is to be assigned.

Inputs/outputs

VAR_IN_OUT
  stCommandBuffer   : ST_DALIV2CommandBuffer;
END_VAR

Name	Type	Description
stCommandBuffer	ST_DALIV2CommandBuffer	Reference to the internal structure for communication with FB_KL6821Communication (KL6821).

Outputs

VAR_OUTPUT
  bBusy    : BOOL;
  bError   : BOOL;
  nErrorId : UDINT;
END_VAR

Name	Type	Description
bBusy	BOOL	When the function block is activated the output is set, and it remains active until execution of the command has been completed.
bError	BOOL	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	UDINT	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).

Requirements

Development Environment	PLC library to include
TwinCAT from v3.1.4022.4	Tc2_DALI from v3.6.2.0