A Hardware Abstraction Layer (HAL) for embedded systems
This project is developed and maintained by the HAL team.
At the moment we are working towards a
1.0.0 release (see #177). During this process we will
release alpha versions like
Alpha releases are not guaranteed to be compatible with each other.
They are provided as early previews for community testing and preparation for the final release.
If you use an alpha release, we recommend you choose an exact version specification in your
embedded-hal = "=1.0.0-alpha.2"
How-to: add a new trait
This is the suggested approach to adding a new trait to
Research / Discussion
Ideally, before proposing a new trait, or set of traits, you should check for an existing issue suggesting the need for the trait, as well as any related works / use cases / requirements that are useful to consider in the design of the trait.
These issues will be labeled as
discussion in the issue tracker.
Implementation / Demonstration
Proposed traits should then be implemented and demonstrated, either by forking
embedded-hal or by creating a new crate with the intent of integrating this into
embedded-hal once the traits have stabilized. You may find cargo workspaces and patch useful for the forking approach.
Traits should be demonstrated with at least two implementations on different platforms and one generic driver built on the trait. Where it is possible we suggest an implementation on a microcontroller, and implementation for linux, and a driver (or drivers where requirements are more complex) with bounds using the trait.
Proposing a trait
Once the trait has been demonstrated a PR should be opened to merge the new trait(s) into
embedded-hal. This should include a link to the previous discussion issue.
If there is determined to be more than one alternative then there should be further discussion to
try to single out the best option. Once there is consensus this will be merged into the
These issues / PRs will be labeled as
proposals in the issue tracker.
Implementations and drivers
For a list of
embedded-hal implementations and driver crates check the awesome-embedded-rust
Minimum Supported Rust Version (MSRV)
This crate is guaranteed to compile on stable Rust 1.35 and up. It might compile with older versions but that may change in any new patch release.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.