结构体 ara::diag::TimeBased

数据结构 ara::diag::TimeBased 用于配置诊断事件基于时间的去抖 [SWS_DM_00539]。它向 ara::diag::Monitor 的构造函数传递以毫秒为单位的阈值，在该时间到期后，事件将被归类为已愈合或故障。Diagnostic Management 在收到状态报告时根据这些阈值启动并控制内部去抖定时器。对于基于时间的去抖方法，不支持在重启后持久存储内部计数器值 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.2 “Time-based debouncing”。

更多 ›

上下文

C++ 结构体 ara::diag::TimeBased 定义了 AUTOSAR Adaptive Platform 的 Diagnostic Management 中诊断事件基于时间的去抖（time-based debouncing）的配置参数 [SWS_DM_00539]。它封装了对诊断事件状态转换起决定性作用的两个持续时间（以毫秒为单位）：作为故障阈值的 failedMs [SWS_DM_00629] 和作为愈合阈值的 passedMs [SWS_DM_00630]。

在整个系统中，该结构连接了三个关键组件：执行诊断的应用功能、类 ara::diag::Monitor 以及 Diagnostic Management (DM) [SWS_DM_00550]。应用程序实例化该结构以设定特定于事件的去抖时间，并将其传递给诊断监视器的构造函数 [SWS_DM_00550]。随后，DM 为该事件激活基于时间的去抖算法 [SWS_DM_00015]，并基于内部定时器和配置的阈值计算事件状态位 kTestFailed AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.2 “Time-based debouncing”。

上下文图：应用程序、ara::diag::TimeBased、ara::diag::Monitor 与 Diagnostic Management 之间的交互。来源：[SWS_DM_00539]、[SWS_DM_00550]、[SWS_DM_00015]

生命周期

作为一个没有动态资源的基础数据容器，ara::diag::TimeBased 具有简单的生命周期 [SWS_DM_00539]。该结构通常由应用程序在栈上或静态存储区中本地创建，使用目标时间进行初始化，并作为值传递给 ara::diag::Monitor 的构造函数 [SWS_DM_00550]（AUTOSAR_AP_SWS_Diagnostics §8.40.1.1.2.3 “Monitor”）。

理解：通过按值传递，参数在创建监视器时被复制，因此原始 TimeBased 对象在构造函数调用完成后可以安全地丢弃。 问题 (未决)DM 从此时起独立管理去抖定时器的动态状态，并在系统启动时将其初始值设为 0 [SWS_DM_00085]。由于 TimeBased 没有内部同步机制，因此应用侧必须排除对共享实例的并发写访问。

使用路径

典型用法分为以下步骤：

1. 参数化与初始化：应用程序实例化 ara::diag::TimeBased，设置 failedMs [SWS_DM_00629] 以及 passedMs [SWS_DM_00630]，并将该结构传递给 ara::diag::Monitor 的构造函数 [SWS_DM_00550]。
2. 定时器初始化：DM 启动去抖服务，并将事件内部定时器初始化为零值 [SWS_DM_00085]。
3. 上报预检结果：当监视器检测到无故障条件时，它会使用 kPrepassed 调用 ReportMonitorAction。DM 朝着愈合状态方向启动定时器 [SWS_DM_00878]，并持续更新故障检测计数器（Fault Detection Counter, FDC）[SWS_DM_00030]。
4. 判定：当定时器达到阈值 passedMs 时，DM 将该事件判定为 kFinallyHealed [SWS_DM_00878]。如果监视器改报 kFailed，则定时器直接设置为 failedMs，且事件作为 kFinallyDefective 进行处理 [SWS_DM_00033]。
5. 冻结与恢复：如有需要，可通过 ReportMonitorAction(kFreezeDebouncing) 暂停去抖 [SWS_DM_00880]，并在发生新动作（kPrepassed 或 kPrefailed）时从冻结的计数器数值继续恢复 [SWS_DM_00038]。

时序图：基于时间的去抖过程中应用程序、监视器与 DM 之间的交互。来源：[SWS_DM_00550]、[SWS_DM_00085]、[SWS_DM_00878]、[SWS_DM_00033]、[SWS_DM_00880]、[SWS_DM_00038]

错误场景

使用基于时间的去抖时，适用以下功能性前置和后置条件：

• 条件性定时器启动：在上报 kPrepassed 时，DM 仅在定时器尚未朝该方向运行且事件尚未被视为已愈合时，才朝 kFinallyHealed 方向启动定时器 [SWS_DM_00878]。
• 缩短的故障判定：如果直接上报 kFailed 或 kPassed，DM 将去抖定时器立即设置为相应阈值，并不经等待地完成分类判定 [SWS_DM_00033]、[SWS_DM_00036]。
• 冻结操作的排他性：DM 仅针对具有基于时间去抖的事件支持动作 kFreezeDebouncing [SWS_DM_00880]。
• 计数器不持久化：对于基于时间的去抖，不提供跨复位和启动周期的去抖计数器数值存储（debounceCounterStorage）AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.2 “Time-based debouncing”；定时器在每次启动时均被重置为零 [SWS_DM_00085]。