Programmierhandbuch CODESYS-Version: 3.5 SP16 Patch 0

ProgrammierhandbuchecomatDisplay

Betriebssystem: ab V2.x.x.xCODESYS-Version: 3.5 SP16 Patch 0

8029

0354

/ 01

01

/ 20

21

DE

2

Inhaltsverzeichnis1 Vorbemerkung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.1 Rechtliche Hinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.2 Zweck des Dokuments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.3 Verwendete Symbole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.4 Verwendete Warnhinweise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.5 Übersicht: ifm Anwender-Dokumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.6 Übersicht: CODESYS-Dokumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.7 Änderungshistorie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Sicherheitshinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1 Notwendige Vorkenntnisse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.2 Cyber-Sicherheit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.1 Systemvoraussetzungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.1.1 Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.1.2 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.1.3 Lizensierung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2 CODESYS Development System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1 CODESYS Development System installieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.3 ifm-Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.3.1 Komponenten des Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.3.2 Package installieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.3.3 Package aktualisieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.3.4 Package deinstallieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.4 Laufzeitsystem des Geräts aktualisieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.4.1 Allgemeine Hinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.4.2 Recovery-Modus starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.4.3 Laufzeitsystem aktualisieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143.4.4 IP-Parameter der Ethernet-Schnittstelle einstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.4.5 Recovery-Modus beenden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4 Schnelleinstieg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.1 CODESYS starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.2 CODESYS-Projekt erstellen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2.1 Template für ecomatDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.2.2 Übersicht: Projektstruktur mit ecomatDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.2.3 Neues Projekt mit ecomatDisplay erstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.3 CODESYS-Bedienungsanleitung nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.4 Programmierschnittstelle konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.4.1 Kommunikationspfad der SPS setzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.5 Zugriffsschutz für Projekt aktivieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.6 Auf das Linux-System des Geräts zugreifen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

5 Gerätekonfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235.1 Setup-Modus starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.1.1 Setup Main Menu: Untermenüs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245.1.2 Bedienhinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245.1.3 Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275.1.4 Backup: Datensicherung erstellen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285.1.5 System Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295.1.6 Device Diagnostic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345.1.7 Device Info: Geräte-Informationen anzeigen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375.1.8 Remove USB: USB-Stick sicher entfernen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

5.2 SPS-Anwendung starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385.3 Setup verlassen, Gerät neu starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

6 Systemkonfiguration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396.1 SPS konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396.2 Schriftart hinzufügen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396.3 CAN-Schnittstellen konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

6.3.1 Gerätebeschreibungsdateien (EDS-Dateien) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3

6.3.2 CANbus hinzufügen und konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.3.3 RawCAN: CANLayer 2 konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.3.4 CANopen: CANopen Manager konfigurieren (Master) . . . . . . . . . . . . . . . . . . . . . . . . 416.3.5 CANopen: CANopen Device konfigurieren (Slave) . . . . . . . . . . . . . . . . . . . . . . . . . . . 416.3.6 J1939: J1939-Manager konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

7 Programmierung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437.1 Objekte der SPS-Anwendung mit ecomatDisplay-Template . . . . . . . . . . . . . . . . . . . . . . . 437.2 SPS-Anwendung erstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

7.2.1 Unterstützte Programmiersprachen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447.2.2 PLC_PRG in FUP und ST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447.2.3 Verfügbarer Speicher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457.2.4 Unterstützte Variablentypen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457.2.5 Persistente Variablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467.2.6 Symbolnamen der Bedienelemente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467.2.7 Arbeitsreihenfolge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

7.3 ifm-Funktionsbibliotheken nutzen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477.3.1 Gerät konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487.3.2 Gerät steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487.3.3 Audiofunktionen ausführen und einstellen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487.3.4 Ethernet-Schnittstelle konfigurieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497.3.5 Gerätetasten konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497.3.6 Gerätedisplay konfgurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497.3.7 Auf Gerätesensoren und Eingänge/Ausgänge zugreifen . . . . . . . . . . . . . . . . . . . . . . 497.3.8 Systemzeit konfigurieren/lesen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507.3.9 Dateien verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507.3.10 Touchscreen konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507.3.11 Analogkamera einstellen und steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517.3.12 Ethernet-Kamera einstellen und steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517.3.13 PDF-Viewer konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517.3.14 Bildfenster steuern / Screenshot erstellen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517.3.15 CSV-Dateien verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517.3.16 Hilfsfunktionen nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

7.4 Visualisierungen nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527.4.1 Einstellungen im Projekt-Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527.4.2 Externe Dateien einbinden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537.4.3 Texte und Schriftarten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537.4.4 Sprachumschaltung. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547.4.5 Bildersammlung verwenden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547.4.6 Visualisierungsmanager nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.4.7 Visualisierung erstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

7.5 Touchscreen-Funktionen nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.5.1 Hinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.5.2 Eingabeobjekte der Visualisierung konfiguieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.5.3 Multitouch-Funktionalität nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

7.6 Bedienung ohne Touch-Funktionalität . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.7 Mobile Kameras nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

7.7.1 Unterstützte Kameras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.7.2 Analogkamera konfigurieren und steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.7.3 Ethernet-Kamera konfigurieren und steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627.7.4 Region of Interest (ROI) konfigurieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

7.8 PDF-Viewer nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637.8.1 Beispiel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

7.9 CSV-Datei-Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647.9.1 CSV-Datei schreiben. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647.9.2 CSV-Datei lesen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657.9.3 Stringformat uiGenericLogSizeMax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

7.10 CODESYS IIoT Libraries SL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657.11 CANopen nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

