看门狗

概述

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/ 下提供一个示例项目:

  • 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();