传递给 .init() 函数的闭包接收默认值作为输入，并将闭包的返回值写回寄存器。

use test_pac::{timer, TIMER};

// do some initializations, write `BoolW` and `BoolRW` with given values,
// write others with defaults
unsafe {
    TIMER
        .bitfield_reg()
        .init(|r| r.boolw().set(true).boolrw().set(false))
}

// use init also for write-only registers
unsafe {
    TIMER.int().init(|r| {
        r.en()
            .set(timer::int::En::ENABLE)
            .mode()
            .set(timer::int::Mode::OVERFLOW)
    })
};

合并所有东西

尤其是读写功能可以合并，例如。

let status = unsafe { TIMER.bitfield_reg().read() };
if status.boolr().get() {
    let modified = status.boolrw().set(true);
    unsafe { TIMER.bitfield_reg().write(modified) }
}

原始访问

对于日志记录、从表初始化等用例，可以以纯整数形式读写寄存器。

// get register value as integer value
let to_log = unsafe { TIMER.sr().read().get_raw() };

// write register with integer value, e.g. read from table
unsafe { TIMER.bitfield_reg().modify(|r| r.set_raw(0x1234)) };

修改原子（仅适用于Aurix）

此函数仅适用于Aurix微控制器。它使用 ldmst 指令在寄存器中读取-修改-写入值。此指令在事务结束时才释放总线。因此，它会影响总线上其他主设备。

use test_pac::{timer, TIMER};
TIMER.bitfield_reg().modify_atomic(|f| {
    f.bitfieldenumerated()
        .set(timer::bitfield_reg::BitfieldEnumerated::GPIOA_0)
        .bitfieldw()
        .set(3)
});

使用 --target aurix 启用Aurix的代码生成

外设数组

使用Rust数组模拟外设的SVD数组。

use test_pac::{UART,uart};
for peri in UART {
    unsafe {
        peri.reg16bitenum().modify(|r| {
            r.bitfield9bitsenum()
                .set(uart::reg16bitenum::Bitfield9BitsEnum::VAL_0)
        })
    };
}

寄存器数组

在模块中将寄存器数组模拟为寄存器结构体的数组。

use test_pac::*;
let reg_array = TIMER.arrayreg();
for reg in reg_array {
    let reg_val = unsafe { reg.read() };
    let old_val = reg_val.get();
    unsafe { reg.write(reg_val.set(old_val + 1)) };
}

位字段数组

位字段数组在寄存器中模拟为位字段结构体的数组。

 let mut reg_value = unsafe { TIMER.bitfield_reg().read() };
 for x in 0..2 {
    reg_value = reg_value.fieldarray(x).set(timer::bitfield_reg::FieldArray::FALLING);
 }
 unsafe { TIMER.bitfield_reg().write(reg_value) };

通过传递整数文字写入枚举位字段

值的尺寸不能超过位字段尺寸。在这里，可以从整数创建关联的结构类型，因为位字段结构已实现 From 特性。

use test_pac::{timer, TIMER};
unsafe {
    TIMER.bitfield_reg().modify(|f| {
        f.bitfieldenumerated()
            .set(0.into())
    });
}

获取位字段的掩码和偏移量

可以使用 mask 和 offset 获取单个位字段的掩码和偏移量。返回的掩码对LSB对齐且未移位（即3位宽的字段具有掩码 0x7，与字段的位置无关）。

 use test_pac::{timer, TIMER};
 unsafe {
    let register_bitfield = TIMER.bitfield_reg().read().bitfieldr();
    let _offset = register_bitfield.offset();
    let _mask = register_bitfield.mask();
}

跟踪功能

当使用 --tracing 命令行标志生成PAC时，PAC将生成具有可选功能标志 tracing 的PAC。启用此功能提供以下附加功能

• 一个接口，可以通过该接口将寄存器访问管道化，使开发人员能够记录对寄存器的访问，甚至直接模拟寄存器。该接口的实现由 regmock-rs 提供。
• 一个特殊的 RegisterValue 特性，允许从整数构建寄存器的值。
• 一个额外的 insanely_unsafe 模块，允许读写、只写和只读寄存器（用于在测试中模拟状态）。
• 一个额外的 reg_name 模块，其中包含物理地址到所有驻留在地址处的寄存器字符串名称的完美哈希映射。

示例

下面展示了如何使用跟踪API的一些简单示例。有关如何使用跟踪功能进行单元测试的完整示例，请参阅 regmock-rs 的文档。

使用跟踪从原始值构造寄存器值

在实现使用跟踪功能的测试时，我们希望在测试期间提供任意数据。

use pac::common::RegisterValue;
let value = pac::peripheral::register::new(0xC0FFEE);
unsafe{ pac::PERIPHERAL.register().write(value) };

使用跟踪从 只写 寄存器读取值

再次用于测试：在测试用例中，我们需要执行与正常代码相反的操作，即我们需要“写入”只读寄存器和“读取”只写寄存器。

跟踪提供了一种后门，允许执行正常代码中不允许的操作。

use pac::tracing::insanely_unsafe;
let value = unsafe{ pac::PERIPHERAL.write_only_register().read_write_only() };

获取特定地址的寄存器名称

为了更好地记录，如果启用了跟踪，则会生成/提供地址到名称的映射。

let regs_at_c0ffee = pac::reg_name::reg_name_from_addr(0xC0FFEE);
println!("{regs_at_c0ffee:?}");

如何在您的 build.rs 中使用

在构建应用程序的过程中，可以通过调用 main 或 main_parse_arguments 来生成 PAC。

运行测试

要执行测试，需要将“thumbv7em-none-eabihf”添加为目标。这可以通过以下方式完成：

rustup target add thumbv7em-none-eabihf

要测试 Aurix PAC 的生成，需要安装 Hightec Rust Aurix 编译器并将其设置为默认编译器。《code>build.rs 会自动检测工具链并添加配置选项以启用针对 Aurix 的特定测试。

致谢

模板 common.tera 的一部分来自 代码复制来源的提交链接

许可证：MIT