#gpio-pin #pin #gpio #embedded-hal #shared #periphereal

no-std shared-pin

An abstraction to share rust embedded_hal pins between functions

1 unstable release

0.1.0 Sep 11, 2023

#1307 in Embedded development

24 downloads per month

Apache-2.0

7KB
50 lines

Shared pin abstraction for embedded rust

crates.io Docs Rust

This is a simple abstraction for embedded rust applications to share a pin between different functions. It uses an Rc<RefCell<Pin>> to share the embedded_hal::digital::v2 pin.
Should be able to be passed on to any function that expects an OutputPin or an InputPin

Example:

Put this into your cargo.toml:

[dependencies]
shared-bus = "0.1.0"

Imports:

use embedded_hal::digital::v2::OutputPin;
use shared_pin::SharedPin;

Definitions:


pub fn do_something_with_the_cloned_pin<PIN>(pin: PIN)
    where PIN: OuputPin
{
    pin.set_high();
    // ...
}

pub struct Device<PIN> {
    pin: PIN,
}

impl<PIN> Device<PIN>
    where
        PIN: OutputPin {
    pub fn new(pin: PIN) -> Self {
        Self {
            pin: PIN,
        }
    }
}

Usage:

{
    let mut shared_output_pin_1 = SharedPin::new(output_pin);
    let mut shared_output_pin_2 = shared_output_pin_1.clone();
    let mut shared_output_pin_3 = shared_output_pin_1.clone();
    do_something_with_the_cloned_pin(shared_output_pin_2);
    let mut device = Device::new(shared_output_pin_3);
    device.pin.set_low();
    
    let mut shared_input_pin_1 = SharedPin::new(input_pin);
    let mut shared_input_pin_2 = shared_input_pin_1.clone();
    let mut shared_input_pin_3 = shared_input_pin_1.clone();
    
    if shared_input_pin_3.is_low() {
        // ...
    }
}

TODO:

  • make thread safe for freeRTOS

Dependencies

~71KB