7.11.1 CANopen: SDO senden und empfangen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667.11.2 CANopen: Network Management (NMT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

7.12 RawCAN nutzen (CAN Layer 2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

DE

4

7.12.1 RawCAN: CAN-Netzwerkknoten steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677.12.2 RawCAN: CAN-Nachrichten versenden und empfangen . . . . . . . . . . . . . . . . . . . . . . 677.12.3 RawCAN: Remote CAN-Nachrichten anfordern und versenden . . . . . . . . . . . . . . . . . 67

7.13 J1939 nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677.13.1 CAN-Bus anhängen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677.13.2 CAN-Schnittstelle zuordnen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687.13.3 J1939-Manager anhängen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687.13.4 J1939-Manager parametrieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687.13.5 J1939-ECU anhängen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687.13.6 J1939-ECU parametrieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

7.14 EtherNet/IP nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697.14.1 Ethernet-Adapter an ein Ethernet anhängen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697.14.2 EtherNet/IP-Adapter anhängen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697.14.3 EtherNet/IP-Modul anhängen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707.14.4 EtherNet/IP-Schnittstelle konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

7.15 Modbus nutzen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707.15.1 Ethernet-Adapter an ein Ethernet anhängen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707.15.2 Modbus TCP Master anhängen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717.15.3 Modbus TCP Slave Device anhängen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717.15.4 Modbus TCP Slave Device konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

7.16 Task-Abarbeitung konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727.16.1 Task konfigurieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727.16.2 Visualisierungs-Task konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

8 Betrieb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748.1 CODESYS-Projekt auf das Gerät übertragen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

8.1.1 Anwendung auf ecomatDisplay laden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748.1.2 Anwendung auf dem Gerät löschen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

8.2 Betriebszustände der SPS-Anwendung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758.2.1 Betriebszustand der SPS-Anwendung anzeigen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758.2.2 SPS-Anwendung starten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758.2.3 SPS-Anwendung stoppen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

8.3 Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758.3.1 Unterstützte Reset-Varianten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758.3.2 Anwendung rücksetzen (warm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768.3.3 Anwendung rücksetzen (kalt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768.3.4 Anwendung rücksetzen (Ursprung) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

8.4 Systeminformationen anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

9 ifm-Funktionsbibliotheken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789.1 Verhaltensmodell der ifm-Funktionsbausteine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

9.1.1 Allgemein . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789.1.2 Verhaltensmodell ENABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789.1.3 Verhaltensmodell EXECUTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

9.2 Bibliothek ifm_ecomatDisplay_Cnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799.3 Bibliothek ifmCANopenManager.library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

9.3.1 COP_GetNodeState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809.3.2 COP_SDOread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829.3.3 COP_SDOwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 849.3.4 COP_SendNMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869.3.5 NMT_SERVICE (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.3.6 NMT_STATES (ENUM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

9.4 Bibliothek ifmDevice_ecomatDisplay.library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.4.1 Audio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.4.2 Common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969.4.3 Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1109.4.4 Keypads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1209.4.5 LCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1349.4.6 Local IO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1449.4.7 Status LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1629.4.8 Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1649.4.9 System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1689.4.10 System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176

5

9.4.11 Touch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1789.4.12 System Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1829.4.13 Window Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1969.4.14 ENUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2079.4.15 STRUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2119.4.16 Global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222

9.5 Bibliothek ifmFileUtil.library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2229.5.1 Generic File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2229.5.2 Parameter File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2359.5.3 Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2399.5.4 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2569.5.5 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2629.5.6 ENUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2739.5.7 STRUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2749.5.8 GlobalConstants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275

9.6 Bibliothek ifmRawCAN.library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2769.6.1 CAN_Enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2769.6.2 CAN_Recover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2789.6.3 CAN_RemoteRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2809.6.4 CAN_RemoteResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2829.6.5 CAN_Rx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2849.6.6 CAN_RxMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2869.6.7 CAN_RxRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2889.6.8 CAN_RxRangeExt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2909.6.9 CAN_Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2929.6.10 CAN_Tx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2949.6.11 BUS_STATE (ENUM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2969.6.12 CAN_Info (GVL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2969.6.13 CAN_BUS_STATE (STRUCT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296

10 Anhang. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29710.1 Adressvergabe in Ethernet-Netzwerken. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

DE

6

1 VorbemerkungAnleitung, technische Daten, Zulassungen und weitere Informationen über den QR-Code auf demGerä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, auchauszugsweise, nur mit Zustimmung der ifm electronic gmbh.

Alle auf unseren Seiten verwendeten Produktnamen, -Bilder, Unternehmen oder sonstige Marken sindEigentum der jeweiligen Rechteinhaber:

• AS-i ist Eigentum der AS-International Association, (→ www.as-interface.net)

• CAN ist Eigentum der Robert Bosch GmbH, Deutschland (→ www.bosch.de)

• CANopen ist Eigentum der CiA (CAN in Automation e.V.), Deutschland (→ www.can-cia.org)

• CODESYS™ ist Eigentum der CODESYS GmbH, Deutschland (→ www.codesys.com)

• DeviceNet™ ist Eigentum der ODVA™ (Open DeviceNet Vendor Association), USA(→ www.odva.org)

• EtherNet/IP® ist Eigentum der → ODVA™

• EtherCAT® ist eine eingetragene Marke und patentierte Technologie, lizenziert durch die BeckhoffAutomation GmbH, Deutschland

• IO-Link® ist Eigentum der → PROFIBUS Nutzerorganisation e.V., Deutschland (→ www.io-link.com)

• ISOBUS ist Eigentum der AEF – Agricultural Industry Electronics Foundation e.V., Deutschland(→ www.aef-online.org)

• Microsoft® ist Eigentum der Microsoft Corporation, USA (→ www.microsoft.com)

• Modbus® ist Eigentum der Schneider Electric SE, Frankreich (→ www.schneider-electric.com)

• PROFIBUS® ist Eigentum der PROFIBUS Nutzerorganisation e.V., Deutschland(→ www.profibus.com)

• PROFINET® ist Eigentum der → PROFIBUS Nutzerorganisation e.V., Deutschland

• Windows® ist Eigentum der → Microsoft Corporation, USA

1.2 Zweck des DokumentsDieses Dokument gilt für folgende Geräte des Typs ecomatDisplay ab Firmware-Version V 2.x.x.x:

• CR1058

• CR1059

• CR1074

• CR1075

• CR1076

• CR1077

• CR1102

• CR1202

• CR1203

• CR1204

http://www.as-interface.net/

http://www.can-cia.org/

http://www.codesys.com/

http://www.odva.org/

http://www.io-link.com/

http://www.io-link.com/

http://www.aef-online.org/

http://www.microsoft.com/

http://www.schneider-electric.com/

http://www.profibus.com/

7

Diese Anleitung beschreibt folgende Themen:

• Konfiguration des Geräts im Setup-Modus

• Aktualisierung der Firmware des Geräts im Recovery-Modus

• Konfiguration des Geräts mit CODESYS 3.5

• Programmierung der geräteinternen SPS mithilfe des Programmiersystems CODESYS 3.5

• Beschreibung der gerätespezifischen CODESYS-Funktionsbibliotheken

1.3 Verwendete SymboleVoraussetzung

Handlungsanweisung

Reaktion, Ergebnis

[...] Bezeichnung von Tasten, Schaltflächen oder Anzeigen

Querverweis

Wichtiger HinweisFehlfunktionen oder Störungen sind bei Nichtbeachtung möglich

InformationErgänzender Hinweis

1.4 Verwendete Warnhinweise

ACHTUNGWarnung vor Sachschäden

VORSICHTWarnung vor Personenschäden

w Leichte reversible Verletzungen sind möglich.

WARNUNGWarnung vor schweren Personenschäden

w Tod oder schwere irreversible Verletzungen sind möglich.

1.5 Übersicht: ifm Anwender-DokumentationDie Dokumentation für das Gerät besteht aus folgenden Modulen:

Dokument Inhalt / Beschreibung

Datenblatt • Technische Daten

Montageanleitung / Betriebsanleitung • Anleitung für Montage, elektrische Installation undInbetriebnahme

• Technische Daten

DE

8


Programmierhandbuch • Erstellen eines CODESYS-Projekts mit diesem Gerät• Zielsystem einstellen mit CODESYS• Geräteinterne SPS mit CODESYS programmieren• Beschreibung der gerätespezifischen CODESYS-

Funktionsbibliotheken

Soweit Dokumente nicht vorliegen, können diese bei ifm angefordert werden oder stehen alsDownload auf der ifm-Website zur Verfügung: www.ifm.com

1.6 Übersicht: CODESYS-DokumentationDie CODESYS GmbH stellt für die Programmierung der SPS des Geräts die folgende Anwender-Dokumentation bereit:


Online-Hilfe • Kontextsensitive Hilfe• Beschreibung des Programmiersystems CODESYS• Beschreibung der Komponenten und Bibliotheken

CODESYS Installation und Erste Schritte • Hinweise zur Installation des Programmiersystems CODESYS• Erste Schritte beim Umgang mit dem Programmiersystem CODESYS

Alle Dokumente sind nach der Installation des Programmiersystems CODESYS 3.5 auf der Festplattedes PC/Laptops gespeichert und aufrufbar:

• Online-Hilfe:...\Programme\3S CoDeSys\CoDeSys\Online-Help

• CODESYS Installation und Erste Schritte:...\Programme\3S CoDeSys\CoDeSys\Documentation

1.7 ÄnderungshistorieAusgabe Thema Datum

00 Neuerstellung des Dokuments 11/2019

http://www.ifm.com

9

Ausgabe Thema Datum

01 Änderungen für Firmware V2Neue Kapitel:(Ò Persistente Variablen / 46)(Ò Ethernet-Kamera konfigurieren und steuern / 62)(Ò PDF-Viewer nutzen / 63)(Ò CSV-Datei-Logging / 64)(Ò CODESYS IIoT Libraries SL / 65)(Ò J1939 nutzen / 67)(Ò EtherNet/IP nutzen / 69)(Ò Modbus nutzen / 70)(Ò Ethernet-Kamera einstellen und steuern / 51)(Ò PDF-Viewer konfigurieren / 51)(Ò Sprachumschaltung / 54)(Ò Bedienung ohne Touch-Funktionalität / 60)(Ò Globales Umschalten der Visualisierung / 56)(Ò Lokales Umschalten der Visualisierung / 57)(Ò Target-Visualisierung konfigurieren / 58)(Ò Web-Visualisierung konfigurieren / 58)(Ò Konventionen für Dateinamen / 53)

Geänderte Kapitel:(Ò Zweck des Dokuments / 6)(Ò Bootscreen einstellen / 32)(Ò CSV-Dateien verwalten / 51)(Ò Hilfsfunktionen nutzen / 52)(Ò Mobile Kameras nutzen / 61)(Ò Unterstützte Kameras / 61)(Ò Einstellungen im Projekt-Template / 52)(Ò Externe Dateien einbinden / 53)Entfernte Kapitel:Beschreibung eKEY_ID

Neue Bibliotheks-Beschreibungen:• FB PDF_Viewer• FB IPCameraWindowControl• ENUM eIP_CAMERA_ENCODING• ENUM eIP_CAMERA_PROTOCOL• STRUCT stCAMERA_CONFIG• STRUCT stPDF_CONTROLS• ALIAS aETH_ITF_LIST• ALIAS aUSB_STORAGE_INFO_LIST• FB ReadCSVData• FB WriteCSVData_Linear• FB WriteCSVData_Ring• FB WriteCSVHeader• FUN ANY_TYPE_TO_STRING• FUN ifmCONCAT• FUN ifmFIND• FUN ifmMID• STRUCT stLOG_FILE_CONFIG• STRUCT stSEPARATOR_CONFIG• GVL ifmGCL

01/2021

DE

10

2 Sicherheitshinweise• Das beschriebene Gerät wird als Teilkomponente in einem System verbaut.

– Die Sicherheit dieses Systems liegt in der Verantwortung des Erstellers.

– Der Systemersteller ist verpflichtet, eine Risikobeurteilung durchzuführen und daraus eineDokumentation nach den gesetzlichen und normativen Anforderungen für den Betreiber undden Benutzer des Systems zu erstellen und beizulegen. Diese muss alle erforderlichenInformationen und Sicherheitshinweise für den Betreiber, Benutzer und ggf. vomSystemersteller autorisiertes Servicepersonal beinhalten.

• Dieses Dokument vor Inbetriebnahme des Produktes lesen und während der Einsatzdaueraufbewahren.

• Das Produkt muss sich uneingeschränkt für die betreffenden Applikationen undUmgebungsbedingungen eignen.

• Das Produkt nur bestimmungsgemäß verwenden (Ò Montageanleitung / Betriebsanleitung,Bestimmungsgemäße Verwendung).

• Die Missachtung von Anwendungshinweisen oder technischen Angaben kann zu Sach- und / oderPersonenschäden führen.

• Für Folgen durch Eingriffe in das Produkt oder Fehlgebrauch durch den Betreiber übernimmt derHersteller keine Haftung und keine Gewährleistung.

• Unsachgemäße oder nicht bestimmungsgemäße Verwendung können zu Funktionsstörungen desGerätes, zu unerwünschten Auswirkungen in der Applikation oder zum Verlust derGewährleistungsansprüche führen.

• Montage, elektrischer Anschluss, Inbetriebnahme, Programmierung, Konfiguration, Bedienung undWartung des Produktes darf nur für die jeweilige Tätigkeit ausgebildetes, autorisiertesFachpersonal durchführen.

• Mitgeltende Dokumente beachten.

2.1 Notwendige VorkenntnisseDas Dokument richtet sich an Fachkräfte. Dabei handelt es sich um Personen, die aufgrund ihrereinschlägigen Ausbildung und ihrer Erfahrung befähigt sind, Risiken zu erkennen und möglicheGefährdungen zu vermeiden, die der Betrieb oder die Instandhaltung eines Produkts verursachenkann.

Für die Programmierung sollten die Personen zusätzlich über Kenntnisse der Steuerungstechnik undErfahrung in der SPS-Programmierung nach IEC 61131-3 verfügen.

Das Dokument enthält Angaben zum korrekten Umgang mit dem Produkt.

2.2 Cyber-Sicherheit

ACHTUNGBetrieb des Geräts in ungeschützter Netzwerkumgebung

w Unzulässiger Lese- oder Schreibzugriff auf Daten möglich.

w Unzulässige Beeinflussung der Gerätefunktion möglich.

u Zugriffsmöglichkeiten auf das Gerät prüfen und einschränken.

11

3 Installation

3.1 Systemvoraussetzungen

3.1.1 HardwareZum Programmieren der geräteinternen SPS des ecomatDisplay sind folgende Hardware-

Komponenten erforderlich:

• Ein Gerät der Produktfamilie ecomatDisplay

• Ein PC für das Programmiersystem CODESYS

• Eine Ethernet-Verbindung zwischen CODESYS-PC und der Ethernet-Schnittstelle des Geräts.

3.1.2 SoftwareZum Programmieren der geräteinternen SPS des ecomatDisplay sind folgende Software-Komponenten erforderlich:

Komponente Beschreibung Version

CODESYS DevelopmentSystem

Programmiersoftware CODESYS für normenkonforme SPS-Programmierung nach IEC 61131-3

3.5 SP16 Patch 0

Package "CODESYS fürifm ecomatDisplay"

• Geräte- und Schnittstellenbeschreibung des Geräts• Funktionsbibliotheken für Programmierung des Geräts

2.x.x.x

Die in diesem Handbuch zugesicherten Eigenschaften und Funktionen sind nur mit denSoftware-Komponenten in den hier angegebenen Versionen erreichbar.

ifm electronic stellt auf seiner Webseite die Software-Komponenten zum Herunterladen bereit:www.ifm.com

3.1.3 LizensierungMit dem Kauf des ecomatDisplay erwirbt der Anwender gleichzeitig eine gültige Lizenz für die Nutzungdes "CODESYS für ifm ecomatDisplay".

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

3.2 CODESYS Development SystemDas CODESYS Development System (kurz: CODESYS) ist eine Entwicklungsumgebung für dieErstellung von SPS-Anwendungen (Applikationen) gemäß Norm IEC 61131-3.

3.2.1 CODESYS Development System installierenUm die Software "CODESYS Development System" zu installieren:

u Programmiersystem CODESYS 3.5 SP16 Patch 0 installieren.

w CODESYS 3.5 SP16 Patch 0 ist auf dem PC/Laptop installiert.

DE

12

3.3 ifm-Packageu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Package Manager: Ò Online-Hilfe > CODESYS Development System > Packages undLizenzen verwalten

3.3.1 Komponenten des Packagesifm stellt für die Programmierung der geräteinternen SPS das CODESYS-Package "CODESYS für ifmecomatDisplay" bereit. Das Package enthält folgende Komponenten:

• Gerätebeschreibungsdateien

• ifm-Funktionsbibliotheken und Erweiterungen

u Detaillierte Informationen zu den ifm-Funktionsbibliotheken: (Ò ifm-Funktionsbibliotheken / 78)

3.3.2 Package installierenUm das ifm-Package "CODESYS für ifm ecomatDisplay" zu installieren:

ü CODESYS 3.5 SP16 Patch 0 ist korrekt installiert.

ü ifm-Package "CODESYS für ifm ecomatDisplay" ist auf dem PC/Laptop gespeichert.

u CODESYS mit Administratorrechten starten.

w CODESYS startet.

w CODESYS-Programmoberfläche erscheint.

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

w Das Fenster [Package Manager] erscheint.

u Auf [Installieren...] klicken.

w Der Datei-Explorer erscheint.

u Die Datei ifm_ecoSys_Lx_64bit_Vx.x.x.x.package wählen

u Auf [Öffnen] klicken und eine komplette Installation durchführen.

w "CODESYS für ifm ecomatDisplay" wird installiert.

w Nach erfolgreicher Installation: Das Fenster [Package Manager] zeigt installiertes Package.

w Die Funktionen des Packages können genutzt werden.

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

3.3.3 Package aktualisierenUm das ifm-Package "CODESYS für ifm ecomatDisplay" zu aktualisieren:

u Alte Version des ifm-Packages deinstallieren: (Ò Package deinstallieren / 13)

u Neue Version des ifm-Packages installieren: (Ò Package installieren / 12)

u Projekt öffnen.

u Im Gerätebaum: Knoten des Geräts wählen.

u [Projekt] > [Gerät aktualisieren...] wählen.

w Dialogfenster erscheint.

u Auf [Gerät aktualisieren] klicken, um den Aktualisierungsvorgang zu starten.

w CODESYS lädt neue Gerätebibliotheken.

w Ansicht des Gerätebaums wird aktualisiert.

13

u Auf [Schließen] klicken, um das Dialogfenster zu schließen.

u Projekt speichern.

3.3.4 Package deinstallierenUm das ifm-Package "CODESYS für ifm ecomatDisplay" zu deinstallieren:

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

w Fenster [Package Manager] zeigt die installierten Packages.

u Package wählen, das deinstalliert werden soll.

u Auf [Entfernen...] klicken.

w Das gewählte Package wird deinstalliert.

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

3.4 Laufzeitsystem des Geräts aktualisieren

3.4.1 Allgemeine HinweiseUm das Laufzeitsystem zu aktualisieren, muss sich das Gerät im Recovery-Modus befinden.

Update-Datei herunterladenu Die aktuelle Version des Laufzeitsystems von der ifm-Webseite herunterladen: www.ifm.com >

Produktseite > [Downloads] > [Software Download]

u ZIP-Archiv mit Update-Datei entpacken.

w Update-Datei ist auf dem PC gespeichert.

3.4.2 Recovery-Modus startenu Gerät vom Stromkreis trennen.

u Folgende Aktionen gleichzeitig ausführen:Klemme SERVICE1 auf VBB legen.Klemme SERVICE0 auf GND legen.Gerät wieder einschalten.Dazu müssen Klemme 15 und Klemme 30 beide an VBB liegen.

w Gerät startet neu.

w Gerät ist im Recovery-Modus.

Alternativ bei Geräten mit integriertem Tastenfeld möglich:u Gerät vom Stromkreis trennen.

u Folgende Aktionen gleichzeitig ausführen:Am Gerät gleichzeitig 3 beliebige Tasten drücken und gedrückt halten.Gerät wieder einschalten.Dazu müssen Klemme 15 und Klemme 30 beide an VBB liegen.


u Tasten solange gedrückt halten, bis ifm-Logo erscheint / Status-LED orange blinkt.

w Gerät ist im Recovery-Modus.

DE

http://www.ifm.com/

14

BedienhinweiseDie Bedienung im Recovery-Modus erfolgt mit dem Touchscreen oder mit den Tasten derKreuzwippe:

Kreuzwippe Funktionstaste Funktion

[▲] nach oben bewegenvorheriges Menü-Element wählen

[◀] nach links bewegenvorheriges Element wählen

[▶] nach rechts bewegennächstes Element wählen

[▼] nach unten bewegennächstes Menü-Element wählen

[RETURN] Menüpunkt selektierenSchaltfläche aktivierenWert erhöhen

Menü im Recovery-ModusDer Bildschirm im Recovery-Modus zeigt:

• Folgende Untermenüs:

Schaltfläche Bedeutung

[UPDATE FROM FILE] Laufzeitsystem/Firmware-Update via USB-Schnittstelle (Ò / 15)

[NETWORK SETUP] (Ò IP-Parameter der Ethernet-Schnittstelle einstellen / 16)

[RESTART] Neustart des Geräts.

• Aktuelle Parameter-Einstellungen der Ethernet-Schnittstelle

3.4.3 Laufzeitsystem aktualisieren

ACHTUNGGefahr von Datenverlust!

w Eine Unterbrechung des Update-Vorgangs kann zu einem Verlust der auf dem Gerätgespeicherten Anwenderdaten führen.

u Den Update-Vorgang nicht unterbrechen!

Das Laufzeitsystem des Geräts kann nur im Recovery-Modus aktualisiert werden.

Die aktuelle Version des Laufzeitsystems steht auf der ifm-Webseite zum Herunterladen bereit. (Ò Update-Datei herunterladen / 13)

u Eine der folgenden Optionen wählen:

• (Ò Laufzeitsystem/Firmware-Update via USB-Schnittstelle / 15)

• (Ò Laufzeitsystem/Firmware-Update via Web-Browser / 15)

15

Laufzeitsystem/Firmware-Update via USB-Schnittstelleu Neues Laufzeitsystem von ifm-Webseite herunterladen: (Ò Update-Datei herunterladen / 13)

u Update-Datei *.swu auf einen USB-Speicher kopieren.

u USB-Speicher mit Gerät verbinden: Ò Montageanleitung

u Recovery-Modus starten: (Ò Recovery-Modus starten / 13)

u Während des Update-Vorgangs keine Tasten am Gerät drücken.

u Während des Update-Vorgangs die Spannungsversorgung nicht unterbrechen.

u Mit Schaltfläche [INSTALL FROM FILE] Dateibrowser öffnen.

w Dateibrowser erscheint.

u Im Dateibrowser die Update-Datei *.swu wählen.

u Mit Schaltfläche [OPEN] den Update-Vorgang starten.

w Softwarekomponenten des Geräts werden automatisch aktualisiert: (Ò AllgemeineHinweise / 13)

w Display zeigt Statusmeldungen.

w Wenn erfolgreich: Statusmeldung auf dem Display erscheint: [Success!]

u Mit Schaltfläche [RESTART] das Gerät neu starten.


w Das Firmware-Update ist abgeschlossen.

Laufzeitsystem/Firmware-Update via Web-Browseru Neues Laufzeitsystem von ifm-Webseite herunterladen: (Ò Update-Datei herunterladen / 13)

u Recovery-Modus starten: (Ò Recovery-Modus starten / 13)

u Ethernet-Netzwerkverbindung zwischen Gerät und PC herstellen: Ò Montageanleitung

u Optional: Parameter der Ethernet-Schnittstelle einstellen.

u Auf dem PC den Web-Browser starten.

u In die Adresszeile des Browsers eingeben: http://<IP-Adresse des Geräts>:8080 ;Standardmäßig: http://192.168.82.247:8080

u Mit der Eingabetaste bestätigen.

w Web-Interface des Geräts erscheint im Browser.

w Web-Interface wechselt direkt auf Registerkarte [Software Update].

u Während des Update-Vorgangs keine Tasten am Gerät drücken.

u Während des Update-Vorgangs Schaltfläche [Restart] im Web-Interface nicht klicken.

u Während des Update-Vorgangs die Spannungsversorgung nicht unterbrechen.

u In den Datei-Bereich [Click here...] klicken..

w Windows Datei-Explorer erscheint.

u Heruntergeladene Update-Datei *.swu wählen und mit [Öffnen] übernehmen und Update starten.

w Datei-Bereich zeigt Dateiname der gewählten Update-Datei.

DE

16

w Gewählte Update-Datei wird auf das Display geladen.

w Softwarekomponenten des Geräts werden automatisch aktualisiert: (Ò AllgemeineHinweise / 13)

w Web-Interface und Geräte-Display zeigen Statusmeldungen.

w Wenn erfolgreich: Statusmeldung im Web-Interface erscheint: [Update successfully] .

u Schaltfläche [Restart] im Web-Interface klicken.


w Das Firmware-Update ist abgeschlossen.

3.4.4 IP-Parameter der Ethernet-Schnittstelle einstellenUm das Laufzeitsystem des Geräts über ein Netzwerk zu aktualisieren, muss das Gerät mit dementsprechenden Netzwerk verbunden sein.

Standardeinstellungen der IP-Adresse:

IP-Adresse = 192.168.82.247

Subnetzmaske = 255.255.255.0

Gateway-Adresse = 192.168.82.1

Für die Konfiguration der Ethernet-Schnittstelle stehen folgende Optionen zur Verfügung:

• Manuell: Der Bediener stellt die Schnittstellen-Parameter (IP-Adresse, Subnetzmaske, Gateway-Adresse) manuell ein.

• Automatisch: Die Schnittstellen-Parameter werden über das Dynamic Host Configuration Protocol(DHCP) eingestellt.

ACHTUNGBei Betrieb des Gerätes in einer ungeschützten Netzwerkumgebung.




u Zugriff auf autorisierte Nutzer beschränken.

u Sichere Verfahren wählen, um sich mit dem Gerät zu verbinden (z. B. VPN).

u Verschlüsselte Datenübertragung nutzen (z. B. https / TLS).

u Um die IP-Parameter der Ethernet-Schnittstelle einzustellen:

u Eine der folgenden Optionen wählen:

• (Ò IP-Parameter von DHCP-Server beziehen / 16)

• (Ò IP-Parameter manuell einstellen / 17)

IP-Parameter von DHCP-Server beziehenu Ethernet-Schnittstelle des Geräts mit dem IP-Netzwerk verbinden.

u Gerät im Recovery-Modus starten: (Ò Recovery-Modus starten / 13)

u Mit [▲] / [▼] das Menü [NETWORK SETUP] wählen und mit [RETURN] aktivieren.

w Die Menüseite zeigt aktuelle Einstellungen ([DHCP], [IP-ADDRESS], [NETMASK]) dervorhandenen Netzwerk-Schnittstellen [eth0], [eth1] und [Gateway].

17

u Mit [▲] / [▼] die Netzwerk-Schnittstelle wählen und mit [RETURN] bestätigen.

w Die gewählte Netzwerk-Schnittstelle ist markiert.

u Mit [◀] / [▶] das Kontrollfeld [DHCP] wählen und mit [RETURN] aktivieren.

u Mit [◀] / [▶] die Schaltfläche [APPLY] wählen und mit [RETURN] aktivieren.

w DHCP ist für die gewählte Netzwerk-Schnittstelle aktiviert. In der Spalte [DHCP] der Übersichtwird [yes] angezeigt.

w Gerät versucht, IP-Parameter der Ethernet-Schnittstelle vom DHCP-Server des Netzwerks zubeziehen.

w Wenn erfolgreich:

w Menüseite [NETWORK SETUP] erscheint.

w Informationszeile zeigt aktive Werte der IP-Parameter [DHCP], [IP-ADDRESS], [NETMASK].

w Gerät ist im IP-Netzwerk unter den angezeigten Parameters erreichbar.

u Optional: Um die Erreichbarkeit des Geräts zu prüfen, in der Eingabeaufforderung folgendenBefehl ausführen: ping <Geräteadresse>, z.B. ping 192.168.82.247

IP-Parameter manuell einstellen

u Weitere Infos zur Vergabe von IP-Adressen Ethernet-Netzwerken: (Ò Adressvergabe inEthernet-Netzwerken / 297)

u Gerät im Recovery-Modus starten. (Ò Recovery-Modus starten / 13)

u Mit [▲] / [▼] das Menü [NETWORK SETUP] wählen und mit [RETURN] aktivieren.

w Die Menüseite zeigt aktuelle Einstellungen ([DHCP], [IP-ADDRESS], [NETMASK]) dervorhandenen Netzwerk-Schnittstellen [eth0], [eth1] und [Gateway].

u Mit [▲] / [▼] die Netzwerk-Schnittstelle wählen und mit [RETURN] bestätigen.

w Die gewählte Netzwerk-Schnittstelle ist markiert.

u Mit [◀] / [▶] den ersten IP-Parameter im Bereich [IP-Address] wählen.

w Der gewählte IP-Parameter ist markiert.

u Mit [RETURN] die gewählte Zahl schrittweise einstellen. Dauerhaftes Drücken von [RETURN] =Schnelles Inkrementieren der Zahl.

w Eingabefeld zeigt eingestellten Wert.

u Mit [◀] / [▶] das nächste Eingabefeld wählen und den gewünschten Wert einstellen.

u Vorgang wiederholen, bis gewünschte IP-Adresse eingestellt ist.

u Oben beschriebene Schritte für die Parameter der Subnetzmaske im Bereich [Netmask]wiederholen.

u Mit [◀] / [▶] die Schaltlfäche [APPLY] wählen und mit [RETURN] aktivieren.

w Eingestellte Parameterwerte sind aktiviert.

w Wenn erfolgreich:

w Menüseite [NETWORK SETUP] erscheint.

w Informationszeile zeigt aktive Werte der IP-Parameter [DHCP], [IP-ADDRESS], [NETMASK].

w Gerät ist im IP-Netzwerk unter den angezeigten Parameters erreichbar.

u Optional: Um die Erreichbarkeit des Geräts zu prüfen, in der Eingabeaufforderung folgendenBefehl ausführen: ping <Geräteadresse> , z.B. ping 192.168.82.247

3.4.5 Recovery-Modus beendenu Recovery-Bildschirm aufrufen.

DE

18

u Mit [▲] / [▼] den Menüpunkt [RESTART] wählen und mit [RETURN] bestätigen.

w Das Gerät startet neu.

Wenn auf dem Gerät ein gültiges Projekt geladen ist, wird nach dem Neustart dieses Projektautomatisch gestartet.

Wenn kein gültiges Projekt gespeichert ist, dann erscheint nach dem Neustart das Setup-Startmenü.

19

4 Schnelleinstieg

4.1 CODESYS startenü Software-Komponenten sind korrekt installiert. (Ò Installation / 11)

u CODESYS starten: Doppelklick auf Symbol [CODESYS 3.5 SP16 Patch 0]

w CODESYS startet.

w CODESYS-Bedienoberfläche erscheint.

4.2 CODESYS-Projekt erstellenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Projekt erstellen: Ò Online-Hilfe > CODESYS Development System > Projekt anlegen undkonfigurieren

Projekt verwalten: Ò Online-Hilfe > CODESYS Development System > Projekt schützen undspeichern

4.2.1 Template für ecomatDisplayifm stellt für jedes Modell der Gerätefamilie ein spezielles Projekt-Template bereit. Das Templateenthält die optimalen Voreinstellungen für das jeweilige Zielgerät (Target). Der Anwender kann dasTemplate während der Projekterstellung wählen. Die Templates sind nach der Installation desGerätepackages verfügbar.

Um Fehler bei einer manuellen Systemkonfiguration zu vermeiden, wird ausdrücklich empfohlen,bei der Erstellung eines ecomatDisplay-Projekts in CODESYS das Projekt-Template der ifm zuverwenden.

4.2.2 Übersicht: Projektstruktur mit ecomatDisplayEin CODESYS-Projekt enthält alle Komponenten für die Konfiguration, Verwaltung undProgrammierung des ecomatDisplay. Alle Komponenten eines Projekts sind im Fenster [Geräte] ineiner Baumansicht hierarchisch abgebildet. CODESYS-Projekte mit einem ecomatDisplay besitztfolgende Struktur:

Abb. 1: Legende:

ecomatDisplay (ecomatDisplay Sample) Logische Vatersteuerung, bietet Zugriff auf die allgemeinen Einstellungen desecomatDisplay.

SPS-Logik Enthält die Applikation des ecomatDisplay.

DE

20

Application Enthält die Objekte, die für ein Steuerungsprogramm und die Visualisierungbenötigt werden.

Communication Bietet Zugriff auf die Konfigurationoptionen der Kommunikationsschnittstellen.

Ethernet / CAN Verfügbare Kommunikationsschnittstellen.

4.2.3 Neues Projekt mit ecomatDisplay erstellenü Alle notwendigen Software-Komponenten sind korrekt installiert. (Ò Installation / 11)

ü CODESYS wurde fehlerfrei gestartet.

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

w Fenster [Neues Projekt] erscheint.

u Folgende Werte einstellen:[Kategorie]: ecomatDisplay wählen.[Vorlagen]: Das zum Gerät passende Template wählen: [ifm ecomatDisplay ...Name]: Projektname eingeben[Ort]: Speicherort der Projektdatei wählen.

u [OK] klicken, um die eingegebenen Werte zu bestätigen.

w CODESYS erzeugt ein neues Projekt mit ecomatDisplay.

w Fenster [Geräte] zeigt den Gerätebaum des Projekts. (Ò Übersicht: Projektstruktur mitecomatDisplay / 19)

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

w CODESYS speichert das Projekt.

4.3 CODESYS-Bedienungsanleitung nutzenDieses Handbuch beschreibt ausschließlich die Integration, Konfiguration und Programmierung desecomatDisplay mithilfe des Programmiersystems CODESYS.

Für die Beschreibung von Nutzeraktionen und Komponenten der Bedienoberfläche wird dieCODESYS-eigene Terminologie verwendet.

Standard-Funktionen und -Mechanismen von CODESYS werden nicht beschrieben. Am Anfang jedesAbschnitts erfolgt ein Verweis auf die entsprechenden Kapitel der Online-Hilfe von CODESYS.

Um die Online-Hilfe von CODESYS aufzurufen:

u CODESYS starten.

w Bedienoberfläche von CODESYS erscheint.

u [F1] drücken.

w Online-Hilfe des Programmiersystems CODESYS erscheint.

u Machen Sie sich mit dem Programmiersystem CODESYS vertraut! Dies gilt insbesondere fürfolgende Themen:- Bezeichnungen und Funktionen der Elemente der Bedienoberfläche- Grundlegende Menüfunktionen- Programmiertechniken und Mechanismen zur Datenhaltung- Feldbusunterstützung

21

4.4 Programmierschnittstelle konfigurierenDie Programmierung der geräteinternen SPS erfolgt über die Ethernet-Schnittstelle des Geräts (Lageder Anschlüsse: Ò Montageanleitung).

Gerät und PC können entweder direkt oder indirekt über ein Ethernet-Netzwerk miteinandergekoppelt werden.

u Für die Verbindung der Ethernet-Schnittstellen nur empfohlenes Zubehör nutzen. ÒMontageanleitung

u Für den Anschluss im Netzwerk sollte ein erfahrener Anwender oder ein System-Administrator die Einrichtung der Netzwerkadressen und die Konfiguration vornehmen.

u Bei Bedarf die Ethernet-Schnittstelle des Geräts im Setup-Modus einstellen. (Ò Connection / 27)

Voraussetzungen für die Verbindung zwischen dem CODESYS-PC und dem Gerät:

ü Die Firmwarestände des verwendeten Projekt-Templates und des Geräts stimmen überein.

ü Die Applikation auf dem Gerät ist geöffnet.– oder -

u Wenn keine Applikation auf dem Gerät läuft, den Button [LOAD APPLICATION] betätigen. (Ò SPS-Anwendung starten / 38)




u Zugriffsmöglichkeiten auf das Gerät prüfen und einschränken:




4.4.1 Kommunikationspfad der SPS setzenUm den Kommunikationspfad zwischen dem Programmiersystem CODESYS und der geräteinternenSPS zu konfigurieren:

ü CODESYS-PC/Laptop und Ethernet-Schnittstelle des Geräts sind verbunden.

ü Optional: IP-Einstellungen der Ethernet-Schnittstelle anpassen.

u Im Gerätebaum: Doppelklick auf Symbol [Device (ecomatDisplay)]

u Im Editor-Fenster: Registerkarte [Kommunikation] wählen.

w Editor-Fenster zeigt Kommunikationseinstellungen.

u In Liste [Gateway] das gewünschte Gateway wählen.

w Liste zeigt gewählten Gateway.

u [Netzwerk durchsuchen...] aktivieren.

w Fenster [Gerät auswählen] erscheint.

DE

22

u Gateway-Knoten wählen und mit [Geräte suchen] den Scan-Vorgang starten.

w CODESYS durchsucht Netzwerk nach Geräten.

w Fenster zeigt Netzwerkpfad und erkannte Geräte.

u Knoten des Geräts wählen und [OK] aktivieren, um den Kommunikationspfad zur geräteinternenSPS zu setzen.

w CODESYS kann Daten auf die geräteinterne SPS übertragen.

4.5 Zugriffsschutz für Projekt aktivierenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Projekt schützen und speichern: Ò Online-Hilfe > CODESYS Development System > Projektschützen und speichern

Um das Projekt auf dem Gerät vor nicht autorisiertem Zugriff zu schützen, kann der Nutzer einenPasswortschutz nutzen.

u [Projekt] > [Projekteinstellungen] wählen.

w Fenster [Projekteigenschaften] erscheint.

u [Sicherheit] wählen.

u Kontrollfeld [Projektdateiverschlüsselung] aktivieren.

u Im Feld [Neues Passwort] das gewünschte Passwort eingeben.

u Im Feld [Neues Passwort bestätigen] das eingegebene Passwort erneut eingeben.

u [OK] wählen, um den Zugriffsschutz für das Projekt zu aktivieren.

w Zugriffsschutz ist aktiviert. Projekt ist verschlüsselt.

4.6 Auf das Linux-System des Geräts zugreifenDer Nutzer kann über die Ethernet-Schnittstelle direkt auf das Linux-System des Geräts zugreifen.Folgende Optionen werden unterstützt:

Option Beschreibung Beispielanwendung

Telnet unverschlüsselter Zugang zu Linux-Kommandozeile Putty (→ www.putty.org)

SSH verschlüsselter Zugang zur Linux-Kommandozeile Putty (→ www.putty.org)

FTP unverschlüsselter Zugriff auf Linux-Dateisystem (Dateien kopieren) WinSCP (→ www.winscp.net)File-Transfer in CODESYS

SCP verschlüsselter Zugriff auf Linux-Dateisystem (Dateien kopieren) WinSCP (→ www.winscp.net)

Benutzername und Passwort: (Ò Login-Daten / 31)

23

5 GerätekonfigurationDieses Kapitel beschreibt die Konfiguration des Geräts im Setup-Modus.

5.1 Setup-Modus startenWenn keine gültige Anwendung auf dem Gerät gespeichert ist, geht das Gerät nach demSystemstart automatisch in das Startmenü. Von dort kann der Setup-Modus gestartet werden.

u Gerät vom Stromkreis trennen.

u Folgende Aktionen gleichzeitig ausführen:Klemme SERVICE0 auf VBB legen.Gerät wieder einschalten. Dazu müssen Klemme 15 und Klemme 30 beide an VBB liegen.


u Im Menü die Schaltfläche [Launch Setup] wählen und mit [RETURN] bestätigen.

w Gerät ist im Setup-Modus.

Alternativ bei Geräten mit integriertem Tastenfeld möglich:u Gerät vom Stromkreis trennen.

u Folgende Aktionen gleichzeitig ausführen:Am Gerät gleichzeitig 2 beliebige Tasten drücken und gedrückt halten.Gerät einschalten. Dazu müssen Klemme 15 und Klemme 30 beide an VBB liegen.


u Im Menü die Schaltfläche [Launch Setup] wählen und mit [RETURN] bestätigen.

w Gerät ist im Setup-Modus.

Startseite im Setup-Modus:

DE

24

5.1.1 Setup Main Menu: UntermenüsDer Bildschirm im Setup-Hauptmenü [Setup Main Menu] zeigt folgende Untermenüs:

Schaltfläche Bedeutung

[Connection] Einstellung der Ethernet-Schnittstellen (Ò Connection / 27)

[System Setup] Systemeinstellungen (Ò System Setup / 29)

[Backup] Backup der Gerätedaten und Einstellungen durchführen (Ò Backup: Datensicherungerstellen / 28)

[Device Diagnostic] Geräte-Diagnose (Ò Device Diagnostic / 34)

[Device Info] Geräte-Information (Ò Device Info: Geräte-Informationen anzeigen / 37)

[Remove USB] USB-Stick sicher entfernen (Ò Remove USB: USB-Stick sicher entfernen / 38)

Gerät neu startenUm das Gerät neu zu starten (Reboot):

u Setup-Hauptmenüseite wählen.

u Mit das Gerät neu starten.

w Das Gerät startet neu.

Wenn auf dem Gerät ein gültiges Projekt geladen ist, wird nach dem Neustart dieses Projektautomatisch gestartet.

Wenn kein gültiges Projekt gespeichert ist, dann erscheint nach dem Neustart das Setup-Startmenü

5.1.2 BedienhinweiseIm Setup-Modus gelten für die Bedienelemente folgende Regeln:

TastenfunktionDie Belegung der Funktionstasten ist kontextabhängig. Welche Aktion bei der Betätigung einer Tasteausgelöst wird, zeigt das Symbol der korrespondierenden Schaltfläche auf dem Bildschirm.

Die folgende Tabelle gibt eine Übersicht der verfügbaren Tastenfunktionen:

Schaltfläche Bedeutung Beispiel

[▼], [▶] Nächstes Bildschirmelement markieren Nächsten Menüpunkt wählen

[▲], [◀] Vorheriges Bildschirmelement markieren Vorherigen Menüpunkt wäheln

[RETURN] Funktion des markierten Bildschirmelementsaktivieren

Untermenü aufrufenIn Menüansicht in das markierte Verzeichnis wechseln

[▲], [▼], [◀], [▶] • in jeweilige Richtung navigieren• Ziffernwerte inkrementieren / dekrementieren

Taste auf Bildschirmtastatur wählen

Nächsthöhere Menüebene wählen Nächsthöhere Menüebene aufrufen

Setup beenden. -

Nächster Schritt. -

Gerät neu starten. -

25

Schaltfläche Bedeutung Beispiel

Abspielen. Audio-Text abspielen.

Recovery-Modus starten. -

Dateibrowser öffnen -

USB-Stick abmelden. -

Datei oder Einstellung speichern IP-Adresse speichern

Empfang starten Empfang von CAN-Telegrammen starten

Empfang stoppen Empfang von CAN-Telegrammen stoppen

Senden starten Senden von CAN-Telegrammen starten

Senden stoppen Senden von CAN-Telegrammen stoppe

Bootscreen als Vollbild anzeigen. -

Ausgeblendete Zeichen anzeigen. Passwort im Klartext anzeigen.

Bestätigung / OK Backup-Einstellungen sind ok. Backup-Vorgangstarten.

Bedienung: Im Setup-Menü navigierenUm im Setup-Menü zu navigieren:

u Mit [▼] oder [▶] den nächsten Menüpunkt wählen (vorwärts).- oder -Mit [▲] oder [◀] den vorherigen Menüpunkt wählen (rückwärts).

w Gewählter Menüpunkt hat Fokus (orangefarbener Rahmen).

u Mit [RETURN] zur gewählten Menüseite wechseln.- oder -

Mit zur übergeordneten Menüseite wechseln.

Bedienung: Auf einer Menüseite navigierenUm innerhalb einer Menüseite zu navigieren:

u Mit [▼] / [▶] oder [▲] / [◀] das gewünschte GUI-Element wählen (z.B. Ziffernfeld, Optionsfeld).

w Gewähltes Bildschirm-Element hat Fokus (orangefarbener Rahmen).

w Gewähltes Element ist aktiv und kann geändert werden.

u Mit [RETURN] das gewählte Bildschirm-Element aktivieren oder deaktivieren (z.B. Optionsfeld)- oder -Mit [▲] oder [▼] den Wert des gewählten Bedienlementes schrittweise vergrößern oder verkleinern(z.B. Ziffernfeld).

w Änderungen werden angezeigt.

u Mit die Änderungen speichern.

u Mit zur übergeordneten Menüseite wechseln.

DE

26

Bedienung: Text eingeben mit der BildschirmtastaturDie Bedienoberfläche des Laufzeitsystems verfügt über eine Bildschirmtastatur. Sie erscheintautomatisch, sobald vom Bediener die Eingabe von Zeichen erwartet wird.

Die Bildschirmtastatur zeigt die QWERTY-Tastaturbelegung. Diese Einstellung kann nichtgeändert werden.

Bei der Passworteingabe: Zum Schutz sensibler Information erscheint nur das zuletzteingegebene Zeichen im Klartext. Alle anderen Zeichen werden durch ein * ersetzt.

Um Text mit der Bildschirmtastatur einzugeben:

u Mit [▲] / [▼] und [▶] / [◀] die Schaltfläche des gewünschten Zeichens wählen.

w Die gewählte Schaltfläche hat den Fokus (orangefarbener Rahmen).

u Mit [RETURN] die gewählte Schaltfläche aktivieren.

w Im Textfeld erscheint das eingegebene Zeichen.

u Vorgang wiederholen, um alle benötigten Zeichen einzugeben.

u Mit das eingebene Passwort bestätigen- oder -

Mit zum vorherigen Setup-Bildschirm wechseln.

KreuzwippeDie Kreuzwippe besteht aus folgenden Einzeltasten:

• 4 Navigationstasten ([▲], [▼], [◀], [▶])

• 1 RETURN-Taste (Center-Taste)

Bestimmte Navigationsfunktionen können sowohl mit den Funktionstasten als auch mit derKreuzwippe ausgeführt werden. Die folgende Tabelle zeigt die Funktionen der Kreuzwippe:

Kreuzwippe Funktionstaste Funktion

[▲] nach oben bewegenvorheriges Menü-Element wählen

[◀] nach links bewegenvorheriges Menü-Element wählen

[▶] nach rechts bewegennächstes Menü-Element wählen

[▼] nach unten bewegennächstes Menü-Element wählen

[RETURN] Menüpunkt / Schaltfläche aktivieren

TouchscreenIm Setup-Modus ist die Touchscreen-Funktionalität des Geräts aktiviert.

27

Bestimmte Navigationsfunktionen können sowohl mit den Funktionstasten als auch mithilfe desTouchscreens ausführt werden. Folgende Bedienelemente kann der Bediener direkt per Berührungauf dem Touchscreens aktivieren:

• Schaltflächen

• Menüpunkte

• Tasten der Bildschirmtastatur

• Symbole im Datei-Verzeichnis

• Eingabefelder

Setup: Passwort eingebenUm das Passwort für den uneingeschränkten Zugriff auf das Setup-Menü einzugeben:

u Korrektes Passwort eingeben. (Ò Bedienung: Text eingeben mit der Bildschirmtastatur / 26)

u Mit das eingebene Passwort bestätigen.

w Setup-Menü erscheint.

w Bediener hat uneingeschränkten Zugriff auf alle Setup-Funktion.

Der uneingeschränkte Zugriff auf alle Setup-Funktionen gilt nur solange, bis der Nutzer dasSetup-Menü verlässt.

u Beim Aufruf des Setup-Menüs das Passwort erneut eingegeben!

5.1.3 Connectionu [Connection] aktivieren.

w Menü [Connection] erscheint.

u Eines der folgenden Untermenüs wählen:

Bezeichnung Bedeutung

[LAN & Ethernet] (Ò Ethernet-Schnittstellen konfigurieren / 27)

Ethernet-Schnittstellen konfigurieren

Standardeinstellungen der IP-Adresse:

IP-Adresse = 192.168.82.247

Subnetzmaske = 255.255.255.0

Gateway-Adresse = 192.168.82.1

Um die Ethernet-Schnittstellen zu konfigurieren:

Menüseite wählenu Navigationspfad: [Launch Setup] > [Connection] > [LAN & Ethernet]

w Menübild zeigt folgende Informationen:

Bezeichnung Bedeutung Mögliche Werte

[Bridge Mode] Bridge-Mode einschalten / ausschalten. Wenn eingeschaltet, werden beide Ethernet-Schnittstellen desGeräts im Bridge-Mode betrieben. Sie besitzen eine gemeinsameIP-Konfiguration.

/

DE

28


[Ethernet 0] / [Ethernet 1] Auswahl der Ethernet-Schnittstelle -

[DHCP Mode] DHCP-Mode einschalten / ausschalten /

[IP Address] IP-Adresse der Ethernet-Schnittstelle des Geräts z.B. 192.68.82.247

[Netmask] Subnetzmaske des Netzwerksegments z.B. 255.255.255.0

[Gateway] IP-Adresse des Netzwerk-Gateways z.B. 192.168.82.1

Bridge-Mode aktivierenu Kontrollfeld [Bridge Mode] aktivieren

w Bridge-Mode ist aktiv.

DHCP-Mode aktivierenu Kontrollfeld [DHCP Mode] aktivieren

w DHCP-Mode ist aktiv.

w Das Gerät bezieht die IP-Adresseinstellungen von einem DHCP-Server im Netzwerk.

IP-Parameter ändernü DHCP-Mode ist inaktiv.

u Schnittstelle [Ethernet 0] / [Ethernet 1] wählen (Außer im Bridge-Mode).

u Eingabefeld [IP Address] markieren.

w Ziffernblock wird eingeblendet.

u IP-Adresse mit dem Ziffernblock eingeben.

u Mit den Eingabefeldern [Netmask] und [Gateway] wie beschrieben vorgehen.

u Die Einstellungen mit der Schaltfläche speichern.

w Die IP-Adresseinstellungen wurden geändert.

5.1.4 Backup: Datensicherung erstellenUm Daten vom Gerät auf einem USB-Speicher zu sichern:

u USB-Speicher an der USB-Schnittstelle des Geräts anschließen.

u [Backup] aktivieren.

w Menü [Backup] erscheint.

u Die zu sichernden Daten und Einstellungen wählen:


[Retain Memory] Daten, die auf dem FLASH-Speicher des Geräts gespeichert sind.

[Ethernet Settings] Einstellungen der Ethernet-Schnittstelle.

[Brightness Setting] Helligkeitseinstellungen.

[Screen Orientation Setting] Einstellungen der Displayausrichtung (Rotation).

u Mit die Wert übernehmen.

w Das Bild [Select USB] erscheint.

29

u USB-Speicher wählen / markieren und mit Backup-Vorgang starten.

w Die Daten werden auf den angeschlossenen USB-Speicher übertragen.

w Die Daten werden in einer *.swu-Datei abgelegt.

w Der Backup-Fortschritt wird grafisch angezeigt.

w Nach Beendigung des Backups erscheint eine Meldung, ob das Backup erfolgreich war.

Mit Hilfe des Recovery-Modus kann das Backup (*.swu) wiederhergestellt werden. (Ò Laufzeitsystem aktualisieren / 14)

5.1.5 System Setupu [System Setup] aktivieren.

w Menü [System Setup] erscheint.



[Date and Time] (Ò Datum und Uhrzeit / 29)

[Password] (Ò Passwort einstellen / 30)

[Boot Screen] (Ò Bootscreen einstellen / 32)

[Display Brightness] (Ò Displayhelligkeit einstellen / 33)

[Display Orientation] (Ò Displayausrichtung einstellen / 33)

[Touch Configuration] (Ò Touchscreen konfigurieren / 34)

Datum und Uhrzeit

Zeitzone einstellenUm Datum und Uhrzeit (Systemzeit) einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Date and Time] > Registerkarte [Time Zone]

w Menüseite zeigt folgende Informationen:


[Time Zone Category] Vorauswahl der Zeitzonenregion.Die Auswahl einer Region wirkt als Filter aufdie Liste [Time Zone].

z.B. All, America, Asia, Australia, Europe, US

[Time Zone] Zeitzone z.B. US/Michigan, Europe/London

2 Zeitzonenregion wählenu Liste [Time Zone Category] wählen.

w Markierte Liste hat orangefarbenen Rahmen.

u Mit [▲] / [▼] den gewünschten Wert einstellen.

u Mit [RETURN] bestätigen.

DE

30

3 Zeitzone ändernu Liste [Time Zone] wählen.


u Mit [RETURN] bestätigen.

4 Geänderte Werte speichern

u Mit den geänderten Wert übernehmen und speichern.

Datum und Uhrzeit einstellenUm Datum und Uhrzeit (Systemzeit) einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Date and Time] > Registerkarte [System

Time]



[Year] Jahr 2000 ... 2100

[Month] Monat 1 ... 12

[Day] Tag 1 ... 31

[Hour] Stunde 0 ... 23

[Min] Minute 0 ... 59

[Sec] Sekunde 0 ... 59

[Time Zone] Zeitzone Liste

2 Datum und Uhrzeit ändernu Das gewünschte Zahlenfeld wählen.

w Markiertes Zahlenfeld hat schwarzen Rahmen.


u Optional: Schritt 2 wiederholen, um die Werte zusätzlicher Zahlengruppen zu ändern.

3 Geänderte Werte speichern

u Mit den geänderten Wert übernehmen und speichern.

Passwort einstellenDie Menüseite [Launch Setup] > [System Setup] > [Password] bietet Zugriff auf folgende Funktionen:

• (Ò System-Passwort ändern / 31)

• (Ò Passwortschutz aktivieren/deaktivieren / 32)

Im Auslieferungszustand ist der Passwortschutz für das Setup-Menü deaktiviert.

Wird der Passwortschutz nach der Erstinbetriebnahme aktiviert, gilt zunächst das werkseitiggesetzte Passwort: pdm3

u Um einen wirksamen Schutz zu gewährleisten, das werkseitig gesetzte Passwort ändern!

31

Die Programmiersoftware CODESYS kann auch bei eingeschaltetem Passwortschutzuneingeschränkt auf das im Gerät gespeicherte IEC-Projekt zugreifen.

Login-Daten

Werkseitig sind folgende Login-Daten eingestellt:

Benutzername/Login: rootPasswort: pdm3

Diese Einstellungen gelten z.B. für:

• Zugriff auf das Gerät per FTP, Telnet, SSH

• Zugriff auf den Setup-Mode, sofern der Passwortschutz aktiviert ist (Ò / 32).

System-Passwort ändern

Bei Verlust des Passworts muss ein Recovery Update durchgeführt werden.

u Geräte-Update durchführen (Ò Laufzeitsystem des Geräts aktualisieren / 13)

u ggf. gesicherte Daten wiederherstellen (Ò Laufzeitsystem aktualisieren / 14)

Hinweise zur Bedienung der Bildschirmtastatur: (Ò Bedienung: Text eingeben mit derBildschirmtastatur / 26)

Um das System-Passwort zu ändern:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Password]

u Mit Schaltfläche [Change Password] weiter.

w Menüseite zeigt Eingabefeld [Enter Old Password] und die Bildschirmtastatur.

2 Altes System-Passwort eingebenu Das alte Passwort zeichenweise eingeben. Standardpasswort: (Ò Login-Daten / 31)

u Mit Symbol die Eingabe bestätigen.

Gibt der Anwender das falsche Passwort ein, erscheint folgende Fehlermeldung: Incorrectpassword!

u Eingabe des Passwort wiederholen!

3 Neues System-Passwort eingebenu Das neue Passwort zeichenweise eingeben.

u Mit die Eingabe bestätigen.

u Eingabe des neuen Passworts wiederholen und mit die Eingabe bestätigen.

w Infofeld zeigt Erfolgsmeldung: Password is changed successfully.

w Neues Passwort ist gültig.

DE

32

Gibt der Anwender 2 unterschiedliche neue Passwörter ein, erscheint folgende Fehlermeldung:Password doesn't match!

u Eingabe des Passworts wiederholen!

Passwortschutz aktivieren/deaktivieren

Im Auslieferungszustand ist der Passwortschutz für das Setup-Menü deaktiviert.

Wird der Passwortschutz nach der Erstinbetriebnahme aktiviert, gilt zunächst das werkseitiggesetzte Passwort: pdm3

u Um einen wirksamen Schutz zu gewährleisten, das werkseitig gesetzte Passwort ändern!

Die Programmiersoftware CODESYS kann auch bei eingeschaltetem Passwortschutzuneingeschränkt auf das im Gerät gespeicherte IEC-Projekt zugreifen.

Um den Passwortschutz des Geräts zu aktivieren / deaktivieren:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Password]

w Das Kontrollfeld [Enable Password] zeigt den Status des Passwortschutzes.

2 Passwortschutz einstellenu Das Kontrollfeld [Enable Password] markieren und wie gewünscht einstellen.

w Passwortabfrage nach dem zuletzt gültigen Passwort erscheint.

u Passwort eingeben.

w Passwortschutz wird aktiviert / deaktiviert.

Der Passwortschutz ist erst wirksam beim nächsten Aufruf des Setup-Menüs.

u Mit solange zum vorherigen Menübild wechseln, bis die Setup-Hauptmenüseite erreichtist.

u Mit das Setup-Hauptmenü verlassen.

u Mit Schaltfläche [Launch Setup] das Setup erneut aufrufen.

Bootscreen einstellen

Das Bild für den Bootscreen kann auch über die Bildersammlung im CODESYS-Projekt auf dasGerät geladen werden und mit einem FB aktiviert werden. (Ò Bootscreen einstellen / 55)

Um das Bild für den Bootscreen einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Boot Screen]



[Recently set boot screen] Aktuell eingestelltes Bild für den Boot Screen

33

2 Bild ändern

u drücken.

w Dateibrowser auf dem Gerät erscheint.

u Bilddatei wählen oder mit Dateipfad ändern.

u Bilddatei markieren.

u Bilddatei mit übernehmen.

w Bilddatei für Boot Screen geändert.

Informationen zur Bilddatei für den Splashscreen:

• Bildformat: BMP 24 Bit Version 3.

• RLE-Kompression und gzip-Kompression sind erlaubt.

• Empfohlene Vorgehensweise: Speichern der Bilddatei mit MS Paint als 24 Bit BMP.

• Empfohlene maximale Bildgröße: Auflösung des Displays Ò Datenblatt

• Groß- / Kleinschreibung beim Dateipfad beachten. Linux ist case sensitive.

• Der Dateiname darf nur Kleinbuchstaben enthalten.

• Neue Datei mit dem CODESYS-Filebrowser oder im Setup-Modus auf das Gerät übertragen.

• Maximale Dateigröße: Keine Begrenzung. Die Bilddatei beansprucht einen Teil des verfügbarenSpeichers für die Benutzerapplikation.

Displayhelligkeit einstellenUm die Helligkeit des Displays einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Display Brightness]



[Display Brightness] Relative Helligkeit des Bildschirms (Wert in %) 0 ... 100

minimale Helligkeit

maximale Helligkeit

2 Helligkeit des Displays ändernu Mit dem Slider den gewünschten Wert einstellen.

u drücken, um den eingestellten Wert zu prüfen.

3 Geänderten Wert speichern

u drücken um den eingestellten Wert zu speichern.

Displayausrichtung einstellenUm die Ausrichtung des Displays einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Display Orientation]


DE

34


[Landscape Right] Querformat, Tasten rechts

[Landscape Left] Querformat, Tasten link

[Portrait] Hochformat, Tasten unten

[UpSide Down] Hochformat, Tasten oben

2 Ausrichtung des Displays ändernu Die gewünschte Ausrichtung einstellen.

w Nach einer Abfrage startet das Gerät neu.

Touchscreen konfigurierenUm den Touchscreen (falls vorhanden) einzustellen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [System Setup] > [Touch Configuration]

w Menüseite zeigt folgende Einstellmöglichkeiten:


[Water Optimized (default)] Optimiert für die Bedienung bei Nässe.

[Glove Optimized] Optimiert für die Bedienung mit Handschuhen.

2 Optimierungsart des Displays ändernu Die gewünschte Optimierungsart einstellen.

u drücken um den eingestellten Wert zu speichern.

5.1.6 Device Diagnosticu [Device Diagnostic] aktivieren.

w Menü [Device Diagnostic] erscheint.



[CAN Test] (Ò CAN Test / 34)

[Audio Test] (Ò Audio Test / 36)

[Camera Test] (Ò Camera Test: Kamerabild testen / 37)

[Keyboard Test] (Ò Keyboard Test: Tastatur testen / 37)

CAN Testu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [CAN Test]

w Menüseite [CAN Test] erscheint.



[Bus Number] CAN-Busschnittstelle eingeben. 1 ... 4

35


[Baudrate] Baudrate des CAN-Bus einstellen. 20 kbit/s33.3 kbit/s50 kbit/s83.3 kbit/s100 kbit/s125 kbit/s250 kbit/s500 kbit/s800 kbit/s1000 kbit/s

[Tx Frame Counter] Anzahl der gesendeten Nachrichten

[Rx Frame Counter] Anzahl der empfangenen Nachrichten

[CAN Tx-ID (hex)] CAN-ID des Senders (als Hexadezimal-Zahl) 00000000...FFFFFFFF

[Extended Frame] Extended Frame-Format aktiveren / deaktivieren /

[Tx Bytes (hex)] zu sendende CAN-Nachricht (8 Bytes)Der Inhalt jedes Bytes kann separat eingestellt werden (alsHexadezimal-Zahl).

pro Byte:00 = 0... FF = 255

[Receive] Tabellarische Ansicht der empfangenen CAN-Nachrichten: [ID],[Frame], [Type], [DLC], [Bytes]

Die Menüseite [Launch Setup] > [Device Diagnostic] > [CAN Test] bietet Zugriff auf folgendeFunktionen:

• (Ò CAN Test: Daten senden / 35)

• (Ò CAN Test: Daten empfangen / 36)

CAN Test: Daten senden

Um das Senden von Daten über eine CAN-Schnittstelle zu testen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [CAN Test]


2 CAN-Bus wählenu In Eingabefeld [Bus Number] die Nummer des CAN-Bus eingeben.

u In der Liste [Baudrate] die Baudrate einstellen.

3 Test-Nachricht und Sender-ID einstellenu In [CAN Tx-Id (hex)] die CAN-ID des Senders einstellen.

u Mit dem Kontrollfeld [Extended Frame] das Extended Frame-Format aktivieren / deaktivieren.

u In [Tx Bytes (hex)] die zu sendende Test-CAN-Nachricht segmentweise einstellen.

w Test-Nachricht und Sender-ID sind eingestellt.

DE

36

4 Test-CAN-Nachricht senden

u Mit Symbol die Test-Nachricht senden.

u Gerät versucht, die CAN-Nachricht über gewählten CAN-Bus zu senden.

w In [Tx Frame Counter] erscheint die Anzahl der CAN-Nachrichten, die seit demÜbertragungsstart gesendet wurden.

w Wenn erfolgreich:

w Erfolgsmeldung erscheint.

u Mit das zyklische Senden der CAN-Nachricht beenden.

w Wenn nicht erfolgreich:

u Mit das zyklische Senden der CAN-Nachricht beenden.

u Verbindung zum CAN-Bus überprüfen.

u Vorgang wiederholen.

CAN Test: Daten empfangenUm den Empfang von Daten über eine CAN-Schnittstelle zu testen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [CAN Test]


2 CAN-Bus wählenu In Eingabefeld [Bus Number] die Nummer des CAN-Bus eingeben.

u In der Liste [Baudrate] die Baudrate einstellen.

3 CAN-Nachricht empfangen

u Mit den Empfang von CAN-Nachrichten auf dem gewählten CAN-Bus starten.

w In der Tabelle [Receive] erscheinen nacheinander die empfangenen CAN-Nachrichten imHexadezimal-Format.

w In [Rx Frame Counter] erscheint die Anzahl der CAN-Nachrichten, die seit demÜbertragungsstart empfangen wurden.

w Wenn erfolgreich:

w [Rx Frame Counter] zeigt einen Wert > 0.

u Mit den Empfang der CAN-Nachrichten beenden.

w Wenn nicht erfolgreich:

w [Rx Frame Counter] zeigt den Wert 0.

u Mit den Empfang der CAN-Nachrichten beenden.

u Verbindung zum CAN-Bus überprüfen.

u Vorgang wiederholen.

Audio Test

u Für diese Funktion einen externen Lautsprecher an das Gerät anschließen. ÒMontageanleitung

37

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [Audio Test]

w Menüseite [Audio Test] erscheint.



[Volume] Lautstärke einstellen 0 ... 100 %

[Balance] Balance einstellen Left / Middle / Right

Lautstärke und Balance einstellen und testen

u Für diese Funktion einen externen Lautsprecher an das Gerät anschließen. ÒMontageanleitung

Um die Balance und die Lautstärke einzustellen und zu testen:

1 Menüseite wählenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [Audio Test]

w Menüseite [Audio Test] erscheint.

2 Lautstärke einstellenu Im Eingabefeld [Volume] die Lautstärke eingeben oder über den Silder einstellen.

3 Balance einstellenu Im Optionsfeld [Balance] die Balance einstellen.

4 Lautstärke und Balance testen

u Mit Symbol Lautstärke und Balance testen.

Camera Test: Kamerabild testenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [Camera Test]

w Menüseite [Camera Test] erscheint.

w Menüseite zeigt die Bilder der angeschlossenen Kameras 1 ... 4.

Keyboard Test: Tastatur testenu Navigationspfad: [Launch Setup] > [Device Diagnostic] > [Keyboard Test]

w Menüseite [Keyboard Test] erscheint.

u Gewünschte Taste des integrierten Tastenfeldes drücken.

w Anzeige, welche Taste gedrückt wurde.

5.1.7 Device Info: Geräte-Informationen anzeigenUm die Geräte-Informationen anzuzeigen:

DE

38

u Navigationspfad: [Launch Setup] > [Device Info]


Name Beschreibung

[Firmware] Firmware-Version

[Serial Number] Seriennummer des Geräts

[MAC Address] MAC-Adressen der Ethernet-Schnittstellen

[External Voltage (supply clamp 15)] Wert der anliegenden Versorgungsspannung an Klemme 15 in mV

[Internal Voltages] Interne Spannungswerte

[Board Temperature] Temperatur auf der Platine

[CPU Core Temperature] CPU-Kerntemperatur

[Memory Usage Harddisk] Speichergröße / Belegter Speicher

5.1.8 Remove USB: USB-Stick sicher entfernenUm einen USB-Stick sicher zu entfernen:

u Navigationspfad: [Launch Setup] > [Remove USB]

w An das Gerät angeschlossene USB-Sticks werden angezeigt.

u Mit Symbol USB-Stick abmelden.

w USB-Stick kann jetzt sicher entfernt werden.

5.2 SPS-Anwendung startenu Setup-Modus starten: (Ò Setup-Modus starten / 23)

u Schaltfläche [Load Application] markieren.

u Mit [RETURN] die Anwendung starten.

w Falls ein gültiges Anwendungsprogramm gespeichert ist: Die Anwendung startet.

w Falls kein gültiges Anwendungsprogramm gespeichert ist: Ein leerer Bildschirm erscheint.

u Mit CODESYS ein gültiges Anwendungsprogramm auf das Gerät übertragen.

u Gerät neu starten (Versorgungsspannung AUS > EIN).

5.3 Setup verlassen, Gerät neu starten(Ò Gerät neu starten / 24)

39

6 Systemkonfiguration

6.1 SPS konfigurierenDie Konfiguration der SPS des ecomatDisplay erfolgt über den "Generischen Geräte-Editor" desCODESYS-Programmiersystems.

u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut. Geräteeditor: Ò Online-Hilfe > CODESYS Development System > ReferenzBenutzeroberfläche > Objekte > Objekt 'Gerät' und Generischer Geräteeditor

Die Konfiguration der SPS erfolgt über den Knoten [Device (ecomatDisplay)] des Gerätebaums.

Um die SPS des ecomatDisplay zu konfigurieren:

u Im Gerätebaum: Doppelklick auf [Device (ecomatDisplay)]

w Editor-Fenster zeigt Geräte-Editor der SPS des ecomatDisplay.

6.2 Schriftart hinzufügenEine Schriftart (True Type Font) auf die Steuerung laden:

u Mit dem Gerät per CODESYS oder winSCP verbinden. (Ò Auf das Linux-System des Gerätszugreifen / 22)

u Datei mit der True Type Font ( *.ttf ) in folgenden Ordner auf dem Gerät kopieren: /usr/share/fonts/

u Gerät neu starten.

w Alle Schriftarten im Ordner werden installiert und können verwendet werden.

Wenn die Schriftart unter Windows ebenfalls neu installiert wird:

u CODESYS, sofern geöffnet, anschließend neu starten, damit die neue Schriftart in CODESYSzur Verfügung steht.

6.3 CAN-Schnittstellen konfigurierenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

CAN-basierte Feldbusse: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse

Das Gerät verfügt über CAN-Schnittstellen.

Jede CAN-Schnittstelle unterstützt folgende Protokolle:

• RawCAN (CAN Layer 2)

• CANopen Manager

• CANopen Device

• J1939 Manager

u Hinweise zur Taskkonfiguration beachten! (Ò Task-Abarbeitung konfigurieren / 72)

u Für jede in der Anwendung genutzte CAN-Schnittstelle ein separates "CAN-Bus"-Gerät zumGerätebaum hinzufügen!

DE

40

6.3.1 Gerätebeschreibungsdateien (EDS-Dateien)Falls notwendig:

u Die EDS-Dateien mit den Gerätebeschreibungen für Geräte von ifm von der ifm-Webseiteherunterladen: www.ifm.com

u EDS-Dateien über das Geräte-Repository in CODESYS installieren.

6.3.2 CANbus hinzufügen und konfigurierenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

CANbus-Einstellungen: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse >Registerkarte "CANbus - Allgemein"

CANbus-E/A-Abbild: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse >Registerkarte "E/A-Abbild"

u Für jede CAN-Schnittstelle ein separates CANbus-Gerät zum Projektbaum hinzufügen.

CANbus hinzufügen:u Im Gerätebaum: Rechtsklick auf [CAN].

w Kontextmenü erscheint.

u [Gerät anhängen ...] wählen.

w Fenster [Gerät anhängen] erscheint.

u Folgende Werte einstellen:[Hersteller]: ifm electronic wählen.In der Tabelle: [ifmCANbus] wählen.[Name]: Eindeutige Bezeichnung für CAN-Schnittstelle eingeben.

u Auf [Gerät anhängen] klicken, um das gewählte Gerät zum Projekt hinzuzufügen.

u Auf [Schließen] klicken, um das Fenster zu schließen.

w CODESYS fügt CAN-Schnittstelle zum Gerätebaum hinzu.

CANbus konfigurieren:u Im Gerätebaum: Doppelklick auf hinzugefügten CAN-Knoten.

w Editor-Fenster zeigt Einstellungsoptionen der CAN-Schnittstelle.

u Im Feld [Netzwerk] die CAN-ID des CAN-Netzwerks wählen.

u In Liste [Baudrate (bit/s)] die Datenrate des CAN-Netzwerks wählen.

u Weiter mit:

• (Ò RawCAN: CANLayer 2 konfigurieren / 40)

• (Ò CANopen: CANopen Manager konfigurieren (Master) / 41)

• (Ò CANopen: CANopen Device konfigurieren (Slave) / 41)

• (Ò J1939: J1939-Manager konfigurieren / 42)

6.3.3 RawCAN: CANLayer 2 konfigurierenUm eine CAN-Schnittstelle als CANLayer 2 (RawCAN) zu verwenden, sind keine weiteren Aktionennotwendig. Der Nutzer kann in der Anwendung direkt auf die CAN-Schnittstelle zugreifen.

http://www.ifm.com

41

u Weitere Informationen zur Programmierung des RawCAN-Schnittstelle: (Ò RawCAN nutzen(CAN Layer 2) / 66)

6.3.4 CANopen: CANopen Manager konfigurieren (Master)u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

CANopen Manager: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse >CANopen > CANopen Manager

Die Konfiguration des CANopen Manager basiert auf dem CANopen-Stack des ProgrammiersystemsCODESYS 3.5.

ü CAN-Schnittstelle hinzufügen und konfigurieren: (Ò CANbus hinzufügen und konfigurieren / 40)

u Im Gerätebaum: Rechtsklick auf hinzugefügten [CAN]-Knoten


u Im Kontextmenü [Gerät anhängen...] wählen.

w Dialogfenster [Gerät anhängen] erscheint.

u Folgende Werte einstellen:[Hersteller]: [<Alle Hersteller>] In Tabelle: [CiA CANopen] > [CiA CANopen Manager] > [CANopenManager] wählen.[Name]: Eindeutige Bezeichnung eingeben.



w CODESYS fügt CANopen Manager zum Gerätebaum hinzu.

u Im Gerätebaum: Doppelklick auf hinzugefügten CANopen Manager

w Editor-Fenster zeigt Konfigurationsoptionen.

u CANopen Manager wie gewünscht konfigurieren.

u Projekt speichern, um die Änderungen zu übernehmen.

Weitere Informationen zur Programmierung der CANopen-Schnittstelle: (Ò CANopennutzen / 66)

6.3.5 CANopen: CANopen Device konfigurieren (Slave)u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

CANopen Local Device: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse >CANopen > CANopen Device

Die Konfiguration des CANopen Device basiert auf dem CANopen-Stack des ProgrammiersystemsCODESYS 3.5.

ü CAN-Schnittstelle hinzufügen und konfigurieren: (Ò CANbus hinzufügen und konfigurieren / 40)

u Im Gerätebaum: Rechtsklick auf hinzugefügten [CAN]-Knoten


u Im Kontextmenü: [Gerät anhängen...] wählen.

w Dialogfenster [Gerät anhängen] erscheint.

DE

42

u Folgende Werte einstellen:[Hersteller]: [<Alle Hersteller>]In Tabelle: [CiA CANopen] > [CiA Lokales Gerät] > [CANopen Device] wählen.[Name]: Eindeutige Bezeichnung eingeben.



w CODESYS fügt CANopen Device zum Gerätebaum hinzu.

u Im Gerätebaum: Doppelklick auf hinzugefügtes CANopen Device


u CANopen Device wie gewünscht konfigurieren.


Weitere Informationen zur Programmierung der CANopen-Schnittstelle: (Ò CANopennutzen / 66)

6.3.6 J1939: J1939-Manager konfigurierenu Machen Sie sich mit den folgenden CODESYS-Funktionen vertraut:

J1939-Manager: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse > J1939 >J1939-Manager

Die Konfiguration des J1939-Managers basiert auf dem J1939-Stack des ProgrammiersystemsCODESYS 3.5.

Um eine CAN-Schnittstelle als J1939-Manager zu konfigurieren:

ü CAN-Schnittstelle hinzufügen und konfigurieren. (Ò CANbus hinzufügen und konfigurieren / 40)

u Im Gerätebaum: Rechtsklick auf hinzugefügten [CAN]-Knoten.


u Im Kontextmenü [Gerät anhängen...] wählen.

u Dialogfenster [Gerät anhängen] erscheint.

u Folgende Werte einstellen:[Hersteller]: <Alle Hersteller>In Tabelle: [SAE J1939] > [SAE J1939 Manager] wählen.[Name]: Eindeutige Bezeichnung eingeben.



w CODESYS fügt J1939-Manager zum Gerätebaum hinzu.

u Im Gerätebaum: Doppelklick auf hinzugefügten J1939-Manager


u J1939-Manager wie gewünscht konfigurieren.


43

7 Programmierung

7.1 Objekte der SPS-Anwendung mit ecomatDisplay-TemplateAlle Objekte einer SPS-Anwendung sind als Unterelemente des Knotens [Application] im Gerätebaumgelistet. In der Grundkonfiguration des Templates (Ò CODESYS-Projekt erstellen / 19) enthält eineSPS-Anwendung folgende Objekte:

Abb. 2:

Legende:

Objekt Beschreibung

Application Container für Objekte einer SPS-Anwendung.

GlobalVariables Ordner mit Globalen Variablenlisten.

GVL_KeyList Globale Variablenliste zum Auswerten der Gerätetasten.

GVL_KeyList_FT Globale Variablenliste zum Auswerten der Gerätetasten als fallende Flanke.

GVL_KeyList_RT Globale Variablenliste zum Auswerten der Gerätetasten als steigende Flanke.

TextLists Ordner für Textlisten.

TL_eKeyMapCodes Textliste mit Mapping-Codes der Tasten.

ifmImagePool Bildersammlung für die Visualisierung.

Bibliotheksverwalter Bietet Zugriff auf Standard- und gerätespezifische Funktionsbibliotheken.

PLC_PRG(PRG) Bietet Zugriff auf die SPS-Anwendung in der Programmiersprache Funktionsplan (FUP).

PLC_PRG_IN_ST(PRG) Bietet Zugriff auf die SPS-Anwendung in der Programmiersprache Strukturierter Text (ST).Standardmäßig vom Build ausgeschlossen.

Taskkonfiguration Bietet Zugriff auf die Einstellungen der Task-Abarbeitung.

DE

44

Objekt Beschreibung

Task Haupttask mit zugewiesenem PLC_PRG.

VISU_TASK Visualisierungstask mit zugewiesener Visualisierung.

Visualisiungsmanager Bietet Zugriff auf die Eigenschaften der Visualisierungen.

TargetVisu Bietet Zugriff auf die Eigenschaften des Displays.

Visu_Default Bietet Zugriff auf die Visualisierungsseite.

7.2 SPS-Anwendung erstellenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Ò Online-Hilfe > CODESYS Development System > Applikation erstellen

CODESYS legt bei der Erstellung des Projekts automatisch den Programmbaustein PLC_PRG (PRG)an. Der Baustein wird zyklisch abgearbeitet. Andere Programme werden in diesem Bausteinaufgerufen.

Um eine SPS-Anwendung zu erstellen:

u Im Gerätebaum: Doppelklick auf [Application] > [PLC_PRG (PRG)]

w Editor-Fenster zeigt Eingabemaske der gewählten Programmiersprache.

u Programmcode eingeben.

7.2.1 Unterstützte ProgrammiersprachenFolgende Programmiersprachen nach IEC 61131 werden durch die ifm-Funktionsbibliothekenunterstützt:

• Funktionsbausteinsprache FUP/FBD

• Kontaktplan KOP/LD

• Strukturierter Text ST

• Ablaufsprache AS/SFC

• Anweisungsliste AWL

• Continuous Function Chart CFC

7.2.2 PLC_PRG in FUP und STDas Projekt-Template enthält die PRGs PLC_PRG (PRG) und PLC_PRG_IN_ST (PRG) . (Ò Objekteder SPS-Anwendung mit ecomatDisplay-Template / 43)

Das PRG PLC_PRG (PRG) ist in Funktionsplan (FUP) programmiert und wird standardmäßig beimKompilieren berücksichtigt (Darstellung in schwarzer Schrift).

Das PRG PLC_PRG_IN_ST (PRG) ist in Strukturierter Text (ST) programmiert und wirdstandardmäßig beim Kompilieren nicht berücksichtigt (Darstellung in grüner Schrift).

Beide PRGs besitzen die selbe Funktionalität.

Bei Bedarf kann für das Kompilieren das PRG PLC_PRG (PRG) deaktiviert und das PRGPLC_PRG_IN_ST (PRG) aktiviert werden.

Das PRG PLC_PRG (PRG) deaktivieren:

u Rechtsklick auf [PLC_PRG (PRG)] > [Eigenschaften] > [Build] > [Vom Build ausschließen]aktivieren.

45

w Das PRG [PLC_PRG (PRG)] wird im Gerätebaum grün dargestellt und ist für das Kompilierengesperrt.

u [PLC_PRG (PRG)] umbenennen in [PLC_PRG_IN_FUP (PRG)].

w Das in FUP programmierte PRG ist jetzt inaktiv.

Das PRG PLC_PRG_IN_ST (PRG) aktivieren:

u Rechtsklick auf [PLC_PRG_IN_ST (PRG)] > [Eigenschaften] > [Build] > [Vom Build ausschließen]deaktivieren.

w Das PRG [PLC_PRG (PRG)] wird im Gerätebaum schwarz dargestellt und ist für dasKompilieren aktiviert.

u [PLC_PRG_IN_ST (PRG)] umbenennen in [PLC_PRG (PRG)].

w Das in ST programmierte PRG ist jetzt aktiv.

7.2.3 Verfügbarer SpeicherSpeicherbereich Größe

Flash-Speicher 2...8 GB, je nach Gerätetyp Ò Datenblatt

RAM-Speicher 1 GB

7.2.4 Unterstützte Variablentypenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Lokale Variablen: Ò Online-Hilfe > CODESYS Development System > ReferenzProgrammierung > Variablentypen und spezielle Variablen > Lokale Variablen – VAR

Globale Variablenliste: Ò Online-Hilfe > CODESYS Development System > ReferenzProgrammierung > Variablentypen und spezielle Variablen > Globale Variablen -VAR_GLOBAL

Netzwerkvariablen: Ò Online-Hilfe > CODESYS Development System > Daten im Netzwerkaustauschen > Netzwerkvariablen

Das Gerät unterstützt folgende Variablentypen:

Variablentyp Deklaration Gültigkeitsbereich Speicherverhalten

lokal im Deklarationsteil des POU gilt nur im POU, in dem sie deklariertwurden

flüchtig

global in Globaler Variablenliste (GVL) gilt in allen POUs des Projekts flüchtig

global Retain nicht flüchtig

Netzwerk in Netzwerkvariablenlisten Werte stehen allen Projekten im gesamtenNetzwerk zur Verfügung, wenn Variable inderen Netzwerkvariablenlisten enthalten ist.

flüchtig

CAN-Netzwerkvariablen werden nicht unterstützt!

DE

46

7.2.5 Persistente VariablenWerte von persistenten Variablen (Retain-Variablen oder remanente Variablen) bleiben nachAusschalten und Neustarten des Geräts im Speicher erhalten. Größe des remanenten Speichers ÒTechnische Daten

Persistente Variablen nur in der Persistente Variablen-Liste unterhalb der [Application]definieren:

u Rechtsklick auf [Application] > [Objekt hinzufügen] > [Persistente Variablen...].

w Das Fenster [Persistente Variablen hinzufügen] erscheint.

u [Name] eingeben.

u [Hinzufügen] klicken.

w Die neue Persistente Variablen-Liste wird unterhalb der [Application] angelegt.

Anlegen von persistenten Variablen in der Persistente Variablen-Liste wie folgt:

u Die Persistente Variablen-Liste mit Doppelklick im Editor öffnen.

u Definition der persistenten Variablen eingeben und speichern.

Beispiel:

VAR_GLOBAL_PERSISTENT RETAIN

retain_var1: INT;

retain_var2: REAL;

retain_var3: STRING;

END_VAR

7.2.6 Symbolnamen der BedienelementeDen Bedienelementen des Geräts sind bestimmte Symbolnamen fest zugewiesen. Mit diesenSymbolnamen kann der Programmierer bestimmte Aktionen und Funktionen definieren, die bei einerBetätigung des jeweiligen Bedienelements ausgelöst wird. (Ò Funktionen für Bedienelementedefinieren / 56)

Die folgende Abbildung zeigt die Symbolnamen der einzelnen Bedienelemente:

47

Funktionstasten:

xF1

xF2

xF3

xF4

CR105n

CR107n

xF1

xF2

xF3

xF4xF6

xF5

Kreuzwippe:

xRight

xUp

xDown

xKey_Return

xLeft

7.2.7 ArbeitsreihenfolgeEs gibt grundsätzlich zwei Reihenfolgen, ein Projekt für Display-Geräte zu erstellen:

Reihenfolge Vorteile Nachteile

Visualisierung zuerst,anschließend die SPS-Anwendung

• Im Programm kann auf dieParameter in den fertigen Bildernquerverwiesen werden.

• Beim Testen der SPS-Anwendungexistieren die Bilder bereits.

Die in den Visualisierungen benötigten SPS-Parameterund Variablen sind noch nicht definiert.

SPS-Anwendung zuerst,anschließend dieVisualisierung

Alle Parameter und Variablen sind inder SPS-Anwendung definiert, bevorin den Visualisierungen auf sieverwiesen wird.

• Die Parameter aus den Bildern (Bildnummer, Taste,LED usw.) müssen anderweitig ermittelt werden.

• Die SPS-Anwendung kann erst nach dem Erstellender Visualisierung getestet werden.

u Vor Beginn eine möglichst genaue Struktur der Visualisierung und ihrer Inhalte entwerfen!

7.3 ifm-Funktionsbibliotheken nutzenifm stellt für die Programmierung des Geräts unter CODESYS 3.5 folgende Funktionsbibliothekenbereit:

DE

48

Name Beschreibung

ifmCANopenManager Funktionen für die Nutzung der CAN-Schnittstellen als CANopen Manager

ifmDevice Gerätespezifische Funktionen, Datenstrukturen, Aufzählungstypen und globale Variablen

ifmFileUtil Datei- und Hilfsfunktionen

ifmRawCAN Funktionen für die Nutzung der CAN-Schnittstellen als CAN-Layer-2

u Detaillierte Informationen zu den ifm-Funktionsbibliotheken: (Ò ifm-Funktionsbibliotheken / 78)

7.3.1 Gerät konfigurierenUm das Gerät zu konfigurieren, stehen die folgenden Funktionselemente zur Verfügung:

Name Beschreibung Referenz

HideSplashScreen Startbild einblenden / ausblenden. (Ò Common / 96)

LoadSplashScreen Individuelles Startbild laden.

SetSupplySwitchMode Verhalten bei AutoShutdown des Geräts einstellen.

GetDeviceOrientation Eingestellte Geräteausrichtung ermitteln.

SetDeviceOrientation Geräteausrichtung einstellen.

GetSysInfo Systeminformationen auslesen. (Ò System Information / 176)

7.3.2 Gerät steuernUm das Gerät zu steuern, stehen die folgenden Funktionselemente zur Verfügung:


ShutdownDevice Gerät herunterfahren / neu starten. (Ò Common / 96)

BootIntoRecovery Recovery Modus aufrufen.

SetStatusLEDstate Status-LED des Geräts steuern. (Ò Status LED / 162)

LinuxSysCallAsync Befehl an Linux-Betriebssystem des Gerätsübergeben. Asynchrone Ausführung des Befehls.

(Ò System Commands / 168)

LinuxSysCallAsync2 Befehl an Linux-Betriebssystem des Gerätsübergeben. Asynchrone Ausführung des Befehls.

LinuxSysCallSync Befehl an Linux-Betriebssystem des Gerätsübergeben. Synchrone Ausführung des Befehls.

LinuxSysCallSync Befehl an Linux-Betriebssystem des Gerätsübergeben. Synchrone Ausführung des Befehls.

7.3.3 Audiofunktionen ausführen und einstellenUm Audiofunktionen des Geräts auszuführen und zu konfigurieren, stehen die folgendenFunktionselemente zur Verfügung:


AudioPlayer Wiedergeben von Audiodaten. (Ò Audio / 88)

AudioRecorder Aufnehmen von Audiodaten.

GetAudioSettings Auslesen der Audioeinstellungen.

SetAudioSettings Einstellen der Audioeinstellungen.

49

7.3.4 Ethernet-Schnittstelle konfigurierenUm die Einstellungen der Ethernet-Schnittstelle des Geräts zu verwalten, stehen die folgendenFunktionselemente zur Verfügung:


GetEthernetInterfaces Eine Liste mit den verfügbaren Ethernet-Schnittstellen ausgeben.

(Ò Ethernet / 110)

GetIPsettings IP-Einstellungen der Ethernet-Schnittstelle lesen

SetIPsettings IP-Einstellungen der Ethernet-Schnittstelle ändern

GetEthernetBridgeConfig Ethernet Bridge Mode-Einstellungen lesen

SetEthernetBridgeConfig Ethernet Bridge Mode-Einstellungen ändern

u Die aktuellen IP-Einstellungen der Ethernet-Schnittstelle können im Online-Modus über denGerätebaum ausgelesen werden. (Ò Systeminformationen anzeigen / 77)

7.3.5 Gerätetasten konfigurierenUm die integrierten Gerätetasten zu konfigurieren, stehen die folgenden Funktionselemente zurVerfügung:


ControllAllKeyLEDs Alle Tasten-LEDs einstellen. (Ò Keypads / 120)

GetKeyMapping Mapping-Einstellungen des Tastenfeldes auslesen.

ResetAllKeyLED Alle Tasten-LEDs ausschalten.

ResetKeyMapping Mapping-Einstellungen des Tastenfeldeszurücksetzen.

SetKeyAutoRepeat Auto-Repeat-Konfiguration des Tastenfeldeseinstellen.

SetKeyLED Farbe und Nachtmodus einer Tasten-LEDeinstellen.

SetKeyMapping Mapping-Einstellungen des Tastenfeldes einstellen.

7.3.6 Gerätedisplay konfgurierenUm das Gerätedisplay zu konfigurieren, stehen die folgenden Funktionselemente zur Verfügung:


LCDcontrol Display und Hintergrundbeleuchtung steuern. (Ò LCD / 134)

GetBootupBacklight Helligkeitseinstellungen für den Bootvorgangauslesen.

GetLCD_Backlight Helligkeitseinstellungen für den Normalbetriebauslesen.

SetBootupBacklight Helligkeitseinstellungen für den Bootvorgangeinstellen.

SetLCD_Backlight Helligkeitseinstellungen für den Normalbetriebeinstellen.

7.3.7 Auf Gerätesensoren und Eingänge/Ausgänge zugreifenu Technische Details zu den Sensoren, Eingängen und Ausgängen: Ò Montageanleitung,

Datenblatt.

DE

50

Um die Sensoren und die Eingänge des Geräts zu lesen und die Ausgänge zu schreiben, stehen diefolgenden Funktionselemente zur Verfügung:


GetLightSensor Integrierten Lichtsensor auslesen. (Ò Local IO / 144)

GetLightSensorCyclic Integrierten Lichtsensor zyklisch auslesen.

GetLocalInputs Lokale Digitaleingänge auslesen.

GetLocalInputsCyclic Lokale Digitaleingänge zyklisch auslesen.

GetTemperatures Gerätetemperaturen auslesen.

GetTemperaturesCyclic Gerätetemperaturen zyklisch auslesen.

GetVoltages Gerätespannungen auslesen.

GetVoltagesCyclic Gerätespannungen zyklisch auslesen.

SetLocalOutputs Lokale Digitalausgänge schreiben.

7.3.8 Systemzeit konfigurieren/lesenUm die Systemzeit des Geräts zu konfigurieren und auszulesen, stehen die folgendenFunktionselemente zur Verfügung:


GetAvailableTimeZones Liste der verfügbaren Zeitzonen anzeigen. (Ò System Time / 182)

GetSysTime Datum, Zeit und Zeitzone des Geräts auslesen.

GetSysTimeCyclic Datum, Zeit und Zeitzone des Geräts zyklischauslesen.

SetSysTime Datum und Zeit des Geräts einstellen.

SetTimeZone Zeitzone des Geräts einstellen.

GetNTP_Settings NTP-Server-Einstellungen auslesen.

SetNTP_Settings NTP-Server-Einstellungen einstellen.

7.3.9 Dateien verwaltenUm Dateien und Verzeichnisse zu verwalten (kopieren, löschen), stehen die folgendenFunktionselemente zur Verfügung:


USBstorageHandler USB-Gerät verwalten. (Ò Storage / 164)

USBstorageHandlerMulti Mehrere USB-Geräte verwalten.

Copy_Device_To_USB Dateien vom Gerät auf einen USB-Speicherkopieren

(Ò Bibliothek ifmFileUtil.library / 222)

Copy_USB_To_Device Dateien vom USB-Speicher auf das Gerät kopieren

DeleteFile Datei auf Gerät löschen

FileCopy Dateien auf dem Gerät kopieren

SyncFileMemory Inhalte von FLASH-Speicher und Arbeitsspeichersynchronisieren

7.3.10 Touchscreen konfigurierenUm den Touchscreen zu konfigurieren, stehen die folgenden Funktionselemente zur Verfügung:

51


DisableTouchScreen Touchscreen-Funktionalität aktivieren / deaktivieren. (Ò Touch / 178)

SetTouchOptimisationMode Optimierungsmodus für Touchscreen einstellen.

7.3.11 Analogkamera einstellen und steuernUm eine Analogkamera zu steuern und zu konfigurieren, steht das folgende Funktionselement zurVerfügung:


AnalogueCameraWindowControl Analogkamerafenster einstellen und steuern. (Ò Window Control / 196)

7.3.12 Ethernet-Kamera einstellen und steuernUm eine Ethernet-Kamera (IP-Kamera) zu steuern und zu konfigurieren, steht das folgendeFunktionselement zur Verfügung:


IPCameraWindowControl Ethernet-Kamerafenster einstellen undsteuern.

(Ò IPCameraWindowControl / 198)

7.3.13 PDF-Viewer konfigurierenUm einen PDF-Viewer zu steuern und zu konfigurieren, steht das folgende Funktionselement zurVerfügung:


PDF_Viewer PDF-Viewer einstellen und steuern. (Ò PDF_Viewer / 201)

7.3.14 Bildfenster steuern / Screenshot erstellenUm das Fenster zu steuern und zu konfigurieren, stehen die folgenden Funktionselemente zurVerfügung:


WindowControlBase Fenster steuern. (Ò Window Control / 196)

Printscreen Screenshot des Displayinhalts erstellen.

7.3.15 CSV-Dateien verwaltenUm CSV-Dateien zu verwalten (erstellen, ändern, lesen), stehen die folgenden Funktionselemente zuVerfügung:


ReadCSV8Byte Inhalt einer CSV-Datei lesen (Ò Log File / 239)

WriteCSV8Byte Inhalt einer CSV-Datei schreiben

WriteCSV8ByteHeader Header-Bereich einer CSV-Datei schreiben

ReadCSVData Inhalt einer CSV-Datei lesen

WriteCSVData_Linear Inhalt einer CSV-Datei schreiben, Linear-Mode

DE

52


WriteCSVData_Ring Inhalt einer CSV-Datei schreiben, Ring-Mode (Ò Log File / 239)

WriteCSVHeader Header-Bereich einer CSV-Datei schreiben

7.3.16 Hilfsfunktionen nutzenDer Anwender kann folgende Hilfsfunktionen nutzen:


GetMemoryInfoAsync Belegung des Gerätespeichers anzeigen (Ò Support / 256)(Ò Functions / 262)(Ò Parameter File / 235)

ByteArray_To_String Array aus Bytes in eine Zeichenkette konvertieren

Buffer_To_String Array aus Bytes in ein Array aus Zeichenkettenkonvertieren

Pack2Byte_To_Word 2 byte in ein Word konvertieren

Pack4Byte_To_DW 4 Byte in ein Doppelwort konvertieren

Word_To_2Byte Word in 2 Byte konvertieren

_8Byte_To_CSV Array aus 8 Byte in CSV-Format konvertieren

DW_To_4Byte DWORD in 4 Bytes konvertieren

RTC_To_String Laufzeit des Geräts als STRING ausgeben

GetFileSizeAsync Größe einer Datei anzeigen

ReadParmSingleAsync Einzelnen Parametersatz aus Textdatei lesen

WriteParmSingleAsync Einzelnen Parametersatz in Textdatei schreiben

ANY_TYPE_TO_STRING Die Funktion konvertiert einen Datenwert in eineZeichenkette.

ifmCONCAT Die Funktion verbindet 2 Strings und gibt dasErgebnis in einem String aus. (Stringlängedefiniert in ifmGCL.uiGenericLogSizeMax)

ifmFind Die Funktion gibt die Position des Strings sStr2 imString sStr1 zurück. (Stringlänge definiert inifmGCL.uiGenericLogSizeMax)

ifmMID Die Funktion liest einen Teilstring eines anderenStrings aus. (Stringlänge definiert inifmGCL.uiGenericLogSizeMax)

7.4 Visualisierungen nutzenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Ò Online-Hilfe > CODESYS Visualization

Das Gerät unterstützt folgende Visualisierungstypen:

• Target-Visualisierung

• Web-Visualisierung

7.4.1 Einstellungen im Projekt-TemplateBei der Verwendung des Projekt-Templates bei der Projekterstellung (Ò CODESYS-Projekterstellen / 19) sind folgende Elemente für die Visualisierung bereits im Gerätebaum unter[Applikation] enthalten:

53

Objekt Beschreibung

VISU_TASK Visualisierungstask

VisualizationManager Objekt zur Verwaltung der grundlegenden Einstellungen.

TargetVisu Objekt zur Konfiguration der Zielvisualisierung, die auf dem Displayangezeigt wird.

WebVisu Objekt zur Konfiguration der webbasierten Visualisierung, die überNetzwerkzugriff in einem Webbrowser angezeigt wird.

Visu_Default Objekt, das ein Visualisierungsbild enthält.

Diese Objekte sind vorkonfiguriert und können angepasst werden.

7.4.2 Externe Dateien einbindenMögliche Externe Dateien: Audio-Dateien, PDF-Dateien, Bilddateien

Externe Dateien können in das CODESYS-Projekt integriert und auf das Gerät geladen werden:

u Rechtsklick auf [Application > Objekt hinzufügen > Externe Datei...]

w Fenster [Externe Datei hinzufügen] erscheint.

u [Dateipfad] wählen. Weitere Einstellungen wählen.

u Klick auf [Hinzufügen].

w Datei wird dem Projekt als externe Datei hinzugefügt.

w Beim Laden des Projektes auf das Gerät überträgt CODESYS externe Dateien in folgenden Pfadauf dem Gerät: /home/cds-apps/PlcLogic/Application/

Konventionen für Dateinamen

u Groß- und Kleinschreibung im Dateipfad und in Dateinamen beachten.

u Keine Leerzeichen in Dateinamen und Pfaden verwenden.

u Keine Sonderzeichen (z.B. |, \, :, (, ), &, ;, ., ,) in Dateinamen und Pfaden verwenden.

u Die maximale Länge eines Dateinamens beträgt 255 Zeichen.

u Der Dateiname muss im Zielordner eindeutig sein.

7.4.3 Texte und Schriftarten• Die kleinste auf dem Gerät gut lesbare Schriftgröße ist 8 Punkt.

• Es sind Standardschriftarten auf dem Gerät verfügbar.

• Standardmäßig sind folgende Zeichensätze/Schriftarten auf dem Gerät vorhanden: LateinischeSchrift, Arabische Schrift, Kyrillische Schrift

u Bei Bedarf: Weitere True Type Font-Schriftarten installieren, z.B. für asiatische Sprachen.

u Alle für die Visualisierungen benötigten Font-Dateien auf dem CODESYS-PC und auf demGerät installieren. (Ò Schriftart hinzufügen / 39)

• Bereits übersetzte Texte können per Drag& Drop aus dem Quelldokument in die Texteigenschafteines Objektes im Visualiserungseditor kopiert werden. Die Schriftzeichen installierter Sprachen(z.B. kyrillisch, arabisch) bleiben dabei erhalten.

DE

54

7.4.4 Sprachumschaltungu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Text in einer Textliste verwalten: Ò Online-Hilfe > CODESYS Development System > Applikation programmieren >Text in einer Textliste verwalten

Eine Sprachumschaltung in der Visualisierung realisieren:

u Globale Textliste mit den Texten, die in der Visualisierung verwendet werden, in den erforderlichenSprachen erstellen.

u Die Eigenschaft [DynamischeTexte] der Visualisierungsobjekte mit der Textliste und derentsprechenden Text-ID verbinden.

u Möglichkeit zur Sprachumschaltung erstellen, z.B. mit einer Schaltfläche.

Beispiel Sprachumschaltung bei MausklickKonfiguration der Sprachumschaltung mit einer Schaltfläche in der Visualisierung.

Vorgehensweise:

u Eine [Schaltfläche] aus dem Werkzeug-Fenster auf die Visualisierung ziehen.

u In den [Eigenschaften] der Schaltfläche unter [Eingabekonfiguration > OnMouseClick] auf[Konfigurieren…] klicken.

u [Sprachumschaltung] markieren und mit Klick auf [>] übernehmen.

u [Sprachumschaltung] in rechten Bereich markieren.

u Mit Klick auf […] das Fenster zum Zuweisen der Zielsprache öffnen.

u Die Zielsprache, z.B. „en“, wählen und [OK] klicken.

u Die [Eingabekonfiguration] abschließen und [OK] klicken.

w Die Sprachumschaltung ist für die Schaltfläche konfiguriert.

w Die Schaltfläche löst die Sprachumschaltung in der Visualisierung aus, wenn die entsprechendenElemente mit einer übersetzten Textliste verknüpft sind ([Eigenschaften > Dynamische Texte]).

Beispiel Variable CurrentLanguageDie aktuell eingestellte Sprache einer Visualisierung steht in der VariablenVisuElems.CURRENTLANGUAGE , z.B. Deutsch „de“, Englisch „en“, Chinesisch „zh-CHS“.

Das Ändern des Variableninhaltes löst die Sprachumschaltung der Visualisierung aus, wenn dieentsprechenden Elemente mit einer übersetzten Textliste verknüpft sind ([Eigenschaften >Dynamische Texte]).

ü VisuElems.CURRENTLANGUAGE = de

u Wert ändern, z.B. im PRG: VisuElems.CURRENTLANGUAGE := ‘en‘;

w Die Sprache der Visualisierung schaltet um.

7.4.5 Bildersammlung verwendenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Bildersammlung: Ò Online-Hilfe > CODESYS Development System > Applikationprogrammieren > Bildersammlungen verwenden

Um eigene Bilder in Visualisierungen nutzen zu können, muss der Nutzer die entsprechendenBilddateien vorher zu einer Bildersammlung in der Anwendung hinzufügen.

Um eine Bildersammlung zu einem Projekt hinzuzufügen:

u Im Gerätebaum: Knoten [Application] markieren.

55

u [Projekt] > [Objekt hinzufügen...] > [Bildersammlung...] wählen.

w Fenster [Bildersammlung hinzufügen] erscheint.

u Name der Bildersammlung eingeben und mit [Hinzufügen] bestätigen.

w Bildersammlung erscheint im Projektbaum als Unterelement der Anwendung.

Bildereigenschaften

Folgende Bilddateiformate werden unterstützt: BMP, JPG, PNG, SVG, TIF

Bootscreen einstellenDas Bild für den Bootscreen kann über die Bildersammlung im CODESYS-Projekt auf das Gerätgeladen und mit dem FB (Ò LoadSplashScreen / 98) aktiviert werden:

Bild für Bootscreen in die Bildersammlung aufnehmenu Doppelklick auf die Bildersammlung.

w Detailansicht erscheint.

u Rechtsklick auf leere Zeile in der Bildersammlung > [Bilddatei einfügen]

u Pfad zur Bilddatei einstellen.

w Bild ist in Bildersammlung aufgenommen.

Bild auf Gerät ladenDas Bild wird zusammen mit dem CODESYS-Projekt auf das Gerät geladen.

Das Bild wird in folgendem Pfad auf dem Gerät gespeichert: /home/cds-apps/PlcLogic/visu/

Bild mit FB einstellenu FB LoadSplashScreen in PRG einfügen.

u FB parametrieren und in Programmlogik einbinden.

u An Bausteineingang sPathToSplash den Pfad und den Dateinamen der Bootscreen-Bilddateieingeben, z.B. '/home/cds-apps/PlcLogic/visu/testbild.bmp' (incl. Anführungszeichen,Groß-/Kleinschreibung beachten)










DE

56

7.4.6 Visualisierungsmanager nutzenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Visualisierungsmanager: Ò Online-Hilfe > CODESYS Visualization > Visualisierungsmanagermit Clients > Visualisierungsmanager

Der Visualisierungsmanager enthält die allgemeinen Einstellungen der Visualisierungen:

u Im Gerätebaum: Doppelklick auf [Application] > [Visualisierungsmanager]

w Editor-Fenster zeigt Visualisierungsmanager.

u Registerkarte [Einstellungen] wählen.

w Editor-Fenster zeigt allgemeine Einstellungen der Visualisierungen.

u Parameter wie gewünscht einstellen.

Wenn die Key Mapping-Funktion genutzt werden soll, dann muss die Standardtastaturbedienungaktiviert sein.

u In Bereich [Zusätzliche Einstellungen] das Kontrollfeld [Standardtastaturbedienung aktivieren]aktivieren.


Funktionen für Bedienelemente definieren

u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut: Tastaturkonfiguration: Ò Online-Hilfe > CODESYS Visualization > Visualisierungseditor >Registerkarte 'Tastaturkonfiguration'

Über die CODESYS-Funktion „Standardtastaturkürzel“ kann der Anwender den Bedienelementen desGeräts bestimmte Funktionen zuweisen (z.B. Seitenwechsel, Variable umschalten). Die so definiertenTastaturfunktionen gelten für alle Visualisierungen des Projekts.

Um den Bedienelementen der Geräts bestimmte Funktionen zuzuordnen:

u Visualisierungsmanager starten.

w Editor-Fenster zeigt Visualisierungsmanager.

u Im Editor-Fenster: Registerkarte [Standardtastaturkürzel] wählen.

w Editor-Fenster zeigt aktuelle Konfiguration der Tastaturfunktionen.

u Folgende Werte einstellen:1. Spalte [Taste]: Gewünschten Symbolnamen wählen. (Ò Symbolnamen derBedienelemente / 46)2. Spalte [Taste drücken]: EIN-Level definieren3. Spalte [Aktionstyp]: Aktionstyp wählen4. Spalte [Aktion]: Aktion wählen.

u Bei Bedarf weitere Tastaturfunktionen definieren.


w Die Standardtastaturkürzel sind definiert.

Globales Umschalten der Visualisierung

u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:CurrentVisu-Variable verwenden: Ò Online-Hilfe > CODESYS Visualization > Referenz,Benutzeroberfläche > Objekte > Objekt 'Visualisierungsmanager' - 'Einstellungen'

57

Folgend wird die globale Umschaltung der Visualisierung mit Hilfe der globalen CurrentVisu-VariableVisuElems.CurrentVisu beschrieben.

Eigenschaften der CurrentVisu-Variable:• Datentyp String

• Enthält zur Laufzeit der Applikation den Namen der aktuell angezeigten Visualisierung.

• Der Wert kann gelesen und geschrieben werden.

• Durch Schreiben des Wertes in der Applikation erfolgt ein globales Umschalten der aktuellenVisualisierung auf allen Visualisierungsgeräten gleichzeitig (TargetVisu und WebVisu).

Vorgehensweise:u Die CurrentVisu-Variable in den Einstellungen des Visualisierungsmanagers unter [Einstellungen]

> [Allgemeine Einstellungen] aktivieren.

u Die CurrentVisu-Variable kann zur globalen Umschaltung der Visualisierung verwendet werden.

u In der Applikation der CurrentVisu-Variable einen neuen Wert zuweisen, Beispiel:VisuElems.CurrentVisu := 'visu1';

w Die Visualisierung wird global auf allen Visualisierungsgeräten (TargetVisu und WebVisu)gleichzeitig umgeschaltet.

Lokales Umschalten der Visualisierung

u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:CurrentVisu-Variable verwenden: Ò Online-Hilfe > CODESYS Visualization > Referenz,Benutzeroberfläche > Objekte > Objekt 'Visualisierungsmanager' - 'Einstellungen'

Folgend wird die lokale Umschaltung der Visualisierung mit Hilfe von Schaltflächen/Funktionstaste inder Visualisierung beschrieben.

Lokal bedeutet, dass die Visualierungsumschaltung nur auf dem jeweiligen Gerät ausgeführt wird, aufwelchem die Schaltfläche betätigt wurde.

Schaltflächen anlegen und konfigurieren:u Die globale CurrentVisu-Variable VisuElems.CurrentVisu in den Einstellungen des

Visualisierungsmanagers unter [Einstellungen] > [Allgemeine Einstellungen] deaktivieren.

w Die globale Umschaltung der Visualisierung ist deaktiviert.

u 2 Visualisierungen anlegen, z.B. visu1 und visu2 . (Ò Visualisierung erstellen / 59)

u Mit Doppelklick visu1 / visu2 im Editor öffnen.

u Per Drag&Drop eine Schaltfläche aus dem Fenster [Visualisierungswerkzeuge] auf dieVisualisierung ziehen.

u Die Schaltfläche markieren.

w Die Eigenschaften der Schaltfläche werden angezeigt.

u [Eigenschaften] > [Eingabekonfiguration] > [OnMouseClick] > [Konfigurieren...] klicken.

w Das Fenster [Eingabekonfiguration] erscheint.

u [Angezeigte Visualisierung wechseln] markieren und [>] klicken.

u Mit [Auswahl] > [Zuweisen] > [...] die visu2 / visu1 wählen.

u [OK] klicken.

w Der Visualisierungswechsel wird angelegt.

DE

58

w Während der Laufzeit erfolgt mit den Schaltflächen jeweils eine Umschaltung von visu1 nachvisu2 und umgekehrt.

Funktionstaste für die Schaltfläche konfigurieren:ü Die Visualisierungen mit der Visualisierungsumschaltung sind angelegt.

u Die Visualisierungen mit Doppelklick im Editor öffnen.

u Die Schaltfläche für den Visualisierungswechsel markieren.

w Die Eigenschaften der Schaltfläche werden angezeigt.

u Unter [Eigenschaften] > [Eingabekonfiguration] > [Tastaturkürzel] > [Taste] die gewünschteFunktionstaste wählen. Die Funktionstaste muss im Visualisierungsmanager im Register[Standardtastaturkürzel] konfiguriert sein.

u Unter [Eigenschaften] > [Eingabekonfiguration] > [Tastaturkürzel] > [Ereignis(se)] [MouseDown/MouseUp] einstellen.

w Die Funktionstaste ist als Tastaturkürzel für die Schaltfläche konfiguriert.

w Während der Laufzeit kann zusätzlich mit den Funktionstasten des Geräts eine Umschaltung vonvisu1 nach visu2 und umgekehrt ausgelöst werden.

Target-Visualisierung konfigurierenUm die Eigenschaften der erstellten Visualisierung zu ändern:

u Im Gerätebaum: Doppelklick auf [Visualisierungsmanager] > [Target-Visualisierung]

w Editor-Fenster zeigt Eigenschaften der Target-Visualisierung

u Folgende Werte einstellen:1. [Startvisualisierung]: Gewünschte Visualisierung wählen.2. [Aktualisierungsrate ms]: 1503. [Skalierungsoptionen]: Fest4. [Zeichnen mit Antialiasing]: aktiv5. [Standard-Texteingabe]: Gewünschte Eingabeeinheit wählen.


u Hinweise zur Konfiguration des Visualisierungs-Tasks beachten! (Ò Visualisierungs-Taskkonfigurieren / 72)

Web-Visualisierung konfigurierenUm die Eigenschaften der erstellten Visualisierung zu ändern:

u Im Gerätebaum: Doppelklick auf [Visualisierungsmanager] > [WebVisualization]

w Editor-Fenster zeigt Eigenschaften der Web-Visualisierung

u Gewünschte Werte einstellen.


u Hinweise zur Konfiguration des Visualisierungs-Tasks beachten! (Ò Visualisierungs-Taskkonfigurieren / 72)

59

7.4.7 Visualisierung erstellenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Visualisierungs-Editor: Ò Online-Hilfe > CODESYS Visualization > Visualisierungseditor

Visualisierungselemente: Ò Online-Hilfe > CODESYS Visualization >Visualisierungselemente

Um eine Visualisierung für eine SPS-Anwendung zu erstellen:

u Im Gerätebaum: Doppelklick auf [Visualization]

w Visualisierungs-Editor mit Fenster [Werkzeuge] erscheint.

u Gewünschte Visualisierung erstellen.


7.5 Touchscreen-Funktionen nutzen

7.5.1 Hinweiseu Folgende Hinweise bei der Programmierung von Touchscreen-Funktionen beachten:

• Das Gerät besitzt Multitouch-Funktionalität.

• Für die Steuerung kritischer Funktionen ist der Einsatz von Touch-Bedienelementen nicht geeignet(z.B. Motor Start/Stop).

u Für die Realisierung kritischer Funktionen die mechanischen Tasten verwenden!

• Der Touchscreen gibt kein mechanische Rückmeldung, wenn ein grafisches Bedienelementaktiviert wurde (z.B. Schaltfläche). Der Bediener weiß deshalb u.U. nicht, ob seine Eingabeerfolgreich war.

u Visuelles Feedback für grafische Bedienelemente nutzen.

• Ungünstiger Lichteinfall und Verschmutzung der Bildschirmoberfläche können die Erkennbarkeitder grafischen Bedienelemente erschweren.

DE

60

u Touch-Bedienelemente ausreichend groß dimensionieren!

u Für die Beschriftung der Touch-Bedienelemente gut lesbare Schriftart in ausreichenderSchriftgröße nutzen.

• Der Touchscreen des Geräts ist werkseitig kalibriert.

• FB DisableTouchScreen (Ò / 178): Der FB aktiviert / deaktiviert die Touchscreen-Funktionalitätdes Displays. Der Touchscreen ist nach einem Geräteneustart standardmäßig aktiviert.

• FB SetTouchOptimisationMode (Ò / 180): Der FB aktiviert den Optimierungsmodus für einebestimmte Betriebsbedingung. Der Anwender kann zwischen folgenden Betriebsbedingungenwählen:

– Standardbetrieb

– Betrieb mit Handschuhen

– Betrieb bei Regen / Spritzwasser

7.5.2 Eingabeobjekte der Visualisierung konfiguierenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Eingabekonfiguration: Ò Online-Hilfe > CODESYS Visualization > Visualisierungselemente >Elemente konfigurieren > Dialog 'Eingabekonfiguration'

Um die Objekte einer Visualisierung für die Eingabe per Touchscreen zu konfigurieren:

u Eingabeobjekt erstellen (z.B. Schaltfläche)

u Erstelltes Eingabeobjekt markieren.

w Fenster [Eigenschaften] zeigt die Eigenschaften des Eingabeobjekts.

u Unter [Eingabekonfiguration] die Werte wie gewünscht ändern.


7.5.3 Multitouch-Funktionalität nutzenDas Gerät kann als Multitouch-Display eingesetzt werden. Dazu muss die entsprechende Option imCODESYS Visualisierungsmanager aktiviert werden. Die Multitouch-Funktionalität muss über dieCODESYS-Applikation programmiert werden.

Ein Beispielprogramm hierzu findet man im CODESYS Store oder kann über den ifm-Supportangefordert werden.

Die Programmierung von Multitouch Applikationen wird nur erfahrenen Anwendern empfohlen, daeinige Standard-Touch-Eingaben von CODESYS im Multitouch-Mode nicht mehr zu Verfügungstehen.

7.6 Bedienung ohne Touch-FunktionalitätBei Geräten ohne Touch-Funktionalität (Ò Technische Daten):

u Die Bedienelemente (Schaltflächen, Eingabefelder etc.) in der Visualisierung mit denNavigationstasten der Kreuzwippe anwählen. (Ò Kreuzwippe / 26)

w Ein Rahmen kennzeichnet das fokussierte Bedienelement.

u Das Bedienelement mit der [RETURN]-Taste der Kreuzwippe aktivieren.

w Die der Schaltfläche zugeordnete Aktion wird ausgeführt.

61

7.7 Mobile Kameras nutzenAlle Gerätevarianten unterstützen den Betrieb von Ethernet-Kameras.

Einige Gerätevarianten unterstützen den Betrieb von Analogkameras. Ò Technische Daten

Die Bilddaten einer angeschlossenen Kamera werden in ein separates Fenster in der Visualisierunggestreamt.

Schnittstelle Signalart Eigenschaften

Analog-Videoeingang(FBAS)

Analog • Anzahl analoge Anschlüsse → Datenblatt• automatische Erkennung NTSC/PAL• alle Kamerabilder gleichzeitig darstellbar• Umschaltung zwischen allen Kameras möglich• Kamerabild und Visualisierung gleichzeitig (überlagert) darstellbar• Ausfall einer Kamera wird beim Einschalten signalisiert• Kameras können einzeln aktiviert/deaktiviert werden• Rotation des Kamerabildes um 90°/180°/270° während des Betriebs möglich• Skalierung und Spiegeln des Kamerabildes während des Betriebs möglich• Erstellen von Screenshots des Kamerabildes

Ethernet- / IP-Schnittstelle

Digital • Die Anzahl der einzubindenden Kameras ist abhängig vom jeweiligen Gerät und von derprogrammierten Applikation, z.B.: CR1077 mit kleiner Applikation: Mehrerehochauflösende Kamerabilder werden unterstützt; CR1058 mit umfangreicherApplikation: Ein niedrig auflösendes Kamerabild wird unterstützt.

• unterstützte CODECS: RTSP und RTP• alle Kamerabilder gleichzeitig darstellbar• Umschaltung zwischen allen Kameras möglich• Kamerabild und Visualisierung gleichzeitig (überlagert) darstellbar• Ausfall einer Kamera wird beim Einschalten signalisiert• Kameras können einzeln aktiviert/deaktiviert werden• Rotation des Kamerabildes um 90°/180°/270° während des Betriebs möglich• Skalierung und Spiegeln des Kamerabildes während des Betriebs möglich• Erstellen von Screenshots des Kamerabildes

7.7.1 Unterstützte KamerasAnalog-Kameras Ethernet-Kameras

EmpfohleneReferenzkameras

ifm electronic:O2M200, O2M201, O2M202, O2M203

ifm electronic:Artikelnummer ZB086x, z.B. ZB0861, ZB0862,ZB0863, ZB0864

Kameras andererHersteller

• Motec: MC3100-3R (getestet)• Vision Techniques: VT70 (getestet)

• Motec: MCDE3100 (getestet)• Axis: F41 Main Unit / F1035-E Sensor Unit 12m

(getestet)Folgende Standards werden unterstützt:• Codecs:

H264MJPEG

• Protokolle: RTP (Automotive Industry) Real Time Protocol, RTSP (Webcam) Real Time Streaming Protoco

u Nur empfohlene oder getestete Kameras nutzen! Der Betrieb anderer Kameras am Gerät istohne Gewähr!

7.7.2 Analogkamera konfigurieren und steuernu Analogkamera mit dem Gerät verbinden.

DE

62

u Zur Konfiguration und Steuerung einer Analogkamera folgenden Funktionsbaustein verwenden: FBAnalogueCameraWindowControl (Ò / 196)

u Den Kamera-FB wie folgt konfigurieren:

• Kamera mit xEnable = TRUE aktivieren und mit xEnable = FALSE deaktivieren.

• Größe und Position des Kamerabildfensters am FB-Eingang stWindowControls konfigurieren.

• Videostream am FB-Eingang eCamera einstellen.

• Eigenschaften und Steuerbefehle für die Kamera am FB-Eingang stCameraControlskonfigurieren.

Bildauflösungen für analoge KamerasAnaloge Kameras liefern in Abhängigkeit des verwendeten Farbkodierungssystems folgendeBildauflösungen:

• PAL: 720 x 576 (Seitenverhältnis: 5:4)

• NTSC: 720 x 480 (Seitenverhältnis: 3.2)

7.7.3 Ethernet-Kamera konfigurieren und steuernu Ethernet-Kamera und Gerät an einem gemeinsamen Netzwerk anschließen.

u Zur Konfiguration und Steuerung einer Ethernet-Kamera folgenden Funktionsbaustein verwenden:FB IPCameraWindowControl (Ò / 198)

u Den Kamera-FB wie folgt konfigurieren:

• Kamera mit xEnable = TRUE aktivieren und mit xEnable = FALSE deaktivieren.

• Größe und Position des Kamerabildfensters am FB-Eingang stWindowControls konfigurieren.

• Einen eindeutigen Kamera-Index am FB-Eingang usiCameraIndex angeben.

• Eigenschaften und Steuerbefehle für die Kamera am FB-Eingang stCameraControlskonfigurieren.

7.7.4 Region of Interest (ROI) konfigurierenNeben der Anzeige des gesamten Kamerabildes, ist es möglich, einen beliebigen Bildausschnitt anbeliebiger Position und in beliebiger Größe auf dem Display anzuzeigen. Der Bildausschnitt wird alsRegion of Interest (ROI) bezeichnet. Die Technik dient dazu, störende Objekte, z.B. Teile derMaschine, auszublenden. Wenn die Größe der ROI genauso groß ist, wie die Auflösung desKamerabildes, dann wird das komplette Kamerabild auf dem Display angezeigt.

Die folgende Grafik verdeutlicht die Zusammenhänge:

63

Window_Controls Objekt mit Größe und Position des Kamerafensters auf demDisplay.

ROI Objekt mit Größe und Position des Kamerabildausschnittes.

7.8 PDF-Viewer nutzenu PDF-Datei im PDF-Viewer auf dem Gerät anzeigen:

1. PDF-Datei auf das Gerät übertragen, z.B. mit der CODESYS-Funktion [Add Object / External File]. (Ò Externe Dateien einbinden / 53)

2. Zur Konfiguration und Anzeige eines PDFs in einem PDF-Viewer folgenden Funktionsbausteinverwenden: FB PDF_Viewer (Ò PDF_Viewer / 201)

u Den FB PDF_Viewer wie folgt konfigurieren:

1. Pfad und Name der PDF-Datei am FB-Eingang sFileName angeben.

2. Größe und Position des PDF-Viewer-Fensters am FB-Eingang stWindowControls konfigurieren.

3. Eigenschaften und Steuerbefehle für den PDF-Viewer am FB-Eingang iq_stPdfControlskonfigurieren.

7.8.1 BeispielProgrammierbeispiel für den PDF-Viewer:

ü Es existiert bereits eine PDF-Datei auf dem Gerät. (Ò Externe Dateien einbinden / 53)

u Den Pfad der PDF-Datei am FB-Eingang sFileName angeben. Standardpfad bei Dateiübertragung per CODESYS: /home/cds-apps/PlcLogic/Application/filename.pdf

u Konventionen für den Dateinamen beachten. (Ò Konventionen für Dateinamen / 53)

u Bei Bedarf unter [Device > Dateien] überprüfen, ob die Datei auf dem Gerät vorhanden sind.

u Bei Bedarf unter [Device > Dateien] die Schreibweise und die Groß-/Kleinschreibung derDatei prüfen.

u Struktur für die Fenstereigenschaften und die PDF-Anzeige definieren:

VAR

stPDF_Window: stWINDOW_CONFIG;

stPDF_ctrl: stPDF_CONTROLS;

END_VAR

u Fenstereigenschaften für PDF-Viewer definieren:

stPDF_Window.stPosition.uiX:=10; (* X position upper left corner *)

stPDF_Window.stPosition.uiY:=10; (* y position upper left corner *)

stPDF_Window.stSize.uiHeight:=450; (* height of pdf viewer window *)

stPDF_Window.stSize.uiWidth:=600; (* width of pdf viewer window *)

u Eigenschaften zur PDF-Anzeige definieren:

DE

64

stPDF_ctrl.xSetFullScreen:=TRUE; (* full screen mode on *)

FB PDF-Viewer mit den notwendigen Parametern aufrufen:

u Vollbildmodus verwenden.

w Scrollen und Zoomen über die Touchfunktion verursacht eine hohe CPU-Auslastung.

7.9 CSV-Datei-LoggingDas Gerät bietet die Möglichkeit CSV-Dateien zu schreiben und zu lesen, z.B. zum Logging vonMaschinendaten.

7.9.1 CSV-Datei schreibenUm eine CSV-Datei zu schreiben, stehen folgende POUs zur Verfügung:


WriteCSVHeader Kopfzeile in CSV-Datei schreiben (Ò WriteCSVHeader / 254)

WriteCSVData_Linear Daten im Linear-Modus in eine CSV-Dateischreiben.

(Ò WriteCSVData_Linear / 248)

WriteCSVData_Ring Daten im Ring-Modus in eine CSV-Dateischreiben.

(Ò WriteCSVData_Ring / 251)

Nützliche Hilfsfunktionen:


ANY_TYPE_TO_STRING Konvertiert jeden Datentyp in einen String. (Ò ANY_TYPE_TO_STRING / 269)

ifmCONCAT Kombiniert zwei Strings mit jeweils bis zu 1000Zeichen zu einem String mit maximal 1000Zeichen.

(Ò ifmCONCAT / 270)

ifmFIND Durchsucht einen String mit bis zu 1000 Zeichen. (Ò ifmFIND / 271)

ifmMID Gibt einen Teilstring mit bis zu 1000 Zeicheneines String mit bis zu 1000 Zeichen aus.

(Ò ifmMID / 272)

65

Die ifm-Hilfsfunktionen ifmCONCAT, ifmFIND und ifmMID verarbeiten Strings mit einermaximalen Länge von 1000 Zeichen. Die Länge eines Standard-Strings in CODESYS beträgt255 Zeichen. (Ò Stringformat uiGenericLogSizeMax / 65)

Logging jeglicher Datentypen und Schreiben in eine CSV-Datei, z.B. REAL, WORD, DWORD,STRING ist möglich.

Maximal: Logging von bis zu 1000 Zeichen pro Operation und bis zu 10 Log-Operationen proSekunde. Insgesamt: Bis zu 10000 Zeichen pro Sekunde

u Sinnvoll mit Systemressourcen umgehen: Nur so viele Daten speichern, wie für denAnwendungsfall notwendig ist.

u Einen Externen Datenträger z.B. einen USB-Stick als Speicherort für die CSV-Dateiverwenden.

Vorgehensweise:u Mit dem FB WriteCSVHeader die CSV-Datei erstellen und die Kopfzeile in die CSV-Datei

schreiben.

u Die Variablenwerte mit der Funktion ANY_TYPE_TO_STRING in Strings umwandeln.

u Mit der Funktion ifmCONCAT die Daten zu einen String für eine CSV-Dateizeile zusammensetzen.

u Mit dem FB WriteCSVData_Linear oder FB WriteCSVData_Ring die CSV-Dateizeile in dieCSV-Datei schreiben.

7.9.2 CSV-Datei lesenUm eine CSV-Datei zu lesen steht folgendes POU zur Verfügung:


ReadCSVData Lesen von Daten aus einer CSV-Datei, die mitdem FB WriteCSVData_Linear oder FBWriteCSVData_Ring geschrieben wurde.

(Ò ReadCSVData / 241)

7.9.3 Stringformat uiGenericLogSizeMaxDie FBs und Funktionen zum Schreiben und Lesen von CSV-Dateien (Daten-Logging) verwenden denString-Datentyp ifmGCL.uiGenericLogSizeMax . (Ò ifmGCL (GVL) / 275)

Der String-Datentyp ifmGCL.uiGenericLogSizeMax speichert Strings mit einer maximalen Längevon 1000 Zeichen.

Der Standard-String-Datentyp von CODESYS speichert Strings mit einer maximalen Länge von 255Zeichen.

7.10 CODESYS IIoT Libraries SL








DE

66

Mit dem Kauf des Geräts ab Firmware V2 erwirbt der Anwender gleichzeitig eine gültige Lizenz für dieNutzung des Softwarepakets IIoT Libraries SL von CODESYS.

Die Lizenz befindet sich bei Auslieferung auf dem Gerät.

Das Softwarepaket IIoT Libraries SL kann von der CODESYS-Website heruntergeladen werden.

Die IIot Libraries SL bieten beispielsweise folgende Features:

• Einfache Implementierung von Web Services auf dem Gerät

• Einfache Verbindung zu Servern oder Web-Schnittstellen wie NodeRED

• http post / http get

• MQTT Client: Open Source IoT Protocol

• AWS IoT Core Client

• Azure IoT Hub Client

• JSON Utilities

• XML Utilities

• Mail Service: einfaches Senden und Empfangen von Emails

7.11 CANopen nutzenu Hinweise zur Taskonfiguration beachten. (Ò Task-Abarbeitung konfigurieren / 72)

Um in einer Anwendung auf eine für den CANopen-Betrieb konfigurierten CAN-Schnittstellezuzugreifen, stehen folgende POUs zur Verfügung.

u Vorher: Das Gerät als CANopen Manager (Master) konfigurieren. (Ò CANopen: CANopenManager konfigurieren (Master) / 41)

7.11.1 CANopen: SDO senden und empfangenUm Service Data Objects (SDO) zu senden oder zu empfangen, stehen folgende POUs zurVerfügung:


COP_SDOread Service Data Object (SDO) lesen (Ò COP_SDOread / 82)

COP_SDOwrite Service Data Object (SDO) schreiben (Ò COP_SDOwrite / 84)

7.11.2 CANopen: Network Management (NMT)Für die Verwaltung des CANopen-Netzwerks stehen folgende POUs zur Verfügung:


COP_GetNodeState Zustand eines oder mehrerer CANopen-Gerät abfragen (Ò COP_GetNodeState / 80)

COP_SendNMT NMT-Steuerungsbefehl an einen CANopen-Gerät senden (Ò COP_SendNMT / 86)

7.12 RawCAN nutzen (CAN Layer 2)u Hinweise zur Taskonfiguration beachten! (Ò Task-Abarbeitung konfigurieren / 72)

67

Um in einer Anwendung auf eine für den CANopen-Betrieb konfigurierte CAN-Schnittstellezuzugreifen, stehen folgende POU zur Verfügung.

u Vorher: Die CAN-Schnittstelle für den Betrieb als RawCAN (CAN Layer 2) konfigurieren. (Ò RawCAN: CANLayer 2 konfigurieren / 40)

7.12.1 RawCAN: CAN-Netzwerkknoten steuernUm einen Knoten in einem CAN-Netzwerk zu steuern, stehen folgende POUs zur Verfügung:


CAN_Enable CAN-Knoten aktivieren (Ò CAN_Enable / 276)

CAN_Recover CAN-Knoten neu starten (Ò CAN_Recover / 278)

7.12.2 RawCAN: CAN-Nachrichten versenden und empfangenUm Nachrichten auf einem CAN-Netzwerk zu versenden oder zu empfangen, stehen folgende POUszur Verfügung:


CAN_Rx CAN-Nachricht empfangen (Ò CAN_Rx / 284)

CAN_RxMask CAN-Nachrichten empfangen (Ò CAN_RxMask / 286)

CAN_RxRange CAN-Nachrichten empfangen für Standard undExtended Frames

(Ò CAN_RxRange / 288)

CAN_RxRange CAN-Nachrichten empfangen für ExtendedFrames

(Ò CAN_RxRangeExt / 290)

CAN_Tx CAN-Nachricht senden (Ò CAN_Tx / 294)

7.12.3 RawCAN: Remote CAN-Nachrichten anfordern und versendenUm Remote-Nachrichten in ein CAN-Netzwerk anzufordern oder Antworten auf eine Remote-Anforderung zu versenden, stehen folgende POUs zur Verfügung:


CAN_RemoteRequest Anforderung für eine Remote-Nachricht senden

(Ò CAN_RemoteRequest / 280)

CAN_RemoteResponse Auf die Anforderung einer Remote-Nachricht antworten

(Ò CAN_RemoteResponse / 282)

7.13 J1939 nutzenZur Nutzung des Netzwerkprotokolls SAE J1939 stellt die CODESYS GmbH die Bibliothek IoDrvJ1939mit zusätzlichen Funktionen zur Verfügung.

Die Konfiguration über den Gerätebaum wie folgt einstellen:

7.13.1 CAN-Bus anhängenu Im CODESYS-Gerätebaum: [Communication] > [CAN] rechtsklicken.

u [Gerät anhängen...] wählen.


DE

68

u Im Bereich [Gerät]: Hersteller: [ifm electronic] wählen.

u In der Liste darunter: [ifmCANBus] wählen.

u Wahl mit [Gerät anhängen] bestätigen.

u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.

7.13.2 CAN-Schnittstelle zuordnenu Im CODESYS-Gerätebaum: [Communication] > [CAN] > [ifmCANBus] doppelklicken.

u Registerkarte [Allgemein] > [Allgemein] > [Netzwerk]:Diese Einstellung einer CAN-Schnittstelle zuordnen.zulässige Werte = 0...3

u Für [Baudrate (bit/s)] aus dem Listenfeld den gewünschten Wert wählen.

7.13.3 J1939-Manager anhängenu Im CODESYS-Gerätebaum: [Communication] > [CAN] > [ifmCANBus] rechtsklicken.



u Im Bereich [Gerät]: Hersteller: <Alle Hersteller> wählen.

u In der Liste darunter: [Feldbusse] > [SAE J1939] > [J1939 Manager] > [J1939_Manager] wählen.



7.13.4 J1939-Manager parametrierenu Im CODESYS-Gerätebaum: [Communication] > [CAN] > [J1939_Manager] doppelklicken.

u Registerkarte [Allgemein] > [Datenbank] > [Datenbank]:aus der Liste die erforderliche Datenbank wählen.voreingestellt = J1939Default

• Der Anwender kann eigene Datenbanken verwenden.

• Diese müssen sich in folgendem Pfad befinden: C:\ProgramData\CODESYS\J1939 Databases

• Das Verzeichnis ProgramData ist standardmäßig versteckt.

u Mit Menü [Datei] > [Projekt speichern] werden die Werte gültig.

7.13.5 J1939-ECU anhängenu Im CODESYS-Gerätebaum: [Communication] > [CAN] > [ifmCANBus] > [J1939_Manager]

rechtsklicken.



u Im Bereich [Gerät]: Hersteller: <Alle Hersteller> wählen.

u In der Liste darunter: [Feldbusse] > [J1939] > [J1939_ECU] > wählen.


69


7.13.6 J1939-ECU parametrierenu Im CODESYS-Gerätebaum: [Communication] > [CAN] > [J1939_Manager] > [J1939_ECU]

doppelklicken.

u In der Registerkarte [Allgemein] im Abschnitt [Allgemein] je nach Anwendungsfall folgendeEinstellungen vornehmen:

Anwendungsfall [Lokales Gerät] Bedeutung [Bevorzugte Adresse]

• Empfangen von -Broadcast-Daten der ECU• Kein Senden

deaktiviert Adresse der ECU, von der Datenempfangen werden sollen

• Senden von Daten (Broadcast und P2P)• Empfangen von P2P-Daten

aktiviert Adresse des ifm-Controllers

u In der Registerkarte [TX-Signale] Parametergruppen hinzufügen mit Klick auf [PG hinzufügen].

u Mit Menü [Datei] > [Projekt speichern] werden die Einstellungen gültig.

7.14 EtherNet/IP nutzenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

EtherNet/IP Adapter: Ò Online-Hilfe > Feldbusunterstützung > EtherNet/IP Configurator >EtherNet/IP Adapter

EtherNet/IP Scanner: Ò Online-Hilfe > Feldbusunterstützung > EtherNet/IP Configurator >EtherNet/IP Scanner

u Zur Nutzung des Netzwerkprotokolls EtherNet/IP die Konfiguration über den Gerätebaum wie folgteinstellen:

7.14.1 Ethernet-Adapter an ein Ethernet anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet].



u In der Liste [Hersteller] <Alle Hersteller> wählen.

u In der Liste darunter [Feldbusse] > [EtherNet/IP] > [Ethernet Adapter] > [Ethernet] wählen.

u Wahl mit [Gerät anhängen] bestätigen


w Der Ethernet-Adapter ist angehängt.

7.14.2 EtherNet/IP-Adapter anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet] > [Ethernet_1].




