Low level access to Cortex-A processors.
Currently Supported Execution States
Minimum Supported Rust Version
Requires a recent nightly of Rust.
Please note that for using this crate's register definitions (as provided by
cortex_a::registers::*), you need to also include
tock-registers in your project. This is because the
interface traits provided by
tock-registers are implemented by this crate. You should include
the same version of
tock-registers as is being used by this crate to ensure sane
For example, in the following snippet,
X.Y.Z should be the same version of
is mentioned in
 = "Your embedded project" # Some parts omitted for brevity.  = "X.Y.Z" = "A.B.C" # <-- Includes tock-registers itself.
Check out https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials for usage examples. Listed
below is a snippet of
rust-raspberrypi-OS-tutorials's early boot code.
use ; use Writeable; // <-- Trait needed to use `write()` and `set()`. // Some parts omitted for brevity. unsafe
Descriptive comments in the source files are taken from the ARM Architecture Reference Manual ARMv8, for ARMv8-A architecture profile.
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.