DEENESPTFRRUARHIKOZHNL

类 ara::sm::s2r::S2RSatellite

[SWS_SM_81002] Upstream: RS_SM_00402

class S2RSatellite {...};

S2RSatellite abstract class.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Forwarding-Header#include "ara/sm/sm_fwd.h"
Scopenamespace ara::sm::s2r

用户指南人工智能生成

为应用程序接收 Suspend-to-RAM 通知,以实现协调的准备和恢复。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: c425edf7dbdd 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

为应用程序接收 Suspend-to-RAM 通知,以实现协调的准备和恢复。

接口 ara::sm::s2r::S2RSatellite 用作 Adaptive Applications 接收来自 State Management 的 Suspend-to-RAM 通知的接收器([SWS_SM_81002]、AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”)。在初始化并经由 Offer() 激活后,已实现的回调函数 EnterSuspendMode() 和 LeaveSuspendMode() 将被调用,以异步控制特定于应用程序的准备工作,如数据备份或服务重启([SWS_SM_00710]、[SWS_SM_81010]、[SWS_SM_81011])。在中央 Hub 处的注册强制要求具有经过适度建模且经过 IAM 认证的进程上下文([SWS_SM_00715])。

上下文

抽象基类 ara::sm::s2r::S2RSatellite 为 Adaptive Applications 定义了接收进入和退出“prepared for Suspend-to-RAM”状态通知的接口([SWS_SM_81002]、AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”)。虽然 State Management 内部的中央 S2RHub 负责协调挂起流程(AUTOSAR_AP_SWS_StateManagement §7.5.1 “S2R Hub”),但 S2RSatellite 的实例充当相应应用程序中的本地端点。Adaptive Application 实现抽象回调函数,以执行特定于应用程序的准备工作,例如保存持久性数据、停止提供的服务或停止安全关键活动(AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”)。

S2RKontext app Adaptive Application sat ara::sm::s2r::S2RSatellite app->sat implementiert / instanziiert hub ara::sm::s2r::S2RHub (State Management) sat->hub Offer() / StopOffer() (Registrierung) hub->sat EnterSuspendMode() LeaveSuspendMode() iam Identity & Access Management (IAM) hub->iam 检查进程上下文 [SWS_SM_00715]

上下文图:Adaptive Application、S2RSatellite、S2RHub 和 Identity Access Management 之间的交互。来源:[SWS_SM_00710]、[SWS_SM_00715]、AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”、AUTOSAR_AP_SWS_StateManagement §7.5.1 “S2R Hub”。

注册和交互受 Identity and Access Management (IAM) 的安全检查约束:仅当卫星的进程上下文与配置的 SuspendToRamSatelliteMapping 一致时,S2RHub 才允许注册([SWS_SM_00715])。

生命周期

实例的创建通过显式构造函数 S2RSatellite(const ara::core::InstanceSpecifier&)([SWS_SM_81003])或静态工厂方法 Create()([SWS_SM_81014])进行。默认构造函数已被删除([SWS_SM_81004])。该类具有严格的所有权语义:拷贝构造函数和拷贝赋值运算符被显式删除([SWS_SM_81007]、[SWS_SM_81009]),而移动构造函数和移动赋值是允许的、异常安全的且线程安全的([SWS_SM_81006]、[SWS_SM_81008])。

实例化后,对象处于非活动状态。只有通过调用 Offer(),卫星才会在 Hub 处主动注册并激活处理程序调用([SWS_SM_00710]、[SWS_SM_81012])。卫星保持活动注册状态,直到调用 StopOffer()([SWS_SM_00710]、[SWS_SM_81013])。通过虚析构函数 ~S2RSatellite()([SWS_SM_81005])销毁时,推测该实例必须事先已注销或会被隐式释放。 问题 Q-bbccd3c283007ce8 (未决)虽然构造函数和赋值是线程安全的,但 Offer()、StopOffer()、析构函数以及处理程序都不是线程安全的([SWS_SM_81003]、[SWS_SM_81005]、[SWS_SM_81010]、[SWS_SM_81011]、[SWS_SM_81012]、[SWS_SM_81013])。

使用路径

