Physical Computing With Rust On Raspberry Pi

Use Rust to control LEDs, Buzzers, and more with the Raspberry Pi

A couple of months ago I released the rust_gpiozero¹ crate. It is a port of the GPIO Zero² library by the Raspberry Pi Foundation. The library provides a simple interface to control GPIO devices with a Raspberry Pi. Following this, recently ported the Raspberry Pi Foundation’s Physical Computing with Python³ guide for Rust.

Why did I create the rust_gpiozero crate?

After going through The Rust Programming language book, I decided to work on a side project to practice some of the concepts. I enjoy working with microcontrollers and Single Board Computers and making beginner tutorials. I looked for crates related to the raspbery Pi and controlling GPIO pins and came across several great ones such as rppal, sysfs_gpio and i2cdev.

The idea behind rust_gpizero was to abstract away some of the complexities and provide a high-level interface to experimenting with GPIO pins on the Raspberry Pi using Rust. This is similar to the original python based GPIOZero library which uses the RPi.GPIO library under the hood. You can experiment with very little code. I also tried to keep a similar API to the original GPIOZero library.

Blinking an LED using GPIOZero
Generated using: carbon
Similarly, blinking an LED using rust_gpiozero
Generated using: carbon

The library is still a work-in-progress and there are many improvements which can be made.

Tutorials to accompany the crate

Physical Computing with Python (published under a Creative Commons license) by The Raspberry Pi Foundation is a great guide which introduces physical computing. The guide uses GPIOZero and teaches how to interface with electronic components such as LEDs, Buzzers and Sensors. More importantly, the guide covers elements from the following strands of the Raspberry Pi Digital Making Curriculum:

  • Use basic programming constructs to create simple programs
  • Use basic digital, analogue, and electromechanical components
Source: Raspberry Pi Foundation

I adapted the guide to make Physical Computing with Rust. The resource is aimed at those who have some basic programming skills and know some Rust. Ideally, it is recommended to have completed at least the first three chapters of The Rust Programming Language Book.

Source: Physical Computing with Rust

Porting the guide was an easy process. I used mdbook⁶ which allows you to generate online books from Markdown files. The Raspberry Pi Foundation already had the content in the format required by mdbook with all content for a particular step in a separate Markdown file. I simply had to create the SUMMARY.md file and structure the project accordingly. Next, I modified the content for specific steps required to experiment using Rust.

The guide does not yet cover all the steps in the original resource.

Roadmap

As I learn more about Rust, I will continue to improve the rust_gpio crate and add corresponding tutorials to the Physical Computing with Rust guide. You can contribute to the project by sending PRs, commenting on the code or providing feedback. I intend to learn a lot from the community and any input is much appreciated. Finally, here are some things I wish to implement eventually:

  1. Use the Linux GPIO Character Device API instead of sysfs_gpio which has been deprecated since linux 4.4. Paul Osborne is already working on the rust interface⁸.
  2. Add background tasks. For e.g, blinking an LED should not block the thread
  3. Implement SPI devices API
Thank you so much for reading. A big thank you goes to ashley williams, @terkwood and Jonathan Pallant for their invaluable feedbacks.

Enjoyed this post?