ruspiro-register 0.3.0

The crate provides simple to use macros to define MMIO registers representations allowing safe access to their contents. In addition this crate defines specific aarch64 and aarch32(CP15) registers to safely use them in rust code. This reduces the need of 'unsafe' calls.

Register abstraction crate for the RusPiRo kernel

This crate provides easy to use and compile time safe access abstraction to MMIO (memory mapped input output) registers of the Raspberry Pi. This crate also provides definitions for some aarch64 and aarch32 cp15 system register. Whether the aarch64 or aarch32 register are available depends on the target architecture used while building this crate.

Travis-CI Status Latest Version Documentation License


To use this crate simply add the dependency to your Cargo.toml file:

ruspiro-register = "0.3"

In any rust file the register could be defined with their access type, size, address and optional a detailed field definition. The register access types are ReadOnly, WriteOnly and ReadWrite. The supported register sizes are u8, u16, u32, u64.

use ruspiro_register::*;

define_mmio_register! [
    WO_REGISTER<WriteOnly<u16>@(0xFF00_0004)> {
        FLAG1   OFFSET(0) BITS(2),
        FLAG2   OFFSET(2),
        FLAG3   OFFSET(3) BITS(4)

fn main() {
    let _ = RO_REGISTER::Register.get(); // read raw value from register

    WO_REGISTER::Register.write_value(WO_REGISTER::FLAG3::with_value(0b1010)); // write only field FLAG3 into the register
    RW_REGISTER::Register.set(0xFFF); // write raw value to register

If access to the system registers is needed this could be done like so:

use ruspiro_register::system::*;

fn main64() {
    // update the system control register of EL2 in aarch64 mode to deactivate the MMU

fn main32() {
    // update the system control register in aarch32 mode to deactivate the MMU


Licensed under Apache License, Version 2.0, (LICENSE or