Skip to content

Latest commit

 

History

History
68 lines (42 loc) · 2.07 KB

README.md

File metadata and controls

68 lines (42 loc) · 2.07 KB

badge-2021-rs

This is a no_std application targeting Espressif's ESP32 (Xtensa).

It was generated using this template:

$ cargo generate https://github.com/esp-rs/esp-template

Why Rust

Brian Schwind from tonari has written a decent primer on hardware projects with Rust, detailing how it went for them and referencing the great work that the embedded devices working group is doing to support Rust on embedded hardware.

Scott Mabin from Espressif gave an excellent introduction to embedded Rust and async.

rusty Rust gear logo Ferris

Target

We are using an ESP32 (Xtensa, no S variant) chip with the current module on https://github.com/das-labor/badge-2021.

Preparation

Follow the toolchain installation instruction from the esp-rs book.

Install cargo-espflash.

Usage

To build, flash and monitor the app, run make flash.

Resources

Check out the Embedded Rust Book and have a look at Ferrous Systems' book on Rust for Espressif chips.

RISC-V Variant ESP32-C3

You may design a different pin compatible SoM for the badge, e.g., based on the ESP32-C3.

See https://github.com/shanemmattner/ESP32-C3_Rust_Tutorials for concrete examples.

The Badge

Labor Badge 2021

Labor Badge 2021 with pixel art

License

MIT license (LICENSE or http://opensource.org/licenses/MIT)