类 ara::diag::EcuResetRequest

用法与调用上下文

类 ara::diag::EcuResetRequest 的纯虚方法 EnableRapidShutdown 用作用于处理快速关机 UDS 子功能的接口（[SWS_DM_01012]）。当收到服务 0x11（ECUReset）的传入诊断请求时，Diagnostic Manager（DM）会调用此函数：对于 EnableRapidPowerShutdown 传入参数 enable = true（[SWS_DM_01020]），对于 DisableRapidPowerShutdown 传入 enable = false（[SWS_DM_01021]）。这使得这两个子功能与所有其他触发 RequestReset 的 ECUReset 服务区别开来（[SWS_DM_00235]）。

该方法接收三个参数（[SWS_DM_01012]）：

• enable：在 true 时激活快速关机，并在 false 时停用快速关机。
• metaInfo：传递诊断请求的元信息。
• cancellationHandler：用于在当前诊断会话被取消时，通过 cancellationHandler.IsCanceled() 监视取消状态或通过 cancellationHandler.SetNotifier() 注册通知器。

语义、错误处理与并发性

该接口返回 ara::core::Future<void>；因此实际处理推测在后台异步进行（[SWS_DM_01012]）。 问题 Q-ee781913ae88fabb (未决)在成功的情况下，future 不返回任何值。在出错的情况下，必须使用 DiagUdsNrcErrc 设置符合 ISO 14229-1 的相应否定响应码（NRC）（AUTOSAR_AP_SWS_Diagnostics §8.16.3.1.3.1 “EnableRapidShutdown”）。该函数被指定为 noexcept 且是异常安全的（exception safe），但被视为非线程安全（not thread-safe），因此应用端必须避免在同一实例上进行并发调用（[SWS_DM_01012]）。

接口 ara::diag::EcuResetRequest 的方法 ExecuteReset 由 Diagnostic Server（DM）调用，以便在实现进程中实际触发先前通过 [SWS_DM_01013] 接受的 ECU 复位 [SWS_DM_01014]。请求的 metaInfo 将作为参数传递。该函数被指定为非线程安全（not thread-safe），但为异常安全（exception safe）[SWS_DM_01014]。

Diagnostic Server 的调用时机取决于配置参数 DiagnosticEcuResetClass.respondToReset：

• 如果该参数不存在或设置为 respondBeforeReset，则 Diagnostic Server 仅在发送肯定 UDS 响应之后才会调用 ExecuteReset [SWS_DM_01023]。
• 如果配置了 respondAfterReset，则直接调用 ExecuteReset，而无需事先发送肯定响应 [SWS_DM_01090]。

该函数返回 ara::core::Future<void> [SWS_DM_01014]。如果在接受复位后阻止了传入的 UDS 请求 [SWS_DM_01022]，则一旦 ExecuteReset 返回的 Future 完成，Diagnostic Server 就会再次解除此阻止 [SWS_DM_01309]。可能的错误通过 ISO 14229-1 NRC 在 Future 中使用 DiagUdsNrcErrc 进行指示；然而在配置为 respondBeforeReset 时，传递的错误将不起作用 [SWS_DM_01014]。

通过方法 ara::diag::EcuResetRequest::Offer（[SWS_DM_01016]），Adaptive Application 向 Diagnostic Management（DM）发出信号，表明其已准备好接收用于 ECU 复位的传入诊断请求。通过该同步调用，DM 被授权将相应的请求报文转发给此处理程序（[SWS_DM_01016]）。该调用通常可能发生在应用程序的初始化阶段，即在由 DM 处理诊断请求之前。 问题 Q-93d794e6b1dba23e (未决)

调用与错误处理

该函数不包含输入参数，声明为 noexcept，并保证异常安全性（[SWS_DM_01016]）。返回值采用 ara::core::Result<void>。如果由于该服务先前已被提供而导致提供失败，则该方法将返回具有回滚语义的错误码 DiagOfferErrc::kAlreadyOffered（[SWS_DM_01016]）。

并发性与交互