常规流程包括提供、处理状态更改以及最终注销:

  1. 提供:应用程序实例化其派生的卫星类并调用 Offer(),以建立与 S2RHub 的通信就绪状态([SWS_SM_00710]、[SWS_SM_81012])。
  2. 挂起请求:当 State Management 触发挂起过程时([SWS_SM_00701]),卫星调用纯虚方法 EnterSuspendMode()([SWS_SM_00711]、[SWS_SM_81010])。应用程序执行其保存例程,并通过返回的 ara::core::Future<void> 异步指示就绪状态([SWS_SM_81010])。
  3. 恢复请求:唤醒后,Hub 请求退出挂起模式([SWS_SM_00703])。卫星执行方法 LeaveSuspendMode()([SWS_SM_00711]、[SWS_SM_81011]),随后应用程序重新激活服务。
  4. 终止:在关闭之前,应用程序调用 StopOffer(),从而在 Hub 处注销卫星并停用处理程序([SWS_SM_00713]、[SWS_SM_81013])。
Nutzungsablauf S2RSatelliteAdaptive ApplicationS2RSatelliteS2RHubUse Case: 初始化与注册Offer()RegistrierungBestaetigungResult<void> (Erfolg)Use Case: Suspend-PhaseRequestToEnterSuspendModeEnterSuspendMode()Persistieren, Dienste stoppenFuture<void> aufgeloestAntwort bereitUse Case: Resume-PhaseRequestToLeaveSuspendModeLeaveSuspendMode()Dienste reaktivierenFuture<void> aufgeloestAntwort bereitUse Case: DeregistrierungStopOffer()Deregistrierung

时序图:注册、Suspend-to-RAM 通知、恢复和注销的典型流程。来源:[SWS_SM_00701]、[SWS_SM_00703]、[SWS_SM_00710]、[SWS_SM_00711]、[SWS_SM_00713]、[SWS_SM_81010]、[SWS_SM_81011]、[SWS_SM_81012]、[SWS_SM_81013]。

错误场景

在实例化阶段就可能发生错误。只要强制的 IAM 切换处于活动状态,静态方法 Create() 就会返回错误 ara::sm::SmErrc::kAuthenticationRequired;在这种情况下,必须改用带有 InstanceSpecifier 的参数化构造函数([SWS_SM_00716]、[SWS_SM_81014])。构造函数 S2RSatellite(const ara::core::InstanceSpecifier&) 检查建模和平台状态,并在发生错误时引发运行时违规:

  • 如果平台运行时环境未初始化,则为 AraNotInitializedViolation([SWS_SM_81003])。
  • 如果标识符无法解析或未引用 PortPrototype,则为 InstanceSpecifierMappingIntegrityViolation([SWS_SM_81003])。
  • 如果接口类型与预期的接口映射不匹配,则为 PortInterfaceMappingViolation([SWS_SM_81003])。
  • 如果实例引用不存在匹配的建模进程,则为 ProcessMappingViolation([SWS_SM_81003])。
  • 如果实例标识符已在进程中使用,则为 InstanceSpecifierAlreadyInUseViolation([SWS_SM_81003])。

如果因与 State Management 守护进程的连接问题导致在 Offer() 处的注册失败,调用将返回包含错误 SmErrc::kOfferFailed 的 ara::core::Result([SWS_SM_81012])。如果在执行 EnterSuspendMode() 或 LeaveSuspendMode() 期间出现问题,卫星通过返回的 Future 标明错误 SmErrc::kRejected([SWS_SM_81010]、[SWS_SM_81011])。在退出挂起模式时,这会导致 Hub 端产生总体结果 kAtLeastOneHadIssuesToLeave([SWS_SM_00707])。

本指南仅基于 AUTOSAR Release R25-11 的规范文档。

成员图

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__sm__s2r__S2RSatellite502 S2RSatellite + S2RSatellite() + operator=() + ~S2RSatellite() + Create() + EnterSuspendMode() + LeaveSuspendMode() + Offer() + StopOffer()

详细视图

请在大纲中选择一个条目。

构造函数和析构函数

S2RSatellite 函数 4

Creation of an S2RSatellite.

