FB_DMXDiscUnMute

FB_DMXDiscUnMute 1:

This function block resets the mute flag of a DMX device. The mute flag specifies whether a DMX device reacts to the FB_DMXDiscUniqueBranch() command (mute flag is not set) or not (mute flag is set).

Applying a positive edge to the bStart input starts the function block, and the bBusy output goes TRUE. The wDestinationManufacturerId and dwDestinationDeviceId inputs address the DMX device. The byPortId input defines the channel within the addressed DMX device. If the execution of the command has been completed, the bBusy output goes back to FALSE. The outputs bError, udiErrorId and wControlField can now be evaluated. Further positive edges at the bStart input will be ignored as long as the function block is active (bBusy is TRUE).

FB_DMXDiscUnMute 2: Inputs

VAR_INPUT
  bStart                     : BOOL;
  wDestinationManufacturerId : WORD;
  dwDestinationDeviceId      : DWORD;
  byPortId                   : BYTE;
  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.

dwOptions

DWORD

Options (currently not used).

FB_DMXDiscUnMute 3: 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()

FB_DMXDiscUnMute 4: Outputs

VAR_OUTPUT
  bBusy         : BOOL;
  bError        : BOOL;
  udiErrorId    : UDINT;
  wControlField : WORD;
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).

wControlField

WORD

If the execution of the command has been completed (bBusy is FALSE), then further information about the DMX device will be available at this output. The meaning of the individual bits is defined as follows (see table):

Bit

Description

0 - Managed Proxy Flag

This bit is set if the DMX device is a proxy device.

1 - Sub-Device Flag

This bit is set if the DMX device supports sub-devices.

2 - Boot-Loader Flag

This bit is set if the DMX device cannot receive any commands (e.g. whilst the firmware is being loaded).

3 - Proxied Device Flag

This bit is set if the response was transmitted by a proxy device.

4 - 15

Reserve (always 0).

Requirements

Development environment

required TC3 PLC library

TwinCAT from v3.1.4020.14

Tc2_DMX from 3.5.3.0