根据规范，该函数被归类为 not thread-safe（[SWS_DM_01016]）。因此，对 ara::diag::EcuResetRequest 的同一实例的调用必须在应用端进行同步。该提供模式符合 Adaptive Diagnostic Management 中的统一接口设计，与为其他处理程序（如 ara::diag::GenericUDSService::Offer（[SWS_DM_00619]）、ara::diag::GenericRoutine::Offer（[SWS_DM_00557]）或 ara::diag::CommunicationControl::Offer（[SWS_DM_00809]））定义的模式类似。尽管其命名借鉴了 ara::com，但它是 Diagnostic Management 的独立实现（AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”）。

一旦接收到针对服务 0x11 (ECUReset) 的 UDS 请求，诊断服务器就会调用方法 ara::diag::EcuResetRequest::RequestReset（#include "ara/diag/ecu_reset_request.h"）（[SWS_DM_00235]、SWS Diagnostics §7.3.2.8.5.2 “Service 0x11 – ECUReset – all other sub functions”）。这适用于除 EnableRapidPowerShutdown 和 DisableRapidPowerShutdown 之外的所有复位子功能（[SWS_DM_01013]）。在接受请求之前，进行实例化的应用程序必须仔细检查是否允许对部分或整个机器执行重启（[SWS_DM_01013]）。

参数与异步接口

该调用传递复位类型 resetType、可选标识符 id（仅在 resetType 处于 custom 时才进行求值）、元数据 metaInfo 以及一个 cancellationHandler ([SWS_DM_01013])。通过 cancellationHandler，应用程序可以通过 IsCanceled 获取取消状态，或通过 SetNotifier 注册取消事件的回调函数（[SWS_DM_01013]）。结果通过 ara::core::Future<void> 异步提供（[SWS_DM_01013]）。

错误处理、执行控制与并发

如果无法接受复位，必须根据 ISO 14229-1 通过 DiagUdsNrcErrc 在 Future 中返回合适的 NRC 错误码（[SWS_DM_01013]）；此外，还会考虑报告 ApApplicationError（[SWS_DM_00360]）。如果请求被接受，该决定对后续的 ExecuteReset 触发器具有约束力（[SWS_DM_01013]），并且诊断服务器将忽略后续传入的 UDS 请求（[SWS_DM_01022]），直到 ExecuteReset 完成后解除阻塞（[SWS_DM_01309]）。实际的复位执行取决于 DiagnosticEcuResetClass.respondToReset，在发送肯定 UDS 响应之后（[SWS_DM_01023]）或紧接着在重启之前执行（[SWS_DM_01090]）。该函数被指定为 exception safe，但明确指定为 not thread-safe（[SWS_DM_01013]）。

使用

方法 ara::diag::EcuResetRequest::StopOffer 终止复位服务的提供，并禁用从 Diagnostic Management (DM) 到应用程序的传入请求消息的转发（[SWS_DM_01017]、AUTOSAR_AP_SWS_Diagnostics §8.16.3.1.3.5 “StopOffer”）。该函数具有签名 void StopOffer() noexcept，不接收参数且不返回值。

错误处理与异常行为

该操作被声明为 noexcept，并在规范中被归类为异常安全（exception safe）（[SWS_DM_01017]）。它既不抛出异常，也不向调用者返回特定错误代码。

并发性与限制

该方法被明确归类为非线程安全（not thread-safe）（[SWS_DM_01017]）。调用者必须在应用程序端同步对 ara::diag::EcuResetRequest 的同一实例的并发访问。从业务逻辑来看，该调用应该仅在先前已提供处理器之后进行，以便有序地停止接收后续的复位请求。 问题 Q-25f37b77dc8cf80f (未决)

相互作用

通过 StopOffer 禁用转发遵循了 Adaptive AUTOSAR 中功能诊断处理器的统一接口模式，该模式在类似情况下也针对诸如 CommunicationControl（[SWS_DM_00810]）或 DownloadService（[SWS_DM_00793]）等其他服务进行了定义。