类 ara::diag::MultipleMonitor

使用

方法 ara::diag::MultipleMonitor::ConfigureMonitor 初始化用于监视器内部消抖的诊断监视器 [SWS_DM_01696]。通过参数 monitorHandle 寻址要配置的监视器，同时使用 initMonitor 注册用于重新初始化的通知程序回调，并使用 getFaultDetectionCounter 注册用于查询当前故障计数值（FDC）的函数 [SWS_DM_01696]。执行同步进行并返回一个 ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 “ConfigureMonitor”。

错误处理与并发

出错时将返回错误结果 DiagErrc::kInvalidArgument [SWS_DM_01696]。这尤其可能在传入无效函数指针或内部消抖存在不兼容状态时发生（解释）。 问题 Q-3de0f2b0cc427ef3 (未决)该操作被指定为 noexcept 以及异常安全（exception safe），但明确标记为非线程安全（not thread-safe）[SWS_DM_01696]。因此，在同一监视器实例上的调用必须在应用端进行同步。

顺序与交互

ConfigureMonitor 的每个重载版本对于一个监视器只能严格调用一次；监视器仅在此初始化步骤之后才可投入使用 [SWS_DM_01696]。在监视器内部消抖的情况下，Diagnostic Monitor 应用程序独立处理消抖逻辑，并且仅将最终结果传输给 Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 “Monitor-internal debouncing”。对于其他消抖机制，提供了针对基于时间的消抖 [SWS_DM_01697]、基于计数器的消抖 [SWS_DM_01702] 或未消抖监控 [SWS_DM_01973] 的替代重载。

使用

头文件 ara/diag/multiple_monitor.h 中的同步成员函数 ara::diag::MultipleMonitor::ConfigureMonitor 配置具有基于时间消抖的诊断监视器（[SWS_DM_01697]，SWS Diagnostics §8.44.2.1.3.2 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)”）。调用时传入用于标识监视器的句柄 monitorHandle、类型为 InitMonitorNotifier 的回调函数 initMonitor 以及类型为 TimeBased 的消抖参数 defaultValues（[SWS_DM_01697]）。返回值采用 ara::core::Result<void>，函数签名被声明为 noexcept（[SWS_DM_01697]）。

调用条件与并发性

只有在完成此初始化步骤后才能使用监视器（[SWS_DM_01697]）。每个监视器实例对于 ConfigureMonitor 的每个重载变体只能严格调用一次（[SWS_DM_01697]）。该接口虽然异常安全（exception safe），但非线程安全（not thread-safe），因此同一实例上的并行调用必须由用户端进行同步（[SWS_DM_01697]）。

错误处理

如果配置失败，调用将在 ara::core::Result 内返回一个错误对象，尤其是错误码 DiagErrc::kInvalidArgument（[SWS_DM_01697]）。

相互作用

该方法补充了用于基于计数器的消抖（[SWS_DM_01702]）、监视器内部消抖（[SWS_DM_01696]）以及无消抖监视器（[SWS_DM_01973]）的备选初始化函数。对于基于时间消抖的事件，Diagnostic Manager 还支持有针对性地冻结消抖定时器（[SWS_DM_00880]），以及随后从冻结状态恢复该定时器（[SWS_DM_00038]）。

类 ara::diag::MultipleMonitor 的同步方法 ConfigureMonitor 用于初始化具有基于计数器消抖的诊断监视器（[SWS_DM_01702]，AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 “ConfigureMonitor”）。该声明通过头文件 ara/diag/multiple_monitor.h 提供（[SWS_DM_01702]）。

用法与参数

该函数接收以下传入参数（[SWS_DM_01702]）：

• monitorHandle（MonitorHandleType）：标识要配置的诊断监视器。
• initMonitor（InitMonitorNotifier）：注册用于初始化监视器的通知回调函数。
• defaultValues（CounterBased）：传入用于基于计数器消抖的默认配置值。

作为返回值，该操作提供一个 ara::core::Result<void>，用于提供成功或错误的信息（[SWS_DM_01702]）。

错误处理

若配置失败，则在返回值中报告错误。当参数无效时，将返回错误码 DiagErrc::kInvalidArgument（[SWS_DM_01702]）。该函数被声明为 noexcept 并保证异常安全性（exception safe）（[SWS_DM_01702]）。

并发性与限制

ConfigureMonitor 的每个重载版本对于一个监视器强制只能调用一次；监视器仅在此初始化步骤之后才可使用（[SWS_DM_01702]）。由于该操作被归类为非线程安全（not thread-safe）（[SWS_DM_01702]），跨线程边界发生调用时可能需要外部同步（解释）。 问题 Q-fcb809ccb021dd6d (未决)

相互作用

该方法是 MultipleMonitor 中配置接口的一部分。它补充了相关重载版本：包含 TimeBased 的基于时间消抖（[SWS_DM_01697]）、带读取功能的监视器内部消抖（[SWS_DM_01696]）以及完全没有消抖机制的监视器（[SWS_DM_01973]）。

