2018-04-06 16:25:25 +00:00
# Embedded Rust
2018-04-01 21:17:28 +00:00
2018-04-06 16:26:00 +00:00
[![Awesome ](https://awesome.re/badge.svg )](https://awesome.re)
2018-04-06 16:25:25 +00:00
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.
2018-04-01 21:17:28 +00:00
2018-04-06 16:03:26 +00:00
[<img src="https://rawgit.com/rust-embedded/awesome-embedded-rust/master/rust-embedded-logo-256x256.png" align="right" width="256"> ](http://www.rust-embedded.org )
2018-08-07 05:36:02 +00:00
This project is developed and maintained by the [Resources team][team].
2018-04-01 21:17:28 +00:00
## Table of contents
2018-04-06 16:26:21 +00:00
* [Community ](#community )
2018-04-06 16:27:03 +00:00
* [Books, blogs and training materials ](#books-blogs-and-training-materials )
2018-04-06 16:27:19 +00:00
* [Tools ](#tools )
2018-04-01 21:17:28 +00:00
* [Device crates ](#device-crates )
* [Nordic ](#nordic )
2018-04-01 22:49:14 +00:00
* [NXP ](#nxp )
* [STMicroelectronics ](#stmicroelectronics )
2018-08-29 12:08:04 +00:00
* [Texas Instruments ](#texas-instruments )
2018-04-06 16:27:47 +00:00
* [MSP430 ](#msp430 )
2018-04-01 21:17:28 +00:00
* [HAL implementation crates ](#hal-implementation-crates )
* [OS ](#os )
* [Nordic ](#nordic-1 )
2018-04-01 22:49:14 +00:00
* [NXP ](#nxp-1 )
2018-04-01 21:17:28 +00:00
* [STMicroelectronics ](#stmicroelectronics-1 )
2018-08-29 12:08:04 +00:00
* [Texas Instruments ](#texas-instruments-1 )
2018-06-14 18:26:39 +00:00
* [Espressif ](#espressif )
2018-04-21 07:21:06 +00:00
* [Architecture support crates ](#architecture-support-crates )
* [ARM ](#arm )
2018-04-01 21:17:28 +00:00
* [Board support crates ](#board-support-crates )
2018-04-01 22:49:14 +00:00
* [Nordic ](#nordic-2 )
* [NXP ](#nxp-2 )
2018-04-01 21:17:28 +00:00
* [STMicroelectronics ](#stmicroelectronics-2 )
* [Driver crates ](#driver-crates )
* [WIP ](#wip )
* [no-std crates ](#no-std-crates )
2018-04-06 16:28:02 +00:00
* [Rust forks ](#rust-forks )
- [AVR ](#avr )
2018-05-02 14:22:53 +00:00
* [Firmware projects ](#firmware-projects )
2018-04-01 21:17:28 +00:00
* [License ](#license )
2018-04-06 16:26:21 +00:00
## Community
2018-04-21 07:22:54 +00:00
In 2018 Rust community has created an embedded workgroup to help drive adoption in the Rust ecosystem.
2018-04-06 16:26:21 +00:00
- [Embedded WG ](https://github.com/rust-lang-nursery/embedded-wg/ ), including newsletters with progress updates.
2018-04-21 07:28:28 +00:00
- You can usually find the members of the embedded WG on the `#rust-embedded` channel (server: `irc.mozilla.org` ).
2018-04-06 16:26:42 +00:00
- [embedded.rs ](https://t.me/embedded_rs ) Telegram chat about Rust for microcontrollers in Russian language.
2018-04-06 16:27:03 +00:00
## Books, blogs and training materials
2018-08-11 12:11:30 +00:00
- [Discovery ](https://rust-embedded.github.io/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
2018-05-28 16:27:54 +00:00
- [Cortex-M Quickstart ](https://docs.rs/cortex-m-quickstart/0.3.1/cortex_m_quickstart/ ) by @japaric – a template and introduction to embedded Rust, suitable for developers familiar to embedded development but new to embedded Rust.
2018-04-06 16:27:03 +00:00
- [Exploring Rust on Teensy ](https://branan.github.io/teensy/ ) by @branan — Beginner set of articles on getting into embedded dev in Rust.
- [Pragmatic Bare Metal Rust ](http://www.hashmismatch.net/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 ](https://spin.atomicobject.com/2016/07/08/rust-embedded-project-example/#.V3-os-6qlZw.hackernews ) Article and some links on setting up Rust cross-compiling.
- [Robigalia ](https://robigalia.org ) IoT operating system in Rust running on secure seL4 microkernel.
- [Tock ](https://www.tockos.org ) An embedded operating system designed for running multiple concurrent, mutually distrustful applications on low-memory and low-power microcontrollers
- [intermezzOS ](http://intermezzos.github.io ) A small teaching operating system in Rust. A book with some explanations is also included.
2018-04-07 11:11:02 +00:00
- Raspberry Pi Bare Metal Programming with Rust
- [32-bit Version (most Pi1 and Pi2 variants) ](https://medium.com/@thiagopnts/raspberry-pi-bare-metal-programming-with-rust-a6f145e84024 ) 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) ](https://github.com/andre-richter/rust-raspi3-tutorial ) A growing collection of tutorials, from simple booting to interfacing components like UARTs or random number generators; Features a painless cross-toolchain setup.
2018-04-06 16:27:03 +00:00
- [Fearless concurrency ](http://blog.japaric.io/fearless-concurrency/ ) by @japaric — How to easily develop Rust programs for pretty much any ARM Cortex-M microcontroller with memory-safe concurrency.
- [RTFM v2 ](http://blog.japaric.io/rtfm-v2/ ) Real-Time For the Masses — Cortex-M programming framework for building concurrent applications.
- [cortex-m rtfm ](https://github.com/japaric/cortex-m-rtfm ) RTFM framework for ARM Cortex-M microcontrollers
- [msp430 rtfm ](https://github.com/japaric/msp430-rtfm ) RTFM framework for MSP430 MCUs
- [FreeRTOS.rs ](https://github.com/hashmismatch/freertos.rs ) Rust interface for the FreeRTOS API
2018-07-23 19:28:16 +00:00
- [MicroRust ](https://droogmic.github.io/microrust/ ) Introductory book for embedded development in Rust on the micro:bit.
2018-04-06 16:27:03 +00:00
2018-04-06 16:27:19 +00:00
## Tools
- [xargo ](https://github.com/japaric/xargo ) Rust package manager with support for non-default std libraries — build rust runtime for your own embedded system.
- [svd2rust ](https://github.com/japaric/svd2rust ) Generate Rust structs with register mappings from SVD files.
- [μtest ](https://github.com/japaric/utest ) unit testing for microcontrollers and other no-std systems.
2018-04-08 08:54:45 +00:00
- [bindgen ](https://crates.io/crates/bindgen ) Automatically generates Rust FFI bindings to C and C++ libraries. - ![crates.io ](https://img.shields.io/crates/v/bindgen.svg )
2018-04-06 16:27:19 +00:00
- [cortex-m semihosting ](https://github.com/japaric/cortex-m-semihosting ) Semihosting for ARM Cortex-M processors
2018-05-06 22:57:17 +00:00
- [bobbin-cli ](https://github.com/bobbin-rs/bobbin-cli ) A Rust command line tool to simplify embedded development and deployment.
2018-04-06 16:27:19 +00:00
2018-04-01 21:17:28 +00:00
## Device crates
2018-04-08 08:54:45 +00:00
Register definition for microcontroller families. Usually generated using [`svd2rust`]. - ![crates.io ](https://img.shields.io/crates/v/svd2rust.svg )
2018-04-01 21:17:28 +00:00
2018-08-07 05:36:02 +00:00
[`svd2rust`]: https://crates.io/crates/svd2rust
2018-04-01 21:17:28 +00:00
*NOTE* You may be able to find even more device crates by searching for the
[`svd2rust`][svd2rust-kw] keyword on crates.io!
[svd2rust-kw]: https://crates.io/keywords/svd2rust
2018-04-21 16:33:00 +00:00
### Microchip
2018-04-21 06:53:33 +00:00
2018-04-21 16:33:00 +00:00
- [`atsamd21` ](https://github.com/wez/atsamd21-rs ) Peripheral access API for Microchip (formerly Atmel) SAMD21 microcontrollers. This git repo hosts both the device crate and the hal.
2018-04-21 06:53:33 +00:00
2018-04-01 22:49:14 +00:00
### Nordic
2018-04-08 08:54:45 +00:00
- [`nrf51` ](https://crates.io/crates/nrf51 ) Peripheral access API for nRF51 microcontrollers (generated using svd2rust) - ![crates.io ](https://img.shields.io/crates/v/nrf51.svg )
2018-04-01 22:49:14 +00:00
### NXP
2018-04-08 08:54:45 +00:00
- [`lpc82x` ](https://crates.io/crates/lpc82x ) - ![crates.io ](https://img.shields.io/crates/v/lpc82x.svg )
- [`mkw41z` ](https://crates.io/crates/mkw41z ) - ![crates.io ](https://img.shields.io/crates/v/mkw41z.svg )
2018-04-08 17:02:14 +00:00
- [`k64` ](https://crates.io/crates/k64 ) - ![crates.io ](https://img.shields.io/crates/v/k64.svg )
2018-04-01 22:49:14 +00:00
2018-04-01 21:17:28 +00:00
### STMicroelectronics
2018-04-08 08:54:45 +00:00
- [`stm32f042` ](https://crates.io/crates/stm32f042 ) - ![crates.io ](https://img.shields.io/crates/v/stm32f042.svg )
- [`stm32f103xx` ](https://crates.io/crates/stm32f103xx ) Peripheral access API for STM32F103XX microcontrollers (generated using svd2rust) - ![crates.io ](https://img.shields.io/crates/v/stm32f103xx.svg )
- [`stm32f100xx` ](https://github.com/japaric/stm32f100xx ) Peripheral access API for STM32F100XX microcontrollers (generated using svd2rust) - ![crates.io ](https://img.shields.io/crates/v/stm32f100xx.svg )
- [`stm32f30x` ](https://crates.io/crates/stm32f30x ) Peripheral access API for STM32F30X microcontrollers (generated using svd2rust) - ![crates.io ](https://img.shields.io/crates/v/stm32f30x.svg )
- [`stm32f429` ](https://crates.io/crates/stm32f429 ) Peripheral access API for STM32F429 microcontrollers (generated using svd2rust) - ![crates.io ](https://img.shields.io/crates/v/stm32f429.svg )
2018-05-16 18:58:27 +00:00
- [`stm32f469xx` ](https://crates.io/crates/stm32f469xx ) Peripheral access API for STM32f469XX microcontrollers (generated using svd2rust) -![crates.io](https://img.shields.io/crates/v/stm32f469xx.svg)
2018-04-08 08:54:45 +00:00
- [`stm32l151` ](https://crates.io/crates/stm32l151 ) - ![crates.io ](https://img.shields.io/crates/v/stm32l151.svg )
2018-05-30 09:08:15 +00:00
* [`stm32-rs` ](https://github.com/adamgreig/stm32-rs ) Peripheral access API for most STM32 microcontrollers (generated using svd2rust): [stm32f0 ](https://crates.io/crates/stm32f0 ), [stm32f1 ](https://crates.io/crates/stm32f1 ), [stm32f2 ](https://crates.io/crates/stm32f2 ), [stm32f3 ](https://crates.io/crates/stm32f3 ), [stm32f4 ](https://crates.io/crates/stm32f4 ), [stm32f7 ](https://crates.io/crates/stm32f7 ), [stm32l0 ](https://crates.io/crates/stm32l0 ), [stm32l1 ](https://crates.io/crates/stm32l1 ), [stm32l4 ](https://crates.io/crates/stm32l4 ), [stm32h7 ](https://crates.io/crates/stm32h7 )
2018-04-01 21:17:28 +00:00
2018-08-29 12:08:04 +00:00
### Texas Instruments
- [`tm4c123x` ](https://crates.io/crates/tm4c123x ) Peripheral access API for TM4C123x microcontrollers (generated using svd2rust)
2018-08-29 14:51:55 +00:00
- [`tm4c129x` ](https://crates.io/crates/tm4c129x ) Peripheral access API for TM4C129x microcontrollers (generated using svd2rust)
2018-08-29 12:08:04 +00:00
2018-04-06 16:27:47 +00:00
### MSP430
2018-04-21 07:21:24 +00:00
2018-04-06 16:27:47 +00:00
- [`msp430g2553` ](https://github.com/japaric/msp430g2553 ) Peripheral access API for MSP430G2553 microcontrollers (generated using svd2rust)
- [rust on msp ](https://github.com/japaric/rust_on_msp ) Simple blinking LED example that runs on MSP430.
- [msp430 quickstart ](https://github.com/japaric/msp430-quickstart ) some examples for msp430
2018-04-01 21:17:28 +00:00
## HAL implementation crates
2018-04-08 08:54:45 +00:00
Implementations of [`embedded-hal`] for microcontroller families and systems running some OS. - ![crates.io ](https://img.shields.io/crates/v/embedded-hal.svg )
2018-04-01 21:17:28 +00:00
2018-08-07 05:36:02 +00:00
[`embedded-hal`]: https://crates.io/crates/embedded-hal
2018-04-01 21:17:28 +00:00
*NOTE* You may be able to find even more HAL implementation crates by searching for the
[`embedded-hal-impl`] and [`embedded-hal`][embedded-hal-kw] keywords on crates.io!
[`embedded-hal-impl`]: https://crates.io/keywords/embedded-hal-impl
[embedded-hal-kw]: https://crates.io/keywords/embedded-hal
### OS
2018-04-08 08:54:45 +00:00
- [`linux-embedded-hal`] for embedded Linux systems like the Raspberry Pi. - ![crates.io ](https://img.shields.io/crates/v/linux-embedded-hal.svg )
2018-04-01 21:17:28 +00:00
2018-08-07 05:36:02 +00:00
[`linux-embedded-hal`]: https://crates.io/crates/linux-embedded-hal
2018-04-01 21:17:28 +00:00
### Nordic
2018-04-08 08:54:45 +00:00
- [`nrf51-hal` ](https://crates.io/crates/nrf51-hal ) - ![crates.io ](https://img.shields.io/crates/v/nrf51-hal.svg )
2018-04-01 21:17:28 +00:00
### NXP
Also check the list of [NXP board support crates][nxp-bsc]!
[nxp-bsc]: #nxp -1
2018-05-02 05:16:59 +00:00
- [`lpc82x-hal` ](https://crates.io/crates/lpc82x-hal ) - [![crates.io ](https://img.shields.io/crates/v/lpc82x-hal.svg )](https://crates.io/crates/lpc82x-hal)
2018-04-01 21:17:28 +00:00
2018-04-08 08:54:45 +00:00
- [`mkw41z-hal` ](https://crates.io/crates/mkw41z-hal ) - ![crates.io ](https://img.shields.io/crates/v/mkw41z-hal.svg )
2018-04-01 21:17:28 +00:00
### STMicroelectronics
Also check the list of [STMicroelectronics board support crates][stm-bsc]!
[stm-bsc]: #stmicroelectronics -2
2018-04-08 08:54:45 +00:00
- [`stm32f042-hal` ](https://crates.io/crates/stm32f042-hal ) - ![crates.io ](https://img.shields.io/crates/v/stm32f042-hal.svg )
2018-04-01 21:17:28 +00:00
- Has examples that can run on boards like the [Nucleo-F042K6] and similar boards
[Nucleo-F042K6]: http://www.st.com/en/evaluation-tools/nucleo-f042k6.html
- [`stm32f103xx-hal` ](https://github.com/japaric/stm32f103xx-hal )
2018-04-01 22:49:14 +00:00
- Has examples that can run on boards like the [Blue pill], [Nucleo-F103RB] and similar boards
[Nucleo-F103RB]: http://www.st.com/en/evaluation-tools/nucleo-f103rb.html
2018-04-01 21:17:28 +00:00
2018-04-08 08:54:45 +00:00
- [`stm32f30x-hal` ](https://crates.io/crates/stm32f30x-hal ) - ![crates.io ](https://img.shields.io/crates/v/stm32f30x-hal.svg )
2018-04-01 21:17:28 +00:00
2018-04-08 08:54:45 +00:00
- [`stm32f429-hal` ](https://crates.io/crates/stm32f429-hal ) - ![crates.io ](https://img.shields.io/crates/v/stm32f429-hal.svg )
2018-04-07 21:49:02 +00:00
2018-04-08 08:54:45 +00:00
- [`stm32l151-hal` ](https://crates.io/crates/stm32l151-hal ) - ![crates.io ](https://img.shields.io/crates/v/stm32l151-hal.svg )
2018-04-02 09:59:50 +00:00
2018-08-13 16:41:45 +00:00
- [`stm32l432xx-hal` ](https://crates.io/crates/stm32l432xx-hal ) - ![crates.io ](https://img.shields.io/crates/v/stm32l432xx-hal.svg )
- Has examples that can run on boards like the [Nucleo-L432KC] and similar boards
[Nucleo-L432KC]: https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-l432kc.html
2018-04-01 21:17:28 +00:00
### Texas Instruments
- [`tm4c123x-hal` ](https://github.com/thejpster/tm4c123x-hal )
[Blue pill]: http://wiki.stm32duino.com/index.php?title=Blue_Pill
2018-06-14 18:17:23 +00:00
### Espressif
- [`esp8266-hal` ](https://github.com/emosenkis/esp8266-hal ) ![crates.io ](https://img.shields.io/crates/v/esp8266-hal.svg ) (not supported by rustc, so must be built with [mrustc ](https://github.com/thepowersgang/mrustc ), typically via the [esp-rs ](https://github.com/emosenkis/esp-rs ) build script)
2018-04-21 07:21:06 +00:00
## Architecture support crates
Crates tailored for general CPU architectures.
### ARM
2018-08-14 19:03:31 +00:00
- [`cortex-m` ](https://github.com/japaric/cortex-m ) Low level access to Cortex-M processors - ![crates.io ](https://img.shields.io/crates/v/cortex-m.svg )
- [`cortex-a` ](https://github.com/andre-richter/cortex-a ) Low level access to Cortex-A processors (early state) - ![crates.io ](https://img.shields.io/crates/v/cortex-a.svg )
2018-04-21 07:21:06 +00:00
2018-04-01 21:17:28 +00:00
## Board support crates
2018-08-01 12:03:06 +00:00
Crates tailored for specific boards.
2018-04-01 21:17:28 +00:00
[STM32F3DISCOVERY]: http://www.st.com/en/evaluation-tools/stm32f3discovery.html
2018-04-01 22:49:14 +00:00
### Nordic
2018-04-08 08:54:45 +00:00
- [`microbit` ](https://crates.io/crates/microbit ) - [micro:bit] - ![crates.io ](https://img.shields.io/crates/v/microbit.svg )
2018-04-01 22:49:14 +00:00
[micro:bit]: http://microbit.org/
2018-04-01 21:17:28 +00:00
### NXP
2018-04-08 08:54:45 +00:00
- [`frdm-kw41z` ](https://crates.io/crates/frdm-kw41z ) - [FRDM-KW41Z] - ![crates.io ](https://img.shields.io/crates/v/frdm-kw41z.svg )
2018-04-01 21:17:28 +00:00
[FRDM-KW41Z]: https://www.nxp.com/products/processors-and-microcontrollers/arm-based-processors-and-mcus/kinetis-cortex-m-mcus/w-serieswireless-conn.m0-plus-m4/freedom-development-kit-for-kinetis-kw41z-31z-21z-mcus:FRDM-KW41Z
### STMicroelectronics
2018-04-01 22:49:14 +00:00
- [`nucleo-f042k6` ](https://github.com/therealprof/nucleo-f042k6.git ) - [Nucleo-F042K6]
- [`nucleo-f103rb` ](https://github.com/therealprof/nucleo-f103rb.git ) - [Nucleo-F103RB]
2018-04-08 08:54:45 +00:00
- [`f3` ](https://crates.io/crates/f3 ) Board Support Crate for the [STM32F3DISCOVERY] - ![crates.io ](https://img.shields.io/crates/v/f3.svg )
2018-04-06 16:28:32 +00:00
- [`blue-pill` ](https://github.com/japaric/blue-pill ) Board Support Crate for [Blue Pill].
2018-04-01 21:17:28 +00:00
2018-07-09 16:40:11 +00:00
### Texas Instruments
- [`stellaris-launchpad` ](https://crates.io/crates/stellaris-launchpad ) - For the Texas Instruments Stellaris Launchpad and Tiva-C Launchpad ![crates.io ](https://img.shields.io/crates/v/stellaris-launchpad.svg )
- [`monotron` ](https://github.com/thejpster/monotron ) - A 1980s home-computer style application for the Texas Instruments Stellaris Launchpad. PS/2 keyboard input, text output on a bit-bashed 800x600 VGA signal. Uses [menu], [vga-framebuffer] and [pc-keyboard].
2018-08-01 12:03:06 +00:00
### Special Purpose
- [`betafpv-f3` ](https://github.com/JoshMcguigan/betafpv-f3 ) - For the BetaFPV F3 drone flight controller
2018-04-01 21:17:28 +00:00
## Driver crates
Platform agnostic crates to interface external components. These crates use the [`embedded-hal`]
interface to support [all the devices and systems that implement the `embedded-hal`
traits][hal-impl].
[hal-impl]: #hal -implementation-crates
The list below contains drivers developed as part of the [Weekly Driver initiative][wd] and that
have achieved the "released" status (published on crates.io + documentation / short blog post).
[wd]: https://github.com/rust-lang-nursery/embedded-wg/issues/39
2018-04-08 08:54:45 +00:00
1. [L3GD20] - SPI - Gyroscope - [Intro blog post][1& 2] - ![crates.io ](https://img.shields.io/crates/v/l3gd20.svg )
2. [LSM303DLHC] - I2C - Accelerometer + compass (magnetometer) - [Intro blog post][1& 2] - ![crates.io ](https://img.shields.io/crates/v/lsm303dlhc.svg )
3. [MCP3008] - SPI - 8 channel 10-bit ADC - [Intro blog post][3] - ![crates.io ](https://img.shields.io/crates/v/adc-mcp3008.svg )
4. [ENC28J60] - SPI - Ethernet controller - [Intro blog post][4] - ![crates.io ](https://img.shields.io/crates/v/enc28j60.svg )
5. [MCP3425] - I2C - 16-bit ADC - [Intro blog post][5] - ![crates.io ](https://img.shields.io/crates/v/mcp3425.svg )
6. [SGP30] - I2C - Gas sensor - [Intro blog post][6] - ![crates.io ](https://img.shields.io/crates/v/sgp30.svg )
7. [HTS221] - I2C - Humidity and temperature sensor - [Intro blog post][7] - ![crates.io ](https://img.shields.io/crates/v/hts221.svg )
2018-04-30 11:44:15 +00:00
8. [SSD1306] - I2C/SPI - OLED display controller - [Intro blog post][8] - ![crates.io ](https://img.shields.io/crates/v/ssd1306.svg )
2018-05-03 19:04:05 +00:00
9. [MMA7660FC] - I2C - 3-axis accelerometer - [Intro blog post][9]
2018-07-06 03:42:07 +00:00
10. [shift-register-driver] - GPIO - Shift register - [Intro blog post][10] - ![crates.io ](https://img.shields.io/crates/v/shift-register-driver.svg )
2018-07-15 19:12:57 +00:00
11. [TSL256X] - I2C - Light Intensity Sensor - [Intro blog post][11] - ![crates.io ](https://img.shields.io/crates/v/tsl256x.svg )
2018-04-01 21:17:28 +00:00
[L3GD20]: https://crates.io/crates/l3gd20
[LSM303DLHC]: https://crates.io/crates/lsm303dlhc
[1& 2]: http://blog.japaric.io/wd-1-2-l3gd20-lsm303dlhc-madgwick/
[MCP3008]: https://crates.io/crates/adc-mcp3008
[3]: http://pramode.in/2018/02/24/an-introduction-to-writing-embedded-hal-based-drivers-in-rust/
[ENC28J60]: https://crates.io/crates/enc28j60
[4]: http://blog.japaric.io/wd-4-enc28j60/
[MCP3425]: https://crates.io/crates/mcp3425
[5]: https://blog.dbrgn.ch/2018/3/13/rust-mcp3425-driver/
[SGP30]: https://crates.io/crates/sgp30
[6]: https://blog.dbrgn.ch/2018/4/1/rust-sgp30-driver/
2018-04-02 17:21:21 +00:00
[HTS221]: https://crates.io/crates/hts221
[7]: https://medium.com/@pdanielgallagher/hts221-humidity-and-temperature-sensor-88056ea9e5fa
2018-04-30 11:44:15 +00:00
[SSD1306]: https://crates.io/crates/ssd1306
[8]: https://wapl.es/electronics/rust/2018/04/30/ssd1306-driver.html
2018-05-03 19:04:05 +00:00
[MMA7660FC]: https://crates.io/crates/mma7660fc
[9]: https://rahul-thakoor.github.io/an-i2c-rust-driver-for-mma7660fc-based-3-axis-digital-accelerometer/
2018-07-06 03:42:07 +00:00
[shift-register-driver]: https://crates.io/crates/shift-register-driver
[10]: https://www.joshmcguigan.com/blog/shift-register-driver/
2018-07-15 19:12:57 +00:00
[TSL256X]: https://crates.io/crates/tsl256x
[11]: https://www.joshmcguigan.com/blog/tsl256x-light-intensity-sensor-driver/
2018-04-01 21:17:28 +00:00
*NOTE* You may be able to find even more driver crates by searching for the [`embedded-hal-driver`]
keyword on crates.io!
[`embedded-hal-driver`]: https://crates.io/keywords/embedded-hal-driver
### WIP
Work in progress drivers. Help the authors make these crates awesome!
- [MFRC522] - SPI - RFID tag reader/writer
- [MPU9250] - SPI - Accelerometer + gyroscope + compass
- [motor-driver] - Motor drivers: L298N, TB6612FNG, etc.
- [MAG3110] - I2C - Magnetometer
- [SI5351] - I2C - clock generator
- [SI7021] - I2C - Humidity and temperature sensor
- [MAX7219] - SPI - LED display driver
- [DS3231] - I2C - real time clock
- [BH1750] - I2C - ambient light sensor (lux meter)
- [SHT2x] - I2C - temperature / humidity sensors
2018-04-08 08:54:45 +00:00
- [INA260] - I2C - power monitor - ![crates.io ](https://img.shields.io/crates/v/ina260.svg )
2018-04-01 21:17:28 +00:00
- [ILI9341] - SPI - TFT LCD display
- [HD44780] - Parallel port - LCD controller
2018-08-08 23:12:59 +00:00
- [HD44780-driver] - GPIO - LCD controller - ![crates.io ](https://img.shields.io/crates/v/hd44780-driver.svg )
2018-04-08 08:54:45 +00:00
- [MCP9808] - I2C - Temperature sensor - ![crates.io ](https://img.shields.io/crates/v/mcp9808.svg )
2018-04-01 21:17:28 +00:00
- [AXP209] - I2C - Power management unit
- [DS3234] - SPI - Real time clock
- [PCD8544] - SPI - 48x84 pixels matrix LCD controller
2018-07-16 14:59:08 +00:00
- [PCD8544_rich] - SPI - Rich driver for 48x84 pixels matrix LCD controller - ![crates.io ](https://img.shields.io/crates/v/pcd8544.svg )
2018-04-01 21:17:28 +00:00
- [HC-SR04] - DIO - Ultrasound sensor
- [AFE4400] - SPI - Pulse oximeter
2018-04-04 20:02:14 +00:00
- [SX1278] - SPI - Long range (LoRa) transceiver
2018-04-01 21:17:28 +00:00
- [RFM69] - SPI - ISM radio transceiver
- [LS010B7DH01] - SPI - Memory LCD
2018-04-02 02:33:40 +00:00
- [MAX31855] - SPI - Thermocouple digital converter
2018-05-09 12:24:45 +00:00
- [MAX31865] - SPI - RTD to Digital converter - ![crates.io ](https://img.shields.io/crates/v/max31865.svg )
2018-04-02 10:59:31 +00:00
- [SHT3x] - I2C - Temperature / humidity sensors
2018-04-21 06:29:12 +00:00
- [SX1509] - I2C - IO Expander / Keypad driver
2018-04-29 20:20:48 +00:00
- [NRF24L01] - SPI - 2.4 GHz wireless communication
2018-05-15 00:34:21 +00:00
- [embedded-nrf24l01] - SPI+GPIO - 2.4 GHz radio
- [stm32-eth] - MCU - Ethernet
2018-06-22 19:41:28 +00:00
- [bme680] - I2C - Temperature / humidity / gas / pressure sensor - ![crates.io ](https://img.shields.io/crates/v/bme680.svg )
2018-07-17 20:42:29 +00:00
- [w5500] - SPI - Ethernet Module with hardwired protocols : TCP, UDP, ICMP, IPv4, ARP, IGMP, PPPoE - ![crates.io ](https://img.shields.io/crates/v/w5500.svg )
2018-07-16 15:19:54 +00:00
- [OneWire] - 1wire - OneWire protocol implementation with drivers for devices such as [DS18B20 ](https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf ) - ![crates.io ](https://img.shields.io/crates/v/onewire.svg )
2018-07-21 11:52:56 +00:00
- [SSD1322] - SPI - Graphical OLED display controller - ![crates.io ](https://img.shields.io/crates/v/ssd1322.svg )
2018-07-27 14:06:51 +00:00
- [GridEYE] - I2C - Rust driver for Grid-EYE / Panasonic AMG88(33)
2018-08-18 07:49:43 +00:00
- [EEPROM24x] - I2C - 24x series serial EEPROM driver ![crates.io ](https://img.shields.io/crates/v/eeprom24x.svg )
2018-08-17 07:21:07 +00:00
- [DS1307] - I2C - Real-time clock driver - ![crates.io ](https://img.shields.io/crates/v/ds1307.svg )
2018-08-22 16:38:21 +00:00
- [PCF857x] - I2C - I/O expanders: PCF8574, PCF8574A, PCF8575 ![crates.io ](https://img.shields.io/crates/v/pcf857x.svg )
2018-08-29 12:06:21 +00:00
- [eink-waveshare] - SPI - driver for E-Paper Modules from Waveshare
2018-09-04 02:30:09 +00:00
- [BlueNRG] - SPI - driver for BlueNRG-MS Bluetooth module. ![crates.io ](https://img.shields.io/crates/v/bluenrg.svg )
2018-04-01 21:17:28 +00:00
[MFRC522]: https://github.com/japaric/mfrc522
[MPU9250]: https://github.com/japaric/mpu9250
[motor-driver]: https://github.com/japaric/motor-driver
[MAG3110]: https://github.com/therealprof/mag3110
[SI5351]: https://github.com/ilya-epifanov/si5351
[SI7021]: https://github.com/wose/si7021
[MAX7219]: https://github.com/maikelwever/max7219
[DS3231]: https://github.com/wose/ds3231
[BH1750]: https://github.com/wose/bh1750
[SHT2x]: https://github.com/dbrgn/sht2x-rs
[INA260]: https://crates.io/crates/ina260
[ILI9341]: https://github.com/yuri91/ili9341-rs
[HD44780]: http://github.com/kunerd/clerk
2018-08-09 12:00:55 +00:00
[HD44780-driver]: https://crates.io/crates/hd44780-driver
2018-04-01 21:17:28 +00:00
[MCP9808]: https://crates.io/crates/mcp9808
[PCD8544]: https://github.com/pcein/pcd8544
2018-07-16 14:59:08 +00:00
[PCD8544_rich]: https://crates.io/crates/pcd8544
2018-04-01 21:17:28 +00:00
[AXP209]: https://github.com/RandomInsano/axp209-rs
[DS3234]: https://github.com/rust-lang-nursery/embedded-wg/issues/39#issuecomment-375262785
[HC-SR04]: https://github.com/nordmoen/hc-sr04
[AFE4400]: https://github.com/ReeceStevens/afe4400
[SX1278]: https://github.com/susu/sx1278
[RFM69]: https://github.com/lolzballs/rfm69
[LS010B7DH01]: https://github.com/byronwasti/ls010b7dh01
2018-04-02 02:33:40 +00:00
[MAX31855]: https://github.com/mbacch/max31855
2018-05-09 12:25:36 +00:00
[MAX31865]: https://crates.io/crates/max31865
2018-04-02 10:59:31 +00:00
[SHT3x]: https://github.com/miek/sht3x-rs
2018-04-21 06:29:12 +00:00
[SX1509]: https://github.com/wez/sx1509
2018-04-29 20:20:48 +00:00
[NRF24L01]: https://github.com/maikelwever/nrf24l01
2018-05-15 00:34:21 +00:00
[embedded-nrf24l01]: https://crates.io/crates/embedded-nrf24l01
[stm32-eth]: https://github.com/astro/stm32-eth
2018-06-22 19:41:28 +00:00
[bme680]: https://github.com/marcelbuesing/bme680
2018-07-17 20:42:29 +00:00
[w5500]: https://crates.io/crates/w5500
2018-07-16 15:19:54 +00:00
[OneWire]: https://crates.io/crates/onewire
2018-07-21 11:52:56 +00:00
[SSD1322]: https://crates.io/crates/ssd1322
2018-07-27 14:06:51 +00:00
[GridEYE]: https://github.com/uwearzt/grideye
2018-08-18 07:49:43 +00:00
[EEPROM24x]: https://crates.io/crates/eeprom24x
2018-08-17 09:52:35 +00:00
[DS1307]: https://crates.io/crates/ds1307
2018-08-22 16:38:21 +00:00
[PCF857x]: https://crates.io/crates/pcf857x
2018-08-29 12:06:21 +00:00
[eink-waveshare]: https://crates.io/crates/eink_waveshare_rs
2018-09-04 02:30:09 +00:00
[BlueNRG]: https://crates.io/crates/bluenrg
2018-04-01 21:17:28 +00:00
## no-std crates
2018-04-02 09:59:50 +00:00
[`#![no_std]` crates][no-std-category] designed to run on resource constrained devices.
2018-04-01 21:17:28 +00:00
2018-04-08 08:54:45 +00:00
- [bit_field ](https://crates.io/crates/bit_field ): manipulating bitfields and bitarrays - ![crates.io ](https://img.shields.io/crates/v/bit_field.svg )
- [heapless ](https://crates.io/crates/heapless ): provides `Vec` , `String` , `LinearMap` , `RingBuffer` backed by fixed-size buffers - ![crates.io ](https://img.shields.io/crates/v/heapless.svg )
2018-05-26 23:39:03 +00:00
- [intrusive-collections ](https://crates.io/crates/intrusive-collections ): intrusive (non-allocating) singly/doubly linked lists and red-black trees - ![crates.io ](https://img.shields.io/crates/v/intrusive-collections.svg )
2018-04-08 08:54:45 +00:00
- [managed ](https://crates.io/crates/managed ): provides `ManagedSlice` , `ManagedMap` backed by either their std counterparts or fixed-size buffers for `#![no_std]` . - ![crates.io ](https://img.shields.io/crates/v/managed.svg )
2018-05-26 23:38:08 +00:00
- [nalgebra ](https://crates.io/crates/nalgebra ): general-purpose and low-dimensional linear algebra library - ![crates.io ](https://img.shields.io/crates/v/nalgebra.svg )
2018-04-23 22:11:40 +00:00
- [smoltcp ](https://github.com/m-labs/smoltcp ): a small TCP/IP stack that runs without `alloc`
2018-04-23 23:23:32 +00:00
- [embedded-graphics ](https://crates.io/crates/embedded-graphics ): 2D drawing library for any size display - ![crates.io ](https://img.shields.io/crates/v/embedded-graphics.svg )
2018-04-29 18:27:21 +00:00
- [scroll ](https://crates.io/crates/scroll ): extensible and endian-aware Read/Write traits for generic containers - ![crates.io ](https://img.shields.io/crates/v/scroll.svg )
2018-07-09 16:40:11 +00:00
- [vga-framebuffer]: A VGA signal generator and font renderer for VGA-less microcontrollers. Used by [Monotron ](https://github.com/thejpster/monotron ) to generate 48 by 36 character display using 3 SPI peripherals and a timer.
- [menu]: A basic command-line interface library. Has nested menus and basic help functionality.
- [pc-keyboard]: A PS/2 keyboard protocol driver. Transport (bit-banging or SPI) agnostic, but can convert Set 2 Scancodes into Unicode.
- [console-traits ](https://github.com/thejpster/console-traits ): Describes a basic text console. Used by [menu] and implemented by [vga-framebuffer].
2018-08-14 19:03:31 +00:00
- [register-rs ](https://github.com/rust-osdev/register-rs ): Unified interface for MMIO and CPU registers. Provides type-safe bitfield manipulation. - ![crates.io ](https://img.shields.io/crates/v/register.svg )
2018-07-09 16:40:11 +00:00
[pc-keyboard]: https://github.com/thejpster/pc-keyboard
[vga-framebuffer]: https://github.com/thejpster/vga-framebuffer-rs
[menu]: https://github.com/thejpster/menu
2018-04-02 09:59:50 +00:00
2018-05-19 15:18:52 +00:00
### WIP
Work in progress crates. Help the authors make these crates awesome!
2018-05-13 20:06:44 +00:00
- [light-cli ](https://github.com/rudihorn/light-cli ): a lightweight heapless cli interface
2018-09-04 02:30:09 +00:00
- [bluetooth-hci ](https://crates.io/crates/bluetooth-hci ): device-independent Bluetooth Host-Controller Interface implementation.
2018-04-02 09:59:50 +00:00
[no-std-category]: https://crates.io/categories/no-std
2018-04-01 21:17:28 +00:00
2018-04-06 16:28:02 +00:00
## Rust forks
### AVR
- [AVR Rust ](https://github.com/avr-rust/rust ) Fork of Rust with AVR support.
2018-05-02 14:22:53 +00:00
## Firmware projects
- [anne-key ](https://github.com/ah-/anne-key ): Alternate keyboard firmware for the Obins ANNE Pro
2018-04-01 21:17:28 +00:00
## License
This list is licensed under
- CC0 1.0 Universal License ([LICENSE-CC0](LICENSE-CC0) or
https://creativecommons.org/publicdomain/zero/1.0/legalcode)
2018-08-07 05:36:02 +00:00
## Code of Conduct
Contribution to this crate is organized under the terms of the [Rust Code of
Conduct][CoC], the maintainer of this crate, the [HAL team][team], promises
to intervene to uphold that code of conduct.
[CoC]: CODE_OF_CONDUCT.md
[team]: https://github.com/rust-embedded/wg#the-hal-team