This repository holds the HAL (Hardware Abstraction Layer) and PACs (Peripheral Access Crates) that supports and enable working with Microchip SAM S70/E70/V70/V71-based devices using Rust.
The PACs are generated by SVD files provided by Microchip, publically available at at the Microship Packs Repository.
The HAL is the result of reading the MCU family datasheet, and provide a type-safe layer ovret he raw PACs. Were able, information is stored in the type-layer instead of computed at run-time. The HAL implements traits specified by embedded-hal, making it compatible with various Embedded Rust ecosystem crates.
Evaluation kit examples are available under boards/, and provide examples for most implemented peripherals.
At present, examples are available for the SAM V71 Xplained Ultra (boards/atsamv71_xult) and SAM E70 Xplained Pro (boards/atsame70_xpro).
This repository employs a trunk-based development: development occurs on master with short-lived branches that merges into it.
When a release is met, for example a v0.3.2 release, a v0.3.x branch is spun of master and the release tagged. If this branch already exists, relevant commits are back-ported instead.
Development is done towards master.
Install the ARMv7-EM target:
$ rustup target add thumbv7em-none-eabihfand build the examples:
$ cd boards/atsamv71_xult
$ cargo build --examples
$ cd boards/atsame70_xpro
$ cargo build --examplesRefer to the SAM V71 Xplained Ulta README.
All source code in this repository is licensed under either of
Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0) MIT license (LICENSE-MIT or https://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 licensed as above, without any additional terms or conditions.