> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RTSS 看门狗概述

RTSS 平台在实时 CPU 单元（RTCU）硬件模块中实现了窗口看门狗（WWDOG）。看门狗硬件在后台持续运行一个自由运行计数器。软件需要通过执行*喂狗*（pet）操作来定期重置该计数器。此喂狗操作向硬件表明软件处于活动且正常运行状态。

如果软件未能在预期时间内喂狗（例如，由于崩溃、死锁或栈溢出），计数器将达到预定义的阈值，并触发 bite 或 bark 事件。

* 传统模式：软件可以在 bite 超时之前的任何时间喂狗。不施加窗口约束。
* 窗口模式：软件只能在定义的有效时间窗口内喂狗。喂狗过早或过晚都会触发错误。

**传统看门狗**

传统看门狗是一种简化的看门狗模式，其要求是软件必须在 bite 超时到期之前喂狗。没有最小窗口时间、没有最大窗口时间，也没有窗口错误中断。因此，软件可以在达到 bite 超时之前的任何时间喂狗。

**窗口看门狗**

窗口看门狗要求软件在指定的时间窗口内喂狗。喂狗过早或过晚都会触发故障。与标准看门狗相比，这有助于检测更广泛的软件异常，包括软件陷入快速执行循环、以高于预期的频率喂狗的情况。

下表列出了看门狗中断信息：

| **内核** | **BARK (PPI)** | **窗口错误 (PPI)** | **BITE ( SPI)** |
| :-: | :-: | :-: | :-: |
| Cluster0-Core0 | 16 | 17 | 176 |
| Cluster0-Core1 | 16 | 17 | 177 |
| Cluster1-Core0 | 16 | 17 | 178 |
| Cluster1-Core1 | 16 | 17 | 179 |

下表列出了窗口模式看门狗时序：

| **参数（用户可配置）** | **原始值 (52 ns)** | **换算时间** | |
| :-: | :-: | :-: | - |
| WIN\_MIN\_TIME | BARK\_TIME | WIN\_MAX\_TIME | BITE\_TIME |
| 0x08CA00 | 0x3EF14800 | 0x44AA2000 | 0x44AA2000 |
| 30 ms | 30 sec | 60 sec | 60 sec |

有关验证看门狗测试命令的信息，请参阅 [Watchdog test commands](https://dragonwingdocs.qualcomm.com/System/FreeRTOS/RTSS-test-commands#view-the-interface-configuration)。