同步方法 ConfigureMonitor 用于在 ara::diag::MultipleMonitor 内初始化无消抖的诊断监视器（[SWS_DM_01973]，AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)”）。它接收监视器的句柄（monitorHandle）以及用于注册 InitMonitorNotifier 通知且类型为（initMonitor）的回调函数作为输入参数（[SWS_DM_01973]）。仅在此强制初始化步骤之后，才能激活使用相关监视器（[SWS_DM_01973]）。

关于调用上下文和并发性，适用以下边界条件：

• ConfigureMonitor 的每个重载版本对于每个单独的监视器只能精确调用一次（[SWS_DM_01973]）。
• 该方法被指定为 exception safe，但被归类为 not thread-safe（[SWS_DM_01973]）。因此，对同一监视器的并发访问可能需要应用程序进行外部同步。 问题 Q-2272f26f380a5a11 (未决)

该函数返回一个 ara::core::Result<void> 作为结果（[SWS_DM_01973]）。若配置失败，则返回错误，例如 DiagErrc::kInvalidArgument（[SWS_DM_01973]）。如果诊断监视器需要消抖方法，则可改用针对监视器内部消抖（[SWS_DM_01696]）、基于时间的消抖（[SWS_DM_01697]）或基于计数器的消抖（[SWS_DM_01702]）的重载变体。

函数 Offer 启用 Diagnostic Management 守护进程（DM）向相应处理程序转发传入的诊断请求 [SWS_DM_01699]。该同步调用无参数，且被指定为具有异常安全性（exception safe）的 noexcept [SWS_DM_01699]。

在成功的情况下，该函数返回一个空的 ara::core::Result<void> [SWS_DM_01699]。如果此前已成功对该处理程序执行过注册，则调用失败并返回具有回滚语义的错误码 DiagOfferErrc::kAlreadyOffered [SWS_DM_01699]；该错误状态归属于诊断错误域 [SWS_DM_00514]。

在并发性方面，该方法被声明为 not thread-safe [SWS_DM_01699]。解释：推测不得在未受保护的情况下从不同线程调用同一处理程序实例，以避免注册状态出现不一致。 问题 Q-95f2e0895004c73b (未决)

Offer 方法的模式符合 AUTOSAR Adaptive 中诊断处理程序的统一提供机制，与用于通用例程 [SWS_DM_00557] 或 UDS 服务 [SWS_DM_00619] 的机制类似。尽管其命名借鉴了 ara::com 中的服务提供，但这属于独立的诊断专用实现 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。

ara::diag::MultipleMonitor 中的函数 [SWS_DM_01698] 用于向 Diagnostic Manager（DM）报告特定诊断 Monitor 的状态信息和去抖动命令。目标 Monitor 通过参数 monitorHandle 进行寻址，而 action 则传递（未）合格的测试结果或用于去抖动和预存储的命令。

关于错误行为，DM 将忽略带有无效 monitorHandle 的调用 [SWS_DM_01698]。如果传递了配置的去抖动方法不支持的操作，DM 将触发违规（Violation）[SWS_DM_01988]。此外，未满足的使能条件可能导致报告被丢弃（AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 “EnableConditions”），这对应于内部错误代码 [SWS_DM_00514]。

关于并发和执行：

• 该方法被声明为 noexcept，因此是异常安全的 [SWS_DM_01698]。
• 线程安全性是有条件的：调用是否必须是线程安全的，取决于传递给构造函数的 ConcurrencyType [SWS_DM_01698]。
• 在与基于计数器的去抖动协同工作时，例如报告 kPrefailed 会导致内部计数器递增 [SWS_DM_00875]。Interpretation：为单个 Monitor 定义的去抖动机制和使能条件大概同样适用于通过句柄控制的多实例。 问题 Q-ff29529143d35ca2 (未决)

类 ara::diag::MultipleMonitor 的方法 StopOffer 用于禁用从 Diagnostic Management（DM）向处理程序转发请求消息 [SWS_DM_01700]。它是提供接口的功能对应项，使应用程序能够有针对性地停止处理传入的诊断请求。

使用受以下特征和约束条件的限制：

• 签名与调用上下文：该函数通过头文件 ara/diag/multiple_monitor.h 声明，并具有签名 void StopOffer() noexcept; [SWS_DM_01700]。它不接受任何参数，也不返回任何返回值。该调用同步执行。
• 错误处理：该方法被指定为 noexcept 且具备异常安全性（exception safe）[SWS_DM_01700]。它不抛出异常，也不提供特定的错误码或错误消息。
• 并发性：该元素被明确归类为非线程安全（not thread-safe）[SWS_DM_01700]。对同一实例的并发调用可能必须由应用程序在外部进行同步。 问题 Q-b73ead392f8b95b2 (未决)

StopOffer 的语义遵循 AUTOSAR Adaptive 中诊断处理程序的统一设计模式，在该模式下服务通过 Offer 和 StopOffer 进行控制 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。禁用请求转发的相同原理也存在于相关端口（如 ara::diag::Monitor::StopOffer [SWS_DM_01089]）以及通用例程 [SWS_DM_00558] 和 UDS 服务 [SWS_DM_00620] 中。