IFM CP9031 Bedienungsanleitung

IFM
Marke
IFM
Modell
CP9031
Typ
Bedienungsanleitung
Programmierhandbuch
CP9031
ecomatDisplay SDK Utilities
11428978 / 0008 / 2022
DE
CP9031
2
Inhaltsverzeichnis
1 Vorbemerkung .............................................................. 5
1.1 Rechtliche Hinweise..................................................... 5
1.2 Zweck des Dokuments................................................... 5
1.3 Verwendete Symbole .................................................... 5
1.4 Verwendete Warnhinweise................................................ 6
1.5 Änderungshistorie....................................................... 6
1.5.1 Änderungen 08 / 2022 – 11428978 / 00 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.5.2 Änderungen 10 / 2017 – 7391179 / 00 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Sicherheitshinweise .......................................................... 7
2.1 Notwendige Vorkenntnisse................................................ 7
3 Bestimmungsgemäße Verwendung .............................................. 8
4 Funktion ................................................................... 9
4.1 Basic- und R360-System.................................................. 9
4.2 ecomatController........................................................ 9
4.3 Übersicht.............................................................. 9
4.4 User Interface.......................................................... 10
4.5 Kommunikation......................................................... 10
4.5.1 Kommunikation Basic- und R360-System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.5.2 Kommunikation ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5 Installation.................................................................. 12
5.1 Voraussetzungen ....................................................... 12
5.1.1 Hardware ......................................................... 12
5.1.2 Software.......................................................... 12
5.1.3 Lizensierung....................................................... 12
5.2 ifm-Package........................................................... 12
5.2.1 Inhalt des ifm-Packages.............................................. 12
5.2.2 CODESYS-Package................................................. 13
5.2.2.1 CODESYS-Package installieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.2.2.2 CODESYS-Package aktualisieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.2.2.3 CODESYS-Package deinstallieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.2.3 rpm-Package für das ecomatDisplay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.2.3.1 Speicherbelegung.............................................. 14
5.2.3.2 ecomatDisplay vorbereiten....................................... 14
5.2.3.3 rpm-Package auf dem ecomatDisplay installieren. . . . . . . . . . . . . . . . . . . . . . 14
5.2.3.4 Software auf andere ecomatDisplays übertragen . . . . . . . . . . . . . . . . . . . . . . 15
5.3 Funktionsbibliothek zu Projekt hinzufügen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.4 Beispiel-Applikation auf das ecomatDisplay laden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.5 ecomatController vorbereiten .............................................. 16
6 Programmierung............................................................. 17
6.1 Bibliotheksfunktionen nutzen............................................... 17
7 ifm-Funktionsbibliotheken...................................................... 19
7.1 Bibliothek ifmSDKutil_ecomatDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.1 Verhaltensmodell der ifm-Funktionsbausteine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.1.1 Allgemein .................................................... 20
7.1.1.2 Verhaltensmodell EXECUTE...................................... 20
7.1.2 Funktionsbausteine.................................................. 21
7.1.2.1 PingDevice................................................... 21
7.1.2.2 GetSysInfo ................................................... 23
7.1.2.3 Command.................................................... 25
7.1.2.4 ReadFromController............................................ 27
7.1.2.5 GetSegmentListFromFile ........................................ 30
7.1.2.6 SelectSegmentFromList......................................... 32
7.1.2.7 WriteToController.............................................. 34
7.1.2.8 WriteInterfaceSettings........................................... 37
7.1.2.9 Authentication................................................. 40
7.1.2.10 GetSdkInterfaces .............................................. 43
7.1.2.11 GetSysInfo_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
CP9031
3
7.1.2.12 Command_ecomatController ..................................... 47
7.1.2.13 ReadPackageFrom_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.1.2.14 UpdateFirmware_ecomatController. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
7.1.2.15 WritePackageTo_ecomatController. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
7.1.2.16 ReadIOSettings_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
7.1.2.17 WriteIOSettings_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.1.2.18 ReadInterfaceSettings_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.1.2.19 WriteInterfaceSettings_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.2.20 GetDataFileList_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
7.1.2.21 ReadDataFiles_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
7.1.2.22 WriteDataFiles_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.1.2.23 ReadDeviceLogs_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
7.1.2.24 ReadSegmentFrom_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.1.2.25 WriteSegmentTo_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.1.2.26 SetPasswords_ecomatController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
7.1.3 ENUM............................................................ 87
7.1.3.1 eCMD_LIST (ENUM) ........................................... 87
7.1.3.2 eDEVICES (ENUM) ............................................ 87
7.1.3.3 eSEGM_TYPE (ENUM) ......................................... 88
7.1.3.4 eCMD_LIST_CR7nnS (ENUM).................................... 88
7.1.3.5 ePACKAGE_TYPE_CR7nnS (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.1.3.6 eUSER_LEVEL (ENUM)......................................... 89
7.1.4 STRUCT.......................................................... 90
7.1.4.1 stSYS_INFO.................................................. 90
7.1.4.2 stSEGM_LIST................................................. 90
7.1.4.3 stSEGM_NAME ............................................... 91
7.1.4.4 stSEGM_TYPE_NAME.......................................... 91
7.1.4.5 stSEGM_LIST_WRITE.......................................... 91
7.1.4.6 stLAST_EVNT_RESP........................................... 92
7.1.4.7 stRD_WR_INFO_TYPE ......................................... 92
7.1.4.8 stSEGM_READ_STATUS........................................ 92
7.1.4.9 stSEGM_WRITE_STATUS....................................... 92
7.1.4.10 stITF_SETTINGS.............................................. 93
7.1.4.11 stSymbolCfgInfo............................................... 93
7.1.4.12 stSOFTWARE_INFO_CR7nnS.................................... 93
7.1.4.13 stDEVICE_INFO_CR7nnS....................................... 94
7.1.4.14 stNETWORK_INFO_CR7nnS..................................... 94
7.1.4.15 stSYS_INFO_CR7nnS .......................................... 94
7.1.4.16 stREAD_INFO_TYPE_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.1.4.17 stIO_SETTINGS_CR7nnS ....................................... 95
7.1.4.18 stIO_INFO_CR7nnS............................................ 95
7.1.4.19 stIO_DATA_CR7nnS ........................................... 95
7.1.4.20 stITF_SETTINGS_CR7nnS....................................... 95
7.1.4.21 stITF_SETTINGS_CAN_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
7.1.4.22 stITF_SETTINGS_ETH_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
7.1.4.23 stITF_SETTINGS_RS232_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
7.1.4.24 stDATA_FILE_LIST_CR7nnS..................................... 97
7.1.4.25 stDEVICE_LOGS_CR7nnS....................................... 97
7.1.4.26 stDEVICE_LOG_INFO_CR7nnS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
7.1.4.27 stSEGM_LIST_READ_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
7.1.4.28 stSEGM_LIST_WRITE_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.1.4.29 stPACKAGE_LIST_CR7nnS...................................... 98
7.1.4.30 stPACKAGE_READ_STATUS_CR7nnS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
7.1.4.31 stPASSWORD_CR7nnS......................................... 99
7.1.4.32 stINTF....................................................... 99
7.1.5 GVL .............................................................100
7.1.5.1 gv_EvntCallBack...............................................100
7.1.6 GCL .............................................................101
7.1.6.1 gc_AllSegments ...............................................101
7.1.7 DUT .............................................................103
7.1.7.1 aSEGM_TYPE_NAME..........................................103
7.1.7.2 aINTF_LIST ..................................................103
CP9031
4
7.1.7.3 aIO_DATA_CR7nnS............................................103
7.1.7.4 aITF_SETTINGS_CAN_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
7.1.7.5 aITF_SETTINGS_ETH_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
7.1.7.6 aITF_SETTINGS_RS232_CR7nnS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
7.1.7.7 aDEVICE_LOG_INFO_CR7nnS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
7.1.7.8 aNETWORK_INFO_CR7nnS.....................................104
7.1.7.9 aSOFTWARE_INFO_CR7nnS....................................104
CP9031
5
1 Vorbemerkung
Anleitung, technische Daten, Zulassungen und weitere Informationen über den QR-Code auf dem
Gerät / auf der Verpackung oder über www.ifm.com.
1.1 Rechtliche Hinweise
© Alle Rechte bei ifm electronic gmbh. Vervielfältigung und Verwertung dieser Anleitung, auch
auszugsweise, nur mit Zustimmung der ifm electronic gmbh.
Alle verwendeten Produktnamen, Bilder, Unternehmen oder sonstige Marken sind Eigentum der
jeweiligen Rechteinhaber.
• AS-i ist Eigentum der AS-International Association
• CAN ist Eigentum der Robert Bosch GmbH, Deutschland
• CANopen ist Eigentum der CiA (CAN in Automation e.V.), Deutschland
• CODESYS™ ist Eigentum der CODESYS GmbH, Deutschland
• DeviceNet™ ist Eigentum der ODVA™ (Open DeviceNet Vendor Association), USA
• EtherNet/IP® ist Eigentum der ODVA™ (Open DeviceNet Vendor Association), USA
• EtherCAT® ist eine eingetragene Marke und patentierte Technologie, lizenziert durch die Beckhoff
Automation GmbH, Deutschland
• ISOBUS ist Eigentum der AEF – Agricultural Industry Electronics Foundation e.V., Deutschland
• Modbus® ist Eigentum der Schneider Electric SE, Frankreich
• PROFIBUS® ist Eigentum der PROFIBUS Nutzerorganisation e.V., Deutschland
• PROFINET® ist Eigentum der PROFIBUS Nutzerorganisation e.V., Deutschland
• Microsoft® ist Eigentum der Microsoft Corporation, USA
• Windows® ist Eigentum der Microsoft Corporation, USA
• Linux® ist die eingetragene Marke von Linus Torvalds in den USA und anderen Ländern.
1.2 Zweck des Dokuments
Das Dokument beschreibt die Verwendung des ifm SDK ecomatDisplay zur Wartung angeschlossener
ifm-Steuerungen.
1.3 Verwendete Symbole
Voraussetzung
Handlungsanweisung
Reaktion, Ergebnis
[...] Bezeichnung von Tasten, Schaltflächen oder Anzeigen
Querverweis
Wichtiger Hinweis
Fehlfunktionen oder Störungen sind bei Nichtbeachtung möglich
Information
Ergänzender Hinweis
CP9031
6
1.4 Verwendete Warnhinweise
ACHTUNG
Warnung vor Sachschäden
VORSICHT
Warnung vor Personenschäden
wLeichte reversible Verletzungen sind möglich.
WARNUNG
Warnung vor schweren Personenschäden
wTod oder schwere irreversible Verletzungen sind möglich.
1.5 Änderungshistorie
1.5.1 Änderungen 08 / 2022 – 11428978 / 00
• Aktualisierung auf SDK Utilities Package V3
1.5.2 Änderungen 10 / 2017 – 7391179 / 00
• Neuerstellung des Dokuments
CP9031
7
2 Sicherheitshinweise
• 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.
Die Konformität mit einschlägigen Richtlinien und Normen zur Erfüllung der gesetzlichen
Anforderungen für das Inverkehrbringen werden erst mit der Verifizierung und Validierung im
Rahmen der Entwicklung beim Systemersteller festgestellt. Ein Bereitstellen durch den
Systemersteller auf dem Markt zur Verwendung durch Endnutzer darf bis zu diesem Zeitpunkt nicht
stattfinden.
• Dieses Dokument vor Inbetriebnahme des Produktes lesen und während der Einsatzdauer
aufbewahren.
• Das Produkt muss sich uneingeschränkt für die betreffenden Applikationen eignen.
• Das Produkt nur bestimmungsgemäß verwenden (Ò Bestimmungsgemäße Verwendung).
• Die Missachtung von Anwendungshinweisen oder technischen Angaben kann zu Sach- und/oder
Personenschäden führen.
• Für Folgen durch Eingriffe in das Produkt oder Fehlgebrauch durch den Betreiber übernimmt der
Hersteller keine Haftung und keine Gewährleistung.
• Unsachgemäße oder nicht bestimmungsgemäße Verwendung können zu Fehlfunktionen, zu
unerwünschten Auswirkungen in der Applikation oder zum Verlust der Gewährleistungsansprüche
führen.
• Mitgeltende Dokumente beachten.
2.1 Notwendige Vorkenntnisse
Das Dokument richtet sich an Fachkräfte. Dabei handelt es sich um Personen, die aufgrund ihrer
einschlägigen Ausbildung und ihrer Erfahrung befähigt sind, Risiken zu erkennen und mögliche
Gefährdungen zu vermeiden, die der Betrieb oder die Instandhaltung eines Produkts verursachen
kann.
Für die Programmierung sollten die Personen zusätzlich über Kenntnisse der Steuerungstechnik und
Erfahrung in der SPS-Programmierung nach IEC61131-3 verfügen.
Das Dokument enthält Angaben zum korrekten Umgang mit dem Produkt.
CP9031
8
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:
• Geräteinformationen lesen
• Applikationen, Firmware und Daten auf das Gerät schreiben (Download)
• Applikationen, Firmware und Daten vom Gerät lesen (Upload)
• Gerät steuern (Start, Stop, Reset, Reboot)
• Verbindung zu einem Gerät testen
• Hilfsfunktionen
CP9031
9
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:
– resx-Dateien für alle Basic- und R360-Steuerungen
– h86-Dateien für alle R360-Steuerungen
– binary-Dateien für alle Basic- und R360-Steuerungen
• Klonen des kompletten Software-Inhalts einer Steuerung im Feld, z.B. im Servicefall.
• Alle oder bestimmte Speichersegmente können von einer programmierten Steuerung gelesen und
auf eine andere Steuerung oder auf dieselbe Steuerung geschrieben werden, z.B. bei einer
fehlgeschlagenen Aktualisierung.
4.2 ecomatController
Die Bibliothek bietet Funktionen für folgenden Anwendungsfälle für einen oder mehrere
ecomatController:
• Benutzerauthentifizierung für den Zugriff auf die Steuerung.
• Abrufen von Systeminformationen.
• Steuern des Betriebsmodus.
• Lesen und Schreiben der IEC Applikation (Standard/Safety), der Firmware und einzelner
Softwaresegmente.
• Speicherkonfiguration lesen und schreiben.
• E/A-Konfiguration lesen und schreiben.
• Kommunikationsschnittstellen-Einstellungen der Steuerung lesen und schreiben.
• Benutzer-Passwörter für alle zulässigen Benutzerebenen lesen.
• Geräteereignisprotokolle lesen und schreiben.
• Benutzerdatendateien lesen und schreiben.
• Aktualisieren einer Steuerung mit neuer Firmware und/oder Applikation usw., die als zip-Datei zur
Verfügung stehen.
• Klonen des kompletten Software-Inhalts einer Steuerung im Feld, z.B. im Servicefall.
• Alle oder bestimmte Speichersegmente können von einer programmierten Steuerung gelesen und
auf eine andere Steuerung oder auf dieselbe Steuerung geschrieben werden, z.B. bei einer
fehlgeschlagenen Aktualisierung.
4.3 Übersicht
Die Übersicht zeigt den Systemaufbau und die Kommunikationswege zwischen den Komponenten.
CP9031
10
4.4 User Interface
• Die Schnittstelle wird als CODESYS-Bibliothek mit Funktionsbausteinen (FBs) und Datenstrukturen
zur Verfügung gestellt.
• Die Funktionsbausteine der Bibliothek werden in 2 Gruppen unterteilt.
Dies geschieht aufgrund der Unterschiede in den verfügbaren Kommunikationsschnittstellen,
Datenstrukturen und Funktionen der verschiedenen Steuerungstypen:
– FB-Gruppe 1: FBs zur Kommunikation mit R360-Steuerungen und Basic-System - Die
Steuerungstypen Basic System, R360Classic Line, Extended Line, 16 Bit, 32 Bit, Sicherheits-
und Standard-Steuerungen werden von dieser Gruppe von FBs unterstützt.
– FB-Gruppe 2: FBs zur Kommunikation mit ecomatController - Alle ecomatController (Standard
und Safety) werden von dieser Gruppe von FBs unterstützt. FBs dieser Gruppe sind erkennbar
durch das Suffix „_ecomatController“ im FB-Namen.
4.5 Kommunikation
4.5.1 Kommunikation Basic- und R360-System
• Die Kommunikation zwischen dem ecomatDisplay und R360-Geräten / Basic-Geräten erfolgt über
CAN-Bus.
• Alle verfügbaren CAN-Kanäle des ecomatDisplays können genutzt werden. Die Anzahl der
verfügbaren CAN-Kanäle ist gerätespezifisch und wird aus der zugehörigen
ifmDevice_ecomatDisplay-Bibliothek > ENUM - ifmDevice.CAN_CHANNEL ausgewählt.
• 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.
uFür die unterstützten Baudraten durch die APIs in den zugrunde liegenden SDK-DLLs die
Dokumentation von ifm-Artikel-Nr. CP9030 beachten.
CP9031
11
• 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
• Die Kommunikation zwischen ecomatDisplay und ecomatController erfolgt über die Ethernet-
Schnittstelle (TFTP/UDP).
• Alle verfügbaren Ethernet-Schnittstellen des ecomatDisplays können genutzt werden. Die Anzahl
der verfügbaren Ethernet-Schnittstellen ist gerätespezifisch und wird aus der zugehörigen
ifmDevice_ecomatDisplay-Bibliothek > ENUM - ifmDevice.eETHERNET_INTERFACES
ausgewählt.
• 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.
CP9031
12
5 Installation
5.1 Voraussetzungen
5.1.1 Hardware
• Ein Gerät der Produktfamilie ecomatDisplay als Client (= das Gerät, von dem die Wartung
durchgeführt wird)
– Laufzeitsystem: 2.1.0.15 oder höher
• Mindestens ein Gerät der Produktfamilie ecomatController, Basic Controller oder R360 Controller
als Zielgerät (= das Gerät, welches gewartet wird)
• PC für das Programmiersystem CODESYS für das erstmalige Einrichten und Projektieren des
ecomatDisplay und der Steuerungen.
• Das ecomatDisplay, der/die ecomatController und der PC sind über Ethernet verbunden und
befinden sich im selben Subnetz.
• Das ecomatDisplay und eventuell vorhandene Basic oder R360 Controller sind über die CAN-
Schnittstelle verbunden.
5.1.2 Software
• CODESYS Development System
– Version: 3.5 SP16 Patch 4 oder höher
• Package "CODESYS for ifm ecomatDisplay"
– Version: 2.3.0.0 oder höher
• SSH Client, z.B. Putty oder WinSCP
Die in diesem Handbuch zugesicherten Eigenschaften und Funktionen sind nur mit den
Software-Komponenten in den hier angegebenen Versionen erreichbar!
ifm electronic stellt auf seiner 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".
uLizenzinformationen: Ò Installationsroutine oder Produktseite des Artikels auf der ifm-
Webseite.
5.2 ifm-Package
uMachen Sie sich mit folgenden CODESYS-Funktionen vertraut:
Package Manager: Ò Online-Hilfe > CODESYS Development System > Packages und
Lizenzen verwalten
5.2.1 Inhalt des ifm-Packages
Das ifm-Package "CP9031_VX.X.X.X.zip" enthält:
• das CODESYS-Package "ifm_SDKutilities_ecomatDisplay_Vx.x.x.x.package" zur Installation auf
dem PC mit CODESYS.
CP9031
13
• das rpm-Package "maintenance-sdk-x.x.xx.x-rx.aarch64.rpm", das auf dem ecomatDisplay
installiert werden muss.
• die vorprogrammierte CODESYS-Beispielapplikation "ifm Package Loader"
• das 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.
uCODESYS mit Administratorrechten starten.
wCODESYS startet.
wCODESYS-Programmoberfläche erscheint.
u[Tools] > [Package Manager] wählen.
wDas Fenster [Package Manager] erscheint.
uAuf [Installieren...] klicken.
wDer Datei-Explorer erscheint.
uDie Datei "ifm_SDKutilities_ecomatDisplay_Vx.x.x.x.package" wählen
uAuf [Öffnen] klicken und eine komplette Installation durchführen.
w"CODESYS für ifm SDK Erweiterung" wird installiert.
wNach erfolgreicher Installation: Das Fenster [Package Manager] zeigt installiertes Package.
wDie Funktionen des Packages können genutzt werden.
uAuf [Schließen] klicken, um den Package Manager zu beenden.
5.2.2.2 CODESYS-Package aktualisieren
Um das ifm-Package "CODESYS für ifm SDK Erweiterung" zu aktualisieren:
uAlte Version des ifm-Packages deinstallieren: CODESYS-Package deinstallieren (Ò/13)
uNeue Version des ifm-Packages installieren: CODESYS-Package installieren (Ò/13)
uProjekt öffnen.
uIm Gerätebaum: Knoten des Geräts wählen.
u[Projekt] > [Gerät aktualisieren...] wählen.
wDialogfenster erscheint.
uAuf [Gerät aktualisieren] klicken, um den Aktualisierungsvorgang zu starten.
wCODESYS lädt neue Gerätebibliotheken.
wAnsicht des Gerätebaums wird aktualisiert.
uAuf [Schließen] klicken, um das Dialogfenster zu schließen.
uProjekt speichern.
5.2.2.3 CODESYS-Package deinstallieren
Um das ifm-Package "CODESYS für ifm SDK Erweiterung" zu deinstallieren:
uPackage Manager starten: [Tools] > [Package Manager] wählen.
CP9031
14
wFenster [Package Manager] zeigt die installierten Packages.
uPackage wählen, das deinstalliert werden soll.
uAuf [Entfernen...] klicken.
wDas gewählte Package wird deinstalliert.
uAuf [Schließen] klicken, um den Package Manager zu beenden.
5.2.3 rpm-Package für das ecomatDisplay
5.2.3.1 Speicherbelegung
Durch das rpm-Package wird folgender Speicher auf dem ecomatDisplay belegt:
• RAM: ca.80MB
• FLASH: ca.15MB
5.2.3.2 ecomatDisplay vorbereiten
uNetzwerkeinstellungen des ecomatDisplays über das Setup-Menü einstellen. Ò
Programmierhandbuch ecomatDisplay
uPC per Netzwerk mit dem ecomatDisplay verbinden.
uAuf dem PC: Kommandozeilen-Befehl in der Windows PowerShell ausführen, um das rpm-
Package in das Verzeichnis /home/root/ des ecomatDisplays zu kopieren:
scp -r .\maintenance-sdk-x.x.xx.x-rx.aarch64.rpm root@IP:/home/root
IP: IP-Adresse des ecomatDisplays
5.2.3.3 rpm-Package auf dem ecomatDisplay installieren
ACHTUNG
Installieren des rpm-Packages im laufenden Betrieb
wZerstörung des Geräts möglich
uDas rpm-Package nicht im laufenden Betrieb installieren.
uDas rpm-Package nur während der Entwicklung installieren.
uEmpfehlung: Die Software auf dem Gerät mit Hilfe der Backup/Restore-Funktion auf
andere Geräte übertragen (Software-Rollout).
uMit einem SSH-Client (z.B. putty ) auf dem ecomatDisplay anmelden:
Benutzer: root
Standard-Passwort: pdm3
uKommandozeilen-Befehl in putty ausführen, um das Verzeichnis zu wechseln:
cd /home/root/
uKommandozeilen-Befehl in putty ausführen, um die Installation zu starten:
dnf install maintenance-sdk-x.x.xx.x-rx.aarch64.rpm
wInformationen zum zu installierenden rpm-Package werden angezeigt.
wAbfrage Is this ok [y/N] erscheint.
uMit der Eingabe y (= Ja) bestätigen.
wDas rpm-Package wird installiert.
wNach erfolgreicher Installation erscheint die Meldung: Complete!
uDas ecomatDisplay neu starten.
CP9031
15
wDie Installation ist abgeschlossen.
Upgrade des rpm-Packages
uMit einem SSH-Client (z.B. putty ) auf dem ecomatDisplay anmelden:
Benutzer: root
Standard-Passwort: pdm3
uKommandozeilen-Befehl in putty ausführen, um das Verzeichnis zu wechseln:
cd /home/root/
uKommandozeilen-Befehl in putty ausführen, um das Upgrade zu starten:
dnf upgrade maintenance-sdk-x.x.xx.x-rx.aarch64.rpm
Löschen des rpm-Packages
uMit einem SSH-Client (z.B. putty ) auf dem ecomatDisplay anmelden:
Benutzer: root
Standard-Passwort: pdm3
uKommandozeilen-Befehl in putty ausführen, um das Verzeichnis zu wechseln:
cd /home/root/
uKommandozeilen-Befehl in putty ausführen, um das rpm-Package zu löschen:
dnf remove maintenance-sdk
uPackage ohne Version und Architecture angeben.
Prüfen des installierten rpm-Packages
uMit einem SSH-Client (z.B. putty ) auf dem ecomatDisplay anmelden:
Benutzer: root
Standard-Passwort: pdm3
uKommandozeilen-Befehl in putty ausführen, um das Verzeichnis zu wechseln:
cd /home/root/
uKommandozeilen-Befehl in putty ausführen, um das auf dem Gerät installierte Package zu prüfen
(Installation und Version):
dnf list grep maintenance-sdk
uPackage ohne Version und Architecture angeben.
wDas rpm-Package wird mit Angabe der Version angezeigt.
ODER
uKommandozeilen-Befehl in putty ausführen, um alle auf dem Gerät installierte Pakete mit dem
Namen zu prüfen (Installation und Version):
dnf list maintenance-sdk
uPackage ohne Version und Architecture angeben.
wAlle rpm-Packages mit dem Namen werden mit Angabe der Version angezeigt.
5.2.3.4 Software auf andere ecomatDisplays übertragen
Zum Übertragen der Software eines fertig installierten und konfigurierten ecomatDisplays:
uDie Software auf dem Gerät mit Hilfe der Backup/Restore-Funktion auf andere Geräte
übertragen (Software-Rollout).
Ò Programmierhandbuch ecomatDisplay, Kapitel Backup: Datensicherung erstellen
Ò ecomatDisplay_BackupRetoreGuide_vx.x.pdf aus dem ecomatDisplay-Softwarepaket.
CP9031
16
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.
uNeues Projekt mit ecomatDisplay erstellen.
ODER:
uExistierendes Projekt mit ecomatDisplay öffnen.
uIm Gerätebaum: Doppelklick auf [Applikation] > [Bibliotheksverwalter]
wEditorfenster zeigt Bibliotheksverwalter der Applikation.
wBibliotheksverwalter zeigt installierte Bibliotheken.
uIm Bibliotheksverwalter: Auf [Bibliothek hinzufügen] klicken.
wDialogfenster erscheint.
uIn Baumansicht: [Target] > [ifm_CRxxxx] > [ifmSDKutil] wählen.
uAuf [OK] klicken, um die Auswahl zu bestätigen.
wCODESYS bindet die gewählte Bibliothek in die Applikation ein.
wFunktionen der Bibliothek können bei der Programmierung genutzt werden.
5.4 Beispiel-Applikation auf das ecomatDisplay laden
uDie Beispiel-Applikation oder das Template-Projekt in CODESYS öffnen und kompilieren.
uDie Applikation auf das ecomatDisplay laden.
uDie Applikation auf dem ecomatDisplay starten.
5.5 ecomatController vorbereiten
uProgrammierhandbuch und Originalbetriebsanleitung des ecomatControllers beachten.
uBenutzereinstellungen und die zugeordneten Benutzerlevel und die zugehörigen Passwörter des
ecomatControllers müssen bekannt sein.
uNetzwerkeinstellungen des ecomatControllers einstellen. Ò Programmierhandbuch
ecomatController
CP9031
17
6 Programmierung
6.1 Bibliotheksfunktionen nutzen
Folgende Funktionselemente stehen zur Verfügung:
Funktionsbaustein Beschreibung Referenz
PingDevice Verbindung zwischen Dialoggerät und
einer Steuerung testen
PingDevice (Ò/21)
GetSysInfo Systeminformationen eines Geräts lesen GetSysInfo (Ò/23)
Command Betriebsmodus des Geräts steuern Command (Ò/25)
ReadFromController Firmware, Anwendung und Daten eines
Geräts lesen und in einer Datei spei-
chern
ReadFromController (Ò/27)
GetSegmentListFromFile Liste der verfügbaren Software-Segmen-
te aus einer Datei lesen
GetSegmentListFromFile (Ò/30)
SelectSegmentFromList Software-Segment aus einer gelesenen
Liste wählen
SelectSegmentFromList (Ò/32)
WriteToController Firmware, Anwendung und Daten aus
einer Datei lesen und auf einem Gerät
speichern
WriteToController (Ò/34)
WriteInterfaceSettings Knoten-ID und CAN-Baudrate des Ziel-
geräts (Basic, R360) ändern.
WriteInterfaceSettings (Ò/37)
Authentication Anmelden und Abmelden an der Steue-
rung mit den eingestellten Benutzerda-
ten
Authentication (Ò/40)
GetSdkInterfaces Sucht nach Schnittstellen auf dem Cli-
entsystem (ecomatDisplay) und ruft eine
Liste der verfügbaren Kommunikations-
schnittstellen ab
GetSdkInterfaces (Ò/43)
GetSysInfo_ecomatController Systeminformationen aus dem eco-
matController auslesen.
GetSysInfo_ecomatController (Ò/45)
Command_ecomatController Betriebsmodus des ecomatControllers
steuern
Command_ecomatController (Ò/47)
ReadPackageFrom_ecomatController Package aus dem ecomatController
auslesen
ReadPackageFrom_ecomatController
(Ò/50)
UpdateFirmware_ecomatController Firmware-Update auf den ecomatCont-
roller aufspielen
UpdateFirmware_ecomatController
(Ò/53)
WritePackageTo_ecomatController Package auf den ecomatController
schreiben
WritePackageTo_ecomatController
(Ò/56)
ReadIOSettings_ecomatController EA-Konfiguration aus dem ecomatCont-
roller auslesen.
ReadIOSettings_ecomatController
(Ò/59)
WriteIOSettings_ecomatController EA-Konfiguration auf den ecomatCont-
roller schreiben
WriteIOSettings_ecomatController
(Ò/61)
ReadInterfaceSettings_ecomatController Schnittstellenkonfiguration aus dem eco-
matController auslesen
ReadInterfaceSettings_ecomatController
(Ò/63)
WriteInterfaceSettings_ecomatController Schnittstellenkonfiguration auf den eco-
matController schreiben
WriteInterfaceSettings_ecomatController
(Ò/65)
GetDataFileList_ecomatController Gibt die Liste aller Dateien zurück, die
sich im Ordner /data des ecomatControl-
lers befinden.
GetDataFileList_ecomatController
(Ò/67)
ReadDataFiles_ecomatController Liest eine oder mehrere Benutzerdatei-
en, die sich im Ordner /data des eco-
matControllers befinden und speichert
sie in einem Zielpfad als zip-Datei
ReadDataFiles_ecomatController
(Ò/69)
CP9031
18
Funktionsbaustein Beschreibung Referenz
WriteDataFiles_ecomatController Schreibt aus einer zip-Datei eine oder
mehrere Benutzerdateien in den Ord-
ner /data des ecomatController
WriteDataFiles_ecomatController
(Ò/72)
ReadDeviceLogs_ecomatController Liest Logging-Daten aus dem eco-
matController aus.
ReadDeviceLogs_ecomatController
(Ò/75)
ReadSegmentFrom_ecomatController Liest ein oder mehrere Softwareseg-
mente und Benutzerdateien aus dem
ecomatController und speichert sie in ei-
ner zip-Datei
ReadSegmentFrom_ecomatController
(Ò/77)
WriteSegmentTo_ecomatController Schreibt ein oder mehrere Softwareseg-
mente und Benutzerdateien aus einer
zip-Datei in den ecomatController
WriteSegmentTo_ecomatController
(Ò/80)
SetPasswords_ecomatController Schreibt die Passwortdatei in den eco-
matController.
SetPasswords_ecomatController
(Ò/84)
CP9031
19
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.
Eigenschaften der Bibliothek
Feld Inhalt
Company: ifm electronic
Title: ifmSDKutil_ecomatDisplay
Version: Gemäß ifm-Versionierungsrichtlinien, z.B.: 1.2.3.4
Categories: Target|ifm_CRnnnn|MaintenanceSDK
Namespace: ifmSDKutil
Author: ifm electronic
Placeholder: ifmSDKutil
7.1.1 Verhaltensmodell der ifm-Funktionsbausteine
Dieses Kapitel beschreibt die Verhaltensmodelle der Funktionsbausteine aus der Bibliothek
ifmSDKutil_ecomatDisplay.
CP9031
20
7.1.1.1 Allgemein
Die ifm-Funktionsbausteine besitzen standardmäßig folgende Ausgänge für die Rückgabe von Status-
und Fehlerinformationen:
Ausgang Beschreibung
xError TRUE Es ist ein Fehler aufgetreten.
FALSE 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.
Sie besitzen in Abhängigkeit der Meldeart eins der folgenden Präfixe :
Präfix Art der Meldung Beschreibung
STAT Zustandsmeldung Statusmeldungen beinhalten Informationen über den Zustand des Funktionsbausteins
während des normalen Ablaufes.
DIAG Diagnosemeldung Diagnosemeldungen beinhalten Informationen zu einem Fehlerereignis. Sie setzen sich
nach Verschwinden des Fehlerereignisses von selbst zurück und können optional durch
die Applikation ausgewertet werden.
ERR Fehlermeldung Fehlermeldungen beinhalten Informationen zu einem Fehlerereignis. Sie müssen nach
Verschwinden des Fehlereereignisses in der Applikation zurückgesetzt werden.
Beispiele für Meldungen / Diagnose-Codes:
• STAT_INACTIVE
• DIAG_OPEN_CIRCUIT
• ERR_OVERVOLTAGE
Auflistungen der Diagnose-Codes sind Teil der Bausteinbeschreibungen: ifm-
Funktionsbibliotheken (Ò/19)
7.1.1.2 Verhaltensmodell EXECUTE
Funktionsbausteine, die das Verhaltensmodell EXECUTE besitzen, werden nach einer steigenden
Flanke am Eingang xExecute einmalig abgearbeitet.
Das Signal an xExecute muss solange auf TRUE gesetzt bleiben, bis xDone = TRUE oder
xError=TRUE wird. Wird das Signal an xExecute vorher FALSE, wird die Bausteinbearbeitung ohne
Ergebnis abgebrochen.
Neue Eingabewerte werden erst dann für die Berechnung mit steigender Flanke übernommen, wenn
die aktuell ausgeführte Aktion abgeschlossen oder abgebrochen wurde.
Hat der Funktionsbaustein seine Funktion erfolgreich ausgeführt, wird der Ausgang xDone für einen
Zyklus auf TRUE gesetzt.
Reaktion auf Fehler
Im Fehlerfall wird xError auf TRUE gesetzt und eDiagInfo zeigt den Fehlerstatus an, solange xExecute
= TRUE ist.
Der Ausgang xDone wird auf FALSE gesetzt, da die Ausführung nicht fehlerfrei beendet werden
konnte.
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
Seite laden ...
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104

IFM CP9031 Bedienungsanleitung

IFM
Marke
IFM
Modell
CP9031
Typ
Bedienungsanleitung
PDF Herunterladen
Bericht

Verwandte Papiere

Sonstige Unterlagen