ruspiro-gpio

Crates.ioruspiro-gpio
lib.rsruspiro-gpio
version0.4.3
sourcesrc
created_at2019-07-29 16:42:55.000006
updated_at2021-09-06 19:33:55.840227
descriptionThis crates provides a GPIO peripheral abstraction of the Raspberry Pi
homepage
repositoryhttps://github.com/RusPiRo/ruspiro-gpio/tree/v0.4.1
max_upload_size
id152674
size62,109
(2ndTaleStudio)

documentation

https://docs.rs/ruspiro-gpio/0.4.1

README

RusPiRo GPIO access abstraction for Raspberry Pi

This crate provide a simple to use and safe abstraction of the GPIO peripheral available on the Raspberry Pi 3. The GPIO configuration requires access to MMIO registers with a specific memory base address. As this might differ between different models the right address is choosen based on the given ruspiro_pi3 feature while compiling.

CI Latest Version Documentation License

Usage

To use the crate just add the following dependency to your Cargo.toml file:

[dependencies]
ruspiro-gpio = "0.4.3"

Once done the access to the GPIO abstraction is available in your rust files like so:

use ruspiro_gpio::GPIO;

fn demo() {
    // "grab" the GPIO in a safe way and use the provided closure to work with it
    // as long as the closure is executed, no other core can access the GPIO to configure pins etc.
    GPIO.with_mut(|gpio| {
        // retrieving a pin gives a Result<>. If the pin is not already taken it returns an Ok()
        // with the pin.
        if let Ok(pin) = gpio.get_pin(17) {
            // as we have now access to the pin, configure it as output and set it to high
            // to lit a connected LED
            pin.to_output().high();
        }
    })
}

Usage Hint

The GPIO crate provides access to the peripheral through a Singleton to ensure safe access from each core of the Raspberry Pi to it. This Singleton uses locks and atomic operations to safeguard the access. Those atomic operations does only work on the Raspberry Pi if the MMU is configured and active (with active caches). So to properly use this crate in your project please check the ruspiro-mmu crate as well and how to configure and activate the MMU.

License

Licensed under Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) or MIT (LICENSE-MIT or http://opensource.org/licenses/MIT)) at your choice.

Commit count: 0

cargo fmt