FB_DMXGetSoftwareVersionLabel
Dieser Funktionsbaustein fragt die Beschreibung der Softwareversion des DMX-Gerätes ab.
Durch eine positive Flanke an dem Eingang bStart wird der Baustein gestartet und der Ausgang bBusy geht auf TRUE. Die Eingänge wDestinationManufacturerId und dwDestinationDeviceId adressieren das DMX-Gerät. Der Eingang byPortId definiert den Kanal innerhalb des adressierten DMX-Gerätes. Ist die Ausführung des Befehls abgeschlossen, geht der Ausgang bBusy wieder auf FALSE. Die Ausgänge bError, udiErrorId und sSoftwareVersionLabel können jetzt ausgewertet werden. Solange der Baustein aktiv ist (bBusy ist TRUE) werden weitere positiven Flanke am Eingang bStart ignoriert.
VAR_INPUT
bStart : BOOL;
wDestinationManufacturerId : WORD;
dwDestinationDeviceId : DWORD;
byPortId : BYTE;
dwOptions : DWORD := 0;
bStart: Über eine positive Flanke an diesem Eingang wird der Befehl gestartet.
wDestinationManufacturerId: Eindeutige Hersteller-Id vom DMX-Gerät.
dwDestinationDeviceId: Eindeutige Geräte-Id vom DMX-Gerät.
byPortId: 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.
dwOptions: Optionen (wird derzeit nicht benutzt).
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
udiErrorId : UDINT;
sSoftwareVersionLabel : STRING;
bBusy: Bei der Aktivierung des Bausteins wird der Ausgang gesetzt und bleibt so lange aktiv, bis der Befehl abgearbeitet wurde.
bError: 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: Enthält den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls. Nur gültig, wenn bBusy auf FALSE ist. Siehe Fehlercodes.
sSoftwareVersionLabel: Ist die Abarbeitung des Befehls abgeschlossen (bBusy ist FALSE), so wird an diesem Ausgang eine Beschreibung (maximal 32 Zeichen) der Softwareversion des DMX-Gerätes ausgegeben. Der Inhalt wird vom DMX-Gerätehersteller festgelegt.
VAR_IN_OUT
stCommandBuffer : ST_DMXCommandBuffer;
stCommandBuffer: Verweis auf die Struktur zur Kommunikation (Puffer) mit dem FB_EL6851CommunicationEx()-Baustein.