当前位置：首页 > news >正文

如何用serialport-rs快速实现Rust串口通信：新手入门教程

news 2026/8/2 23:05:45

如何用serialport-rs快速实现Rust串口通信：新手入门教程

【免费下载链接】serialport-rsA cross-platform serial port library in Rust. Provides a blocking I/O interface and port enumeration including USB device information.项目地址: https://gitcode.com/gh_mirrors/se/serialport-rs

serialport-rs是一个功能强大的跨平台Rust串口通信库，它提供了阻塞式I/O接口和端口枚举功能，包括USB设备信息。本教程将带您快速掌握使用serialport-rs进行串口通信的基本方法，让您的Rust项目轻松实现与硬件设备的串口交互。

🌟 serialport-rs简介：为什么选择它？

serialport-rs库通过SerialPorttrait提供了跨平台的串口功能，抽象了不同操作系统底层的差异。无论是Windows、Linux还是macOS，您都可以使用统一的接口进行串口操作。库采用资源获取即初始化（RAII）范式，当SerialPort对象被Drop时会自动关闭端口，确保资源安全释放。

该库的主要特点包括：

跨平台支持，无需修改代码即可在不同操作系统上运行
简单易用的构建器模式配置串口参数
支持端口枚举和USB设备信息获取
提供完整的串口功能：设置波特率、数据位、校验位、停止位等
支持全双工通信，可同时读写数据

🚀 快速开始：安装与基本配置

安装serialport-rs

要在Rust项目中使用serialport-rs，首先需要在Cargo.toml中添加依赖：

[dependencies] serialport = "0.11.0"

列出可用串口

在进行串口通信前，我们需要知道系统中有哪些可用的串口。serialport-rs提供了available_ports()函数来获取系统中的串口列表：

use serialport::available_ports; fn main() { match available_ports() { Ok(ports) => { println!("找到 {} 个可用串口:", ports.len()); for (i, port) in ports.iter().enumerate() { println!(" 串口 {}: {}", i + 1, port.port_name); } } Err(e) => { eprintln!("获取串口列表失败: {}", e); } } }

这段代码会列出系统中所有可用的串口，包括它们的端口名称。您可以在examples/list_ports.rs中找到完整的示例代码。

⚙️ 配置与打开串口

serialport-rs使用构建器模式来配置和打开串口。下面是一个基本的示例，展示如何配置并打开一个串口：

use serialport::SerialPortBuilder; fn main() -> Result<(), Box<dyn std::error::Error>> { // 创建串口构建器并配置基本参数 let mut port = SerialPortBuilder::new("/dev/ttyUSB0", 9600) .data_bits(serialport::DataBits::Eight) .parity(serialport::Parity::None) .stop_bits(serialport::StopBits::One) .flow_control(serialport::FlowControl::None) .timeout(std::time::Duration::from_millis(1000)) .open()?; println!("成功打开串口: {}", port.name().unwrap_or("未知端口")); Ok(()) }

在这个示例中，我们创建了一个串口构建器，指定了串口路径（Windows系统可能是"COM1"，Linux系统可能是"/dev/ttyUSB0"）和波特率9600。然后我们设置了数据位为8位，无校验位，1位停止位，无流控，并设置了1秒的超时时间。最后调用open()方法打开串口。

💬 串口通信：发送与接收数据

打开串口后，我们就可以进行数据的发送和接收了。serialport-rs实现了std::io::Read和std::io::Writetrait，因此我们可以使用标准的I/O操作来读写串口。

发送数据

发送数据非常简单，只需调用write()或write_all()方法：

// 发送字符串 let data = "Hello, serial port!"; port.write_all(data.as_bytes())?; println!("发送了 {} 字节的数据", data.len());

接收数据

接收数据可以使用read()或read_to_end()等方法：

// 接收数据 let mut buffer = [0; 1024]; let bytes_read = port.read(&mut buffer)?; println!("接收到 {} 字节的数据: {:?}", bytes_read, &buffer[..bytes_read]); println!("字符串形式: {}", String::from_utf8_lossy(&buffer[..bytes_read]));

🔄 全双工通信示例

serialport-rs支持全双工通信，您可以同时进行读写操作。下面是一个简单的全双工通信示例：

use serialport::SerialPort; use std::thread; fn main() -> Result<(), Box<dyn std::error::Error>> { // 打开串口 let mut port = serialport::new("/dev/ttyUSB0", 9600) .timeout(std::time::Duration::from_millis(100)) .open()?; // 克隆端口用于读取线程 let mut reader = port.try_clone()?; // 启动读取线程 thread::spawn(move || { let mut buffer = [0; 1024]; loop { match reader.read(&mut buffer) { Ok(n) if n > 0 => { println!("接收到: {}", String::from_utf8_lossy(&buffer[..n])); } Ok(_) => {} Err(e) => { eprintln!("读取错误: {}", e); break; } } } }); // 主线程发送数据 let mut input = String::new(); loop { std::io::stdin().read_line(&mut input)?; port.write_all(input.as_bytes())?; input.clear(); } }

在这个示例中，我们使用try_clone()方法创建了一个端口的克隆，用于读取线程。这样我们就可以在一个线程中持续读取数据，同时在主线程中发送数据。您可以在examples/duplex.rs中找到更多关于全双工通信的示例。

🧪 测试与调试

serialport-rs提供了一些工具来帮助测试和调试串口通信。例如，examples/hardware_check.rs可以作为使用serialport-rs时遇到错误的调试工具。它可以检查串口的基本功能，包括设置参数、发送接收数据等。

另外，您可以使用examples/loopback.rs来测试串口的环回功能，这对于验证串口通信是否正常非常有用。

📚 进阶功能

serialport-rs还提供了一些进阶功能，帮助您更好地控制串口通信：

缓冲区操作

您可以使用clear()方法清除输入或输出缓冲区：

// 清除输入缓冲区 port.clear(serialport::ClearBuffer::Input)?; // 清除输出缓冲区 port.clear(serialport::ClearBuffer::Output)?; // 清除所有缓冲区 port.clear(serialport::ClearBuffer::All)?;

流量控制

serialport-rs支持多种流量控制方式：

// 软件流控 port.set_flow_control(serialport::FlowControl::Software)?; // 硬件流控 port.set_flow_control(serialport::FlowControl::Hardware)?; // 无流控 port.set_flow_control(serialport::FlowControl::None)?;

串口信息获取

您可以获取串口的详细信息，包括USB设备信息（如果适用）：

use serialport::{available_ports, SerialPortType}; fn print_port_info() -> Result<(), Box<dyn std::error::Error>> { let ports = available_ports()?; for port in ports { println!("端口名称: {}", port.port_name); match port.port_type { SerialPortType::UsbPort(info) => { println!(" USB 设备信息:"); println!(" 供应商ID: 0x{:04x}", info.vid); println!(" 产品ID: 0x{:04x}", info.pid); println!(" 序列号: {}", info.serial_number.as_deref().unwrap_or("未知")); println!(" 制造商: {}", info.manufacturer.as_deref().unwrap_or("未知")); println!(" 产品名称: {}", info.product.as_deref().unwrap_or("未知")); } SerialPortType::BluetoothPort => { println!(" 蓝牙端口"); } SerialPortType::PciPort => { println!(" PCI 端口"); } SerialPortType::Unknown => { println!(" 未知类型"); } } } Ok(()) }