u In der Liste darunter [Feldbusse] > [EtherNet/IP] > [EtherNet/IP Local Adapter] > [EtherNet/IPAdapter] wählen.

DE

70



w Der EtherNet/IP-Adapter ist angehängt.

7.14.3 EtherNet/IP-Modul anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet] > [Ethernet_1] >

[Ethernet_IP_Adapter].




u In der Liste darunter [Feldbusse] > [EtherNet/IP] > [EtherNet/IP Module] > [EtherNet/IP Module]wählen.



w Der EtherNet/IP-Modul ist angehängt.

7.14.4 EtherNet/IP-Schnittstelle konfigurierenu Im CODESYS-Gerätebaum [Communication] > [Ethernet] > [Ethernet_1] doppelklicken.

u Schnittstelle wie gewünscht konfigurieren, z.B.:

• IP-Adresse

• Ethernet Device E/A-Abbild

• Ethernet Device IEC-Objekte

7.15 Modbus nutzenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Modbus Master: Ò Online-Hilfe > Feldbusunterstützung > Modbus Configurator > ModbusMaster

Modbus Slave Device: Ò Online-Hilfe > Feldbusunterstützung > Modbus Configurator >Modbus Slave Device

Zur Nutzung des Netzwerkprotokolls Modbus die Konfiguration über den Gerätebaum wie folgteinstellen:

