dummy-pin

Crates.iodummy-pin
lib.rsdummy-pin
version1.0.0
sourcesrc
created_at2021-03-10 09:11:32.770708
updated_at2024-01-19 08:05:44.274136
descriptionDummy implementations of the input/output pin embedded-hal traits.
homepagehttps://github.com/eldruin/dummy-pin-rs
repositoryhttps://github.com/eldruin/dummy-pin-rs
max_upload_size
id366712
size39,794
Diego Barrios Romero (eldruin)

documentation

https://docs.rs/dummy-pin

README

Dummy Input/Output Pin Implementations

crates.io Docs MSRV Build Status Coverage Status

This provides dummy implementations of the input/output pin embedded-hal traits. This is useful when dealing with setups where a certain pin is handled by hardware in a way that the software does not need to know about, for example.

In addition to the no-op, zero-cost DummyPin, this crate provides an implementation of LastStateDummyPin, which stores the last state set at runtime and returns it when read.

Usage

This example demonstrates how the same driver can operate with either a real or a dummy output pin.

use dummy_pin::DummyPin;
use embedded_hal::digital::OutputPin;
use linux_embedded_hal::SysfsPin;

struct Driver<P> {
    output: P,
}

impl<P, E> Driver<P>
where
    P: OutputPin<Error = E>,
{
    fn new(pin: P) -> Self {
        Driver { output: pin }
    }

    fn do_something(&mut self) -> Result<(), E> {
        // ...
        self.output.set_high()
    }
}

fn main() {
    // The same driver can operate with either a real or a dummy pin.
    let real_pin = SysfsPin::new(25);
    let mut driver_with_real_pin = Driver::new(real_pin);
    driver_with_real_pin.do_something().unwrap();

    let dummy_pin = DummyPin::new_low();
    let mut driver_with_dummy_pin = Driver::new(dummy_pin);
    driver_with_dummy_pin.do_something().unwrap();
}

Support

For questions, issues, feature requests, and other changes, please file an issue in the github project.

License

Licensed under either of

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 10

cargo fmt