BT编程语言文档

device.scan('serial')

功能

扫描操作系统当前可见的串口列表。

语法

也可以省略参数,默认扫描串口:

参数

参数类型必填默认值说明
typestringserial设备类型,当前只支持 serial

返回值

Array:串口信息对象数组。没有扫描到串口时返回 []

返回字段:

字段类型说明
typestring固定为 serial
portstring串口名称,例如 COM1/dev/ttyUSB0
namestring友好名称;USB 设备优先使用产品名或厂商名
kindstring串口来源类型:usbbluetoothpciunknown
vidintUSB Vendor ID,仅 USB 串口存在该字段
pidintUSB Product ID,仅 USB 串口存在该字段
serialNumberstringUSB 序列号;没有时为空字符串
manufacturerstringUSB 厂商名;没有时为空字符串
productstringUSB 产品名;没有时为空字符串

示例返回:

代码示例

平台差异

  • Windows 常见串口名为 COM1COM3
  • Linux 常见串口名为 /dev/ttyUSB0/dev/ttyACM0
  • macOS 常见串口名为 /dev/tty.*/dev/cu.*

注意事项

  • device.scan('serial') 依赖操作系统和串口驱动枚举结果。
  • 扫描成功不代表一定能打开;打开串口还可能受权限、占用和硬件状态影响。
  • 传入非 serial 类型会返回不支持错误。