3 releases
0.2.3 | Jan 21, 2023 |
---|---|
0.2.2 | Oct 15, 2022 |
0.2.1 | Sep 15, 2022 |
0.2.0 |
|
#5 in #libgpiod
83KB
2K
SLoC
libgpiod in Rust for async-std
Rust crate for interfacing with Linux GPIO character devices. This crate supports async-std async runtime.
It provides an interface to the Linux GPIO using the chardev module. This interface involves calling ioctl funcions which are unsafe and require some unintuitive variable mapping. To ease this process, this crate provides a [Chip] struct which encapsulates the interface in safe Rust functions. The functionality provided here is highly inspired by libgpiod.
Since all functionality is dependent on Linux function calls, this crate only compiles for Linux systems.
ABI compatibility
Both v1 (>= 4.0) and v2 (>= v5.10) ABI currently supported but edge detection implemented for v2 only. Sysfs-based API (< 4.0) does not supported.
Crates
- gpiod-core - core abstractions and low level interface (not for end users)
- gpiod - sync interface which supports synchronous operation only
- tokio-gpiod - async interface for tokio fans
- async-std-gpiod - async interface for async-std fans
Usage examples
Input values:
use async_std_gpiod::{Chip, Options};
#[async_std::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(())
}
Output values:
use async_std_gpiod::{Chip, Options};
#[async_std::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(())
}
Monitor values:
use async_std_gpiod::{Chip, Options, EdgeDetect};
#[async_std::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(())
}
Dependencies
~6–15MB
~202K SLoC