# device 硬件设备库

## 功能

device 提供设备扫描、打开、列表、存在性检查和串口读写能力。当前源码实现的设备类型是 serial。

## API 列表

| API | 说明 |
| ------ | ------ |
| [device.open](/docs/device/open) | 打开设备连接。当前实现支持 serial 串口设备。 |
| [device.scan](/docs/device/scan) | 扫描系统设备。当前实现支持 serial 串口扫描。 |
| [device.list](/docs/device/list) | 返回当前程序仍可见的已打开设备列表。 |
| [device.exists](/docs/device/exists) | 判断系统中是否存在指定串口。 |
| [serial.read](/docs/device/read) | 从已打开串口读取数据。 |
| [serial.write](/docs/device/write) | 向已打开串口写入数据。 |
| [serial.flush](/docs/device/flush) | 刷新已打开串口的输出缓冲。 |
| [serial.close](/docs/device/close) | 关闭已打开串口。 |

## 示例

```bt
ports = device.scan()
result = type(ports)

// 输出：Array
print result
```

## 注意事项

- device 是标准库构造入口，也支持 device.scan() 这种短写调用。
- 串口通信依赖系统设备和权限，示例中的 COM3 需要替换为实际端口。