open_serialT_open_serialOpenSerialOpenSerialopen_serial (Operator)
Name
open_serialT_open_serialOpenSerialOpenSerialopen_serial — Öffnen eines seriellen Gerätes.
Signatur
Beschreibung
open_serialopen_serialOpenSerialOpenSerialOpenSerialopen_serial öffnet ein serielles Gerät. Der Name des
Geräts wird in PortNamePortNamePortNamePortNameportNameport_name. 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_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param 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
PortNamePortNamePortNamePortNameportNameport_name (input_control) filename → HTuplestrHTupleHtuple (string) (string) (HString) (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"
SerialHandleSerialHandleSerialHandleSerialHandleserialHandleserial_handle (output_control) serial → HSerial, HTupleHHandleHTupleHtuple (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_serialOpenSerialOpenSerialOpenSerialopen_serial den Wert TRUE.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param,
read_serialread_serialReadSerialReadSerialReadSerialread_serial,
write_serialwrite_serialWriteSerialWriteSerialWriteSerialwrite_serial,
close_serialclose_serialCloseSerialCloseSerialCloseSerialclose_serial
Siehe auch
set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param,
get_serial_paramget_serial_paramGetSerialParamGetSerialParamGetSerialParamget_serial_param,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
Modul
Foundation