DEENESPTFRRUARHIKOZHNL

class 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

User GuideKI-GENERIERT

Empfängt Suspend-to-RAM-Benachrichtigungen für Anwendungen zur koordinerten Vorbereitung und Wiederaufnahme.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c425edf7dbdd Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Empfängt Suspend-to-RAM-Benachrichtigungen für Anwendungen zur koordinerten Vorbereitung und Wiederaufnahme.

Die Schnittstelle ara::sm::s2r::S2RSatellite dient Adaptive Applications als Empfänger für Suspend-to-RAM-Benachrichtigungen aus dem State Management ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 „Interfaces for Suspend-to-Ram Notifications“). Nach der Initialisierung und Aktivierung via Offer() werden die implementierten Rückruffunktionen EnterSuspendMode() und LeaveSuspendMode() aufgerufen, um anwendungsspezifische Vorbereitungen wie Datensicherung oder Dienstneustarts asynchron zu steuern ([SWS_SM_00710], [SWS_SM_81010], [SWS_SM_81011]). Die Registrierung am zentralen Hub setzt dabei zwingend einen passend modellierten und IAM-authentifizierten Prozesskontext voraus ([SWS_SM_00715]).

Kontext

Die abstrakte Basisklasse ara::sm::s2r::S2RSatellite definiert die Schnittstelle für Adaptive Applications, um Benachrichtigungen für den Übergang in den und aus dem Zustand „prepared for Suspend-to-RAM“ zu empfangen ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 „Interfaces for Suspend-to-Ram Notifications“). Während der zentrale S2RHub innerhalb des State Managements die Koordination der Suspend-Abläufe steuert (AUTOSAR_AP_SWS_StateManagement §7.5.1 „S2R Hub“), agiert die Instanz von S2RSatellite als lokaler Endpunkt in der jeweiligen Anwendung. Eine Adaptive Application implementiert die abstrakten Rückruffunktionen, um anwendungsspezifische Vorbereitungen wie das Sichern persistenter Daten, das Einstellen angebotener Dienste oder das Stoppen sicherheitskritischer Aktivitäten vorzunehmen (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) prüft Prozesskontext [SWS_SM_00715] prüft Prozesskontext