重载 S2RSatellite 4
explicit S2RSatellite (const ara::core::InstanceSpecifier &instance) noexcept; SWS_SM_81003
S2RSatellite ()=delete; SWS_SM_81004
S2RSatellite (S2RSatellite &&ra) noexcept; SWS_SM_81006
S2RSatellite (const S2RSatellite &)=delete; SWS_SM_81007

Destructor for S2RSatellite.

virtual ~S2RSatellite () noexcept;

方法

Create 函数

Creation of an conneting directly to S2RHub within the current machine.

static ara::core::Result< S2RSatellite > Create () noexcept;

EnterSuspendMode is called to enter Suspend Mode. The handler invocation needs to be enabled before by a call of Offer().

virtual ara::core::Future< void > EnterSuspendMode ()=0;

LeaveSuspendMode is called to leave Suspend Mode. The handler invocation needs to be enabled before by a call of Offer().

virtual ara::core::Future< void > LeaveSuspendMode ()=0;
Offer 函数

Enables potential invocations of handlers .

ara::core::Result< void > Offer () noexcept;
StopOffer 函数

Disables invocations of handlers.

void StopOffer () noexcept;

运算符

operator= 函数 2

Move assignment operator for S2RSatellite.

重载 = 2
S2RSatellite & operator= (S2RSatellite &&ra) noexcept; SWS_SM_81008
S2RSatellite & operator= (const S2RSatellite &)=delete; SWS_SM_81009

方法文档

函数 Create [SWS_SM_81014] Upstream: RS_SM_00402

static ara::core::Result< S2RSatellite > Create () noexcept;

Creation of an conneting directly to S2RHub within the current machine.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: ee8ec5327419 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

静态工厂方法 ara::sm::s2r::S2RSatellite::Create 用于在同一台机器内同步实例化一个卫星端,以便直接连接到 S2RHub([SWS_SM_81014])。该调用不接收任何参数,并返回一个 ara::core::Result<S2RSatellite>,成功时其提供创建的卫星端对象([SWS_SM_81014])。

错误处理

如果配置中的开关“Force IAM switch”设置为 true,则调用失败并返回错误码 ara::sm::SmErrc::kAuthenticationRequired([SWS_SM_00716])。在这种情况下,必须强制改用构造函数 ara::sm::s2r::S2RSatellite::S2RSatellite([SWS_SM_81014])。此外,如果在调用时 ARA 运行时环境未初始化,则会引发 AraNotInitialized-Violation([SWS_SM_81014])。

并发性与边界条件

该函数被指定为线程安全以及异常安全,并声明为 noexcept([SWS_SM_81014])。因此,可以安全地从并发应用上下文中调用它。

相互作用

S2RSatellite 的实例用于支持 S2R 的应用中,以处理挂起模式之前和之后的通知(SWS StateManagement §7.5.2 “S2R Satellite”)。实例化成功后,应用通过 Offer 在 Hub 上注册([SWS_SM_00710])。在销毁对象之前,必须调用 StopOffer 进行注销([SWS_SM_00713])。Interpretation:方法 Create 预计主要用于未对卫星端强制执行 IAM 认证的应用场景。 问题 Q-fc41980edcb3f61a (未决)

本使用说明由 AI 创建。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)AraNotInitialized- Violation message that is sent in case a constructor or function Violation checks for an initialized ara and identifies that ara is not initialized.

Rückgabewert

TypBeschreibung
ara::core::Result< S2RSatellite >a result that contains either a object or an error.

Fehler

FehlercodeBeschreibung
ara::sm::SmErrc::kAuthenticationRequiredrollback_semantics S2R Satellite requires IAM authentication. ara::sm::s2r:: S2RSatellite::S2RSatellite has to be used instead.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81014
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81014@rel:R25-11#22e2b056
Content hash
22e2b056
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81014
Status: valid/unmigrated Version: rel:R25-11#cd8a5e9e Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81014@rel:R25-11#cd8a5e9e
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 EnterSuspendMode [SWS_SM_81010] Upstream: RS_SM_00402

virtual ara::core::Future< void > EnterSuspendMode ()=0;

