看门狗
概述
RTL8721F 提供一个 KM4TZ 核心可访问的安全系统看门狗。Rust 驱动 ameba_hal::wdg 直接封装 PAC 寄存器块,不涉及裸位操作或 C FFI 调用。
功能特性
单个安全系统看门狗实例
Wdg/CPU0_S_WDG_DEV,可从 KM4TZ 核心访问可通过
Wdg::init以毫秒为单位配置重载超时时间,写入时会被限制在 16 位WDG_RLR.RELOAD字段范围内无喂狗窗口限制——
refresh可以在倒计时的任意时刻调用超时后由硬件触发复位,未提供早期中断路径
一旦使能就没有软件关闭路径——底层硬件本身未提供对应的解锁序列
备注
独立看门狗 IWDG_DEV 未由此驱动暴露。它已由 NP 核心的 C 固件在启动时无条件接管,KM4TZ 侧驱动若重新配置只会和 NP 核心自身的喂狗序列抢占同一组寄存器,没有对应的安全收益。
工作模式
WDG 遵循单一的线性流程:初始化超时时间、使能看门狗,然后在超时前周期性喂狗。
看门狗流程
Wdg::init 配置重载超时时间并使能外设时钟,Wdg::enable 启动看门狗,Wdg::refresh 从配置的超时时间重新开始倒计时。如果在超时前没有调用 refresh,硬件会触发芯片复位。
use ameba_hal::{println, wdg::Wdg};
...
const TIMEOUT_MS: u32 = 5000;
const REFRESH_INTERVAL_MS: u64 = 500;
...
let wdg = unsafe { Wdg::steal() };
wdg.init(TIMEOUT_MS);
wdg.enable();
...
loop {
Timer::after(Duration::from_millis(REFRESH_INTERVAL_MS)).await;
wdg.refresh();
}
完整示例见 examples/wdg/src/main.rs。
应用示例
Rust SDK 在 examples/wdg/ 下提供一个示例项目:
-
初始化并使能系统看门狗,超时设为 5 s,每 500 ms 喂狗一次,打印 10 次后报
[PASS],随后持续喂狗保持板子运行——喂狗逻辑若有误,板子会在 5 s 内复位重启,串口日志会从[WDG] start重新开始,而不会看到[PASS]。接线:无需外部接线。
[WDG] start [WDG] system watchdog enabled, timeout=5000ms [WDG] refresh #0 ... [WDG] refresh #9 [PASS] wdg: OK
备注
编译任意示例:cargo xtask build example --name wdg。
API 参考
快速用法
use ameba_hal::wdg::Wdg;
let wdg = unsafe { Wdg::steal() };
wdg.init(5000);
wdg.enable();
wdg.refresh();