Embedded devices Working Group

Coordination repository of the embedded devices Working Group (WG)

This repository issue tracker is used by the embedded WG to coordinate efforts towards making Rust
a great choice for embedded development.

Want to get started with embedded development with Rust? Check out our
embedded Rust book and the rest of our bookshelf.

Want to stay up-to-date with community progress? Check out our newsletter.

Join the discussion on Matrix! #rust-embedded:matrix.org

Vision

What is it that we really want? At a broad level:

• To improve the absolute quality (functionality, safety, performance) of embedded software in the
  wild.
• To improve the productivity of embedded software development teams, by reducing the tangible and
  intangible costs of achieving a level of quality.
• To improve the experience for programmers developing for embedded systems.
• To make embedded systems programming more accessible for people that are not already embedded
  systems developers.

What we do

At a high level we have two main tasks:

We work with the community to improve the embedded ecosystem.

• We maintain and develop core crates in the embedded ecosystem ensuring that the development
  roadmap aligns with the needs of its users. You can find all the crates we maintain in the
  Organization section.

• We develop and curate resources about embedded Rust development. Check our
  bookshelf!

• We maintain and moderate the venues the embedded community uses to discuss. That includes this
  coordination repository and our Matrix room (#rust-embedded:matrix.org).

And, we serve as a bridge between the Rust teams and the embedded community.

• If you need a language or a compiler feature to improve your embedded software let us know and
  we'll discuss your request with the appropriate Rust team. For example, see this request for
  making the compiler emit information about the stack usage of functions, which was later
  implemented as an experimental feature.

• Similarly, if you need some unstable API in the standard library to be stabilized to make your
  crate work on the stable we'll forward your request to the library team. For example, see this
  proposal to add ARM instructions to core::arch::arm to eliminate the need for the unstable
  inline assembly feature (asm!) in the most common scenarios.

How you can help

Everyone can contribute to the embedded WG efforts! There are several ways to help out:

• Let us know where the gaps are. If you think the language, the compiler, the tooling, the
  documentation or the crate ecosystem is lacking some feature, information or library to build
  embedded software let us know and we'll bring it up to the Rust teams or organize the community to
  build the crates or tools to fill the gaps.

• Participate in RFC (Request For Comments) threads. We are always looking into ways to
  improve. This may involve things from changing how we run the WG to landing major breaking changes
  in core crates. To ensure we are actually making things better we need your input! That's why
  all these changes are preceded by an "RFC", a discussion thread (which may or may not be backed by
  a proper RFC document) where we evaluate the pros and cons of a proposal and explore alternatives.
  Only after there's consensus on accepting the proposal is the proposal made effective.

• Help wanted!. There's always lots to do but the WG members only have so much free time. You can
  help us fixing bugs, implementing features, writing tests, trying out examples and tutorials,
  writing documentation, fixing typos, etc. We'll mentor you through these tasks and review your
  work. In some cases you may not even need previous embedded experience or access embedded hardware
  to help us out so don't let that discourage you from checking out our help wanted issues.

• Join our weekly meetings on Matrix. We use these meetings as a faster, synchronous alternative to the
  RFC threads on GitHub. The agenda is posted in the issue tracker of this repository in advance
  to the meeting. Everyone is free to join the meeting and share their thoughts. You can also
  nominate an existing GH thread for discussion if you think it would benefit from a more
  synchronous discussion.

• We have several teams focused on different areas: tooling, Cortex-M crates, etc. and each team
  maintains several projects (crates, docs and / or tools) that live under the rust-embedded
  organization. You can collaborate with the maintenance and development of these projects by
  becoming a project collaborator (consult with the team that owns the project) or by joining the
  team.

Organization

The WG is composed of several teams whose functions are defined in RFC
#136. The embedded WG develops and maintains a large set
of projects under the rust-embedded organization. This section lists all the
teams and all the projects owned by the WG.

The core team

The functions of the core team are:

• Representing the WG in meetings with other Rust teams.
• Communicating the needs of the embedded Rust community (e.g. language features, core API
  stabilization) to the Rust teams.
• Giving the casting vote on intra-WG decisions where no voting majority can be achieved.
• Driving and moderating the weekly meetings.

Members

• @jamesmunns
• @japaric
• @therealprof

The Cortex-A team

The Cortex-A team develops and maintains the core of the Cortex-A crate ecosystem.

Members

• @andre-richter
• @parched
• @raw-bin
• @wizofe

Projects

Projects maintained by this team.

• cortex-a
• register-rs
• rust-raspi3-OS-tutorials

The Cortex-M team

The Cortex-M team develops and maintains the core of the Cortex-M crate ecosystem.

Members

• @adamgreig
• @korken89
• @thejpster
• @therealprof
• @ithinuel
• @jonas-schievink

Projects

Projects maintained by this team.

• alloc-cortex-m
• cortex-m-quickstart
• cortex-m-rt
• cortex-m-semihosting
• cortex-m
• itm
• panic-itm
• panic-semihosting

The Cortex-R team

The Cortex-R team develops and maintains the core of the Cortex-R crate ecosystem.

Members

• @japaric
• @paoloteti

Projects

• arm-dcc
• cortex-r
• panic-dcc

The embedded Linux team

The embedded Linux team develops and maintains the core of the embedded Linux crate ecosystem.

Members

• @nastevens
• @posborne
• @ryankurte

Projects

Projects maintained by the embedded Linux team

• gpio-cdev
• gpio-utils
• i2cdev
• linux-embedded-hal
• spidev
• sysfs-gpio
• sysfs-pwm

The HAL team

The HAL team develops and maintains crates that ease the development of Hardware Abstraction Layers,
Board Support Crates and drivers.

Members

• @thejpster
• @therealprof
• @ithinuel
• @ryankurte

Projects

Projects maintained by the HAL team.

• embedded-hal

The MSP430 team

The MS430 team develops and maintains the core of the MSP430 crate ecosystem.

Members

• @awygle
• @cr1901
• @pftbest

Projects

Projects maintained by this team

• msp430-quickstart
• msp430-rt
• msp430

The infrastructure team

The infrastructure team manages our domains, DNS records, e-mail aliases, etc.

Members

• @nastevens
• @ryankurte

Projects

Projects maintained by this team

• rust-embedded-provisioning

The RISC-V team

The RISC-V team develops and maintains the core of the RISC-V crate ecosystem.

Members

• @almindor
• @bradjc
• @danc86
• @dvc94ch
• @Disasm
• @laanwj

Projects

Projects maintained by this team

• riscv-rust-quickstart
• riscv-rt
• riscv

The resources team

The resources team develops, maintains and curates resources on embedded Rust.

Members

• @adamgreig
• @andre-richter
• @jamesmunns
• @thejpster
• @therealprof

Projects

Projects maintained by the resources team

• Awesome embedded Rust
• The Discovery book
• The embedded Rust book
• The embedonomicon
• @rustembedded twitter

The tools team

The tools team maintains and develops core embedded tools.

Members

• @adamgreig
• @burrbull
• @Disasm
• @Emilgardis
• @reitermarkus
• @ryankurte
• @therealprof

Projects

Projects maintained by the tools team

• cargo-binutils
• cross
• itm
• svd-parser
• svd2rust

The triage team

The triage team is charge of keeping PR queues moving; they ensure no PR is left unattended.

Members

• @Disasm
• @mathk

The IRR 2018 team

This team consists of the participants of the Increasing Rust Reach (2018) program who worked on
the embedded project of adding CI tests for embedded platforms to the compiler, and their mentor.

• @jamesmunns (mentor)
• @nerdyvaishali
• @sekineh

The old guard

This list is the membership of the embedded WG when it was first created and it's kept around for
historical purposes. All the people in this list are members of the rust-embedded organization and
most of them are members of one of the teams listed above.

• @dvc94ch
• @dylanmckay
• @hannobraun
• @jamesmunns
• @japaric
• @jcsoo
• @pftbest
• @thejpster

Hibernating

The following members have put themselves into hibernation the hibernation state, due to being absent or busy for an extended amount of time. See ops/hibernating.md.

• @hannobraun

Contact

Each team can be privately contacted via the following e-mail addresses:

• cortex-m@teams.rust-embedded.org
• cortex-r@teams.rust-embedded.org
• embedded-linux@teams.rust-embedded.org
• hal@teams.rust-embedded.org
• infrastructure@teams.rust-embedded.org
• resources@teams.rust-embedded.org
• risc-v@teams.rust-embedded.org
• tools@teams.rust-embedded.org

You can usually find the members of the embedded WG on the Rust Embedded Matrix room
(#rust-embedded:matrix.org).

Our Matrix room is logged by logbot on the bridged IRC channel, and you can find the logs at: https://freenode.logbot.info/rust-embedded

Other projects

These are other projects you may be interested in but that (currently) are not owned by the WG.

• AVR fork of Rust

On going community efforts

embedded-hal

embedded-hal is a project that aims to build a standard set of traits (interfaces) for I/O
functionality common in embedded devices: Serial, I2C, etc. with the goal of serving as a base for
building reusable driver crates, crates to interface with external components like sensors.

There are plenty of traits that still need to be designed, in particular ones that involve async
I/O. Join the discussion and help us design the missing traits so that they'll fulfill your needs.

The weekly driver initiative

To put the embedded-hal to test and to expand the embedded crates.io ecosystem we are running the
weekly driver initiative. The goal is to release a new no_std, generic, embedded-hal driver
crate every one or two weeks.

There's lots of cool devices that would be great to have drivers for. Join the initiative and help
us grow the embedded crates.io ecosystem!

Awesome embedded Rust

The community is building a curated list of crates useful for embedded development. In this list
you'll find driver crates, board support crates and general purpose no-std crates. Help us improve
this list by adding your crate via PR or by tackling any of our help wanted issues.

Embedded category in the user forum

As an experiment the Rust lang user forum has gained a new embedded category.

This is meant as a friendly exchange for anyone interested in embedded topics with Rust.

So if you want to discuss ideas, problems or solutions please feel free to chime in on existing topics or create a new one!

RFCs

When the team deems it necessary the RFC process may be used to make decisions or to design
processes, user interfaces, APIs, etc.

Learn more about the Rust's RFC process (which is the same as our own) here.

To create an RFC, simply:

• clone this repo to your own personal one
• copy 0000-template.md to text/0000-my-feature.md (where "my-feature" is
  descriptive. Don't assign an RFC number yet)
• fill in the details of your RFC in that file
• Open an pull request with this repository