FB_DMXSetDeviceLabel

This function block writes a description text into the DMX device. The function block FB_DMXGetDeviceLabel() can be used to read the text.

Inputs

VAR_INPUT
  bStart                     : BOOL;
  wDestinationManufacturerId : WORD;
  dwDestinationDeviceId      : DWORD;
  byPortId                   : BYTE;
  sDeviceLabel               : STRING := '';
  dwOptions                  : DWORD := 0;
END_VAR

Name	Type	Description
bStart	BOOL	The function block is activated by a positive edge at this input.
wDestinationManufacturerId	WORD	Unique manufacturer Id of the DMX device (for details, see DMX device address).
dwDestinationDeviceId	DWORD	Unique device Id of the DMX device (for details, see DMX device address).
byPortId	BYTE	Channel within the addressed DMX device. Sub-devices are addressed through the Port Id. The root device always has the Port Id 0.
sDeviceLabel	STRING	New description text for the DMX device.
dwOptions	DWORD	Options (currently not used).

Inputs/outputs

VAR_IN_OUT
  stCommandBuffer : ST_DMXCommandBuffer;
END_VAR

Name	Type	Description
stCommandBuffer	ST_DMXCommandBuffer	Reference to the structure for communication (buffer) with the function block FB_EL6851Communication()

Outputs

VAR_OUTPUT
  bBusy         : BOOL;
  bError        : BOOL;
  udiErrorId    : 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 udiErrorId. Only valid if bBusy is FALSE.
udiErrorId	UDINT	Contains the command-specific error code of the most recently executed command. Only valid if bBusy is FALSE (see error codes).

Requirements

Development environment	required TC3 PLC library
TwinCAT from v3.1.4020.14	Tc2_DMX from 3.5.3.0