raslib

raslib is a library to manage Raspberry PI devices, written in Rust.

It provides GPIO¹ ports access in order to manage leds or motors (direct support for L298N circuit motors).

Installation • Overview • Examples

Installation

In your "Cargo.toml" file :

[dependencies]
raslib = "*"

Check the current version on crates.io.

Overview

• GPIO

  The library provides a structure to manipulate GPIO ports simply called Gpio.

  #[derive(Copy, Clone)]
  struct Gpio {
      pin: u32,
  }
  

  Implementation

  fn new(pin: u32) -> Result<Self, std::io::Error>;
  
  fn write(&self, value: bool) -> Result<(), std::io::Error>;
  
  fn read(&self) -> Result<bool, std::io::Error>;
  
  fn pin(&self) -> u32;
  

  Usage

  use raslib::Gpio;
  

  let gpio = Gpio::new(16)?;
  gpio.write(raslib::HIGH)?;
  
  let pin: u32 = gpio.pin();
  

  The Raspberry PI has different GPIO pins following the version. Make sure to connect to the right numbers.

  This example is tested on Raspberry PI 4 Model B and the port 16 is not a power (PWR) nor a ground (GND) pin !

  See its example.

• L298N

  The library provides a simple way to manipulate motors using the L298N circuit. Because the motors wires are connected to the GPIO pins, L298n actually uses Gpio.

  struct L298n {
    in1: Gpio,
    in2: Gpio,
    ena: Gpio,
  }
  

  Implementation

  fn new(in1: u32, in2: u32, ena: u32) -> Self;
  
  fn forward(&mut self) -> Result<(), io::Error>;
  
  fn backward(&mut self) -> Result<(), io::Error>;
  
  fn stop(&mut self) -> Result<(), io::Error>;
  

  Usage

  use raslib::L298n;
  

  let mut motor_left = L298n::new(18, 15, 14);
  let mut motor_right = L298n::new(9, 7, 25);
  
  motor_left.forward()?;
  motor_right.forward()?;
  

  See its example.

• Utils

  The library provides a simple sleep function that makes the current thread wait for a duration in milliseconds.

  fn sleep(milliseconds: u64);
  

  Usage

  raslib::sleep(1000); // waits 1 second.
  

  To make writing values prettier, it also provides two constants:

  const HIGH: bool = true;
  const LOW: bool = false;
  

  Usage

  gpio.write(raslib::HIGH);
  gpio.write(true); // same as above