IrDA: Lesen - Funktion

Modus gibt die Funktionsweise der Leseoperation an.

Verbindungs-ID ist eine Referenz zur eindeutigen Kennzeichnung der IrDA-Verbindung.

Zu lesende Bytes gibt an, wie viele Bytes die Funktion vom IrDA-Gerät lesen soll. Für größenveränderliche Nachrichten empfiehlt sich eine der folgenden Vorgehensweisen:

• Am Beginn der Nachrichten sollte ein Header fester Größe stehen, in dem die Nachricht beschrieben wird. Dieser Header kann zum Beispiel eine Zahl enthalten, die angibt, was für eine Nachricht folgt, und eine Zahl, die die Größe der Nachricht angibt. Sowohl Server als auch Client empfangen Nachrichten durch Ausstellen einer Lesefunktion von 8 Byte (vorausgesetzt, jede der Zahlen ist ein 4-Byte-Integer), die in zwei Zahlen umgewandelt werden. Anhand der zweiten Zahl wird angezeigt, wie viele Bytes für die restliche Nachricht eine zweite Lesefunktion passieren werden. Sobald der zweite Lesevorgang abgeschlossen ist, springt jede Seite zurück zur Lesefunktion für den 8 Byte großen Header. Diese Vorgehensweise ist am flexibelsten, erfordert jedoch zum Empfang jeder Nachricht zwei Lesevorgänge. In der Praxis wird der zweite Lesevorgang in der Regel unmittelbar nach dem Erstellen der Nachricht mit einer Schreibfunktion beendet.
• Halten Sie bei jeder Nachricht eine feste Größe ein. Wenn die Nachricht kleiner als angegeben ist, füllen Sie die Nachricht auf die angegebene Größe auf. Das Empfangen von Nachrichten ist damit etwas weniger aufwändig, da nur ein Lesevorgang benötigt wird, jedoch werden dadurch auch zuweilen unnötige Daten übertragen.
• Senden Sie Nur-Text-Nachrichten, das heißt, jede Nachricht wird durch einen Wagenrücklauf und zwei Zeichen für einen Zeilenvorschub beendet. Die Lesefunktion hat einen Eingang, mit dem das VI beim Befehl CRLF so lange Text liest, bis ein Wagenrücklauf gefolgt von einem Zeilenvorschub angetroffen wird. Diese Form der Übertragung kann zwar bei mehreren aufeinander folgenden Zeilenumschaltungen und -umbrüchen in der Mitte des Textes zu Problemen führen, ist jedoch bei Internetprotokollen wie POP3, FTP oder HTTP üblich.

Timeout (ms) gibt an, wie viele Millisekunden die Funktion auf Bytes von einem IrDA-Gerät in einem drahtlosen Netzwerk warten soll, bevor sie einen Fehler ausgibt. Der Standardwert lautet 25.000 ms. Bei –1 wird kein Timeout vorgegeben.

Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

Verbindungs-ID (Ausgang) eine die Referenz zur eindeutigen Kennzeichnung der IrDA-Verbindung. Sie dient in nachfolgenden Aufrufen der IrDA-Funktion als Referenz auf diese Verbindung. Verbindungs-ID (Ausgang) ist immer mit Verbindungs-ID identisch.

Daten (Ausgang) enthält die von einem IrDA-Gerät gelesenen Daten in Form eines Strings oder Daten-Strings. Mit der Funktion String deserialisieren können die Daten in den richtigen Datentyp konvertiert werden. Sie können auch die Funktion Unflatten From XML verwenden, um Daten aus dem XML-Format zu konvertieren.

Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.