Seite 1 Programmierhandbuch ecomatDisplay Betriebssystem: ab V2.x.x.x CODESYS-Version: 3.5 SP16 Patch 0...
Seite 2: Inhaltsverzeichnis
4.2.3 Neues Projekt mit ecomatDisplay erstellen ....... . . 20 CODESYS-Bedienungsanleitung nutzen .
Seite 3 ........
Seite 4 Anwendung auf ecomatDisplay laden ........
Seite 5 9.4.11 Touch .............178 9.4.12 System Time .
Seite 6: Vorbemerkung
PROFINET ist Eigentum der → PROFIBUS Nutzerorganisation e.V., Deutschland ® • Windows ist Eigentum der → Microsoft Corporation, USA 1.2 Zweck des Dokuments Dieses Dokument gilt für folgende Geräte des Typs ecomatDisplay ab Firmware-Version V 2.x.x.x: • CR1058 • CR1059 • CR1074 •...
Seite 7: Verwendete Symbole
Warnung vor Personenschäden w Leichte reversible Verletzungen sind möglich. WARNUNG Warnung vor schweren Personenschäden w Tod oder schwere irreversible Verletzungen sind möglich. 1.5 Übersicht: ifm Anwender-Dokumentation Die Dokumentation für das Gerät besteht aus folgenden Modulen: Dokument Inhalt / Beschreibung Datenblatt • Technische Daten Montageanleitung / Betriebsanleitung •...
Seite 8: Übersicht: Codesys-Dokumentation
• 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 als Download auf der ifm-Website zur Verfügung: www.ifm.com 1.6 Übersicht: CODESYS-Dokumentation Die CODESYS GmbH stellt für die Programmierung der SPS des Geräts die folgende Anwender-...
Seite 9 Ausgabe Thema Datum Änderungen für Firmware V2 01/2021 Neue 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)
Seite 10: Sicherheitshinweise
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 eine Dokumentation nach den gesetzlichen und normativen Anforderungen für den Betreiber und den Benutzer des Systems zu erstellen und beizulegen.
Seite 11: Installation
Webseite die Software-Komponenten zum Herunterladen bereit: www.ifm.com 3.1.3 Lizensierung Mit dem Kauf des ecomatDisplay erwirbt der Anwender gleichzeitig eine gültige Lizenz für die Nutzung des "CODESYS für ifm ecomatDisplay". u Lizenzinformationen: Ò Installationsroutine oder Produktseite des Artikels auf der ifm- Webseite.
Seite 12: Ifm-Package
Machen Sie sich mit folgenden CODESYS-Funktionen vertraut: Package Manager: Ò Online-Hilfe > CODESYS Development System > Packages und Lizenzen verwalten 3.3.1 Komponenten des Packages ifm stellt für die Programmierung der geräteinternen SPS das CODESYS-Package "CODESYS für ifm ecomatDisplay" bereit. Das Package enthält folgende Komponenten: • Gerätebeschreibungsdateien •...
Seite 13: Package Deinstallieren
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.
Seite 14: Menü Im Recovery-Modus
Eine Unterbrechung des Update-Vorgangs kann zu einem Verlust der auf dem Gerät gespeicherten 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: •...
Seite 15 Laufzeitsystem/Firmware-Update via USB-Schnittstelle u 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.
Seite 16: Ip-Parameter Der Ethernet-Schnittstelle Einstellen
w Gewählte Update-Datei wird auf das Display geladen. w Softwarekomponenten des Geräts werden automatisch aktualisiert: (Ò Allgemeine Hinweise / 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.
Seite 17: Recovery-Modus Beenden
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.
Seite 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 Projekt automatisch gestartet. Wenn kein gültiges Projekt gespeichert ist, dann erscheint nach dem Neustart das Setup- Startmenü.
Seite 19: Schnelleinstieg
4.2.1 Template für ecomatDisplay ifm stellt für jedes Modell der Gerätefamilie ein spezielles Projekt-Template bereit. Das Template enthält die optimalen Voreinstellungen für das jeweilige Zielgerät (Target). Der Anwender kann das Template während der Projekterstellung wählen. Die Templates sind nach der Installation des Gerätepackages verfügbar.
Seite 20: Neues Projekt Mit Ecomatdisplay Erstellen
[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.
Seite 21: Programmierschnittstelle Konfigurieren
SPS 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.
Seite 22: Zugriffsschutz Für Projekt Aktivieren
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äteinternen SPS zu setzen. w CODESYS kann Daten auf die geräteinterne SPS übertragen. 4.5 Zugriffsschutz für Projekt aktivieren u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut: Projekt schützen und speichern: Ò...
Seite 23: Gerätekonfiguration
5 Gerätekonfiguration Dieses Kapitel beschreibt die Konfiguration des Geräts im Setup-Modus. 5.1 Setup-Modus starten Wenn keine gültige Anwendung auf dem Gerät gespeichert ist, geht das Gerät nach dem Systemstart 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.
Seite 24: Setup Main Menu: Untermenüs
5.1.1 Setup Main Menu: Untermenüs Der 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: Datensicherung erstellen / 28) [Device Diagnostic] Geräte-Diagnose (Ò Device Diagnostic / 34) [Device Info] Geräte-Information (Ò Device Info: Geräte-Informationen anzeigen / 37) [Remove USB]...
Seite 25: Bedienung: Im Setup-Menü Navigieren
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.
Seite 26: Bedienung: Text Eingeben Mit Der Bildschirmtastatur
Bedienung: Text eingeben mit der Bildschirmtastatur Die Bedienoberfläche des Laufzeitsystems verfügt über eine Bildschirmtastatur. Sie erscheint automatisch, sobald vom Bediener die Eingabe von Zeichen erwartet wird. Die Bildschirmtastatur zeigt die QWERTY-Tastaturbelegung. Diese Einstellung kann nicht geändert werden. Bei der Passworteingabe: Zum Schutz sensibler Information erscheint nur das zuletzt eingegebene Zeichen im Klartext.
Seite 27: Setup: Passwort Eingeben
Bestimmte Navigationsfunktionen können sowohl mit den Funktionstasten als auch mithilfe des Touchscreens ausführt werden. Folgende Bedienelemente kann der Bediener direkt per Berührung auf dem Touchscreens aktivieren: • Schaltflächen • Menüpunkte • Tasten der Bildschirmtastatur • Symbole im Datei-Verzeichnis • Eingabefelder Setup: Passwort eingeben Um das Passwort für den uneingeschränkten Zugriff auf das Setup-Menü...
Seite 28: Backup: Datensicherung Erstellen
Bezeichnung Bedeutung Mögliche Werte [Ethernet 0] / [Ethernet 1] Auswahl der Ethernet-Schnittstelle [DHCP Mode] DHCP-Mode einschalten / ausschalten z.B. 192.68.82.247 [IP Address] IP-Adresse der Ethernet-Schnittstelle des Geräts z.B. 255.255.255.0 [Netmask] Subnetzmaske des Netzwerksegments z.B. 192.168.82.1 [Gateway] IP-Adresse des Netzwerk-Gateways Bridge-Mode aktivieren u Kontrollfeld [Bridge Mode] aktivieren w Bridge-Mode ist aktiv.
Seite 29: System Setup
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.
Seite 30: Datum Und Uhrzeit Einstellen
3 Zeitzone ändern u 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 einstellen Um Datum und Uhrzeit (Systemzeit) einzustellen: 1 Menüseite wählen u Navigationspfad: [Launch Setup] >...
Seite 31 Die Programmiersoftware CODESYS kann auch bei eingeschaltetem Passwortschutz uneingeschränkt auf das im Gerät gespeicherte IEC-Projekt zugreifen. Login-Daten Werkseitig sind folgende Login-Daten eingestellt: Benutzername/Login: root Passwort: pdm3 Diese Einstellungen gelten z.B. für: • Zugriff auf das Gerät per FTP, Telnet, SSH •...
Seite 32: Passwortschutz Aktivieren/Deaktivieren
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 werkseitig gesetzte Passwort: pdm3 u Um einen wirksamen Schutz zu gewährleisten, das werkseitig gesetzte Passwort ändern! Die Programmiersoftware CODESYS kann auch bei eingeschaltetem Passwortschutz...
Seite 33: Displayhelligkeit Einstellen
2 Bild ändern 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. •...
Seite 34: Touchscreen Konfigurieren
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 ändern u Die gewünschte Ausrichtung einstellen. w Nach einer Abfrage startet das Gerät neu. Touchscreen konfigurieren Um den Touchscreen (falls vorhanden) einzustellen: 1 Menüseite wählen u Navigationspfad: [Launch Setup] >...
Seite 35 Bezeichnung Bedeutung Mögliche Werte [Baudrate] Baudrate des CAN-Bus einstellen. 20 kbit/s 33.3 kbit/s 50 kbit/s 83.3 kbit/s 100 kbit/s 125 kbit/s 250 kbit/s 500 kbit/s 800 kbit/s 1000 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...
Seite 36: Can Test: Daten Empfangen
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.
Seite 37: Device Info: Geräte-Informationen Anzeigen
1 Menüseite wählen u 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.
Seite 38: Remove Usb: Usb-Stick Sicher Entfernen
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]...
Seite 39: Systemkonfiguration
6 Systemkonfiguration 6.1 SPS konfigurieren Die Konfiguration der SPS des ecomatDisplay erfolgt über den "Generischen Geräte-Editor" des CODESYS-Programmiersystems. u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut. Geräteeditor: Ò Online-Hilfe > CODESYS Development System > Referenz Benutzeroberfläche > Objekte > Objekt 'Gerät' und Generischer Geräteeditor Die Konfiguration der SPS erfolgt über den Knoten [Device (ecomatDisplay)] des Gerätebaums.
Seite 40: Gerätebeschreibungsdateien (Eds-Dateien)
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-Webseite herunterladen: www.ifm.com u EDS-Dateien über das Geräte-Repository in CODESYS installieren. 6.3.2 CANbus hinzufügen und konfigurieren u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut: CANbus-Einstellungen: Ò Online-Hilfe > Feldbusunterstützung > CAN-basierte Feldbusse >...
Seite 41: Canopen: Canopen Manager Konfigurieren (Master)
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 Programmiersystems CODESYS 3.5.
Seite 42: J1939: J1939-Manager Konfigurieren
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.
Seite 43: Programmierung
7 Programmierung 7.1 Objekte der SPS-Anwendung mit ecomatDisplay-Template Alle Objekte einer SPS-Anwendung sind als Unterelemente des Knotens [Application] im Gerätebaum gelistet. In der Grundkonfiguration des Templates (Ò CODESYS-Projekt erstellen / 19) enthält eine SPS-Anwendung folgende Objekte: Abb. 2: Legende: Objekt Beschreibung Application Container für Objekte einer SPS-Anwendung.
Seite 44: Sps-Anwendung Erstellen
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 Programmiersprachen Folgende Programmiersprachen nach IEC 61131 werden durch die ifm-Funktionsbibliotheken unterstützt: • Funktionsbausteinsprache FUP/FBD •...
Seite 45: Verfügbarer Speicher
w Das PRG [PLC_PRG (PRG)] wird im Gerätebaum grün dargestellt und ist für das Kompilieren gesperrt. 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.
Seite 46: Persistente Variablen
7.2.5 Persistente Variablen Werte von persistenten Variablen (Retain-Variablen oder remanente Variablen) bleiben nach Ausschalten 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.
Seite 47: Arbeitsreihenfolge
• Die SPS-Anwendung kann erst nach dem Erstellen verwiesen wird. der Visualisierung getestet werden. u Vor Beginn eine möglichst genaue Struktur der Visualisierung und ihrer Inhalte entwerfen! 7.3 ifm-Funktionsbibliotheken nutzen ifm stellt für die Programmierung des Geräts unter CODESYS 3.5 folgende Funktionsbibliotheken bereit:...
Seite 48: Detaillierte Informationen Zu Den Ifm-Funktionsbibliotheken: (Ò Ifm-Funktionsbibliotheken / 78)
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 konfigurieren Um das Gerät zu konfigurieren, stehen die folgenden Funktionselemente zur Verfügung: Name...
Seite 49: Ethernet-Schnittstelle Konfigurieren
7.3.4 Ethernet-Schnittstelle konfigurieren Um die Einstellungen der Ethernet-Schnittstelle des Geräts zu verwalten, stehen die folgenden Funktionselemente zur Verfügung: Name Beschreibung Referenz GetEthernetInterfaces Eine Liste mit den verfügbaren Ethernet- (Ò Ethernet / 110) Schnittstellen ausgeben. GetIPsettings IP-Einstellungen der Ethernet-Schnittstelle lesen SetIPsettings IP-Einstellungen der Ethernet-Schnittstelle ändern GetEthernetBridgeConfig Ethernet Bridge Mode-Einstellungen lesen SetEthernetBridgeConfig...
Seite 50: Systemzeit Konfigurieren/Lesen
Um die Sensoren und die Eingänge des Geräts zu lesen und die Ausgänge zu schreiben, stehen die folgenden 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.
Seite 51: Analogkamera Einstellen Und Steuern
Name Beschreibung Referenz DisableTouchScreen Touchscreen-Funktionalität aktivieren / deaktivieren. (Ò Touch / 178) SetTouchOptimisationMode Optimierungsmodus für Touchscreen einstellen. 7.3.11 Analogkamera einstellen und steuern Um eine Analogkamera zu steuern und zu konfigurieren, steht das folgende Funktionselement zur Verfügung: Name Beschreibung Referenz AnalogueCameraWindowControl Analogkamerafenster einstellen und steuern. (Ò Window Control / 196) 7.3.12 Ethernet-Kamera einstellen und steuern Um eine Ethernet-Kamera (IP-Kamera) zu steuern und zu konfigurieren, steht das folgende Funktionselement zur Verfügung:...
Seite 52: Hilfsfunktionen Nutzen
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 nutzen Der Anwender kann folgende Hilfsfunktionen nutzen: Name Beschreibung Referenz GetMemoryInfoAsync Belegung des Gerätespeichers anzeigen (Ò Support / 256) (Ò Functions / 262) ByteArray_To_String Array aus Bytes in eine Zeichenkette konvertieren (Ò Parameter File / 235) Buffer_To_String Array aus Bytes in ein Array aus Zeichenketten...
Seite 53: Externe Dateien Einbinden
Objekt Beschreibung VISU_TASK Visualisierungstask VisualizationManager Objekt zur Verwaltung der grundlegenden Einstellungen. TargetVisu Objekt zur Konfiguration der Zielvisualisierung, die auf dem Display angezeigt wird. WebVisu Objekt zur Konfiguration der webbasierten Visualisierung, die über Netzwerkzugriff in einem Webbrowser angezeigt wird. Visu_Default Objekt, das ein Visualisierungsbild enthält. Diese Objekte sind vorkonfiguriert und können angepasst werden.
Seite 54: Sprachumschaltung
7.4.4 Sprachumschaltung u 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 erforderlichen Sprachen erstellen.
Seite 55: Bootscreen Einstellen
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 einstellen Das Bild für den Bootscreen kann über die Bildersammlung im CODESYS-Projekt auf das Gerät geladen und mit dem FB (Ò LoadSplashScreen / 98) aktiviert werden:...
Seite 56: Visualisierungsmanager Nutzen
7.4.6 Visualisierungsmanager nutzen u Machen Sie sich mit folgenden CODESYS-Funktionen vertraut: Visualisierungsmanager: Ò Online-Hilfe > CODESYS Visualization > Visualisierungsmanager mit 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.
Seite 57 Folgend wird die globale Umschaltung der Visualisierung mit Hilfe der globalen CurrentVisu-Variable VisuElems.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. •...
Seite 58: Target-Visualisierung Konfigurieren
w Während der Laufzeit erfolgt mit den Schaltflächen jeweils eine Umschaltung von visu1 nach visu2 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.
Seite 59: Visualisierung Erstellen
7.4.7 Visualisierung erstellen u 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.
Seite 60: Eingabeobjekte Der Visualisierung Konfiguieren
Das Gerät kann als Multitouch-Display eingesetzt werden. Dazu muss die entsprechende Option im CODESYS Visualisierungsmanager aktiviert werden. Die Multitouch-Funktionalität muss über die CODESYS-Applikation programmiert werden. Ein Beispielprogramm hierzu findet man im CODESYS Store oder kann über den ifm-Support angefordert werden. Die Programmierung von Multitouch Applikationen wird nur erfahrenen Anwendern empfohlen, da einige Standard-Touch-Eingaben von CODESYS im Multitouch-Mode nicht mehr zu Verfügung...
Seite 61: Mobile Kameras Nutzen
• 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 Kameras Analog-Kameras Ethernet-Kameras Empfohlene ifm electronic: ifm electronic: Referenzkameras O2M200, O2M201, O2M202, O2M203 Artikelnummer ZB086x, z.B. ZB0861, ZB0862, ZB0863, ZB0864 Kameras anderer •...
Seite 62: Ethernet-Kamera Konfigurieren Und Steuern
u Zur Konfiguration und Steuerung einer Analogkamera folgenden Funktionsbaustein verwenden: FB AnalogueCameraWindowControl (Ò / 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. •...
Seite 63: Pdf-Viewer Nutzen
Window_Controls Objekt mit Größe und Position des Kamerafensters auf dem Display. Objekt mit Größe und Position des Kamerabildausschnittes. 7.8 PDF-Viewer nutzen u 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.
Seite 64: Csv-Datei-Logging
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-Logging Das Gerät bietet die Möglichkeit CSV-Dateien zu schreiben und zu lesen, z.B. zum Logging von Maschinendaten.
Seite 65: Csv-Datei Lesen
Die ifm-Hilfsfunktionen ifmCONCAT, ifmFIND und ifmMID verarbeiten Strings mit einer maximalen Länge von 1000 Zeichen. Die Länge eines Standard-Strings in CODESYS beträgt 255 Zeichen. (Ò Stringformat uiGenericLogSizeMax / 65) Logging jeglicher Datentypen und Schreiben in eine CSV-Datei, z.B. REAL, WORD, DWORD, STRING ist möglich.
Seite 66: Canopen Nutzen
Mit dem Kauf des Geräts ab Firmware V2 erwirbt der Anwender gleichzeitig eine gültige Lizenz für die Nutzung 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: •...
Seite 67: Rawcan: Can-Netzwerkknoten Steuern
Um in einer Anwendung auf eine für den CANopen-Betrieb konfigurierte CAN-Schnittstelle zuzugreifen, 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 steuern Um einen Knoten in einem CAN-Netzwerk zu steuern, stehen folgende POUs zur Verfügung: Name Beschreibung Referenz...
Seite 68: Can-Schnittstelle Zuordnen
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 zuordnen u Im CODESYS-Gerätebaum: [Communication] > [CAN] > [ifmCANBus] doppelklicken.
Seite 69: J1939-Ecu Parametrieren
• Kein Senden • Senden von Daten (Broadcast und P2P) aktiviert Adresse des ifm-Controllers • Empfangen von P2P-Daten 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.
Seite 70: Ethernet/Ip-Modul Anhängen
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ängen u 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>...
Seite 71: Modbus Tcp Master Anhängen
7.15.2 Modbus TCP Master anhängen u 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.
Seite 72: Task-Abarbeitung Konfigurieren
Taskkonfiguration: Ò Online-Hilfe > CODESYS Development System > Applikation programmieren > Taskkonfiguration Die Abarbeitung der Tasks wird durch Parameter gesteuert. Der Anwender kann jeden Task separat parametrieren. CODESYS legt bei der Projekt- und Visualisierungserstellung mit Verwendung des ecomatDisplay- Templates automatisch folgende Tasks an: Name Beschreibung...
Seite 73 u Im Gerätebaum: Doppelklick auf [VISU_TASK] w Im Editor-Fenster: Registerkarte [VISU_TASK] > [Konfiguration] zeigt aktuelle Konfiguration des Visualisierungs-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 nicht zu unterbrechen, dem Visualisierungs-Task ([VISU_TASK]) eine möglichst niedrige Priorität zuweisen.
Seite 74: Betrieb
Anwendung / 75) 8.1.1 Anwendung auf ecomatDisplay laden Um 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.
Seite 75: Betriebszustände Der Sps-Anwendung
CODESYS löscht die gewählten Anwendungen auf dem Gerät. 8.2 Betriebszustände der SPS-Anwendung Die auf dem ecomatDisplay gespeicherten Anwendungen werden in separaten Tasks unabhängig voneinander ausgeführt. Eine Anwendung kann folgende Betriebszustände einnehmen: • Entladen Auf dem Gerät ist keine Anwendung gespeichert.
Seite 76: Anwendung Rücksetzen (Warm)
Reset-Variante System-Verhalten Auslösende Aktionen Reset (Warm) • Die Anwendung geht in den STOP- (Ò Anwendung rücksetzen (warm) / 76) Zustand. • Standard Variablen (VAR) der Anwendung werden neu initialisiert. • Remanente Variablen (VAR RETAIN) der Anwendung behalten ihre aktuellen Werte. Reset (Kalt) • Die Anwendung geht in den Zustand (Ò Anwendung rücksetzen (kalt) / 76) STOP.
Seite 77: Systeminformationen Anzeigen
[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.
Seite 78: Ifm-Funktionsbibliotheken
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 Funktionsbausteine Status-/Diagnose-/Fehler-Meldungen der Funktionsbausteine sind im globalen Enum DIAG_INFO definiert.
Seite 79: Reaktion Auf Fehler
Funktionsbausteine, die keinen xEnable-Eingang besitzen, werden zyklisch ab Start der Applikation abgearbeitet. Erst mit Stopp der Applikation wird die Abarbeitung beendet. Das Verhalten entspricht dem eines Funktionsbausteins mit einem dauerhaften TRUE am Eingang xEnable. Reaktion auf Fehler Im Fehlerfall wird xError auf TRUE gesetzt und eDiagInfo zeigt den Diagnose-Code an, solange xEnable = TRUE ist.
Seite 80: Bibliothek Ifmcanopenmanager.library
9.3 Bibliothek ifmCANopenManager.library Die Bibliothek enthält Programmbausteine (POU) und Datenstrukturen für die Programierung der Funktionalität eines CANopen Managers. 9.3.1 COP_GetNodeState Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmCANopenManager.library Symbol in CODESYS: Beschreibung Der FB gibt den aktuellen Zustand eines CANopen-Knotens aus. Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte...
Seite 81 • STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_DEVICE_NOT_AVAILABLE Fehler: Gewähltes Gerät unbekannt / nicht konfiguriert...
Seite 82: Cop_Sdoread
9.3.2 COP_SDOread Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmCANopenManager.library Symbol in CODESYS: Beschreibung Der 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 und Subindex des Objektverzeichnisses.
Seite 83 • ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INTERNAL Fehler: Interner Systemfehler ifm-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 •...
Seite 84: Cop_Sdowrite
9.3.3 COP_SDOwrite Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmCANopenManager.library Symbol in CODESYS: Beschreibung Der FB schreibt den Inhalt eines Service Data Objects (SDO). Das SDO wird ausgewählt über die CAN-Schnittstelle, die ID des CANopen-Knotens sowie Index und Subindex des Objektverzeichnisses. Eingangsparameter Parameter Datentyp Bedeutung...
Seite 85 • ERR_TIMEOUT Fehler: Die zulässige maximale Ausführungszeit wurde überschritten. Die Aktion wurde nicht abgeschlossen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-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 •...
Seite 86: Cop_Sendnmt
9.3.4 COP_SendNMT Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmCANopenManager.library Symbol in CODESYS: Beschreibung Der FB sendet einen Befehl zur Steuerung eines CANopen-Knotens. Eingangsparameter Parameter 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 die Bausteinausführung erfolgreich beendet...
Seite 87 • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren!
Seite 88: Nmt_Service (Enum)
9.3.5 NMT_SERVICE (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert NMT_SER Befehl zur Steuerung SET_PRE_OPERATIO Preoperational-Zustand setzen VICE des CANopen-Knotens SET_OPERATIONAL Operational-Zustand setzen RESET_NODE CAN-Knoten zurücksetzen RESET_COMM Kommunikation zurücksetzen STOP_NODE CAN-Knoten stoppen 9.3.6 NMT_STATES (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert NMT_STAT Zustand des CAN-Netzwerkes INIT Initialisierung PREOP...
Seite 89: Ausgangsparameter
• Abspielvorgang steuern (Pause, Wiederholen, Startposition) • Wiedergabelautärke einstellen • Spieldauer der Audio-Datei anzeigen • Aktivität des Audio Players anzeigen (an, aus) Eingangsparameter Parameter 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...
Seite 90 AudioRecorder Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB aktiviert / deaktiviert den Audio-Recorder des Geräts. Der Audio-Recorder bietet folgende Funktionen: • Audio-Signal am Line-In-Eingang des Geräts aufnehmen und als Datei speichern (unterstütztes Format: .wav) •...
Seite 91 • Audio-Dateiformat wird nicht unterstützt (nur .wav) • ERR_MULTIMEDIA_ • Fehler beim Start der Aufnahme RECORDING_START • ERR_MULTIMEDIA_ • Fehler beim Beenden der Aufnahme RECORDING:STOP • ERR_MULTIMEDIA_ • Fehler beim Pausieren der Aufnahme RECORDING_PAUSE • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 92 GetAudioSettings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 93 An den Ausgänge liegen gültige Ergebnisse an. • ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-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...
Seite 94 SetAudioSettings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 bei Wertänderung ausgeführt. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein.
Seite 95 An den Ausgänge liegen gültige Ergebnisse an. • ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-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...
Seite 96: Common
9.4.2 Common HideSplashScreen Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB steuert die Anzeige des Startbilds (Splashscreen) auf dem Display. Standardmäßig wird das Startbild nach Booten des Geräts angezeigt. Das Startbild wird mit dem FB LoadSplashScreen eingestellt.
Seite 97 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-Instanz wird nicht ausgeführt • ERR_HIDE_SPLASH_SCREEN Fehler: Fehler beim Anzeigen/Ausblenden des Startbildes. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 98 LoadSplashScreen Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB lädt eine Bilddatei in den Flash-Speicher des Geräts. Die Bilddatei wird ab dem nächsten Neustart 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.
Seite 99 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 Fehler ifm-Service-Center kontaktieren!
Seite 100 SetSupplySwitchMode Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB aktiviert oder deaktiviert die automatische Abschaltung (AutoShutdown) des Geräts in Abhängigkeit des Spannungswerts an Klemme 15. Standardeinstellung nach Einschalten des Geräts: Die automatische Abschaltung ist aktiv. Das Gerät fährt herunter, sobald der Spannungswert an Klemme 15 <...
Seite 101 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-Instanz wird nicht ausgeführt • ERR_SET_SUPPLY_SWITCH_MO Fehler: Fehler beim Aktivieren / Deaktivieren der automatischen Abschaltung. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 102 ShutdownDevice Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB löst in Abhängigkeit des Spannungswertes an Klemme 15 ein geordnetes Herunterfahren oder einen 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.
Seite 103 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-Instanz wird nicht ausgeführt • ERR_SHUTDOWN_DEVICE Fehler: Fehler beim Abschalten. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 104 BootIntoRecovery Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB startet das Gerät im Recovery Modus. Dazu wird das Gerät auf Befehl unverzüglich neu gestartet. 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.
Seite 105 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...
Seite 106 GetDeviceOrientation Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 107 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-Instanz wird nicht ausgeführt • ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 108 SetDeviceOrientation Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB rotiert den Bildschirminhalt ja nach Geräteausrichtung. Nach der erfolgreichen Ausführung des FBs und nachfolgendem Neustart des Geräts wird der Bildschirminhalt entsprechend der Einstellungen gedreht. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 109 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-Instanz wird nicht ausgeführt • ERR_GET_DEVICE_ROTATION Fehler: Fehler beim Lesen der konfigurierten Geräteausrichtung. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 110: Ethernet
9.4.3 Ethernet GetEthernetInterfaces Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB gibt eine Liste mit allen verfügbaren Ethernet-Schnittstellen des Geräts aus. Eingangsparameter Parameter Datentyp Beschreibung Mögliche Werte xExecute BOOL Ausführung des FB steuern FALSE => TRUE FB wird einmal ausgeführt sonst.
Seite 111 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-Instanz wird nicht ausgeführt • ERR_GET_ETH_ITF_LIST Fehler: Probleme beim Lesen der verfügbaren Ethernet-Schnittstellen • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 112 GetIPsettings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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. Eingangsparameter Parameter Datentyp...
Seite 113 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen 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 Fehler ifm-Service-Center kontaktieren!
Seite 114: Beschreibung
SetIPsettings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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.
Seite 115: Ausgangsparameter
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 Fehler ifm-Service-Center kontaktieren!
Seite 116 GetEthernetBridgeConfig Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 117 • ERR_BRIDGE_MODE_NOT_ACTIV Fehler: Ethernet Bridge Mode ist nicht aktiv. Die Ethernet Bridge Mode-Konfiguration kann 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 Fehler ifm-Service-Center kontaktieren!
Seite 118 SetEthernetBridgeConfig Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB startet oder stoppt den Bridge Mode zwischen zwei mit den Ethernet-Schnittstellen des Geräts verbundenen Netzwerken. Beim Ausführen des FB, werden die Bridge Mode-Einstellungen aktiv. Folgende Einstellungen für den Bridge Mode sind möglich: •...
Seite 119 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 Fehler ifm-Service-Center kontaktieren!
Seite 120: Keypads
9.4.4 Keypads ControlAllKeyLEDs Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB schaltet entsprechend der gewählten Einstellungen alle Tasten-LEDs des Geräts ein / aus und stellt die LED-Farbe ein. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 121 • 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 Fehler ifm-Service-Center kontaktieren!
Seite 122 GetKeyMapping Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest die aktuellen Mapping-Einstellungen des integrierten Tastenfeldes aus. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 123 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 Fehler ifm-Service-Center kontaktieren!
Seite 124 • 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-Instanz wird nicht ausgeführt • ERR_RESET_KEY_LED Fehler: Fehler beim Zurücksetzen der Tasten-LEDs. ifm-Service-Center kontaktieren!
Seite 125 • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 126 ResetKeyMapping Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB setzt das Mapping aller Tasten auf Standardwerte zurück. u Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 127 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-Instanz wird nicht ausgeführt • ERR_RESET_KEY_MAP • Fehler beim Zurücksetzen des Tasten-Mappings ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 128 SetKeyAutoRepeat Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB stellt die Auto-Repeat-Konfiguration (Impuls-Wiederholung) für die Tasten des integrierten Tastenfeldes ein. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 129 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-Instanz wird nicht ausgeführt • ERR_SET_KEY_AUTO_REPEAT • Fehler beim Setzen der Auto-Repeat-Konfiguration ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 130 SetKeyLED Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 einmal ausgeführt sonst.
Seite 131 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen 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 Fehler ifm-Service-Center kontaktieren!
Seite 132 SetKeyMapping Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 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 Fehler ifm-Service-Center kontaktieren!
Seite 134: Lcd
9.4.5 LCD LCDcontrol Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 135 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-Instanz wird nicht ausgeführt • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 136 GetBootupBacklight Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 137 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-Instanz wird nicht ausgeführt • ERR_GET_BOOTUP_LCD_ Fehler beim Lesen des Helligkeitswertes BRIGHTNESS ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 138 GetLCD_Backlight Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 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 Helligkeitswertes ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 140 SetBootupBacklight Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 141 • ERR_SET_BOOTUP_LCD_ Fehler beim Einstellen des Helligkeitswertes. BRIGHTNESS ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 142 SetLCD_Backlight Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 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 Fehler ifm-Service-Center kontaktieren!
Seite 144: Local Io
9.4.6 Local IO GetLightSensor Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB gibt den Lichtstärkewert des integrierten Lichtsensors zurück. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 145 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-Instanz wird nicht ausgeführt • ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 146 • 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-Instanz wird nicht ausgeführt • ERR_READ_LIGHT_SENSOR • Fehler beim Lesen des Lichtsensor-Wertes. ifm-Service-Center kontaktieren!
Seite 147 • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 148 GetLocalInputs Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 149 • STAT_BUSY Zustand: FB/Funktion wird gerade ausgeführt. • STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 150 GetLocalInputsCyclic Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest den Zustand der lokalen Digitaleingänge des Geräts in einem zyklischen Intervall von 50 ms.. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 151 • ERR_READ_DIGITAL_INPUT • Fehler beim Lesen der Digitaleingangskanäle. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 152 GetTemperature Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest folgende Systemtemperaturen aus: • Temperatur Platine • Temperatur Prozessor Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 153 Ergebnisse an. • ERR_INSTANCE_LIMIT Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt • ERR_READ_TEMPERATURE_ Fehler beim Lesen der Prozessortemperatur CORE_0 ifm-Service-Center kontaktieren! • ERR_READ_TEMPERATURE_BOA Fehler beim Lesen der Platinentemperatur. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler...
Seite 154 • 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-Instanz wird nicht ausgeführt • ERR_READ_TEMPERATURE_ Fehler beim Lesen der Prozessortemperatur CORE_0 ifm-Service-Center kontaktieren!
Seite 155 • ERR_READ_TEMPERATURE_BOA Fehler beim Lesen der Platinentemperatur. ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 156 GetVoltages Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest folgende Systemspannungen aus: • VBB0 • VBB15 • VBB30 Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 157 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.
Seite 158 GetVoltagesCyclic Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 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 Fehler ifm-Service-Center kontaktieren!
Seite 160 SetLocalOutputs Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB schreibt die Werte der lokalen Digitalausgänge. Der FB besitzt eine Diagnosefunktion. Es wird eine Fehlermeldung ausgelöst und ein Fehlerbit "xDiagChannel0 / 1" gesetzt, wenn der Istzustand der Ausgänge nicht mit dem Sollzstand übereinstimmt.
Seite 161 Fehler: Mehr als eine Instanz des FB erzeugt; diese FB-Instanz wird nicht ausgeführt • ERR_WRITE_DIGITAL_ Fehler beim Schreiben des Digitalen Ausgangswerts. OUTPUT • ERR_READ_DIAG_INPUT Fehler beim Lesen des Diagnose-Status. • ERR_VALUE_MISMATCH Fehler: Eingestellter Digitalausgangswert stimmt nicht mit gelesenem Diagnosezustand überein. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 162: Status Led
9.4.7 Status LED SetStatusLEDstate Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB steuert die Status-LED des Geräts. Die Status-LED kann zweifarbig blinken. Die Blinkfrequenz ist einstellbar. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 163: Ausgangsparameter
• 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 Fehler ifm-Service-Center kontaktieren!
Seite 164: Storage
9.4.8 Storage USBstorageHandler Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE mit Busy Extension Bibliothek: ifmUSBstorageUtil.library Symbol in CODESYS: Beschreibung Der 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) •...
Seite 165 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 Fehler ifm-Service-Center kontaktieren! • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren!
Seite 166 USBstorageHandlerMulti Baustein- Funktionsbaustein (FB) Typ: Verhalten ENABLE mit Busy Extension smodell: Bibliothek ifmUSBstorageUtil.library Symbol in CODESYS Beschreibung Der FB verwaltet die mit dem Gerät verbundenen USB-Geräte. Die gerätespezifischen Informationen der USB-Geräte werden in einem Array gespeichert. Der FB führt folgende Funktionen aus: •...
Seite 167 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 Fehler ifm-Service-Center kontaktieren! • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren!
Seite 168: System Commands
9.4.9 System Commands LinuxSysCallAsync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmPDM360NGutil.library Symbol in CODESYS: Beschreibung Der FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem des Geräts und gibt den Rückgabewert des Befehls aus. Der übergebene Befehl wird asynchron im Hintergrund ausgeführt.
Seite 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änge liegen 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.
Seite 170 LinuxSysCallAsync2 Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem des Geräts und gibt den Rückgabewert des Befehls aus. Der übergebene Befehl wird asynchron im Hintergrund ausgeführt. Die Standardausgabe (stdout) des Linux-Befehls wird in einem String-Puffer gespeichert.
Seite 171 Ausgangsparameter Parameter Datentyp Beschreibung Mögliche Werte xDone BOOL Anzeige, ob FB-Ausführung erfolgreich 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ührung ein Fehler FALSE kein Fehler aufgetreten aufgetreten ist oder der FB wird noch ausgeführt...
Seite 172 LinuxSysCallSync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem des Geräts und gibt den Rückgabewert des Befehls aus. Der übergebene Befehl wird synchron zum aufrufenden IEC-Task ausgeführt, das bedeutet: •...
Seite 173 Parameter Datentyp Beschreibung Mögliche Werte wCmdResul WORD Rückgabewert des Linux-Befehls Abhängig vom Befehl, z.B.: 0: Befehl erfolgreich ausgeführt 1...65534: Fehler: Ausführung des Befehls fehlgeschlagen. → CmpErrors.library oder Hilfe zu Linux-Befehl. 65535: Befehl wird ausgeführt Diagnose-Code: • STAT_INACTIVE Zustand: FB/Funktion ist inaktiv. •...
Seite 174: Beschreibung
LinuxSysCallSync2 Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB übergibt einen Linux-Befehl mit Parametern (max. 255 Zeichen) an das Betriebssystem des Geräts und gibt den Rückgabewert des Befehls aus. Die Standardausgabe (stdout) des Linux-Befehls wird in einem String-Puffer gespeichert. Der übergebene Befehl wird synchron zum aufrufenden IEC-Task ausgeführt, das bedeutet: •...
Seite 175 Parameter Datentyp Beschreibung Mögliche Werte sCommand STRING Linux-Befehl inkl. Parameter (max. 255 Zeichen) psCmdStdOut POINTER TO STRING Adresse des Puffers für die Standardausgabe (stdout) des Linux- Befehls. Mögliche Größe 1...10000 Bytes. Ausgangsparameter Parameter Datentyp Beschreibung Mögliche Werte xDone BOOL Anzeige, ob FB-Ausführung erfolgreich beendet ist FALSE FB wird ausgeführt TRUE...
Seite 176: System Information
9.4.10 System Information GetSysInfo Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest Systeminformationen aus dem Gerät aus. Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein. Der Aufruf jeder weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 177 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 Fehler ifm-Service-Center kontaktieren!
Seite 178: Touch
9.4.11 Touch DisableTouchScreen Baustein-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 nach einem Geräteneustart standardmäßig aktiviert. Der FB ist nur verfügbar für Geräte mit integriertem Touchscreen. Eingangsparameter Parameter Datentyp...
Seite 179 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-Instanz wird nicht ausgeführt • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 180 SetTouchOptimisationMode Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB aktiviert den Optimierungsmodus für eine bestimmte Betriebsbedingung. Der Anwender kann zwischen folgenden Betriebsbedingungen wählen: • Standardbetrieb • Betrieb mit Handschuhen • Betrieb bei Regen / Spritzwasser Innerhalb einer Anwendung darf nur eine Instanz des FBs aktiv sein.
Seite 181 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-Instanz wird nicht ausgeführt • ERR_INVALID_VALUE Fehler: Ungültiger Optimierungsmodus gewählt • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 182: System Time
9.4.12 System Time GetAvailableTimesZones Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB gibt die Anzahl und eine Liste der verfügbaren Zeitzonenkonfigurationen des Geräts aus. Eingangsparameter Parameter Datentyp Beschreibung Mögliche Werte xExecute BOOL Ausführung des FB steuern FALSE =>...
Seite 183 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-Instanz wird nicht ausgeführt • ERR_GET_TIMEZONES Fehler: Probleme beim Lesen der Zeitzonen-Infomrationen; Hersteller informieren • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 184 GetSysTime Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 185 • 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 Fehler ifm-Service-Center kontaktieren!
Seite 186 GetSysTimeCyclic Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB liest zyklisch im Intervall von 1000 ms 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 187 • 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 Fehler ifm-Service-Center kontaktieren!
Seite 188 SetSysTime Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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.
Seite 189 • ERR_SET_DATE_TIME Fehler: Fehler beim Schreiben von Datum und/oder Zeit • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 190 SetTimeZone Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der FB schreibt folgende Werte der Systemuhr des Geräts: • Zeitzone Der FB aktiviert / deaktiviert die Sommerzeit (Daylight Saving Time - DST) in Abhängigkeit von der eingestellten Zeitzone. Wenn die automatische Aktivierung / Deaktivierung der Sommerzeit nicht benötigt wird, dann eine Zeitzone ohne Sommerzeit wählen (z.
Seite 191 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-Instanz wird nicht ausgeführt • ERR_SET_TIMEZONES Fehler: Fehler beim Schreiben der Zeitzonen-Informationen • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 192 GetNTP_Settings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben. u Nur eine Instanz des FB innerhalb der Anwendung aufrufen! Eingangsparameter Parameter...
Seite 193 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_STATU Fehler: Fehler beim Lesen des NTP Running Status. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 194 SetNTP_Settings Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 weiteren FB-Instanz wird abgebrochen und eine Fehlermeldung ausgegeben.
Seite 195 Fehler: Fehler beim setzen der NTP-Server im System • ERR_GET_NTP_DAEMON_STATU 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 Fehler ifm-Service-Center kontaktieren!
Seite 196: Window Control
9.4.13 Window Control AnalogueCameraWindowControl Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 •...
Seite 197 Fehler beim Setzen des Fensters in den Hintergrund. BOTTOM • ERR_WM_CAPTURE_WINDOW Fehler beim Erstellen des Screenshots. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren! • ERR_CAMERA_START Fehler beim Starten der Kamera. • ERR_CAMERA_STOP Fehler beim Stoppen der Kamera. • ERR_CAMERA_SET_FLIP_ Fehler beim Einstellen der Konfiguration des Kamerabildes (Drehen und Spiegeln) ROTATION •...
Seite 198 IPCameraWindowControl Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 •...
Seite 199: Ausgangsparameter
Ausgangsparameter Parameter Datentyp Beschreibung Mögliche Werte xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehler FALSE kein Fehler aufgetreten aufgetreten ist oder der FB wird noch ausgeführt TRUE • Fehler aufgetreten • Aktion konnte nicht ausgeführt werden • Diagnoseinformatione n beachten eDiagInfo DIAG_INFO Diagnoseinformationen...
Seite 200: Diagnose-Codes
Bei Fehlermeldungen "ERR_", die während der Projektierung mit häufigem Ändern der Konfiguration 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-Center kontaktieren! • STAT_INACTIVE Zustand: FB/Funktion ist inaktiv.
Seite 201: Beschreibung
PDF_Viewer Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 über Seitenzahl •...
Seite 202 Parameter Datentyp Beschreibung Mögliche Werte xError BOOL Anzeige, ob bei der FB-Ausführung ein TRUE • Fehler aufgetreten Fehler aufgetreten ist • Aktion konnte nicht ausgeführt werden • Diagnoseinformati onen beachten Ò Liste unten (Diagnose-Codes) eDiagInfo DIAG_INFO Diagnoseinformationen xPrepared BOOL Zustand der FB-Ausgänge FALSE FB-Ausgänge ungültig;...
Seite 203 Fehler beim Setzen des Fensters in den Hintergrund. BOTTOM • ERR_WM_CAPTURE_WINDOW Fehler beim Erstellen des Screenshots. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-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.
Seite 204 • 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 Fehler ifm-Service-Center kontaktieren!
Seite 205 WindowControlBase Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmDevice_ecomatDisplay.library Symbol in CODESYS: Beschreibung Der 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 •...
Seite 206 Fehler beim Setzen der Position und Größe des Fensters. SIZE • ERR_WM_BRING_TO_TOP Fehler beim Setzen des Fensters in den Vordergrund. • ERR_WM_SEND_TO_ Fehler beim Setzen des Fensters in den Hintergrund. BOTTOM • ERR_WM_CAPTURE_WINDOW Fehler beim Erstellen des Screenshots. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 207: Enum
9.4.14 ENUM CAN_BAUDRATE (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert CAN_BAUDRATE Datenübertragungsrate KBAUD_20 20 Kilobaud der CAN-Schnittstelle KBAUD_33 33,3 Kilobaud KBAUD_50 50 Kilobaud KBAUD_83 83,3 Kilobaud KBAUD_100 100 Kilobaud KBAUD_125 125 Kilobaud KBAUD_250 250 Kilobaud KBAUD_500 500 Kilobaud KBAUD_666 666,6 Kilobaud KBAUD_800 800 Kilobaud KBAUD_1000...
Seite 208 Name Beschreibung Mögliche Werte Datentyp Wert eDAY_OF_WEEK Liste mit Wochentagen FRIDAY USINT SATURDAY USINT eETHERNET_INTERFACES (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eETHERNET_INTERFACES Liste der verfügbaren ETH_0 Ethernet-Schnittstelle 0 (eth0) Ethernet-Schnittstellen ETH_1 Ethernet-Schnittstelle 1 (eth1) eIP_CAMERA_ENCODING (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eIP_CAMERA_ENCODING...
Seite 209 eKEY_MAP_CODES (ENUM) Linux input Name Beschreibung Mögliche Werte Datentyp event code (dezimal) eKEY_MAP_CODES Liste der möglichen Standard- NONE Keine Auswahl UDINT Tastatur-Funktionen (MF2), ESCAPE Escape-Taste UDINT die einer Taste auf dem integrierten Tastenfeld MINUS UDINT zugewiesen werden können. ASTERISK UDINT SPACE Leertaste UDINT...
Seite 210 Linux input Name Beschreibung Mögliche Werte Datentyp event code (dezimal) eKEY_MAP_CODES Liste der möglichen Standard- KEY_Y UDINT Tastatur-Funktionen (MF2), KEY_Z UDINT die einer Taste auf dem integrierten Tastenfeld KEY_RETURN Return-Taste UDINT zugewiesen werden können. BACKSPACE Rück-Taste UDINT Tab-Taste UDINT PRINT Druck-Taste UDINT HOME...
Seite 211: Struct
eOBJECT_FLIP (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eOBJECT_FLIP Liste der verfügbaren NONE Keine Auswahl. Umkehreinstellungen für NORMAL Normaldarstellu analoge Videostreams. ng des Kamerabildes. FLIP Gespiegelte Darstellung des Kamerabildes. eOBJECT_ROTATION (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eOBJECT_ROTATION Liste der verfügbaren NONE Keine Auswahl.
Seite 212 stAUDIO_SETTINGS (STRUCT) Bezeichnung Datentyp Bedeutung Mögliche Werte Ò stMaster Master-Lautstärke 0...100 %; Startwert = 10 % stAUDIO_CHANNEL_VOLUME stSpeaker Lautstärke Lautsprecher 0...100 %; Startwert = 10 % stHeadPhone Lautstärke Kopfhörer 0...100 %; Startwert = 10 % stLineInToLineOut Lautstärke Aux LineIn to LineOut- 0...100 %;...
Seite 213 Parameter Datentyp Bedeutung Mögliche Werte tStreamTimeout TIME IP-Kamera: Stream-Timeout Standardwert: T#100MS Zeitverzögerung nach Unterbrechung des Kamera- T0#MS: Kein Timeout konfiguriert. Streams bis zum Auslösen der Das Kamerabild friert ein, wenn der Diagnosemeldung. Stream abbricht, bis der Stream wieder aktiv ist. >...
Seite 214 Bezeichnung Datentyp Bedeutung Mögliche Werte Standardwert uiYear UINT Jahr 2000...2099 2000 uiMonth UINT Monat 1...12 uiDay UINT 1...31 uiHour UINT Stunde 0...23 uiMinute UINT Minute 0...59 uiSeconds UINT Sekunde 0...59 eDayOfWeek Ò eDAY_OF_WEEK Wochentag Ò eDAY_OF_WEEK (ENUM) (ENUM) stETHERNET_BRIDGE_CONFIG (STRUCT) Bezeichnung Datentyp Bedeutung...
Seite 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...
Seite 216 Parameter Datentyp Bedeutung Standardwert eKey2_Right eKEY_MAP_CODES Gruppe 2, Taste 3, Navigationstaste eKEY_MAP_CODES.RIGHT (ENUM) rechts eKey2_Enter Gruppe 2, Taste 4, Navigationstaste eKEY_MAP_CODES.RETURN Enter/Return stLED_SETTINGS (STRUCT) Parameter Datentyp Bedeutung Mögliche Werte BOOL LED einschalten/ausschalten TRUE LED einschalten FALSE LED ausschalten (Standardwert) udiColor UDINT RGB-Farbwert für die LED RGB: 16#00RRGGBB mit...
Seite 217 stNTP_SETTINGS Element Datentyp Beschreibung Mögliche Werte xEnable BOOL Status und Befehl zum Aktivieren / FALSE Standardwert Deaktivieren des NTP-Services. deaktivieren / 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 IP-Adressen oder Servernamen (maximal 11).
Seite 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 und FALSE => TRUE Aktion ausführen zum ersten Auftreten des Sichtextes FALSE springen.
Seite 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 vorhanden FALSE Kein Touchscreen ja / nein vorhanden TRUE Touchscreen vorhanden stSYS_INFO_EXTENDED (STRUCT) Element...
Seite 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...
Seite 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ür z.B. '/home/cds-apps/ Screenshot. ScreenShot.jpg' stWINDOW_CONTROLS (STRUCT) Parameter Datentyp Bedeutung Mögliche Werte xVisible BOOL Fenster sichtbar / unsichtbar schalten.
Seite 222: Global
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...
Seite 223: Beschreibung
Symbol in CODESYS: Beschreibung Der 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 einmal ausgeführt sonst. keine Auswirkungen auf FB-Abarbeitung sFileName STRING(255) Verzeichnispfad und Name der Datei...
Seite 224 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 von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 225 FileCopy Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB kopiert eine Datei oder mehrere Dateien von einem Quellverzeichnis auf dem Gerät in ein Zielverzeichnis auf dem Gerät. Der FB nutzt den Linux-Befehl "cp -rf <sSource> <sDestin>". Eingangsparameter Parameter Datentyp...
Seite 226: Diagnose-Codes
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 von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 227 Copy_Device_To_USB Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB kopiert eine Datei oder mehrere Dateien von einem Quellverzeichnis auf dem Gerät in ein Zielverzeichnis auf einem USB-Speicher. u Der FB nutzt den Linux-Befehl "cp -rf < sDevicePath > < sUSBpath >". Eingangsparameter Parameter Datentyp...
Seite 228 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 von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 230 Copy_USB_To_Device Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB kopiert eine Datei oder mehrere Dateien von einem USB-Speicher in ein Zielverzeichnis auf dem Gerät. u Der FB nutzt den Linux-Befehl "cp -rf < sUSBpath > < sDevicePath >". Eingangsparameter Parameter Datentyp...
Seite 231 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 von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 233 SyncFileMemory Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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...
Seite 234 Zustand: FB/Funktion wird gerade ausgeführt. • STAT_DONE Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_NOT_SUPPORTED Fehler: Ungültiger Funktionsaufruf; Funktion wird nicht unterstützt. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 235: Parameter File
9.5.2 Parameter File WriteParmSingleAsync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 0000000001 0000000123...
Seite 236 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
Seite 237 ReadParmSingleAsync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 und rechtsbündig gespeichert sein.
Seite 238 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
Seite 239: Log File
9.5.3 Log File ReadCSV8Byte Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 den Zeitstempel. Die CSV-Datei muss mit dem FB (Ò WriteCSV8Byte / 243) erzeugt worden sein.
Seite 240 Parameter Datentyp Bedeutung Mögliche Werte xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehler FALSE kein Fehler aufgetreten aufgetreten ist oder der FB wird noch ausgeführt TRUE • Fehler aufgetreten • Aktion konnte nicht ausgeführt werden • Diagnoseinformatio nen beachten Ò...
Seite 241 ReadCSVData Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 den Zeitstempel.
Seite 242 • STAT_RESET Zustand: FB/Funktion führt eine RESET-Operation durch. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_NO_OBJECT Fehler: Datei nicht vorhanden. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 243 WriteCSV8Byte Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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). Nachdem der Datensatz geschrieben wurde, inkrementiert der FB automatisch den Pointer zum nächsten Array in der Datenstruktur.
Seite 244 Parameter Datentyp Bedeutung Mögliche Werte xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließt Datei • alle Ausgänge werden zurückgesetzt xTrigger BOOL Aktion auslösen FALSE => TRUE FB liest gewählten Datensatz sonst. keine Aktion sFileName STRING(255) Verzeichnispfad und Name der Datei z.B.
Seite 245 • STAT_READY Zustand: Datei bereit für getriggerte Schreib-/Lesezugriffe • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
Seite 246 WriteCSV8ByteHeader Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB schreibt die Kopfzeile in eine CSV-Datei. Die Kopfzeile wird immer in den Bytes 0 bis 53 der Datei geschrieben. Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte xExecute BOOL Ausführung des FB steuern...
Seite 247 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_NO_OBJECT Fehler: Datei nicht vorhanden.
Seite 248 WriteCSVData_Linear Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 den •...
Seite 249 Parameter Datentyp Bedeutung Mögliche Werte xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließt Datei • alle Ausgänge werden zurückgesetzt xTrigger BOOL Aktion auslösen FALSE => TRUE FB liest gewählten Datensatz sonst. keine Aktion sFileName STRING(255) Verzeichnispfad und Name der Datei z.B.
Seite 250 • ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler.. • ERR_NO_OBJECT Fehler: Datei nicht vorhanden. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-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 : •...
Seite 251 WriteCSVData_Ring Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 den Datensatz sCSVData in die geöffnete Datei sFileName .
Seite 252 Parameter Datentyp Bedeutung Mögliche Werte xExecute BOOL Ausführung des FB steuern TRUE => FALSE • FB schließt Datei • alle Ausgänge werden zurückgesetzt xTrigger BOOL Aktion auslösen FALSE => TRUE FB liest gewählten Datensatz sonst. keine Aktion sFileName STRING(255) Verzeichnispfad und Name der Datei z.B.
Seite 253 • ERR_ASYNC_TASK Fehler: Asynchroner Task liefert einen Fehler.. • ERR_NO_OBJECT Fehler: Datei nicht vorhanden. • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-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 : •...
Seite 254 WriteCSVHeader Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE with Trigger Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB schreibt die Kopfzeile in eine CSV-Datei, die anschließend mit dem FB WriteCSVData_Linear oder dem FB WriteCSVData_Ring geschrieben wird. Wenn die an sFileName angegebene Datei bereits existiert, wird der Dateianfang mit der Länge des an sHeader angegebenen Strings überschrieben.
Seite 255 Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; 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 Fehler ifm-Service-Center kontaktieren!
Seite 256: Support
9.5.4 Support Buffer_To_String Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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, dann schreibt er die nachfolgenden Daten in eine neue Array-Zeile.
Seite 257 Parameter Datentyp Bedeutung Mögliche Werte xError BOOL Anzeige, ob bei der FB-Ausführung ein Fehler FALSE kein Fehler aufgetreten aufgetreten ist oder der FB wird noch ausgeführt TRUE • Fehler aufgetreten • Aktion konnte nicht ausgeführt werden • Diagnoseinformatio nen beachten eDiagInfo DIAG_INFO Diagnoseinformationen...
Seite 258 GetFileSizeAsync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der 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 einmal ausgeführt sonst. keine Auswirkungen auf FB-Abarbeitung sFileName STRING(255) Verzeichnispfad und Name der Datei...
Seite 259 Parameter Datentyp Bedeutung Mögliche Werte hFileHand RTS_IEC_ Dateibeschreibung des Laufzeitsystems < 1 Fehler HANDLE sonst. kein Fehler xwFileSize XWORD aktuelle Dateigröße der Datei (in Bytes) 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.
Seite 260 GetMemoryInfoAsync Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Der FB gibt detailierte Informationen über die Speicherbelegung und den verfügbaren Speicher eines Verzeichnisses aus (z. B. /data). Der FB speichert die Informationen in einer Textdatei, die den gleiche Name besitzt wie der Wert an "eDirName". Die Textdateien werden in folgenden Verzeichnissen gespeichert: eDirName Speicherort...
Seite 261 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_FILE_SYSTEM Fehler: Dateioperation fehlgeschlagen. • ERR_NO_OBJECT Fehler: Datei nicht vorhanden. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren!
Seite 262: Functions
9.5.5 Functions ByteArray_To_String Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion liest ein Byte Array ein, verkettet die Werte und gibt sie als Zeichenkette aus. Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte abyInData ARRAY Array mit Eingangsdaten pro Byte: [0...63] OF BYTE 0x00 ...
Seite 263 DW_To_4Byte Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion konvertiert ein DWORD in ein Array mit 4 Bytes. Beispiel: DWORD: 0xFFEEDDCC ARRAY[0..3] OF BYTE: 0xFF | 0xEE | 0xDD | 0xCC Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte dwInData DWORD Daten...
Seite 264 Pack2Byte_To_Word Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion konvertiert ein Array aus 2 Bytes zu einem Wort. Beispiel: aInData[0] = 0x00 aInData[1] = 0xAA Pack2Byte_To_Word = 0xAA00 Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte abyInData ARRAY Array mit Eingangsdaten pro Byte: [0...1] OF BYTE...
Seite 265 Pack4Byte_To_DW Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion konvertiert ein Array aus 4 Bytes in ein Doppelwort. Beispiel: aInData[0] = 0x00 aInData[1] = 0x11 aInData[2] = 0xAA aInData[3] = 0xFF Pack4Byte = 0xFFAA1100 Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte...
Seite 266 RTC_To_String Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion liest die geräteinterne Echtzeituhr (RTC) und gibt die Laufzeit in Sekunden seit dem letzten Systemstart als String aus. Ausgangsparameter Parameter Datentyp Bedeutung Mögliche Werte z.B. 02.08.2016 08:59:03 RTC_To_String STRING Aktuelle Zeit im Format...
Seite 267 Word_To_2Byte Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion konvertiert ein WORD in ein Array mit 2 Bytes. Beispiel: wInData = 0xFFEE Word_To_2Byte[0] = 0xEE Word_To_2Byte[1] = 0xFF Eingangsparameter Parameter Datentyp Bedeutung Mögliche Werte wInData WORD Daten 0x0000 ...
Seite 268 _8Byte_To_CSV Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die 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 sind durch eine Komma getrennt.
Seite 269 ANY_TYPE_TO_STRING Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die 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 dem Datenwert erscheint.
Seite 270 ifmCONCAT Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die 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 Zeichen und ist definiert in der globalen Konstante ifmGCL.uiGenericLogSizeMax . (Ò ifmGCL (GVL) / 275) Eingangsparameter Parameter...
Seite 271 ifmFIND Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion gibt die Position des Strings sStr2 im String sStr1 zurück. Die Suche startet an uiPosition . u Die String-Länge der verwendeten Strings beträgt mehr als die standardmäßigen 255 Zeichen und ist definiert in der globalen Konstante ifmGCL.uiGenericLogSizeMax .
Seite 272 ifmMID Baustein-Typ: Funktion (FUN) Verhaltensmodell: Bibliothek: ifmFileUtil.library Symbol in CODESYS: Beschreibung Die Funktion liest einen Teilstring eines anderen Strings aus. u Die String-Länge der verwendeten Strings beträgt mehr als die standardmäßigen 255 Zeichen und ist definiert in der globalen Konstante ifmGCL.uiGenericLogSizeMax . (Ò ifmGCL (GVL) / 275) Beispiel: uiPosition...
Seite 273: Enum
9.5.6 ENUM eCSVmode (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eCSVmode Schreibmodus für CSV-Datei NONE LINEAR RING eFileSystem (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert eFileSystem Verzeichnispfade für das ROOT Einbinden von Geräten und /dev Dateien TMPFS /tmpfs HOME /home NAND_FLASH_1GB /data FONTS /opt/qt-x.y.z/lib/fonts...
Seite 274: Struct
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)
Seite 275: Globalconstants
Bezeichnung Datentyp Bedeutung Mögliche Werte xHeaderSet BOOL Zeigt an, ob ein Header in die Datei geschrieben FALSE Header wurde wurde (FB WriteCSVHeader) noch nicht geschrieben. udiDataSetNbMax UDINT Maximale Anzahl an Datensätzen, die im RING- Mode in die Datei geschrieben werden (FIFO). stSEPARATOR_CONFIG (STRUCT) Konfiguration des CSV-Trennzeichens.
Seite 276: Bibliothek Ifmrawcan.library
9.6 Bibliothek ifmRawCAN.library Die Bibliothek enthält POUs und Datenstrukturen für die Programmierung der CAN-Layer-2-Ebene der CAN-Schnittstellen des Geräts unter CODESYS. 9.6.1 CAN_Enable Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB aktiviert die CAN-Layer2-Funktionen einer CAN-Schnittstelle mit einer bestimmten Übertragungsrate.
Seite 277 Ausgänge liegen gültige Ergebnisse an. • ERR_BUS_OFF Fehler: CAN-Schnittstelle ist im Zustand "BUS OFF" • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_BAUDRATE_INVALID Fehler: Gewünschte Baudrate kann nicht eingestellt werden, da sie ungültig ist _OR_ALREADY_SET oder schon eine andere Baudrate definiert wurde.
Seite 278: Can_Recover
9.6.2 CAN_Recover Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der 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. •...
Seite 279 Zustand: FB/Funktion wurde erfolgreich ausgeführt und beendet. An den Ausgänge liegen gültige Ergebnisse an. • ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_UNDEFINED Fehler: Unbekannter Fehler...
Seite 280: Can_Remoterequest
9.6.3 CAN_RemoteRequest Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: EXECUTE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB sendet die Anforderung für eine CAN-Remote-Nachricht in ein CAN-Netzwerk. Die Daten der Antwortnachricht gibt der FB in ein Array aus. Der FB unterstützt Standard- und Extended-Frames. Eingangsparameter Parameter Datentyp...
Seite 281 übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren! • ERR_INACTIVE_INTERFACE Fehler: Gewählter CAN-Kanal ist deaktiviert.
Seite 282: Can_Remoteresponse
9.6.4 CAN_RemoteResponse Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB antwortet als Reaktion auf eine Anforderung einer CAN-Remote-Nachricht und sendet die angeforderten Daten in ein CAN-Netzwerk. So lange der FB aktiviert ist, antwortet er auf jede an ihn gerichtete RemoteRequest-Nachricht (Automatisches Antworten).
Seite 283 Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 284: Can_Rx
9.6.5 CAN_Rx Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der 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 und speichert sie in einem FIFO-Pufferspeicher. Die Anzahl der empfangenen CAN-Nachrichten wird angezeigt.
Seite 285 Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 286: Can_Rxmask
9.6.6 CAN_RxMask Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB empfängt CAN-Nachrichten eines nicht zusammenhängenden Bereichs. Der Bereich wird definiert ü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...
Seite 287: Ausgangsparameter
• ERR_BUFFER_OVERFLOW Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 288: Can_Rxrange
9.6.7 CAN_RxRange Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB empfängt CAN-Nachrichten eines zusammenhängenden Bereichs. Der Bereich wird definiert durch eine Ober- und eine Untergrenze. Für die Definition dieses Bereichs gelten folgende Regeln: Unter- und Obergrenze: Standard Frames: 0 ...
Seite 289 Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 290: Can_Rxrangeext
9.6.8 CAN_RxRangeExt Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB empfängt CAN-Nachrichten eines zusammenhängenden Bereichs mit Extended Identifier (29 Bit). Der Bereich wird definiert durch eine Ober- und eine Untergrenze. Für die Definition dieses Bereichs gelten folgende Regeln: Unter- und Obergrenze: 0 ...
Seite 291 Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 292: Can_Status
9.6.9 CAN_Status Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der FB liest den aktuellen Status des CAN-Netzwerks und gibt folgende Status- und DiagnoseInformationen aus: • Baudrate • Zustand des CAN-Busses (Zustandsdiagramm) • Zähler Rx-Fehler • Zähler Tx-Fehler •...
Seite 293 Warnung überschritten (uiErrorCntTx > 96) TRUE Warnung udiCountRx UDINT Anzahl der erkannten CAN- 0...4294967295 Nachrichten (unabhängig von konfigurierten Rx-Nachrichten) usiBusLoad USINT Buslast (in Prozent) 0...100 Diagnose-Codes: • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 294: Can_Tx
9.6.10 CAN_Tx Baustein-Typ: Funktionsbaustein (FB) Verhaltensmodell: ENABLE Bibliothek: ifmRawCAN.library Symbol in CODESYS: Beschreibung Der 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 der SPS-Zyklus haben darauf keinen Einfluss.
Seite 295 Fehler: Übertragungspuffer voll; CAN-Nachricht kann Pufferspeicher nicht beschreiben und wird nicht übertragen • ERR_INVALID_VALUE Fehler: mind. 1 ungültiger Eingangsparameter oder ungültige Kombination von Eingangsparametern; Funktionsaufruf wurde abgebrochen. • ERR_INTERNAL Fehler: Interner Systemfehler ifm-Service-Center kontaktieren! • ERR_UNDEFINED Fehler: Unbekannter Fehler ifm-Service-Center kontaktieren!
Seite 296: Bus_State (Enum)
9.6.11 BUS_STATE (ENUM) Name Beschreibung Mögliche Werte Datentyp Wert BUS_STATE Zustand der CAN- UNDEFINED Zustand nicht verfügbar oder nicht Schnittstelle konfiguriert ERROR_ACTIVE Fehlerzähler Tx und Rx <= 96 ERROR_PASSIVE Fehlerzähler Tx oder Rx > 127 und Fehlerzähler Tx oder Rx < 255 ERROR_WARNING Fehlerzähler Rx oder Tx >...
Seite 297: Anhang
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 Rahmen der Subnetzmaske identisch sind, können miteinander kommunizieren. Regel: Bei Teil-Subnetzmaske = 255 müssen die Teil-IP-Adressen identisch sein.

Diese Anleitung auch für:

Cr1058 Cr1059 Cr1074 Cr1075 Cr1076 Cr1077 ... Alle anzeigen

ifm ecomatDisplay Programmierhandbuch

1 Vorbemerkung

2 Sicherheitshinweise

3 Installation

4 Schnelleinstieg

5 Gerätekonfiguration

6 Systemkonfiguration

7 Programmierung

8 Betrieb

9 Ifm-Funktionsbibliotheken

10 Anhang

Quicklinks

Verwandte Anleitungen für ifm ecomatDisplay

Inhaltszusammenfassung für ifm ecomatDisplay

Diese Anleitung auch für:

Inhaltsverzeichnis