SERIALRECEIVE(buffer as string or integer arrray , numChars as integer, timeout as double)
Beschreibung
Empfängt eingehende Daten vom seriellen Port und speichert diese in buffer. Diese Funktion kann verwendet werden, um auf Dateneingänge zu warten oder um Daten abzuholen, wenn das Programm durch den NsbSerialIn Event informiert worden ist. Die Funktion stoppt, nachdem sie wenigstens ein numChars Zeichen empfangen hat und sie stoppt den weiteren Datentransfer, wenn die Anzahl der empfangenen Zeichen größer ist, als die Puffergröße, die mittels SerialSet Funktion eingestellt wurde. Der ganzzahlige Fehlercode wird bei SerialOpen näher beschrieben. Zum Löschen des Empfangspuffers, verwenden Sie SerialSend(„“,0).
Wird SerialReceive als Ergebnis eines NsbSerialIn Events aufgerufen, beendet es seine Ausführung, nachdem alle Zeichen eingelesen worden sind, auch dann, wenn noch kein numChars Zeichen empfangen wurde. Der Timeout-Wert wird ignoriert. Um festzustellen, wie viele Zeichen im seriellen Eingabepuffer stehen, kann die Funktion SysInfo verwendet werden.
Wenn die Funktion SerialReceive nicht als Ergebnis eines NsbSerialEvent aufgerufen wird, kehrt sie zum Hauptprogramm zurück, sobald numChars empfangen wird oder die Timeout Zeitspanne (in Sekunden) abgelaufen ist. Die Timeout Zeitspanne kann auch Bruchteile von Sekunden umfassen. Im Falle eines Timeouts gibt die Funktion den Code 773 zurück, zusammen mit allen Zeichen, die bis zu diesem Zeitpunkt im Buffer aufgelaufen sind.
Ist der Puffer als Integer Array definiert, so wird der ASCII Wert jedes Bytes in einem Element des Arrays abgelegt. Auf diese Weise lassen sich auch Null Charakter (hex 00) empfangen.
Beispiel
Err=SerialReceive(inputString, 200, .5) 'non event case