跳到主要内容

az-serial

自动收集自 crates/network/az-serial/README.md。

跨平台串口通信工具，提供可移植的串口读写和帧解码抽象。

功能​

  • 串口读写：通过 SerialPort 打开 /dev/tty*（Unix）或 COM*（Windows）端口，进行同步读写
  • 可配置参数：支持自定义波特率（4800–921600 或自定义值）、数据位、校验位、停止位和流控制
  • 帧解码：FrameDecoder 支持三种工业常见帧格式——定长帧、分隔符帧和长度前缀帧
  • 串口枚举：SerialPort::list_ports() 列出系统可用串口及其 USB VID/PID 信息
  • 配置序列化：SerialConfig 可通过 serde 进行 JSON 序列化/反序列化，方便持久化配置
  • 统一错误模型：SerialError 覆盖 I/O 错误、端口未找到、配置无效、超时、缓冲区溢出等场景

安装​

在 Cargo.toml 中添加：

[dependencies]
az-serial = { path = "../az-serial" }       # workspace 内部引用
# 或发布后：
# az-serial = "0.1"                          # crates.io 引用

用法​

打开串口并读写数据​

use az_serial::{SerialPort, SerialConfig, BaudRate, Parity, StopBits};

let config = SerialConfig::new(BaudRate::Baud115200)
    .with_parity(Parity::None)
    .with_stop_bits(StopBits::One)
    .with_data_bits(8);

let mut port = SerialPort::open("/dev/ttyUSB0", &config)?;
port.write(b"AT\r\n")?;

let mut buf = [0u8; 256];
let n = port.read(&mut buf)?;
println!("Received: {:?}", &buf[..n]);
port.close()?;

使用帧解码器解析串口数据流​

use az_serial::{FrameDecoder, FrameFormat, FrameEvent};

let mut decoder = FrameDecoder::new(FrameFormat::Delimiter(vec![0x0A]));
decoder.push(b"Hello");
assert!(decoder.poll().is_none());
decoder.push(b"\n");
assert_eq!(decoder.poll(), Some(FrameEvent::Frame(b"Hello".to_vec())));

依赖的 crates​

  • serde - 序列化/反序列化支持
  • serde_json - JSON 处理（用于配置序列化）
  • thiserror - 简化错误类型定义
  • tokio - 异步运行时（预留异步支持）