FB_DMXSetDeviceLabel

Dieser Funktionsbaustein schreibt in das DMX-Gerät einen Beschreibungstext. Mit dem Baustein FB_DMXGetDeviceLabel() kann der Text ausgelesen werden.

Eingänge

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

Name	Typ	Beschreibung
bStart	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein gestartet.
wDestinationManufacturerId	WORD	Eindeutige Hersteller-Id vom DMX-Gerät (Details siehe DMX-Geräteadresse).
dwDestinationDeviceId	DWORD	Eindeutige Geräte-Id vom DMX-Gerät (Details siehe DMX-Geräteadresse).
byPortId	BYTE	Kanal innerhalb des adressierten DMX-Gerätes. Untergeräte (Sub-Devices) werden durch die Port-Id adressiert. Das Hauptgerät (Root-Device) hat immer die Port-Id 0.
sDeviceLabel	STRING	Neuer Beschreibungstext für das DMX-Gerät.
dwOptions	DWORD	Optionen (wird derzeit nicht benutzt).

Ein-/Ausgänge

VAR_IN_OUT
  stCommandBuffer : ST_DMXCommandBuffer;
END_VAR

Name	Typ	Beschreibung
stCommandBuffer	ST_DMXCommandBuffer	Verweis auf die Struktur zur Kommunikation (Puffer) mit dem Baustein FB_EL6851Communication()

Ausgänge

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

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Bausteins wird der Ausgang gesetzt und bleibt so lange aktiv, bis der Befehl abgearbeitet wurde.
bError	BOOL	Dieser Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung eines Befehls ein Fehler aufgetreten ist. Der befehlsspezifische Fehlercode ist in udiErrorId enthalten. Nur gültig, wenn bBusy auf FALSE ist.
udiErrorId	UDINT	Enthält den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls. Nur gültig, wenn bBusy auf FALSE ist (siehe Fehlercodes).

Voraussetzungen

Entwicklungsumgebung	erforderliche TC3 SPS-Bibliothek
TwinCAT ab v3.1.4020.14	Tc2_DMX ab v3.5.3.0