7.15.1 Ethernet-Adapter an ein Ethernet anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet].




u In der Liste darunter [Feldbusse] > [Ethernet Adapter] > [Ethernet Adapter] > [Ethernet] wählen.



w Der Ethernet-Adapter ist angehängt.

71

7.15.2 Modbus TCP Master anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet] > [Ethernet_1].




u In der Liste darunter [Feldbusse] > [Modbus] > [Modbus TCP Master] > [Modbus TCP Master]wählen.



w Der Modus TCP Master ist angehängt.

7.15.3 Modbus TCP Slave Device anhängenu Im CODESYS-Gerätebaum: Rechtsklick auf [Communication] > [Ethernet] > [Ethernet_1] >

[Modbus_TCP_Master].




u In der Liste darunter [Feldbusse] > [Modbus] > [Modbus TCP Slave Device] > [Modbus TCP SlaveDevice] wählen.



w Das Modus TCP Slave Device wird zum Modbus TCP Master hinzugefügt.

7.15.4 Modbus TCP Slave Device konfigurierenu Im CODESYS-Gerätebaum: Doppelklick auf [Communication] > [Ethernet] > [Ethernet_1] >

[Modbus_TCP_Master] > [Modbus_TCP_Slave].

w Das Konfigurationsfenster für den Modbus_TCP_Slave erscheint.

u In folgenden Registerkarten die Parameter wie gewünscht einstellen:

• [General]: Die IP-Adresse des Modbus_TCP_Slaves eingeben. Optional: [Response Timeout] und[Port] eingeben.

• [Modbus Slave Channel]: Die gewünschten Modbus-Channels (Read Holding Registers)hinzufügen.

• [Modbus TCPSlave I/O Mapping]: Variablen definieren und diesen die Werte der Modbus-Registerzuweisen.

u Für weitere Informationen zu den Modbus-Einstellungen, zu der Modbus-Kommunikation undzu der Registerkonfiguration des jeweiligen Modbus Slaves: Ò Betriebsanleitung des ModbusSlaves.

u Nach Abschluss der Modbus-Konfiguration die Variablen im Anwendungsprogrammauswerten.

DE

72

7.16 Task-Abarbeitung konfigurierenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Taskkonfiguration: Ò Online-Hilfe > CODESYS Development System > Applikationprogrammieren > Taskkonfiguration

Die Abarbeitung der Tasks wird durch Parameter gesteuert. Der Anwender kann jeden Task separatparametrieren.

CODESYS legt bei der Projekt- und Visualisierungserstellung mit Verwendung des ecomatDisplay-Templates automatisch folgende Tasks an:

Name Beschreibung Verweis

Task Task für die Abarbeitung des Hauptprogramms[PLC_PRG (PRG)]

(Ò Task konfigurieren / 72)

VISU_TASK Task für die Abarbeitung der Visualisierungen (Ò Visualisierungs-Taskkonfigurieren / 72)

Für Unterprogramme mit POUs, die mehrmals pro SPS-Zyklus ausgeführt werden sollen:

u Neuen Task anlegen.

u Task-Eigenschaften konfigurieren: [Typ]: Zyklisch [Intervall]: gewünschte Zykluszeit

u Unterprogramm mit POUs dem neu erstellten Task zuweisen.

Bei starker Auslastung der CAN-Busse:

u Für jede CAN-Schnittstelle einen separaten Task anlegen.

u Task-Eigenschaften konfigurieren: [Priorität]: hoch (< 5) [Typ]: Zyklisch [Intervall]: gewünschte Zykluszeit (= Übertragungsintervall)

u Unterprogramme mit den POUs für die CAN-Kommunikation den CAN-Tasks zuordnen.

7.16.1 Task konfigurierenDie Task bestimmt die Ausführung des Standardprogramms [PLC_PRG]. Der Programmierer kann derTask zusätzliche Unterprogramme zuweisen.

Um die Eigenschaften der Task einzustellen:

u Im Gerätebaum: Doppelklick auf [Task]

w Im Editor-Fenster: Registerkarte [Konfiguration] zeigt aktuelle Konfiguration der Task.

u Folgende Werte einstellen:[Priorität (0...31)]: 1[Typ]: Zyklisch[Intervall]: t#10ms


7.16.2 Visualisierungs-Task konfigurierenJede Visualisierung wird getrennt vom Programm-Code in einem separaten Task ausgeführt.

Um die Eigenschaften des Visualisierungs-Tasks einzustellen:

73

u Im Gerätebaum: Doppelklick auf [VISU_TASK]

w Im Editor-Fenster: Registerkarte [VISU_TASK] > [Konfiguration] zeigt aktuelle Konfiguration desVisualisierungs-Tasks.

u Folgende Werte einstellen:[Priorität (0...31)]: <16[Typ]: Zyklisch[Intervall]: t#20ms

u Um die Abarbeitung anderer, für die Kernfunktionalität der Applikation wichtiger Tasks nichtzu unterbrechen, dem Visualisierungs-Task ([VISU_TASK]) eine möglichst niedrige Prioritätzuweisen.

u Um die Ressourcen der geräteinternen SPS und des Feldbus-Netzwerks zu schonen, denVISU_TASK in angemessenen zyklischen Intervallen ausführen.


DE

74

8 Betrieb

8.1 CODESYS-Projekt auf das Gerät übertragenu Machen Sie sich mit folgenden CODESYS-Funktionen vertraut:

Applikation auf das Gerät übertragen: Ò Online-Hilfe > CODESYS Development System >Applikation auf die SPS übertragen

Monitoring: Ò Online-Hilfe > CODESYS Development System > Applikation zur Laufzeit >Monitoring von Werten

u Hinweise zu den Zuständen der SPS-Anwendung beachten! (Ò Betriebszustände der SPS-Anwendung / 75)

8.1.1 Anwendung auf ecomatDisplay ladenUm die erstellte Anwendung auf das Gerät zu laden und spannungsausfallsicher zu speichern:

ü Verbindung zwischen PC/Laptop und ecomatDisplay ist hergestellt.

ü Kommunikationspfad ist gesetzt. (Ò Programmierschnittstelle konfigurieren / 21)

ü Projekt ist getestet.

u Im Projektbaum: Auf [Application] klicken.

u [Erstellen] > [Übersetzen] wählen.

w CODESYS erzeugt Programmcode der Anwendung.

u [Online] > [Einloggen] wählen.

w CODESYS wechselt in den Online-Betrieb.

w CODESYS lädt aktive Anwendung auf das Gerät (Download).

w Anwendung auf dem Gerät ist im STOP-Zustand.

u [Debug] > [Start] wählen.

w Anwendung auf dem Gerät wechselt in den RUN-Zustand.

u [Online] > [Bootapplikation erzeugen] wählen.

w CODESYS speichert die Anwendung spannungsausfallsicher auf dem Gerät.

8.1.2 Anwendung auf dem Gerät löschenUm eine auf dem Gerät gespeicherte Anwendung zu löschen:

u Im Gerätebaum: Auf [Application] klicken.



u Im Gerätebaum: Doppelklick auf [Device (ecomatDisplay)]

u Editor-Fenster zeigt Geräteeinstellungen.

u Registerkarte [Applikationen] wählen.

u Auf [Liste aktualisieren] klicken.

w Editor-Fenster zeigt die auf dem Gerät gespeicherten Anwendungen.

u Auf [Alle löschen] klicken, um alle Anwendungen zu löschen.- oder -Gewünschte Anwendung wählen und auf [Löschen] klicken, um eine einzelne Anwendung zulöschen.

75

w CODESYS löscht die gewählten Anwendungen auf dem Gerät.

8.2 Betriebszustände der SPS-AnwendungDie auf dem ecomatDisplay gespeicherten Anwendungen werden in separaten Tasks unabhängigvoneinander ausgeführt. Eine Anwendung kann folgende Betriebszustände einnehmen:

• EntladenAuf dem Gerät ist keine Anwendung gespeichert.

• RUN– Die Anwendung ist auf dem Gerät gespeichert.– Die Anwendung wird zyklisch abgearbeitet.

• STOP– Die Anwendung ist auf dem Gerät gespeichert.– Die Anwendung wird nicht abgearbeitet.

8.2.1 Betriebszustand der SPS-Anwendung anzeigenUm den aktuellen Betriebszustand der auf dem Gerät gespeicherten SPS-Anwendung anzuzeigen:

u Im Gerätebaum: Symbol [Application] zeigt den aktuellen Zustand- oder -Im Online-Betrieb: CODESYS-Statusleiste zeigt den aktuellen Zustand der Anwendung.

8.2.2 SPS-Anwendung startenUm die Ausführung der SPS-Anwendung zu starten:

u Im Gerätebaum: Rechtsklick auf [Application] und [Aktive Applikation setzen] wählen.



u [Debug] > [Starten] wählen.

w Anwendung wechselt in den RUN-Zustand.

u Optional: Vorgang für weitere Anwendungen wiederholen.

8.2.3 SPS-Anwendung stoppenUm die Ausführung der SPS-Anwendung zu stoppen:

u Im Gerätebaum: Rechtsklick auf [Application] und [Aktive Applikation setzen] wählen.



u [Debug] > [Stop] wählen.

w Anwendung wechselt in den STOP-Zustand.

u Optional: Vorgang für weitere Anwendungen wiederholen.

8.3 Reset

8.3.1 Unterstützte Reset-VariantenDie folgende Tabelle zeigt die von der geräteinternen SPS unterstützten Reset-Varianten und dasresultierende System-Verhalten:

DE

76

Reset-Variante System-Verhalten Auslösende Aktionen

Reset (Warm) • Die Anwendung geht in den STOP-Zustand.

• Standard Variablen (VAR) derAnwendung werden neu initialisiert.

• Remanente Variablen (VAR RETAIN)der Anwendung behalten ihre aktuellenWerte.

(Ò Anwendung rücksetzen (warm) / 76)

Reset (Kalt) • Die Anwendung geht in den ZustandSTOP.

• Alle Variablen (VAR, VAR RETAIN) derAnwendung werden neu initialisiert.

(Ò Anwendung rücksetzen (kalt) / 76)

Reset (Ursprung) • Die Anwendung geht in den STOP-Zustand.

• Die Anwendung auf der SPS wirdgelöscht.

• Alle Variablen (VAR, VAR RETAIN) derAnwendung werden neu initialisiert.

• SPS wird in Urzustand rückgesetzt.

(Ò Anwendung rücksetzen (Ursprung) / 76)

Eine Variable, die ohne einen Initialisierungswert deklariert wurde, wird mit demvariablenspezifischen Standardwert initialisiert (z.B. INT = 0 ).

8.3.2 Anwendung rücksetzen (warm)Um die Anwendung rückzusetzen:

u Im Gerätebaum: [Application] wählen und als aktive Applikation



u [Online] > [Reset warm] wählen, um die Anwendung rückzusetzen.


w Standard-Variablen werden neu initialisiert.

w Retain-Variablen behalten ihre Werte.

8.3.3 Anwendung rücksetzen (kalt)Um die Anwendung rückzusetzen:

u Im Gerätebaum: [Application] wählen.



u [Online] > [Reset kalt] wählen, um die Anwendung rückzusetzen.


w Alle Variablen werden neu initialisiert.

8.3.4 Anwendung rücksetzen (Ursprung)Um die Anwendung rückzusetzen:

u Im Gerätebaum: [Application] wählen.



u [Online] > [Reset Ursprung] wählen, um die Anwendung rückzusetzen.

77

w Anwendung wechselt in den STOP-Zustand und wird gelöscht.

w Alle Variablen werden neu initialisiert.

w SPS wird in Urzustand rückgesetzt.

8.4 Systeminformationen anzeigenIm Online-Modus zeigt der Gerätebaum die aktuelle Werte der folgenden Systemparameter an:

Parameter Beschreibung Mögliche Werte

[IP-Settings] IP-Einstellungen --

• [IP Address] IP-Adresse des Geräts z.B. 192.168.0.100

• [IP Mask] Subnet-Maske des Netzwerks z.B. 255.255.255.0

• [Gateway Address] IP-Adresse des Netzwerk-Gateways z.B. 192.168.0.2

[Version Firmware] Version der installierten Firmware z.B. V1.4.0

[Serial Number Device] Seriennummer des Geräts z.B. 1511AB019

Um die Systeminformationen des Geräts anzuzeigen:

u Verbindung zwischen CODESYS und ecomatDisplay herstellen.



u Im Gerätebaum: Doppelklick auf [System_Info].

u Im Editor-Fenster: Registerkarte [Parameter] wählen.

w Im Editor-Fenster: Tabelle zeigt aktuelle Werte der Systemparameter.

DE

78

9 ifm-FunktionsbibliothekenDieses Kapitel enthält die detaillierte Beschreibung der Funktionsbibliotheken, die die ifm electronic fürdie Programmierung des Geräts unter CODESYS 3.5 bereitstellt.

9.1 Verhaltensmodell der ifm-FunktionsbausteineDieses Kapitel beschreibt die Verhaltensmodelle der ifm-Funktionsbausteine für das ecomatDisplay.

9.1.1 AllgemeinDie 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 / 78)

Alle Ein- und Ausgänge, die zum ifm-Verhaltensmodell gehören, sind im FB als oberste angeordnet.

Meldungen / Diagnose-Codes der FunktionsbausteineStatus-/Diagnose-/Fehler-Meldungen der Funktionsbausteine sind im globalen Enum DIAG_INFOdefiniert.

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 Funktionsbausteinswährend des normalen Ablaufes.