EnterSuspendMode is called to enter Suspend Mode. The handler invocation needs to be enabled before by a call of Offer().

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 023b44de9187 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::sm::s2r::S2RSatellite [SWS_SM_81010] 的纯虚回调方法 EnterSuspendMode 请求卫星实例进入挂起模式 [SWS_SM_00711]。当 S2R Hub 通过 RequestToEnterSuspendMode 指示所有处于活动注册状态的卫星切换至挂起状态时,将发起该调用 [SWS_SM_00701]。接收此调用的前提条件是,该卫星实例此前已通过 Offer 成功在 Hub 上注册 [SWS_SM_81010] [SWS_SM_00710]。

ara::core::Future<void> 用作返回值 [SWS_SM_81010]。如果应用程序能够成功进入挂起模式,则 Future 将以 void 兑现 [SWS_SM_81010]。若发生错误,则该 Future 应以错误码 SmErrc::kRejected 完成 [SWS_SM_81010]。如果至少有一个卫星报告 kRejected,则 Hub 请求将返回总体结果 kAtLeastOneRejected [SWS_SM_00702]。若某个卫星未在超时时间内及时响应,通信将因错误 kCommunicationTimeout 中断 AUTOSAR_AP_SWS_StateManagement 第36页。

在并发性方面,该接口被定义为非线程安全(not-threadsafe)且非异常安全(not exception safe)[SWS_SM_81010]。在销毁卫星对象之前,必须调用 StopOffer;该调用会注销卫星并阻塞,直到正在运行的回调执行完成 [SWS_SM_00713]。由于该方法被声明为纯虚函数,具体的实现预计会在派生的应用程序类中完成,以便在 Suspend-to-RAM 之前持久化本地状态。 问题 Q-628b88828075652c (未决)

本文由 AI 系统基于 AUTOSAR R25-11 规范生成。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitnot exception safe
Thread-Sicherheitnot-threadsafe

Rückgabewert

TypBeschreibung
ara::core::Future< void >void in case the Suspend Mode is successfully entered; or the error kRejected if there is an issue to enter Suspend Mode.

Fehler

FehlercodeBeschreibung
SmErrc::kRejectedrollback_semantics There are issues to enter Suspend Mode.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81010
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81010@rel:R25-11#24bf6151
Content hash
24bf6151
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81010
Status: valid/unmigrated Version: rel:R25-11#4ccf8b3e Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81010@rel:R25-11#4ccf8b3e
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 LeaveSuspendMode [SWS_SM_81011] Upstream: RS_SM_00402

virtual ara::core::Future< void > LeaveSuspendMode ()=0;

LeaveSuspendMode is called to leave Suspend Mode. The handler invocation needs to be enabled before by a call of Offer().

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 4c7954c5f9b4 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

纯虚方法 LeaveSuspendMode 用于支持 S2R 的应用程序(S2R-Aware applications)退出挂起模式并恢复常规运行 [SWS_SM_81011],SWS StateManagement §7.5.2 “S2R Satellite”。作为 Interpretation,应用程序专用的恢复逻辑预计会在派生自 ara::sm::s2r::S2RSatellite 的类中实现。 问题 Q-c8e12bf51d76935c (未决)

用法与调用上下文

该调用以异步方式进行,并在卫星端接收到恢复触发时被引发 [SWS_SM_00711]。此触发源自 ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode,后者向所有处于活动注册状态的卫星实例发送消息 [SWS_SM_00703]。该方法不期望任何参数,并返回一个 ara::core::Future<void> [SWS_SM_81011]。成功时,一旦成功退出挂起模式,Future 即以 void 兑现 [SWS_SM_81011]。

错误处理

若在唤醒时发生问题,Future 将以错误码 SmErrc::kRejected 失败(回滚语义)[SWS_SM_81011]。这将促使 S2R Hub 输出 kAtLeastOneHadIssuesToLeave 作为总体结果 [SWS_SM_00707]。若某个卫星在规定期限内未做出响应,Hub 将以 kCommunicationTimeout 中断 [SWS_SM_00707]。

