mirror of https://github.com/rust-embedded/awesome-embedded-rust.git synced 2024-12-24 00:40:38 +00:00

Curated list of resources for Embedded and Low-level development in the Rust programming language

awesome awesome-list embedded embedded-systems libraries rust

Find a file

bors[bot] 656b848a17 Merge #190 190: update MAX7219 for new release r=adamgreig a=almindor I've taken over the MAX7219 driver since the original author didn't touch it for a year. Driver has been updated to use latest `embedded-hal`, documented and slightly extended with helper functions. I've made a release to crates.io as well since there was none done previously. Co-authored-by: Ales Katona <almindor@gmail.com>		2019-07-01 21:59:08 +00:00
.github	set up CI	2019-03-06 19:00:01 +01:00
.travis.yml	set up CI	2019-03-06 19:00:01 +01:00
Code-of-Conduct.md	Mention EWG as point of contact	2018-04-21 10:38:20 +03:00
CODE_OF_CONDUCT.md	README: mention the CoC and who maintains this repo	2018-08-07 00:36:02 -05:00
CONTRIBUTING.md	Clean up contribution guidelines	2018-04-21 10:38:20 +03:00
LICENSE-CC0	initial commit	2018-04-01 23:17:28 +02:00
README.md	Merge #190	2019-07-01 21:59:08 +00:00
rust-embedded-logo-256x256.png	Add logo	2018-04-06 18:03:26 +02:00

README.md

Embedded Rust

This is a curated list of resources related to embedded and low-level programming in the programming language Rust, including a list of useful crates.

This project is developed and maintained by the Resources team.

Don't see something you want or need here? Add it to the Not Yet Awesome Embedded Rust list!

Community
Books, blogs and training materials
Tools
Peripheral Access Crates
- Microchip
- Nordic
- NXP
- SiFive
- STMicroelectronics
- Texas Instruments
- MSP430
HAL implementation crates
- OS
- Nordic
- NXP
- SiFive
- STMicroelectronics
- Texas Instruments
- Espressif
- Silicon Labs
- XMC
Architecture support crates
- ARM
- RISC-V
- MIPS
Board support crates
Component abstraction crates
Driver crates
- WIP
no-std crates
- WIP
Rust forks
- AVR
Firmware projects
License

Community

In 2018 Rust community has created an embedded workgroup to help drive adoption in the Rust ecosystem.

Embedded WG, including newsletters with progress updates.
You can usually find the members of the embedded WG on the #rust-embedded channel (server: irc.mozilla.org).
embedded.rs Telegram chat about Rust for microcontrollers in Russian language.

Books, blogs and training materials

Discovery by @rust-embedded — this book is an introductory course on microcontroller-based embedded systems that uses Rust as the teaching language. Original author: @japaric
Cortex-M Quickstart by @japaric – a template and introduction to embedded Rust, suitable for developers familiar to embedded development but new to embedded Rust.
Exploring Rust on Teensy by @branan — Beginner set of articles on getting into embedded dev in Rust.
Pragmatic Bare Metal Rust A starter article about starting Rust development on STM32 microcontrollers (cubeMX + FFI).
Using Rust in an Embedded Project: A Simple Example Article and some links on setting up Rust cross-compiling.
Robigalia general purpose robust operating system in Rust running on secure seL4 microkernel.
Tock An embedded operating system designed for running multiple concurrent, mutually distrustful applications on low-memory and low-power microcontrollers
intermezzOS A small teaching operating system in Rust. A book with some explanations is also included.
Raspberry Pi Bare Metal Programming with Rust
- 32-bit Version (most Pi1 and Pi2 variants) A starter article on OSdev with Rust on RPi (cross-compiler setup and a very basic LED-blinking kernel).
- 64-bit Version (Pi2 Model B v1.2 and all Pi3) A growing collection of tutorials, from simple booting to interfacing components like UARTs or random number generators; Features a painless cross-toolchain setup.
Fearless concurrency by @japaric — How to easily develop Rust programs for pretty much any ARM Cortex-M microcontroller with memory-safe concurrency.
RTFM v2 Real-Time For the Masses — Cortex-M programming framework for building concurrent applications.
cortex-m rtfm RTFM framework for ARM Cortex-M microcontrollers
msp430 rtfm RTFM framework for MSP430 MCUs
FreeRTOS.rs Rust interface for the FreeRTOS API
MicroRust Introductory book for embedded development in Rust on the micro:bit.
Physical Computing With Rust A (WIP) guide to physical computing with Rust on the Raspberry Pi.
Internet of Streams A video series by @jamesmunns building a bare metal IoT Sensor Node Platform from (nearly) scratch in Rust