DIAG Diagnosemeldung Diagnosemeldungen beinhalten Informationen zu einem Fehlerereignis. Sie setzen sichnach Verschwinden des Fehlerereignisses von selbst zurück und können optional durchdie Applikation ausgewertet werden.

ERR Fehlermeldung Fehlermeldungen beinhalten Informationen zu einem Fehlerereignis. Sie müssen nachVerschwinden 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 / 78)

9.1.2 Verhaltensmodell ENABLEFunktionsbausteine, die das Verhaltensmodell ENABLE verwenden, werden zyklisch abgearbeitet,solange der Zustand am Eingang xEnable = TRUE ist.

Wenn xEnable = FALSE ist, wird der Funktionsbaustein nicht ausgeführt. Alle Bausteinausgängewerden auf ihre voreingestellten Standardwerte rückgesetzt und nicht aktualisiert. In diesem Fall gilt:xError = FALSE und eDiagInfo = STAT_INACTIVE.

79

Funktionsbausteine, die keinen xEnable-Eingang besitzen, werden zyklisch ab Start der Applikationabgearbeitet. Erst mit Stopp der Applikation wird die Abarbeitung beendet. Das Verhalten entsprichtdem eines Funktionsbausteins mit einem dauerhaften TRUE am Eingang xEnable.

Reaktion auf FehlerIm Fehlerfall wird xError auf TRUE gesetzt und eDiagInfo zeigt den Diagnose-Code an, solangexEnable = TRUE ist.

Alle anderen Ausgänge des Funktionsbausteins werden abhängig vom Datentyp rückgesetzt auffolgende Werte:

Datentyp Wert

numerisch 0 / 0.0

String Leerstring

BOOL/Bit FALSE

9.1.3 Verhaltensmodell EXECUTEFunktionsbausteine, die das Verhaltensmodell EXECUTE besitzen, werden nach einer steigendenFlanke am Eingang xExecute einmalig abgearbeitet.

Das Signal an xExecute muss solange auf TRUE gesetzt bleiben, bis xDone = TRUE oderxError = TRUE wird. Wird das Signal an xExecute vorher FALSE, wird die Bausteinbearbeitung ohneErgebnis abgebrochen.

Hat der Funktionsbaustein seine Funktion erfolgreich ausgeführt, wird der Ausgang xDone für einenZyklus auf TRUE gesetzt.

Reaktion auf FehlerIm 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 werdenkonnte.

Alle anderen Ausgänge des Funktionsbausteins werden abhängig vom Datentyp rückgesetzt auffolgende Werte:

Datentyp Wert

numerisch 0 / 0.0

String Leerstring

BOOL/Bit FALSE

9.2 Bibliothek ifm_ecomatDisplay_CntDie Bibliothek ist eine Container-Bibliothek. Sie enthält alle für die Programmierung des Gerätsbenötigten Funktionsbibliotheken.

• ifmCANopenManager (Ò / 80)

• ifmDevice_ecomatDisplay (Ò / 88)

• ifmFileUtil (Ò / 222)

• ifmRawCAN (Ò / 276)

DE

80

9.3 Bibliothek ifmCANopenManager.libraryDie Bibliothek enthält Programmbausteine (POU) und Datenstrukturen für die Programierung derFunktionalität eines CANopen Managers.

9.3.1 COP_GetNodeStateBaustein-Typ: Funktionsbaustein (FB)

Verhaltensmodell: EXECUTE

Bibliothek: ifmCANopenManager.library

Symbol inCODESYS:

BeschreibungDer FB gibt den aktuellen Zustand eines CANopen-Knotens aus.

EingangsparameterParameter Datentyp Bedeutung Mögliche Werte

xExecute BOOL Ausführung des FB steuern • FALSE: FB nicht ausführen• TRUE: FB ausführen.

Den FB solange ausführen(xExecute = TRUE), bis dieBausteinausführung erfolgreich beendetist (xDone = TRUE).Wenn xDone = TRUE, dann denEingang xExecute auf FALSErücksetzen.

eChannel CAN_CHANNEL

Identifier der CAN-Schnittstelle (Ò CAN_CHANNEL (ENUM) / 207)

usiNode USINT ID des CANopen-Knotens • 0: lokales Gerät• 1...127: ID des CANopen-Knotens

AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte

xDone BOOL Anzeige, ob FB-Ausführungerfolgreich beendet ist

FALSE FB wird ausgeführt

TRUE • FB erfolgreich ausgeführt• FB kann erneut aufgerufen

werden

xError BOOL Anzeige, ob bei der FB-Ausführungein Fehler aufgetreten ist

FALSE kein Fehler aufgetreten oderder FB wird noch ausgeführt

TRUE • Fehler aufgetreten• Aktion konnte nicht

ausgeführt werden• Diagnoseinformationen

beachten

eDiagInfo DIAG_INFO Diagnoseinformationen → Liste unten (Diagnose-Codes)

eNMT_State NMT_STATES

Zustand des CANopen-Knotens → NMT_STATES (ENUM) (→ S. )

81

Diagnose-Codes:

• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.

• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.

• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.

• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!

• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.

• ERR_DEVICE_NOT_AVAILABLE Fehler: Gewähltes Gerät unbekannt / nicht konfiguriert

• ERR_INVALID_CHANNEL Fehler: Gewählter Kommunikationskanal unbekannt / nicht konfiguriert

DE

82

9.3.2 COP_SDOreadBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest den Inhalt eines Service Data Objects (SDO) und schreibt diesen in einen Pufferspeicher.Das SDO wird ausgewählt über die CAN-Schnittstelle, die ID des CANopen-Knotens sowie Index undSubindex des Objektverzeichnisses.

Der CANopen-Knoten muss innerhalb einer vom Nutzer definierten Zeit auf die Anfrage des FBantworten.







uiIndex UINT Index im Objektverzeichnis

usiSubIndex USINT Subindex des Indexes imObjektverzeichnis

pData Pointer to USINT Pointer auf den Pufferspeicher

udiBuffLen UDINT Größe des Pufferspeichers (in Byte)

tTimeout TIME max. Antwortzeit z.B. T#25ms

Ausgangsparameter

Parameter Datentyp Bedeutung Mögliche Werte

xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist


TRUE • FB erfolgreichausgeführt

• FB kann erneutaufgerufen werden

83


xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist

FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt


ausgeführt werden• Diagnoseinformation

en beachten


udiLen UDINT Anzahl der empfangenen Bytes

Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Mindestens ein Eingangsparameter ist ungültig oder außerhalb desWertebereichs.

• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nichtbeschreiben und wird nicht übertragen



• ERR_SDO_IDX_NOT_EXIST Fehler: Objekt, das gelesen/geschrieben werden soll, existiert nicht

• ERR_SDO_SUBIDX_NOT_EXIST Fehler: Unterobjekt, das gelesen/geschrieben werden soll, existiert nicht

• ERR_SDO_UNSUPPORTED_ACCESS

Fehler: Lese-/Schreibzugriff auf das gewählte Objekt ist nicht erlaubt

• ERR_SDO_DATA_TYPE Fehler: Datentyp der zu schreibenden Daten passt nicht zum Objekt oderist außerhalb des Wertebereichs

DE

84

9.3.3 COP_SDOwriteBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt den Inhalt eines Service Data Objects (SDO). Das SDO wird ausgewählt über dieCAN-Schnittstelle, die ID des CANopen-Knotens sowie Index und Subindex desObjektverzeichnisses.







uiIndex UINT Index im Objektverzeichnis

usiSubIndex USINT Subindex des Indexes imObjektverzeichnis

pData Pointer to USINT Pointer auf den Pufferspeicher

udiLen UDINT Anzahl der empfangenen Bytes

tTimeout TIME max. Antwortzeit z.B. T#25ms




TRUE • FB erfolgreich ausgeführt• FB kann erneut aufgerufen werden

xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist

FALSE kein Fehler aufgetreten oder der FBwird noch ausgeführt

TRUE • Fehler aufgetreten• Aktion konnte nicht ausgeführt

werden• Diagnoseinformationen beachten

85



Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Mindestens ein Eingangsparameter ist ungültig oder außerhalb desWertebereichs.


• ERR_TIMEOUT Fehler: Die zulässige maximale Ausführungszeit wurde überschritten. Die Aktionwurde nicht abgeschlossen.



• ERR_SDO_IDX_NOT_EXIST Fehler: Objekt, das gelesen/geschrieben werden soll, existiert nicht

• ERR_SDO_SUBIDX_NOT_EXIST Fehler: Unterobjekt, das gelesen/geschrieben werden soll, existiert nicht

• ERR_SDO_UNSUPPORTED_ACCESS

Fehler: Lese-/Schreibzugriff auf das gewählte Objekt ist nicht erlaubt

• ERR_SDO_DATA_TYPE Fehler: Datentyp der zu schreibenden Daten passt nicht zum Objekt oder istaußerhalb des Wertebereichs

DE

86

9.3.4 COP_SendNMTBaustein-Typ: Funktionsbaustein (FB)



Symbol inCODESYS:

BeschreibungDer FB sendet einen Befehl zur Steuerung eines CANopen-Knotens.







usiNMTservice NMT_SERVICE

Befehl zur Steuerung des CANopen-Knotens

(Ò NMT_SERVICE (ENUM) / 88)




TRUE • FB erfolgreich ausgeführt• FB kann erneut aufgerufen

werden


FALSE kein Fehler aufgetreten oder derFB wird noch ausgeführt



beachten


Diagnose-Codes:


• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.


87



DE

88