并发性与前置条件

  • Registrierung:处理程序激活的前提条件是此前已调用 Offer [SWS_SM_81011],从而使卫星处于活动注册状态 [SWS_SM_00710]。
  • Sicherheit:该操作被指定为 not-threadsafe 和 not exception safe [SWS_SM_81011]。
  • Lebenszyklus:在销毁卫星之前必须调用 StopOffer;该调用会阻塞,直至正在运行的回调完成 [SWS_SM_00713]。

该使用提示自动生成,并完全基于 AUTOSAR Adaptive R25-11 的规范数据。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitnot exception safe
Thread-Sicherheitnot-threadsafe

Rückgabewert

TypBeschreibung
ara::core::Future< void >void in case the Suspend Mode is left; or the error kRejected if the resume is not successful.

Fehler

FehlercodeBeschreibung
SmErrc::kRejectedrollback_semantics There are issues to leave Suspend Mode.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81011
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81011@rel:R25-11#8a90236a
Content hash
8a90236a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81011
Status: valid/unmigrated Version: rel:R25-11#121e27da Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81011@rel:R25-11#121e27da
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 Offer [SWS_SM_81012] Upstream: RS_SM_00402

ara::core::Result< void > Offer () noexcept;

Enables potential invocations of handlers .

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 4698b0d80386 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

同步成员函数 ara::sm::s2r::S2RSatellite::Offer 用于将卫星端实例注册到中央 S2R-Hub [SWS_SM_00710]。该无参调用会激活通知接收功能,从而使得用于切换到挂起模式以及重新唤醒的应用端回调能够被调用 [SWS_SM_81012]、[SWS_SM_81010]、[SWS_SM_81011]。该方法返回 ara::core::Result<void>,并声明为异常安全(noexcept)[SWS_SM_81012]。

在常规成功情况下,返回的 Result 为空 [SWS_SM_81012]。如果由于与 State Management 守护进程通信中断而无法提供服务,调用将失败并返回错误码 SmErrc::kOfferFailed [SWS_SM_81012]。此外,卫星端的进程上下文必须符合已注册应用的 IAM 规定,因为未授权的实例将被拒绝 [SWS_SM_00715]。Interpretation:若注册失败,该实例预计仍保持未在 Hub 上注册的状态。 问题 Q-1b445bcf1aecef2d (未决)

在并发性方面,Offer 被指定为非线程安全(not thread-safe)[SWS_SM_81012];因此在同一实例上的并发调用需要外部同步。在成功提供后,卫星端将保持活动注册状态,直到应用显式调用 ara::sm::s2r::S2RSatellite::StopOffer [SWS_SM_00710]。通过 StopOffer 进行的注销必须在卫星端销毁之前执行,并且会发生阻塞,直到正在运行的回调完成 [SWS_SM_00713]。

本文由 AI 生成,仅供参考。唯一具有约束力的是 AUTOSAR 规范。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >A Result, being either empty or containing any of the errors defined below.

Fehler

FehlercodeBeschreibung
SmErrc::kOfferFailedrollback_semantics Service could not be offered due to failure of communication with Sm daemon

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81012
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81012@rel:R25-11#8e7e2bcb
Content hash
8e7e2bcb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81012
Status: valid/unmigrated Version: rel:R25-11#a19ccbb6 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81012@rel:R25-11#a19ccbb6
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 S2RSatellite [SWS_SM_81003] Upstream: RS_SM_00402

explicit S2RSatellite (const ara::core::InstanceSpecifier &instance) noexcept;

Creation of an S2RSatellite.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- The type of mapping does not match the expected type of Port pingViolation Interface: {portInterfaceTypeName} referenced by a {mappingType Name}. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process. AraNotInitialized- Violation message that is sent in case a constructor or function Violation checks for an initialized ara and identifies that ara is not initialized.

Parameter (in)

ParameterBeschreibung
instanceinstance specifier to the PPortPrototype of a SuspendToRamSatelliteInterface

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81003
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81003@rel:R25-11#61a9ca13
Content hash
61a9ca13
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81003
Status: valid/unmigrated Version: rel:R25-11#00c86d21 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81003@rel:R25-11#00c86d21
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 S2RSatellite [SWS_SM_81004] Upstream: RS_SM_00402

S2RSatellite ()=delete;

