klasse 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"
Scope	namespace ara::sm::s2r

User GuideAI-GEGENEREERD

Ontvangt Suspend-to-RAM-notificaties voor applicaties voor gecoördineerde voorbereiding en hervatting.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: c425edf7dbdd Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Ontvangt Suspend-to-RAM-notificaties voor applicaties voor gecoördineerde voorbereiding en hervatting.

De interface ara::sm::s2r::S2RSatellite dient voor Adaptive Applications als ontvanger voor Suspend-to-RAM-notificaties vanuit het State Management ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”). Na initialisatie en activering via Offer() worden de geïmplementeerde callbackfuncties EnterSuspendMode() en LeaveSuspendMode() aangeroepen om applicatiespecifieke voorbereidingen zoals gegevensback-up of herstarts van services asynchroon aan te sturen ([SWS_SM_00710], [SWS_SM_81010], [SWS_SM_81011]). De registratie bij de centrale hub vereist daarbij dwingend een passend gemodelleerde en IAM-geauthenticeerde procescontext ([SWS_SM_00715]).

Context

De abstracte basisklasse ara::sm::s2r::S2RSatellite definieert de interface voor Adaptive Applications om notificaties voor de overgang naar en vanuit de toestand “prepared for Suspend-to-RAM” te ontvangen ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”). Terwijl de centrale S2RHub binnen het State Management de coördinatie van de suspend-processen aanstuurt (AUTOSAR_AP_SWS_StateManagement §7.5.1 “S2R Hub”), fungeert de instantie van S2RSatellite als lokaal eindpunt in de betreffende applicatie. Een Adaptive Application implementeert de abstracte callbackfuncties om applicatiespecifieke voorbereidingen te treffen, zoals het opslaan van persistente data, het beëindigen van aangeboden services of het stoppen van veiligheidskritieke activiteiten (AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 “Interfaces for Suspend-to-Ram Notifications”).

Contextdiagram: Samenspel tussen Adaptive Application, S2RSatellite, S2RHub en Identity Access Management. Bronnen: [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”.

De registratie en interactie zijn onderworpen aan beveiligingscontroles door het Identity and Access Management (IAM): De S2RHub staat een registratie alleen toe als de procescontext van de satelliet overeenkomt met de geconfigureerde SuspendToRamSatelliteMapping ([SWS_SM_00715]).

Levenscyclus

Het aanmaken van een instantie vindt plaats via de expliciete constructor S2RSatellite(const ara::core::InstanceSpecifier&) ([SWS_SM_81003]) of via de statische factory-methode Create() ([SWS_SM_81014]). De standaardconstructor is verwijderd ([SWS_SM_81004]). De klasse hanteert een strikte semantiek voor eigenaarschap: de copy constructor en copy assignment operator zijn expliciet verwijderd ([SWS_SM_81007], [SWS_SM_81009]), move constructor en move assignment zijn daarentegen toegestaan, uitzonderingsveilig en thread-safe ([SWS_SM_81006], [SWS_SM_81008]).

Na instantiatie bevindt het object zich in de inactieve toestand. Pas door het aanroepen van Offer() registreert de satelliet zich actief bij de hub en worden handler-aanroepen geactiveerd ([SWS_SM_00710], [SWS_SM_81012]). De satelliet blijft actief geregistreerd totdat StopOffer() wordt aangeroepen ([SWS_SM_00710], [SWS_SM_81013]). Bij vernietiging via de virtuele destructor ~S2RSatellite() ([SWS_SM_81005]) moet de instantie vermoedelijk vooraf zijn afgemeld of wordt deze impliciet vrijgegeven. Vraag Q-bbccd3c283007ce8 (open) Terwijl constructors en toewijzingen thread-safe zijn, zijn Offer(), StopOffer(), de destructor en de handlers niet thread-safe ([SWS_SM_81003], [SWS_SM_81005], [SWS_SM_81010], [SWS_SM_81011], [SWS_SM_81012], [SWS_SM_81013]).

Gebruikspad

Het reguliere verloop omvat de gereedstelling, het verwerken van toestandswisselingen en de uiteindelijke deregistratie:

Beschikbaarstelling: De applicatie instantieert haar afgeleide satellietklasse en roept Offer() aan om de communicatiegereedheid met de S2RHub tot stand te brengen ([SWS_SM_00710], [SWS_SM_81012]).
Suspend-verzoek: Wanneer het State Management een suspend-procedure initieert ([SWS_SM_00701]), roept de satelliet de puur virtuele methode EnterSuspendMode() aan ([SWS_SM_00711], [SWS_SM_81010]). De applicatie voert haar back-uproutines uit en signaleert de gereedheid asynchroon via de geretourneerde ara::core::Future<void> ([SWS_SM_81010]).
Resume-verzoek: Na het ontwaken verzoekt de hub het verlaten van de suspend-modus ([SWS_SM_00703]). De satelliet voert de methode LeaveSuspendMode() uit ([SWS_SM_00711], [SWS_SM_81011]), waarna de applicatie services reactiveert.
Beëindiging: Vóór het afsluiten roept de applicatie StopOffer() aan, waardoor de satelliet bij de hub wordt afgemeld en handlers worden gedeactiveerd ([SWS_SM_00713], [SWS_SM_81013]).

Sequentiediagram: Typisch verloop van registratie, Suspend-to-RAM-notificatie, hervatting en deregistratie. Bronnen: [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].

Foutscenario's

Reeds bij de instantiatie kunnen fouten optreden. De statische methode Create() levert de fout ara::sm::SmErrc::kAuthenticationRequired op indien een geforceerde IAM-wissel actief is; in dat geval moet in plaats daarvan de geparametriseerde constructor met InstanceSpecifier worden gebruikt ([SWS_SM_00716], [SWS_SM_81014]). De constructor S2RSatellite(const ara::core::InstanceSpecifier&) controleert modellerings- en platformtoestanden en veroorzaakt bij fouten runtime-schendingen:

AraNotInitializedViolation, wanneer de runtime-omgeving van het platform niet geïnitialiseerd is ([SWS_SM_81003]).
InstanceSpecifierMappingIntegrityViolation, indien de identifier niet kan worden omgezet of niet verwijst naar een PortPrototype ([SWS_SM_81003]).
PortInterfaceMappingViolation, wanneer het interfacetype niet overeenkomt met de verwachte interfacemapping ([SWS_SM_81003]).
ProcessMappingViolation, wanneer er voor de instantieverwijzing geen passend gemodelleerd proces bestaat ([SWS_SM_81003]).
InstanceSpecifierAlreadyInUseViolation, indien de instantie-identifier al in het proces wordt gebruikt ([SWS_SM_81003]).

Als de registratie bij Offer() mislukt wegens verbindingsproblemen met de State Management-daemon, retourneert de aanroep een ara::core::Result met de fout SmErrc::kOfferFailed ([SWS_SM_81012]). Bij problemen tijdens de uitvoering van EnterSuspendMode() of LeaveSuspendMode() signaleert de satelliet via de geretourneerde Future de fout SmErrc::kRejected ([SWS_SM_81010], [SWS_SM_81011]). Dit leidt aan de zijde van de hub bij het verlaten van de suspend-modus tot het totale resultaat kAtLeastOneHadIssuesToLeave ([SWS_SM_00707]).

Deze handleiding is uitsluitend gebaseerd op de specificatiedocumenten van de AUTOSAR-release R25-11.

Ledenkaart

Klassendiagram

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

Detailweergave

Kies een item in de inhoudsopgave.

Geen elementgegevens voor deze release

Constructors en destructor

S2RSatellite functie 4

Creation of an S2RSatellite.

Overloads 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 functie

Destructor for S2RSatellite.

virtual ~S2RSatellite () noexcept;

Methoden

Create functie

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

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

EnterSuspendMode functie

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 functie

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 functie

Enables potential invocations of handlers .

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

StopOffer functie

Disables invocations of handlers.

void StopOffer () noexcept;

Operatoren

operator= functie 2

Move assignment operator for S2RSatellite.

Overloads = 2

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

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

Klik op een item om de relaties te zien.

Documentatie van de methoden

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: ee8ec5327419 Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De statische factory-methode ara::sm::s2r::S2RSatellite::Create dient voor de synchrone instantiëring van een satelliet voor een directe verbinding met de S2RHub binnen dezelfde machine ([SWS_SM_81014]). De aanroep accepteert geen parameters en retourneert een ara::core::Result<S2RSatellite>, die bij succes het gecreëerde satellietobject beschikbaar stelt ([SWS_SM_81014]).

Foutafhandeling

Indien in de configuratie de schakelaar “Force IAM switch” op true is gezet, faalt de aanroep en levert deze de foutcode ara::sm::SmErrc::kAuthenticationRequired op ([SWS_SM_00716]). In dat geval moet in plaats daarvan verplicht de constructor ara::sm::s2r::S2RSatellite::S2RSatellite worden gebruikt ([SWS_SM_81014]). Bovendien wordt een AraNotInitialized-Violation getriggerd indien de ARA-runtime-omgeving op het moment van de aanroep niet is geïnitialiseerd ([SWS_SM_81014]).

Gelijktijdigheid en randvoorwaarden

De functie is gespecificeerd als thread-safe en exception-safe en gedeclareerd met noexcept ([SWS_SM_81014]). Ze kan zodoende veilig worden aangeroepen vanuit concurrente applicatiecontexten.

Samenspel

Instanties van S2RSatellite worden gebruikt in S2R-compatibele applicaties om meldingen vóór en na de suspend-modus te verwerken (SWS StateManagement §7.5.2 “S2R Satellite”). Na succesvolle instantiëring registreert de applicatie zich via Offer bij de hub ([SWS_SM_00710]). Vóór het vernietigen van het object moet de deregistratie via StopOffer worden aangeroepen ([SWS_SM_00713]). Interpretatie: De methode Create zal vermoedelijk primair zijn bedoeld voor toepassingsscenario's waarin geen IAM-authenticatie voor de satelliet wordt afgedwongen. Vraag Q-fc41980edcb3f61a (open)

Deze gebruiksinstructie is opgesteld door een AI.

Implementer's Guide volgt (complexiteit I1)

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-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

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

Fehler

Fehlercode	Beschreibung
ara::sm::SmErrc::kAuthenticationRequired	rollback_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#befb323a
Content hash: befb323a
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 023b44de9187 Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De zuiver virtuele callback-methode EnterSuspendMode van de klasse ara::sm::s2r::S2RSatellite [SWS_SM_81010] verzoekt een satellietinstantie om naar de suspend-modus over te gaan [SWS_SM_00711]. De aanroep wordt geïnitieerd wanneer de S2R Hub via RequestToEnterSuspendMode alle actief geregistreerde satellieten opdraagt over te schakelen naar de suspend-toestand [SWS_SM_00701]. Voorwaarde voor de ontvangst van deze aanroep is dat de satellietinstantie vooraf via Offer succesvol bij de hub is geregistreerd [SWS_SM_81010] [SWS_SM_00710].

Als retourwaarde dient ara::core::Future<void> [SWS_SM_81010]. Als de applicatie de suspend-modus succesvol kan aannemen, wordt de future voldaan met void [SWS_SM_81010]. Doet zich een fout voor, dan moet de future worden afgesloten met de foutcode SmErrc::kRejected [SWS_SM_81010]. Meldt ten minste één satelliet kRejected, dan levert het hub-verzoek als totaalresultaat kAtLeastOneRejected op [SWS_SM_00702]. Reageert een satelliet niet tijdig binnen de time-out, dan breekt de communicatie af met de fout kCommunicationTimeout AUTOSAR_AP_SWS_StateManagement p. 36.

Wat betreft concurrency is de interface gedefinieerd als niet-thread-safe (not-threadsafe) en niet-uitzonderingsveilig (not exception safe) [SWS_SM_81010]. Vóór de vernietiging van het satellietobject moet StopOffer worden aangeroepen; deze aanroep deregistreert de satelliet en blokkeert totdat lopende callback-uitvoeringen zijn beëindigd [SWS_SM_00713]. Omdat de methode zuiver virtueel is gedeclareerd, zal de concrete implementatie vermoedelijk plaatsvinden in een afgeleide applicatieklasse om lokale toestanden voorafgaand aan de Suspend-to-RAM te persisteren. Vraag Q-628b88828075652c (open)

Deze tekst is gegenereerd door een AI-systeem op basis van de specificatie AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	not exception safe
Thread-Sicherheit	not-threadsafe

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
SmErrc::kRejected	rollback_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#4aef6d82
Content hash: 4aef6d82
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 4c7954c5f9b4 Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De zuiver virtuele methode LeaveSuspendMode dient voor S2R-compatibele applicaties (S2R-Aware applications) om de suspend-modus te verlaten en de reguliere werking te hervatten [SWS_SM_81011], SWS StateManagement §7.5.2 “S2R Satellite”. De applicatiespecifieke hervattingslogica zal daarbij vermoedelijk als interpretatie worden geïmplementeerd in een van ara::sm::s2r::S2RSatellite afgeleide klasse. Vraag Q-c8e12bf51d76935c (open)

Gebruik en aanroepcontext

De aanroep vindt asynchroon plaats en wordt veroorzaakt door de ontvangst van een resume-trigger op de satelliet [SWS_SM_00711]. Deze trigger gaat uit van ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode, die een bericht verzendt naar alle actief geregistreerde satellietinstanties [SWS_SM_00703]. De methode verwacht geen parameters en retourneert een ara::core::Future<void> [SWS_SM_81011]. In geval van succes wordt de future voldaan met void zodra de suspend-modus succesvol is verlaten [SWS_SM_81011].

Foutafhandeling

Treden er bij het ontwaken problemen op, dan faalt de future met de foutcode SmErrc::kRejected (rollback-semantiek) [SWS_SM_81011]. Dit brengt de S2R-hub ertoe om als totaalresultaat kAtLeastOneHadIssuesToLeave uit te voeren [SWS_SM_00707]. Reageert een satelliet niet binnen de vastgestelde termijn, dan breekt de hub af met kCommunicationTimeout [SWS_SM_00707].

Gelijktijdigheid en randvoorwaarden

Registratie: De activering van de handler vereist dat vooraf Offer is aangeroepen [SWS_SM_81011], waarmee de satelliet actief geregistreerd is [SWS_SM_00710].
Veiligheid: De operatie is gespecificeerd als not-threadsafe en not exception safe [SWS_SM_81011].
Levenscyclus: Vóór de vernietiging van de satelliet moet StopOffer worden aangeroepen; de aanroep blokkeert totdat lopende callbacks zijn voltooid [SWS_SM_00713].

Deze gebruiksinstructie is automatisch gegenereerd en is uitsluitend gebaseerd op de specificatiegegevens van AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	not exception safe
Thread-Sicherheit	not-threadsafe

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
SmErrc::kRejected	rollback_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#cc92cd92
Content hash: cc92cd92
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie Offer [SWS_SM_81012] Upstream: RS_SM_00402

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

Enables potential invocations of handlers .

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 4698b0d80386 Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De synchrone lidfunctie ara::sm::s2r::S2RSatellite::Offer registreert een satellietinstantie bij de centrale S2R-hub [SWS_SM_00710]. De parameterloze aanroep activeert de ontvangst van meldingen, zodat applicatie-callbacks voor het overschakelen naar de suspend-modus evenals het opnieuw ontwaken kunnen worden aangeroepen [SWS_SM_81012], [SWS_SM_81010], [SWS_SM_81011]. De methode levert een ara::core::Result<void> op en is gedeclareerd als uitzonderingsveilig (noexcept) [SWS_SM_81012].

In het reguliere geval van succes is de geretourneerde Result leeg [SWS_SM_81012]. Indien de service wegens een verstoorde communicatie met de State Management-daemon niet kan worden geleverd, faalt de aanroep met de foutcode SmErrc::kOfferFailed [SWS_SM_81012]. Bovendien moet de procescontext van de satelliet voldoen aan de IAM-vereisten voor de geregistreerde applicatie, aangezien onbevoegde instanties worden afgewezen [SWS_SM_00715]. Interpretatie: Als de registratie mislukt, zal de instantie vermoedelijk ongeregistreerd blijven bij de hub. Vraag Q-1b445bcf1aecef2d (open)

Wat betreft concurrente uitvoering is Offer gespecificeerd als niet-thread-safe (not thread-safe) [SWS_SM_81012]; parallelle aanroepen op dezelfde instantie vereisen daarom externe synchronisatie. Na een succesvolle aanbieding blijft de satelliet actief geregistreerd totdat de applicatie expliciet ara::sm::s2r::S2RSatellite::StopOffer aanroept [SWS_SM_00710]. De deregistratie via StopOffer moet plaatsvinden vóór de vernietiging van de satelliet en blokkeert totdat actieve callbacks zijn voltooid [SWS_SM_00713].

Deze tekst is gegenereerd door een AI en dient als leidraad. Uitsluitend de specificaties van AUTOSAR zijn bindend.

Implementer's Guide volgt (complexiteit I1)

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
SmErrc::kOfferFailed	rollback_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#2f774a4d
Content hash: 2f774a4d
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie 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"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-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)

Parameter	Beschreibung
instance	instance 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#27466dcc
Content hash: 27466dcc
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie 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"
Scope	class 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#14f129ae
Content hash: 14f129ae
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie S2RSatellite [SWS_SM_81006] Upstream: RS_SM_00402

S2RSatellite (S2RSatellite &&ra) noexcept;

Move constructor for S2RSatellite.

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
ra	The 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#00a0c6e0
Content hash: 00a0c6e0
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie 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"
Scope	class 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#1e467a0e
Content hash: 1e467a0e
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

void StopOffer () noexcept;

Disables invocations of handlers.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: f065eb564bf8 Herkomst Open vragen (1)

vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik en semantiek

De methode StopOffer() deregistreert een instantie van ara::sm::s2r::S2RSatellite bij de S2R Hub en deactiveert toekomstige callback-aanroepen ([SWS_SM_81013], [SWS_SM_00710]). De aanroep geschiedt synchroon en blokkeert totdat alle momenteel actieve callback-uitvoeringen volledig zijn afgerond ([SWS_SM_00713]). De functie accepteert geen parameters en heeft geen retourwaarde.

Levenscyclus en foutafhandeling

De interface is gedeclareerd als noexcept en werpt geen exceptions; er bestaan geen specifieke foutcodes ([SWS_SM_81013]). Volgens de specificatie is StopOffer() niet-thread-safe (not thread-safe). De applicatie moet ervoor zorgen dat StopOffer() hetzij expliciet vóór de vernietiging van het S2RSatellite-object wordt aangeroepen, hetzij – interpretatie: vermoedelijk – binnen de destructor van de inkapselende gebruikersklasse wordt uitgevoerd (SWS StateManagement §7.5.2 “Deregistration of S2R Satellites at S2R Hub”). Vraag Q-79aa369fb23871ed (open)

Interactie in het Suspend-to-RAM-proces

Wanneer de S2R Hub zich in de uitvoering van RequestToEnterSuspendMode of RequestToLeaveSuspendMode bevindt, wacht deze op alle geadresseerde satellieten. Meldt een satelliet zich in deze fase af via StopOffer(), dan wordt dit door de hub als een positieve terugkoppeling beschouwd en voorkomt dit een mislukking van de toestandsverandering ([SWS_SM_00702], [SWS_SM_00707]).

Deze gebruiksinstructie is geautomatiseerd opgesteld op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
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#40c45fe3
Content hash: 40c45fe3
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie 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"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
ra	The S2RSatellite object to be moved.

Rückgabewert

Typ	Beschreibung
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#f6ed2dc7
Content hash: f6ed2dc7
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie 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"
Scope	class 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#f425d7d4
Content hash: f425d7d4
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

functie ~S2RSatellite [SWS_SM_81005] Upstream: RS_SM_00402

virtual ~S2RSatellite () noexcept;

Destructor for S2RSatellite.

Header-Datei	#include "ara/sm/s2r/S2RSatellite.h"
Scope	class ara::sm::s2r::S2RSatellite
Exception-Sicherheit	exception safe
Thread-Sicherheit	not 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#bda5a31a
Content hash: bda5a31a
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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

klasse ara::sm::s2r::S2RSatellite

User GuideAI-GEGENEREERD

Context

Levenscyclus

Gebruikspad

Foutscenario's

Ledenkaart

Constructors en destructor

Methoden

Operatoren

Klassendiagram

Detailweergave

Constructors en destructor

Methoden

Operatoren

Documentatie van de methoden

functie Create [SWS_SM_81014] Upstream: RS_SM_00402

Gebruik

Foutafhandeling

Gelijktijdigheid en randvoorwaarden

Samenspel

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie EnterSuspendMode [SWS_SM_81010] Upstream: RS_SM_00402

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie LeaveSuspendMode [SWS_SM_81011] Upstream: RS_SM_00402

Gebruik en aanroepcontext

Foutafhandeling

Gelijktijdigheid en randvoorwaarden

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie Offer [SWS_SM_81012] Upstream: RS_SM_00402

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie S2RSatellite [SWS_SM_81003] Upstream: RS_SM_00402

Parameter (in)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie S2RSatellite [SWS_SM_81004] Upstream: RS_SM_00402

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie S2RSatellite [SWS_SM_81006] Upstream: RS_SM_00402

Parameter (in)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie S2RSatellite [SWS_SM_81007] Upstream: RS_SM_00402

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

Gebruik en semantiek

Levenscyclus en foutafhandeling

Interactie in het Suspend-to-RAM-proces

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie operator= [SWS_SM_81008] Upstream: RS_SM_00402

Parameter (in)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

functie operator= [SWS_SM_81009] Upstream: RS_SM_00402