Kontextdiagramm: Zusammenspiel zwischen Adaptive Application, S2RSatellite, S2RHub und Identity Access Management. Quellen: [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“.

Die Registrierung und Interaktion unterliegt Sicherheitsprüfungen durch das Identity and Access Management (IAM): Der S2RHub lässt eine Registrierung nur zu, wenn der Prozesskontext des Satelliten mit dem konfigurierten SuspendToRamSatelliteMapping übereinstimmt ([SWS_SM_00715]).

Lebenszyklus

Die Erzeugung einer Instanz erfolgt über den expliziten Konstruktor S2RSatellite(const ara::core::InstanceSpecifier&) ([SWS_SM_81003]) oder über die statische Fabrikmethode Create() ([SWS_SM_81014]). Der Standardkonstruktor ist gelöscht ([SWS_SM_81004]). Die Klasse besitzt strikte Semantik für Eigentümerschaft: Kopierkonstruktor und Kopierzuweisungsoperator sind explizit gelöscht ([SWS_SM_81007], [SWS_SM_81009]), Verschiebekonstruktor und Verschiebezuweisung sind hingegen zulässig, ausnahmesicher und threadsicher ([SWS_SM_81006], [SWS_SM_81008]).

Nach der Instanziierung befindet sich das Objekt im inaktiven Zustand. Erst durch den Aufruf von Offer() registriert sich der Satellit aktiv beim Hub und aktiviert die Handler-Aufrufe ([SWS_SM_00710], [SWS_SM_81012]). Der Satellit bleibt aktiv registriert, bis StopOffer() aufgerufen wird ([SWS_SM_00710], [SWS_SM_81013]). Bei der Zerstörung über den virtuellen Destruktor ~S2RSatellite() ([SWS_SM_81005]) muss die Instanz vermutlich zuvor deregistriert worden sein oder wird implizit freigegeben. Frage Q-bbccd3c283007ce8 (offen) Während Konstruktoren und Zuweisungen threadsicher sind, sind Offer(), StopOffer(), der Destruktor sowie die Handler nicht threadsicher ([SWS_SM_81003], [SWS_SM_81005], [SWS_SM_81010], [SWS_SM_81011], [SWS_SM_81012], [SWS_SM_81013]).

Nutzungspfad

Der reguläre Ablauf umfasst die Bereitstellung, das Verarbeiten von Zustandswechseln und die abschließende Deregistrierung:

  1. Bereitstellung: Die Anwendung instanziiert ihre abgeleitete Satellitenklasse und ruft Offer() auf, um die Kommunikationsbereitschaft mit dem S2RHub herzustellen ([SWS_SM_00710], [SWS_SM_81012]).
  2. Suspend-Aufforderung: Löst das State Management einen Suspend-Vorgang aus ([SWS_SM_00701]), ruft der Satellit die reine virtuelle Methode EnterSuspendMode() auf ([SWS_SM_00711], [SWS_SM_81010]). Die Anwendung führt ihre Sicherungsroutinen aus und signalisiert die Bereitschaft asynchron über das zurückgegebene ara::core::Future<void> ([SWS_SM_81010]).
  3. Resume-Aufforderung: Nach dem Aufwachen fordert der Hub das Verlassen des Suspend-Modus an ([SWS_SM_00703]). Der Satellit führt die Methode LeaveSuspendMode() aus ([SWS_SM_00711], [SWS_SM_81011]), woraufhin die Anwendung Dienste reaktiviert.
  4. Beendigung: Vor dem Herunterfahren ruft die Anwendung StopOffer() auf, wodurch der Satellit beim Hub abgemeldet und Handler deaktiviert werden ([SWS_SM_00713], [SWS_SM_81013]).
Nutzungsablauf S2RSatelliteAdaptive ApplicationS2RSatelliteS2RHubUse Case: Initialisierung und RegistrierungOffer()RegistrierungBestaetigungResult<void> (Erfolg)Use Case: Suspend-PhaseRequestToEnterSuspendModeEnterSuspendMode()Persistieren, Dienste stoppenFuture<void> aufgeloestAntwort bereitUse Case: Resume-PhaseRequestToLeaveSuspendModeLeaveSuspendMode()Dienste reaktivierenFuture<void> aufgeloestAntwort bereitUse Case: DeregistrierungStopOffer()Deregistrierung

Sequenzdiagramm: Typischer Ablauf von Registrierung, Suspend-to-RAM-Benachrichtigung, Wiederaufnahme und Deregistrierung. Quellen: [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].

Fehlerszenarien

Bereits bei der Instanziierung können Fehler auftreten. Die statische Methode Create() liefert den Fehler ara::sm::SmErrc::kAuthenticationRequired, sofern ein erzwungener IAM-Wechsel aktiv ist; in diesem Fall muss stattdessen der parametrisierte Konstruktor mit InstanceSpecifier genutzt werden ([SWS_SM_00716], [SWS_SM_81014]). Der Konstruktor S2RSatellite(const ara::core::InstanceSpecifier&) prüft Modellierungs- und Plattformzustände und löst bei Fehlern Laufzeitverletzungen aus:

  • AraNotInitializedViolation, wenn die Plattform-Laufzeitumgebung nicht initialisiert ist ([SWS_SM_81003]).
  • InstanceSpecifierMappingIntegrityViolation, falls der Bezeichner nicht auflösbar ist oder nicht auf einen PortPrototype verweist ([SWS_SM_81003]).
  • PortInterfaceMappingViolation, wenn der Schnittstellentyp nicht zum erwarteten Schnittstellenmapping passt ([SWS_SM_81003]).
  • ProcessMappingViolation, wenn zur Instanzreferenz kein passender modellierter Prozess existiert ([SWS_SM_81003]).
  • InstanceSpecifierAlreadyInUseViolation, falls der Instanzbezeichner im Prozess bereits verwendet wird ([SWS_SM_81003]).

Schlägt die Registrierung bei Offer() wegen Verbindungsproblemen zum State-Management-Dämon fehl, gibt der Aufruf ein ara::core::Result mit dem Fehler SmErrc::kOfferFailed zurück ([SWS_SM_81012]). Bei Problemen während der Ausführung von EnterSuspendMode() oder LeaveSuspendMode() signalisiert der Satellit über das zurückgegebene Future den Fehler SmErrc::kRejected ([SWS_SM_81010], [SWS_SM_81011]). Dies führt auf Seiten des Hubs beim Verlassen des Suspend-Modus zum Gesamtergebnis kAtLeastOneHadIssuesToLeave ([SWS_SM_00707]).

Dieser Leitfaden basiert ausschließlich auf den Spezifikationsdokumenten des AUTOSAR-Releases R25-11.

Mitgliederkarte

Konstruktoren und Destruktor

2
S2RSatellite~S2RSatellite

Methoden

5
CreateEnterSuspendModeLeaveSuspendModeOfferStopOffer

Operatoren

1
operator=

Klassendiagramm

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()

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

S2RSatellite function 4

Creation of an S2RSatellite.

Überladungen 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
~S2RSatellite function

Destructor for S2RSatellite.

virtual ~S2RSatellite () noexcept;

Methoden

Create function

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

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

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 function

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 function

Enables potential invocations of handlers .

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

Disables invocations of handlers.

void StopOffer () noexcept;

Operatoren

operator= function 2

Move assignment operator for S2RSatellite.

Überladungen = 2
S2RSatellite & operator= (S2RSatellite &&ra) noexcept; SWS_SM_81008
S2RSatellite & operator= (const S2RSatellite &)=delete; SWS_SM_81009

Dokumentation der Methoden

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: ee8ec5327419 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die statische Fabrikmethode ara::sm::s2r::S2RSatellite::Create dient der synchronen Instanziierung eines Satelliten zur direkten Verbindung mit dem S2RHub innerhalb derselben Maschine ([SWS_SM_81014]). Der Aufruf nimmt keine Parameter entgegen und gibt ein ara::core::Result<S2RSatellite> zurück, welches im Erfolgsfall das erzeugte Satelliten-Objekt bereitstellt ([SWS_SM_81014]).

Fehlerbehandlung

Falls in der Konfiguration der Schalter „Force IAM switch“ auf true gesetzt ist, schlägt der Aufruf fehl und liefert den Fehlercode ara::sm::SmErrc::kAuthenticationRequired ([SWS_SM_00716]). In diesem Fall ist stattdessen zwingend der Konstruktor ara::sm::s2r::S2RSatellite::S2RSatellite zu verwenden ([SWS_SM_81014]). Zudem wird eine AraNotInitialized-Violation ausgelöst, falls die ARA-Laufzeitumgebung zum Aufrufzeitpunkt nicht initialisiert ist ([SWS_SM_81014]).

Nebenläufigkeit und Randbedingungen

Die Funktion ist als thread-safe sowie exception-safe spezifiziert und mit noexcept deklariert ([SWS_SM_81014]). Sie kann somit sicher aus nebenläufigen Anwendungskontexten aufgerufen werden.

Zusammenspiel

Instanzen von S2RSatellite werden in S2R-fähigen Anwendungen eingesetzt, um Benachrichtigungen vor und nach dem Suspend-Modus zu verarbeiten (SWS StateManagement §7.5.2 „S2R Satellite“). Nach erfolgreicher Instanziierung registriert sich die Anwendung über Offer am Hub ([SWS_SM_00710]). Vor dem Zerstören des Objekts muss die Deregistrierung mittels StopOffer aufgerufen werden ([SWS_SM_00713]). Interpretation: Die Methode Create dürfte primär für Anwendungsszenarien vorgesehen sein, in denen keine IAM-Authentifizierung für den Satelliten erzwungen wird. Frage Q-fc41980edcb3f61a (offen)

Dieser Nutzungshinweis wurde von einer KI erstellt.

Implementer's Guide folgt (Komplexität 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#cd8a5e9e
Content hash
cd8a5e9e
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

function 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().

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 023b44de9187 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die rein virtuelle Callback-Methode EnterSuspendMode der Klasse ara::sm::s2r::S2RSatellite [SWS_SM_81010] fordert eine Satelliteninstanz zum Eintritt in den Suspend-Modus auf [SWS_SM_00711]. Der Aufruf wird initiiert, wenn der S2R Hub via RequestToEnterSuspendMode alle aktiv registrierten Satelliten anweist, in den Suspend-Zustand zu wechseln [SWS_SM_00701]. Voraussetzung für den Empfang dieses Aufrufs ist, dass die Satelliteninstanz zuvor über Offer erfolgreich am Hub registriert wurde [SWS_SM_81010] [SWS_SM_00710].

Als Rückgabewert dient ara::core::Future<void> [SWS_SM_81010]. Kann die Anwendung den Suspend-Modus erfolgreich einnehmen, wird das Future mit void erfüllt [SWS_SM_81010]. Tritt ein Fehler auf, ist das Future mit dem Fehlercode SmErrc::kRejected abzuschließen [SWS_SM_81010]. Meldet mindestens ein Satellit kRejected, liefert die Hub-Anforderung das Gesamtergebnis kAtLeastOneRejected [SWS_SM_00702]. Antwortet ein Satellit nicht rechtzeitig innerhalb des Timeouts, bricht die Kommunikation mit dem Fehler kCommunicationTimeout ab AUTOSAR_AP_SWS_StateManagement S. 36.

Hinsichtlich der Nebenläufigkeit ist die Schnittstelle als nicht threadsicher (not-threadsafe) und nicht ausnahmesicher (not exception safe) definiert [SWS_SM_81010]. Vor der Zerstörung des Satellitenobjekts muss StopOffer aufgerufen werden; dieser Aufruf deregistriert den Satelliten und blockiert, bis laufende Callback-Ausführungen beendet sind [SWS_SM_00713]. Da die Methode rein virtuell deklariert ist, dürfte die konkrete Implementierung in einer abgeleiteten Anwendungsklasse erfolgen, um lokale Zustände vor dem Suspend-to-RAM zu persistieren. Frage Q-628b88828075652c (offen)

Dieser Text wurde durch ein KI-System auf Basis der Spezifikation AUTOSAR R25-11 generiert.

Implementer's Guide folgt (Komplexität 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#4ccf8b3e
Content hash
4ccf8b3e
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

function 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().

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 4c7954c5f9b4 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die rein virtuelle Methode LeaveSuspendMode dient S2R-fähigen Anwendungen (S2R-Aware applications) dazu, den Suspend-Modus zu verlassen und den regulären Betrieb wiederaufzunehmen [SWS_SM_81011], SWS StateManagement §7.5.2 „S2R Satellite“. Die anwendungsspezifische Wiederaufnahme-Logik dürfte dabei als Interpretation in einer von ara::sm::s2r::S2RSatellite abgeleiteten Klasse implementiert werden. Frage Q-c8e12bf51d76935c (offen)

Verwendung und Aufrufkontext

Der Aufruf erfolgt asynchron und wird durch den Empfang eines Resume-Triggers am Satelliten veranlasst [SWS_SM_00711]. Dieser Trigger geht von ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode aus, welches eine Nachricht an alle aktiv registrierten Satelliten-Instanzen sendet [SWS_SM_00703]. Die Methode erwartet keine Parameter und liefert ein ara::core::Future<void> zurück [SWS_SM_81011]. Im Erfolgsfall wird das Future mit void erfüllt, sobald der Suspend-Modus erfolgreich verlassen wurde [SWS_SM_81011].

Fehlerbehandlung

Treten beim Aufwachen Probleme auf, schlägt das Future mit dem Fehlercode SmErrc::kRejected fehl (Rollback-Semantik) [SWS_SM_81011]. Dies veranlasst den S2R-Hub, als Gesamtergebnis kAtLeastOneHadIssuesToLeave auszugeben [SWS_SM_00707]. Reagiert ein Satellit nicht innerhalb der festgelegten Frist, bricht der Hub mit kCommunicationTimeout ab [SWS_SM_00707].

Nebenläufigkeit und Vorbedingungen

  • Registrierung: Die Handler-Aktivierung setzt voraus, dass zuvor Offer aufgerufen wurde [SWS_SM_81011], womit der Satellit aktiv registriert ist [SWS_SM_00710].
  • Sicherheit: Die Operation ist als not-threadsafe und not exception safe spezifiziert [SWS_SM_81011].
  • Lebenszyklus: Vor der Zerstörung des Satelliten muss StopOffer aufgerufen werden; der Aufruf blockiert, bis laufende Callbacks abgeschlossen sind [SWS_SM_00713].

Dieser Nutzungshinweis wurde automatisiert generiert und basiert ausschließlich auf den Spezifikationsdaten von AUTOSAR Adaptive R25-11.

Implementer's Guide folgt (Komplexität 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#121e27da
Content hash
121e27da
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

function Offer [SWS_SM_81012] Upstream: RS_SM_00402

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

Enables potential invocations of handlers .

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 4698b0d80386 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die synchrone Memberfunktion ara::sm::s2r::S2RSatellite::Offer registriert eine Satelliten-Instanz beim zentralen S2R-Hub [SWS_SM_00710]. Der parameterlose Aufruf aktiviert den Empfang von Benachrichtigungen, sodass anwendungsseitige Callbacks für den Wechsel in den Suspend-Modus sowie das Wiederaufwachen aufgerufen werden können [SWS_SM_81012], [SWS_SM_81010], [SWS_SM_81011]. Die Methode liefert ein ara::core::Result<void> zurück und ist als ausnahmesicher (noexcept) deklariert [SWS_SM_81012].

Im regulären Erfolgsfall ist das zurückgegebene Result leer [SWS_SM_81012]. Kann der Dienst aufgrund einer gestörten Kommunikation mit dem State-Management-Daemon nicht bereitgestellt werden, schlägt der Aufruf mit dem Fehlercode SmErrc::kOfferFailed fehl [SWS_SM_81012]. Zudem muss der Prozesskontext des Satelliten den IAM-Vorgaben für die registrierte Anwendung entsprechen, da unberechtigte Instanzen abgewiesen werden [SWS_SM_00715]. Interpretation: Schlägt die Registrierung fehl, dürfte die Instanz beim Hub unregistriert verbleiben. Frage Q-1b445bcf1aecef2d (offen)

Hinsichtlich der Nebenläufigkeit ist Offer als nicht threadsicher (not thread-safe) spezifiziert [SWS_SM_81012]; parallele Aufrufe auf derselben Instanz bedürfen daher externer Synchronisation. Nach erfolgreichem Angebot bleibt der Satellit solange aktiv registriert, bis die Anwendung explizit ara::sm::s2r::S2RSatellite::StopOffer aufruft [SWS_SM_00710]. Die Deregistrierung über StopOffer muss vor der Zerstörung des Satelliten erfolgen und blockiert, bis laufende Callbacks abgeschlossen sind [SWS_SM_00713].

Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe. Verbindlich sind ausschließlich die Spezifikationen der AUTOSAR.

Implementer's Guide folgt (Komplexität 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#a19ccbb6
Content hash
a19ccbb6
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

function 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#00c86d21
Content hash
00c86d21
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

function 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#5d3b2368
Content hash
5d3b2368
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

function 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#00250293
Content hash
00250293
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

function 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#c1967e7f
Content hash
c1967e7f
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

function StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

void StopOffer () noexcept;

Disables invocations of handlers.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: f065eb564bf8 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung und Semantik

Die Methode StopOffer() deregistriert eine Instanz von ara::sm::s2r::S2RSatellite beim S2R Hub und deaktiviert künftige Callback-Aufrufe ([SWS_SM_81013], [SWS_SM_00710]). Der Aufruf erfolgt synchron und blockiert so lange, bis alle gerade aktiven Callback-Ausführungen vollständig abgeschlossen sind ([SWS_SM_00713]). Die Funktion nimmt keine Parameter entgegen und besitzt keinen Rückgabewert.

Lebenszyklus und Fehlerbehandlung

Die Schnittstelle ist als noexcept deklariert und wirft keine Exceptions; spezifische Fehlercodes existieren nicht ([SWS_SM_81013]). Gemäß Spezifikation ist StopOffer() nicht threadsicher (not thread-safe). Die Anwendung muss sicherstellen, dass StopOffer() entweder explizit vor der Zerstörung des S2RSatellite-Objekts aufgerufen wird oder – Interpretation: vermutlich – innerhalb des Destruktors der kapselnden Benutzerklasse ausgeführt wird (SWS StateManagement §7.5.2 „Deregistration of S2R Satellites at S2R Hub“). Frage Q-79aa369fb23871ed (offen)

Zusammenspiel im Suspend-to-RAM-Ablauf

Befindet sich der S2R Hub in der Ausführung von RequestToEnterSuspendMode oder RequestToLeaveSuspendMode, wartet dieser auf alle adressierten Satelliten. Meldet sich ein Satellit in dieser Phase über StopOffer() ab, wird dies vom Hub wie eine positive Rückmeldung gewertet und verhindert einen Fehlschlag des Zustandswechsels ([SWS_SM_00702], [SWS_SM_00707]).

Dieser Nutzungshinweis wurde automatisiert auf Basis der AUTOSAR-Spezifikation R25-11 erstellt.

Implementer's Guide folgt (Komplexität 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#b565557d
Content hash
b565557d
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

function 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#b5e55d29
Content hash
b5e55d29
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

function 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#f0c4993d
Content hash
f0c4993d
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

function ~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#4b892348
Content hash
4b892348
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