cortex-a
Low level access to Cortex-A processors.
Currently Supported Execution States
- AArch64
- AArch32
Minimum Supported Rust Version
Requires a recent nightly of Rust if the (default) nightly
feature is enabled. Without this the
register access module is not available.
Usage
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
interoperatbility.
For example, in the following snippet, X.Y.Z
should be the same version of tock-registers
that
is mentioned in cortex-a
's Cargo.toml
.
[]
= "Your embedded project"
# Some parts omitted for brevity.
[]
= "X.Y.Z"
= "A.B.C" # <-- Includes tock-registers itself.
Example
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
Disclaimer
Descriptive comments in the source files are taken from the ARM Architecture Reference Manual ARMv8, for ARMv8-A architecture profile.
License
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.
Contribution
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.