HALCON Website / HALCON Operator-Referenz / System / Seriell
KlassenKlassenKlassenKlassen | | | | Operatoren

read_serialread_serialReadSerialread_serialReadSerialReadSerial (Operator)

Name

read_serialread_serialReadSerialread_serialReadSerialReadSerial — Lesen von einem seriellen Gerät.

Signatur

read_serial( : : SerialHandle, NumCharacters : Data)

Herror read_serial(const Hlong SerialHandle, const Hlong NumCharacters, Hlong* Data)

Herror T_read_serial(const Htuple SerialHandle, const Htuple NumCharacters, Htuple* Data)

Herror read_serial(const HTuple& SerialHandle, const HTuple& NumCharacters, Hlong* Data)

Herror read_serial(const HTuple& SerialHandle, const HTuple& NumCharacters, HTuple* Data)

HTuple HSerial::ReadSerial(const HTuple& NumCharacters) const

void ReadSerial(const HTuple& SerialHandle, const HTuple& NumCharacters, HTuple* Data)

HTuple HSerial::ReadSerial(Hlong NumCharacters) const

void HOperatorSetX.ReadSerial(
[in] VARIANT SerialHandle, [in] VARIANT NumCharacters, [out] VARIANT* Data)

VARIANT HSerialX.ReadSerial([in] Hlong NumCharacters)

static void HOperatorSet.ReadSerial(HTuple serialHandle, HTuple numCharacters, out HTuple data)

HTuple HSerial.ReadSerial(int numCharacters)

Beschreibung

read_serialread_serialReadSerialread_serialReadSerialReadSerial versucht, NumCharactersNumCharactersNumCharactersNumCharactersNumCharactersnumCharacters von dem seriellen Gerät, das durch SerialHandleSerialHandleSerialHandleSerialHandleSerialHandleserialHandle angegeben wird, zu lesen. Die gelesenen Daten werden in DataDataDataDataDatadata als Tupel von Integer-Werten zurückgegeben. Dies erlaubt das Lesen von NUL-Zeichen, die sonst als String-Ende interpretiert würden. Falls der Timeout des Gerätes mit set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam auf einen Wert größer als 0 gesetzt wurde, wird so lange auf die Ankunft des ersten Zeichens gewartet, wie durch den Timeout angegeben ist, ansonsten kehrt die Funktion sofort zurück. In jedem Fall werden die zur Zeit der Rückkehr verfügbaren Zeichen zurückgeliefert. D.h., es können weniger Zeichen als angefordert zurückgeliefert werden. Dies kann über die Länge des Tupels DataDataDataDataDatadata überprüft werden.

Parallelisierung

Parameter

SerialHandleSerialHandleSerialHandleSerialHandleSerialHandleserialHandle (input_control)  serial_id → HSerial, HTupleHTupleHSerial, HTupleHSerialX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle der seriellen Schnittstelle.

NumCharactersNumCharactersNumCharactersNumCharactersNumCharactersnumCharacters (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der zu lesenden Zeichen.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 10, 20, 40, 100

DataDataDataDataDatadata (output_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Gelesene Zeichen (als Integer-Tupel).

Ergebnis

Wenn die Parameter korrekt sind und das Lesen vom seriellen Gerät erfolgreich war, liefert read_serialread_serialReadSerialread_serialReadSerialReadSerial den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_serialopen_serialOpenSerialopen_serialOpenSerialOpenSerial

Siehe auch

write_serialwrite_serialWriteSerialwrite_serialWriteSerialWriteSerial

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH