#串口 #串行 #mio

mio-serial

为 mio 实现的串口

25 个版本 (14 个稳定版)

5.0.5 2023年2月8日
5.0.3 2022年11月2日
5.0.2 2022年3月4日
5.0.1 2021年8月8日
0.1.0 2016年12月11日

#111 in 异步

Download history 10317/week @ 2024-03-14 9834/week @ 2024-03-21 10421/week @ 2024-03-28 13853/week @ 2024-04-04 15466/week @ 2024-04-11 14248/week @ 2024-04-18 13593/week @ 2024-04-25 13668/week @ 2024-05-02 14908/week @ 2024-05-09 14617/week @ 2024-05-16 15453/week @ 2024-05-23 13784/week @ 2024-05-30 14362/week @ 2024-06-06 16121/week @ 2024-06-13 17853/week @ 2024-06-20 14344/week @ 2024-06-27

65,687 每月下载量
用于 79 个 crate (7 个直接使用)

MIT 许可协议

37KB
528

Crates.io MIT licensed Build Status

mio-serial: MIO 的串口 IO 库。

mio-serial 提供了一个使用 mio 的串口实现。

使用方法

mio-serial 添加到你的 Cargo.toml

[dependencies]
mio-serial = "5.0.1"

然后在你的 crate 根目录下添加以下内容

extern crate mio_serial;

特性

默认情况下,serialport-rs 的 "libudev" 依赖项被启用。对于 x86 Linux 系统,这启用了 available_ports 函数以进行端口枚举。并非所有目标都支持 udev,特别是交叉编译时。要禁用此功能,请使用 --no-default-features 选项进行编译。例如

cargo build --no-default-features

MSRV

最低支持的 Rust 版本是 1.60.0,这是通过 cargo-msrv 找到的。

示例

一些示例可以在 这里 找到。

测试

对于串口的实用测试需要...串口,而串口通常不是由在线 CI 提供商提供的。因此,自动构建测试实际上只是检查代码是否编译,而不是是否工作。

集成测试位于 tests/ 目录中,通常需要两个串口来运行。串口名称可以在运行时通过设置环境变量 TEST_PORT_NAMES 为包含两个串口名称的分号分隔字符串来配置。默认值是

  • 对于 Unix: TEST_PORT_NAMES=/dev/ttyUSB0;/dev/ttyUSB1
  • 对于Windows: TEST_PORT_NAMES=COM1;COM2

重要 为了防止多个测试同时与同一端口通信,请确保使用以下方法将测试线程数量限制为1:

cargo test -j1 -- --test-threads=1

许可证

本软件根据MIT许可证授权。

本软件基于MPL-2.0许可证授权的serialport-rs,并构成了该许可证下的“更大作品”。serialport-rs的源代码可以在https://gitlab.com/susurrus/serialport-rs找到。

依赖项

~2–12MB
~109K SLoC