1. 安装工具#

1
cargo install svd2rust
2
cargo install form
3
rustup component add rustfmt

2. 创建一个 PAC 库工程#

需要用 Cargo 创建一个 lib 工程，命令如下：

1
cargo new cw32l010_pac --lib
2
cd cw32l010_pac

将 svd 文件放入工程根目录，例如：

1
cw32l010_pac/
2
├── Cargo.toml
3
└── STM32F103.svd

3. 根据芯片内核选择 target#

svd2rust 支持 Cortex-M、MSP430、RISC-V 和 Xtensa LX6 微控制器。生成的 crate 可通过 --target 标志针对特定架构进行定制。

该标志接受 "cortex-m"、"msp430"、"riscv"、"xtensa-lx" 和 "none" 作为值。使用 "none" 可生成与架构无关的 crate，适用于 svd2rust 当前未知的架构，例如 Cortex-A 架构。

如果省略 --target 标志，svd2rust 将默认目标架构为 Cortex-M。

常用选择：

1
STM32F103 / STM32F407 / STM32G4        -> --target cortex-m
2
CH32V203 / CH32V307 / CH32V003         -> --target riscv
3
架构不确定，只想生成寄存器访问层       -> --target none

比如 STM32：

1
svd2rust -i .\STM32F103.svd --target cortex-m

比如 WCH 的 CH32V307：

1
svd2rust -i .\CH32V307.svd --target riscv

执行后，Cortex-M 目标通常会生成：

1
build.rs
2
device.x
3
lib.rs

4. 拆解 lib.rs 为正常 Rust 工程目录#

官方文档也说明了 Cortex-M 会生成这三个文件：build.rs、device.x、lib.rs。

所有这些文件都必须包含在同一个设备 crate 中。lib.rs 文件包含多个内联模块且未格式化。建议使用 form 工具将其拆分，然后使用 rustfmt / cargo fmt 格式化输出：

1
svd2rust -i CW32L010.svd
2
rm -rf src
3
form -i lib.rs -o src/ && rm lib.rs
4
cargo fmt

5. 不同内核的 Cargo.toml 配置#

生成的 crate 必须提供一个可选的 rt 功能，并依赖于以下这些 crate：

• critical-section v1.x
• cortex-m >= v0.7.6
• cortex-m-rt >= v0.6.13
• vcell >= v0.1.2

此外，当启用 rt 特性时，必须同时启用 cortex-m-rt 的 device 特性。设备 crate 的 Cargo.toml 将如下所示：

1
[dependencies]
2
critical-section = { version = "1.0", optional = true }
3
cortex-m = "0.7.6"
4
cortex-m-rt = { version = "0.6.13", optional = true }
5
vcell = "0.1.2"
6

7
[features]
8
rt = ["cortex-m-rt/device"]

1
[package]
2
name = "cw32l010_pac"
3
version = "0.1.0"
4
edition = "2021"
5

6
[dependencies]
7
critical-section = { version = "1.0", optional = true }
8
cortex-m = "0.7.6"
9
cortex-m-rt = { version = "0.6.13", optional = true }
10
vcell = "0.1.2"
11

12
[features]
13
default = ["critical-section"]
14
rt = ["cortex-m-rt/device"]

1
default = ["critical-section"]

1
Peripherals::take()

1
[package]
2
name = "ch32v307-pac"
3
version = "0.1.0"
4
edition = "2021"
5

6
[dependencies]
7
critical-section = { version = "1.0", optional = true }
8
riscv = "0.12.1"
9
riscv-rt = { version = "0.13.0", optional = true }
10
vcell = "0.1.0"
11

12
[features]
13
default = ["critical-section"]
14
rt = ["riscv-rt"]

6. 检查 PAC 能否编译#

1
rustup target add xxxxxxxxxx

1
cargo check --target thumbv7em-none-eabihf
2

3
# 开启 rt 可以使用下面的命令
4
cargo check --target thumbv7m-none-eabi --features rt

7. 在工程中使用 PAC#

后续可以在 HAL 或应用工程中引入生成好的 PAC crate，并基于寄存器访问层继续封装外设抽象。