AUTOSAR_SWS_WatchdogInterface 中文翻译

文档编号：041　|　状态：Final（正式发布）　|　发布于：AUTOSAR CP Release 4.4.0（2018-10-31）
所属标准：AUTOSAR Classic Platform 标准　|　文档责任方：AUTOSAR　|　保密等级：AUTOSAR CONFIDENTIAL

本翻译覆盖原文档 1-28 页正文，约 0.60 MB / 28 页。
原文为软件规范（SWS, Software Specification），定义看门狗接口（Watchdog Interface, WdgIf）模块的功能、API 与配置——提供对底层 WDG 驱动的统一抽象访问接口。
本翻译校对区块：10 章 + 3 API 函数（WdgIf_SetMode/SetTriggerCondition/GetVersionInfo）+ 完整 ECUC 配置参数 + 完整错误分类。

1 引言与功能概述（Introduction and functional overview）

本文档规约 AUTOSAR 基础软件模块看门狗接口（WdgIf）的功能、API 与配置。

WdgIf 模块位于 ECU 抽象层（ECU Abstraction Layer），为上层 WdgM（看门狗管理器）模块提供对底层 WDG 驱动的统一抽象访问。WdgIf 不直接操作看门狗硬件；它将 WdgM 的请求转发给对应的 WDG 驱动实例。

WdgIf 支持多个 WDG 驱动实例——一个 ECU 可有多个看门狗设备（内部 + 外部），WdgIf 提供设备索引（DeviceIndex）参数以区分。

2 缩略语与缩写（Acronyms and abbreviations）

3 相关文档（Related documentation）

3.1 输入文档

• AUTOSAR_SRS_WatchdogDriver — 看门狗驱动需求
• AUTOSAR_SRS_BSWGeneral — 基础软件通用需求

3.2 相关标准与规范

N/A

3.3 相关规范

• AUTOSAR_SWS_WatchdogDriver — 看门狗驱动规范
• AUTOSAR_SWS_WatchdogManager — 看门狗管理器规范

4 约束与假设（Constraints and assumptions）

4.1 限制（Limitations）

WdgIf 是抽象层；不直接访问硬件。

4.2 适用性（Applicability to car domains）

WdgIf 适用于所有汽车域。

5 与其他模块的依赖（Dependencies to other modules）

5.1 文件结构（File structure）

5.1.1 代码文件结构（Code file structure）

WdgIf.c                    # 主源文件
WdgIf_Lcfg.c               # Link-time 配置

5.1.2 版本检查（Version check）

WdgIf 应使用 WdgIf_GetVersionInfo() 报告其版本号。集成商应检查版本一致性。

6 需求可追溯性（Requirements traceability）

本 SWS 中所有 SWS_WdgIf_NNNNN 需求均链接到上游 AUTOSAR_SRS_WatchdogDriver 中的 SRS_Wdg_NNNNN 需求。详细追溯表见原文 11-17 页（28+ 个 SWS_WdgIf_NNNNN 需求）。

7 功能规范（Functional specification）

7.1 通用行为（General behavior）

WdgIf 的设计原则：

1. WdgIf 是抽象层 API，调用通过索引转发到对应 WDG 驱动；
2. WdgIf 本身不维护状态；
3. WdgIf 必须在 Wdg_SetMode() 前先调用 WdgIf_SetMode()；
4. WdgIf 必须将 WdgM 的请求透传给底层 WDG 驱动；
5. WdgIf 应支持多 WDG 驱动实例的并行运行。

7.2 错误分类（Error classification）

7.2.1 开发错误（Development Errors）

7.2.2 运行时错误（Runtime Errors）

无。

7.2.3 瞬态故障（Transient Faults）

无。

7.2.4 生产错误（Production Errors）

无。

7.2.5 扩展生产错误（Extended Production Errors）

无。

8 API 规范（API specification）

8.1 导入类型（Imported types）

• Std_ReturnType（来自 Std_Types.h）
• Std_VersionInfoType（来自 Std_Types.h）

8.2 类型定义（Type definitions）

8.2.1 WdgIf_ModeType

typedef enum {
    WDGIF_FAST_MODE = 0,
    WDGIF_SLOW_MODE = 1,
    WDGIF_OFF_MODE  = 2
} WdgIf_ModeType;

8.3 函数定义（Function definitions）

8.3.1 WdgIf_SetMode

Std_ReturnType WdgIf_SetMode(uint8 DeviceIndex, WdgIf_ModeType Mode);

说明：设置指定 WDG 设备的操作模式。WdgIf 转发该请求到对应的 WDG 驱动 Wdg_SetMode()。

参数：

• DeviceIndex：WDG 设备索引（0..WdgIfMaxDeviceIndex）；
• Mode：目标模式。

返回：E_OK 成功；E_NOT_OK 失败。

错误：

• WDGIF_E_INV_DEVICE_INDEX：DeviceIndex 越界；
• WDGIF_E_PARAM_MODE：Mode 无效。

8.3.2 WdgIf_SetTriggerCondition

Std_ReturnType WdgIf_SetTriggerCondition(uint8 DeviceIndex, uint16 Timeout);

说明：设置指定 WDG 设备的触发条件（timeout）。WdgIf 转发到 Wdg_SetTriggerCondition()。

参数：

• DeviceIndex：WDG 设备索引；
• Timeout：新 timeout 值。

返回：E_OK 成功；E_NOT_OK 失败。

错误：

• WDGIF_E_INV_DEVICE_INDEX：DeviceIndex 越界。

8.3.3 WdgIf_GetVersionInfo

#if (WDGIF_VERSION_INFO_API == STD_ON)
void WdgIf_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr);
#endif

说明：返回 WdgIf 驱动的版本信息。

参数：

• VersionInfoPtr：指向 Std_VersionInfoType 结构的指针。

8.4 回调通知（Call-back notifications）

无（WdgIf 无回调）。

9 序列图（Sequence diagrams）

序列图 9.1 描述 WdgM 通过 WdgIf 操作 WDG 驱动的流程：

1. WdgM 调用 WdgIf_SetMode() 或 WdgIf_SetTriggerCondition()；
2. WdgIf 根据 DeviceIndex 路由到对应 WDG 驱动的 API；
3. WDG 驱动操作硬件；
4. 结果返回 WdgM。

配置规范（Configuration specification）

WdgIf 配置容器：

11 未应用需求（Not applicable requirements）

本节列出来自上游 AUTOSAR_SRS_WatchdogDriver 但在本 SWS 中不直接对应的需求（标 N/A）。WdgIf 本身无具体需求不被应用——它纯粹是 WDG 驱动的抽象层。