unistore-serial

UniStore 串口通信能力，提供跨平台的 RS232/UART 通信支持。

概述

unistore-serial 提供：

• 串口发现与枚举
• 配置管理（波特率、数据位、停止位、校验）
• 同步读写操作
• 流控制（RTS/CTS、XON/XOFF）
• 信号线控制（DTR、RTS、CTS、DSR、CD）
• 与 UniStore 生命周期集成

安装

[dependencies]

unistore-serial = "0.1"

快速开始

use unistore_serial::{SerialPort, SerialConfig, list_ports};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 列出可用串口
    let ports = list_ports()?;
    for port in &ports {
        println!("发现串口: {} - {:?}", port.name, port.port_type);
    }
    
    // 打开串口
    let config = SerialConfig::default()
        .with_baud_rate(115200)
        .with_timeout_ms(1000);
    
    let mut port = SerialPort::open("COM1", config)?;
    
    // 写入数据
    port.write(b"AT\r\n")?;
    
    // 读取响应
    let mut buf = [0u8; 256];
    let n = port.read(&mut buf)?;
    println!("收到: {:?}", &buf[..n]);
    
    Ok(())
}

配置预设

// 常见波特率配置
let config = SerialConfig::baud_115200_8n1();  // 115200, 8N1
let config = SerialConfig::baud_9600_8n1();   // 9600, 8N1

信号控制

// 设置 DTR/RTS
port.set_dtr(true)?;
port.set_rts(true)?;

// 读取信号状态
let cts = port.read_cts()?;
let dsr = port.read_dsr()?;
let cd = port.read_cd()?;

底层访问

需要直接使用 serialport 时：

let inner = port.inner();
// inner 是 Box<dyn serialport::SerialPort>

平台支持

许可证

MIT OR Apache-2.0

致谢

本 crate 基于以下优秀项目构建：

• serialport-rs - 跨平台串口通信库

感谢 serialport-rs 团队提供的出色工作！

许可证说明: serialport-rs 使用 MPL-2.0 许可证。UniStore 作为依赖使用， 不修改其源码，符合 MPL-2.0 的使用条款。