open_serialT_open_serialOpenSerialOpenSerial (Operator)
Name
open_serialT_open_serialOpenSerialOpenSerial — Öffnen eines seriellen Gerätes.
Signatur
Beschreibung
open_serialopen_serialOpenSerialOpenSerialOpenSerial öffnet ein serielles Gerät. Der Name des
Geräts wird in PortNamePortNamePortNamePortNameportName. Er ist Betriebssystem-abhängig:
auf Windows-Rechnern wird typischerweise
'COM1'"COM1""COM1""COM1""COM1"-'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*"
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_paramSetSerialParamSetSerialParamSetSerialParam gesetzt oder
verändert werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
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
PortNamePortNamePortNamePortNameportName (input_control) filename → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der seriellen Schnittstelle.
Defaultwert:
'COM1'
"COM1"
"COM1"
"COM1"
"COM1"
Wertevorschläge: 'COM1'"COM1""COM1""COM1""COM1", 'COM2'"COM2""COM2""COM2""COM2", 'COM3'"COM3""COM3""COM3""COM3", 'COM4'"COM4""COM4""COM4""COM4", '/dev/ttya'"/dev/ttya""/dev/ttya""/dev/ttya""/dev/ttya", '/dev/ttyb'"/dev/ttyb""/dev/ttyb""/dev/ttyb""/dev/ttyb", '/dev/tty00'"/dev/tty00""/dev/tty00""/dev/tty00""/dev/tty00", '/dev/tty01'"/dev/tty01""/dev/tty01""/dev/tty01""/dev/tty01", '/dev/ttyd1'"/dev/ttyd1""/dev/ttyd1""/dev/ttyd1""/dev/ttyd1", '/dev/ttyd2'"/dev/ttyd2""/dev/ttyd2""/dev/ttyd2""/dev/ttyd2", '/dev/cua0'"/dev/cua0""/dev/cua0""/dev/cua0""/dev/cua0", '/dev/cua1'"/dev/cua1""/dev/cua1""/dev/cua1""/dev/cua1"
SerialHandleSerialHandleSerialHandleSerialHandleserialHandle (output_control) serial → HSerial, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der seriellen Schnittstelle.
Ergebnis
Wenn die Parameter korrekt sind und das angegebene Gerät geöffnet
werden konnte, liefert open_serialopen_serialOpenSerialOpenSerialOpenSerial den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParam,
read_serialread_serialReadSerialReadSerialReadSerial,
write_serialwrite_serialWriteSerialWriteSerialWriteSerial,
close_serialclose_serialCloseSerialCloseSerialCloseSerial
Siehe auch
set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParam,
get_serial_paramget_serial_paramGetSerialParamGetSerialParamGetSerialParam,
open_fileopen_fileOpenFileOpenFileOpenFile
Modul
Foundation