Tools

xargo Rust package manager with support for non-default std libraries — build rust runtime for your own embedded system.
- xargo is great but it's in maintenance mode, cargo-xbuild is catching up as intended replacement.
svd2rust Generate Rust structs with register mappings from SVD files.
μtest unit testing for microcontrollers and other no-std systems.
embedded-hal-mock Mock implementation of embedded-hal traits for testing without accessing real hardware. -
bindgen Automatically generates Rust FFI bindings to C and C++ libraries. -
cortex-m semihosting Semihosting for ARM Cortex-M processors
bobbin-cli A Rust command line tool to simplify embedded development and deployment.
cargo-fel4 A Cargo subcommand for working with feL4 projects. -

Peripheral Access Crates

Peripheral Access Crates were also called Device Crates.

NOTE You may be able to find even more peripheral access crates by searching for the svd2rust keyword on crates.io!

Microchip

atsamd21 Peripheral access API for Microchip (formerly Atmel) SAMD21 microcontrollers. This git repo hosts both the peripheral access crate and the hal.
atsamd51 Peripheral access API for Microchip (formerly Atmel) SAMD51 microcontrollers. This git repo hosts both the peripheral access crate and the hal.
avr-device Peripheral access API for Microchip (formerly Atmel) AVR microcontroller family.
sam3x8e Peripheral access API for Atmel SAMD3X8E microcontrollers (generated using svd2rust) -

Nordic

nrf51 Peripheral access API for nRF51 microcontrollers (generated using svd2rust) -
nrf52810-pac - Peripheral access API for the nRF52810 microcontroller (generated using svd2rust) -
nrf52832-pac - Peripheral access API for the nRF52832 microcontroller (generated using svd2rust) -
nrf52840-pac - Peripheral access API for the nRF52840 microcontroller (generated using svd2rust) -

NXP

SiFive

e310x - svd2rust generated interface to SiFive Freedom E310 MCUs -

STMicroelectronics

stm32f103xx Peripheral access API for STM32F103XX microcontrollers (generated using svd2rust) -
stm32f100xx Peripheral access API for STM32F100XX microcontrollers (generated using svd2rust) -
stm32f30x Peripheral access API for STM32F30X microcontrollers (generated using svd2rust) -
stm32f469xx Peripheral access API for STM32f469XX microcontrollers (generated using svd2rust) -
stm32l151 -

stm32-rs Peripheral access API for most STM32 microcontrollers (generated using svd2rust): stm32f0, stm32f1, stm32f2, stm32f3, stm32f4, stm32f7, stm32l0, stm32l1, stm32l4, stm32h7

Texas Instruments

tm4c123x Peripheral access API for TM4C123x microcontrollers (generated using svd2rust)
tm4c129x Peripheral access API for TM4C129x microcontrollers (generated using svd2rust)

MSP430

msp430g2553 Peripheral access API for MSP430G2553 microcontrollers (generated using svd2rust)
- msp430 quickstart some examples for msp430

HAL implementation crates

Implementations of embedded-hal for microcontroller families and systems running some OS. -

NOTE You may be able to find even more HAL implementation crates by searching for the embedded-hal-impl and embedded-hal keywords on crates.io!