#mmio #register #abstraction #fields #read #macro

no-std ral-registers

MMIO registers abstraction with a macro API

4 releases

0.1.3 Jun 18, 2023
0.1.2 Jan 3, 2023
0.1.1 Sep 29, 2021
0.1.0 Aug 15, 2021

#1078 in Embedded development

Download history 403/week @ 2023-12-06 1083/week @ 2023-12-13 808/week @ 2023-12-20 386/week @ 2023-12-27 722/week @ 2024-01-03 1039/week @ 2024-01-10 929/week @ 2024-01-17 1020/week @ 2024-01-24 593/week @ 2024-01-31 968/week @ 2024-02-07 1231/week @ 2024-02-14 1334/week @ 2024-02-21 1101/week @ 2024-02-28 1118/week @ 2024-03-06 1388/week @ 2024-03-13 1458/week @ 2024-03-20

5,334 downloads per month
Used in 16 crates (4 directly)

MIT/Apache

31KB
155 lines

ral-registers

Version Documentation CI License

This crate contains an MMIO abstraction that uses macros to read, modify, and write fields in registers.

For example, several fields on a register can be updated (without changing the other fields) using:

// Modify some fields on GPIOA.MODER without changing others.
modify_reg!(gpio, GPIOA, MODER, MODER1: Input, MODER2: Output, MODER3: Input);

// Check a condition on a field.
while read_reg!(gpio, GPIOA, IDR, IDR3 == High) {}

// Read and write the entire register word value.
let port = read_reg!(gpio, GPIOA, IDR);
write_reg!(gpio, GPIOA, port);

This crate contains register code originally written in stm32ral, extracted for easier use in other projects.

Licence

Licensed under either of

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.

No runtime deps