Post on 18-Dec-2021
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
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
Dokument Inhalt / Beschreibung
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:
Dokument Inhalt / Beschreibung
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
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.
w Gerät startet neu.
u Tasten solange gedrückt halten, bis ifm-Logo erscheint / Status-LED orange blinkt.
w Gerät ist im Recovery-Modus.
DE
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 Gerät startet neu.
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 Gerät startet neu.
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.
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.
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)
ACHTUNGBei Betrieb des Gerätes in einer ungeschützten 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:
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).
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.
w Gerät startet neu.
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.
w Gerät startet neu.
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
Bezeichnung Bedeutung Mögliche Werte
[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:
Bezeichnung Bedeutung
[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.
u Eines der folgenden Untermenüs wählen:
Bezeichnung Bedeutung
[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:
Bezeichnung Bedeutung Mögliche Werte
[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 [▲] / [▼] den gewünschten Wert einstellen.
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]
w Menüseite zeigt folgende Informationen:
Bezeichnung Bedeutung Mögliche Werte
[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 Mit [▲] / [▼] den gewünschten Wert einstellen.
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]
w Menüseite zeigt folgende Informationen:
Bezeichnung Bedeutung
[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]
w Menüseite zeigt folgende Informationen:
Bezeichnung Bedeutung Mögliche Werte
[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]
w Menüseite zeigt folgende Informationen:
DE
34
Bezeichnung Bedeutung
[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:
Bezeichnung Bedeutung
[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.
u Eines der folgenden Untermenüs wählen:
Bezeichnung Bedeutung
[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.
w Menüseite zeigt folgende Informationen:
Bezeichnung Bedeutung Mögliche Werte
[Bus Number] CAN-Busschnittstelle eingeben. 1 ... 4
35
Bezeichnung Bedeutung Mögliche Werte
[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]
w Menüseite [CAN Test] erscheint.
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]
w Menüseite [CAN Test] erscheint.
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.
w Menüseite zeigt folgende Informationen:
Bezeichnung Bedeutung Mögliche Werte
[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]
w Menüseite zeigt folgende Informationen:
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.
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
w Kontextmenü erscheint.
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.
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 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
w Kontextmenü erscheint.
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.
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 CANopen Device zum Gerätebaum hinzu.
u Im Gerätebaum: Doppelklick auf hinzugefügtes CANopen Device
w Editor-Fenster zeigt Konfigurationsoptionen.
u CANopen Device wie gewünscht konfigurieren.
u Projekt speichern, um die Änderungen zu übernehmen.
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.
w Kontextmenü erscheint.
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.
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 J1939-Manager zum Gerätebaum hinzu.
u Im Gerätebaum: Doppelklick auf hinzugefügten J1939-Manager
w Editor-Fenster zeigt Konfigurationsoptionen.
u J1939-Manager wie gewünscht konfigurieren.
u Projekt speichern, um die Änderungen zu übernehmen.
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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)
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.
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.
u Projekt speichern, um die Änderungen zu übernehmen.
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.
u Projekt speichern, um die Änderungen zu übernehmen.
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 Projekt speichern, um die Änderungen zu übernehmen.
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 Projekt speichern, um die Änderungen zu übernehmen.
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.
u Projekt speichern, um die Änderungen zu übernehmen.
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.
u Projekt speichern, um die Änderungen zu übernehmen.
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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
ACHTUNGBei Betrieb des Gerätes in einer ungeschützten 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.
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).
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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:
Name Beschreibung Referenz
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.
w Fenster [Gerät anhängen] erscheint.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u Im Bereich [Gerät]: Hersteller: <Alle Hersteller> wählen.
u In der Liste darunter: [Feldbusse] > [SAE J1939] > [J1939 Manager] > [J1939_Manager] 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.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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u Im Bereich [Gerät]: Hersteller: <Alle Hersteller> wählen.
u In der Liste darunter: [Feldbusse] > [J1939] > [J1939_ECU] > wählen.
u Wahl mit [Gerät anhängen] bestätigen.
69
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
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
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u In der Liste [Hersteller] <Alle Hersteller> wählen.
u In der Liste darunter [Feldbusse] > [EtherNet/IP] > [EtherNet/IP Local Adapter] > [EtherNet/IPAdapter] wählen.
DE
70
u Wahl mit [Gerät anhängen] bestätigen
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u In der Liste [Hersteller] <Alle Hersteller> wählen.
u In der Liste darunter [Feldbusse] > [EtherNet/IP] > [EtherNet/IP Module] > [EtherNet/IP Module]wählen.
u Wahl mit [Gerät anhängen] bestätigen
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u In der Liste [Hersteller] <Alle Hersteller> wählen.
u In der Liste darunter [Feldbusse] > [Ethernet Adapter] > [Ethernet Adapter] > [Ethernet] wählen.
u Wahl mit [Gerät anhängen] bestätigen
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u In der Liste [Hersteller] <Alle Hersteller> wählen.
u In der Liste darunter [Feldbusse] > [Modbus] > [Modbus TCP Master] > [Modbus TCP Master]wählen.
u Wahl mit [Gerät anhängen] bestätigen
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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 [Gerät anhängen...] wählen.
w Fenster [Gerät anhängen] erscheint.
u In der Liste [Hersteller] <Alle Hersteller> wählen.
u In der Liste darunter [Feldbusse] > [Modbus] > [Modbus TCP Slave Device] > [Modbus TCP SlaveDevice] wählen.
u Wahl mit [Gerät anhängen] bestätigen
u Fenster [Gerät anhängen] mit Schaltfläche [Schließen] schließen.
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
u Projekt speichern, um die Änderungen zu übernehmen.
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.
u Projekt speichern, um die Änderungen zu übernehmen.
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 [Online] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
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 [Online] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
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 [Online] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
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] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
u [Online] > [Reset warm] wählen, um die Anwendung rückzusetzen.
w Anwendung wechselt in den STOP-Zustand.
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] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
u [Online] > [Reset kalt] wählen, um die Anwendung rückzusetzen.
w Anwendung wechselt in den STOP-Zustand.
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] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
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 [Online] > [Einloggen] wählen.
w CODESYS wechselt in den Online-Betrieb.
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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmCANopenManager.library
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.
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
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
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
83
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen → Liste unten (Diagnose-Codes)
udiLen UDINT Anzahl der empfangenen Bytes
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.
• ERR_INVALID_CHANNEL Fehler: Gewählter Kommunikationskanal unbekannt / nicht konfiguriert
• 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_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_DEVICE_NOT_AVAILABLE Fehler: Gewähltes Gerät unbekannt / nicht konfiguriert
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmCANopenManager.library
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.
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
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
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
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
Parameter Datentyp Bedeutung Mögliche Werte
eDiagInfo DIAG_INFO Diagnoseinformationen → Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.
• ERR_INVALID_CHANNEL Fehler: Gewählter Kommunikationskanal unbekannt / nicht konfiguriert
• 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_TIMEOUT Fehler: Die zulässige maximale Ausführungszeit wurde überschritten. Die Aktionwurde nicht abgeschlossen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_DEVICE_NOT_AVAILABLE Fehler: Gewähltes Gerät unbekannt / nicht konfiguriert
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmCANopenManager.library
Symbol inCODESYS:
BeschreibungDer FB sendet einen Befehl zur Steuerung eines CANopen-Knotens.
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
usiNMTservice NMT_SERVICE
Befehl zur Steuerung des CANopen-Knotens
(Ò NMT_SERVICE (ENUM) / 88)
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreich ausgeführt• FB kann erneut aufgerufen
werden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetreten oder derFB wird noch ausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformationen
beachten
eDiagInfo DIAG_INFO Diagnoseinformationen → Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_CHANNEL Fehler: Gewählter Kommunikationskanal unbekannt / nicht konfiguriert
87
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
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
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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 des Audio Recorders FALSE Aufnahme fortsetzen
TRUE Aufnahme pausiert
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendetist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
stSettings stAUDIO_SETTINGS Lautstärke-Einstellungen der Audio-Kanäle desGeräts.
Ò stAUDIO_SETTINGS (STRUCT)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• 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)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
stSettings stAUDIO_SETTINGS Lautstärke-Einstellungen der Audio-Kanäle desGeräts.
Ò stAUDIO_SETTINGS (STRUCT)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sindnoch nicht verfügbar. Einige Ausgangswerte werden in jedemSPS-Zyklus aktualisiert.
95
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
xHide BOOL Startbild (Splashscreen) einblenden /ausblenden.
FALSE Startbild(Splashscreen)ausblenden undVisualisierunganzeigen.
TRUE Startbild(Splashscreen)anzeigen undVisualisierungausblenden.
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
97
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
stSettings stAUDIO_SETTINGS
Lautstärke-Einstellungen der Audio-Kanäle desGeräts.
Ò stAUDIO_SETTINGS (STRUCT)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_HIDE_SPLASH_SCREEN Fehler: Fehler beim Anzeigen/Ausblenden des Startbildes.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
98
LoadSplashScreenBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
u Nur eine Instanz des FB innerhalb der Anwendung aufrufen!
Jeder Aufruf des FB führt eine Schreiboperation auf den Flash-Speicher des Geräts aus.
u Funktionsbaustein im Programmcode nicht zyklisch aufrufen!
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sPathToSplash STRING absoluter Verzeichnispfad zur Bilddatei z.B. '/home/cds-apps/PlcLogic/visu/splashscreen.bmp'
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
99
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
100
SetSupplySwitchModeBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
xAutoShutdown BOOL Automatische Abschaltungeinschalten / ausschalten
FALSE AutomatischeAbschaltungdeaktiviert
TRUE. AutomatischeAbschaltung aktiviert
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
101
Parameter Datentyp Beschreibung Mögliche Werte
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_SET_SUPPLY_SWITCH_MODE
Fehler: Fehler beim Aktivieren / Deaktivieren der automatischen Abschaltung.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
102
ShutdownDeviceBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
103
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_SHUTDOWN_DEVICE Fehler: Fehler beim Abschalten.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
104
BootIntoRecoveryBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
105
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
106
GetDeviceOrientationBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt die im Gerät konfigurierte Ausrichtung (Rotation) des Bildschirminhalts 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
eRotation eOBJECT_ROTATION
Konfigurierte Geräteausrichtung(Rotation).
Ò eOBJECT_ROTATION (ENUM)
Diagnose-Codes:
107
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
108
SetDeviceOrientationBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
eRotation eOBJECT_ROTATION Konfigurierte Geräteausrichtung (Rotation). Ò eOBJECT_ROTATION (ENUM)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
109
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
110
9.4.3 Ethernet
GetEthernetInterfacesBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt eine Liste mit allen verfügbaren Ethernet-Schnittstellen des Geräts aus.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_ETH_ITF_LIST Fehler: Probleme beim Lesen der verfügbaren Ethernet-Schnittstellen
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
112
GetIPsettingsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführungerfolgreich beendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
stIPv4Setting stIPv4Setting IPv4-Einstellungen des Geräts (Ò stIPV4SETTING (STRUCT) / 214)
113
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 den Ausgängeliegen gültige Ergebnisse an.
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
114
SetIPsettingsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
Jeder Aufruf des FB führt eine Schreiboperation auf den Flash-Speicher des Geräts aus.
u Funktionsbaustein im Programmcode nicht zyklisch aufrufen!
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
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)
stIPv4Setting stIPv4Setting IPv4-Einstellungen des Geräts (Ò stIPV4SETTING (STRUCT) / 214)
115
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführungerfolgreich beendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatione
n beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
116
GetEthernetBridgeConfigBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt die im Gerät konfigurierte Ethernet Bridge Mode-Konfiguration 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!
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern • FALSE => TRUE: FB wird einmalausgeführt
• Sonst: keine Auswirkungen auf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
stSettings stETHERNET_BRIDGE_CONFIG
Ethernet Bridge Mode-Konfiguration Ò stETHERNET_BRIDGE_CONFIG(STRUCT)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
117
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
118
SetEthernetBridgeConfigBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern • FALSE => TRUE: FB wird einmalausgeführt
• Sonst: keine Auswirkungen auf FB-Abarbeitung
stSettings stETHERNET_BRIDGE_CONFIG
Ethernet Bridge Mode-Konfiguration (Ò stETHERNET_BRIDGE_CONFIG(STRUCT) / 214)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
119
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
120
9.4.4 Keypads
ControlAllKeyLEDsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB schaltet entsprechend der gewählten Einstellungen alle Tasten-LEDs des Geräts ein / aus undstellt die LED-Farbe ein.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
121
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
122
GetKeyMappingBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest die aktuellen Mapping-Einstellungen des integrierten Tastenfeldes 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
uiNoOfKeys UINT Anzahl der Tasten auf dem integriertenTastenfeld
stKeyMapList stKEY_MAP_LIST Struktur mit Mapping-Informationender Tasten.
Ò stKEY_MAP_LIST (STRUCT)
Diagnose-Codes:
123
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_KEY_CONFIG Fehler beim Lesen der Tastenkonfiguration
• ERR_GET_KEY_MAP Fehler beim Lesen des Tasten-Mappings
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
124
ResetAllKeyLEDBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB setzt alle Tasten-LEDs auf den Standardwert "AUS" zurück.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_RESET_KEY_LED Fehler: Fehler beim Zurücksetzen der Tasten-LEDs.ifm-Service-Center kontaktieren!
125
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
126
ResetKeyMappingBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
u Nur eine Instanz des FB innerhalb der Anwendung aufrufen!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
127
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_RESET_KEY_MAP • Fehler beim Zurücksetzen des Tasten-Mappingsifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
128
SetKeyAutoRepeatBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB stellt die Auto-Repeat-Konfiguration (Impuls-Wiederholung) für die Tasten des integriertenTastenfeldes ein.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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].
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehleraufgetreten oderder FB wird nochausgeführt
TRUE • Fehleraufgetreten
• Aktion konntenicht ausgeführtwerden
• Diagnoseinformationenbeachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
129
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_SET_KEY_AUTO_REPEAT • Fehler beim Setzen der Auto-Repeat-Konfigurationifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
130
SetKeyLEDBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB stellt die Farbe und den Nachtmodus der angegeben Tasten-LED ein.
Eingangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
xPrepared BOOL Zustand der FB-Ausgänge FALSE FB-Ausgänge ungültig;FB wird nochabgearbeitet
131
Parameter Datentyp Beschreibung Mögliche Werte
xPrepared BOOL Zustand der FB-Ausgänge TRUE FB-Ausgänge gültig;FB wurde abgearbeitet
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 den Ausgängeliegen gültige Ergebnisse an.
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
132
SetKeyMappingBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB weist den Tasten des integrierten Tastenfeldes Standard-Tastatur-Funktionen zu (Key-Mapping).
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
stKeyMapList stKEY_MAP_LIST
Struktur mit Mapping-Informationen der Tasten. → stKEY_MAP_LIST (STRUCT)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
133
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_SET_KEY_MAP Fehler beim Einstellen des Tasten-Mappings
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
134
9.4.5 LCD
LCDcontrolBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB schaltet das LCD-Display und die Hintergrundbeleuchtung ein oder 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
xEnableLCD BOOL LCD einschalten / ausschalten(Energiesparmodus).
FALSE LCD einschalten.
TRUE LCD ausschalten.
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
135
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren! DE
136
GetBootupBacklightBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest die eingestellten LCD-Helligkeitseinstellungen für den Bootvorgang 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
usiBrightness USINT Eingestellter Helligkeitswert für denGeräte-Bootvorgang
0...100 %
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
137
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_BOOTUP_LCD_BRIGHTNESS
Fehler beim Lesen des Helligkeitswertesifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren! DE
138
GetLCD_BacklightBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest die eingestellten LCD-Helligkeitseinstellungen für den Normalbetrieb des Displays 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
usiBrightness USINT Eingestellter Helligkeitswert für denNormalbetrieb des Geräts
0...100 %
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 den Ausgängeliegen gültige Ergebnisse an.
139
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_LCD_BRIGHTNESS Fehler beim Lesen des Helligkeitswertesifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
140
SetBootupBacklightBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB stellt den Wert für die LCD-Helligkeit für den Bootvorgang ein.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
usiBrightness USINT Helligkeitswert für den Geräte-Bootvorgang
0...100 %Standardwert: 80 %
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
142
SetLCD_BacklightBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB stellt den Wert für die LCD-Helligkeit für den Normalbetrieb ein.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
usiBrightness USINT Helligkeitswert für den Normalbetriebdes Geräts
0...100 [%]Standardwert: 80 [%]Hintergrundbeleuchtung aus = 0 [%]
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
144
9.4.6 Local IO
GetLightSensorBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt den Lichtstärkewert des integrierten Lichtsensors zurück.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
uiAmbientLight UINT Wert der Lichtstärke, ermittelt durchden integrierten Lichtsensor
0...4096 = 0...100%
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
145
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
146
GetLightSensorCyclicBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt den Lichtstärkewert des integrierten Lichtsensors in einem zyklischen Intervall von 150 mszurück.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
uiAmbientLight UINT Wert der Lichtstärke, ermittelt durchden integrierten Lichtsensor
0...4096 = 0...100%
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes.ifm-Service-Center kontaktieren!
147
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
148
GetLocalInputsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest den Zustand der lokalen Digitaleingänge des Geräts.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
xChannel0 BOOL Zustand des Digitaleingangs "Channel0"
FALSE AUS
TRUE EIN
xChannel1 BOOL Zustand des Digitaleingangs "Channel1"
FALSE AUS
TRUE EIN
149
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
150
GetLocalInputsCyclicBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest den Zustand der lokalen Digitaleingänge des Geräts in einem zyklischen Intervall von 50ms..
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
xChannel0 BOOL Zustand des Digitaleingangs "Channel 0" FALSE AUS
TRUE EIN
xChannel1 BOOL Zustand des Digitaleingangs "Channel 1" FALSE AUS
TRUE EIN
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
151
• ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
152
GetTemperatureBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest folgende Systemtemperaturen aus:
• Temperatur Platine
• Temperatur Prozessor
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
stTemperatures stSYSTEM_TEMPERATURES
Struktur mit den Systemtemperaturen Ò stSYSTEM_TEMPERATURES(STRUCT)
Diagnose-Codes:
153
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
154
GetTemperaturesCyclicBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest zyklisch in einem Intervall von 2000 ms folgende Systemtemperaturen aus:
• Temperatur Platine
• Temperatur Prozessor
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
stTemperatures stSYSTEM_TEMPERATURES
Struktur mit den Systemtemperaturen Ò stSYSTEM_TEMPERATURES(STRUCT)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
156
GetVoltagesBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest folgende Systemspannungen aus:
• VBB0
• VBB15
• VBB30
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
stSystemVoltages
stSYSTEM_VOLTAGES
Struktur mit den Systemspannungen Ò stSYSTEM_VOLTAGES (STRUCT)
157
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_READ_VOLTAGE_VBB0 Fehler beim Lesen der Systemspannung VBB0.ifm-Service-Center kontaktieren!
• ERR_READ_VOLTAGE_VBB15 Fehler beim Lesen der Systemspannung VBB15.ifm-Service-Center kontaktieren!
• ERR_READ_VOLTAGE_VBB30 Fehler beim Lesen der Systemspannung VBB30.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
158
GetVoltagesCyclicBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest folgende Systemspannungen zyklisch im Intervall von 50 ms aus:
• VBB0
• VBB15
• VBB30
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
stSystemVoltages stSYSTEM_VOLTAGES
Struktur mit den Systemspannungen Ò stSYSTEM_VOLTAGES (STRUCT)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
159
• ERR_READ_VOLTAGE_VBB0 Fehler beim Lesen der Systemspannung VBB0.ifm-Service-Center kontaktieren!
• ERR_READ_VOLTAGE_VBB15 Fehler beim Lesen der Systemspannung VBB15.ifm-Service-Center kontaktieren!
• ERR_READ_VOLTAGE_VBB30 Fehler beim Lesen der Systemspannung VBB30.ifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
160
SetLocalOutputsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
stChannel0 STRUCT Befehl für Digitalausgangskanal 0 Ò stOUTPUT_COMMANDS (STRUCT)
stChannel1 STRUCT Befehl für Digitalausgangskanal 1 Ò stOUTPUT_COMMANDS (STRUCT)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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
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
Parameter Datentyp Beschreibung Mögliche Werte
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
162
9.4.7 Status LED
SetStatusLEDstateBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB steuert die Status-LED des Geräts. Die Status-LED kann zweifarbig blinken. Die Blinkfrequenzist einstellbar.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
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
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführungerfolgreich beendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführungein Fehler aufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatione
n beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-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
Parameter Datentyp Bedeutung Mögliche Werte
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
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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
165
Parameter Datentyp Bedeutung Mögliche Werte
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• 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
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
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)
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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
usiNumberUSBdevice USINT Anzahl derverbundenen USB-Speichergeräte
0 kein Gerät verbunden
1 1 Gerät verbunden
167
Parameter Datentyp Beschreibung Mögliche Werte
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• 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
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
DE
168
9.4.9 System Commands
LinuxSysCallAsyncBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sCommand STRING Linux-Befehl inkl. Parameter (max. 255Zeichen)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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
• 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 den Ausgängeliegen gültige Ergebnisse an.
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.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. 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
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sCommand STRING Linux-Befehl inkl. Parameter (max. 255Zeichen)
psCmdStdOut POINTER TO STRING Adresse des Puffers für dieStandardausgabe (stdout) des Linux-Befehls. Mögliche Größe 1...10000Bytes.
171
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• 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
172
LinuxSysCallSync
Baustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.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 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
Parameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sCommand STRING Linux-Befehl inkl. Parameter (max. 255Zeichen)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
173
Parameter Datentyp Beschreibung Mögliche Werte
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
Diagnose-Code:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: Ungültiger Wert an Eingang sCommand. Funktionsaufruf abgebrochen.
• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.
DE
174
LinuxSysCallSync2
Baustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.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. 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
Parameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
175
Parameter Datentyp Beschreibung Mögliche Werte
sCommand STRING Linux-Befehl inkl. Parameter (max. 255Zeichen)
psCmdStdOut POINTER TO STRING Adresse des Puffers für dieStandardausgabe (stdout) des Linux-Befehls. Mögliche Größe 1...10000Bytes.
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: Ungültiger Wert an Eingang sCommand. Funktionsaufruf abgebrochen.
• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.
DE
176
9.4.10 System Information
GetSysInfoBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol inCODESYS:
BeschreibungDer FB liest Systeminformationen aus dem Gerät 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
178
9.4.11 Touch
DisableTouchScreenBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
xDisableTouch BOOL Touchscreen-Funktionalität desDisplays aktivieren/deaktivieren
FALSE Touchscreen-Funktionalitätaktiviert
TRUE Touchscreen-Funktionalitätdeaktiviert
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
179
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
180
SetTouchOptimisationModeBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
Der FB ist nur verfügbar für Geräte mit integriertem Touchscreen.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
eTouchOptiMode
eTOUCH_OPTIMISATION_MODE
OPtimierungsmodus für Touchscreen-Betrieb ÒeTOUCH_OPTIMISATION_MODE(ENUM)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
181
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_INVALID_VALUE Fehler: Ungültiger Optimierungsmodus gewählt
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
182
9.4.12 System Time
GetAvailableTimesZonesBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB gibt die Anzahl und eine Liste der verfügbaren Zeitzonenkonfigurationen des Geräts aus.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_TIMEZONES Fehler: Probleme beim Lesen der Zeitzonen-Infomrationen; Hersteller informieren
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
184
GetSysTimeBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest folgende Parameter der geräteinternen Systemuhr und gibt die Werte aus:
• Datum
• Uhrzeit
• Zeitzone
• NTP-Status
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehleraufgetreten oder derFB wird nochausgeführt
185
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte
nicht ausgeführtwerden
• Diagnoseinformationen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_DATE_TIME Fehler: Fehler beim Lesen von Datum und/oder -Zeit
• ERR_GET_TIMEZONES Fehler: Fehler beim Lesen der Zeitzonen-Informationen
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
186
GetSysTimeCyclicBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
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.
187
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_GET_DATE_TIME Fehler: Fehler beim Lesen von Datum und/oder -Zeit
• ERR_GET_TIMEZONES Fehler: Fehler beim Lesen der Zeitzonen-Informationen
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
188
SetSysTimeBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
stDateTime stDATE_TIME Datum und -Zeit Ò stDATE_TIME (STRUCT)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
189
• ERR_SET_DATE_TIME Fehler: Fehler beim Schreiben von Datum und/oder Zeit
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
190
SetTimeZoneBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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).
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sTimeZone STRING Zeitzonen-Information
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
191
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• ERR_SET_TIMEZONES Fehler: Fehler beim Schreiben der Zeitzonen-Informationen
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren! DE
192
GetNTP_SettingsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB liest die konfigurierten NTP-Servereinstellungen und den NTP-Serverstatus 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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformationen
beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
stSettings ÒstNTP_SETTINGS
NTP-Einstellungen Ò stNTP_SETTINGS
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
193
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
194
SetNTP_SettingsBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
Symbol in CODESYS:
BeschreibungDer FB aktiviert / deaktiviert NTP Services und konfiguriert die Adressen der NTP-Server im System.
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!
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
stSettings ÒstNTP_SETTINGS
NTP-Einstellungen Ò stNTP_SETTINGS
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
195
• ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt
• 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
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
196
9.4.13 Window Control
AnalogueCameraWindowControlBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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
197
Parameter Datentyp Beschreibung Mögliche Werte
stImageSize STRUCT Größe des Kamerabildes (ermittelt) Ò stCAMERA_IMAGE_SIZE(STRUCT)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: Zugriff auf vom Zielgerät nicht unterstützte Tasten-LED
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• 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)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
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
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatione
n beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
xPrepared BOOL Zustand der FB-Ausgänge FALSE FB-Ausgänge ungültig;FB wird nochabgearbeitet
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_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sindnoch nicht verfügbar. Einige Ausgangswerte werden in jedemSPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet.An den Ausgänge liegen gültige Ergebnisse an.
• 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_INVALID_VALUE Fehler: Zugriff auf vom Zielgerät nicht unterstützte Tasten-LED
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• 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)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
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)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehleraufgetreten oder derFB wird nochausgeführt
DE
202
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte
nicht ausgeführtwerden
• Diagnoseinformationen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: Zugriff auf vom Zielgerät nicht unterstützte Tasten-LED
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• 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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmDevice_ecomatDisplay.library
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)
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sFileName STRING (255) Verzeichnispfad, Name und Formatder Bilddatei.
z.B. '/home/cds-apps/screenshot.bmp'
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• 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.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
205
WindowControlBaseBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmDevice_ecomatDisplay.library
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
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
sWindowID STRING Fenster-ID oder Name
stWindowControls
stWINDOW_CONTROLS
Fenster-Konfiguration und Steuerung → stWINDOW_CONTROLS(STRUCT)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
DE
206
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_PREPARING Zustand: FB/FUN wird abgearbeitet; endgültige Ergebnisse sind noch nichtverfügbar. Einige Ausgangswerte werden in jedem SPS-Zyklus aktualisiert.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: Zugriff auf vom Zielgerät nicht unterstützte Tasten-LED
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
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
KBAUD_50 50 Kilobaud INT 50
KBAUD_83 83,3 Kilobaud INT 83
KBAUD_100 100 Kilobaud INT 100
KBAUD_125 125 Kilobaud INT 125
KBAUD_250 250 Kilobaud INT 250
KBAUD_500 500 Kilobaud INT 500
KBAUD_666 666,6 Kilobaud INT 666
KBAUD_800 800 Kilobaud INT 800
KBAUD_1000 1000 Kilobaud INT 1000
CAN_CHANNEL (ENUM)Name Beschreibung Mögliche Werte Datentyp Wert
CAN_CHANNEL Identifier der CAN-Schnittstelle
CHAN_0 CAN-Schnittstelle0
INT 0
CHAN_1 CAN-Schnittstelle1
INT 1
CHAN_2 CAN-Schnittstelle2
INT 2
CHAN_3 CAN-Schnittstelle3
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
CAM_1 VideostreamAnalogkamera 1
INT 1
CAM_2 VideostreamAnalogkamera 2
INT 2
CAM_3 VideostreamAnalogkamera 3
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
KEY0_1 LED Taste 1, Gruppe 0 UDINT 16#2
KEY0_2 LED Taste 2, Gruppe 0 UDINT 16#4
KEY0_3 LED Taste 3, Gruppe 0 UDINT 16#6
KEY0_4 LED Taste 4, Gruppe 0 UDINT 16#8
KEY1_0 LED Taste 0, Gruppe 1 UDINT 16#1
KEY1_1 LED Taste 1, Gruppe 1 UDINT 16#3
KEY1_2 LED Taste 2, Gruppe 1 UDINT 16#5
KEY1_3 LED Taste 3, Gruppe 1 UDINT 16#7
KEY1_4 LED Taste 4, Gruppe 1 UDINT 16#9
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
F2 F2-Taste UDINT 60
F3 F3-Taste UDINT 61
F4 F4-Taste UDINT 62
F5 F5-Taste UDINT 63
F6 F6-Taste UDINT 64
F7 F7-Taste UDINT 65
F8 F8-Taste UDINT 66
F9 F9-Taste UDINT 67
F10 F10-Taste UDINT 68
F11 F11-Taste UDINT 87
F12 F12-Taste UDINT 88
NUM0 0 Nummernblock UDINT 82
NUM1 1 Nummernblock UDINT 79
NUM2 2 Nummernblock UDINT 80
NUM3 3 Nummernblock UDINT 81
NUM4 4 Nummernblock UDINT 75
NUM5 5 Nummernblock UDINT 76
NUM6 6 Nummernblock UDINT 77
NUM7 7 Nummernblock UDINT 71
NUM8 8 Nummernblock UDINT 72
NUM9 9 Nummernblock UDINT 73
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:root@192.168.82.90: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
Parameter Datentyp Bedeutung Mögliche Werte
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)
Parameter Datentyp Bedeutung Mögliche Werte
xStartStop BOOL Kamera starten / stoppen. FALSE => TRUE Kamera starten.Initialwert.
TRUE => FALSE Kamera stoppen.Der eingestellteFensterhintergrundwird angezeigt.
stCAMERA_IMAGE_SIZE (STRUCT)
Parameter Datentyp Bedeutung Mögliche Werte
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)
Parameter Datentyp Bedeutung Mögliche Werte
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)
Bezeichnung Datentyp Bedeutung Mögliche Werte
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)
Bezeichnung Datentyp Bedeutung Mögliche Werte
stKey0_0 Ò stLED_SETTINGS (STRUCT) LED Gruppe 0, Taste 0 Ò stLED_SETTINGS (STRUCT)
stKey0_1 LED Gruppe 0, Taste 1
stKey0_2 LED Gruppe 0, Taste 2
stKey0_3 LED Gruppe 0, Taste 3
215
Bezeichnung Datentyp Bedeutung Mögliche Werte
stKey0_4 Ò stLED_SETTINGS (STRUCT) LED Gruppe 0, Taste 4 Ò stLED_SETTINGS (STRUCT)
stKey1_0 LED Gruppe 1, Taste 0
stKey1_1 LED Gruppe 1, Taste 1
stKey1_2 LED Gruppe 1, Taste 2
stKey1_3 LED Gruppe 1, Taste 3
stKey1_4 LED Gruppe 1, Taste 4
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
eKey0_1 Gruppe 0, Taste 1 eKEY_MAP_CODES.F3
eKey1_1 Gruppe 1, Taste 1 eKEY_MAP_CODES.F4
eKey0_2 Gruppe 0, Taste 2 eKEY_MAP_CODES.F5
eKey1_2 Gruppe 1, Taste 2 eKEY_MAP_CODES.F6
eKey0_3 Gruppe 0, Taste 3 eKEY_MAP_CODES.F7
eKey1_3 Gruppe 1, Taste 3 eKEY_MAP_CODES.F8
eKey0_4 Gruppe 0, Taste 4 eKEY_MAP_CODES.F9
eKey1_4 Gruppe 1, Taste 4 eKEY_MAP_CODES.F10
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 => TRUE Aktion ausführen
FALSE -
xRotateCW BOOL PDF-Ansicht im Uhrzeigersinnrotieren.
FALSE => TRUE Aktion ausführen
FALSE -
DE
218
Bezeichnung Datentyp Bedeutung Mögliche Werte
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 => TRUE Aktion ausführen
FALSE -
xSearchDown BOOL Nach dem nächsten Auftreten desSuchtextes im PDF suchen.
FALSE => TRUE Aktion ausführen
FALSE -
xSearchUp BOOL Nach dem vorherigen Auftreten desSuchtextes im PDF suchen.
FALSE => TRUE Aktion ausführen
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 => TRUE Aktion ausführen
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
FALSE nicht vorhanden
TRUE vorhanden
xAudio_LineInAvailable BOOL Verfügbarkeit des LineIn-Eingangskanals
FALSE nicht vorhanden
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
Zeitzone 1 Bezeichnung RTC-Zeitzone 1 STRING(31) 1
... ... STRING(31) ...
Zeitzone 120 Bezeichnung RTC-Zeitzone 120 STRING(31) 120
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)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
223
Symbol in CODESYS:
BeschreibungDer FB löscht eine Datei vom FLASH-Speicher des Geräts oder vom USB-Speicher.
Eingangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
DE
224
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
225
FileCopyBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
227
Copy_Device_To_USBBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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
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)
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
229
DE
230
Copy_USB_To_DeviceBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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
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)
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
232
233
SyncFileMemoryBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
DE
234
• 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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
235
9.5.2 Parameter File
WriteParmSingleAsyncBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
udiInData UDINT Parameter, der geschrieben werden soll 0...65535
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
DE
236
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
hFileHand RTS_IEC_HANDLE
Dateibeschreibung des Laufzeitsystems < 1 Fehler
sonst. kein Fehler
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
237
ReadParmSingleAsyncBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE =>TRUE
FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
Ausgangsparameter Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
hFileHand RTS_IEC_HANDLE
Dateibeschreibung des Laufzeitsystems < 1 Fehler
DE
238
Parameter Datentyp Bedeutung Mögliche Werte
hFileHand RTS_IEC_HANDLE
Dateibeschreibung des Laufzeitsystems sonst. kein Fehler
udiReadParm
UDINT gelesener Parameter aus der Textdatei 0...4294967295
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
239
9.5.3 Log File
ReadCSV8ByteBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keineAuswirkungenauf FB-Abarbeitung
xTrigger BOOL Aktion auslösen FALSE => TRUE FB liestgewähltenDatensatz
sonst. keine Aktion
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
udiDataSetNb UDINT Nummer des Datensatzes, der aus der Dateigelesen werden soll
0 ... 65535
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
DE
240
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
241
ReadCSVDataBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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.
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
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
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
DE
242
Parameter Datentyp Bedeutung Mögliche Werte
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_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• STAT_RESET Zustand: FB/Funktion führt eine RESET-Operation durch.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
243
WriteCSV8ByteBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB öffnet Datei
DE
244
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließtDatei
• alle Ausgängewerdenzurückgesetzt
xTrigger BOOL Aktion auslösen FALSE => TRUE FB liest gewähltenDatensatz
sonst. keine Aktion
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
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
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
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
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)
xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 0...4294967295
245
Parameter Datentyp Bedeutung Mögliche Werte
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:
• 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 den Ausgängeliegen gültige Ergebnisse an.
• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
DE
246
WriteCSV8ByteHeaderBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDer FB schreibt die Kopfzeile in eine CSV-Datei. Die Kopfzeile wird immer in den Bytes 0 bis 53 derDatei geschrieben.
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keineAuswirkungen aufFB-Abarbeitung
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
stHeader stCSVHeader Struktur mit Header-DatenÒ stCSVHeader (STRUCT)
Timestamp,R1C2,R1C3,...,R1C9*
* ... voreingestellter Wert
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)
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
247
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
LastLogMsg STRING geschriebene Kopfzeile als STRING
udiDataSetPosi
UDINT Nummer des zuletzt geschriebenen Datensatzes 0...65535
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
DE
248
WriteCSVData_LinearBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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
2 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
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB öffnet Datei
249
Parameter Datentyp Bedeutung Mögliche Werte
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
sFileName STRING(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
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
* ... voreingestellter Wert
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)
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wirdausgeführt
TRUE • FB erfolgreichausgeführt
• FB kannerneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehleraufgetreten oderder FB wird nochausgeführt
TRUE • Fehleraufgetreten
• Aktion konntenichtausgeführtwerden
• Diagnoseinformationenbeachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 0...4294967295
DE
250
Parameter Datentyp Bedeutung Mögliche Werte
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• STAT_RESET Zustand: FB/Funktion führt eine RESET-Operation durch.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.
• ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler..
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• ERR_GET_DATE_TIME Fehler: Fehler beim Lesen von Datum und/oder -Zeit
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)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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
1 DD.MM.YYYY hh:mm:ss, Byte 0, Byte 1, Real 0, String 0, Real 1, Byte 2
2 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
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB öffnet Datei
DE
252
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern 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(255) Verzeichnispfad und Name der Datei z.B. '/home/project/data.txt'
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
* ... voreingestellter Wert
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)
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreichbeendet ist
FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformation
en beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 0...4294967295
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
Parameter Datentyp Bedeutung Mögliche Werte
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• STAT_RESET Zustand: FB/Funktion führt eine RESET-Operation durch.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.
• ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler..
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• ERR_GET_DATE_TIME Fehler: Fehler beim Lesen von Datum und/oder -Zeit
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)
Verhaltensmodell: EXECUTE with Trigger
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
sFileName STRING Verzeichnispfad und Name der Datei z.B. '/home/project/data.csv'
sHeader STRING String mit Header-Daten für die CSV-Datei
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
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
255
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
sLastLogMsg
STRING geschriebene Kopfzeile als STRING
udiDataSetPos
UDINT Nummer des zuletzt geschriebenen Datensatzes 0...4294967295
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
• ERR_LINUX_SYS_CALL Fehler bei Ausführung des Linux-Befehls.
• ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler..
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
256
9.5.4 Support
Buffer_To_StringBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
abyInData ARRAY[0...499] OF BYTE
Pufferspeicher, der die zu lesendenDaten enthält
pro Byte:0x00 ... 0xFF
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
257
Parameter Datentyp Bedeutung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
aTextLine ARRAY[0..24] OF STRING
Array mit konvertierten Textzeilen
byNoOfTextLine
BYTE Anzahl der gefundenen Zeilen im Array
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 den Ausgängeliegen gültige Ergebnisse an.
DE
258
GetFileSizeAsyncBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDer FB ermittelt die Größe einer Datei.
Eingangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keine Auswirkungenauf FB-Abarbeitung
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
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
259
Parameter Datentyp Bedeutung Mögliche Werte
hFileHand RTS_IEC_HANDLE
Dateibeschreibung des Laufzeitsystems < 1 Fehler
sonst. kein Fehler
xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 0...4294967295
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
DE
260
GetMemoryInfoAsyncBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keineAuswirkungenauf FB-Abarbeitung
eDirName eFileSystem Verzeichnis, dessen Speicherinformation gelesenwerden sollen
Ò eFileSystem (ENUM)
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wirdausgeführt
261
Parameter Datentyp Bedeutung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist TRUE • FBerfolgreichausgeführt
• FB kannerneutaufgerufenwerden
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehleraufgetretenoder der FBwird nochausgeführt
TRUE • Fehleraufgetreten
• Aktionkonnte nichtausgeführtwerden
• Diagnoseinformationenbeachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
aFileInfoText ARRAY[0..24] OFSTRING
Array mit Speicherinformationen desVerzeichnispfades
stMemInfo stMemoryInfo ausgelesene Speicherinformationen Ò stMemoryInfo (STRUCT)
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 den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen.
• ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
DE
262
9.5.5 Functions
ByteArray_To_StringBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDie Funktion liest ein Byte Array ein, verkettet die Werte und gibt sie als Zeichenkette aus.
Eingangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
abyInData ARRAY[0...63] OF BYTE
Array mit Eingangsdaten pro Byte:0x00 ... 0xFF
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
ByteArray_To_String STRING Zurückgegebene Zeichenkette
263
DW_To_4ByteBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
dwInData DWORD Daten z.B. 0xFFDDEECC
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
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)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
abyInData ARRAY[0...1] OF BYTE
Array mit Eingangsdaten pro Byte:0x00 ... 0xFF
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
Pack2Byte_To_Word WORD Rückgabewert der Funktion 0x0000 ... 0xFFFF
265
Pack4Byte_To_DWBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
abyInData ARRAY[0...3] OF BYTE
Array mit Eingangsdaten pro Byte:0x00 ... 0xFF
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
Pack4Byte_To_DW DWORD Rückgabewert der Funktion 0x00000000 ... 0xFFFFFFFF
DE
266
RTC_To_StringBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDie Funktion liest die geräteinterne Echtzeituhr (RTC) und gibt die Laufzeit in Sekunden seit demletzten Systemstart als String aus.
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
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)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
wInData WORD Daten 0x0000 ... 0xFFFF
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
Word_To_2Byte ARRAY[0..1] OF BYTE
Rückgabewert derFunktion
Pro Byte:0x00 ... 0xFF
DE
268
_8Byte_To_CSVBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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
Parameter Datentyp Bedeutung Mögliche Werte
abyInData ARRAY[0..7] OF BYTE
Array mit Eingangsdaten pro Byte:0x00 ... 0xFF
Ausgangsparameter
Parameter Datentyp Bedeutung Mögliche Werte
_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)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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.
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
anyVar ANY CSV-Daten, die in eineZeichenkette konvertiertwerden sollen.
-
stSepCfg stSEPARATOR_CONFIG CSV-Trennzeichen-Konfiguration (Ò stSEPARATOR_CONFI
G (STRUCT) / 275)
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
ANY_TYPE_TO_STRING STRING Zeichenkette mit denkonvertierten CSV-Daten incl.Trennzeichen.
--
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
DE
270
ifmCONCATBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
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)
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
sStr1 STRING Zeichenkette 1 --
sStr2 STRING Zeichenkette 2 --
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
ifmCONCAT STRING Zeichenkette sStr1 + sStr2 --
271
ifmFINDBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDie Funktion gibt die Position des Strings sStr2 im String sStr1 zurück. Die Suche startet anuiPosition .
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)
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
sStr1 STRING Zeichenkette 1 --
sStr2 STRING Zeichenkette 2, nach dieserwird in Zeichenkette 1gesucht.
--
uiPosition UINT Startposition für das Suchenin der Zeichenkette 1
0 = 1. Zeichen
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
ifmFIND UINT Position von sStr2 in sStr1 --
DE
272
ifmMIDBaustein-Typ: Funktion (FUN)
Verhaltensmodell: --
Bibliothek: ifmFileUtil.library
Symbol in CODESYS:
BeschreibungDie Funktion liest einen Teilstring eines anderen Strings 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)
Beispiel:
uiPosition 0 1 2 3 4 5
sStr a b c d e f
sStr = "abcdef"
uiPosition = 1
uiLength = 3
=> ifmMTD = "bcd"
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
sStr STRING Zeichenkette --
uiPosition UINT Startposition in derZeichenkette
0 = 1. Zeichen
uiLength UINT Anzahl der Zeichen --
AusgangsparameterParameter Datentyp Bedeutung Mögliche Werte
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
USB2 /tmpfs/media/usb/<USB Name> INT 7
USB3 /tmpfs/media/usb/<USB Name> INT 8
USB4 /tmpfs/media/usb/<USB Name> INT 9
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*
sColumn3 STRING(3) Überschrift der Spalte 3 R1C3*
sColumn4 STRING(3) Überschrift der Spalte 4 R1C4*
sColumn5 STRING(3) Überschrift der Spalte 5 R1C5*
sColumn6 STRING(3) Überschrift der Spalte 6 R1C6*
sColumn7 STRING(3) Überschrift der Spalte 7 R1C7*
sColumn8 STRING(3) Überschrift der Spalte 8 R1C8*
sColumn9 STRING(3) Überschrift der Spalte 9 R1C9*
* ... 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.
Bezeichnung Datentyp Bedeutung Mögliche Werte
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
Bezeichnung Datentyp Bedeutung Mögliche Werte
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.
Bezeichnung Datentyp Bedeutung Mögliche Werte
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
Baustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: 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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
eBaudrate CAN_BAUDRATE Baudrate des CAN-Kanals Ò CAN_BAUDRATE (ENUM)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
277
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.
• ERR_BUS_OFF Fehler: CAN-Schnittstelle ist im Zustand "BUS OFF"
• 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_BAUDRATE_INVALID_OR_ALREADY_SET
Fehler: Gewünschte Baudrate kann nicht eingestellt werden, da sie ungültig istoder schon eine andere Baudrate definiert wurde.
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
278
9.6.2 CAN_Recover
Baustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmRawCAN.library
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.
EingangsparameterParameter Datentyp Bedeutung Mögliche Werte
xExecute BOOL Ausführung des FB steuern • FALSE => TRUE: FB wird einmalausgeführt
• Sonst: keine Auswirkungen auf FB-Abarbeitung
eChannel CAN_CHANNEL
Identifier der CAN-Schnittstelle (Ò CAN_CHANNEL (ENUM) / 207)
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
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist • FALSE: FB wird ausgeführt• TRUE:
FB erfolgreich ausgeführtFB kann erneut aufgerufenwerden
279
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
• FALSE: kein Fehler aufgetretenoder der FB wird nochausgeführt
• TRUE: Fehler aufgetretenAktion konnte nicht ausgeführtwerdenDiagnoseinformationen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
usiRetryCount USINT Zähler für bereits absolvierteWiederholungsversuche seit der letzten Aktivierungdes FB
Ò
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• 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_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
280
9.6.3 CAN_RemoteRequestBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: EXECUTE
Bibliothek: ifmRawCAN.library
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
Parameter Datentyp Beschreibung Mögliche Werte
xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmalausgeführt
sonst. keineAuswirkungenauf FB-Abarbeitung
eChannel CAN_CHANNEL
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
* ... voreingestellter Wert
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt
TRUE • FB erfolgreichausgeführt
• FB kann erneutaufgerufen werden
281
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreibenund wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
DE
282
9.6.4 CAN_RemoteResponseBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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
Parameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL
Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
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
xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)
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
* ... voreingestellter Wert
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatione
n beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
283
Parameter Datentyp Beschreibung Mögliche Werte
uiRTR_Cnt UINT Anzahl der empfangenen Remote-Anforderungennach dem letzten Aufruf des FB
Diagnose-Code:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An denAusgänge liegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nichtbeschreiben und wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
284
9.6.5 CAN_RxBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL
Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)
FALSE StandardFrame*
TRUE ExtendedFrame
udiID UDINT Identifier der CAN-Nachricht • für Standard Frame (11 BitIdentifier):0 ... 2047
• für Extended Frame (29 BitIdentifier):0 ... 536.870.911
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatione
n beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
285
Parameter Datentyp Beschreibung Mögliche Werte
aData ARRAY[0...7] OFUSINT
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
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreibenund wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
286
9.6.6 CAN_RxMaskBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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)
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)
FALSE Standard Frame*
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
* ... voreingestellter Wert
287
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehler aufgetretenist
FALSE kein Fehleraufgetreten oderder FB wirdnoch ausgeführt
TRUE • Fehleraufgetreten
• Aktion konntenichtausgeführtwerden
• Diagnoseinformationenbeachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
aData ARRAY[0...7] OFUSINT
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
uiAvailable
UINT • Anzahl der empfangenen CAN-Nachrichten seit demletzten FB-Aufruf
• aktuelle CAN-Nachricht wird mitgezählt
0 keine CAN-Nachrichtempfangenzwischen 2 FB-Aufrufen
n n CAN-Nachrichtenempfangen
udiID UDINT Identifier der CAN-Nachricht • für Standard Frame (11 BitIdentifier):0 ... 2047
• für Extended Frame (29 BitIdentifier):0 ... 536.870.911
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• 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
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
288
9.6.7 CAN_RxRangeBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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.
Generelles Verhalten des FB: (Ò CAN_Rx / 284)
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FBdeaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL
Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)
FALSE StandardFrame*
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
* ... voreingestellter Wert
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetreten oder derFB wird noch ausgeführt
289
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht ausgeführt
werden• Diagnoseinformationen
beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
aData ARRAY[0...7] OFUSINT
Array für die Speicherung der empfangenenDaten
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 dem letzten FB-Aufruf
• aktuelle CAN-Nachricht wird mitgezählt
0 keine CAN-Nachricht empfangenzwischen 2 FB-Aufrufen
n n CAN-Nachrichten empfangen
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
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nichtbeschreiben und wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
290
9.6.8 CAN_RxRangeExtBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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.
Generelles Verhalten des FB: (Ò CAN_Rx / 284)
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern • FALSE: FB deaktivieren• TRUE: FB aktivieren
eChannel CAN_CHANNEL Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
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
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
FALSE kein Fehler aufgetreten oder derFB wird noch ausgeführt
TRUE • Fehler aufgetreten• Aktion konnte nicht ausgeführt
werden• Diagnoseinformationen
beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
aData ARRAY[0...7] OFUSINT
Array für die Speicherung der empfangenenDaten
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 dem letzten FB-Aufruf
• aktuelle CAN-Nachricht wird mitgezählt
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:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nichtbeschreiben und wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
292
9.6.9 CAN_StatusBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
AusgangsparameterParameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung einFehler aufgetreten ist
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)
293
Parameter Datentyp Beschreibung Mögliche Werte
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:
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
DE
294
9.6.10 CAN_TxBaustein-Typ: Funktionsbaustein (FB)
Verhaltensmodell: ENABLE
Bibliothek: ifmRawCAN.library
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.
EingangsparameterParameter Datentyp Beschreibung Mögliche Werte
xEnable BOOL Aktivität des FB steuern FALSE FB deaktivieren
TRUE FB aktivieren
eChannel CAN_CHANNEL
Identifier der CAN-Schnittstelle Ò CAN_CHANNEL (ENUM)
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
xExtended BOOL gewünschter Frame-Typ: - Standard Frame (11 Bit-Identifier)- Extended-Frame (29 Bit-Identifier)
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
aData ARRAY[0...7] OF USINT
Array mit den zu sendenden Daten
* ... voreingestellter Wert
Ausgangsparameter
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
FALSE kein Fehler aufgetretenoder der FB wird nochausgeführt
295
Parameter Datentyp Beschreibung Mögliche Werte
xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehleraufgetreten ist
TRUE • Fehler aufgetreten• Aktion konnte nicht
ausgeführt werden• Diagnoseinformatio
nen beachten
eDiagInfo DIAG_INFO Diagnoseinformationen Ò Liste unten (Diagnose-Codes)
Diagnose-Codes:
• STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
• STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgängeliegen gültige Ergebnisse an.
• ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nichtbeschreiben und wird nicht übertragen
• ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination vonEingangsparametern; Funktionsaufruf wurde abgebrochen.
• ERR_INTERNAL Fehler: Interner Systemfehlerifm-Service-Center kontaktieren!
• ERR_UNDEFINED Fehler: Unbekannter Fehlerifm-Service-Center kontaktieren!
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