FB_DMXGetDeviceInfo

FB_DMXGetDeviceInfo 1:

This function block queries all relevant information from a DMX device.

Applying a positive edge to the bStart input starts the 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 bError, udiErrorId and stDMXDeviceInfo outputs can now be processed. Further positive edges at the bStart input will be ignored if the block is active (bBusy is TRUE).

VAR_INPUT

bStart                      : BOOL;
wDestinationManufacturerId  : WORD;
dwDestinationDeviceId       : DWORD;
byPortId                    : BYTE;
dwOptions                   : DWORD := 0;

bStart: The command is started by a positive edge at this input.

wDestinationManufacturerId: Unique manufacturer ID of the DMX device.

dwDestinationDeviceId: Unique device ID of the DMX device.

byPortId: Channel within the addressed DMX device. Sub-devices are addressed through the Port ID. The root device always has the Port ID 0.

dwOptions: Options (currently not used).

VAR_OUTPUT

bBusy            : BOOL;
bError           : BOOL;
udiErrorId       : UDINT;
stDMXDeviceInfo  : ST_DMXDeviceInfo;

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 udiErrorId. Only valid if bBusy is FALSE.

udiErrorId: Contains the command-specific error code of the most recently executed command. Only valid if bBusy is FALSE. See Error codes.

stDMXDeviceInfo: If the execution of the command has been completed (bBusy is FALSE), then all relevant information for the DMX device is sent to this output in a structure. See also the description of the ST_DMXDeviceInfo structure.

uliUID: Unique 48-bit address of the DMX device. The lower 32 bits define the device ID and the upper 16 bits the manufacturer ID.

tRDMProtocolVersion: Version number of the supported RDM standard.

uiDeviceModelId: The device model ID is defined by the device manufacturer.

stProductCategory: Device type of the DMX device. The device types are defined in the RDM standard.

udiSoftwareVersionId: Version number of the software (firmware) in the DMX device.

uiDMX512Footprint: Number of DMX512 slots occupied by the device. Each sub-device and the root device occupy their own DMX512 slots.

stDMX512Personality: DMX devices can possess various personalities. Personalities are comparable with profiles. The current profile and the number of profiles are displayed in this element.

uiDMX512StartAddress: The DMX512 start address. This lies within the range from 1 – 512. If the uiDMX512Footprint parameter is 0, then the DMX start address is 0xFFFF (65535). Each sub-device and the root device occupy different DMX512 start addresses.

uiSubDeviceCount: Number of sub-devices.

bySensorCount: The number of sensors contained in the sub-device or the root device.

VAR_IN_OUT

stCommandBuffer          : ST_DMXCommandBuffer;

stCommandBuffer: A reference to the structure for communication (the buffer) with the FB_EL6851CommunicationEx() block.

See also