Default constructor for S2RSatellite shall not be used.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81004
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81004@rel:R25-11#1c10d5e7
Content hash
1c10d5e7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81004
Status: valid/unmigrated Version: rel:R25-11#5d3b2368 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81004@rel:R25-11#5d3b2368
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 S2RSatellite [SWS_SM_81006] Upstream: RS_SM_00402

S2RSatellite (S2RSatellite &&ra) noexcept;

Move constructor for S2RSatellite.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
raThe S2RSatellite object to be moved.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81006
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81006@rel:R25-11#7779d266
Content hash
7779d266
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81006
Status: valid/unmigrated Version: rel:R25-11#00250293 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81006@rel:R25-11#00250293
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 S2RSatellite [SWS_SM_81007] Upstream: RS_SM_00402

S2RSatellite (const S2RSatellite &)=delete;

The copy constructor for S2RSatellite shall not be used.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81007
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81007@rel:R25-11#30c01ef4
Content hash
30c01ef4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81007
Status: valid/unmigrated Version: rel:R25-11#c1967e7f Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81007@rel:R25-11#c1967e7f
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

void StopOffer () noexcept;

Disables invocations of handlers.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: f065eb564bf8 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用法与语义

方法 StopOffer() 在 S2R Hub 处注销 ara::sm::s2r::S2RSatellite 的实例,并停用未来的回调调用([SWS_SM_81013]、[SWS_SM_00710])。该调用同步进行,并一直阻塞到当前所有活动的回调执行完全结束([SWS_SM_00713])。该函数不接收参数,也没有返回值。

生命周期与错误处理

该接口声明为 noexcept 且不抛出异常;不存在特定的错误码([SWS_SM_81013])。根据规范,StopOffer() 是非线程安全的(not thread-safe)。应用必须确保要么在销毁 S2RSatellite 对象之前显式调用 StopOffer(),要么——Interpretation:大概——在封装用户类的析构函数中执行(SWS StateManagement §7.5.2 “Deregistration of S2R Satellites at S2R Hub”)。 问题 Q-79aa369fb23871ed (未决)

在挂起到 RAM 流程中的交互

当 S2R Hub 处于执行 RequestToEnterSuspendMode 或 RequestToLeaveSuspendMode 的过程中时,它会等待所有寻址的卫星端。如果卫星端在此阶段通过 StopOffer() 注销,Hub 会将其视为肯定确认,从而避免状态切换失败([SWS_SM_00702]、[SWS_SM_00707])。

本使用说明基于 AUTOSAR 规范 R25-11 自动创建。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81013
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81013@rel:R25-11#e8ea8fe6
Content hash
e8ea8fe6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81013
Status: valid/unmigrated Version: rel:R25-11#b565557d Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81013@rel:R25-11#b565557d
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 operator= [SWS_SM_81008] Upstream: RS_SM_00402

S2RSatellite & operator= (S2RSatellite &&ra) noexcept;

Move assignment operator for S2RSatellite.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
raThe S2RSatellite object to be moved.

Rückgabewert

TypBeschreibung
S2RSatellite &The moved S2RSatellite object.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81008
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81008@rel:R25-11#bd4b8b00
Content hash
bd4b8b00
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81008
Status: valid/unmigrated Version: rel:R25-11#b5e55d29 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81008@rel:R25-11#b5e55d29
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 operator= [SWS_SM_81009] Upstream: RS_SM_00402

S2RSatellite & operator= (const S2RSatellite &)=delete;

The copy assignment operator for S2RSatellite shall not be used.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81009
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81009@rel:R25-11#f016508e
Content hash
f016508e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81009
Status: valid/unmigrated Version: rel:R25-11#f0c4993d Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81009@rel:R25-11#f0c4993d
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 ~S2RSatellite [SWS_SM_81005] Upstream: RS_SM_00402

virtual ~S2RSatellite () noexcept;

Destructor for S2RSatellite.

Header-Datei#include "ara/sm/s2r/S2RSatellite.h"
Scopeclass ara::sm::s2r::S2RSatellite
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_81005
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_81005@rel:R25-11#a792d092
Content hash
a792d092
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_81005
Status: valid/unmigrated Version: rel:R25-11#4b892348 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_81005@rel:R25-11#4b892348
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill