IFM AE3100 Bedienungsanleitung

Programmierhandbuch

IIoT Controller

CabinetLine

AE3100

11530969 / 0004 / 2023

DE

AE3100 IIoT Controller

2

Inhaltsverzeichnis

1 Vorbemerkung .............................................................. 9

1.1 Rechtliche Hinweise..................................................... 9

1.2 Verwendete Symbole .................................................... 9

1.3 Warnhinweise.......................................................... 9

1.4 Sicherheitssymbol auf dem Gerät........................................... 10

1.5 Mitgeltende Dokumente .................................................. 10

2 Installation.................................................................. 11

2.1 Systemvoraussetzungen.................................................. 11

2.1.1 Hardware ......................................................... 11

2.1.2 Software.......................................................... 11

2.1.3 Lizensierung....................................................... 11

2.2 CODESYS Development System........................................... 11

2.2.1 CODESYS installieren ............................................... 11

2.3 CODESYS-Package..................................................... 12

2.3.1 Überblick.......................................................... 12

2.3.2 CODESYS-Package installieren........................................ 12

2.3.3 CODESYS-Package deinstallieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3 Erste Schritte ............................................................... 14

3.1 CODESYS starten....................................................... 14

3.2 Projektvorlagen nutzen................................................... 14

3.3 CODESYS-Projekt erstellen............................................... 14

3.4 Projektstruktur.......................................................... 15

4 Systemkonfiguration.......................................................... 16

4.1 Speicherprogrammierbare Steuerung (SPS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.1.1 SPS des Geräts konfigurieren.......................................... 16

4.1.2 Kommunikationspfad zur SPS setzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.1.3 IODDs installieren................................................... 17

4.2 Ethernet .............................................................. 18

4.2.1 Ethernet-Schnittstellen parametrieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.2.2 Ethernet-Adapter hinzufügen .......................................... 18

4.2.2.1 Ethernet-Adapter einer Ethernet-Schnittstelle zuweisen . . . . . . . . . . . . . . . . . 19

4.2.3 Feldbus-Erweiterungen nutzen......................................... 19

4.2.3.1 EtherCAT Master .............................................. 19

4.2.3.2 Modbus TCP Master............................................ 21

4.2.3.3 Modbus TCP Slave............................................. 22

4.2.3.4 EtherNet/IP Scanner............................................ 23

4.2.3.5 EtherNet/IP Adapter............................................ 25

4.2.3.6 PROFINET IO Master........................................... 26

4.3 Task-Konfiguration...................................................... 28

4.3.1 Task-Konfiguration einstellen .......................................... 28

4.4 Projekt absichern ....................................................... 28

5 Programmierung............................................................. 30

5.1 Objekte der Applikation................................................... 30

5.2 Applikation erstellen..................................................... 30

5.2.1 Hinweise zur Programmierung ......................................... 30

5.2.1.1 ifm-Funktionsbibliotheken nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.2.1.2 Unterstützte Programmiersprachen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.2.1.3 PLC_PRG (PRG) in FUP und ST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

5.2.1.4 Unterstützte Variablentypen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

5.2.1.5 Verfügbarer Speicher ........................................... 32

5.2.2 Hinweise zum ifm IoT-Core............................................ 32

5.3 Prozessdaten sammeln................................................... 34

5.3.1 Daten über IoT-Core Geräte sammeln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

5.3.1.1 IoT-Core-Funktionalität aktivieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

5.3.1.2 IoT-Core-Geräte onboarden...................................... 35

5.3.1.3 IoT-Core-Geräte verwalten....................................... 36

5.3.1.4 IoT-Core-Geräte offboarden...................................... 36

5.3.2 Daten aus der Feldbus-Ebene sammeln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

IIoT Controller AE3100

3

5.3.2.1 Beispiel: IIoT Controller > AL1304 > TCC501 . . . . . . . . . . . . . . . . . . . . . . . . . 38

5.3.2.2 Beispiel: IIoT Controller > AL1330 > TCC501 . . . . . . . . . . . . . . . . . . . . . . . . . 38

5.3.2.3 Beispiel: IIoT Controller > AL1324 > TCC501 . . . . . . . . . . . . . . . . . . . . . . . . . 38

5.3.2.4 Beispiel: IIoT Controller > AL1340 > TCC501 . . . . . . . . . . . . . . . . . . . . . . . . . 39

5.3.3 Datenpunkte nutzen ................................................. 40

5.3.3.1 Datenpunkte erzeugen.......................................... 40

5.3.3.2 Datenpunkte lesen ............................................. 40

5.3.3.3 Datenpunkte schreiben.......................................... 40

5.3.3.4 Datenpunkte kennzeichnen....................................... 41

5.3.3.5 Datenpunkte löschen ........................................... 41

5.4 Daten verarbeiten....................................................... 42

5.4.1 CSV-Dateien verarbeiten ............................................. 42

5.4.2 Hilfsfunktionen nutzen................................................ 42

5.4.3 Dateien verarbeiten.................................................. 42

5.5 Daten in die Cloud-Ebene übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

5.5.1 Unterstützte Cloud-Systeme........................................... 44

5.5.2 Firewall konfigurieren ................................................ 44

5.5.3 AWS-Cloud........................................................ 45

5.5.3.1 AWS-Adapter einrichten......................................... 45

5.5.3.2 Verbindung zur AWS-Cloud herstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

5.5.3.3 Daten in die AWS-Cloud übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

5.5.4 AnyViz-Cloud ...................................................... 48

5.5.4.1 AnyViz-Adapter einrichten........................................ 48

5.5.4.2 Verbindung zur AnyViz-Cloud herstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.5.4.3 Daten in die AnyViz-Cloud übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.5.5 Azure-Cloud....................................................... 50

5.5.5.1 Azure-Adapter einrichten ........................................ 50

5.5.5.2 Verbindung zur Azure-Cloud herstellen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.5.5.3 Daten in die Azure-Cloud übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.6 OPC-UA nutzen ........................................................ 53

5.6.1 CODESYS OPC UA Server nutzen...................................... 53

5.6.2 ifm IoT-Core OPC UA Server nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.6.2.1 OPC UA Server aktivieren........................................ 53

5.6.2.2 Verbindung mit OPC UA Client herstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.7 Gerätespezifische Funktionen nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

5.7.1 Gerät steuern ...................................................... 55

5.7.2 IP-Einstellungen ändern.............................................. 55

5.7.3 Temperatur und Spannungen überwachen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

5.7.4 Status-LED steuern.................................................. 55

5.7.5 Externe Speicher verwalten ........................................... 55

5.7.6 Linux-Systembefehle aufrufen.......................................... 56

5.7.7 Systeminformationen lesen............................................ 56

5.7.8 Systemzeit lesen und ändern .......................................... 56

5.8 Visualisierungen nutzen .................................................. 57

5.8.1 Unterstützte Visualisierungstypen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.8.2 Aufgabe der Visualisierung............................................ 57

5.8.3 Visualisierung zu einem Projekt hinzufügen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.8.3.1 Überblick: Elemente einer Visualisierung . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.8.4 Visualisierung erstellen............................................... 58

5.8.5 Eigenschaften der Web-Visualisierung einstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6 Betrieb .................................................................... 60

6.1 CODESYS-Projekt auf das Gerät übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

6.1.1 Applikation auf Gerät laden............................................ 60

6.1.2 Applikation vom Gerät löschen......................................... 60

6.2 Betriebszustände der Applikation........................................... 61

6.2.1 Betriebszustand der Applikation anzeigen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

6.2.2 Applikation starten .................................................. 61

6.2.3 Applikation stoppen.................................................. 61

6.3 Reset-Verhalten ........................................................ 62

6.3.1 Unterstützte Reset-Varianten .......................................... 62

6.3.2 Applikation zurücksetzen (warm). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

AE3100 IIoT Controller

4

6.3.3 Applikation zurücksetzen (kalt)......................................... 63

6.3.4 Applikation zurücksetzen (Ursprung). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

7 ifm-Funktionsbibliotheken...................................................... 64

7.1 Bibliothek ifm_edgeController_CabinetLine_Cnt.library. . . . . . . . . . . . . . . . . . . . . . . . . . . 64

7.2 Bibliothek ifmDevice_edgeController_CabinetLine.library . . . . . . . . . . . . . . . . . . . . . . . . . 65

7.2.1 Common.......................................................... 65

7.2.1.1 BootIntoRecovery.............................................. 65

7.2.1.2 ShutdownDevice............................................... 67

7.2.2 Ethernet .......................................................... 68

7.2.2.1 GetEthernetBridgeConfig2 ....................................... 68

7.2.2.2 GetIPsettings ................................................. 70

7.2.2.3 SetEthernetBridgeConfig2........................................ 72

7.2.2.4 SetIPsettings.................................................. 76

7.2.3 Local IO .......................................................... 78

7.2.3.1 GetTemperatures.............................................. 78

7.2.3.2 GetTemperaturesCyclic ......................................... 80

7.2.3.3 GetVoltages2 ................................................. 81

7.2.3.4 GetVoltagesCyclic2............................................. 83

7.2.4 Status LED........................................................ 84

7.2.4.1 GetAvailableStatusLEDs......................................... 84

7.2.4.2 GetStatusLEDstate............................................. 86

7.2.4.3 SetStatusLEDstate............................................. 88

7.2.5 Storage........................................................... 90

7.2.5.1 StorageDeviceHandler .......................................... 90

7.2.5.2 StorageDeviceHandlerMulti....................................... 92

7.2.6 System Commands.................................................. 94

7.2.6.1 LinuxSysCallAsync............................................. 94

7.2.6.2 LinuxSysCallAsync2............................................ 96

7.2.6.3 LinuxSysCallSync.............................................. 98

7.2.6.4 LinuxSysCallSync2.............................................100

7.2.7 System Info........................................................102

7.2.7.1 GetSysInfo2 ..................................................102

7.2.8 System Time.......................................................104

7.2.8.1 GetAvailableTimesZones ........................................104

7.2.8.2 GetNTP_Settings ..............................................106

7.2.8.3 GetSysTime ..................................................108

7.2.8.4 GetSysTimeCyclic..............................................110

7.2.8.5 SetNTP_Settings2..............................................112

7.2.8.6 SetSysTime...................................................114

7.2.8.7 SetTimeZone .................................................116

7.2.9 Aufzählungstypen (ENUM)............................................118

7.2.9.1 eBRIDGE_INTERFACES (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118

7.2.9.2 eETHERNET_INTERFACES (ENUM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118

7.2.9.3 eDAY_OF_WEEK (ENUM).......................................118

7.2.9.4 eSTATUS_LEDs (ENUM)........................................118

7.2.10 Strukturen (STRUCT)................................................119

7.2.10.1 stDATE_TIME (STRUCT)........................................119

7.2.10.2 stETHERNET_BRIDGE_CONFIG (STRUCT). . . . . . . . . . . . . . . . . . . . . . . . .119

7.2.10.3 stIPV4SETTING (STRUCT) ......................................119

7.2.10.4 stLOCAL_IO (STRUCT).........................................119

7.2.10.5 stNTP_SETTINGS .............................................119

7.2.10.6 stSTORAGE_DEVICE_INFO (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

7.2.10.7 stSYSTEM_TEMPERATURES (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . .120

7.2.10.8 stSYSTEM_VOLTAGES2 (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

7.2.10.9 stSYS_INFO_BASIC2 (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

7.2.10.10 stSYS_INFO_EXTENDED2 (STRUCT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

7.2.10.11 stSYS_INFO_INTERNAL2 (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121

7.2.11 Typen (ALIAS) .....................................................122

7.2.11.1 aETH_ITF_LIST (ALIAS).........................................122

7.2.11.2 aSTATUS_LED_LIST (ALIAS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

7.2.11.3 aSTORAGE_DEVICE_INFO_LIST (ALIAS) . . . . . . . . . . . . . . . . . . . . . . . . . .122

IIoT Controller AE3100

5

7.2.11.4 aTIME_ZONE_LIST (ALIAS)......................................122

7.2.12 Globale Konstanten (GC).............................................123

7.2.12.1 GCL_Data (GVL) ..............................................123

7.2.12.2 GCL_RG_COLOUR (GVL).......................................123

7.2.13 Globale Variablen (GV)...............................................124

7.2.13.1 GVL_Data....................................................124

7.3 Bibliothek ifmFileUtil_edgeController_CabinetLine.library . . . . . . . . . . . . . . . . . . . . . . . . .125

7.3.1 Generic File........................................................125

7.3.1.1 Copy_Device_To_StorageDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

7.3.1.2 Copy_StorageDevice_To_Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

7.3.1.3 DeleteFile....................................................129

7.3.1.4 FileCopy.....................................................131

7.3.1.5 SyncFileMemory...............................................133

7.3.2 Log File...........................................................135

7.3.2.1 ReadCSV8Byte................................................135

7.3.2.2 ReadCSVData ................................................137

7.3.2.3 WriteCSV8Byte................................................139

7.3.2.4 WriteCSV8ByteHeader..........................................142

7.3.2.5 WriteCSVData_Linear...........................................144

7.3.2.6 WriteCSVData_Ring............................................147

7.3.2.7 WriteCSVHeader ..............................................150

7.3.3 Parameter File .....................................................152

7.3.3.1 WriteParmSingleAsync..........................................152

7.3.3.2 ReadParmSingleAsync..........................................154

7.3.4 Support...........................................................156

7.3.4.1 Buffer_To_String...............................................156

7.3.4.2 GetFileSizeAsync..............................................158

7.3.5 Functions .........................................................160

7.3.5.1 ANY_TYPE_TO_STRING........................................160

7.3.5.2 ByteArray_To_String............................................161

7.3.5.3 DW_To_4Byte.................................................162

7.3.5.4 ifmCONCAT..................................................163

7.3.5.5 ifmFIND......................................................164

7.3.5.6 ifmMID ......................................................165

7.3.5.7 Pack2Byte_To_Word ...........................................166

7.3.5.8 Pack4Byte_To_DW.............................................167

7.3.5.9 RTC_TO_STRING .............................................168

7.3.5.10 VALIDATE_FILE_NAME.........................................169

7.3.5.11 Word_To_2Byte ...............................................170

7.3.5.12 _8Byte_To_CSV...............................................170

7.3.6 Aufzählungstypen (ENUM)............................................172

7.3.6.1 eCSV_MODE (ENUM) ..........................................172

7.3.7 Strukturen (STRUCT)................................................173

7.3.7.1 stCSV_HEADER (STRUCT)......................................173

7.3.7.2 stLOG_DATA (STRUCT) ........................................173

7.3.7.3 stLOG_FILE_CONFIG (STRUCT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173

7.3.7.4 stSEPARATOR_CONFIG (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173

7.3.8 Globale Konstanten (GC).............................................175

7.3.8.1 ifmGCL (GVL).................................................175

7.4 Bibliothek ifmiot.library ...................................................176

7.4.1 EnableIFMIoT......................................................176

7.4.2 IoT Additional functions...............................................178

7.4.2.1 ActivateOPC..................................................178

7.4.2.2 ExecuteScan..................................................181

7.4.2.3 GetAddressesByProfile..........................................184

7.4.2.4 TagProfiles...................................................187

7.4.3 IoT Device functions.................................................190

7.4.3.1 CheckBoardingState............................................190

7.4.3.2 CheckOnlineState..............................................193

7.4.3.3 GetEthernetAdapter ............................................196

7.4.3.4 GetSensor....................................................199

7.4.3.5 IODDExtend..................................................202

AE3100 IIoT Controller

6

7.4.3.6 OffboardDevice................................................204

7.4.3.7 OnboardDevice................................................206

7.4.3.8 OnboardDeviceWithIODDExtend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208

7.4.4 IoT Help functions...................................................211

7.4.4.1 GetJSONValByKey.............................................211

7.4.5 IoTCore Node functions ..............................................213

7.4.5.1 AddNode.....................................................213

7.4.5.2 AddNode_Polling ..............................................216

7.4.5.3 GetData .....................................................219

7.4.5.4 GetDataMulti..................................................222

7.4.5.5 GetData_Polling...............................................225

7.4.5.6 ReadDataFromIoTCore..........................................228

7.4.5.7 RemoveNode.................................................231

7.4.5.8 SetDataOfIoTNode.............................................233

7.4.5.9 SetDataOfIoTNode_Polling.......................................236

7.4.6 Aufzählungstypen (ENUM)............................................238

7.4.6.1 e_Datatype (ENUM)............................................238

7.4.6.2 IoTDeviceBoardStatus (ENUM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238

7.4.6.3 IoTDeviceConStatus (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238

7.4.7 Strukturen (STRUCT)................................................239

7.4.7.1 IoTDatapoint (STRUCT).........................................239

7.4.7.2 IoTDevice (STRUCT) ...........................................239

7.4.7.3 IoTSensor (STRUCT)...........................................239

7.4.8 Globale Konstanten (GC).............................................240

7.4.8.1 GVL_IoTConst (GVL)...........................................240

7.5 Bibliothek ifmIOLink.library................................................241

7.5.1 AcyclicModbus (FB) .................................................241

7.5.2 ClearAlarmHistory (FB)...............................................243

7.5.3 Cyclic (FB) ........................................................244

7.5.4 CyclicModbus (FB)..................................................245

7.5.5 EIPAcyclicRead (FB).................................................246

7.5.6 EIPAcyclicWrite (FB).................................................248

7.5.7 LaunchSetUp (FB) ..................................................250

7.5.8 IO-Link Devices.....................................................251

7.5.8.1 AL240x......................................................251

7.5.8.2 AL241x......................................................253

7.5.8.3 AL2x05......................................................255

7.5.8.4 AL2x25_AL2x21...............................................260

7.5.8.5 AL2x3x......................................................264

7.5.8.6 AL2x4x......................................................267

7.5.8.7 AL_DO......................................................270

7.5.8.8 DF2101......................................................271

7.5.8.9 DP1213......................................................275

7.5.8.10 DP1222......................................................276

7.5.8.11 DP1223......................................................277

7.5.8.12 DP2200......................................................278

7.5.8.13 DTI_AutoRdWr................................................279

7.5.8.14 DV21_RGB...................................................281

7.5.8.15 DV25_Analog.................................................283

7.5.8.16 DV25_RGB...................................................285

7.5.8.17 E30391......................................................287

7.5.8.18 IF_IG_II_IM...................................................289

7.5.8.19 KG6_KI......................................................290

7.5.8.20 KT6.........................................................291

7.5.8.21 LDL.........................................................293

7.5.8.22 LK..........................................................294

7.5.8.23 LMC ........................................................295

7.5.8.24 LMC502 .....................................................296

7.5.8.25 LMT ........................................................297

7.5.8.26 LR2.........................................................298

7.5.8.27 LR3.........................................................299

7.5.8.28 LR7.........................................................300

IIoT Controller AE3100

7

7.5.8.29 LR8.........................................................301

7.5.8.30 LR9020......................................................303

7.5.8.31 LRxx2x......................................................304

7.5.8.32 LT30........................................................305

7.5.8.33 LT80........................................................306

7.5.8.34 MVQ1.......................................................308

7.5.8.35 MVQ2.......................................................309

7.5.8.36 O1D_OGD ...................................................311

7.5.8.37 O5D_OID ....................................................312

7.5.8.38 O6_O8 ......................................................313

7.5.8.39 OGH........................................................314

7.5.8.40 OPD........................................................315

7.5.8.41 OPL ........................................................316

7.5.8.42 PM .........................................................317

7.5.8.43 PN_PI.......................................................318

7.5.8.44 PP..........................................................320

7.5.8.45 PQ .........................................................321

7.5.8.46 PV..........................................................322

7.5.8.47 RA_RB_RU_RV...............................................323

7.5.8.48 RMx3xx......................................................324

7.5.8.49 RxP5xx......................................................326

7.5.8.50 SA..........................................................327

7.5.8.51 SB..........................................................329

7.5.8.52 SDx501_SDx601 ..............................................331

7.5.8.53 SMxx2x......................................................333

7.5.8.54 SM_SD......................................................335

7.5.8.55 SV..........................................................337

7.5.8.56 TAD ........................................................339

7.5.8.57 TCC ........................................................340

7.5.8.58 TD_TA_TP...................................................341

7.5.8.59 TN_TR ......................................................342

7.5.8.60 TV..........................................................343

7.5.8.61 TW .........................................................344

7.5.8.62 UGT_UIT ....................................................345

7.5.8.63 VVB ........................................................346

7.5.8.64 EX260_SIL1_X210.............................................348

7.5.8.65 VEGAPOINT21................................................351

7.5.9 Aufzählungstypen (ENUM)............................................352

7.5.9.1 DUT_PDSize (ENUM)...........................................352

7.5.9.2 DUT_Ports (ENUM) ............................................352

7.5.9.3 DUT_Errors (ENUM)............................................352

7.5.9.4 DUT_KeyIndication (ENUM)......................................352

7.5.9.5 ERRCODE (ENUM) ............................................353

7.5.9.6 ERRCODE_EXTD (ENUM).......................................353

7.5.9.7 ERRCMD (ENUM) .............................................354

7.5.9.8 ERROR_ADDITIONAL (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354

7.5.10 Strukturen (STRUCT)................................................355

7.5.10.1 ST_REQUEST (STRUCT) .......................................355

7.5.10.2 ST_RESPONSE (STRUCT)......................................355

7.5.10.3 ST_AUTOPDI (STRUCT)........................................356

7.5.10.4 ST_AUTOPDO (STRUCT).......................................356

7.5.10.5 ST_IOLevent (STRUCT).........................................356

7.5.10.6 ST_PORT (STRUCT)...........................................356

7.5.10.7 ST_Status (STRUCT)...........................................357

7.6 Bibliothek ifmTypes_edgeController_CabinetLine.library . . . . . . . . . . . . . . . . . . . . . . . . .359

7.6.1 Aufzählungstypen (ENUM)............................................359

7.6.1.1 eDIAG_INFO (ENUM)...........................................359

7.7 Wrapper-Funktionsbausteine ..............................................361

7.7.1 AzureCloudConnector................................................361

7.7.2 AzureSendIoTData..................................................363

7.7.3 AWSCloudConnector ................................................364

7.7.4 AWSSendIoTData...................................................366

AE3100 IIoT Controller

8

7.7.5 AnyVizCloudConnector...............................................368

7.7.6 AnyVizSendIoTData.................................................370

7.7.7 Clouds (ENUM).....................................................371

7.7.8 eDIAG_INFO_Cloud (ENUM)..........................................372

IIoT Controller AE3100

9

1 Vorbemerkung

Anleitung, technische Daten, Zulassungen und weitere Informationen über den QR-Code auf dem

Gerät / auf der Verpackung oder über documentation.ifm.com.

1.1 Rechtliche Hinweise

auszugsweise, nur mit Zustimmung der ifm electronic gmbh.

Alle auf unseren Seiten verwendeten Produktnamen, Bilder, Unternehmen oder sonstige Marken sind

Eigentum der jeweiligen Rechteinhaber.

1.2 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

1.3 Warnhinweise

Warnhinweise warnen vor möglichen Personen- und Sachschäden. Dadurch wird der sichere Umgang

mit dem Produkt ermöglicht. Warnhinweise sind wie folgt abgestuft:

WARNUNG

Warnung vor schweren Personenschäden

wTödliche und schwere Verletzungen sind möglich, wenn der Warnhinweis nicht beachtet

wird.

VORSICHT

Warnung vor leichten bis mittelschweren Personenschäden

wLeichte bis mittelschwere Verletzungen sind möglich, wenn der Warnhinweis nicht

beachtet wird.

ACHTUNG

Warnung vor Sachschäden

wSachschäden sind möglich, wenn der Warnhinweis nicht beachtet wird.

AE3100 IIoT Controller

10

1.4 Sicherheitssymbol auf dem Gerät

Sicherheitssymbol auf dem Gerät:

uFür den sicheren Betrieb des Geräts die Betriebsanleitung beachten.

1.5 Mitgeltende Dokumente

• Datenblatt

• Betriebsanleitung

IIoT Controller AE3100

11

2 Installation

2.1 Systemvoraussetzungen

2.1.1 Hardware

• PC für Programmiersystem CODESYS (Hardware-Voraussetzungen: Ò CODESYS-Hilfe)

• IIoT Controller AE3100, Firmware: 0.4.11.0 oder höher

• IO-Link Master DataLine AL13xx / IO-Link Master CabinetLine AL19xx, Firmware: 3.1 oder höher

– IO-Link Device (Sensoren / Aktuatoren)

• SmartSPS DataLine AC14xx, Firmware: 6.1 oder höher

– AS-i Slaves (Sensoren / Aktuatoren)

• Verbindungstechnik

– Ethernet-Verbindungskabel

– Anschlusskabel IO-Link Devices

2.1.2 Software

• CODESYS Development System, Version V3.5 SP16 Patch 5 (64 Bit)

• Package „CODESYS für alle ifm edgeController _64bit Produkte“, Version 2.4.4.0

• Bei Einsatz des Cloud-Systems Microsoft Azure: Azure IoT Explorer, https://github.com/Azure/

azure-iot-explorer/releases

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:

documentation.ifm.com

2.1.3 Lizensierung

Mit dem Kauf des Geräts erwirbt der Anwender gleichzeitig eine gültige Lizenz für die Nutzung des

Packages „CODESYS für alle ifm edgeController _64bit Produkte“.

Lizenzinformationen: Ò Installationsroutine oder Produktseite des Artikels auf der ifm-Webseite.

2.2 CODESYS Development System

Das CODESYS Development System (kurz: CODESYS) ist eine Entwicklungsumgebung für die

Erstellung von SPS-Applikationen gemäß Norm IEC 61131-3.

2.2.1 CODESYS installieren

uHinweise zur Installation beachten: Ò Anwenderdokumentation „CODESYS Installation und

Erste Schritte“

Um die Software CODESYS Development System zu installieren:

Voraussetzungen:

üPC / Laptop erfüllt die Installationsvoraussetzungen für CODESYS Development System.

AE3100 IIoT Controller

12

uCODESYS Development System V3.5 SP16 Patch 5 (64 Bit) herunterladen.

uCODESYS V3.5 SP16 Patch 5 (64 Bit) installieren.

wCODESYS ist auf dem PC/Laptop installiert.

2.3 CODESYS-Package

2.3.1 Überblick

ifm electronic stellt für die Programmierung des Geräts unter CODESYS das Package „CODESYS für

alle ifm edgeController _64bit Produkte“ bereit.

Das Package enthält folgende Komponenten:

• Geräte- und Schnittstellenbeschreibung des Geräts

• Projektvorlagen, Projektbeispiele

• Funktionsbibliotheken für Programmierung der SPS

uDetaillierte Informationen zu den ifm-Funktionsbibliotheken: ifm-Funktionsbibliotheken

(Ò/64)

2.3.2 CODESYS-Package installieren

Um das CODESYS-Package auf dem Programmier-PC/Laptop zu installieren:

Voraussetzungen:

üCODESYS V3.5 SP16 Patch 5 (64 Bit) ist korrekt installiert.

üPackage für V3.5 SP16 Patch 5 (64 Bit) ist korrekt installiert.

üifm-Package ist auf dem PC / Laptop gespeichert.

uCODESYS mit Administratorrechten starten.

wCODESYS-Programmoberfläche erscheint.

u[Tools] > [Package Manager] wählen.

wFenster [Package Manager] erscheint.

uAuf [Installieren…] klicken.

wInstallationsdialog erscheint.

uDatei ifm_edgeControllers_64bit_V2.4.3.0.package wählen und eine komplette Installation

durchführen.

wFenster [Package Manager] zeigt installiertes CODESYS-Package.

uAuf [Schließen] klicken, um den Package Manager zu beenden.

wCODESYS-Package ist installiert.

2.3.3 CODESYS-Package deinstallieren

Um das installierte Package „CODESYS für alle ifm edgeController _64bit Produkte“zu deinstallieren:

uCODESYS mit Administratorrechten starten.

wCODESYS-Programmoberfläche erscheint.

u[Tools] > [Package Manager] wählen.

wFenster [Package Manager] erscheint.

wFenster [Package Manager] zeigt die installierten Packages.

IIoT Controller AE3100

13

uOption [Versionsnummer anzeigen] aktivieren.

wFenster zeigt Versionsnummern der installierten Packages.

uPackage-Version wählen, die deinstalliert werden soll.

uAuf [Entfernen...] klicken.

wCODESYS deinstalliert die gewählte Package-Version.

uAuf [Schließen] klicken, um den Package Manager zu beenden.

wCODESYS-Package ist deinstalliert.

AE3100 IIoT Controller

14

3 Erste Schritte

3.1 CODESYS starten

uMit den grundlegenden Funktionen des CODESYS Development Systems vertraut machen!

uKontextsensitive Hilfe von CODESYS nutzen.

Voraussetzungen:

üNotwendige Software wurde korrekt installiert.

uCODESYS starten.

wCODESYS wird geladen.

wCODESYS-Bedienoberfläche erscheint.

3.2 Projektvorlagen nutzen

ifm stellt für das Gerät mehrere Projektvorlagen (Templates) bereit. Die Vorlagen decken

verschiedene Anwendungsfälle ab. Die Vorlagen enthalten die optimalen Voreinstellungen für das

Zielgerät (Target). Die Vorlagen sind nach der Installation des gerätespezifischen Packages

verfügbar. Der Anwender kann die passende Vorlage während der Projekterstellung wählen.

Verfügbare Projektvorlagen:

Projektvorlage Beschreibung

ifm edgeController CabinetLine, leer Vorlage für minimales Projekt mit einem IIoT Controller CabinetLine

ifm edgeController CabinetLine, Beispiel Any-

viz cloud

Vorlage für Projekt mit IIoT Controller CabinetLine inkl. Anbindung an Anyviz-

Cloud

ifm edgeController CabinetLine, Beispiel AWS

cloud

Vorlage für Projekt mit IIoT Controller CabinetLine inkl. Anbindung an AWS-

Cloud

ifm edgeController CabinetLine, Beispiel Azure

cloud

Vorlage für Projekt mit IIoT Controller CabinetLine inkl. Anbindung an Azure-

Cloud

3.3 CODESYS-Projekt erstellen

Voraussetzungen:

üCODESYS wurde gestartet.

üCODESYS-Package „CODESYS für alle ifm edgeController _64bit Produkte“ wurde korrekt

installiert.

u[Datei] > [Neues Projekt] wählen.

wDialogfenster erscheint.

IIoT Controller AE3100

15

uIn Feld [Kategorien] den Pfad [edgeController] > [CabinetLine] wählen.

wDas Feld [Vorlagen] zeigt die verfügbaren Projektvorlagen für das Gerät, Projektvorlagen

nutzen (Ò/14).

uGewünschte Projektvorlage wählen.

uName des Projekts eingeben und Speicherort wählen.

uAuf [OK] klicken, um das Projekt zu erstellen.

wCODESYS erstellt Projekt mit dem Gerät.

wAlle notwendigen Bibliotheken werden in das Projekt eingebunden.

3.4 Projektstruktur

Ein CODESYS-Projekt enthält alle Komponenten für die Konfiguration, Verwaltung und

Programmierung des Geräts. Die Komponenten eines Projekts sind im Fenster Geräte in einer

Baumstruktur hierarchisch angeordnet. Mithilfe der Projektvorlage erstellte CODESYS-Projekte

besitzen folgende Struktur:

2

3

4

5

1

1: Logischer Wurzelknoten des Geräts; bietet Zugriff auf die

allgemeine Konfigurationseinstellungen

2: Container für die SPS-Applikation

3: SPS-Applikation mit Objekten wie Steuerungslogik und Vi-

sualisierung

4: Container für Kommunikationsschnittstellen

5: Knoten für den Zugriff auf die Parameter der verfügbaren

Kommunikationsschnittstellen

AE3100 IIoT Controller

16

4 Systemkonfiguration

4.1 Speicherprogrammierbare Steuerung (SPS)

4.1.1 SPS des Geräts konfigurieren

Die Konfiguration der SPS des Geräts erfolgt über den Generischen Geräteeditor des

CODESYS-Programmiersystems.

uMit der Benutzeroberfläche und den Funktionen des Generischen Geräteeditor vertraut

machen!

Um die SPS des Geräts zu konfigurieren:

Voraussetzungen:

üProjekt wurde mithilfe der Projektvorlage erstellt.

uIm Gerätebaum: Doppelklick auf Symbol [Device (ifm_edgeController_CabinetLine)]

wGenerischer Geräteditor erscheint.

uSPS des Geräts konfigurieren.

wSPS des Geräts ist konfiguriert.

4.1.2 Kommunikationspfad zur SPS setzen

Um den Kommunikationspfad zwischen CODESYS und der SPS des Geräts einzustellen:

Voraussetzungen:

üCODESYS-PC/Laptop ist mit der Ethernet-Schnittstelle eth2 oder eth3 des Geräts verbunden.

üIP-Parameter der Ethernet-Schnittstellen des Geräts und des PC/Laptop sind korrekt eingestellt.

üGerät ist gestartet.

üCODESYS Runtime ist gestartet (Status-LED SYS leuchtet grün).

üProjekt wurde mithilfe der Projektvorlage erstellt.

uIm Gerätebaum: Doppelklick auf Symbol [Device (ifm_edgeController_CabinetLine)]

wGenerischer Geräteditor erscheint.

uIm Editor: Auf Registerkarte [Kommunikation] klicken.

wDetailfenster zeigt Kommunikationseinstellungen.

uIn Liste [Gateway] das Gateway wählen.

wListe zeigt gewähltes Gateway.

uAuf [Netzwerk durchsuchen…] klicken.

wDialogfenster erscheint.

uGateway wählen und auf [Geräte suchen] klicken.

wCODESYS durchsucht das Netzwerk nach verfügbaren Geräten.

wFenster zeigt Netzwerkpfad und erkannte Geräte.

IIoT Controller AE3100

17

uOptional: Auf [Blinken] klicken, um das Gerät zu lokalisieren.

wStatus-LED APP blinkt gelb (ca. 5s).

uGerät wählen und auf [OK] klicken.

wKommunikationspfad ist gesetzt.

wCODESYS kann Daten auf die geräteinterne SPS übertragen.

4.1.3 IODDs installieren

Damit das Gerät die Prozessdaten sowie die Diagnose- und Statusinformationen der

angeschlossenen IO-Link Devices interpretieren kann, müssen die Gerätebeschreibungen (IO Device

Description - IODD) der IO-Link Sensoren und IO-Link Aktuatoren auf dem Gerät installiert sein.

IODD-Dateien können kostenlos über folgende Webseite heruntergeladen werden: https://

ioddfinder.io-link.com

Auf dem Gerät sind werkseitig die IODDs aller ifm IO-Link Devices gespeichert (Stand: 03/2023).

Voraussetzungen:

üKommunikationspfad zur SPS ist gesetzt.

üIODDs der IO-Link Devices sind auf Computer verfügbar.

uMit CODESYS auf dem Gerät einloggen.

uIm Gerätebaum: Auf Knoten [Device (ifm_edgeController_CabinetLine)] klicken.

wGenerischer Geräteeditor erscheint.

uRegisterkarte [Dateien] wählen.

wDetailansicht zeigt Dateimanager.

uIODDs in folgendes Verzeichnis auf dem Gerät kopieren: /home/cds-apps/iodds

wGerät kann mit den IO-Link Devices kommunizieren.

AE3100 IIoT Controller

18

4.2 Ethernet

Das Gerät verfügt über 4 Ethernet-Schnittstellen.

Werkseinstellungen der Ethernet-Schnittstellen: Ò Betriebsanleitung

4.2.1 Ethernet-Schnittstellen parametrieren

Die Projektvorlagen für Cloud-Anbindungen enthalten die POU [IPSetting (PRG)].

Die POU zeigt anhand eines Beispiels, wie über eine Applikation die Ethernet-Schnittstellen des

Geräts parametriert werden können.

Bei der Aktivierung der automatischen Adressvergabe durch einen DHCP-Server wird die IP-

Routing-Tabelle neu aufgebaut. Eine bestehende Internet-Verbindung wird unterbrochen.

uUm Probleme zu vermeiden, nur bei einem der Ethernet-Ports eth0 oder eth1 die DHCP-

Funktionalität aktivieren.

4.2.2 Ethernet-Adapter hinzufügen

Die Funktionalität der Ethernet-Schnittstellen des Geräts kann erweitert werden, z.B. Feldbus-

Erweiterungen nutzen (Ò/19). Dafür muss dem Gerät im Projekt ein Ethernet-Adapter hinzugefügt

werden.

Voraussetzungen:

üCODESYS wurde gestartet.

üProjekt ist geöffnet.

uIm Gerätebaum: Rechtsklick auf Knoten [Ethernet].

wKontextmenü erscheint.

uMenüpunkt [Gerät anhängen…] wählen.

wDialogfenster erscheint.

uIn Tabelle: Unter [Ethernet Adapter] den Knoten [Ethernet_edgeController] wählen.

uDem Ethernet-Adapter einen eindeutigen Namen geben.

uAuf [Gerät anhängen] klicken.

wCODESYS fügt Ethernet-Adapter zum Projekt hinzu.

IIoT Controller AE3100

19

4.2.2.1 Ethernet-Adapter einer Ethernet-Schnittstelle zuweisen

Die Konfiguration des Ethernet-Adapters erfolgt über den Ethernet-Adapter-Konfigurator von

CODESYS.

Detaillierte Informationen zu Konfigurationsoptionen: help.codesys.com

Um den Ethernet-Adapter einer Ethernet-Schnittstelle des Geräts zuzuweisen:

Voraussetzungen:

üEthernet-Adapter wurde hinzugefügt.

üKommunikationspfad ist gesetzt.

uIn den Online-Modus wechseln.

uIm Gerätebaum: Doppelklick auf Knoten Ethernet-Adapter.

wEditor erscheint.

uNeben Feld [Netzwerkschnittstelle] auf […] klicken.

wDialogfenster erscheint.

uEthernet-Port wählen und bestätigen.

wEthernet-Adapter wird der gewählten Ethernet-Schnittstelle zugewiesen.

wAnsicht zeigt die aktuellen IP-Einstellungen.

uHinweise zur Änderung der IP-Einstellungen beachten: Ethernet-Schnittstellen

parametrieren (Ò/18)

4.2.3 Feldbus-Erweiterungen nutzen

Die Funktionalität des Geräts kann um Feldbus-Funktionen erweitert werden. Dadurch lässt sich das

Gerät flexibel in Feldbus-Umgebungen integrieren.

Verfügbare Feldbus-Erweiterungen:

•EtherCAT Master (Ò/19)

•EtherNet/IP Scanner (Ò/23)

•EtherNet/IP Adapter (Ò/25)

•Modbus TCP Master (Ò/21)

•Modbus TCP Slave (Ò/22)

•PROFINET IO Master (Ò/26)

4.2.3.1 EtherCAT Master

Das Gerät kann als EtherCAT Master betrieben werden. Dafür stellt die ifm electronic einen

EtherCAT-Master-Stack für das CODESYS Development System 3.5 bereit.

Der EtherCAT Master muss einer ungenutzten Ethernet-Schnittstelle eth2 oder eth3 des Geräts

zugewiesen werden.

EtherCAT Master hinzufügen

Voraussetzungen:

üCODESYS wurde gestartet.

üProjekt ist geöffnet.

üEthernet-Adapter wurde dem Projekt hinzugefügt und konfiguriert, Ethernet-Adapter hinzufügen

(Ò/18).

uIm Gerätebaum: Rechtsklick auf Knoten [Ethernet_edgeController].

wKontextmenü erscheint.

AE3100 IIoT Controller

20

uMenüpunkt [Gerät anhängen…] wählen.

wDialogfenster erscheint.

uIn Tabelle: [EtherCAT Master] wählen.

uAuf [Gerät anhängen] klicken.

uAuf [Schließen] klicken.

wCODESYS fügt einen EtherCAT Master zum Projekt hinzu.

EtherCAT Master konfigurieren

Die Konfiguration des EtherCAT Master erfolgt über den EtherCAT-Geräte-Editor von CODESYS.

Detaillierte Informationen zu Konfigurationsoptionen: help.codesys.com

Voraussetzungen:

üEtherCAT Master wurde zum Projekt hinzugefügt.

uIm Gerätebaum: Doppelklick auf den Knoten des EtherCAT Masters.

wGeräte-Editor erscheint.

uEtherCAT Master konfigurieren.

wEtherCAT Master ist konfiguriert.

Optional: EtherCAT Slave hinzufügen

Voraussetzungen:

üEtherCAT Master wurde zum Projekt hinzugefügt.

uESI-Datei des EtherCAT Slaves zum Geräte-Repository hinzufügen.

uIm Gerätebaum: Rechtsklick auf Knoten des EtherCAT Masters.

wKontextmenü erscheint.

uMenüpunkt [Gerät anhängen…] wählen.

wDialogfenster erscheint.

uIn Tabelle: EtherCAT Slave wählen.

uAuf [Gerät anhängen] klicken.

wCODESYS fügt EtherCAT Slave als Unterelement des EtherCAT Masters hinzu.

Seite wird geladen ...

IFM AE3100 Bedienungsanleitung

IFM AE3100 Bedienungsanleitung

Verwandte Artikel

Andere Dokumente