device.open

device.open

功能

打开设备连接。当前实现支持 serial 串口设备。

语法

参数

参数	类型	必填	默认值	说明
config	Object	是	无	设备配置对象。

串口配置字段

当前 device.open(config) 仅支持打开 serial 串口设备。config 字段如下：

字段	类型	必填	默认值	说明
type	String	否	`serial`	设备类型。当前只支持 `serial`，传入其它值会抛出 unsupported device type 错误。
port	String	是	无	系统串口名称，例如 `COM3`、`/dev/ttyUSB0`。通常来自 `device.scan()` 返回对象的 `port` 字段。
baud_rate	Int	否	`9600`	波特率，表示每秒传输的符号数量。必须和外部设备配置一致。
data_bits	Int	否	`8`	数据位数量。支持 `5`、`6`、`7`、`8`。
stop_bits	Int	否	`1`	停止位数量。支持 `1`、`2`。
parity	String	否	`none`	校验位。支持 `none`、`odd`、`even`；空字符串按 `none` 处理。
timeout	Int	否	`1000`	读写超时时间，单位毫秒。

返回值

类型	说明
Device	返回已打开的设备句柄。

示例

注意事项

配置字段统一使用 snake_case。
baud_rate、data_bits、stop_bits、parity 必须和硬件设备的串口参数一致，否则可能无法正常通信。