ra4m1-ctpac

ra4m1-ctpac is a Peripheral Access Crate for Renesas RA4M1 microcontrollers. Unlike similar PACs for the RA4M1, this crate is generated programmatically by chiptool using the SVD as found on Keil's site. The resulting API is different from other crates that are generated using svd2rust and the chiptool documentation covers these differences. This is primarily intended to be used by an upcoming RA4M1 HAL crate, however a secondary goal is to make this a bit more legible to humans.

Supported Hardware

In the consumer space the Renesas RA4M1 is most commonly found in the Arduino "R4" boards like the Uno R4 Minima and Nano R4.

Usage

If you plan to use this PAC directly read the user manual first.

Note that IIC1 has been collapsed onto IIC0. The only hardware difference is that IIC1 lacks the wake-up knobs. They're present in the PAC for IIC1. Don't use them.

Updating

To update the Rust code run the generate.sh script from this directory. If you wish to use a different SVD, place it in the support/svd directory and set the SVD environment variable appropriately.

generate.sh depends on chiptool, form, and GNU sed. chiptool will be installed or updated via cargo unless CHIPTOOL_CMD is set to a valid executable. form will be installed and locked to a specific version via cargo if needed. If GNU sed is installed as gsed it will be used over sed.

Note: that this crate currently cannot be rebuilt with the stock chiptool.

TODO

• Get required PRs merged into chiptool.
• Continue renaming enum variants with symbolic names.
• Add transforms any additional missing chunks.