System_open-Baustein

Kurz-Information

Name

System_open

→POE-Typ

→Funktion

Kategorie

Weitere Systembausteine, Bausteine zum Aufrufen von Systemfunktionen, Baustein mit interner Fehlerdiagnose

Grafische Schnittstelle

Verfügbar ab

  • Version 1.13.0 (für Neuron Power Engineer) und Version 2.3.901 des →Laufzeitsystems – Anfangsvariante
    (Warnung) Dieser Baustein wird nur für →Raspberry Pi unterstützt.

  • Version 1.28.0 (für Neuron Power Engineer) und Version 2.3.1301 des →Laufzeitsystems – Erweiterung: zusätzlicher Eingang mode

    (Warnung) Dieser Baustein wird nur für →Raspberry Pi unterstützt.

  • Version 1.54.0 (für Neuron Power Engineer) und Version 3.0.9 des →Laufzeitsystems – Erweiterung: zusätzlicher Ausgang rc
    (Warnung) Dieser Baustein wird nur für die integrierte SPS und Raspberry unterstützt.

  • Version 1.109.0 (für Neuron Power Engineer) und Version 3.19.0 des →Laufzeitsystems
    (Warnung) Dieser Baustein wird nur für die integrierte SPS, für Raspberry Pi und bei Verwendung der Plattform LinuxX86 unterstützt.

  • Version 2.0.4 (für Bibliothek System) und Version 3.23.0 des →Laufzeitsystems
    (Warnung) Dieser Baustein wird nur für die integrierte SPS und bei Verwendung der Plattform LinuxX86 unterstützt.
    Zusätzlich wird der Baustein für die folgenden Zielsysteme unterstützt: Raspberry Pi, →phyBOARD-Regor, →phyBOARD-Wega, →µMIC.200

Funktionalität

Der Baustein bereitet eine Datei, ein Gerät oder eine Gerätedatei vor. Diese werden durch nachfolgende Systemaufrufe verwendet, z.B. durch System_ioctl-Baustein, System_read-Baustein oder System_write-Baustein.

Vorausgesetzte Kenntnisse

Für die effektive Verwendung dieses Bausteins müssen Sie mit der Funktionsweise des zugrunde liegenden Systemaufrufs des Betriebsystems vertraut sein, das auf der SPS verwendet wird.

Eingänge, Ausgänge, Ergebniswert

 

Bezeichner

→Datentyp

Beschreibung

Eingänge:

pathname

STRING

Zeichenfolge, die die Ressource repräsentiert

flags

DINT

Zugriffsmodus und/oder Erstellungsoptionen
Gültige Werte für Windows sind z.B.: 0 = nur Lesen, 1 = nur Schreiben, 2 = Lesen und Schreiben.

Mögliche Werte für Windows finden Sie unter: http://www.delorie.com/djgpp/doc/incs/fcntl.h
Mögliche Werte für Linux finden Sie unter: http://unix.superglobalmegacorp.com/Net2/newsrc/sys/fcntl.h.html

Sie können die Werte durch den IOR-Baustein verknüpfen (siehe Beispiel unten)

mode

DINT

Dateisystem-Berechtigungen (optional; POSIX-Style)
Dieser Eingang ist verpflichtend, falls eine neue Datei zu erzeugen ist.

Mögliche Werte für Windows finden Sie unter: https://www.rpi.edu/dept/cis/software/g77-mingw32/include/sys/stat.h
Mögliche Werte für Linux finden Sie unter: http://unix.superglobalmegacorp.com/Net2/newsrc/sys/stat.h.html

Ausgänge:

rc

DINT

Ergebniscode:

0 = kein Fehler

-1 = ungültiger Datei-Deskriptor

-3 = fehlgeschlagener Systemaufruf

errno

DINT

der Fehlercode, der vom Systemaufruf geliefert wird

Windows-Standardwerte (für die integrierte SPS gültig): siehe https://msdn.microsoft.com/en-us/library/t3ayayh1.aspx
Linux-Standardwerte(z.B. für Raspberry Pi gültig): siehe http://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/Errors/unix_system_errors.html

Ergebniswert:

–

DINT

liefert den Datei-Deskriptor im Erfolgsfall

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

Interne Fehlerdiagnose für Baustein

Der Baustein prüft die folgenden Fehlerfälle:

  • Der Systemdienst wurde nicht geladen.

  • Der Ergebniswert des Bausteins ist ein negativer Wert.

  • Der Ergebniscode des Funktionsaufrufs entspricht einem Fehler (Ausgang rc ≠ Wert 0).

In einem solchen Fehlerfall wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt.

Beispiel für Verwendung im ST-Editor

Derzeit ist kein Beispiel verfügbar.