扫描操作系统当前可见的串口列表。
device.scan('serial')
也可以省略参数,默认扫描串口:
device.scan()
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| type | string | 否 | serial | 设备类型,当前只支持 serial |
Array:串口信息对象数组。没有扫描到串口时返回 []。
返回字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| type | string | 固定为 serial |
| port | string | 串口名称,例如 COM1、/dev/ttyUSB0 |
| name | string | 友好名称;USB 设备优先使用产品名或厂商名 |
| kind | string | 串口来源类型:usb、bluetooth、pci 或 unknown |
| vid | int | USB Vendor ID,仅 USB 串口存在该字段 |
| pid | int | USB Product ID,仅 USB 串口存在该字段 |
| serialNumber | string | USB 序列号;没有时为空字符串 |
| manufacturer | string | USB 厂商名;没有时为空字符串 |
| product | string | USB 产品名;没有时为空字符串 |
示例返回:
[ { "type": "serial", "port": "COM3", "name": "USB Serial", "kind": "usb", "vid": 1027, "pid": 24577, "serialNumber": "", "manufacturer": "FTDI", "product": "USB Serial" } ]
ports = device.scan('serial') for port in ports { println(port.port + ' ' + port.kind) }
COM1、COM3。
/dev/ttyUSB0、/dev/ttyACM0。
/dev/tty.* 或 /dev/cu.*。
device.scan('serial') 依赖操作系统和串口驱动枚举结果。
serial 类型会返回不支持错误。