IFM CP9031 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

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 wird geladen ...

IFM CP9031 Bedienungsanleitung

IFM CP9031 Bedienungsanleitung

Verwandte Artikel

Andere Dokumente