System_read-Baustein

Kurz-Information

NameSystem_read
→POE-Typ→Funktion
KategorieWeitere Systembausteine, Bausteine zum Aufrufen von Systemfunktionen, Baustein mit interner Fehlerdiagnose
Grafische Schnittstelle

Verfügbar ab
  • Version 1.13.0 (für logi.CAD 3 ) und Version 2.3.901 von logi.RTS – Anfangsvariante: data als VAR_INPUT
    (warning) Dieser Baustein wird nur für →Raspberry Pi unterstützt.
  • Version 1.54.0 (für logi.CAD 3 ) und Version 3.0.9 von logi.RTS – Erweiterung: zusätzlicher Ausgang rc, data als VAR_IN_OUT
    (warning) Dieser Baustein wird nur für die integrierte SPS und für Raspberry Pi unterstützt.
  • Version 1.109.0 (für logi.CAD 3 ) und Version 3.19.0 von logi.RTS
    (warning) 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 von logi.RTS
    (warning) Dieser Baustein wird für die integrierte SPS, bei Verwendung der Plattform LinuxX86 und die folgenden Zielsysteme unterstützt:

    Raspberry Pi, →MICA→phyBOARD-Regor→phyBOARD-Wega→µMIC.200

  • Version 2.0.5 (für Bibliothek System) – grafische Schnittstelle mit Ein-/Ausgangsvariable

Funktionalität

Der Baustein liest bis zu 64 Bytes von einem definierten Datei-Deskriptor.

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→DatentypBeschreibung
Eingänge:fdDINTder Datei-Deskriptor
countDINTAnzahl der Bytes, die in einem Zug gelesen werden sollen
Ein-/Ausgänge
(VAR_IN_OUT):
dataARRAY[0..63] OF BYTEdie gelesenen Bytes
Ausgänge:rcDINT

Ergebniscode:

  • 0 = kein Fehler  
  • -2 = ungültige Anzahl der Bytes  
  • -3 = fehlgeschlagener Systemaufruf  

errnoDINT

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 (für Raspberry Pi gültig): siehe http://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/Errors/unix_system_errors.html

Ergebniswert:LINTliefert den Ergebniswert des Systemaufrufs zum Lesen

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.
Der Ausgang ENO für diesen Baustein liefert den Wert TRUE (oder eine Entsprechung) nur, sofern die definierte Anzahl an Bytes auch gelesen wurden.

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) gesetzt. 

Beispiel für Verwendung im ST-Editor

Derzeit ist kein Beispiel verfügbar.

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.