# device 常见问题

## 当前支持哪些设备

当前源码实现支持 serial 串口。其它设备类型调用 open 或 scan 会返回 unsupported device type 错误。

## 二进制协议应该用哪个读取方法

工业协议和自定义二进制报文建议使用 `read_bytes()`，返回值固定为 Bytes。`read()` 保留兼容行为，合法 UTF-8 返回 String，非法 UTF-8 返回字节数组；`read_text()` 严格按 UTF-8 转换，失败返回 null。

## 串口字段使用什么命名规则

所有配置字段和返回对象字段统一使用 snake_case，例如 baud_rate、data_bits、stop_bits、serial_number。

## write 支持二进制吗

支持。传入字符串时写入 UTF-8 字节；传入数组时每个元素必须是 0 到 255 的整数。