<feed xmlns='http://www.w3.org/2005/Atom'>
<title>ral-registers, branch v0.2</title>
<subtitle>MMIO abstraction using a macro-based API
</subtitle>
<id>https://git.mciantyre.dev/ral-registers/atom?h=v0.2</id>
<link rel='self' href='https://git.mciantyre.dev/ral-registers/atom?h=v0.2'/>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/'/>
<updated>2025-09-28T14:32:16+00:00</updated>
<entry>
<title>Prototype a v0.2</title>
<updated>2025-09-28T14:32:16+00:00</updated>
<author>
<name>Ian McIntyre</name>
<email>me@mciantyre.dev</email>
</author>
<published>2025-04-12T22:37:30+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=495fbc58b6f4d2e751b16883a2c5cee3c598fd79'/>
<id>urn:sha1:495fbc58b6f4d2e751b16883a2c5cee3c598fd79</id>
<content type='text'>
Needs to be documented. The gist: remove references to MMIO, and add
support for nested structures. Drop the reset_reg! macro.
</content>
</entry>
<entry>
<title>Release 0.1.3</title>
<updated>2023-06-18T15:28:23+00:00</updated>
<author>
<name>Adam Greig</name>
<email>adam@adamgreig.com</email>
</author>
<published>2023-06-18T15:28:23+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=7bf03005703186667623bfc681e10c44f7f8923d'/>
<id>urn:sha1:7bf03005703186667623bfc681e10c44f7f8923d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Merge pull request #7 from Finomnis/trailing_commas</title>
<updated>2023-06-18T15:27:13+00:00</updated>
<author>
<name>Adam Greig</name>
<email>adam@adamgreig.com</email>
</author>
<published>2023-06-18T15:27:13+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=301dff58b1684bca10983fe8c524aa278a09b4c2'/>
<id>urn:sha1:301dff58b1684bca10983fe8c524aa278a09b4c2</id>
<content type='text'>
Allow trailing commas at register macros</content>
</entry>
<entry>
<title>Allow trailing commas at register macros</title>
<updated>2023-06-18T15:10:38+00:00</updated>
<author>
<name>Finomnis</name>
<email>finomnis@gmail.com</email>
</author>
<published>2023-06-18T15:10:38+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=d49fb1ec06bcd89fee1fe20cb20ab82da91ce434'/>
<id>urn:sha1:d49fb1ec06bcd89fee1fe20cb20ab82da91ce434</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Merge pull request #6 from adamgreig/0.1.2</title>
<updated>2023-01-03T17:38:58+00:00</updated>
<author>
<name>Adam Greig</name>
<email>adam@adamgreig.com</email>
</author>
<published>2023-01-03T17:38:58+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=1b5e99297f6303fc20da2622ae815b3a4987dbb1'/>
<id>urn:sha1:1b5e99297f6303fc20da2622ae815b3a4987dbb1</id>
<content type='text'>
Release 0.1.2</content>
</entry>
<entry>
<title>Release 0.1.2</title>
<updated>2023-01-03T17:38:25+00:00</updated>
<author>
<name>Adam Greig</name>
<email>adam@adamgreig.com</email>
</author>
<published>2023-01-03T17:38:25+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=83e35f81ff4f69e04dbea12c03a853f2939f262b'/>
<id>urn:sha1:83e35f81ff4f69e04dbea12c03a853f2939f262b</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Merge pull request #5 from mciantyre/register-arrays</title>
<updated>2023-01-03T17:37:13+00:00</updated>
<author>
<name>Adam Greig</name>
<email>adam@adamgreig.com</email>
</author>
<published>2023-01-03T17:37:13+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=c3a5ddfdb8e2d9995436a0c4e76ca04b48e4603d'/>
<id>urn:sha1:c3a5ddfdb8e2d9995436a0c4e76ca04b48e4603d</id>
<content type='text'>
Add macro support for register arrays</content>
</entry>
<entry>
<title>Document support for register arrays in each macro</title>
<updated>2022-12-07T14:56:44+00:00</updated>
<author>
<name>Ian McIntyre</name>
<email>ianpmcintyre@gmail.com</email>
</author>
<published>2022-12-07T14:56:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=5e7603467c24abb8bdaac95928c05ed74898c9a2'/>
<id>urn:sha1:5e7603467c24abb8bdaac95928c05ed74898c9a2</id>
<content type='text'>
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.
</content>
</entry>
<entry>
<title>Expand macros testing for register scalars, arrays</title>
<updated>2022-12-07T14:42:54+00:00</updated>
<author>
<name>Ian McIntyre</name>
<email>ianpmcintyre@gmail.com</email>
</author>
<published>2022-11-03T15:44:43+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=1290bae4efb487e2b51ae6176a7211d84cbb447e'/>
<id>urn:sha1:1290bae4efb487e2b51ae6176a7211d84cbb447e</id>
<content type='text'>
The parent commit extends the macros to support both scalar and array
register access. This commit extends the macro test suite to test both
scalar and array register access.

It also tests that you can use things that deref to a register block,
including normal references, deref smart pointers, and raw pointers. The
tests cases carry over the shadowed variable tests.
</content>
</entry>
<entry>
<title>Add macro support for register arrays</title>
<updated>2022-12-07T14:42:54+00:00</updated>
<author>
<name>Ian McIntyre</name>
<email>ianpmcintyre@gmail.com</email>
</author>
<published>2022-09-22T17:49:23+00:00</published>
<link rel='alternate' type='text/html' href='https://git.mciantyre.dev/ral-registers/commit/?id=a5850ab6d6c508fc3351fd86646bcf3fb1b69103'/>
<id>urn:sha1:a5850ab6d6c508fc3351fd86646bcf3fb1b69103</id>
<content type='text'>
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&lt;u32&gt;; 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.
</content>
</entry>
</feed>
