ral-registers/src, branch v0.2

Prototype a v0.2

2025-09-28T14:32:16+00:00

Needs to be documented. The gist: remove references to MMIO, and add support for nested structures. Drop the reset_reg! macro.

Allow trailing commas at register macros

2023-06-18T15:10:38+00:00

Document support for register arrays in each macro

2022-12-07T14:56:44+00:00

Since stm32ral doesn't have register arrays, I'm using prose and pseudo-code to document each macro's support for register arrays. This seemed to be today's simplest way to document the features for users. I have another commit that implements a hidden module with a RAL-like API and register arrays. Documentation examples then reference this hidden module to demonstrate the register array feature. But, it adds more code (could be shared with the tests), and it resulted in inconsistent documentation examples when compared to the STM examples.

Add macro support for register arrays

2022-12-07T14:42:54+00:00

I'm experimenting with a RAL code generator that collapses contiguous register arrays. The generated code would resemble pub struct RegisterBlock { pub MY_ARRAY: [RWRegister; 3], } and an individual register would be addressed like ral::read_reg!(ral::my_mod, my_inst, MY_ARRAY[1]); This commit extends the four macros so that we can specify an array offset. We simply need to match zero or more `[N]` patterns, where `N` is some expression that produces an array offset. The included test case shows that the approach should support multi-dimensional arrays.

Prevent masking value variables with imports

2021-09-23T04:59:55+00:00

Mark all registers as transparent

2021-09-21T21:52:54+00:00

Guarantees that the layout is the same as the inner type. Since UnsafeCell is also transparent, this ensures that the register has the same ABI as T. Today's registers work without this. Otherwise, RAL register blocks would have unaccounted offsets / wrong sizes. This is for completness, and a signal for others that a transmute might be OK. Requires Rust 1.28.

Initial commit. Import `registers.rs` from stm32ral.

2021-08-15T10:00:01+00:00