9.3.5 NMT_SERVICE (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

NMT_SERVICE

Befehl zur Steuerungdes CANopen-Knotens

SET_PRE_OPERATIONAL

Preoperational-Zustand setzen INT 1

SET_OPERATIONAL Operational-Zustand setzen INT 2

RESET_NODE CAN-Knoten zurücksetzen INT 3

RESET_COMM Kommunikation zurücksetzen INT 4

STOP_NODE CAN-Knoten stoppen INT 5

9.3.6 NMT_STATES (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

NMT_STATES

Zustand des CAN-Netzwerkes INIT Initialisierung INT 1

PREOP Preopertional INT 2

OPERATIONAL Operational INT 3

STOP STOP INT 4

NOT_AVAILABLE Nicht verfügbar INT 5

UNKNOWN unbekannt INT 6

9.4 Bibliothek ifmDevice_ecomatDisplay.libraryDie Bibliothek enthält Folgendes:

• gerätespezifische Datenstrukturen

• gerätespezifische Aufzählungstypen

• gerätespezifische globale Variablen und Konstanten

• gerätespezifische Funktionen

9.4.1 Audio

AudioPlayerBaustein-Typ: Funktionsbaustein (FB)

Verhaltensmodell: ENABLE

Bibliothek: ifmDevice_ecomatDisplay.library

Symbol in CODESYS:

BeschreibungDer FB aktiviert / deaktiviert den Audio Player des Geräts. Der Audio Player bietet folgendeFunktionen:

• Inhalt einer Audio-Datei wiedergeben (unterstützte Formate: .wav, .ogg)

89

• Abspielvorgang steuern (Pause, Wiederholen, Startposition)

• Wiedergabelautärke einstellen

• Spieldauer der Audio-Datei anzeigen

• Aktivität des Audio Players anzeigen (an, aus)

EingangsparameterParameter Datentyp Beschreibung Mögliche Werte

xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren

TRUE FB aktivieren

sFileName STRING(255) Pfad und Name der Audio-Datei z.B. \??\??\sound1.wav

xPause BOOL steuert die "Pause"-Funktion desAudio Players

FALSE Wiedergabefortsetzen undStummschaltungdeaktiviert

TRUE Wiedergabe pausiertund Stummschaltungaktiviert

xRepeat BOOL steuert die "Repeat"-Funktion desAudio Players

FALSE Wiederholungdeaktiviert

TRUE Wiederholungaktiviert

usiVolume USINT Wiedergabe-Lautstärke 0...100

AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte


FALSE kein Fehleraufgetreten oder derFB wird nochausgeführt

TRUE • Fehler aufgetreten• Aktion konnte

nicht ausgeführtwerden

• Diagnoseinformationen beachten

eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)

xPlaying BOOL zeigt, ob die Audio-Datei abgespieltwird

FALSE Audio-Datei wirdnicht gespielt

TRUE Audio-Datei wirdgespielt

tTotalDuration TIME Gesamtlänge der Audio-Datei(Spieldauer) in Sekunden.

uiMediaField UINT Dateisystem-ID der Audio-Datei 0...65536

DE

90

AudioRecorderBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB aktiviert / deaktiviert den Audio-Recorder des Geräts. Der Audio-Recorder bietet folgendeFunktionen:

• Audio-Signal am Line-In-Eingang des Geräts aufnehmen und als Datei speichern (unterstütztesFormat: .wav)

• Aufnahmevorgang steuern (Start/Stopp, Pause / Fortsetzen)

• Länge der Aufnahme anzeigen

• Aktivität des Audio-Recorders anzeigen (aktiv/Pause)

• Überschreiben der Datei, sofern bereits vorhanden

• Dateiname während der Ausnahme ändern

• Fehlerdiagnose anzeigen



TRUE FB aktivieren

sFileName STRING(255) Pfad und Name der Audio-Datei z.B. \??\??\sound1.wav

xPause BOOL steuert die "Pause"-Funktion des Audio Recorders FALSE Aufnahme fortsetzen

TRUE Aufnahme pausiert





ausgeführt werden• Diagnoseinformatio

nen beachten


xRecording BOOL zeigt, ob die Audio-Datei aufgenommen wird FALSE Audio-Datei wird nichtaufgenommen; Pauseaktiv

TRUE Audio-Datei wirdaufgenommen

tDuration TIME Länge der aufgenommenen Audio-Datei inSekunden

91

Diagnose-Codes:


• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.


• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt

• STAT_PAUSED Zustand: FB/Funktion ist im Zustand "Pause".

• STAT_RECORDING Zustand: FB/Funktion ist im Zustand "Aufnehmen".

• ERR_INVALID_VALUE Fehler: Mindestens ein Eingangsparameter ist ungültig. Funktionsaufruf wurdeabgebrochen.Ungültige Werte:• Wert an sFileName ist NULL (z.B. '')• Wert an sFileName endet auf "/" (z.B ein Verzeichnis)• Wert an sFileName enthält fortlaufende Schrägstriche (z.B. "////")• Verzeichnis oder Unterverzeichnis existiert nicht• Audio-Dateiformat wird nicht unterstützt (nur .wav)

• ERR_MULTIMEDIA_RECORDING_START

• Fehler beim Start der Aufnahme

• ERR_MULTIMEDIA_RECORDING:STOP

• Fehler beim Beenden der Aufnahme

• ERR_MULTIMEDIA_RECORDING_PAUSE

• Fehler beim Pausieren der Aufnahme

• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!

DE

92

GetAudioSettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die aktuell eingestellten Lautstärkewerte der verschiedenen Audio-Kanäle (Master,Lautsprecher L + R, Kopfhörer L + R, Line-In) und gibt die Werte aus.

Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiterenFB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.

u Nur eine Instanz des FB innerhalb der Anwendung aufrufen!


xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt

sonst. keine Auswirkungenauf FB-Abarbeitung


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendetist








nen beachten


stSettings stAUDIO_SETTINGS Lautstärke-Einstellungen der Audio-Kanäle desGeräts.

Ò stAUDIO_SETTINGS (STRUCT)

Diagnose-Codes:


• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sindnoch nicht verfügbar. Einige Ausgangswerte werden in jedemSPS-Zyklus aktualisiert.

93

• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet.An den Ausgänge liegen gültige Ergebnisse an.

• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanzwird nicht ausgeführt


• ERR_MULTIMEDIA_GET_MASTER_VOLUME Fehler beim Lesen der Master-Lautstärke

• ERR_MULTIMEDIA_GET_SPEAKER_VOLUME Fehler beim Lesen der Lautsprecher-Lautstärke

• ERR_MULTIMEDIA_GET_HEADPHONE_VOLUME Fehler beim Lesen der Kopfhörer-Lautstärke

• ERR_MULTIMEDIA_GET_LINEIN_VOLUME Fehler beim Lesen der LineIn-Lautstärke

• ERR_MULTIMEDIA_GET_RECORDING_VOLUME Fehler beim Lesen der Aufnahme-Lautstärke

DE

94

SetAudioSettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB konfiguriert die Lautstärkewerte der verschiedenen Audio-Kanäle (Master, Lautsprecher L + R,Kopfhörer L + R, Line-In) des Geräts. Die unterlagerten Systemfunktionen werden nur beiWertänderung ausgeführt.





TRUE FB aktivieren

stSettings stAUDIO_SETTINGS Lautstärke-Einstellungen der Audio-Kanäle desGeräts.







nen beachten


xPrepared BOOL Zustand der FB-Ausgänge FALSE FB-Ausgänge ungültig;FB wird nochabgearbeitet

TRUE FB-Ausgänge gültig;FB wurde abgearbeitet

Diagnose-Codes:



95


• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanzwird nicht ausgeführt


• ERR_MULTIMEDIA_SET_MASTER_VOLUME Fehler beim Einstellen der Master-Lautstärke

• ERR_MULTIMEDIA_SET_SPEAKER_VOLUME Fehler beim Einstellen der Lautsprecher-Lautstärke

• ERR_MULTIMEDIA_SET_HEADPHONE_VOLUME Fehler beim Einstellen der Kopfhörer-Lautstärke

• ERR_MULTIMEDIA_SET_LINEIN_VOLUME Fehler beim Einstellen der LineIn-Lautstärke

• ERR_MULTIMEDIA_SET_RECORDING_VOLUME Fehler beim Einstellen der Aufnahme-Lautstärke

DE

96

9.4.2 Common

HideSplashScreenBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB steuert die Anzeige des Startbilds (Splashscreen) auf dem Display. Standardmäßig wird dasStartbild nach Booten des Geräts angezeigt. Das Startbild wird mit dem FB LoadSplashScreeneingestellt.






xHide BOOL Startbild (Splashscreen) einblenden /ausblenden.

FALSE Startbild(Splashscreen)ausblenden undVisualisierunganzeigen.

TRUE Startbild(Splashscreen)anzeigen undVisualisierungausblenden.


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt





97

Parameter Datentyp Beschreibung Mögliche Werte




nen beachten


stSettings stAUDIO_SETTINGS

Lautstärke-Einstellungen der Audio-Kanäle desGeräts.


Diagnose-Codes:





• ERR_HIDE_SPLASH_SCREEN Fehler: Fehler beim Anzeigen/Ausblenden des Startbildes.ifm-Service-Center kontaktieren!


DE

98

LoadSplashScreenBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB lädt eine Bilddatei in den Flash-Speicher des Geräts. Die Bilddatei wird ab dem nächstenNeustart des Geräts als Startbild (Splashscreen) verwendet.

Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein.


Jeder Aufruf des FB führt eine Schreiboperation auf den Flash-Speicher des Geräts aus.

u Funktionsbaustein im Programmcode nicht zyklisch aufrufen!













sPathToSplash STRING absoluter Verzeichnispfad zur Bilddatei z.B. '/home/cds-apps/PlcLogic/visu/splashscreen.bmp'



99


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist TRUE • FB erfolgreichausgeführt






nen beachten


Diagnose-Codes:





• ERR_INVALID_VALUE Fehler: Dateipfad für Startbild an sPathToSplash ist ungültig. Funktionsaufruf wurdeabgebrochen.Ungültige Werte für sPathToSplash:• Wert ist NULL (z.B. '')• Wert auf "/" (z.B ein Verzeichnis)• Wert enthält fortlaufende Schrägstriche (z.B. "////")

• ERR_SET_SPLASH_SCREEN Fehler: Fehler beim Laden des Startbildes.ifm-Service-Center kontaktieren!


DE

100

SetSupplySwitchModeBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB aktiviert oder deaktiviert die automatische Abschaltung (AutoShutdown) des Geräts inAbhängigkeit des Spannungswerts an Klemme 15.

Standardeinstellung nach Einschalten des Geräts: Die automatische Abschaltung ist aktiv. Das Gerätfährt herunter, sobald der Spannungswert an Klemme 15 < 50% des Spannungswertes an Klemme30.

Wenn die automatische Abschaltung inaktiv ist: Das Gerät bleibt eingeschaltet, bis der FBShutdownDevice aufgerufen wird.






xAutoShutdown BOOL Automatische Abschaltungeinschalten / ausschalten

FALSE AutomatischeAbschaltungdeaktiviert

TRUE. AutomatischeAbschaltung aktiviert









nen beachten

101



Diagnose-Codes:





• ERR_SET_SUPPLY_SWITCH_MODE

Fehler: Fehler beim Aktivieren / Deaktivieren der automatischen Abschaltung.ifm-Service-Center kontaktieren!


DE

102

ShutdownDeviceBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB löst in Abhängigkeit des Spannungswertes an Klemme 15 ein geordnetes Herunterfahren odereinen Neustart des Geräts aus.

Zustand /Spannungswert von Klemme 15 Art des Shutdowns

AUS = FALSE => kleiner 50% von Spannungswert an Klemme 30 Gerät herunterfahren

EIN = TRUE / größer ca. 4 V Gerät neustarten














nen beachten


Diagnose-Codes:

103





• ERR_SHUTDOWN_DEVICE Fehler: Fehler beim Abschalten.ifm-Service-Center kontaktieren!


DE

104

BootIntoRecoveryBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB startet das Gerät im Recovery Modus. Dazu wird das Gerät auf Befehl unverzüglich neugestartet.

Datenverlust möglich: Ungespeicherte Daten (z.B. Alarme, Data Logging, Prozessdaten,Rezepte) gehen beim Neustart verloren.

u Vor dem Neustart alle benötigten Daten auf dem FLASH-Speicher des Geräts speichern














nen beachten


105

Diagnose-Codes:





• ERR_SET_RECOVERY_MODE Fehler: Fehler beim Setzen des Recovery Modus.ifm-Service-Center kontaktieren!

• ERR_SHUTDOWN_DEVICE Fehler: Fehler beim Abschalten.ifm-Service-Center kontaktieren!


DE

106

GetDeviceOrientationBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt die im Gerät konfigurierte Ausrichtung (Rotation) des Bildschirminhalts aus.










• FB kann erneutaufgerufenwerden







eRotation eOBJECT_ROTATION

Konfigurierte Geräteausrichtung(Rotation).

Ò eOBJECT_ROTATION (ENUM)

Diagnose-Codes:

107





• ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung.


DE

108

SetDeviceOrientationBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB rotiert den Bildschirminhalt ja nach Geräteausrichtung. Nach der erfolgreichen Ausführung desFBs und nachfolgendem Neustart des Geräts wird der Bildschirminhalt entsprechend derEinstellungen gedreht.




xExecute BOOL Ausführung des FB steuern FALSE =>TRUE

FB wird einmalausgeführt


eRotation eOBJECT_ROTATION Konfigurierte Geräteausrichtung (Rotation). Ò eOBJECT_ROTATION (ENUM)









nen beachten


Diagnose-Codes:



109



• ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung.


DE

110

9.4.3 Ethernet

GetEthernetInterfacesBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt eine Liste mit allen verfügbaren Ethernet-Schnittstellen des Geräts aus.















usiEthItfsCnt USINT Anzahl der vefügbaren Ethernet-Schnittstellen

0 keine Ethernet-Schnittstelle

... ...

15 15 Ethernet-Schnittstellen

aEthItfsList aETH_ITF_LIST Liste aller verfügbaren Ethernet-Schnittstellen

Ò aETH_ITF_LIST (GVL)

111

Diagnose-Codes:





• ERR_GET_ETH_ITF_LIST Fehler: Probleme beim Lesen der verfügbaren Ethernet-Schnittstellen


DE

112

GetIPsettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest folgende IP-Einstellungen der angegebenen Ethernet-Schnittstelle des Geräts:

• IP-Adresse

• Netzmaske des TCP/IP-Netzwerks sowie

• IP-Adresse des Gateways

• DHCP-Status

Der FB gibt die ausgelesenen Werte in einer komplexen Variable des Typs "stIPv4Setting" aus.


xExecute BOOL Ausführung des FB steuern • FALSE => TRUE: FB wird einmalausgeführt

• Sonst: keine Auswirkungen auf FB-Abarbeitung

eInterface eETHERNET_INTERFACES

Ethernet-Schnittstellen-ID (Ò eETHERNET_INTERFACES(ENUM) / 208)










en beachten


stIPv4Setting stIPv4Setting IPv4-Einstellungen des Geräts (Ò stIPV4SETTING (STRUCT) / 214)

113

Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Ungültige Ethernet-Schnittstelle gewählt.

• ERR_GET_DHCP_STATUS Fehler beim Lesen des DHCP-Server-Status.

• ERR_GET_IP_SETTINGS Fehler beim Ermitteln der IP-Konfiguration.


DE

114

SetIPsettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB ändert folgende IP-Einstellungen der angegebenen Ethernet-Schnittstelle des Geräts:

• IP-Adresse

• Subnetzmaske des TCP/IP-Netzwerks

• IP-Adresse des Gateways

• DHCP-Status

Die IP-Einstellungen werden dem FB in einer komplexen Variable vom Typ "stIPv4Setting" übergeben.

Der Parameter DHCP besitzt höchste Priorität. Wenn DHCP = TRUE, dann werden die Werte derParameter IPAdresse, Subnetzmaske und Gateway-Adresse nicht ausgewertet.

Der FB überprüft nach dem Aufruf, ob DHCP aktiviert ist. Wenn ja, deaktiviert der FB den DHCP-Client des Geräts und setzt die gewünschte IP-Adresse.

u IP-Adresse in folgender Notation eingeben: www.xxx.yyy.zzz

u Bei der Eingabe der IP-Adresse die führenden Nullen weglassen!FALSCH: 192.168.000.055RICHTIG: 192.168.0.55



Jeder Aufruf des FB führt eine Schreiboperation auf den Flash-Speicher des Geräts aus.

u Funktionsbaustein im Programmcode nicht zyklisch aufrufen!




eInterface eETHERNET_INTERFACES

Ethernet-Schnittstellen-ID (Ò eETHERNET_INTERFACES(ENUM) / 208)

stIPv4Setting stIPv4Setting IPv4-Einstellungen des Geräts (Ò stIPV4SETTING (STRUCT) / 214)

115









ausgeführt werden• Diagnoseinformatione

n beachten


Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Ungültige Ethernet-Schnittstelle gewählt.

• ERR_GET_DHCP_STATUS Fehler beim Lesen des DHCP-Server-Status.

• ERR_SET_DHCP_STATUS Fehler beim Ändern des DHCP-Server-Status.

• ERR_SET_IP_SETTINGS Fehler beim Schreiben der IP-Konfiguration.IP-Adresse, Subnetzmaske und Default-Gateway prüfen.


DE

116

GetEthernetBridgeConfigBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt die im Gerät konfigurierte Ethernet Bridge Mode-Konfiguration aus.

















stSettings stETHERNET_BRIDGE_CONFIG

Ethernet Bridge Mode-Konfiguration Ò stETHERNET_BRIDGE_CONFIG(STRUCT)

Diagnose-Codes:



117



• ERR_BRIDGE_MODE_GET_STATUS

Fehler: Fehler beim Lesen des Ethernet Bridge Mode-Status

• ERR_BRIDGE_MODE_NOT_ACTIVE

Fehler: Ethernet Bridge Mode ist nicht aktiv. Die Ethernet Bridge Mode-Konfigurationkann nicht gelesen werden.

• ERR_GET_DHCP_STATUS Fehler: Fehler beim Lesen des DHCP-Status.

• ERR_GET_IP_SETTINGS Fehler: Fehler beim Lesen der aktuellen IP-Einstellungen.


DE

118

SetEthernetBridgeConfigBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB startet oder stoppt den Bridge Mode zwischen zwei mit den Ethernet-Schnittstellen des Gerätsverbundenen Netzwerken.

Beim Ausführen des FB, werden die Bridge Mode-Einstellungen aktiv.

Folgende Einstellungen für den Bridge Mode sind möglich:

• Bridge-Netzwerks:

– IP-Adresse

– DHCP-Mode / statisch

• Auswahl der beteiligten Ethernet-Schnittstellen

u IP-Adresse in folgender Notation eingeben: www.xxx.yyy.zzz

u Bei der Eingabe der IP-Adresse die führenden Nullen weglassen!FALSCH: 192.168.000.055RICHTIG: 192.168.0.55






stSettings stETHERNET_BRIDGE_CONFIG

Ethernet Bridge Mode-Konfiguration (Ò stETHERNET_BRIDGE_CONFIG(STRUCT) / 214)





119






nen beachten


Diagnose-Codes:





• ERR_BRIDGE_MODE_GET_STATUS

Fehler: Fehler beim Lesen des Ethernet Bridge Mode-Status

• ERR_GET_DHCP_STATUS Fehler: Fehler beim Lesen des DHCP-Status.

• ERR_SET_DHCP_STATUS Fehler: Fehler beim Ändern des DHCP-Status.

• ERR_SET_IP_SETTINGS Fehler: Fehler beim Ändern der IP-Einstellungen. Entweder IP-Adresse,Subnetzmaske oder Standardgateway ungültig.

• ERR_BRIDGE_MODE_STOP Fehler: Fehler beim Stoppen des Ethernet Bridge Mode.


DE

120

9.4.4 Keypads

ControlAllKeyLEDsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schaltet entsprechend der gewählten Einstellungen alle Tasten-LEDs des Geräts ein / aus undstellt die LED-Farbe ein.





TRUE FB aktivieren

stNightMode stKEY_LED_NIGHT_MODE

Nachtmodus für Beleuchtung derTasten-LED aktivieren/deaktivieren unddie Nachtmodus-Helligkeit einstellen.

Ò stLED_SETTINGS (STRUCT)

stControlKeyLED stKEY_LED_CONTROL Einstellen/Steuern der Tasten-LEDs:Ein/Aus und Farbe

Ò stKEY_LED_CONTROL(STRUCT)

xErrorReset BOOL Fehler rücksetzen, wenn xError amAusgangsbaustein aktiv.

FALSE =>TRUE

Fehler rücksetzen

FALSE (Standardwert)






nen beachten


Diagnose-Codes:


121




• ERR_INVALID_VALUE Fehler: Zugriff auf vom Zielgerät nicht unterstützte Tasten-LED

• ERR_SET_KEY_LED_COLOR Fehler beim Setzen der LED-Farbe.ifm-Service-Center kontaktieren!


DE

122

GetKeyMappingBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die aktuellen Mapping-Einstellungen des integrierten Tastenfeldes aus.

















uiNoOfKeys UINT Anzahl der Tasten auf dem integriertenTastenfeld

stKeyMapList stKEY_MAP_LIST Struktur mit Mapping-Informationender Tasten.

Ò stKEY_MAP_LIST (STRUCT)

Diagnose-Codes:

123





• ERR_GET_KEY_CONFIG Fehler beim Lesen der Tastenkonfiguration

• ERR_GET_KEY_MAP Fehler beim Lesen des Tasten-Mappings


DE

124

ResetAllKeyLEDBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB setzt alle Tasten-LEDs auf den Standardwert "AUS" zurück.














nen beachten


Diagnose-Codes:





• ERR_RESET_KEY_LED Fehler: Fehler beim Zurücksetzen der Tasten-LEDs.ifm-Service-Center kontaktieren!

125


DE

126

ResetKeyMappingBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB setzt das Mapping aller Tasten auf Standardwerte zurück.

u

u Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jederweiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
















Diagnose-Codes:


127




• ERR_RESET_KEY_MAP • Fehler beim Zurücksetzen des Tasten-Mappingsifm-Service-Center kontaktieren!


DE

128

SetKeyAutoRepeatBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB stellt die Auto-Repeat-Konfiguration (Impuls-Wiederholung) für die Tasten des integriertenTastenfeldes ein.






uiDelay UINT Zeit, die eine Taste gedrückt seinmuss, bis Auto-Repeat gestartet wirdin [ms].

uiPeriod UINT Zeit zwischen zwei Auto-Repeat-Impulsen in [ms].







FALSE kein Fehleraufgetreten oderder FB wird nochausgeführt

TRUE • Fehleraufgetreten

• Aktion konntenicht ausgeführtwerden

• Diagnoseinformationenbeachten


129

Diagnose-Codes:





• ERR_SET_KEY_AUTO_REPEAT • Fehler beim Setzen der Auto-Repeat-Konfigurationifm-Service-Center kontaktieren!


DE

130

SetKeyLEDBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB stellt die Farbe und den Nachtmodus der angegeben Tasten-LED ein.

Eingangsparameter




eLED_ID eKEY_LED_ID Angabe der Tasten-LED aufdem integrierten Tastenfeld.

→ eKEY_LED_ID (ENUM)

udiColor UDINT Einzustellende LED-Farbe. RGB: 16#00RRGGBB mitRR = 0...FFGG = 0...FFBB = 0...FFBeispiele:rot = 16#00FF0000grün = 16#0000FF00blau = 16#000000FFschwarz = 16#00000000weiß = 16#00FFFFFF

stNightMode stKEY_LED_NIGHT_MODE Nachtmodus für Beleuchtungder Tasten-LED aktivieren/deaktivieren und dieNachtmodus-Helligkeiteinstellen.

Ò stLED_SETTINGS (STRUCT)






nen beachten



131


xPrepared BOOL Zustand der FB-Ausgänge TRUE FB-Ausgänge gültig;FB wurde abgearbeitet

Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Ungültige Angabe der LED an Eingangsparameter eLED_ID.

• ERR_SET_KEY_LED_COLOR Fehler beim einstellen der LED-Farbe.ifm-Service-Center kontaktieren!


DE

132

SetKeyMappingBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB weist den Tasten des integrierten Tastenfeldes Standard-Tastatur-Funktionen zu (Key-Mapping).







stKeyMapList stKEY_MAP_LIST

Struktur mit Mapping-Informationen der Tasten. → stKEY_MAP_LIST (STRUCT)









nen beachten


Diagnose-Codes:




133


• ERR_SET_KEY_MAP Fehler beim Einstellen des Tasten-Mappings


DE

134

9.4.5 LCD

LCDcontrolBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schaltet das LCD-Display und die Hintergrundbeleuchtung ein oder aus.






xEnableLCD BOOL LCD einschalten / ausschalten(Energiesparmodus).

FALSE LCD einschalten.

TRUE LCD ausschalten.









nen beachten


Diagnose-Codes:



135




• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren! DE

136

GetBootupBacklightBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die eingestellten LCD-Helligkeitseinstellungen für den Bootvorgang aus.






Ausgangsparameter












usiBrightness USINT Eingestellter Helligkeitswert für denGeräte-Bootvorgang

0...100 %

Diagnose-Codes:



137



• ERR_GET_BOOTUP_LCD_BRIGHTNESS

Fehler beim Lesen des Helligkeitswertesifm-Service-Center kontaktieren!


138

GetLCD_BacklightBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die eingestellten LCD-Helligkeitseinstellungen für den Normalbetrieb des Displays aus.

















usiBrightness USINT Eingestellter Helligkeitswert für denNormalbetrieb des Geräts

0...100 %

Diagnose-Codes:




139


• ERR_GET_LCD_BRIGHTNESS Fehler beim Lesen des Helligkeitswertesifm-Service-Center kontaktieren!


DE

140

SetBootupBacklightBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB stellt den Wert für die LCD-Helligkeit für den Bootvorgang ein.






usiBrightness USINT Helligkeitswert für den Geräte-Bootvorgang

0...100 %Standardwert: 80 %









nen beachten


Diagnose-Codes:





• ERR_INVALID_VALUE Fehler: Wert an Eingangsparameter usiBrightness außerhalb des Wertebereichs.

141

• ERR_SET_BOOTUP_LCD_BRIGHTNESS

Fehler beim Einstellen des Helligkeitswertes.ifm-Service-Center kontaktieren!


DE

142

SetLCD_BacklightBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB stellt den Wert für die LCD-Helligkeit für den Normalbetrieb ein.






usiBrightness USINT Helligkeitswert für den Normalbetriebdes Geräts

0...100 [%]Standardwert: 80 [%]Hintergrundbeleuchtung aus = 0 [%]






nen beachten




Diagnose-Codes:





143

• ERR_INVALID_VALUE Fehler: Wert an Eingangsparameter usiBrightness außerhalb des Wertebereichs.

• ERR_SET_LCD_BRIGHTNESS Fehler beim Einstellen des Helligkeitswertes.ifm-Service-Center kontaktieren!


DE

144

9.4.6 Local IO

GetLightSensorBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt den Lichtstärkewert des integrierten Lichtsensors zurück.

















uiAmbientLight UINT Wert der Lichtstärke, ermittelt durchden integrierten Lichtsensor

0...4096 = 0...100%

Diagnose-Codes:


145




• ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes.ifm-Service-Center kontaktieren!


DE

146

GetLightSensorCyclicBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt den Lichtstärkewert des integrierten Lichtsensors in einem zyklischen Intervall von 150 mszurück.





TRUE FB aktivieren

Ausgangsparameter








uiAmbientLight UINT Wert der Lichtstärke, ermittelt durchden integrierten Lichtsensor

0...4096 = 0...100%

Diagnose-Codes:





• ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes.ifm-Service-Center kontaktieren!

147


DE

148

GetLocalInputsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest den Zustand der lokalen Digitaleingänge des Geräts.






Ausgangsparameter












xChannel0 BOOL Zustand des Digitaleingangs "Channel0"

FALSE AUS

TRUE EIN

xChannel1 BOOL Zustand des Digitaleingangs "Channel1"

FALSE AUS

TRUE EIN

149

Diagnose-Codes:




• ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle.ifm-Service-Center kontaktieren!


DE

150

GetLocalInputsCyclicBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest den Zustand der lokalen Digitaleingänge des Geräts in einem zyklischen Intervall von 50ms..





TRUE FB aktivieren

Ausgangsparameter








xChannel0 BOOL Zustand des Digitaleingangs "Channel 0" FALSE AUS

TRUE EIN

xChannel1 BOOL Zustand des Digitaleingangs "Channel 1" FALSE AUS

TRUE EIN

Diagnose-Codes:




151

• ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle.ifm-Service-Center kontaktieren!


DE

152

GetTemperatureBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest folgende Systemtemperaturen aus:

• Temperatur Platine

• Temperatur Prozessor






Ausgangsparameter












stTemperatures stSYSTEM_TEMPERATURES

Struktur mit den Systemtemperaturen Ò stSYSTEM_TEMPERATURES(STRUCT)

Diagnose-Codes:

153





• ERR_READ_TEMPERATURE_CORE_0

Fehler beim Lesen der Prozessortemperaturifm-Service-Center kontaktieren!

• ERR_READ_TEMPERATURE_BOARD

Fehler beim Lesen der Platinentemperatur.ifm-Service-Center kontaktieren!


DE

154

GetTemperaturesCyclicBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest zyklisch in einem Intervall von 2000 ms folgende Systemtemperaturen aus:

• Temperatur Platine

• Temperatur Prozessor





TRUE FB aktivieren

Ausgangsparameter








stTemperatures stSYSTEM_TEMPERATURES

Struktur mit den Systemtemperaturen Ò stSYSTEM_TEMPERATURES(STRUCT)

Diagnose-Codes:





• ERR_READ_TEMPERATURE_CORE_0

Fehler beim Lesen der Prozessortemperaturifm-Service-Center kontaktieren!

155

• ERR_READ_TEMPERATURE_BOARD

Fehler beim Lesen der Platinentemperatur.ifm-Service-Center kontaktieren!


DE

156

GetVoltagesBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest folgende Systemspannungen aus:

• VBB0

• VBB15

• VBB30






Ausgangsparameter












stSystemVoltages

stSYSTEM_VOLTAGES

Struktur mit den Systemspannungen Ò stSYSTEM_VOLTAGES (STRUCT)

157

Diagnose-Codes:





• ERR_READ_VOLTAGE_VBB0 Fehler beim Lesen der Systemspannung VBB0.ifm-Service-Center kontaktieren!




DE

158

GetVoltagesCyclicBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest folgende Systemspannungen zyklisch im Intervall von 50 ms aus:

• VBB0

• VBB15

• VBB30





TRUE FB aktivieren

Ausgangsparameter








stSystemVoltages stSYSTEM_VOLTAGES

Struktur mit den Systemspannungen Ò stSYSTEM_VOLTAGES (STRUCT)

Diagnose-Codes:





159





DE

160

SetLocalOutputsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt die Werte der lokalen Digitalausgänge. Der FB besitzt eine Diagnosefunktion. Es wirdeine Fehlermeldung ausgelöst und ein Fehlerbit "xDiagChannel0 / 1" gesetzt, wenn der Istzustand derAusgänge nicht mit dem Sollzstand übereinstimmt.





TRUE FB aktivieren

stChannel0 STRUCT Befehl für Digitalausgangskanal 0 Ò stOUTPUT_COMMANDS (STRUCT)

stChannel1 STRUCT Befehl für Digitalausgangskanal 1 Ò stOUTPUT_COMMANDS (STRUCT)






nen beachten




xErrorChannel0 BOOL Fehler beim Schreiben auf Channel 0 FALSE Kein Fehleraufgetreten

TRUE Fehler aufgetreten

xDiagChannel0 BOOL Diagnosestatus Channel 0. Nicht relevant. FALSE Istzustand =Sollzustand Channel 0

161


xDiagChannel0 BOOL Diagnosestatus Channel 0. Nicht relevant. TRUE Istzustand ungleichSollzustand

xErrorChannel1 BOOL Fehler beim Schreiben auf Channel 1 FALSE Kein Fehleraufgetreten

TRUE Fehler aufgetreten

xDiagChannel1 BOOL Diagnosestatus Channel 1. Nicht relevant. FALSE Istzustand =Sollzustand Channel 1

TRUE Istzustand ungleichSollzustand

Diagnose-Codes:





• ERR_WRITE_DIGITAL_OUTPUT

Fehler beim Schreiben des Digitalen Ausgangswerts.

• ERR_READ_DIAG_INPUT Fehler beim Lesen des Diagnose-Status.

• ERR_VALUE_MISMATCH Fehler: Eingestellter Digitalausgangswert stimmt nicht mit gelesenemDiagnosezustand überein.


DE

162

9.4.7 Status LED

SetStatusLEDstateBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB steuert die Status-LED des Geräts. Die Status-LED kann zweifarbig blinken. Die Blinkfrequenzist einstellbar.





sonst. keineAuswirkungen aufFB-Abarbeitung

udiColor0 UDINT Erste LED-Farbe RGB: 16#00RRGGBB mitRR = 0...FFGG = 0...FFBB = 0...FFBeispiele:rot = 16#00FF0000grün = 16#0000FF00blau = 16#000000FFschwarz = 16#00000000weiß = 16#00FFFFFF

udiColor1 UDINT Zweite LED-Farbe RGB: 16#00RRGGBB mitRR = 0...FFGG = 0...FFBB = 0...FFBeispiele:rot = 16#00FF0000grün = 16#0000FF00blau = 16#000000FFschwarz = 16#00000000weiß = 16#00FFFFFF

eFreq eSTATUS_LED_FLASH_FREQ LED-Blinkfrequenz Ò eSTATUS_LED_FLASH_FREQ(ENUM)

163






xError BOOL Anzeige, ob bei der FB-Ausführungein Fehler aufgetreten ist




n beachten


Diagnose-Codes:





• ERR_INVALID_VALUE Fehler: Ungültiger Wert an udiColor0, udiColor1 oder eFreq.

• ERR_SET_STATUS_LED Fehler beim Setzen der LED-Farbe.ifm-Service-Center kontaktieren!


DE

164

9.4.8 Storage

USBstorageHandlerBaustein-Typ: Funktionsbaustein (FB)

Verhaltensmodell: ENABLE mit Busy Extension

Bibliothek: ifmUSBstorageUtil.library

Symbol in CODESYS:

BeschreibungDer FB verwaltet den mit dem Gerät verbundenen USB-Gerät. Der FB führt folgende Funktionen aus:

• USB-Gerät automatisch in das Dateisystem des Geräts einbinden (mount)

• Pfad zum USB-Gerät im Dateisystem des Geräts ausgeben

• USB-Gerät auf Befehl des Nutzers aus dem Dateisystem des Geräts entfernen (unmount)

• Stecken und Herausziehen des USB-Geräts signalisieren

Eingangsparameter


xEnable BOOL Aktivität des FBsteuern

FALSE FB deaktivieren

TRUE FB aktivieren

xRemoveDevice BOOL USB-Gerät ausDateisystem entfernen(unmount)

FALSE => TRUE USB-Gerät wirdentfernt

sonst. keine Aktion






en beachten


xPrepared BOOL Zustand der FB-Ausgänge

FALSE FB-Ausgänge ungültig;FB wird nochabgearbeitet


165


usiNumberUSBdevice USINT Anzahl derverbundenen USB-Speichergeräte

0 kein Gerät verbunden

1 1 Gerät verbunden

sAccessPath STRING absoluterVerzeichnispfad desUSB-Speichergeräts

z.B. /mnt/usb

xDevicePlugged BOOL Signalisiert dasStecken eines USB-Geräts innerhalb desaktuellen SPS-Zyklus

FALSE kein USB-Gerätgesteckt

TRUE USB-Gerät gesteckt

xDeviceUnplugged BOOL Signalisiert dasEntfernen eines USB-Geräts innerhalb desaktuellen SPS-Zyklus

FALSE USB-Gerät nichtentfernt

TRUE USB-Gerät wurdeentfernt

Diagnose-Codes:




• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB wurde erzeugt; diese FB-Instanz wird nichtausgeführt

• ERR_INSTANCE_RESTRICTION Fehler: FB sollte nicht zusammen mit FB USBshandlerMulti genutzt werden

• ERR_INVALID_VALUE Fehler: Falsches USB-Speichergerät wurde aus Dateisystem entfernt

• ERR_GET_STORAGE_LIST Fehler: Probleme beim Lesen der Liste mit verbundenen USB-Speichergeräten

• ERR_UNPLUG_STORAGE Fehler: Probleme beim Entfernen eines USB-Speichergeräts aus dem Dateisystem



DE

166

USBstorageHandlerMultiBaustein-Typ:

Funktionsbaustein (FB)

Verhaltensmodell:

ENABLE mit Busy Extension

Bibliothek:

ifmUSBstorageUtil.library

Symbol inCODESYS:

BeschreibungDer FB verwaltet die mit dem Gerät verbundenen USB-Geräte. Die gerätespezifischen Informationender USB-Geräte werden in einem Array gespeichert. Der FB führt folgende Funktionen aus:

• USB-Geräte automatisch in das Dateisystem des Geräts einbinden (mount)

• Stecken und Herausziehen des USB-Geräts signalisieren

• Name und Art des Dateisystems ausgeben

• Pfade zu USB-Geräten im Dateisystem des Geräts ausgeben

• USB-Geräte auf Befehl des Nutzers aus dem Dateisystem des Geräts entfernen (unmount)


xEnable BOOL Aktivität des FBsteuern

FALSE FB deaktivieren

TRUE FB aktivieren

iq_aUSBstorageList ARRAY [0..n] OFstUSB_STORAGE_INFO

Array mitSteuersignalen undInformationen übermehrere USB-Geräte

Pro Array-Zeile: → stUSB_STORAGE_INFO(STRUCT)






en beachten


xPrepared BOOL Zustand der FB-Ausgänge

FALSE FB-Ausgänge ungültig;FB wird nochabgearbeitet


usiNumberUSBdevice USINT Anzahl derverbundenen USB-Speichergeräte

0 kein Gerät verbunden

1 1 Gerät verbunden

167


xDevicePlugged BOOL Signalisiert dasStecken eines USB-Geräts innerhalb desaktuellen SPS-Zyklus

FALSE kein USB-Gerätgesteckt

TRUE USB-Gerät gesteckt

xDeviceUnplugged BOOL Signalisiert dasEntfernen eines USB-Geräts innerhalb desaktuellen SPS-Zyklus

FALSE USB-Gerät nichtentfernt

TRUE USB-Gerät wurdeentfernt

Diagnose-Codes:




• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB wurde erzeugt; diese FB-Instanz wird nichtausgeführt

• ERR_INSTANCE_RESTRICTION Fehler: FB sollte nicht zusammen mit FB USBstorageHandler genutzt werden

• ERR_INVALID_VALUE Fehler: Falsches USB-Speichergerät wurde aus Dateisystem entfernt

• ERR_GET_STORAGE_LIST Fehler: Probleme beim Lesen der Liste mit verbundenen USB-Speichergeräten

• ERR_UNPLUG_STORAGE Fehler: Probleme beim Entfernen eines USB-Speichergeräts aus dem Dateisystem



DE

168

9.4.9 System Commands

LinuxSysCallAsyncBaustein-Typ: Funktionsbaustein (FB)


Bibliothek: ifmPDM360NGutil.library

Symbol in CODESYS:

BeschreibungDer FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem desGeräts und gibt den Rückgabewert des Befehls aus. Der übergebene Befehl wird asynchron imHintergrund ausgeführt.




sCommand STRING Linux-Befehl inkl. Parameter (max. 255Zeichen)










en beachten


wCmdResult WORD Rückgabewert desLinux-Befehls

Abhängig vom Befehl, z.B.:0: Befehl erfolgreich ausgeführt1...65534: Fehler: Ausführung des Befehlsfehlgeschlagen. → CmpErrors.library oder Hilfezu Linux-Befehl.65535: Befehl wird ausgeführt

Diagnose-Code:

169




• ERR_INVALID_VALUE Fehler: Ungültiger Wert an Eingang sCommand. Funktionsaufruf abgebrochen.

• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.

• ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler.. DE

170

LinuxSysCallAsync2Baustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem desGeräts und gibt den Rückgabewert des Befehls aus. Der übergebene Befehl wird asynchron imHintergrund ausgeführt. Die Standardausgabe (stdout) des Linux-Befehls wird in einem String-Puffergespeichert.

Eigenschaften des Puffers für die Standardausgabe• mögliche Puffergröße 1...10000 Bytes

• Wenn die Standardausgabe eines Linux-Befehls größer ist, als die definierte Puffergröße, werdennicht alle Informationen im Puffer gespeichert und gehen teilweise verloren.

• Beispiel mit definierter Puffergröße = 1000 Bytes (→ folgendes Programmierbeispiel):

– Bei einer Länge der Standardausgabe von 1500 Bytes gehen die Bytes 0...499 derStandardausgabe verloren. Die Bytes 500...1499 der Standardausgabe sind anschließend imPuffer (psCmdStdOut) enthalten.

Programmierbeispiel:VAR

sCmdStdOut : STRING(1000); /// buffer size

instLinuxSysCallAsync2.psCmdStdOut : LinuxSysCallAsync2; /// instance of FB

END_VAR;

instLinuxSysCallAsync2.psCmdStdOut := ADR(sCmdStdOut);

Eingangsparameter Parameter Datentyp Beschreibung Mögliche Werte




psCmdStdOut POINTER TO STRING Adresse des Puffers für dieStandardausgabe (stdout) des Linux-Befehls. Mögliche Größe 1...10000Bytes.

171









nen beachten


wCmdResult

WORD Rückgabewert des Linux-Befehls Abhängig vom Befehl, z.B.:0: Befehl erfolgreich ausgeführt1...65534: Fehler: Ausführung desBefehls fehlgeschlagen. →CmpErrors.library oder Hilfe zuLinux-Befehl.65535: Befehl wird ausgeführt

diCmdStdOutByteCnt

DINT Länge der zurückgegebenen Standardausgabe inBytes.

0...10000 Bytes

Diagnose-Code:






• ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler..

DE

172

LinuxSysCallSync

Baustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem desGeräts und gibt den Rückgabewert des Befehls aus.

Der übergebene Befehl wird synchron zum aufrufenden IEC-Task ausgeführt, das bedeutet:

• Während der Ausführung des Befehls wird die Abarbeitung des IEC-Task blockiert.

• Mögliche unerwünschte Effekte bei der Abarbeitung der IEC-Applikation durch einen langandauernden Linux-Befehl, z.B. beim Kopieren großer Datenmengen.

u Bei lang andauernden Befehlen die FBs für asynchrone Befehlsausführung verwenden:

• (Ò LinuxSysCallAsync / 168)

• (Ò LinuxSysCallAsync2 / 170)

Eingangsparameter













nen beachten


173


wCmdResult


Diagnose-Code:






DE

174

LinuxSysCallSync2




Symbol in CODESYS:

BeschreibungDer FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem desGeräts und gibt den Rückgabewert des Befehls aus. Die Standardausgabe (stdout) des Linux-Befehlswird in einem String-Puffer gespeichert.

Der übergebene Befehl wird synchron zum aufrufenden IEC-Task ausgeführt, das bedeutet:

• Während der Ausführung des Befehls wird die Abarbeitung des IEC-Task blockiert.

• Mögliche unerwünschte Effekte bei der Abarbeitung der IEC-Applikation durch einen langandauernden Linux-Befehl, z.B. beim Kopieren großer Datenmengen.

u Bei lang andauernden Befehlen die FBs für asynchrone Befehlsausführung verwenden:

• (Ò LinuxSysCallAsync / 168)

• (Ò LinuxSysCallAsync2 / 170)

Eigenschaften des Puffers für die Standardausgabe• mögliche Puffergröße 1...10000 Bytes

• Wenn die Standardausgabe eines Linux-Befehls größer ist, als die definierte Puffergröße, werdennicht alle Informationen im Puffer gespeichert und gehen teilweise verloren.

• Beispiel mit definierter Puffergröße = 1000 Bytes (→ folgendes Programmierbeispiel):

– Bei einer Länge der Standardausgabe von 1500 Bytes gehen die Bytes 0...499 derStandardausgabe verloren. Die Bytes 500...1499 der Standardausgabe sind anschließend imPuffer (psCmdStdOut) enthalten.

Programmierbeispiel:VAR

sCmdStdOut : STRING(1000); /// buffer size

instLinuxSysCallSync2.psCmdStdOut : LinuxSysCallSync2; /// instance of FB

END_VAR;

instLinuxSysCallSync2.psCmdStdOut := ADR(sCmdStdOut);

Eingangsparameter




175



psCmdStdOut POINTER TO STRING Adresse des Puffers für dieStandardausgabe (stdout) des Linux-Befehls. Mögliche Größe 1...10000Bytes.

Ausgangsparameter









nen beachten


wCmdResult


diCmdStdOutByteCnt

DINT Länge der zurückgegebenen Standardausgabe inBytes.

0...10000 Bytes

Diagnose-Code:






DE

176

9.4.10 System Information

GetSysInfoBaustein-Typ: Funktionsbaustein (FB)



Symbol inCODESYS:

BeschreibungDer FB liest Systeminformationen aus dem Gerät aus.

















stSysInfoBasic stSYS_INFO_BASIC Gelesene Basis-Systeminformationen Ò stSYS_INFO_BASIC (STRUCT)

stSysInfoExtd stSYS_INFO_EXTENDED

Gelesene erweiterteSysteminformationen

Ò stSYS_INFO_EXTENDED (STRUCT)

stSysInfoInternal

stSYS_INFO_INTERNAL

Gelesene interne Systeminformationen(optionla).

Ò stSYS_INFO_INTERNAL (STRUCT)

177

Diagnose-Codes:





• ERR_GET_SYS_INFO Fehler beim Lesen der Systeminformationen

• ERR_GET_KEYPAD_INFO Fehler beim Lesen der Informationen über das Tastenfeld

• ERR_GET_KEY_INFO Fehler beim Lesen der Tastenkonfiguration


DE

178

9.4.11 Touch

DisableTouchScreenBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

Beschreibung

Der FB aktiviert / deaktiviert die Touchscreen-Funktionalität des Displays. Der Touchscreen ist nacheinem Geräteneustart standardmäßig aktiviert.

Der FB ist nur verfügbar für Geräte mit integriertem Touchscreen.




xDisableTouch BOOL Touchscreen-Funktionalität desDisplays aktivieren/deaktivieren

FALSE Touchscreen-Funktionalitätaktiviert

TRUE Touchscreen-Funktionalitätdeaktiviert









nen beachten


179

Diagnose-Codes:







DE

180

SetTouchOptimisationModeBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB aktiviert den Optimierungsmodus für eine bestimmte Betriebsbedingung. Der Anwender kannzwischen folgenden Betriebsbedingungen wählen:

• Standardbetrieb

• Betrieb mit Handschuhen

• Betrieb bei Regen / Spritzwasser



Der FB ist nur verfügbar für Geräte mit integriertem Touchscreen.





eTouchOptiMode

eTOUCH_OPTIMISATION_MODE

OPtimierungsmodus für Touchscreen-Betrieb ÒeTOUCH_OPTIMISATION_MODE(ENUM)









nen beachten


181

Diagnose-Codes:





• ERR_INVALID_VALUE Fehler: Ungültiger Optimierungsmodus gewählt



DE

182

9.4.12 System Time

GetAvailableTimesZonesBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt die Anzahl und eine Liste der verfügbaren Zeitzonenkonfigurationen des Geräts aus.















aTimeZoneList aTIME_ZONE_LIST

Liste aller verfügbaren RTC-Zeitzonen Ò aTIME_ZONE_LIST (ALIAS)

uiTimeZonesCnt

UINT Anzahl der vefügbaren RTC-Zeitzonen 0 keine RTC-Zeitzonen

... ...

120 120 RTC-Zeitzonen

183

Diagnose-Codes:





• ERR_GET_TIMEZONES Fehler: Probleme beim Lesen der Zeitzonen-Infomrationen; Hersteller informieren


DE

184

GetSysTimeBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest folgende Parameter der geräteinternen Systemuhr und gibt die Werte aus:

• Datum

• Uhrzeit

• Zeitzone

• NTP-Status













185







stDateTime stDATE_TIME Datum und -Zeit Ò stDATE_TIME (STRUCT)

sTimeZone STRING Zeitzonen-Information

xNTP_DateTime

BOOL Aktualisierungsmodus von Datum undUhrzeit.

FALSE Aktualisierung überNTP nicht aktiv.

TRUE Aktualisierung überNTP aktiv.

Diagnose-Codes:





• ERR_GET_DATE_TIME Fehler: Fehler beim Lesen von Datum und/oder -Zeit

• ERR_GET_TIMEZONES Fehler: Fehler beim Lesen der Zeitzonen-Informationen


DE

186

GetSysTimeCyclicBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest zyklisch im Intervall von 1000 ms folgende Parameter der geräteinternen Systemuhr undgibt die Werte aus:

• Datum

• Uhrzeit

• Zeitzone

• NTP-Status





TRUE FB aktivieren










xNTP_DateTime

BOOL Aktualisierungsmodus von Datum undUhrzeit.

FALSE Aktualisierung überNTP nicht aktiv.

TRUE Aktualisierung überNTP aktiv.

187

Diagnose-Codes:






• ERR_GET_TIMEZONES Fehler: Fehler beim Lesen der Zeitzonen-Informationen


DE

188

SetSysTimeBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt folgende Parameter der Systemuhr des Geräts:

• Datum

• Zeit

Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.

Nur eine Instanz des FB innerhalb der Anwendung aufrufen!














nen beachten


Diagnose-Codes:





189

• ERR_SET_DATE_TIME Fehler: Fehler beim Schreiben von Datum und/oder Zeit


DE

190

SetTimeZoneBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt folgende Werte der Systemuhr des Geräts:

• Zeitzone

Der FB aktiviert / deaktiviert die Sommerzeit (Daylight Saving Time - DST) in Abhängigkeit von dereingestellten Zeitzone. Wenn die automatische Aktivierung / Deaktivierung der Sommerzeit nichtbenötigt wird, dann eine Zeitzone ohne Sommerzeit wählen (z. B . GMT+2).















nen beachten


Diagnose-Codes:


191




• ERR_SET_TIMEZONES Fehler: Fehler beim Schreiben der Zeitzonen-Informationen


192

GetNTP_SettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die konfigurierten NTP-Servereinstellungen und den NTP-Serverstatus aus.















beachten


stSettings ÒstNTP_SETTINGS

NTP-Einstellungen Ò stNTP_SETTINGS

Diagnose-Codes:



193



• ERR_GET_NTP_SERVERS Fehler: Fehler beim Lesen der im System konfigurierten NTP-Server.

• ERR_GET_NTP_DAEMON_STATUS

Fehler: Fehler beim Lesen des NTP Running Status.


DE

194

SetNTP_SettingsBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB aktiviert / deaktiviert NTP Services und konfiguriert die Adressen der NTP-Server im System.







stSettings ÒstNTP_SETTINGS

NTP-Einstellungen Ò stNTP_SETTINGS









nen beachten


Diagnose-Codes:




195


• ERR_INVALID_VALUE Fehler:• usiServerCnt > 11oder• aServerList[] = NULL wenn usiServerCnt > 0

• ERR_SET_NTP_SERVERS Fehler: Fehler beim setzen der NTP-Server im System

• ERR_GET_NTP_DAEMON_STATUS

Fehler: Fehler beim Lesen des NTP-Daemon-Status aus dem System

• ERR_START_NTP_DAEMON Fehler: Fehler beim Starten des NTP-Daemon

• ERR_STOP_NTP_DAEMON Fehler: Fehler beim Stoppen des NTP-Daemon


DE

196

9.4.13 Window Control

AnalogueCameraWindowControlBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB bietet folgende Funktionen zur Konfiguration und Steuerung einer Analogkamera:

• Starten und Stoppen

• Streamen des Videobildes im Kamerafenster

• Einstellen einer Region of Interest (ROI) zur Anzeige im Kamerafenster

• Drehen und Spiegeln des Kamerabildes

• Größe des Kamerabildes ermitteln

• Hintergrundfarbe des Kamerafensters transparent einstellen



TRUE FB aktivieren

stWindowControls STRUCT Fenster-Konfiguration undSteuerung

→ stWINDOW_CONTROLS(STRUCT)

eCamera eANALOGUE_VIDEO_STREAMS Auswahl desAnalogkamera-Videostreams

→ eANALOGUE_VIDEO_STREAMS (ENUM)

stCameraControls STRUCT Konfiguration undSteuerung der Kamera

→ stCAMERA_CONTROLS(STRUCT) (STRUCT)






nen beachten




197


stImageSize STRUCT Größe des Kamerabildes (ermittelt) Ò stCAMERA_IMAGE_SIZE(STRUCT)

Diagnose-Codes:





• ERR_WM_SET_VISIBILITY Fehler beim Setzen der Sichtbarkeit. des Fensters.

• ERR_WM_SET_POSITION_SIZE

Fehler beim Setzen der Position und Größe des Fensters.

• ERR_WM_BRING_TO_TOP Fehler beim Setzen des Fensters in den Vordergrund.

• ERR_WM_SEND_TO_BOTTOM

Fehler beim Setzen des Fensters in den Hintergrund.

• ERR_WM_CAPTURE_WINDOW Fehler beim Erstellen des Screenshots.


• ERR_CAMERA_START Fehler beim Starten der Kamera.

• ERR_CAMERA_STOP Fehler beim Stoppen der Kamera.

• ERR_CAMERA_SET_FLIP_ROTATION

Fehler beim Einstellen der Konfiguration des Kamerabildes (Drehen und Spiegeln)

• ERR_CAMERA_SET_ROI Fehler beim Einstellen der ROI

• ERR_CAMERA_GET_IMAGE_SIZE

Fehler beim Lesen der Kamerabildgröße

• ERR_CAMERA_SET_BACKGROUND_COLOR

Fehler beim Einstellen der Hintergrundfarbe

DE

198

IPCameraWindowControlBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB bietet folgende Funktionen zur Konfiguration und Steuerung einer Ethernet-Kamera:

• Starten und Stoppen

• Streamen des Videobildes im Kamerafenster

• Einstellen einer Region of Interest (ROI) zur Anzeige im Kamerafenster

• Drehen und Spiegeln des Kamerabildes

• Größe des Kamerabildes ermitteln

• Hintergrundfarbe des Kamerafensters transparent einstellen

Wenn xEnable = FALSE:

1. Kamera stoppen.

2. Nach eingestellter Verzögerung die eingestellte Hintergrundfarbe im Kamerafenster ausgeben.

3. Kamerafenster ausblenden.

Wenn xEnable = TRUE:

1. Kamera starten.

2. Kamera-Stream entsprechend der Parametrierung des Bausteins in einem Kamerafensteranzeigen.

3. Kamerafenster einblenden.



TRUE FB aktivieren

stWindowControls STRUCT Fenster-Konfiguration und Steuerung → stWINDOW_CONTROLS (STRUCT)

usiCameraIndex USINT IP-Kamera-Index.Jeder aufgerufenen Instanz des FBs mussein eindeutiger Indexwert zugewiesenwerden.

0...255

stCameraControls STRUCT Konfiguration und Steuerung der Kamera → stCAMERA_CONTROLS (STRUCT)(STRUCT)

199






n beachten



TRUE FB-Ausgänge gültig; FBwurde abgearbeitet

stImageSize STRUCT Größe des Kamerabildes (ermittelt) Ò stCAMERA_IMAGE_SIZE (STRUCT)

xStreamActive BOOL Empfangsstatus des Kamera-Videostreams. TRUE Kamera-Videostream istaktiv und wird vom Gerätempfangen.

FALSE Kamera-Videostream istunterbrochen. (Dies wirdnicht als Fehlerinterpretiert.)

sWindowID STRING Für erfahrene Benutzer: Fenster-ID desKamerafensters

--

sCallBackRespDesc

STRING Für erfahrene Benutzer: Bei IP-Kamera-Fehler - Callback response description.

--

DE

200

Diagnose-Codes

Bei Fehlermeldungen "ERR_", die während der Projektierung mit häufigem Ändern derKonfiguration und Laden/Neustarten der Applikation auftreten:

u Gerät und Kamera spannungslos schalten und nach ca. 10 Sekunden wieder einschalten.

u Falls der Fehler immer noch anliegt und keine Ursache erkennbar ist: ifm-Service-Centerkontaktieren!




• STAT_EVNT_OPEN_CAMERA_ERROR Zustand: FB öffnet ein Call Back Event für einen IP-Kamera-Fehler.

• STAT_EVNT_OPEN_CAMERA_STREAM_STATUS Zustand: FB öffnet ein Call Back Event für die Änderung desBetriebszustandes des IP-Kamera-Streams.

• STAT_EVNT_OPEN_DONE Zustand: Öffnen des Call Back Events ist erfolgt.

• STAT_EVNT_REGI_CAMERA_ERROR Zustand: FB registriert eine Call Back Function für einen IP-Kamera-Fehler.

• STAT_EVNT_REGI_CAMERA_STREAM_STATUS Zustand: FB registriert eine Call Back Function für die Änderungdes Betriebszustandes des IP-Kamera-Streams.

• STAT_EVNT_REGI_DONE Zustand: Registrierung der Call Back Function erledigt.

• STAT_EVNT_CAMERA_STREAM_ACTIVATED Zustand: Das Ereignis "Aktivierung des IP-Kamera-Streams" istaufgetreten.

• STAT_EVNT_CAMERA_STREAM_INTERRUPTED Zustand: Das Ereignis "Unterbrechung des IP-Kamera-Streams"ist aufgetreten.










• ERR_CAMERA_INIT_WINDOW Fehler beim Initialisieren der Kamera nach Geräte-Neustart.

• ERR_CAMERA_START Fehler beim Starten der Kamera.

• ERR_CAMERA_STOP Fehler beim Stoppen der Kamera.

• ERR_CAMERA_SET_FLIP_ROTATION

Fehler beim Einstellen der Konfiguration des Kamerabildes(Drehen und Spiegeln)

• ERR_CAMERA_SET_ROI Fehler beim Einstellen der ROI

• ERR_CAMERA_GET_IMAGE_SIZE

Fehler beim Lesen der Kamerabildgröße

• ERR_CAMERA_SET_BACKGROUND_COLOR

Fehler beim Einstellen der Hintergrundfarbe

• ERR_EVNT_OPEN Fehler beim Öffnen eines Events für die Call Back Function-Registrierung.

• ERR_EVNT_REGI Fehler beim Registrieren einer Call Back Function für ein CallBack Event.

201

PDF_ViewerBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB bietet Funktionen zur Konfiguration und Anzeige eines PDF-Dokuments in einem PDF-Viewer-Fenster auf dem Gerät, z.B.:

• Suchen

• Anzeigen einer gewünschten Seite: Erste / Letzte Seite, vorherige / nächste Seite, Seite überSeitenzahl

• Scrollen nach oben oder unten

• Rotieren linksherum oder rechtsherum

• Hereinzoomen und Herauszoomen, Zoomen auf einen bestimmten Wert oder Zoomen auf diepassende Breite

• Inhaltsverzeichnis anzeigen / verbergen

• Vollbildmodus ein / aus

Bei Deaktivieren des FB ( xEnable = FALSE ) werden das PDF und das Fenster des PDF-Viewersgeschlossen.

Wenn der Name oder Pfad des geöffneten PDFs ( sFileName ) geändert wird, wird das PDFgeschlossen und das neue PDF geöffnet.

Bei PDF-Fehlern (ERR_PDF_...):

u FB deaktivieren ( xEnable = FALSE ) um den Fehler zurückzusetzen.



TRUE FB aktivieren

stWindowControls

STRUCT Fenster-Konfiguration und Steuerung → stWINDOW_CONTROLS (STRUCT)

sFileName STRING Name und Pfad der PDF-Datei. z.B. /home/example.pdf

iq_stPdfControls

STRUCT Konfiguration und Steuerbefehle fürdie Darstellung des PDF-Viewers.

→ stPDF_CONTROLS (STRUCT)




DE

202







xPrepared BOOL Zustand der FB-Ausgänge FALSE FB-Ausgängeungültig; FB wirdnoch abgearbeitet

TRUE FB-Ausgänge gültig;FB wurdeabgearbeitet

udiWindowId STRING Fenster-ID des PDF-Viewer-Fensters 16#1003 0000... 16#1003 FFFF

203

Diagnose-Codes• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.












• ERR_PDF_VIEWER_START Fehler beim Starten oder Aktivieren des PDF-Viewers.

• ERR_PDF_VIEWER_STOP Fehler beim Beenden oder Deaktivieren des PDF-Viewers.

• ERR_PDF_DOCU_OPEN Fehler beim Öffnen eines PDF-Dokuments.

• ERR_PDF_DOCU_CLOSE Fehler beim Schließen eines PDF-Dokuments.

• ERR_PDF_GOTO_PAGE Fehler bei einer der folgenden Operation innerhalb eines PDF-Dokuments:• Anzeigen einer angegebenen Seite• Anzeigen der ersten oder letzten Seite• Anzeige der vorherigen oder nachfolgenden Seite

• ERR_PDF_ROTATE_PAGE Fehler beim Rotieren des PDF-Dokuments.

• ERR_PDF_SCROLL_PAGE Fehler beim Scrollen des PDF-Dokuments.

• ERR_PDF_SEARCH_STRING Fehler beim Suchen nach dem eingegebenen String im PDF-Dokument.

• ERR_PDF_SHOW_HIDE_TOC Fehler beim Anzeigen / Verbergen des Inhaltsverzeichnisses.

• ERR_PDF_ZOOM_CONTROLS Fehler beim Zoomen des PDF-Dokuments.

• ERR_PDF_SET_FULL_SCREEN_MODE

Fehler beim Einschalten oder Ausschalten des Vollbildmodus.

PrintScreenBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB erstellt einen Screenshot des Displayinhalts und speichert diesen als Bilddatei ab.

Unterstützte Bildformate:

• bmp (raw format = große Datei)

DE

204

• jpg (bevorzugtes Format für Inhalte mit Kamerabild = kleine Datei)

• png (bevorzugtes Format für HMI-Darstellung ohne Kamerabilder = kleine Datei)




sFileName STRING (255) Verzeichnispfad, Name und Formatder Bilddatei.

z.B. '/home/cds-apps/screenshot.bmp'









nen beachten


Diagnose-Codes:




• ERR_INVALID_VALUE Fehler: Wert an Eingangsparameter sFileName ist ungültig. Funktionsaufruf wurdeabgebrochen.Ungültige Werte:• Wert an sFileName ist NULL (z.B. '')• Wert an sFileName endet auf "/" (z.B ein Verzeichnis)• Wert an sFileName enthält fortlaufende Schrägstriche (z.B. "////")• Verzeichnis oder Unterverzeichnis existiert nicht

• ERR_WM_CAPTURE_SCREEN Fehler beim Erstellen des Screenshots.


205

WindowControlBaseBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB bietet folgende Funktionen zur Konfiguration und Steuerung von Fenstern:

• In den Vordergrund bringen

• In den Hintergrund bringen

• Anzeigen oder unsichtbar schalten

• Position und Größe einstellen

• Position freigeben und fest einstellen

• Größe freigeben und fest einstellen

• Eine Ebene weiter in den Vordergrund bringen

• Eine Ebene weiter in den Hintergrund bringen

• Screenshot von Fensterinhalt erstellen und als Datei speichern



TRUE FB aktivieren

sWindowID STRING Fenster-ID oder Name

stWindowControls

stWINDOW_CONTROLS

Fenster-Konfiguration und Steuerung → stWINDOW_CONTROLS(STRUCT)






nen beachten




Diagnose-Codes:

DE

206













207

9.4.14 ENUM

CAN_BAUDRATE (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

CAN_BAUDRATE Datenübertragungsrateder CAN-Schnittstelle

KBAUD_20 20 Kilobaud INT 20

KBAUD_33 33,3 Kilobaud INT 33










CAN_CHANNEL (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

CAN_CHANNEL Identifier der CAN-Schnittstelle

CHAN_0 CAN-Schnittstelle0

INT 0


INT 1


INT 2


INT 3

eANALOGUE_VIDEO_STREAMS (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eANALOGUE_VIDEO_STREAMS Liste derverfügbarenanalogenVideostreams.

CAM_0 VideostreamAnalogkamera 0

INT 0


INT 1


INT 2


INT 3

eDAY_OF_WEEK (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eDAY_OF_WEEK Liste mit Wochentagen SUNDAY USINT 0

MONDAY USINT 1

TUESDAY USINT 2

WEDNESDAY USINT 3

THURSDAY USINT 4

DE

208

Name Beschreibung Mögliche Werte Datentyp Wert

eDAY_OF_WEEK Liste mit Wochentagen FRIDAY USINT 5

SATURDAY USINT 6

eETHERNET_INTERFACES (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eETHERNET_INTERFACES Liste der verfügbarenEthernet-Schnittstellen

ETH_0 Ethernet-Schnittstelle 0 (eth0) INT 0

ETH_1 Ethernet-Schnittstelle 1 (eth1) INT 1

eIP_CAMERA_ENCODING (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eIP_CAMERA_ENCODING Liste der verfügbaren IP-Kamera-Stream-Kodierungen

NONE Keine Auswahl INT 0

JPEG JPEG-Kodierung INT 1

H264 H264-Kodierung INT 2

eIP_CAMERA_PROTOCOL (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eCAMERA_PROTOCOL Liste der verfügbaren IP-Kamera-Protokolle

NONE Keine Auswahl INT 0

RTSP Real Time Streaming Protocol INT 1

RTP Real Time Protocol INT 2

eKEY_LED_ID (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eKEY_LED_ID

Liste der Tasten-LED-IDs desintegrierten Tastenfeldes

NONE Keine Auswahl UDINT 16#FF

KEY0_0 LED Taste 0, Gruppe 0 UDINT 16#0










KEY2_NAVIGATION LED Navigationstasten UDINT 16#B

209

eKEY_MAP_CODES (ENUM)

Name Beschreibung Mögliche Werte DatentypLinux inputevent code(dezimal)

eKEY_MAP_CODES Liste der möglichen Standard-Tastatur-Funktionen (MF2),die einer Taste auf demintegrierten Tastenfeldzugewiesen werden können.

NONE Keine Auswahl UDINT 0

ESCAPE Escape-Taste UDINT 1

MINUS - UDINT 74

ASTERISK * UDINT 55

SPACE Leertaste UDINT 57

COMMA , UDINT 83

SLASH / UDINT 98

PLUS + UDINT 78

KEY_0 0 UDINT 11

KEY_1 1 UDINT 2

KEY_2 2 UDINT 3

KEY_3 3 UDINT 4

KEY_4 4 UDINT 5

KEY_5 5 UDINT 6

KEY_6 6 UDINT 7

KEY_7 7 UDINT 8

KEY_8 8 UDINT 9

KEY_9 9 UDINT 10

KEY_A A UDINT 30

KEY_B B UDINT 48

KEY_C C UDINT 46

KEY_D D UDINT 32

KEY_E E UDINT 18

KEY_F F UDINT 33

KEY_G G UDINT 34

KEY_H H UDINT 35

KEY_I I UDINT 23

KEY_J J UDINT 36

KEY_K K UDINT 37

KEY_L L UDINT 38

KEY_M M UDINT 50

KEY_N N UDINT 49

KEY_O O UDINT 24

KEY_P P UDINT 25

KEY_Q Q UDINT 16

KEY_R R UDINT 19

KEY_S S UDINT 31

KEY_T T UDINT 20

KEY_U U UDINT 22

KEY_V V UDINT 47

KEY_W W UDINT 17

KEY_X X UDINT 45

DE

210

Name Beschreibung Mögliche Werte DatentypLinux inputevent code(dezimal)

eKEY_MAP_CODES Liste der möglichen Standard-Tastatur-Funktionen (MF2),die einer Taste auf demintegrierten Tastenfeldzugewiesen werden können.

KEY_Y Y UDINT 21

KEY_Z Z UDINT 44

KEY_RETURN Return-Taste UDINT 28

BACKSPACE Rück-Taste UDINT 14

TAB Tab-Taste UDINT 15

PRINT Druck-Taste UDINT 99

HOME Home-Taste UDINT 102

UP Pfeil nach oben-Taste

UDINT 103

LEFT Pfeil nach links-Taste

UDINT 105

RIGHT Pfeil nach rechts-Taste

UDINT 106

END Ende-Taste UDINT 107

DOWN Pfeil nach unten-Taste

UDINT 108

INSERT Einfügen-Taste UDINT 110

DELETE Lösch-Taste UDINT 111

PAUSE Pause-Taste UDINT 119

F1 F1-Taste UDINT 59












NUM0 0 Nummernblock UDINT 82










211

eOBJECT_FLIP (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eOBJECT_FLIP Liste der verfügbarenUmkehreinstellungen füranaloge Videostreams.

NONE Keine Auswahl. INT 0

NORMAL Normaldarstellung desKamerabildes.

INT 1

FLIP GespiegelteDarstellung desKamerabildes.

INT 2

eOBJECT_ROTATION (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eOBJECT_ROTATION Liste der verfügbarenRotationswinkel.

NONE Keine Auswahl. INT 0

DEG_0 Originalposition (0 Grad, "12 Uhr") INT 1

DEG_90 Drehung um 90 Grad im Uhrzeigersinn INT 2

DEG_180

Drehung um 180 Grad im Uhrzeigersinn INT 3

DEG_270

Drehung um 270 Grad im Uhrzeigersinn INT 4

eSTATUS_LED_FLASH_FREQ (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eSTATUS_LED_FLASH_FREQ Liste derBlinkfrequenzen derStatus-LEDs

FREQ_0Hz Kein Blinken INT 0

FREQ_05Hz 0,5 Hz INT 1

FREQ_1Hz 1 Hz INT 2

FREQ_2Hz 2 Hz INT 3

FREQ_5Hz 5 Hz INT 4

eTOUCH_OPTIMISATION_MODE (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eTOUCH_OPTIMISATION_MODE

Optimierungsmodi fürTouchscreen-Betrieb

NONE keine Optimierung INT 0

GLOVE Optimierung fürBetrieb mitHandschuh

INT 1

WATER Optimierung fürBetrieb bei Regen /Spritzwasser

INT 2

9.4.15 STRUCT

stAUDIO_CHANNEL_VOLUMESBezeichnung Datentyp Bedeutung Mögliche Werte

usiVolumeLeft USINT Lautstärke Lautsprecher links 0...100 %; Startwert = 10 %

usiVolumeRight USINT Lautstärke Lautsprecher rechts 0...100 %; Startwert = 10 %

DE

212

stAUDIO_SETTINGS (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

stMaster ÒstAUDIO_CHANNEL_VOLUMES

Master-Lautstärke 0...100 %; Startwert = 10 %

stSpeaker Lautstärke Lautsprecher 0...100 %; Startwert = 10 %

stHeadPhone Lautstärke Kopfhörer 0...100 %; Startwert = 10 %

stLineInToLineOut Lautstärke Aux LineIn to LineOut-Kanal

0...100 %; Startwert = 10 %

stRecording Lautstärke Aufnahme-Kanal 0...100 %; Startwert = 10 %

stCAMERA_CONFIG (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

stROI stCAMERA_ROI_CONFIG Region of Interest (ROI)-Konfiguration im Kamerabild.

Ò stCAMERA_ROI_CONFIG(STRUCT)

eFlip eOBJECT_FLIP Spiegeleinstellung Ò eOBJECT_FLIP (ENUM)

eRotation eOBJECT_ROTATION Rotationseinstellung Ò eOBJECT_ROTATION (ENUM)

udiBackgroundColour

UDINT Fensterhintergrundfarbe,wenn kein Kamerabildangezeigt wird (Kameragestoppt) im RGBA-Format.

RGBA: 16#RRGGBBAA mitrot RR = 0...FFgrün GG = 0...FFblau BB = 0...FFTransparenz AA: 0...FFBeispiele:16#FFFFFFFF = schwarz 100 %ausgefüllt (keine Transparenz)16#FFFFFF7F = weiß mit 50 %Transparenz16#0000007F = schwarz mit 50 %Transparenz

eProtocol eIP_CAMERA_PROTOCOL IP-Kamera: Streaming-Protokoll

Ò eIP_CAMERA_PROTOCOL(ENUM)

sLocation STRING IP-Kamera, nur bei RTSP:Zugriff auf den RTSP-Stream

Format:'rtsp://USER:PASSWORD@IP-ADRESSE:PORT/PFAD'Die notwendigen Angaben derDokumentation der IP-Kameraentnehmen.Beispiel für eine Axis-Kamera:'rtsp://root:[email protected]:554/axis-media/media.amp?videocodec=jpeg&resolution=1920x1080';

udiPort UDINT IP-Kamera, nur bei RTP:Netzwerk-RTP-Port

Standardwert: 50004

eEncoding ENUM IP-Kamera: Stream-KodierungBei RTSP: Die hiereingestellte Kodierung mussder Angabe imParameterstring sLocationentsprechen.

Ò eIP_CAMERA_ENCODING(ENUM)

tLatency TIME IP-Kamera: Stream-Latenz Standardwert: T#10MS

213


tStreamTimeout TIME IP-Kamera: Stream-TimeoutZeitverzögerung nachUnterbrechung des Kamera-Streams bis zum Auslösen derDiagnosemeldung.

Standardwert: T#100MS

T0#MS: Kein Timeout konfiguriert.Das Kamerabild friert ein, wenn derStream abbricht, bis der Streamwieder aktiv ist.

> T0#MS: Timeout konfiguriert. DasKamerabild friert ein, wenn derStream abbricht, bis die Timeout-Zeit abgelaufen ist. Anschließendwird das Kamera-Fenster in derkonfigurierten Hintergrundfarbeangezeigt und die MeldungSTAT_EVNT_CAMERA_STREAM_INTERRUPTED wirdausgegeben.

stCAMERA_CONTROLS (STRUCT)


xStartStop BOOL Kamera starten / stoppen. FALSE => TRUE Kamera starten.Initialwert.

TRUE => FALSE Kamera stoppen.Der eingestellteFensterhintergrundwird angezeigt.

stCAMERA_IMAGE_SIZE (STRUCT)


udiWidth UDINT Breite des Kamerabildes in Pixeln. Initialwert = 0 Pixel

udiHeight UDINT Höhe des Kamerabildes in Pixeln. Initialwert = 0 Pixel

stCAMERA_ROI_CONFIG (STRUCT)


stPosition stWINDOW_POSITION

Position der Region of Interest (ROI) → stWINDOW_POSITION (STRUCT)

stSize stWINDOW_SIZE Größe des Fensters der Region ofInterest (ROI)

→ stWINDOW_SIZE (STRUCT)

stDATE_TIME (STRUCT)

DE

214

Bezeichnung Datentyp Bedeutung Mögliche Werte Standardwert

uiYear UINT Jahr 2000...2099 2000

uiMonth UINT Monat 1...12 1

uiDay UINT Tag 1...31 1

uiHour UINT Stunde 0...23 0

uiMinute UINT Minute 0...59 0

uiSeconds UINT Sekunde 0...59 0

eDayOfWeek Ò eDAY_OF_WEEK(ENUM)

Wochentag Ò eDAY_OF_WEEK(ENUM)

0

stETHERNET_BRIDGE_CONFIG (STRUCT)

Bezeichnung Datentyp Bedeutung Mögliche Werte

xEnable BOOL Ethernet Bridge Modus FALSE deaktivieren /inaktiv

TRUE aktivieren / aktiv

stIPv4Setting Ò stIPV4SETTING(STRUCT)

Ethernet IPv4-Einstellungen derEthernet Bridge

Ò stIPV4SETTING (STRUCT)

eInterfaceA ÒeETHERNET_INTERFACES (ENUM)

1. Ethernet-Schnittstelle Ò eETHERNET_INTERFACES (ENUM)

eInterfaceB ÒeETHERNET_INTERFACES (ENUM)

2. Ethernet-Schnittstelle Ò eETHERNET_INTERFACES (ENUM)

stIPV4SETTING (STRUCT)


sIpAddress STRING(15) IP-Adresse des Geräts (IPv4) z.B. 192.168.1.10

sSubnetMask STRING(15) Subnetzmaske z.B. 255.255.255.0

sDefaultGateway STRING(15) IP-Adresse des Netzwerk-Gateways z.B. 192.168.1.1

xDHCPStat BOOL Status des DHCP-Clients des Geräts FALSE DHCP-Clientdeaktiviert

TRUE DHCP-Client aktiv

stKEY_LED_CONTROL (STRUCT)


stKey0_0 Ò stLED_SETTINGS (STRUCT) LED Gruppe 0, Taste 0 Ò stLED_SETTINGS (STRUCT)

stKey0_1 LED Gruppe 0, Taste 1



215


stKey0_4 Ò stLED_SETTINGS (STRUCT) LED Gruppe 0, Taste 4 Ò stLED_SETTINGS (STRUCT)






stKey2_Navigation LED Navigationstasten

stLED_SETTINGS (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

xON BOOL Nachtmodus für Beleuchtung derTasten-LED aktivieren/deaktivieren.

TRUE Nachtmodus-Helligkeit aktivieren

FALSE Nachtmodus-Helligkeitdeaktivieren,Normale Helligkeitaktivieren(Standardwert)

usiBrightness USINT Helligkeit der Tasten-LED imNachtmodus.Bei aktivem Nachtmodus werden dieRGB-Farbwerte auf den eingestelltenProzentsatz reduziert.Beispiel:Tasten-LED RGB im Tagmodus= WHITE = (00, 255, 255, 255)Tasten-LED RGB im Nachtmodus(Helligkeit = 20 %) =WHITE = (00,51,51,51)

1...100 %Standardwert = 20 %

stKEY_MAP_LIST (STRUCT)Parameter Datentyp Bedeutung Standardwert

eKey0_0 eKEY_MAP_CODES(ENUM)

Gruppe 0, Taste 0 eKEY_MAP_CODES.F1

eKey1_0 Gruppe 1, Taste 0 eKEY_MAP_CODES.F2









eKey2_Up Gruppe 2, Taste 0, Navigationstasteoben

eKEY_MAP_CODES.UP

eKey2_Down Gruppe 2, Taste 1, Navigationstasteunten

eKEY_MAP_CODES.DOWN

eKey2_Left Gruppe 2, Taste 2, Navigationstastelinks

eKEY_MAP_CODES.LEFT

DE

216

Parameter Datentyp Bedeutung Standardwert

eKey2_Right eKEY_MAP_CODES(ENUM)

Gruppe 2, Taste 3, Navigationstasterechts

eKEY_MAP_CODES.RIGHT

eKey2_Enter Gruppe 2, Taste 4, NavigationstasteEnter/Return

eKEY_MAP_CODES.RETURN

stLED_SETTINGS (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

xON BOOL LED einschalten/ausschalten TRUE LED einschalten

FALSE LED ausschalten(Standardwert)

udiColor UDINT RGB-Farbwert für die LED RGB: 16#00RRGGBB mitRR = 0...FFGG = 0...FFBB = 0...FFBeispiele:rot = 16#00FF0000grün = 16#0000FF00blau = 16#000000FFschwarz = 16#00000000weiß = 16#00FFFFFF

stLOCAL_IO (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

uiAmbientLight UINT Umgebungslichtstärke, gemessendurch den integrierten Lichtsensor(→ FB GetLightSensor)

0...100 %Standardwert 0 %

xInput_00 BOOL Zustand Digitaleingang 0(→ FB GetLocalInputs)

FALSE Aus (Standardwert)

TRUE Ein

xInput_01 BOOL Zustand Digitaleingan 1(→ FB GetLocalInputs)

FALSE Aus (Standardwert)

TRUE Ein

xDiagInput_00 BOOL Zustand DiagnoserückmeldungDigitalausgang 0(→ FB SetLocalOutputs)

FALSE Aus

TRUE Ein

xDiagInput_01 BOOL Zustand DiagnoserückmeldungDigitalausgang 1(→ FB SetLocalOutputs)

FALSE Aus

TRUE Ein

xOutput_00 BOOL Zustand Digitalausgang 0(→ FB SetLocalOutputs)

FALSE Aus

TRUE Ein

xOutput_01 BOOL Zustand Digitalausgang 1(→ FB SetLocalOutputs)

FALSE Aus

TRUE Ein

stSystemTemperatures ÒstSYSTEM_TEMPERATURES (STRUCT)

Systemtemperaturen(→ FB GetTemperature)

Ò stSYSTEM_TEMPERATURES(STRUCT)

stSystemVoltages ÒstSYSTEM_VOLTAGES(STRUCT)

Systemspannungen(→ FB GetVoltages)

Ò stSYSTEM_TEMPERATURES(STRUCT)

217

stNTP_SETTINGSElement Datentyp Beschreibung Mögliche Werte

xEnable BOOL Status und Befehl zum Aktivieren /Deaktivieren des NTP-Services.

FALSE Standardwertdeaktivieren / inaktiv

TRUE aktivieren / aktiv

usiServerCnt USINT Gültige NTP-Server in aServerList 0...11; Standardwert = 0

aServerList ARRAY [0..10] OF STRING Liste mit NTP-Server-Adressen(maximal 11).

IP-Adressen oder Servernamender NTP-Server.

stOUTPUT_COMMANDS (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

xValue BOOL Zustand des Digitalausgangs setzen TRUE Ausgang aktivieren

FALSE Ausgangdeaktivieren(Standardwert)

xErrorReset BOOL Fehler rücksetzen, wenn xError amAusgangsbaustein aktiv.

FALSE => TRUE Fehler rücksetzen

FALSE (Standardwert)

stPDF_CONTROLS (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

xOpenClose BOOL PDF-Dokument im PDF-Viewer-Fenster öffnen oder schließen.

TRUE PDF-Dokument imPDF-Viewer-Fensteröffnen.(Standardwert)

FALSE PDF-Dokument imPDF-Viewer-Fensterschließen.

xGotoFirstPage BOOL Erste Seite des PDFs anzeigen. FALSE => TRUE Aktion ausführen

FALSE -

xGotoLastPage BOOL Letzte Seite des PDFs anzeigen. FALSE => TRUE Aktion ausführen

FALSE -

uiGotoPage UINT Seitenzahl der Seite, die angezeigtwerden soll.Der Wert wird aktiv bei einersteigenden Flanke an xGotoSetPage .

1 (erste Seite)

xGotoSetPage BOOL Die an uiGotoPage eingestellte PDF-Seite anzeigen.

FALSE => TRUE Aktion ausführen

FALSE -

xOnePageDown BOOL Eine Seite herunterscrollen. FALSE => TRUE Aktion ausführen

FALSE -

xOnePageUp BOOL Eine Seite heraufscrollen. FALSE => TRUE Aktion ausführen

FALSE -

xRotateCCW BOOL PDF-Ansicht gegen den Uhrzeigersinnrotieren.


FALSE -

xRotateCW BOOL PDF-Ansicht im Uhrzeigersinnrotieren.


FALSE -

DE

218


xScrollDown BOOL Herunterscrollen. FALSE => TRUE Aktion ausführen

FALSE -

xScrollUp BOOL Heraufscrollen. FALSE => TRUE Aktion ausführen

FALSE -

sSearchString STRING Suchtext. -

xSearchHere BOOL Im PDF nach Suchtext suchen undzum ersten Auftreten des Sichtextesspringen.


FALSE -

xSearchDown BOOL Nach dem nächsten Auftreten desSuchtextes im PDF suchen.


FALSE -

xSearchUp BOOL Nach dem vorherigen Auftreten desSuchtextes im PDF suchen.


FALSE -

xToggle_TOC BOOL Inhaltsverzeichnis anzeigen oderausblenden.

TRUE anzeigen

FALSE ausblenden

uiZoom UINT Zoom-Faktor in %.Der Wert wird aktiv, bei einersteigenden Flanke an xZoomToValue .

10...1600 %

xZoomToValue BOOL Zoom auf den eingestellten Zoom-Faktor an uiZoom einstellen.


FALSE -

xZoomIn BOOL Herein-Zoomen Standardschritte beim Zoomen: 12, 25,33, 50, 66, 75, 100, 125, 150, 200, 400,800, 1600 %xZoomOut BOOL Heraus-Zoomen

xZoomToFitWidth BOOL Auf Fensterbreite zoomen. FALSE => TRUE Aktion ausführen

FALSE -

stSYSTEM_TEMPERATURES (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

rCore0 REAL Prozessortemperatur in °C z.B. 40.1 °C

rBoard REAL Hauptplatinentemperatur in °C z.B. 43.9 °C

stSYSTEM_VOLTAGES (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

rVBB0 REAL Systemspannung VBB0 in V z.B. 28.2 V

rVBB15 REAL Systemspannung Klemme 15 in V

rVBB30 REAL Systemspannung Klemme 30 in V

stSYS_INFO_BASIC (STRUCT)Element Datentyp Beschreibung Mögliche Werte

sDevice_FWver STRING Geräte -Fmwareversion z.B. 1.0.0.0

sDeviceHWver STRING Hardware-Version z.B. 1.1.1.1

sDevice_SerialNum STRING Seriennummer des Geräts z.B. 000000017427

219

Element Datentyp Beschreibung Mögliche Werte

sDevice_ArticleNum STRING ifm Artikelnummer z.B. CR1203

sDevice_ArticleName STRING ifm Artikelname z.B. ecomatDisplay/7"/Basic

sDevice_ArticleRev STRING ifm Artikelrevision z.B. AB

xTouchScreen_Available BOOL Touchscreen-Funktionalität vorhandenja / nein

FALSE Kein Touchscreenvorhanden

TRUE Touchscreenvorhanden

stSYS_INFO_EXTENDED (STRUCT) Element Datentyp Beschreibung Mögliche Werte

uiNumOfETHitf UINT Anzahl der verfügbarenEthernetschnittstellen

z.B 2

uiNumOfUSBitf UINT Anzahl der verfügbaren USB-Schnittstellen

z.B. 1

usiNumOfACam USINT Anzahl der verfügbarenAnalogkamera-Eingangsstreams

z.B 1

usiLocalIO_NumOfDI USINT Anzahl der verfügbarenDigitaleingänge

z.B. 2

usiLocalIO_NumOfDO USINT Anzahl der verfügbarenDigitalausgänge

z.B. 2

usiLocalIO_NumOfStatLED USINT Anzahl der verfügbaren Status-LEDs auf dem Frontpanel

z.B. 1

usiLocalIO_NumOfLightSensors USINT Anzahl der verfügbarenLichtsensoren auf dem Frontpanel

z.B. 1

xAudio_HeadPhoneOutAvailable BOOL Verfügbarkeit desKopfhörerausgangskanals

FALSE nicht vorhanden

TRUE vorhanden

xAudio_SpeakerOutAvailable BOOL Verfügbarkeit desLautsprecherausgangskanals


TRUE vorhanden

xAudio_LineInAvailable BOOL Verfügbarkeit des LineIn-Eingangskanals


TRUE vorhanden

sDevice_MfgDate STRING Herstellungsdatum Im Format TT.MM.JJJJ,hh:mm:ss, z.B. 01.12.2019,09:13:55

sDevice_MAC_ETHitf_0 STRING MAC-Adresse vonEthernetschnittstelle ETH0

z.B. 00:01:02:06:63:DE

sDevice_MAC_ETHitf_1 STRING MAC-Adresse vonEthernetschnittstelle ETH1

z.B. 00:01:02:06:63:DF

usiNumOfKeypad USINT Anzahl der verfügbaren Keypads z.B. 1

usiKeypad_0_NumOfKeys USINT Anzahl der Tasten auf Keypad 0 z.B. 6

usiKeypad_0_NumOfNaviElem USINT Anzahl der Navigationstasten aufKeypad 0

z.B. 5

usiKeypad_1_NumOfKeys USINT Anzahl der Tasten auf Keypad 1 z.B. 6

usiKeypad_1_NumOfNaviElem USINT Anzahl der Navigationstasten aufKeypad 1

z.B. 5

uiLCD_Width_mm UINT Breite des LCD in mm z.B. 153

uiLCD_Height_mm UINT Höhe des LCD in mm z.B. 92

uiLCD_Width_Pixels UINT Breite des LCD in Pixeln z.B. 800

uiLCD_Height_Pixels UINT Höhe des LCD in Pixeln z.B. 480

usiLCD_ColourDepth_bpp USINT Farbtiefe des LCD in bpp z.B. 8 = 8 bpp

DE

220

Element Datentyp Beschreibung Mögliche Werte

usiLCD_DiagonalSize_Inch USINT Bilddiagonale des LCD in Zoll z.B. 7 = 7 Zoll

stSYS_INFO_INTERNAL (STRUCT)Element Datentyp Beschreibung Mögliche Werte

sDevice_ProductType STRING Produkttyp z.B. pdm3_12w_002

udiDevice_SWcompatibility UDINT Softwarekompatibilität z.B. 4

sDevice_ProductionOrderNum STRING Geräteproduktionsnummer z.B. 9999999

sKeypad_0_FWver STRING Firmwareversion Keypad 0

sKeypad_0_HWver STRING Hardwareversion Keypad 0

sKeypad_1_FWver STRING Firmwareversion Keypad 1

sKeypad_1_HWver STRING Hardwareversion Keypad 1

udiFrontPanel_SerialNum UDINT Frontpanel Seriennummer z.B. 4294967296

sFrontPanel_MfgWeek STRING Frontpanel Herstellungswoche z.B. 51

sFrontPanel_MfgYear STRING Frontpanel Herstellungsjahr z.B. 2019

uiFrontPanel_VendorId UINT Frontpanel Hersteller ID z.B. 65535

uiFrontPanel_Id UINT Frontpanel ID z.B. 65535

sLCD_MfgrName STRING LCD Herstellername

usiTouchScreen_Address USINT Touchscreen-Adresse z.B. 5A

uiTouchScreen_VendorId UINT Touchscreen-Controller HerstellerID

z.B. 65535-

usiTouchScreen_DeviceId USINT Touchscreen-Controller Geräte ID z.B. 65535

sMainBoard_OrderNum STRING Produktionsnummer desMainboards

z.B. 9999999

sMainBoard_MaterialNum STRING ERP Materialnummer desMainboards

z.B. 9999999

sMainBoard_MaterialRev STRING ERP Materialrevision desMainboards

z.B. 00

stUSB_STORAGE_INFO (STRUCT)Element Datentyp Beschreibung Mögliche Werte

sFileSystemName STRING(40) Name des gemounteten Dateisystems z.B. /dev/sda1Standardwert: "not available"

sAccessPath STRING(50) USB-Speicher-Verzeichnis z.B. /media/usb/sda1Standardwert: "not available"

sFileSystemType STRING(16) Dateisystem-Typ z.B. vfatStandardwert: "not available"

xRemove BOOL Befehl zum Unmounten des USB-Speichers FALSE ->TRUE

Unmountenaktivieren.

FALSE Unmount-Operation isterfolgt.

221

stWINDOW_CONFIG (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

stPosition stWINDOW_POSITION Fensterposition → stWINDOW_POSITION(STRUCT)

stSize stWINDOW_SIZE Fenstergröße in Pixeln → stWINDOW_SIZE (STRUCT)

sFileName_PrintWindow STRING (255) Dateiname, Pfad und Format fürScreenshot.

z.B. '/home/cds-apps/ScreenShot.jpg'

stWINDOW_CONTROLS (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

xVisible BOOL Fenster sichtbar / unsichtbar schalten. FALSE =>TRUE

Fenster erscheint.Initialwert.

TRUE =>FALSE

Fensterverschwindet.

xBringToTop BOOL Fenster in den Vordergrund bringen. FALSE =>TRUE

Fenster in denVordergrundbringen.

FALSE

xSendToBottom BOOL Fenster in den Hintergrund bringen. FALSE =>TRUE

Fenster in denHintergrund bringen.

FALSE

xOneLevelUp BOOL Fenster eine Ebene weiter nach vornebringen.

FALSE =>TRUE

Fenster eine Ebeneweiter nach vornebringen.

FALSE

xOneLevelDown BOOL Fenster eine Ebene weiter nach hintenbringen.

FALSE =>TRUE

Fenster eine Ebeneweiter nach hintenbringen.

FALSE

xLockPosition BOOL Fensterposition sperren / entsperren. FALSE =>TRUE

Fensterpositionsperren.

TRUE =>FALSE

Fensterpositionentsperren.

xLockSize BOOL Fenstergröße sperren / entsperren. FALSE =>TRUE

Fenstergrößesperren.

TRUE =>FALSE

Fenstergrößeentsperren.

xPrintWindow BOOL Screenshot des Fensterinhalts erstellen undals Datei speichern.

FALSE =>TRUE

Screenshot erstellen.

FALSE

stWINDOW_POSITION (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

uiX UINT X-Position des Fensters in Pixeln. 0...4096; Initialwert = 0

uiY UINT Y-Position des Fensters in Pixeln. 0...4096; Initialwert = 0

DE

222

stWINDOW_SIZE (STRUCT)Parameter Datentyp Bedeutung Mögliche Werte

uiWidth UINT Breite des Fensters in Pixeln. 0...4096; Initialwert = 0 Pixel

uiHeight UINT Höhe des Fensters in Pixeln. 0...4096; Initialwert = 0 Pixel

9.4.16 Global

aETH_ITF_LIST (ALIAS)Liste der Namen aller verfügbaren Ethernet-Schnittstellen.

aTIME_ZONE_LIST (ALIAS)Name Beschreibung Datentyp Wert

Zeitzone 0 Bezeichnung RTC-Zeitzone 0 STRING(31) 0


... ... STRING(31) ...


aUSB_STORAGE_INFO_LIST (ALIAS)Liste der gemounteten USB-Speicher-Geräte.

GCL_Data (GVL)Name Beschreibung Datentyp Wert

usiMaxEthItf Anzahl der Ethernet-Schnittstellen des Geräts USINT 16

usiNumberOfSysInfo Anzahl der System-Information-Parameter des Geräts. USINT 7

usiMaxStrgDevi Anzahl der unterstützten USB-Speichermedien. USINT 16

usiMaxTimeZones Anzahl der RTC-Zeitzonen. USINT 121

9.5 Bibliothek ifmFileUtil.libraryDie Bibliothek enthält Programmbausteine (POU), Datenstrukturen und Aufzählungstypen fürDateioperationen.

9.5.1 Generic File

DeleteFileBaustein-Typ: Funktionsbaustein (FB)


Bibliothek: ifmFileUtil.library

223

Symbol in CODESYS:

BeschreibungDer FB löscht eine Datei vom FLASH-Speicher des Geräts oder vom USB-Speicher.

Eingangsparameter




sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'

Folgende Eingaben für "sFileName" sind ungültig und erzeugen eine Fehlermeldung:

• Wert enthält Leerzeichen

• kein Wert wird eingegeben

• Wert ist ein Ordner (z. B. /home/cds-apps/)

• Wert enthält aufeinanderfolgende "/" (z. B. /home/cds-apps///LogFile.csv)

Ausgangsparameter









nen beachten


Diagnose-Codes:



DE

224


• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.




225

FileCopyBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB kopiert eine Datei oder mehrere Dateien von einem Quellverzeichnis auf dem Gerät in einZielverzeichnis auf dem Gerät.

Der FB nutzt den Linux-Befehl "cp -rf <sSource> <sDestin>".

Eingangsparameter




sSource STRING Quellverzeichnis/-datei z.B. /data/source /data/sourcefile.txt /data/*.txt

sDestin STRING Zielverzeichnis/-datei auf dem Gerät z.B. /data/destin

Folgende Möglichkeiten für die Dateiauswahl bestehen:

• einzelne Dateien (z. B. /home/values/sample.csv)

• mehrere Dateien mithilfe von Wildcards (z. B. /home/values/*.csv)

• alle Dateien eines Verzeichnisses (z. B. /home/values/)

Folgende Kombinationen aus Quell- und Zielangaben sind gültig:

• Werte für Quelle und Ziel sind unterschiedlich und beides sind Ordner

• Werte für Quelle und Ziel sind unterschiedlich und beides sind Dateien

• Wert für Quelle ist Datei und Wert für Ziel ist Ordner

Folgende Kombinationen aus Quell- und Zielangaben sind ungültig und erzeugen eineFehlermeldung:

• keine Werte für Quelle und/oder Ziel

• Wert für Quelle ist Ordner und Wert für Ziel ist Datei

• Werte für Quelle und/oder Ziel enthalten aufeinanderfolgende "/" (z. B. /home/values///file.csv)

• Werte für Quelle und/oder Ziel enthalten Leerzeichen

• Werte für Quelle und Ziel sind gleich (Datei und Ordner)

DE

226

Ausgangsparameter









nen beachten


Diagnose-Codes:








227

Copy_Device_To_USBBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB kopiert eine Datei oder mehrere Dateien von einem Quellverzeichnis auf dem Gerät in einZielverzeichnis auf einem USB-Speicher.

u Der FB nutzt den Linux-Befehl "cp -rf < sDevicePath > < sUSBpath >".

Eingangsparameter





sDevicePath STRING Quellverzeichnis/-datei auf dem Gerät,dessen Inhalt kopiert werden soll

z.B. ' /data/tmp/logfile.csv'

sUSBpath STRING Zielverzeichnis auf dem USB-Speicher, indas die Dateien kopiert werden sollen• Das Verzeichnis als relativen Pfad zum

Mount-Punkt des USB-Gerät eingeben.• Beispiel: '/sda1/NewFolder' kopiert die

gewählten Dateien in das Verzeichnis ' /media/USB/sda1/NewFolder/'

z.B. ' /sda1/NewFolder'

DE

228















Ausgangsparameter









nen beachten


Diagnose-Codes:








229

DE

230

Copy_USB_To_DeviceBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB kopiert eine Datei oder mehrere Dateien von einem USB-Speicher in ein Zielverzeichnis aufdem Gerät.

u Der FB nutzt den Linux-Befehl "cp -rf < sUSBpath > < sDevicePath >".

Eingangsparameter





sUSBpath STRING Quellverzeichnis /-datei auf dem USB-Speicher• Das Verzeichnis als relativen Pfad zum

Mount-Punkt des USB-Gerät eingeben.• Beispiel: '/sda1/NewFolder' kopiert alle

Dateien des Verzeichnisses ' /media/USB/sda1/NewFolder/'

z.B. ' /sda1/NewFolder'

sDevicePath STRING Zielverzeichnis auf dem Gerät z.B. ' /data/tmp/'

231















Ausgangsparameter









nen beachten


Diagnose-Codes:








DE

232

233

SyncFileMemoryBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB synchronisiert den NAND-Flash-Speicher mit dem Arbeitsspeicher (RAM) des Geräts.

u Den FB als letzte Operation vor dem Herunterfahren des Geräts ausführen!

u Der FB nutzt den Linux-Befehl "sync".

Eingangsparameter




Ausgangsparameter









nen beachten


Diagnose-Codes:

DE

234







235

9.5.2 Parameter File

WriteParmSingleAsyncBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt einen einzelnen Parameter vom Typ UDINT in eine Textdatei.

Der Parameter wird in der Datei als 10-stelliger Wert und rechtsbündig gespeichert.

Beispiel:

Wert in Datei gespeichert als

1 0000000001

123 0000000123

1234567890 1234567890

Eingangsparameter






udiInData UDINT Parameter, der geschrieben werden soll 0...65535

Ausgangsparameter







DE

236





nen beachten


hFileHand RTS_IEC_HANDLE

Dateibeschreibung des Laufzeitsystems < 1 Fehler

sonst. kein Fehler

Diagnose-Codes:





• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.


• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.

237

ReadParmSingleAsyncBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest aus einer Textdatei einen einzelnen Datensatz vom Typ UINT und gibt diesen aus.

Die Datei darf nur diesen einen Datensatz enthalten. Der Wert in der Datei muss 10-stellig undrechtsbündig gespeichert sein.

Beispiel:

Wert in Datei gespeichert als

1 000000001

123 000000123

12345567890 1234567890






Ausgangsparameter Parameter Datentyp Bedeutung Mögliche Werte








nen beachten




DE

238



Dateibeschreibung des Laufzeitsystems sonst. kein Fehler

udiReadParm

UDINT gelesener Parameter aus der Textdatei 0...4294967295

Diagnose-Codes:








239

9.5.3 Log File

ReadCSV8ByteBaustein-Typ: Funktionsbaustein (FB)

Verhaltensmodell: EXECUTE with Trigger


Symbol in CODESYS:

BeschreibungDer FB liest Datensätze aus einer CSV-Datei und gibt sie aus. Der FB weist ungenutzten Zellen denWert 0 zu. Der FB speichert zu jedem Datensatz den Zeitstempel. Die CSV-Datei muss mit dem FB (Ò WriteCSV8Byte / 243) erzeugt worden sein.

Jeder Datensatz muss 54 Byte groß sein.

Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte


sonst. keineAuswirkungenauf FB-Abarbeitung

xTrigger BOOL Aktion auslösen FALSE => TRUE FB liestgewähltenDatensatz

sonst. keine Aktion


udiDataSetNb UDINT Nummer des Datensatzes, der aus der Dateigelesen werden soll

0 ... 65535

Ausgangsparameter





DE

240






nen beachten


xEOF BOOL Anzeige des Dateiendes FALSE Dateiende noch nichterreicht

TRUE Dateiende erreicht

stReadData stLogData Datenstruktur mit allen gelesenen DatenÒ stLogData (STRUCT)

xwReadSize XWORD Größe des zuletzt gelesenen Datensatzes 54 Lesevorgangerfolgreich

sonst. Lesevorgang fehlerhaft

Diagnose-Codes:



• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe





241

ReadCSVDataBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest Datensätze aus einer CSV-Datei und gibt sie aus.

Der FB weist ungenutzten Zellen den Wert 0 zu. Der FB speichert zu jedem Datensatz denZeitstempel.

Die CSV-Datei muss mit dem FB (Ò WriteCSVData_Linear / 248) oder mit dem FB (Ò WriteCSVData_Ring / 251) erzeugt worden sein.


xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB öffnet Datei

TRUE [ FALSE • FB schließt Datei• alle Ausgänge

werdenzurückgesetzt

xTrigger BOOL Aktion auslösen FALSE => TRUE FB liest gewähltenDatensatz

sonst. keine Aktion

sFileName STRING Verzeichnispfad und Name der Datei z.B. '/home/project/data.csv'

udiDataSetNb UDINT Nummer des Datensatzes, der aus derDatei gelesen werden soll

0 ... 4294967295









nen beachten


DE

242


xEOF BOOL Anzeige des Dateiendes FALSE Dateiende noch nichterreicht

TRUE Dateiende erreicht

sCSVHeader

STRING CSV-Header ausgelesen aus der Datei. CSV-Header: sofern in der Dateivorhanden

Erster Datensatz: sofern kein CSV-Header in der Datei vorhanden ist.

sReadData STRING CSV-Datensatz mit allen aus der Datei gelesenenDaten

--

udiReadSize

UDINT Größe des zuletzt gelesenen Datensatzes in Bytes --

Diagnose-Codes:





• STAT_RESET Zustand: FB/Funktion führt eine RESET-Operation durch.





243

WriteCSV8ByteBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest die Daten aus einem Array mit 8 Bytes und schreibt diese als Datensatz in eine CSV-Datei. Der FB speichert zu jedem Datensatz zusätzlich einen Zeitstempel (Datum, Uhrzeit). Nachdemder Datensatz geschrieben wurde, inkrementiert der FB automatisch den Pointer zum nächsten Arrayin der Datenstruktur.

Prinzip:

Nr. des Datensatzes Inhalt des Datensatzes

1 Zeitstempel*, Byte 0, Byte 1, ..., Byte 7

2 Zeitstempel, Byte 0, Byte 1, ..., Byte 7

... ...

udiDataSetNbMax Zeitstempel, Byte 0, Byte 1, ..., Byte 7

* ...Format des Zeitstempels: TT.MM.JJJJ SS:MM:SS

Beispiel für Datensatz:

04.08.2016 19:59:55,0,15,245,15,251,15,0,8

Der Anwender kann zwischen folgenden Schreibmodi wählen:

• Linear:Die Datensätze werden linear geschrieben. Die Anzahl der Datensätze ist theoretisch unbegrenzt;sie wird nur durch die maximale Dateigröße begrenzt, die vom Betriebssystem vorgegeben ist.Existierende Datensätze werden nicht überschrieben.

• Ring:Die Datensätze werden in einen Ringpuffer geschrieben. Die Anzahl der Datensätze ist begrenzt.Nachdem die letzte Speicherzelle des Ringpuffers geschrieben wurde, beginnt der FB wieder beider ersten Speicherzelle des Ringpuffers. Existierende Datensätze werden überschrieben.

Im Modus "Linear" sind die Bytes 0 bis 53 reserviert für den CSV-Header. Der CSV-Header kannnachträglich mit dem FB (Ò WriteCSV8ByteHeader / 246) hinzugefügt werden.

Im Ring-Modus muss der CSV-Header vor dem Schreiben der Datensätze in die Dateigeschrieben werden.

Eingangsparameter



DE

244


xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließtDatei

• alle Ausgängewerdenzurückgesetzt


sonst. keine Aktion


aLogData ARRAY [0..7] OFBYTE

Array mit den Daten, die in die CSV-Datei geschrieben werden sollen

eWriteMode eCSVmode SchreibmodusÒ eCSVmode (ENUM)

LINEAR Linear-Modus*

RING Ring-Modus

udiDataSetNbMax UDINT Maximale Anzahl der Datensätze imRing-Modus

0...65535

xRst BOOL CSV-Datei und Pointer zum Datensatzlöschen

FALSE => TRUE Pointer und CSV-Datei löschen

sonst. keine Aktion

* ... voreingestellter Wert






Ausgangsparameter











xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 0...4294967295

245


sLastLogMsg STRING Zuletzt geschriebener Datensatz als STRING z.B. 06.12.201620:35:45,10,101,255,103,104,105,106,$n

udiDataSetNb UDINT Nummer des Datensatzes, der zuletzt in die Dateigeschrieben wurde

0 ... 65535

udiRingCnt UDINT Zähler für abgeschlossenen Durchläufe des Ring-Pufferspeichers

0 ... 65535

Diagnose-Codes:









DE

246

WriteCSV8ByteHeaderBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt die Kopfzeile in eine CSV-Datei. Die Kopfzeile wird immer in den Bytes 0 bis 53 derDatei geschrieben.



sonst. keineAuswirkungen aufFB-Abarbeitung


stHeader stCSVHeader Struktur mit Header-DatenÒ stCSVHeader (STRUCT)

Timestamp,R1C2,R1C3,...,R1C9*













247





nen beachten


LastLogMsg STRING geschriebene Kopfzeile als STRING

udiDataSetPosi

UDINT Nummer des zuletzt geschriebenen Datensatzes 0...65535

Diagnose-Codes:








DE

248

WriteCSVData_LinearBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt einen Datensatz linear in eine CSV-Datei.

• Bei einer steigenden Flanke an xExecute wird die an sFileName angegebene Datei geöffnet.

• Wenn xExecute = TRUE ist, scheibt der FB bei jeder steigenden Flanke an xTrigger denDatensatz sCSVData in die geöffnete Datei sFileName .

• Bei einer fallenden Flanke an xExecute wird die an sFileName angegebene Datei geschlossen.

• Der FB speichert am Anfang eines jeden Datensatzes zusätzlich einen Zeitstempel im FormatDD.MM.YYYY hh:mm:ss .

• Ein Datensatz entspricht einer Zeile in der CSV-Datei.

• Die Anzahl der Datensätze ist theoretisch unbegrenzt; sie wird nur durch die maximale Dateigrößebegrenzt, die vom Betriebssystem oder vom verfügbaren Speicher vorgegeben ist.

• Existierende Datensätze werden nicht überschrieben. Neue Datensätze werden an die bestehendeDatei angehängt.

• Ein Dateiheader kann mit dem FB WriteCSVHeader vor Schreiben des ersten Datensatzes in dieCSV-Datei geschrieben werden.

Die Größe der CSV-Datei nimmt mit jedem geschriebenen Datensatz zu.

Die Datei kann sehr groß werden.

u Die Speichergröße des Geräts beachten.

Prinzip:

Nr. desDatensatzes Inhalt des Datensatzes

1 DD.MM.YYYY hh:mm:ss, Byte 0, Byte 1, Real 0, String 0, Real 1, Byte 2


... ...

Beispiele für einen Datensatz:

24.09.2020 19:59:55,0,15,245.45,‘Errorcode 996346‘,251.43567,15



249


xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließtDatei

• alle Ausgängewerdenzurückgesetzt

xTrigger BOOL Aktion auslösen FALSE => TRUE FB liestgewähltenDatensatz

sonst. keine Aktion


sCSVData STRINGifmGCL (GVL) -21

CSV-Daten, die in der Datei gespeichert werdensollen.Reservierter Speicher für Zeitstempel und NewLine-Zeichen am Ende der Zeile (21 Bytes)

xRst BOOL CSV-Datei und Pointer zum Datensatz löschen FALSE => TRUE Pointer und CSV-Datei löschen

sonst. keine Aktion









FALSE FB wirdausgeführt


• FB kannerneutaufgerufenwerden


FALSE kein Fehleraufgetreten oderder FB wird nochausgeführt


• Aktion konntenichtausgeführtwerden




DE

250


sLastLogMsg STRING Zuletzt geschriebener Datensatz alsSTRING

z.B. 06.12.201620:35:45,10,101,255,103,104,105,106,$n

udiDataSetNb UDINT Nummer des Datensatzes, der zuletzt in dieDatei geschrieben wurde

0 ... 65535

udiLastLogDataSize UDINT Größe des zuletzt geschriebenenDatensatzes in Byte.

0 ... ifmGCL (GVL)

Diagnose-Codes:













Zusatzinformation zu ERR_INVALID_VALUE:

Mögliche Ursachen an Eingangsparameter sFileName :

• Ungültiges Verzeichnis

• Kein Dateipfad angegeben

• Ungültige Folge mehrerer "/"

• Ungültige Zeichen

251

WriteCSVData_RingBaustein-Typ: Funktionsbaustein (FB)



Symbol inCODESYS:

BeschreibungDer FB schreibt einen Datensatz im Ring-Mode in eine CSV-Datei.

• Bei einer steigenden Flanke an xExecute wird die an sFileName angegebene Datei geöffnet.

• Wenn xExecute = TRUE ist, scheibt der FB bei jeder steigenden Flanke an xTrigger denDatensatz sCSVData in die geöffnete Datei sFileName .

• Bei einer fallenden Flanke an xExecute wird die an sFileName angegebene Datei geschlossen.

• Der FB speichert am Anfang eines jeden Datensatzes zusätzlich einen Zeitstempel im FormatDD.MM.YYYY hh:mm:ss .

• Ein Datensatz entspricht einer Zeile in der CSV-Datei.

• Die Anzahl der Datensätze ist begrenzt durch den Wert an udiDataSetNbMax .

• Der älteste existierende Datensatz wird nach Erreichen der maximalen Anzahl gelöscht. Der neueDatensatz wird an die bestehende Datei angehängt.

• Ein Dateiheader kann mit dem FB WriteCSVHeader vor Schreiben des ersten Datensatzes in dieCSV-Datei geschrieben werden.

• Die Dateigröße bleibt gleich, da ältere Einträge überschrieben werden. Die Dateigröße wird von derAnzahl der Datensätze begrenzt.

Prinzip:

Nr. desDatensatzes Inhalt des Datensatzes



... ...

Beispiele für einen Datensatz:

24.09.2020 19:59:55,0,15,245.45,‘Errorcode 996346‘,251.43567,15



DE

252


xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließt Datei• alle Ausgänge

werdenzurückgesetzt


sonst. keine Aktion


sCSVData STRINGifmGCL (GVL) -21

CSV-Daten, die in der Dateigespeichert werden sollen.Reservierter Speicher für Zeitstempelund New Line-Zeichen am Ende derZeile (21 Bytes)

udiDataSetNbMax UDINT Maximale Anzahl der Datensätze imRing-Modus

0...65535

xRst BOOL CSV-Datei und Pointer zumDatensatz löschen

FALSE => TRUE Pointer und CSV-Datei löschen

sonst. keine Aktion
















en beachten



sLastLogMsg STRING Zuletzt geschriebener Datensatz alsSTRING

z.B. 06.12.201620:35:45,10,101,255,103,104,105,106,$n

udiDataSetNb UDINT Nummer des Datensatzes, der zuletzt indie Datei geschrieben wurde

0 ... 65535

253


udiRingCnt UDINT Zähler für abgeschlossenen Durchläufedes Ring-Pufferspeichers

0 ... 65535

udiLastLogDataSize UDINT Größe des zuletzt geschriebenenDatensatzes in Byte.

0 ... ifmGCL (GVL)

Diagnose-Codes:













Zusatzinformation zu ERR_INVALID_VALUE:

Mögliche Ursachen an Eingangsparameter sFileName :

• Ungültiges Verzeichnis

• Kein Dateipfad angegeben

• Ungültige Folge mehrerer "/"

• Ungültige Zeichen

DE

254

WriteCSVHeaderBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB schreibt die Kopfzeile in eine CSV-Datei, die anschließend mit dem FB WriteCSVData_Linearoder dem FB WriteCSVData_Ring geschrieben wird.

Wenn die an sFileName angegebene Datei bereits existiert, wird der Dateianfang mit der Länge desan sHeader angegebenen Strings überschrieben.

Die Datei wird neu erzeugt, wenn sie noch nicht existiert.

Eingangsparameter




sFileName STRING Verzeichnispfad und Name der Datei z.B. '/home/project/data.csv'

sHeader STRING String mit Header-Daten für die CSV-Datei






Ausgangsparameter







255





nen beachten


sLastLogMsg

STRING geschriebene Kopfzeile als STRING

udiDataSetPos

UDINT Nummer des zuletzt geschriebenen Datensatzes 0...4294967295

Diagnose-Codes:










DE

256

9.5.4 Support

Buffer_To_StringBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest ein BYTE-Array, verkettet die Werte und gibt das Ergebnis in einem STRING-Array aus.

• Größe des BYTE-Arrays: 500 Bytes

• Größe des STRING-Arrays: 25 Strings

Wenn der FB in den Quelldaten das Steuerzeichen für Zeilenende/Zeilenumbruch findet, dannschreibt er die nachfolgenden Daten in eine neue Array-Zeile.

Wenn der FB in den Quelldaten einen 0-Wert oder das Steuerzeichen für Dateiende findet, dannbeendet er die Konvertierung.

u BUFFER_TO_STRING ist eine Hilfsfunktion für andere Bausteine.

Eingangsparameter




abyInData ARRAY[0...499] OF BYTE

Pufferspeicher, der die zu lesendenDaten enthält

pro Byte:0x00 ... 0xFF

Ausgangsparameter





257






nen beachten


aTextLine ARRAY[0..24] OF STRING

Array mit konvertierten Textzeilen

byNoOfTextLine

BYTE Anzahl der gefundenen Zeilen im Array

Diagnose-Codes:




DE

258

GetFileSizeAsyncBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB ermittelt die Größe einer Datei.

Eingangsparameter










Ausgangsparameter









nen beachten


259




sonst. kein Fehler


Diagnose-Codes:







DE

260

GetMemoryInfoAsyncBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB gibt detailierte Informationen über die Speicherbelegung und den verfügbaren Speicher einesVerzeichnisses aus (z. B. /data). Der FB speichert die Informationen in einer Textdatei, die dengleiche Name besitzt wie der Wert an "eDirName". Die Textdateien werden in folgendenVerzeichnissen gespeichert:

eDirName Speicherort

NAND_FLASH_1GB /data/

sonst. /home/cds-apps/PlcLogic/

Beispiel:

eDirName: HOME

Speicherort: /home/cds-apps/PlcLogic/home.txt

Eingangsparameter




eDirName eFileSystem Verzeichnis, dessen Speicherinformation gelesenwerden sollen

Ò eFileSystem (ENUM)

Ausgangsparameter


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wirdausgeführt

261


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist TRUE • FBerfolgreichausgeführt

• FB kannerneutaufgerufenwerden


FALSE kein Fehleraufgetretenoder der FBwird nochausgeführt


• Aktionkonnte nichtausgeführtwerden



aFileInfoText ARRAY[0..24] OFSTRING

Array mit Speicherinformationen desVerzeichnispfades

stMemInfo stMemoryInfo ausgelesene Speicherinformationen Ò stMemoryInfo (STRUCT)

Diagnose-Codes:








DE

262

9.5.5 Functions

ByteArray_To_StringBaustein-Typ: Funktion (FUN)

Verhaltensmodell: --


Symbol in CODESYS:

BeschreibungDie Funktion liest ein Byte Array ein, verkettet die Werte und gibt sie als Zeichenkette aus.

Eingangsparameter



Array mit Eingangsdaten pro Byte:0x00 ... 0xFF

Ausgangsparameter


ByteArray_To_String STRING Zurückgegebene Zeichenkette

263

DW_To_4ByteBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert ein DWORD in ein Array mit 4 Bytes.

Beispiel:

DWORD: 0xFFEEDDCCARRAY[0..3] OF BYTE: 0xFF | 0xEE | 0xDD | 0xCC


dwInData DWORD Daten z.B. 0xFFDDEECC

Ausgangsparameter


DW_To_4BytebyNoOfTextLine ARRAY[0..3] OF BYTE

Rückgabewert derFunktion

z.B.Byte 0: CCByte 1: DDByte 2: EEByte 3: FF

DE

264

Pack2Byte_To_WordBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert ein Array aus 2 Bytes zu einem Wort.

Beispiel:

aInData[0] = 0x00aInData[1] = 0xAA

Pack2Byte_To_Word = 0xAA00

Eingangsparameter




Ausgangsparameter


Pack2Byte_To_Word WORD Rückgabewert der Funktion 0x0000 ... 0xFFFF

265

Pack4Byte_To_DWBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert ein Array aus 4 Bytes in ein Doppelwort.

Beispiel:

aInData[0] = 0x00aInData[1] = 0x11aInData[2] = 0xAAaInData[3] = 0xFF

Pack4Byte = 0xFFAA1100





Pack4Byte_To_DW DWORD Rückgabewert der Funktion 0x00000000 ... 0xFFFFFFFF

DE

266

RTC_To_StringBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion liest die geräteinterne Echtzeituhr (RTC) und gibt die Laufzeit in Sekunden seit demletzten Systemstart als String aus.

Ausgangsparameter


RTC_To_String STRING Aktuelle Zeit im Format DD.MM.YYYY HH:MM:SS

z.B. 02.08.2016 08:59:03

267

Word_To_2ByteBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert ein WORD in ein Array mit 2 Bytes.

Beispiel:

wInData = 0xFFEE

Word_To_2Byte[0] = 0xEEWord_To_2Byte[1] = 0xFF

Eingangsparameter


wInData WORD Daten 0x0000 ... 0xFFFF

Ausgangsparameter


Word_To_2Byte ARRAY[0..1] OF BYTE

Rückgabewert derFunktion

Pro Byte:0x00 ... 0xFF

DE

268

_8Byte_To_CSVBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert die Daten eines Arrays aus 8 Byte in einen CSV-String und gibt diesen aus.Ein- und zweistellige Zahlen werden dabei mit führenden Nullen ergänzt. Die einzelnen Werte sinddurch eine Komma getrennt. Das Zeilenende ist durch ein Komma ( , ) gekennzeichnet.

Beispiel:

aInData[0] = 0x00aInData[1] = 0x01aInData[2] = 0x63aInData[3] = 0x64aInData[4] = 0xA0aInData[5] = 0xEEaInData[6] = 0xFFaInData[7] = 0x11

8byte_To_CSV = 000,001,099,100,160,238,255,017,

Eingangsparameter


abyInData ARRAY[0..7] OF BYTE


Ausgangsparameter


_8Byte_To_CSV STRING CSV-String; einzelne Bytes sind durchKomma getrennt

z.B.002,004,008,016,032,064,128,255

269

ANY_TYPE_TO_STRINGBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion konvertiert einen Datenwert in eine Zeichenkette.

Folgende Datentypen werden konvertiert: BYTE, WORD, DWORD, LWORD, USINT, UINT, UDINT,ULINT, SINT, INT, DINT, LINT, REAL, LREAL, STRING.

Es kann definiert werden, ob ein Trennzeichen ergänzt werden soll und ob es vor oder nach demDatenwert erscheint.


anyVar ANY CSV-Daten, die in eineZeichenkette konvertiertwerden sollen.

-

stSepCfg stSEPARATOR_CONFIG CSV-Trennzeichen-Konfiguration (Ò stSEPARATOR_CONFI

G (STRUCT) / 275)


ANY_TYPE_TO_STRING STRING Zeichenkette mit denkonvertierten CSV-Daten incl.Trennzeichen.

--


Diagnose-Codes:



DE

270

ifmCONCATBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion verbindet 2 Strings und gibt das Ergebnis in einem String aus.

u Die String-Länge der verwendeten Strings beträgt mehr als die standardmäßigen 255 Zeichenund ist definiert in der globalen Konstante ifmGCL.uiGenericLogSizeMax . (Ò ifmGCL(GVL) / 275)


sStr1 STRING Zeichenkette 1 --



ifmCONCAT STRING Zeichenkette sStr1 + sStr2 --

271

ifmFINDBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion gibt die Position des Strings sStr2 im String sStr1 zurück. Die Suche startet anuiPosition .




sStr2 STRING Zeichenkette 2, nach dieserwird in Zeichenkette 1gesucht.

--

uiPosition UINT Startposition für das Suchenin der Zeichenkette 1

0 = 1. Zeichen


ifmFIND UINT Position von sStr2 in sStr1 --

DE

272

ifmMIDBaustein-Typ: Funktion (FUN)



Symbol in CODESYS:

BeschreibungDie Funktion liest einen Teilstring eines anderen Strings aus.


Beispiel:

uiPosition 0 1 2 3 4 5

sStr a b c d e f

sStr = "abcdef"

uiPosition = 1

uiLength = 3

=> ifmMTD = "bcd"


sStr STRING Zeichenkette --

uiPosition UINT Startposition in derZeichenkette

0 = 1. Zeichen

uiLength UINT Anzahl der Zeichen --


ifmMID STRING Teilstring mit der LängeuiLength ab StartpositionuiPosition.

--

273

9.5.6 ENUM

eCSVmode (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eCSVmode Schreibmodus für CSV-Datei NONE INT 0

LINEAR INT 1

RING INT 2

eFileSystem (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

eFileSystem Verzeichnispfade für dasEinbinden von Geräten undDateien

ROOT / INT 0

DEV /dev INT 1

TMPFS /tmpfs INT 2

HOME /home INT 3

NAND_FLASH_1GB /data INT 4

FONTS /opt/qt-x.y.z/lib/fonts INT 5

USB1 /tmpfs/media/usb/<USB Name> INT 6




DE

274

9.5.7 STRUCT

stCSVHeader (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

sColumn1 STRING(18) Überschrift der Spalte 1 DateAndTime*

sColumn2 STRING(3) Überschrift der Spalte 2 R1C2*








* ... voreingestellter Wert (R = Row, C = Column, R1C2 = Reihe 1, Spalte 2)

stMemoryInfo (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

udiTotalKB UDINT Gesamter Speicher (in kBytes)

udiUsedKB UDINT Genutzter Speicher (in kBytes)

udiAvailKB UDINT Verfügbarer Speicher (in kBytes)

usiUsedPerc UDINT Anteil des genutzten Speichers angesamten Speicher (in %)

stLogData (STRUCT)Bezeichnung Datentyp Bedeutung Mögliche Werte

sTimeStamp STRING Zeitstempel (TT.MM.JJJJ HH:MM:SS)

aData ARRAY[0..7] OF BYTE CSV-Datensatz

sRawData STRING sTimeStamp und aData alsSTRING; Werte sind komma-separiert

stLOG_FILE_CONFIG (STRUCT)Logfile-Parameter.


xwPosition __XWORD Cursor-Position (Byte)

udiDataSetNb UDINT Datensatznummer

sCSVmode STRING CSV-Datei Log-Mode LINEAR / RING

udiRingCnt UDINT Ring-Zähler; Gibt an, wie oft die Datei im Ring-Mode überschrieben wurde.

xwLastLogDataSize __XWORD Letzte geloggte Datensatzgröße in Bytes.

xHeaderSet BOOL Zeigt an, ob ein Header in die Datei geschriebenwurde (FB WriteCSVHeader)

TRUE Header wurdegeschrieben.

275


xHeaderSet BOOL Zeigt an, ob ein Header in die Datei geschriebenwurde (FB WriteCSVHeader)

FALSE Header wurdenoch nichtgeschrieben.

udiDataSetNbMax UDINT Maximale Anzahl an Datensätzen, die im RING-Mode in die Datei geschrieben werden (FIFO).

stSEPARATOR_CONFIG (STRUCT)

Konfiguration des CSV-Trennzeichens.


sChar STRING[1] CSV-Trennzeichen Komma ","Semikolon ";" (Standardwert)Kein Trennzeichen ""

xAfterData BOOL Definiert, ob das Trennzeichen vor oder nach demDatenwert erscheinen soll.

TRUE Nach dem Datenwert, z.B."1234;"

FALSE Vor dem Datenwert, z.B.";1234" (Standardwert)

9.5.8 GlobalConstants

ifmGCL (GVL)Name Beschreibung Datentyp Wert

uiHeaderSize Länge des CSV-Datei-Headers (1 Byte ist für denZeilenumbruch reserviert)

UINT 53

uiLogTextSize Länge des CSV-Datei-Texts (1 Byte ist für denZeilenumbruch reserviert)

UINT 53

sAsyncTaskName Async task name für die ifmFileUtil Bibliothek STRING 'Task_ifmFileUtil'

udiTaskSleepTime Async task sleep time in ms UDINT 20

udiTaskTimeout Async task time out in ms UDINT 1000

uiGenericLogSizeMax Länge der CSV-Daten (1 Zeile) inclusiveZeitstempel und New Line-Zeichen in Bytes.Insgesamt sind 21 Bytes reserviert:20 Bytes für den Zeitstempel am Zeilenanfang; 1 Byte für den Zeilenumbruch am Zeilenende;

UINT 1024

DE

276

9.6 Bibliothek ifmRawCAN.libraryDie Bibliothek enthält POUs und Datenstrukturen für die Programmierung der CAN-Layer-2-Ebene derCAN-Schnittstellen des Geräts unter CODESYS.

9.6.1 CAN_Enable



Bibliothek: ifmRawCAN.library

Symbol in CODESYS:

BeschreibungDer FB aktiviert die CAN-Layer2-Funktionen einer CAN-Schnittstelle mit einer bestimmtenÜbertragungsrate. Gleichzeitig schreibt der FB Informationen über den aktuellen Zustand der CAN-Schnittstelle in die globale Variable CAN-State.

Änderungen der Übertragungsrate oder der CAN-Schnittstelle werden sofort übernommen. Dabeiwerden alle existierenden Empfangs- und Sende-Pufferspeicher gelöscht.

Der FB hat keinen Einfluss auf einen CANopen Manager/ein CANopen Device an der gewähltenCAN-Schnittstelle. Der FB kann in diese Fall die Übertragungsrate der CAN-Schnittstelle nichtändern.



TRUE FB aktivieren

eChannel CAN_CHANNEL Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)

eBaudrate CAN_BAUDRATE Baudrate des CAN-Kanals Ò CAN_BAUDRATE (ENUM)






nen beachten


Diagnose-Codes:

277



• ERR_BUS_OFF Fehler: CAN-Schnittstelle ist im Zustand "BUS OFF"



• ERR_BAUDRATE_INVALID_OR_ALREADY_SET

Fehler: Gewünschte Baudrate kann nicht eingestellt werden, da sie ungültig istoder schon eine andere Baudrate definiert wurde.


DE

278

9.6.2 CAN_Recover




Symbol in CODESYS:

BeschreibungDer FB steuert die Verarbeitung eines Ausfalls des CAN-Kanals.

Ein Aufruf des FBs löst folgende Aktionen aus:

• Bei einem Ausfall des CAN-Kanals wird die CAN-Schnittstelle zurückgesetzt und neu gestartet.

• Alle Pufferspeicher werden geleert.

Wenn der CAN-Kanal immer noch ausfällt, nachdem die maximale Anzahl anWiederherstellungsversuchen überschritten ist, bleibt der CAN-Bus im Fehlerzustand.

u FB erneut aufrufen, um die Wiederherstellungsfunktion noch einmal auszuführen.






usiNumberRetry USINT max. Anzahl anWiederholungsversuchen

z.B. 4

tInhibitTime TIME Verzögerung, bis nach der Erkennungeines CAN-Bus-Ausfalls die CAN-Schnittstelle wieder gestartet wird

z.B #2ms


xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist • FALSE: FB wird ausgeführt• TRUE:

FB erfolgreich ausgeführtFB kann erneut aufgerufenwerden

279



• FALSE: kein Fehler aufgetretenoder der FB wird nochausgeführt

• TRUE: Fehler aufgetretenAktion konnte nicht ausgeführtwerdenDiagnoseinformationen beachten


usiRetryCount USINT Zähler für bereits absolvierteWiederholungsversuche seit der letzten Aktivierungdes FB

Ò

Diagnose-Codes:



• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.




DE

280

9.6.3 CAN_RemoteRequestBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB sendet die Anforderung für eine CAN-Remote-Nachricht in ein CAN-Netzwerk. Die Daten derAntwortnachricht gibt der FB in ein Array aus. Der FB unterstützt Standard- und Extended-Frames.

Eingangsparameter





Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)

udiID UDINT Identifier der CAN-Nachricht • für Standard Frame (11 BitIdentifier):0 ... 2047

• für Extended Frame (29 BitIdentifier):0 ... 536.870.911

xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)

FALSE StandardFrame*

TRUE ExtendedFrame

usiSetDLC UINT Anzahl der Daten-Bytes in der CAN-Nachricht (DLC = Data Length Count)

0...8

0 Bytes*...8 Bytes


Ausgangsparameter





281






nen beachten


aData ARRAY[0...7] OF USINT

Array für die Speicherung der empfangenen Daten

usiDLC UINT Anzahl der Daten-Bytes in der CAN-Nachricht (DLC= Data Length Count)

0...8

0 Bytes*...8 Bytes

Diagnose-Daten:




• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreibenund wird nicht übertragen





DE

282

9.6.4 CAN_RemoteResponseBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB antwortet als Reaktion auf eine Anforderung einer CAN-Remote-Nachricht und sendet dieangeforderten Daten in ein CAN-Netzwerk.

So lange der FB aktiviert ist, antwortet er auf jede an ihn gerichtete RemoteRequest-Nachricht(Automatisches Antworten).

Mehrere FB-Aufrufe während eines SPS-Zyklus sind möglich.

Eingangsparameter



TRUE FB aktivieren



udiID UDINT Identifier der CAN-Nachricht • für Standard Frame (11 Bit Identifier):0 ... 2047

• für Extended Frame (29 Bit Identifier):0 ... 536.870.911


FALSE Standard Frame*

TRUE Extended Frame

usiDLC UINT Anzahl der Daten-Bytes in der CAN-Nachricht (DLC = Data Length Count)

0...8

0 Bytes*...8 Bytes


Ausgangsparameter






n beachten


283


uiRTR_Cnt UINT Anzahl der empfangenen Remote-Anforderungennach dem letzten Aufruf des FB

Diagnose-Code:








DE

284

9.6.5 CAN_RxBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB dient dem Empfang von CAN-Nachrichten mit einem definierten Identifier.

Der FB empfängt zwischen 2 FB-Aufrufen alle CAN-Nachrichten mit dem angegebenen Identifier undspeichert sie in einem FIFO-Pufferspeicher. Die Anzahl der empfangenen CAN-Nachrichten wirdangezeigt. Am Ausgang wird immer die zuerst empfangene CAN-Nachricht ausgegeben.

Falls mehrere CAN-Nachrichten im FIFO-Pufferspeicher sind, kann der FB solange aufgerufenwerden, bis der Ausgang uiAvailable =0 ist und alle CAN-Nachrichten aus dem FIFO-Pufferspeicher ausgelesen sind.



TRUE FB aktivieren





TRUE ExtendedFrame



Ausgangsparameter






n beachten


285


aData ARRAY[0...7] OFUSINT


usiDLC UINT Anzahl der Daten-Bytes in der CAN-Nachricht (DLC =Data Length Count)

0...8

0 Bytes*...8 Bytes

uiAvailable

UINT • Anzahl der empfangenen CAN-Nachrichten seitdem letzten FB-Aufruf

• aktuelle CAN-Nachricht wird mitgezählt

0 keine CAN-Nachrichtempfangen zwischen 2FB-Aufrufen

n n CAN-Nachrichtenempfangen

Fehler-Codes:




• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreibenund wird nicht übertragen




DE

286

9.6.6 CAN_RxMaskBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB empfängt CAN-Nachrichten eines nicht zusammenhängenden Bereichs. Der Bereich wirddefiniert über ein Bitmuster und eine Bitmaske.

Für die Bitmaske gelten folgende Regeln:

0: Das äquivalente Bit des CAN-Identifiers kann 0 oder 1 sein

1: Das äquivalente Bit des CAN-Identifiers muss den gleichen Wert haben wie das Bit im Bitmuster

Beispiel:Muster: 000 0010 0000 Maske: 000 1111 1111

Ergebnis: xxx 0010 0000

Alle CAN-Nachrichten mit einem Identifier, dessen niederwertigste 8 Bit den Wert "0010 0000"besitzen, werden empfangen.

z.B. 110 0010 0000 000 0010 0000, 001 0010 0000

Generelles Verhalten des FB: (Ò CAN_Rx / 284)



TRUE FB aktivieren




TRUE Extended Frame

udiIDSet UDINT Voreingestellter Bitmuster für dieMaskierung des Identifiers der CAN-Nachricht

z.B. 000 0010 0000

udiIDMask UDINT Bitmuster des gewünschten Bereichs1 ... Bit ist relevant für Auswahl0 ... Bit nicht relevant für Auswahl

z.B. 000 1111 1111


287


xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehler aufgetretenist

FALSE kein Fehleraufgetreten oderder FB wirdnoch ausgeführt


• Aktion konntenichtausgeführtwerden





usiDLC UINT Anzahl der Daten-Bytes in der CAN-Nachricht (DLC =Data Length Count)

0...8

0 Bytes*...8 Bytes

uiAvailable

UINT • Anzahl der empfangenen CAN-Nachrichten seit demletzten FB-Aufruf


0 keine CAN-Nachrichtempfangenzwischen 2 FB-Aufrufen

n n CAN-Nachrichtenempfangen



Diagnose-Codes:


• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegengültige Ergebnisse an.

• ERR_INACTIVE_INTERFACE

Fehler: Gewählter CAN-Kanal ist deaktiviert.

• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben undwird nicht übertragen




DE

288

9.6.7 CAN_RxRangeBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB empfängt CAN-Nachrichten eines zusammenhängenden Bereichs. Der Bereich wird definiertdurch eine Ober- und eine Untergrenze.

Für die Definition dieses Bereichs gelten folgende Regeln:

Unter- und Obergrenze:Standard Frames: 0 ... 2047 (11-Bit Identifier)Extended Frames: 0 ... 536 870 911 (29-Bit Identifier)

Der Wert für die Untergrenze muss <= dem Wert der Obergrenze sein.

Beispiel:Untergrenze: 000 0000 0010

Obergrenze: 000 0000 1000

Ergebnis: Alle CAN-Nachrichten mit eine Identifier, dessen niederwertigste 4 Bit einen Wert zwischen"0010" und "1000" besitzen, werden empfangen.



xEnable BOOL Aktivität des FB steuern FALSE FBdeaktivieren

TRUE FB aktivieren





TRUE ExtendedFrame

udiIDStart UDINT Anfang des gewünschten Bereichs z.B. 000 0000 0010

udiIDStop UDINT Ende des gewünschten Bereichs z.B. 000 0000 1000





289




werden• Diagnoseinformationen

beachten



Array für die Speicherung der empfangenenDaten


0...8

0 Bytes*...8 Bytes

uiAvailable

UINT • Anzahl der empfangenen CAN-Nachrichten seit dem letzten FB-Aufruf


0 keine CAN-Nachricht empfangenzwischen 2 FB-Aufrufen

n n CAN-Nachrichten empfangen



Diagnose-Codes:








DE

290

9.6.8 CAN_RxRangeExtBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB empfängt CAN-Nachrichten eines zusammenhängenden Bereichs mit Extended Identifier (29Bit). Der Bereich wird definiert durch eine Ober- und eine Untergrenze.

Für die Definition dieses Bereichs gelten folgende Regeln:

Unter- und Obergrenze: 0 ... 536 870 911

Der Wert für die Untergrenze muss <= dem Wert der Obergrenze sein.

Beispiel:Untergrenze: 0 0000 0000 0000 0000 0000 0000 0010

Obergrenze: 0 0000 0000 0000 0000 0000 0000 1000

Ergebnis: Alle CAN-Nachrichten mit eine Identifier, dessen niederwertigste 4 Bit einen Wert zwischen"0010" und "1000" besitzen, werden empfangen.


FB für Standard Identifier (11 Bit): (Ò CAN_RxRange / 288)

Der FB besitzt folgendes Verhalten nach Umstellung der Empfangs-ID während der Laufzeit derApplikation:

Der FB-Speicher wird nicht vollständig zurückgesetzt. Die Ausgänge aData und usiDLC behaltendie letzten Werte. Der Zähler uiAvailable wird auf 0 gesetzt.

u Den FB nur mit statischen (im Betrieb unveränderten) ID-Konfigurationen an den Eingängenverwenden.

u Den Wert von uiAvailable <> 0 prüfen, bevor die Daten verwendet werden.


xEnable BOOL Aktivität des FB steuern • FALSE: FB deaktivieren• TRUE: FB aktivieren


udiIDStart UDINT Anfang des gewünschten Bereichs z.B. 0 0000 0000 0000 00000000 0000 0010

udiIDStop UDINT Ende des gewünschten Bereichs z.B. 0 0000 0000 0000 00000000 0000 1000

291





werden• Diagnoseinformationen

beachten



Array für die Speicherung der empfangenenDaten


0...8

0 Bytes*...8 Bytes

uiAvailable

UINT • Anzahl der empfangenen CAN-Nachrichten seit dem letzten FB-Aufruf


0 keine CAN-Nachricht empfangenzwischen 2 FB-Aufrufen

n n CAN-Nachrichten empfangen

udiID UDINT Identifier der CAN-Nachricht • für Extended Frame (29 Bit Identifier):0 ... 536.870.911

Diagnose-Codes:








DE

292

9.6.9 CAN_StatusBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB liest den aktuellen Status des CAN-Netzwerks und gibt folgende Status- undDiagnoseInformationen aus:

• Baudrate

• Zustand des CAN-Busses (Zustandsdiagramm)

• Zähler Rx-Fehler

• Zähler Tx-Fehler

• Warnung Rx-Fehler

• Warnung Tx-Fehler

• Zähler empfangene CAN-Nachrichten

• Buslast



TRUE FB aktivieren









293


eBaudrate CAN_BAUDRATE Baudrate des CAN-Kanals Ò CAN_BAUDRATE (ENUM)

eBusState BUS_STATE

aktueller Zustand der CAN-Schnittstelle

Ò BUS_STATE (ENUM)

uiErrorCntRx UINT Fehlerzähler Rx-Nachrichten 0...65535

uiErrorCntTx UINT Fehlerzähler Tx-Nachrichten 0...65535

xWarningRx BOOL Rx-Fehler: Schwelle für Warnmeldungüberschritten (uiErrorCntRx > 96)

FALSE keine Warnung

TRUE Warnung

xWarningTx BOOL Tx-Fehler: Schwelle für Warnmeldungüberschritten (uiErrorCntTx > 96)

FALSE keine Warnung

TRUE Warnung

udiCountRx UDINT Anzahl der erkannten CAN-Nachrichten (unabhängig vonkonfigurierten Rx-Nachrichten)

0...4294967295

usiBusLoad USINT Buslast (in Prozent) 0...100

Diagnose-Codes:



DE

294

9.6.10 CAN_TxBaustein-Typ: Funktionsbaustein (FB)



Symbol in CODESYS:

BeschreibungDer FB dient dem asynchronen Senden von CAN-Nachrichten. Der FB schreibt die konfigurierte CAN-Nachricht in den Pufferspeicher des gewählten CAN-Kanals. Zu welchem Zeitpunkt die CAN-Nachrichtübertragen wird, hängt vom Zustand des CAN-Kanals und des Pufferspeichers ab. Der FB und derSPS-Zyklus haben darauf keinen Einfluss.

Der FB kann mehrmals während eines SPS-Zyklus aufgerufen werden.

Der wiederholte Aufruf des FB während eines SPS-Zyklus löst eine wiederholte Übertragung derCAN-Nachricht innerhalb eines SPS-Zyklus aus.



TRUE FB aktivieren







TRUE Extended Frame


0...8

0 Bytes*...8 Bytes

aData ARRAY[0...7] OF USINT

Array mit den zu sendenden Daten


Ausgangsparameter




295





nen beachten


Diagnose-Codes:








DE

296

9.6.11 BUS_STATE (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert

BUS_STATE Zustand der CAN-Schnittstelle

UNDEFINED Zustand nicht verfügbar oder nichtkonfiguriert

INT 0

ERROR_ACTIVE Fehlerzähler Tx und Rx <= 96 INT 1

ERROR_PASSIVE Fehlerzähler Tx oder Rx > 127 undFehlerzähler Tx oder Rx < 255

INT 2

ERROR_WARNING Fehlerzähler Rx oder Tx > 96 undFehlerzähler Rx oder Tx <= 127

INT 3

BUS_OFF Fehlerzähler Tx = 255 INT 65535

9.6.12 CAN_Info (GVL)Name Beschreibung Datentyp Mögliche Werte

CAN_State Zustand der CAN-Kanäle ARRAY[0...3] OFCAN_BUS_STATE

pro Array-Feld: → CAN_BUS_STATE(STRUCT)

Logger_Enabled zeigt, ob Log des CAN-Kanals aktiviert ist

ARRAY[0...3] OF BOOL pro Array-Feld:

FALSE deaktiviert

TRUE aktiviert

9.6.13 CAN_BUS_STATE (STRUCT)Name Datentyp Beschreibung Mögliche Werte

uiBaudrate UINT Baudrate der CAN-Schnittstelle Ò CAN_BAUDRATE (ENUM)

eBusState BUS_STATE aktueller Zustand der CAN-Schnittstelle Ò BUS_STATE (ENUM)

uiErrorCntRx UINT Fehlerzähler Rx-Nachrichten 0...65535

uiErrorCntTx UINT Fehlerzähler Tx-Nachrichten 0...65535

xWarningRx BOOL Rx-Fehler: Schwelle für Warnmeldungüberschritten (uiErrorCntRx > 96)

FALSE keine Warnung

TRUE Warnung

xWarningTx BOOL Tx-Fehler: Schwelle für Warnmeldungüberschritten (uiErrorCntTx > 96)

FALSE keine Warnung

TRUE Warnung

udErrorCntTx UDINT Anzahl der erkannten CAN-Nachrichten(unabhängig von konfigurierten Rx-Nachrichten)

0...4294967295

297

10 Anhang

10.1 Adressvergabe in Ethernet-Netzwerken

Im Ethernet-Netzwerk MUSS jede IP-Adresse einmalig sein.

Folgende IP-Adressen sind für netzinterne Zwecke reserviert und deshalb als Teilnehmer-Adresse nicht zulässig: nnn.nnn.nnn.0 | nnn.nnn.nnn.255.

Nur Netzwerkteilnehmer, deren Subnetzmaske identisch ist und deren IP-Adressen im Rahmender Subnetzmaske identisch sind, können miteinander kommunizieren.

Regel: Bei Teil-Subnetzmaske = 255 müssen die Teil-IP-Adressen identisch sein.Bei Teil-Subnetzmaske = 0 müssen sich die Teil-IP-Adressen unterscheiden

Wenn Subnetzmaske = 255.255.255.0, dann sind 254 miteinander kommunizierende Teilnehmerim Netz möglich.Wenn Subnetzmaske = 255.255.0.0, dann sind 256x254 = 65 024 miteinander kommunizierendeTeilnehmer im Netz möglich.

Im selben physikalischen Netzwerk sind unterschiedliche Subnetzmasken der Teilnehmerzulässig. Sie bilden unterschiedliche Teilnehmergruppen, die nicht mit Teilnehmergruppen mitanderen Subnetzmasken kommunizieren können.

u Im Zweifelsfall oder bei Problemen fragen Sie bitte Ihren System-Administrator.

Beispiele:

Teilnehmer AIP-Adresse

Teilnehmer ASubnetzmaske

Teilnehmer BIP-Adresse

Teilnehmer BSubnetzmaske

Kommunikation der Teilnehmermöglich?

192.168.82.247 255.255.255.0 192.168.82.10 255.255.255.0 ja, 254 Teilnehmer möglich

192.168.82.247 255.255.255.0 192.168.82.247 255.255.255.0 nein (gleiche IP-Adresse)

192.168.82.247 255.255.255.0 192.168.82.10 255.255.0.0 nein (unterschiedliche Subnetzmaske)

192.168.82.247 255.255.255.0 192.168.116.10 255.255.255.0 nein (unterschiedlicher IP-Adressbereich:82 vs. 116)

192.168.222.213 255.255.0.0 192.168.222.123 255.255.0.0 ja, 65 024 Teilnehmer möglich

192.168.111.213 255.255.0.0 192.168.222.123 255.255.0.0 ja, 65 024 Teilnehmer möglich

192.168.82.247 255.255.255.0 192.168.82.0 255.255.255.0 nein; gesamtes Netz gestört, weil IP-Adresse xxx.xxx.xxx.0 nicht zulässig

DE

Documents

Programmierhandbuch CODESYS-Version: 3.5 SP16 Patch 0