• Home
• Funktionen/Funktionsbausteine - Referenz
• Funktionsbausteine für PLCnext Technology-Steuerungen
• Geräteinformation
• DEVICE_INFO

DEVICE_INFO

Typ	Funktionsbaustein
Beschreibung	Mit dem Funktionsbaustein kann aus dem Applikationsprogramm der DeviceInfoService der PLCnext Technology-Steuerung ausgeführt werden. Der DeviceInfoService ermöglicht den Zugriff auf die Geräteinformationen. Der Funktionsbaustein wird bei einer steigenden Flanke am Eingang REQ ausgeführt. Der Name (Parameter) des auszuführenden DeviceInfoService wird am Eingang IDENTIFIER angegeben (die Beschreibung der möglichen Parameter finden Sie am Ende der Hilfeseite). Nach erfolgreicher Ausführung des Funktionsbausteins wird der Ausgang DONE auf TRUE gesetzt. Das Ergebnis/der Rückgabewert des ausgeführten DeviceInfoService wird am Ein-/Ausgang RESULT angezeigt. (Der Datentyp des Ergebnisses muss zum Parameter des auszuführenden DeviceInfoService passen.) Tritt während der Ausführung ein Fehler auf, wird DONE auf FALSE und ERROR auf TRUE gesetzt. Solange ERROR = TRUE ist, wird am Ausgang STATUS der Fehlercode ausgegeben. Mit einer fallenden Flanke am Eingang REQ werden alle Ausgänge zurückgesetzt.
Hinweise	Funktionsbausteine müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein.
Parameter	Eingang REQ Datentyp: BOOL Beschreibung: Mit einer steigenden Flanke am Eingang REQ (REQ steht für REQUEST) wird der Funktionsbaustein ausgeführt. Ist die Ausführung beendet, wird der Ausgang DONE auf TRUE gesetzt. Tritt während der Ausführung ein Fehler auf, wird ERROR auf TRUE und DONE auf FALSE gesetzt. Mit einer fallenden Flanke an diesem Eingang werden alle Ausgänge zurückgesetzt. IDENTIFIER Datentyp: STRING Beschreibung: Name (Parameter) des auszuführenden DeviceInfoService (die Beschreibung der möglichen Parameter finden Sie am Ende der Hilfeseite). Ein-/Ausgang RESULT Datentyp: ANY Beschreibung: Ergebnis/Rückgabewert des ausgeführten DeviceInfoService. Der Datentyp des Ergebnisses muss zum Datentyp des Parameters passen, der am Eingang IDENTIFIER angelegt wird (die Beschreibung der möglichen Parameter finden Sie am Ende der Hilfeseite). Ausgänge DONE Datentyp: BOOL Beschreibung: Der Ausgang wird auf TRUE gesetzt, sobald der Funktionsbaustein vollständig und erfolgreich ausgeführt wurde. Solange DONE = TRUE ist, besitzen die Ausgänge gültige Werte. BUSY Datentyp: BOOL Beschreibung: Wird auf TRUE gesetzt solange der FB abgearbeitet und der Service ausgeführt wird. ERROR Datentyp: BOOL Beschreibung: Falls der Aufruf des FBs fehlschlägt, wird der Ausgang auf TRUE gesetzt. Solange ERROR = TRUE ist, liefert der Fehlerode am Ausgang STATUS Informationen zur Fehlerursache. STATUS Datentyp: DWORD Beschreibung: Liefert den Fehlercode im Fehlerfall (ERROR = TRUE) oder den aktuellen Status des Funktionsbausteins (ERROR = FALSE). Mögliche Werte: 0 Kein Fehler. 1 Service nicht verfügbar (nicht vorhanden; Rückgabe Object = Null). 2 Falscher Datentyp am Ausgang RESULT. Der Datentyp passt nicht zum Rückgabewert des Service, bzw. im Falle eines Strings, ist nicht vom Typ STRING (Standard IEC-String mit max. 80 Zeichen). 3 Service-Ergebnis vom Typ String überschreitet die zulässige Länge von 80 Zeichen (STRING). 4 Exception beim Ausführen des Service.
DeviceInfoService-Parameter	DeviceInfoService-Parameter Die folgenden Parameter stehen für die Abfrage von Geräteinformationen zur Verfügung. Der Datentyp des Ein-/Ausgangs RESULT muss wie oben beschrieben zum Datentyp des Parameters passen, der am Eingang IDENTIFIER angelegt ist. Weitere Infos Die neuesten DeviceInfoService-Parameter finden Sie im Kapitel "RSC Device Interface Services" im PLCnext Info Center. Parameter Datentyp Beschreibung General.DeviceClass UINT32 Gibt die Geräteklasse an. Momentan wird nur "ProgrammableLogicController" unterstützt. 0: Nicht definiert 1: ProgrammableLogicController 2: BusCoupler 3: Switch General.VendorName STRING VendorName zeigt den Herstellernamen an. General.ArticleName STRING ArticleName zeigt den Gerätenamen an. General.ArticleNumber STRING ArticleNumber zeigt die Bestellnummer des Geräts an. General.SerialNumber STRING SerialNumber zeigt die Seriennummer des Geräts an. General.CloudUuid STRING CloudUuid zeigt die Proficloud UUID des Geräts an. General.Firmware.Version STRING FirmwareVersion zeigt die Firmware-Version des Geräts an. Es wird die 5-Stufen Notation (Major, Minor, Patch, Build, Status) verwendet. General.Firmware.VersionMajor BYTE Jahr der Firmware-Version ohne die ersten zwei Ziffern. Z.B. für "2019" wird 19 angezeigt. General.Firmware.VersionMinor BYTE FirmwareVersionMinor General.Firmware.VersionPatch BYTE FirmwareVersionPatch General.Firmware.VersionBuild UINT32 FirmwareVersionBuild General.Firmware.VersionStatus STRING FirmwareVersionStatus General.Firmware.BuildDate STRING FirmwareBuildDate ISO 8601-Format <YYYY>-<MM>-<DD> General.Firmware.BuildTime STRING FirmwareBuildTime ISO 8601-Format <hh>:<mm>:<ss> General.Hardware.Version STRING HardwareVersion zeigt die Hardware-Version des Geräts an. General.Fpga.Version STRING FPGAVersion zeigt die FPGA-Version des Geräts an. Es wird die 3-Stufen Notation (Major, Minor, Patch) verwendet. General.Fpga.VersionMajor BYTE FPGAVersionMajor General.Fpga.VersionMinor BYTE FPGAVersionMinor General.Fpga.VersionPatch BYTE FPGAVersionPatch General.UniqueHardwareId STRING Sha256-Hash (32byte) hexadezimal-kodiert als String General.SPNS.Fpga.Version STRING FPGA-Version des SPNS (nur für Geräte mit integrierter Sicherheitssteuerung) General.SPNS.Fpga.VersionMajor BYTE SPNS FPGA-Version, Major General.SPNS.Fpga.VersionMinor BYTE SPNS FPGA-Version, Minor General.SPNS.Fpga.BuildVersion Unsigned32 NS FPGA-Build-Version General.SPNS.Firmware.Version STRING SPNS-Firmware-Version General.SPNS.Firmware.VersionMajor BYTE SPNS Firmware-Version, Major General.SPNS.Firmware.VersionMinor BYTE SPNS Firmware-Version, Minor General.SPNS.Firmware.BuildVersion Unsigned32 SPNS Firmware-Build-Version Interfaces.Ethernet.Count BYTE NoOfNetworkInterfaces zeigt die Anzahl der Netzwerkschnittstellen an. Interfaces.Ethernet.{adapterIndex}.{port}.Mac STRING Der Mac-Parameter zeigt die MAC-Adresse der ausgewählten Schnittstelle an. adapterIndex: 1, 2,... Port = 0 für die MAC-Schnittstelle Port = 1, 2 für den MAC-Port Das MAC-Datenformat ist immer AA:BB:CC:DD:EE:FF.