CP9031 1.4 Verwendete Warnhinweise ACHTUNG Warnung vor Sachschäden VORSICHT Warnung vor Personenschäden w Leichte reversible Verletzungen sind möglich. WARNUNG Warnung vor schweren Personenschäden w Tod oder schwere irreversible Verletzungen sind möglich. 1.5 Änderungshistorie 1.5.1 Änderungen 08 / 2022 – 11428978 / 00 •...
• Die beschriebenen Funktionsbausteine der Funktionsbibliothek und die daraus erstellten IEC- Applikationen dürfen nicht ungeprüft industriell eingesetzt werden. ifm übernimmt für die Funktionalität insbesondere an Maschinen und Anlagen keinerlei Garantie. Es handelt sich nicht um ein (Software-)Produkt, das von europäischen Richtlinien erfasst wird.
CP9031 3 Bestimmungsgemäße Verwendung Mithilfe der Funktionen der Bibliothek "ifmSDKutil_ecomatDisplay" kann der Anwender aus der CODESYS-Applikation eines ecomatDisplays (= Client) heraus zu Wartungszwecken auf Steuerungen folgender ifm-Gerätefamilien (= Zielgeräte) zugreifen: • ClassicController • ExtendedController • SmartController • SafetyController • BasicController • ecomatController Die Bibliothek bietet folgende Funktionen: •...
CP9031 4 Funktion 4.1 Basic- und R360-System Die Bibliothek bietet Funktionen für folgenden Anwendungsfälle für eine oder mehrere Steuerungen des Basic- und R360-Systems: • Systeminformationen abrufen. • Betriebsmodus steuern. • Lesen und Schreiben von Anwendung, Firmware, Benutzerdaten usw. • Aktualisieren einer Steuerung mit neuer Firmware und/oder Applikation usw. mit folgenden Dateitypen: –...
Die verwendete CAN-Baudrate ist die Baudrate, die innerhalb der Anwendung mit Bausteinen der ifmRawCAN-Bibliothek konfiguriert worden ist oder die im Gerätebaum konfigurierte Baudrate, wenn der CANopen-Manager unter dem Gerätekommunikationsknoten verwendet wird. u Für die unterstützten Baudraten durch die APIs in den zugrunde liegenden SDK-DLLs die Dokumentation von ifm-Artikel-Nr. CP9030 beachten.
CP9031 • Es kann nur mit einer Steuerung gleichzeitig kommuniziert werden. Die Kommunikationsbefehle zu mehreren Steuerungen werden nacheinander in der programmierten Reihenfolge in der CODESYS-Applikation aufgerufen. Somit ist z.B. sichergestellt, dass Updates mehrerer Steuerungen automatisch nacheinander durchgeführt werden. 4.5.2 Kommunikation ecomatController •...
Webseite die Software-Komponenten zum Herunterladen bereit: www.ifm.com 5.1.3 Lizensierung Mit dem Kauf des CP9031 erwirbt der Anwender gleichzeitig eine gültige Lizenz für die Nutzung des "ecomatDisplay SDK Utilities Library". u Lizenzinformationen: Ò Installationsroutine oder Produktseite des Artikels auf der ifm- Webseite.
MaintenanceTool-AddIn "Package Creator" 5.2.2 CODESYS-Package 5.2.2.1 CODESYS-Package installieren Um das ifm-Package "CODESYS für ifm SDK Erweiterung" zu installieren: ü CODESYS 3.5 SP16 Patch 4 ist korrekt installiert. ü Das ifm-Package "ifm_SDKutilities_ecomatDisplay_Vx.x.x.x.package" ist auf dem PC gespeichert. u CODESYS mit Administratorrechten starten.
CP9031 w Fenster [Package Manager] zeigt die installierten Packages. u Package wählen, das deinstalliert werden soll. u Auf [Entfernen...] klicken. w Das gewählte Package wird deinstalliert. u Auf [Schließen] klicken, um den Package Manager zu beenden. 5.2.3 rpm-Package für das ecomatDisplay 5.2.3.1 Speicherbelegung...
CP9031 w Die Installation ist abgeschlossen. Upgrade des rpm-Packages u Mit einem SSH-Client (z.B. putty ) auf dem ecomatDisplay anmelden: Benutzer: root Standard-Passwort: pdm3 u Kommandozeilen-Befehl in putty ausführen, um das Verzeichnis zu wechseln: cd /home/root/ u Kommandozeilen-Befehl in putty ausführen, um das Upgrade zu starten: dnf upgrade maintenance-sdk-x.x.xx.x-rx.aarch64.rpm...
CP9031 5.3 Funktionsbibliothek zu Projekt hinzufügen Um auf die Funktionen des Packages "CODESYS für ifm SDK Erweiterung" in einem CODESYS- Projekt zugreifen zu können, muss der Anwender die entsprechende Funktionsbibliothek in die Applikation einbinden. ü Package "CODESYS für ifm SDK Erweiterung" ist korrekt installiert.
CP9031 6 Programmierung 6.1 Bibliotheksfunktionen nutzen Folgende Funktionselemente stehen zur Verfügung: Funktionsbaustein Beschreibung Referenz PingDevice Verbindung zwischen Dialoggerät und PingDevice (Ò / 21) einer Steuerung testen GetSysInfo Systeminformationen eines Geräts lesen GetSysInfo (Ò / 23) Command Betriebsmodus des Geräts steuern Command (Ò / 25) ReadFromController Firmware, Anwendung und Daten eines ReadFromController (Ò / 27)
Seite 18
CP9031 Funktionsbaustein Beschreibung Referenz WriteDataFiles_ecomatController Schreibt aus einer zip-Datei eine oder WriteDataFiles_ecomatController mehrere Benutzerdateien in den Ord- (Ò / 72) ner /data des ecomatController ReadDeviceLogs_ecomatController Liest Logging-Daten aus dem eco- ReadDeviceLogs_ecomatController matController aus. (Ò / 75) ReadSegmentFrom_ecomatController Liest ein oder mehrere Softwareseg- ReadSegmentFrom_ecomatController mente und Benutzerdateien aus dem (Ò / 77)
CP9031 7 ifm-Funktionsbibliotheken Dieses Kapitel enthält die detaillierte Beschreibung der Funktionsbibliotheken, die die ifm electronic für die Programmierung des Geräts unter CODESYS 3.5 bereitstellt. 7.1 Bibliothek ifmSDKutil_ecomatDisplay Diese Bibliothek beinhaltet alle Funktionen zur Wartung einer ifm-Steuerung mit Hilfe einer Applikation auf einem ecomatDisplay.
Es ist kein Fehler aufgetreten. eDiagInfo Diagnose-/Fehler-Information Meldungen / Diagnose-Codes der Funktionsbausteine (Ò / 20) Alle Ein- und Ausgänge, die zum ifm-Verhaltensmodell gehören, sind im FB als oberste angeordnet. Meldungen / Diagnose-Codes der Funktionsbausteine Status-/Diagnose-/Fehler-Meldungen der Funktionsbausteine sind im globalen Enum DIAG_INFO definiert.
CP9031 7.1.2 Funktionsbausteine 7.1.2.1 PingDevice Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB prüft, ob eine Verbindung zwischen dem Client-Gerät mit SDK und dem Zielgerät im CAN- Netzwerk hergestellt werden kann. Der FB sendet ein PING-Signal an ein Zielgerät mit einer bestimmten Knoten-ID ( usiDownloadID ) und einer bestimmten Artikelnummer ( eDevice ) im CAN-Netzwerk ( eChannel ).
Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren! • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Abarbeitung wurde abgebrochen...
CP9031 7.1.2.2 GetSysInfo Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest die Systeminformationen eines Geräts (eChannel, usiDownloadId, eDevice). Optional kann der Nutzer für passwortgeschützte IEC-Anwendungen das entsprechende Passwort übergeben (sPassword). Die gelesenen Informationen werden in einer Strukturvariable vom Typ stSYS_INFO (STRUCT) gespeichert.
Seite 24
CP9031 Name Datentyp Beschreibung Wertebereich eDiagInfo eDIAG_ Diagnoseinformationen Ò Liste unten (Diagnose-Codes) INFO stSysInfo stSYS_IN- Strukturvariable, in der die gele- Definiert in: stSYS_INFO (Ò / 90) senen Informationen gespei- chert werden Diagnose-Codes • STAT_ABORT Zustand: Ausführung des FBs / der Funktion wird abgebrochen •...
CP9031 7.1.2.3 Command Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB dient zur Steuerung des Betriebszustands der Applikation des angeschlossenen Zielgeräts. Das Zielgerät wird durch die Eingänge eChannel, usiDownloadId, eDevice ausgewählt. Der Befehl wird am Eingang eCommand eingestellt.
Seite 26
• ERR_COMPATIBILITY Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_CMND_NOT_SUPPORT Fehler: Mindestens ein Befehl wird von dem Gerät nicht unterstützt. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.4 ReadFromController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest die Daten eines Zielgeräts (eChannel, usiDownloadId, eDevice). Der Anwender kann festlegen, welche Speicherbereiche des Zielgeräts gelesen werden sollen (stSegmList). Für zugriffsgeschützte CODESYS-Anwendungen kann der Anwender das entsprechende Passwort eingeben (sPassword).
Seite 28
CP9031 Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 29
CP9031 • ERR_PROTOCOL Fehler: Fehler im Maintenance Befehlsprotokoll u Befehlsausführung wiederholen. • ERR_COMPATIBILITY Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren! • ERR_UNKNOWN Fehler: Unbekannter Fehler...
CP9031 7.1.2.5 GetSegmentListFromFile Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest alle verfügbaren Software-Segmente, deren Name und Datentypen aus einer Datei (sFileName, sMd5Filename). Die Ergebnisse speichert er in einer Datenstruktur (iq_aSegmTypeNameList). Die Datenstruktur kann Informationen von maximal 16 Software-Segmenten speichern.
Seite 31
Fehler: Datei enthält mehr Software-Segmente als erlaubt oder Datei ent- hält mehr als 2 Versionen des gleichen Segmenttyps. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Abarbeitung wurde abgebrochen • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.6 SelectSegmentFromList Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest eine Datenstruktur (aSegmTypeNameList). Er erzeugt aus den gelesenen Daten eine Liste der Software-Segmente (stSegmList). Dabei werden alle Datensätze mit xSele = TRUE in die Liste übernommen.
Seite 33
CP9031 Name Datentyp Beschreibung Wertebereich eDiagInfo eDIAG_ Diagnoseinformationen Ò Liste unten (Diagnose-Codes) INFO stSegmList stSEGM_ gewünschte Speichersegmente Definiert in: stSEGM_LIST (Ò / 90) LIST Diagnose-Codes • STAT_ABORT Zustand: Ausführung des FBs / der Funktion wird abgebrochen • STAT_BUSY Zustand: FB / Funktion wird ausgeführt •...
CP9031 7.1.2.7 WriteToController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB schreibt Firmware, Anwendungen oder Daten auf ein Zielgerät (eChannel, usiDownloadId, eDevice). Die zu schreibenden Daten werden aus einer Datei mit Prüfsumme gelesen (sFileName, sMd5FileName).
Seite 35
CP9031 Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 36
Fehler: Ungültige Target-ID (z.B. CAN-ID, IP-Adresse etc.) • ERR_PROTOCOL Fehler: Fehler im Maintenance Befehlsprotokoll u Befehlsausführung wiederholen. • ERR_BAD_CRC Fehler: CRC-Fehler • ERR_FILE_OPEN Fehler: SDK-API meldet Fehler beim Öffnen der Datei. • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren! • ERR_UNKNOWN Fehler: Unbekannter Fehler...
CP9031 7.1.2.8 WriteInterfaceSettings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB dient dazu, die Knoten-ID und die CAN-Baudrate des angegebenen CAN-Kanals des Zielgeräts zu ändern. Wenn die Baudrate oder Knoten-ID des CAN-Kanals des Zielgeräts geändert wird, wird die Kommunikation zwischen dem ecomatDisplay und dem Zielgerät unterbrochen.
Seite 38
CP9031 Eingangsparameter Name Datentyp Beschreibung Wertebereich xExecute BOOL Steuerung des FBs • FALSE ⇨ TRUE: FB einmalig ausführen. Werte an den Eingängen werden übernommen. Den FB solange ausführen (xExecute = TRUE), bis die Bausteinausführung erfolgreich beendet ist (xDone = TRUE). Wenn xDone = TRUE, dann den Eingang xExecute auf FALSE rücksetzen.
Seite 39
Fehler: Ungültige Target-ID (z.B. CAN-ID, IP-Adresse etc.) • ERR_PROTOCOL Fehler: Fehler im Maintenance Befehlsprotokoll u Befehlsausführung wiederholen. • ERR_COMPATIBILITY Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.9 Authentication Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB dient zur Authentifizierung auf einem ecomatController: • Bei steigender Flanke am FB-Eingang xExecute : Mit den gesetzten Anmeldeinformationen am ecomatController anmelden. •...
Seite 41
CP9031 Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 42
Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.10 GetSdkInterfaces Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB sucht nach SDK-Schnittstellen auf dem Clientsystem (ecomatDisplay) und ruft eine Liste der verfügbaren Kommunikationsschnittstellen ab. Eingangsparameter Name Datentyp Beschreibung Wertebereich xExecute BOOL Steuerung des FBs •...
Seite 44
Fehler: Falsches oder unbekanntes Gerät • ERR_COMPATIBILITY Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.11 GetSysInfo_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Dieser FB liest die folgenden Informationen aus dem Zielgerät (ecomatController): • Softwareinformationen: Gibt Informationen über die aktuelle Software zurück. • Geräteinformationen: Gibt detaillierte Informationen zur Hardware und Netzwerkschnittstelle des Geräts zurück.
Seite 46
Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.12 Command_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB wird verwendet, um die folgenden Befehle auf dem Zielgerät auszuführen: • Anwendung starten: Startet die IEC-Standard-Applikation im Gerät. • Anwendung stoppen: Stoppt die IEC-Standard-Applikation und die IEC-Safety-Applikation im Gerät.
Seite 48
CP9031 Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 49
Fehler: Inkompatible Version der Hardware, der Datei, des Laufzeitsys- tems, der Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.13 ReadPackageFrom_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Dieser FB liest Softwaresegmente aus einem ecomatController aus und speichert sie. Der FB erzeugt pro Segmenttyp, der am FB-Eingang StSegmList ausgewählt ist, eine zip-Datei, die alle Konfigurationsdateien und zugehörigen Daten für den gewählten Segmenttyp enthält.
Seite 51
CP9031 Name Datentyp Beschreibung Wertebereich eEthItf ifmDevice. Ethernet-Schnittstelle des Dia- Definiert in: Ò ifmDevice.eETHERNET_IN- eETHER- loggerätes, z.B. ecomatDisplay TERFACES NET_ INTERFA- sIPaddress STRING IP-Adresse des Zielgeräts, z.B. Standardwert: 192.168.82.247 (15) ecomatController sFileName STRING Verzeichnispfad und Name der z.B. \data\MyData.bin BIN-Datei...
Seite 52
Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_NO_SOFTWARE Fehler: Die Software ist auf dem Zielgerät nicht verfügbar. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
Vorgangs auf TRUE setzen. u Die Ausführung des FBs erst beenden ( xExecute = FALSE ), wenn die FB-Ausgänge xDone = TRUE oder xError = TRUE sind. Der FB lädt das von ifm electronic bereitgestellte Firmware-Update (zip-Paketdatei) auf den ecomatController. •...
Seite 54
CP9031 Name Datentyp Beschreibung Wertebereich eEthItf ifmDevice. Ethernet-Schnittstelle des Dia- Definiert in: Ò ifmDevice.eETHERNET_IN- eETHER- loggerätes, z.B. ecomatDisplay TERFACES NET_ INTERFA- sIPaddress STRING IP-Adresse des Zielgeräts, z.B. Standardwert: 192.168.82.247 (15) ecomatController sFileName STRING Verzeichnispfad und Name der z.B. \data\MyData.bin BIN-Datei...
Seite 55
• ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.15 WritePackageTo_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung ACHTUNG Abbruch des Schreibvorgangs auf die Steuerung w Beschädigung des Geräts möglich u Die Ausführung des FBs während des Schreibvorgangs nicht abbrechen. u Den Wert des FB-Eingangs xExecute während des gesamten Schreibvorgangs auf TRUE setzen.
Seite 57
CP9031 Name Datentyp Beschreibung Wertebereich eEthItf ifmDevice. Ethernet-Schnittstelle des Dia- Definiert in: Ò ifmDevice.eETHERNET_IN- eETHER- loggerätes, z.B. ecomatDisplay TERFACES NET_ INTERFA- sIPaddress STRING IP-Adresse des Zielgeräts, z.B. Standardwert: 192.168.82.247 (15) ecomatController sFileName STRING Verzeichnispfad und Name der z.B. \data\MyData.bin BIN-Datei...
Seite 58
• ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.16 ReadIOSettings_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest die Einstellungen aller EAs aus dem ecomatController aus. Damit der FB auf das Zielgerät zugreifen kann: u Vor Ausführen des FBs: Anmelden mithilfe des FBs Authentication mit den benötigten Benutzerrechten (user level) und dem entsprechenden Passwort auf dem Zielgerät.
Seite 60
• ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.17 WriteIOSettings_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung ACHTUNG Abbruch des Schreibvorgangs auf die Steuerung w Beschädigung des Geräts möglich u Die Ausführung des FBs während des Schreibvorgangs nicht abbrechen. u Den Wert des FB-Eingangs xExecute während des gesamten Schreibvorgangs auf TRUE setzen.
Seite 62
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE_IO_SETTING Fehler: Fehler beim Schreiben der IO-Einstellungen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.18 ReadInterfaceSettings_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB gibt eine Liste der Schnittstellen incl. Parameter des ecomatControllers zurück. Damit der FB auf das Zielgerät zugreifen kann: u Vor Ausführen des FBs: Anmelden mithilfe des FBs Authentication mit den benötigten Benutzerrechten (user level) und dem entsprechenden Passwort auf dem Zielgerät.
Seite 64
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.19 WriteInterfaceSettings_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB schreibt die am FB-Eingang stItfSettings eingestellten Schnittstellenparameter in den ecomatController. Damit der FB auf das Zielgerät zugreifen kann: u Vor Ausführen des FBs: Anmelden mithilfe des FBs Authentication mit den benötigten Benutzerrechten (user level) und dem entsprechenden Passwort auf dem Zielgerät.
Seite 66
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE_ITF_SETTINGS Fehler: Fehler beim Schreiben der Schnittstellen-Einstellungen. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.20 GetDataFileList_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB gibt die Liste aller Dateien zurück, die sich im Ordner /data des ecomatControllers befinden. Damit der FB auf das Zielgerät zugreifen kann: u Vor Ausführen des FBs: Anmelden mithilfe des FBs Authentication mit den benötigten...
Seite 68
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.21 ReadDataFiles_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest eine oder mehrere Benutzerdateien, die sich im Ordner /data des ecomatControllers befinden und speichert sie in einem Zielpfad als zip Containerdatei.
Seite 70
CP9031 Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 71
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.22 WriteDataFiles_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB schreibt eine oder mehrere Benutzerdateien aus einer zip-Containerdatei (Quelle) in den Ordner /data des ecomatControllers (Ziel). • Die Namen aller Benutzerdateien, die in den Ordner /data des ecomatControllers geschrieben werden sollen, werden in das Array am FB-Eingang stDataFileList eingetragen.
Seite 73
CP9031 Eingangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt • TRUE: – FB / FUN wurde erfolgreich ausgeführt – FB / FUN kann erneut aufgerufen werden xError BOOL Fehleranzeige •...
Seite 74
• ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.23 ReadDeviceLogs_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB liest das Ereignisprotokoll mit geloggten Fehlern, Informationen und Wartungsaktivitäten aus dem Gerät aus. • Das Ereignisprotokoll wird als Liste von Protokollierungsereignissen am FB-Ausgang stLogs ausgegeben.
Seite 76
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
Keine manuellen Änderungen an den Segmentdateien vornehmen. Der Inhalt ist ein gültiger Satz von CRC-geprüften Dateien. Alle Änderungen von außerhalb machen die Dateien für die ifm SDK-API unbrauchbar. Damit der FB auf das Zielgerät zugreifen kann: u Vor Ausführen des FBs: Anmelden mithilfe des FBs Authentication mit den benötigten Benutzerrechten (user level) und dem entsprechenden Passwort auf dem Zielgerät.
Seite 78
CP9031 Eingangsparameter Name Datentyp Beschreibung Wertebereich xExecute BOOL Steuerung des FBs • FALSE ⇨ TRUE: FB einmalig ausführen. Werte an den Eingängen werden übernommen. Den FB solange ausführen (xExecute = TRUE), bis die Bausteinausführung erfolgreich beendet ist (xDone = TRUE). Wenn xDone = TRUE, dann den Eingang xExecute auf FALSE rücksetzen.
Seite 79
Software oder der Applikation • ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_READ Fehler: Fehler beim Lesen eines Segments oder Pakets vom Gerät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.25 WriteSegmentTo_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB ermöglicht es dem Benutzer, ein oder mehrere Softwaresegmente und Benutzerdateien aus der angegebenen zip-Datei in den ecomatController zu schreiben. ACHTUNG Abbruch des Schreibvorgangs auf die Steuerung w Beschädigung des Geräts möglich...
Seite 81
In der Paketdatei sind oft mehrere Varianten von MemConfig-Dateien vorhanden. Diese sind unterschiedlich benannt. u Die Datei, auf das Gerät geladen werden soll, umbenennen in memconf.ifm und alle anderen Varianten aus der Datei entfernen. u Nach dem Laden von Applikationen auf das Gerät entweder einen (manuellen) PowerOn-Reset oder einen Reset mit dem Reset-Befehl durchführen, um die Daten in den Flash-Speicher zu...
Seite 82
CP9031 Name Datentyp Beschreibung Wertebereich eEthItf ifmDevice. Ethernet-Schnittstelle des Dia- Definiert in: Ò ifmDevice.eETHERNET_IN- eETHER- loggerätes, z.B. ecomatDisplay TERFACES NET_ INTERFA- sIPaddress STRING IP-Adresse des Zielgeräts, z.B. Standardwert: 192.168.82.247 (15) ecomatController sFileName STRING Verzeichnispfad und Name der z.B. \data\MyData.bin BIN-Datei...
Seite 83
• ERR_INVALID_AUTH Fehler: Ungültige oder fehlende Authentifizierung • ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.2.26 SetPasswords_ecomatController Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE (Ò Verhaltensmodell EXECUTE / 20) Bibliothek: ifmSDKutil_ecomatDisplay Symbol in CODESYS: Beschreibung Der FB schreibt eine Passwortdatei in den ecomatController. • Die Passwortdatei muss immer alle Benutzer enthalten, die zugewiesen werden müssen. • In jedem Fall müssen der Admin-Benutzer und das Passwort festgelegt werden.
Seite 85
CP9031 Name Datentyp Beschreibung Wertebereich sIPaddress STRING IP-Adresse des Zielgeräts, z.B. Standardwert: 192.168.82.247 (15) ecomatController ePassword STRING Optional: Passwort für geschütz- te IEC-Anwendungen Ausgangsparameter Name Datentyp Beschreibung Wertebereich xDone BOOL Status der Abarbeitung • FALSE: FB / FUN ist inaktiv oder wird ausgeführt...
Seite 86
• ERR_CMND_FAILED Fehler: Ausführung des Befehls fehlgeschlagen. • ERR_WRITE Fehler: Fehler beim Schreiben eines Segments oder Pakets auf das Ge- rät. • ERR_WRITE_PASSWORD Fehler: Fehler beim Schreiben des Passworts. • ERR_UNKNOWN Fehler: Unbekannter Fehler • ERR_INTERNAL Fehler: Interner Systemfehler; ifm-Service-Center kontaktieren!
CP9031 7.1.4 STRUCT 7.1.4.1 stSYS_INFO Definiert verfügbare Systeminformationen der angeschlossenen R360 Basis-, Classic/ Extended Controller. Möglicherweise stellen nicht alle Geräte alle Systeminformationen bereit. Wenn ein verbundenes Gerät kein bestimmtes Element dieser Struktur bereitstellt, lautet der Wert der Zeichenfolge -not available- . Element...
CP9031 7.1.4.6 stLAST_EVNT_RESP Neuester Antwortcode, der vom SDK-API-Rückrufereignis empfangen wurde. Element Datentyp Beschreibung Mögliche Werte diErrorCode DINT Neuester Antwortcode, der vom SDK-API- • < 0: Fehlermeldung Rückrufereignis empfangen wurde. • = 0: Fertig • > 0: In Bearbeitung sRespDesc STRING(251) Beschreibung entsprechend dem Fehlercode.
CP9031 Element Datentyp Beschreibung stUserFlash ifmSDKutil.stRD_WR_INFO_TYPE Status User Flash Segment stDataFlash Status Data Flash Segment stRetaData Status Retain Daten / IEC User Retain segment stMemoReta Status Memory Retain Segment stEEPROM Status EEPROM-Segment xError BOOL • TRUE: Der SDK API-Aufruf hat einen Fehler zurückgemeldet.
Optional: Version des Software-Segments sBuildDate STRING Optional: Build-Datum des Software-Segments xActive BOOL Gibt an, ob das Software-Segment aktiv ist (nur • TRUE: aktiv für Bootloader und ifm-Betriebssystem verfügbar) • FALSE: nicht aktiv 7.1.4.13 stDEVICE_INFO_CR7nnS Geräteinformationen über den verbundenen ecomatController. Element Datentyp Beschreibung sArticle STRING Artikelnummer des Geräts...
CP9031 Element Datentyp Beschreibung Mögliche Werte xRead BOOL Lesestatus FALSE: Das Lesen des Seg- ments oder des Pakets ist inaktiv TRUE: Das Lesen des Segments oder des Pakets läuft / ist erledigt usiProg USINT Lesefortschritt in % 0…100 % sRespDesc...
CP9031 Element Datentyp Beschreibung usiNumOfItf_CAN USINT(0..8) Anzahl der gültigen Array-Ele- mente in der Variable astItf- List_CAN in diesem STRUCT astItfList_CAN ifmSDKutil.aITF_SETTINGS_CAN_CR7nnS Liste der CAN-Schnittstellen und der zugehörigen Parameter usiNumOfItf_ETH USINT(0..8) Anzahl der gültigen Array-Ele- mente in der Variable astItf- List_ETH in diesem STRUCT astItfList_ETH ifmSDKutil.aITF_SETTINGS_ETH_CR7nnS...
CP9031 Element Datentyp Beschreibung Mögliche Werte xActive BOOL Status der Schnittstelle • TRUE: Active • FALSE: Disabled 7.1.4.24 stDATA_FILE_LIST_CR7nnS Liste mit Benutzerdateien im Ordner /data des ecomatControllers Element Datentyp Beschreibung Anzahl der gültigen Array-Elemente in der Variable asFileName in diesem uiTotElem UINT(0..501)
CP9031 7.1.4.30 stPACKAGE_READ_STATUS_CR7nnS Status verschiedener Vorgänge beim Lesen des Softwarepakets aus dem ecomatController. Element Datentyp Beschreibung stFirmware stREAD_INFO_TYPE_CR7nnS (Ò / 94) Firmware (ODER runtime system)-Paket, enthält diese Segmente: compat, boot, sissys, ifmOS stIECApp_Standard IEC-Standard-Applikation-Paket, enthält diese Segmente: standard app, standard retain, stan- dard memory bytes stIECApp_Safe IEC-Safety-Applikation-Paket, enthält diese Seg-...
CP9031 7.1.5 GVL 7.1.5.1 gv_EvntCallBack stLastEvnt Die Variable zeigt die letzte Antwort der Diagnose an, die vom SDK-API-Rückrufereignis empfangen wurde. Die Variable kann für Diagnosezwecke verwendet werden, indem ihr Wert im zugehörigen Zustand des FB erfasst wird, z.B. bei steigender Flanke am FB-Ausgang xError .
CP9031 7.1.6 GCL 7.1.6.1 gc_AllSegments Liste der standardmäßig voreingestellten Softwaresegmente für verschiedene Controllertypen. stBasic Mit Hilfe dieser globalen Konstanten-Liste werden die Softwaresegmente ausgewählt, die von einem Basic Controller gelesen oder auf einen Basic Controller geschrieben werden sollen. Die Konstante ist vom Typ stSEGM_LIST (Ò / 90) Voreingestellter Wert für...
Seite 102
CP9031 Voreingestellter Wert für Element Datentyp Beschreibung die Auswahl xFirmware BOOL Firmware-Segment TRUE xIECApp BOOL IEC Applikation-Segment TRUE xIECAppCfg BOOL IEC Applikation Konfiguration-Segment FALSE xFileFlash BOOL File Flash-Segment TRUE xUserFlash BOOL User Flash-Segment TRUE xDataFlash BOOL Data Flash-Segment TRUE xRetaData...
CP9031 7.1.7 DUT 7.1.7.1 aSEGM_TYPE_NAME Name Datentyp Beschreibung aITF_ ARRAY [0..7] of Liste der Namen der in der Datei ver- SEGM_ fügbaren Segmenttypen für R360 Ba- stSEGM_TYPE_NAME (Ò / 91) TYPE_ sic, Classic / Extended Controller NAME 7.1.7.2 aINTF_LIST Name Datentyp Beschreibung aINTF_LIST ARRAY [0..31] of Liste der Namen der verfügbaren SDK-...
Seite 104
CP9031 7.1.7.8 aNETWORK_INFO_CR7nnS Name Datentyp Beschreibung aNETWORK_ ARRAY [0..8] of Netzwerk-Informationen des eco- INFO_ matControllers stNETWORK_INFO_CR7nnS (Ò / 94) CR7nnS 7.1.7.9 aSOFTWARE_INFO_CR7nnS Name Datentyp Beschreibung aSOFTWARE_ ARRAY [0..31] of Software-Informationen des eco- INFO_ matControllers stSOFTWARE_INFO_CR7nnS (Ò / 93) CR7nnS...