open_serialT_open_serialOpenSerialOpenSerialopen_serial (算子)

名称

open_serialT_open_serialOpenSerialOpenSerialopen_serial — 打开串行设备。

签名

open_serial( : : PortName : SerialHandle)

描述

open_serialopen_serialOpenSerialOpenSerialOpenSerialopen_serial opens a serial device. The name of the device is determined by the parameter PortNamePortNamePortNamePortNameportNameport_name and is operating system specific. On Windows machines, 'COM1'"COM1""COM1""COM1""COM1""COM1"-'COM4'"COM4""COM4""COM4""COM4""COM4" is typically used, while on Unix-like systems the serial devices usually are named '/dev/tty*'"/dev/tty*""/dev/tty*""/dev/tty*""/dev/tty*""/dev/tty*". The parameters of the serial device, e.g., its speed or number of data bits, are set to the system default values for the respective device after the device has been opened. They can be set or changed by calling set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。

参数

PortNamePortNamePortNamePortNameportNameport_name (输入控制) filename → (string)

Name of the serial port.

默认值： 'COM1' "COM1" "COM1" "COM1" "COM1" "COM1"

建议值： '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 (输出控制) serial → (handle)

Serial interface handle.

结果

If the parameters are correct and the device could be opened, the operator open_serialopen_serialOpenSerialOpenSerialOpenSerialopen_serial 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。

可能的后继

set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param, read_serialread_serialReadSerialReadSerialReadSerialread_serial, write_serialwrite_serialWriteSerialWriteSerialWriteSerialwrite_serial, close_serialclose_serialCloseSerialCloseSerialCloseSerialclose_serial

另见

set_serial_paramset_serial_paramSetSerialParamSetSerialParamSetSerialParamset_serial_param, get_serial_paramget_serial_paramGetSerialParamGetSerialParamGetSerialParamget_serial_param, open_fileopen_fileOpenFileOpenFileOpenFileopen_file

模块

基础

算子