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

open_serialopen_serialOpenSerialopen_serialOpenSerialOpenSerial (Operator)

Name

open_serialopen_serialOpenSerialopen_serialOpenSerialOpenSerial — Öffnen eines seriellen Gerätes.

Signatur

open_serial( : : PortName : SerialHandle)

Herror open_serial(const char* PortName, Hlong* SerialHandle)

Herror T_open_serial(const Htuple PortName, Htuple* SerialHandle)

Herror open_serial(const HTuple& PortName, Hlong* SerialHandle)

void HSerial::OpenSerial(const HTuple& PortName)

void OpenSerial(const HTuple& PortName, HTuple* SerialHandle)

void HSerial::HSerial(const HString& PortName)

void HSerial::HSerial(const char* PortName)

void HSerial::OpenSerial(const HString& PortName)

void HSerial::OpenSerial(const char* PortName)

void HOperatorSetX.OpenSerial(
[in] VARIANT PortName, [out] VARIANT* SerialHandle)

void HSerialX.OpenSerial([in] BSTR PortName)

static void HOperatorSet.OpenSerial(HTuple portName, out HTuple serialHandle)

public HSerial(string portName)

void HSerial.OpenSerial(string portName)

Beschreibung

open_serialopen_serialOpenSerialopen_serialOpenSerialOpenSerial öffnet ein serielles Gerät. Der Name des Geräts wird in PortNamePortNamePortNamePortNamePortNameportName. Er ist Betriebssystem-abhängig: auf Windows-Rechnern wird typischerweise 'COM1'"COM1""COM1""COM1""COM1""COM1"-'COM4'"COM4""COM4""COM4""COM4""COM4" verwendet, während die seriellen Schnittstellen unter unixartigen Systemen normalerweise '/dev/tty*'"/dev/tty*""/dev/tty*""/dev/tty*""/dev/tty*""/dev/tty*" heißen. Die Parameter der seriellen Schnittstelle, wie die Übertragungsgeschwindigkeit oder die Anzahl der Datenbits, sind nach dem Öffnen auf die Standardwerte des jeweiligen Gerätes gesetzt. Sie können mit set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam gesetzt oder verändert werden.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

PortNamePortNamePortNamePortNamePortNameportName (input_control)  filename → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der seriellen Schnittstelle.

Defaultwert: 'COM1' "COM1" "COM1" "COM1" "COM1" "COM1"

Wertevorschläge: 'COM1'"COM1""COM1""COM1""COM1""COM1", 'COM2'"COM2""COM2""COM2""COM2""COM2", 'COM3'"COM3""COM3""COM3""COM3""COM3", 'COM4'"COM4""COM4""COM4""COM4""COM4", '/dev/ttya'"/dev/ttya""/dev/ttya""/dev/ttya""/dev/ttya""/dev/ttya", '/dev/ttyb'"/dev/ttyb""/dev/ttyb""/dev/ttyb""/dev/ttyb""/dev/ttyb", '/dev/tty00'"/dev/tty00""/dev/tty00""/dev/tty00""/dev/tty00""/dev/tty00", '/dev/tty01'"/dev/tty01""/dev/tty01""/dev/tty01""/dev/tty01""/dev/tty01", '/dev/ttyd1'"/dev/ttyd1""/dev/ttyd1""/dev/ttyd1""/dev/ttyd1""/dev/ttyd1", '/dev/ttyd2'"/dev/ttyd2""/dev/ttyd2""/dev/ttyd2""/dev/ttyd2""/dev/ttyd2", '/dev/cua0'"/dev/cua0""/dev/cua0""/dev/cua0""/dev/cua0""/dev/cua0", '/dev/cua1'"/dev/cua1""/dev/cua1""/dev/cua1""/dev/cua1""/dev/cua1"

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

Handle der seriellen Schnittstelle.

Ergebnis

Wenn die Parameter korrekt sind und das angegebene Gerät geöffnet werden konnte, liefert open_serialopen_serialOpenSerialopen_serialOpenSerialOpenSerial den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam, read_serialread_serialReadSerialread_serialReadSerialReadSerial, write_serialwrite_serialWriteSerialwrite_serialWriteSerialWriteSerial, close_serialclose_serialCloseSerialclose_serialCloseSerialCloseSerial

Siehe auch

set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam, get_serial_paramget_serial_paramGetSerialParamget_serial_paramGetSerialParamGetSerialParam, open_fileopen_fileOpenFileopen_fileOpenFileOpenFile

Modul

Foundation

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