Rust中的libgpiod用于tokio

Rust包用于与Linux GPIO字符设备接口。此包支持tokio异步运行时。

它提供了使用chardev模块的Linux GPIO接口。此接口涉及调用ioctl函数，这些函数是不安全的并且需要一些不直观的变量映射。为了简化此过程，此包提供了一个[Chip]结构体，它封装了在安全Rust函数中的接口。这里提供的功能高度受到libgpiod的启发。

由于所有功能都依赖于Linux函数调用，因此此包仅适用于Linux系统。

ABI兼容性

支持ABI v1（linux >= 4.0）和v2（linux >= v5.10），但仅对v2实现了边缘检测。已弃用的基于sysfs的API（linux < 4.0）目前完全不支持。

包

• gpiod-core - 核心抽象和低级接口（不面向最终用户）
• gpiod - 仅支持同步操作的同步接口
• tokio-gpiod - 适合tokio爱好者的异步接口
• async-gpiod - 用于非tokio异步运行时的异步接口

使用示例

输入值

use tokio_gpiod::{Chip, Options};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let chip = Chip::new("gpiochip0").await?; // open chip

    let opts = Options::input([27, 3, 11]) // configure lines offsets
        .consumer("my-inputs"); // optionally set consumer string

    let inputs = chip.request_lines(opts).await?;

    let values = inputs.get_values([false; 3]).await?;

    println!("values: {:?}", values);

    Ok(())
}

输出值

use tokio_gpiod::{Chip, Options};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let chip = Chip::new("gpiochip0").await?; // open chip

    let opts = Options::output([9, 21]) // configure lines offsets
        .values([false, true]) // optionally set initial values
        .consumer("my-outputs"); // optionally set consumer string

    let outputs = chip.request_lines(opts).await?;

    outputs.set_values([true, false]).await?;

    Ok(())
}

监控值

use tokio_gpiod::{Chip, Options, EdgeDetect};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let chip = Chip::new("gpiochip0").await?; // open chip

    let opts = Options::input([4, 7]) // configure lines offsets
        .edge(EdgeDetect::Both) // configure edges to detect
        .consumer("my-inputs"); // optionally set consumer string

    let mut inputs = chip.request_lines(opts).await?;

    loop {
        let event = inputs.read_event().await?;

        println!("event: {:?}", event);
    }

    Ok(())
}