RgGen::SystemRDL

RgGen::SystemRDL is a RgGen plugin to load register map descriptions written in SystemRDL 2.0.

To install RgGen::SystemRDL, use the following command:

$ gem install rggen-systemrdl

You need to tell RgGen to load the RgGen::SystemRDL plugin. There are two ways.

$ rggen --plugin rggen-systemrdl your_register_map.rdl

$ export RGGEN_PLUGINS=${RGGEN_PLUGINS}:rggen-systemrdl
$ rggen your_register_map.rdl

The plugin converts SystemRDL addrmap, regfile, reg, field, and mem components into the corresponding RgGen register map layers, including a wide range of field access types. Some SystemRDL constructs have no corresponding concept in RgGen. These are not supported and cause an error.

For the detailed component-to-layer correspondence, the full SystemRDL-property to RgGen-type mapping, and the complete list of unsupported constructs with the reasons behind each decision, see the design notes:

• SystemRDL to RgGen mapping
• Bit field type matrix

RgGen fixes precedence to hardware, whereas SystemRDL's precedence is variable and defaults to software. A field is therefore rejected unless its precedence is explicitly set to hw.

To accept a SystemRDL description without changing it, set the ignore_precedence configuration option (default false) to true. Then the precedence property in the SystemRDL description is ignored and every field is treated as hardware precedence.

Feedbacks, bug reports, questions and etc. are welcome! You can post them by using the following ways:

• GitHub Issue Tracker
• GitHub Discussions
• Discord
• Mailing List
• Mail

Copyright © 2026 Taichi Ishitani. RgGen::SystemRDL is licensed under the MIT License, see LICENSE for further details.