#raspberry-pi #pi #raspberry #bindings #api-wrapper #type-system #wiring

wiringpi

An API wrapper for WiringPi, implementing the most important functions and provides a bit of type system convenience. See README.md for Raspberry Pi build instructions.

8 releases

Uses old Rust 2015

0.2.4 Mar 17, 2018
0.2.3 Mar 4, 2018
0.2.2 Feb 4, 2018
0.2.1 May 28, 2017
0.1.1 Apr 18, 2015

#52 in #raspberry

Download history 21/week @ 2023-11-20 12/week @ 2023-11-27 8/week @ 2023-12-04 13/week @ 2023-12-11 17/week @ 2023-12-18 8/week @ 2023-12-25 13/week @ 2024-01-08 14/week @ 2024-01-15 4/week @ 2024-01-22 2/week @ 2024-01-29 9/week @ 2024-02-05 19/week @ 2024-02-12 19/week @ 2024-02-19 36/week @ 2024-02-26 33/week @ 2024-03-04

109 downloads per month
Used in 3 crates (2 directly)

MIT license

1MB
14K SLoC

C 13K SLoC // 0.3% comments Rust 556 SLoC // 0.0% comments Bazel 198 SLoC // 0.2% comments Shell 34 SLoC // 0.6% comments

Contains (static library, 130KB) wiringPi/wiringPi/libwiringPi.a, (static library, 91KB) WiringOP/wiringPi/libwiringPi.a, (ELF exe/lib, 19KB) wiringPi/wiringPiD/wiringpid

WiringPi Bindings for Rust

An API wrapper for WiringPi to make it accessible using Rust. It implements the most important functions and provides a bit of type system convenience.

Add the following lines to your Cargo.io to use rust-wiringpi:

[dependencies]
wiringpi = "0.2"

Online Documentation

Released

Master branch

Example: Flashing Light

extern crate wiringpi;

use wiringpi::pin::Value::{High, Low};
use std::{thread, time};

fn main() {
    //Setup WiringPi with its own pin numbering order
    let pi = wiringpi::setup();

    //Use WiringPi pin 0 as output
    let pin = pi.output_pin(0);

    let interval = time::Duration::from_millis(1000);

    loop {
        //Set pin 0 to high and wait one second
        pin.digital_write(High);
        thread::sleep(interval);

        //Set pin 0 to low and wait one second
        pin.digital_write(Low);
        thread::sleep(interval);
    }
}

Cross Compiling Using Cargo

Follow this guide.

cargo build --target=arm-unknown-linux-gnueabihf   # Older models
cargo build --target=armv7-unknown-linux-gnueabihf # Newer models

Orange Pi support

rust-wiringpi can also wrap the WiringOP library for the Orange Pi SBC boards. This can be enabled with the orangepi feature:

[dependencies.wiringpi]
verson = "0.2"
features = ["orangepi"]

Development Mode

In development mode, rust-wiringpi is compiled as a rust-native library excluding the original WiringPi. And binding functions are replaced by dummy functions that output simple logs to stdout. With this mode, you can build and debug your project on platforms that does not support WiringPi.

# build
$ cargo build --features wiringpi/development

# run
$ cargo run --features wiringpi/development

[wiringpi] `wiringPiSetup` called
[wiringpi] `pinMode` called with: 0, 1
[wiringpi] `digitalWrite` called with: 0, 1
[wiringpi] `digitalWrite` called with: 0, 0
...

Dependencies