为 Vorago VA108xx 微控制器系列提供的 PAC

此仓库包含 Vorago VA108xx 系列基于 Cortex-M0 的微控制器的外围设备访问 Crate (PAC)。

该 Crate 是使用 svd2rust 生成的。

如果您对更高级的抽象感兴趣，建议您访问 va108xx-hal HAL Crate 和 vorago-reb1 BSP Crate，它们基于此 PAC 构建。

使用方法

要使用此 Crate，请将以下内容添加到您的 Cargo.toml

[dependencies.va108xx]
version = "<Most Recent Version>"
features = ["rt"]

rt 功能是可选的，但建议使用。它引入了对 cortex-m-rt 的支持。

有关自生成的 API 的完整详细信息，请参阅 svd2rust 文档。

重新生成 PAC

如果您想重新生成 PAC，例如如果寄存器文件 va416xx.svd 发生更改或 svd2rust 版本已更新，您可以使用以下步骤进行操作

1. 确保已安装所有必要的工具：svd2rust、svdtools 和 form。您可以使用 cargo 安装所有工具。

   cargo install --locked svd2rust svdtools form
   

2. 修补供应商提供的 SVD 文件 svd/va41xx.svd。这可以通过使用 svdtools 以及 svd/va108xx-patch.yml 文件来完成。

   svdtools patch svd/va108xx-patch.yml
   

3. 使用 svd2rust 生成 Rust 库

   svd2rust -i svd/va108xx.svd.patched
   

4. 使用 form 工具将生成的 lib.rs 分割成单独的模块。

   form -i lib.rs -o src/
   

gen-helper.sh 自动化步骤 2-4。