Robin Mueller
94c6d91bae
- The workspace is now a monorepo without submodules. The HAL, PAC and BSP are integrated directly - Update all dependencies: embedded-hal v1 and RTIC v2 |
||
---|---|---|
.. | ||
.github | ||
automation | ||
src | ||
svd | ||
.gitignore | ||
build.rs | ||
Cargo.toml | ||
CHANGELOG.md | ||
device.x | ||
gen-helper.sh | ||
LICENSE-APACHE | ||
NOTICE | ||
README.md |
PAC for the Vorago VA108xx microcontroller family
This repository contains the Peripheral Access Crate (PAC) for Voragos VA108xx series of Cortex-M0 based microcontrollers.
The crate was generated using svd2rust
.
If you are interested in higher-level abstractions, it is recommended you visit
the va108xx-hal
HAL crate and
the vorago-reb1
BSP crate which build on top of
this PAC and provide application examples as well.
Usage
To use this crate, add this to your Cargo.toml
[dependencies.va108xx]
version = "<Most Recent Version>"
features = ["rt"]
The rt
feature is optional and recommended. It brings in support for cortex-m-rt
.
For full details on the autgenerated API, please see the svd2rust documentation.
Regenerating the PAC
If you want to re-generate the PAC, for example if the register file va416xx.svd
changes
or the svd2rust
version is updated, you can do some using the following these steps:
-
Make sure all necessary tools are installed:
svd2rust
,svdtools
andform
. You can install all tools withcargo
:cargo install --locked svd2rust svdtools form
-
Patch the vendor-provided SVD file
svd/va41xx.svd
. This can be done usingsvdtools
in conjunction with thesvd/va108xx-patch.yml
file.svdtools patch svd/va108xx-patch.yml
-
Use
svd2rust
to generate the Rust librarysvd2rust -i svd/va108xx.svd.patched
-
Use the
form
tool to split the generatedlib.rs
into individual modules.form -i lib.rs -o src/
The gen-helper.sh
automates steps 2-4.