DEENESPTFRRUARHIKOZHNL

classe 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

Guide utilisateurGÉNÉRÉ PAR IA

Reçoit des notifications Suspend-to-RAM pour les applications en vue d'une préparation et d'une reprise coordonnées.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : c425edf7dbdd Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Reçoit des notifications Suspend-to-RAM pour les applications en vue d'une préparation et d'une reprise coordonnées.

L'interface ara::sm::s2r::S2RSatellite sert de récepteur aux Adaptive Applications pour les notifications Suspend-to-RAM issues du State Management ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 « Interfaces for Suspend-to-Ram Notifications »). Après l'initialisation et l'activation via Offer(), les fonctions de rappel implémentées EnterSuspendMode() et LeaveSuspendMode() sont appelées afin de piloter de manière asynchrone des préparatifs spécifiques à l'application tels que la sauvegarde de données ou le redémarrage de services ([SWS_SM_00710], [SWS_SM_81010], [SWS_SM_81011]). L'enregistrement auprès du hub central requiert impérativement un contexte de processus correctement modélisé et authentifié par l'IAM ([SWS_SM_00715]).

Contexte

La classe de base abstraite ara::sm::s2r::S2RSatellite définit l'interface permettant aux Adaptive Applications de recevoir des notifications pour la transition vers et depuis l'état « prepared for Suspend-to-RAM » ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 « Interfaces for Suspend-to-Ram Notifications »). Alors que le S2RHub central pilote la coordination des séquences de mise en veille au sein du State Management (AUTOSAR_AP_SWS_StateManagement §7.5.1 « S2R Hub »), l'instance de S2RSatellite agit en tant que point de terminaison local dans l'application respective. Une Adaptive Application implémente les fonctions de rappel abstraites afin d'effectuer des préparatifs spécifiques à l'application tels que la sauvegarde de données persistantes, l'arrêt des services proposés ou l'interruption d'activités critiques pour la sécurité (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 vérifie le contexte de processus [SWS_SM_00715]

Diagramme de contexte : interaction entre Adaptive Application, S2RSatellite, S2RHub et Identity Access Management. Sources : [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 ».

L'enregistrement et l'interaction sont soumis à des contrôles de sécurité par l'Identity and Access Management (IAM) : le S2RHub n'autorise un enregistrement que si le contexte de processus du satellite correspond au SuspendToRamSatelliteMapping configuré ([SWS_SM_00715]).

Cycle de vie

La création d'une instance s'effectue via le constructeur explicite S2RSatellite(const ara::core::InstanceSpecifier&) ([SWS_SM_81003]) ou via la méthode de fabrique statique Create() ([SWS_SM_81014]). Le constructeur par défaut est supprimé ([SWS_SM_81004]). La classe possède une sémantique de propriété stricte : le constructeur de copie et l'opérateur d'affectation par copie sont explicitement supprimés ([SWS_SM_81007], [SWS_SM_81009]), tandis que le constructeur de déplacement et l'affectation par déplacement sont autorisés, sûrs vis-à-vis des exceptions et sûrs vis-à-vis des threads ([SWS_SM_81006], [SWS_SM_81008]).

Après l'instanciation, l'objet se trouve à l'état inactif. Ce n'est que par l'appel de Offer() que le satellite s'enregistre activement auprès du hub et active les appels de gestionnaires ([SWS_SM_00710], [SWS_SM_81012]). Le satellite reste activement enregistré jusqu'à ce que StopOffer() soit appelé ([SWS_SM_00710], [SWS_SM_81013]). Lors de la destruction via le destructeur virtuel ~S2RSatellite() ([SWS_SM_81005]), l'instance doit probablement avoir été désenregistrée au préalable, ou bien elle est libérée implicitement. Question Q-bbccd3c283007ce8 (ouverte) Alors que les constructeurs et les affectations sont sûrs vis-à-vis des threads, Offer(), StopOffer(), le destructeur ainsi que les gestionnaires ne sont pas sûrs vis-à-vis des threads ([SWS_SM_81003], [SWS_SM_81005], [SWS_SM_81010], [SWS_SM_81011], [SWS_SM_81012], [SWS_SM_81013]).

Parcours d'utilisation

Le déroulement standard comprend la mise à disposition, le traitement des changements d'état et le désenregistrement final :

  1. Mise à disposition : l'application instancie sa classe satellite dérivée et appelle Offer() afin d'établir la disponibilité opérationnelle de communication avec le S2RHub ([SWS_SM_00710], [SWS_SM_81012]).
  2. Demande de mise en veille (suspend) : si le State Management déclenche une opération de mise en veille ([SWS_SM_00701]), le satellite appelle la méthode virtuelle pure EnterSuspendMode() ([SWS_SM_00711], [SWS_SM_81010]). L'application exécute ses routines de sauvegarde et signale de manière asynchrone sa disponibilité via le ara::core::Future<void> renvoyé ([SWS_SM_81010]).
  3. Demande de reprise (resume) : après le réveil, le hub demande la sortie du mode suspend ([SWS_SM_00703]). Le satellite exécute la méthode LeaveSuspendMode() ([SWS_SM_00711], [SWS_SM_81011]), à la suite de quoi l'application réactive les services.
  4. Arrêt : avant l'arrêt complet, l'application appelle StopOffer(), ce qui désenregistre le satellite auprès du hub et désactive les gestionnaires ([SWS_SM_00713], [SWS_SM_81013]).
Nutzungsablauf S2RSatelliteAdaptive ApplicationS2RSatelliteS2RHubUse Case: Initialisation et enregistrementOffer()RegistrierungBestaetigungResult<void> (Erfolg)Use Case: Suspend-PhaseRequestToEnterSuspendModeEnterSuspendMode()Persistieren, Dienste stoppenFuture<void> aufgeloestAntwort bereitUse Case: Resume-PhaseRequestToLeaveSuspendModeLeaveSuspendMode()Dienste reaktivierenFuture<void> aufgeloestAntwort bereitUse Case: DeregistrierungStopOffer()Deregistrierung

Diagramme de séquence : déroulement typique de l'enregistrement, de la notification Suspend-to-RAM, de la reprise et du désenregistrement. Sources : [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].

Scénarios d'erreur

Des erreurs peuvent survenir dès l'instanciation. La méthode statique Create() renvoie l'erreur ara::sm::SmErrc::kAuthenticationRequired si un changement IAM forcé est actif ; dans ce cas, le constructeur paramétré avec InstanceSpecifier doit être utilisé à la place ([SWS_SM_00716], [SWS_SM_81014]). Le constructeur S2RSatellite(const ara::core::InstanceSpecifier&) vérifie les états de modélisation et de plateforme et déclenche des violations à l'exécution en cas d'erreur :

  • AraNotInitializedViolation si l'environnement d'exécution de la plateforme n'est pas initialisé ([SWS_SM_81003]).
  • InstanceSpecifierMappingIntegrityViolation si l'identifiant ne peut pas être résolu ou ne référence pas un PortPrototype ([SWS_SM_81003]).
  • PortInterfaceMappingViolation si le type d'interface ne correspond pas au mappage d'interface attendu ([SWS_SM_81003]).
  • ProcessMappingViolation si aucun processus modélisé correspondant n'existe pour la référence d'instance ([SWS_SM_81003]).
  • InstanceSpecifierAlreadyInUseViolation si l'identifiant d'instance est déjà utilisé dans le processus ([SWS_SM_81003]).

Si l'enregistrement auprès de Offer() échoue en raison de problèmes de connexion avec le démon du State Management, l'appel renvoie un ara::core::Result contenant l'erreur SmErrc::kOfferFailed ([SWS_SM_81012]). En cas de problèmes pendant l'exécution de EnterSuspendMode() ou LeaveSuspendMode(), le satellite signale l'erreur SmErrc::kRejected via le Future renvoyé ([SWS_SM_81010], [SWS_SM_81011]). Du côté du hub, cela conduit au résultat global kAtLeastOneHadIssuesToLeave lors de la sortie du mode suspend ([SWS_SM_00707]).

Ce guide est basé exclusivement sur les documents de spécification de la version AUTOSAR R25-11.

Carte des membres

Constructeurs et destructeur

2
S2RSatellite~S2RSatellite

Méthodes

5
CreateEnterSuspendModeLeaveSuspendModeOfferStopOffer

Opérateurs

1
operator=

Diagramme de classes

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

Vue détaillée

Sélectionnez une entrée dans le plan.

Constructeurs et destructeur

S2RSatellite fonction 4

Creation of an S2RSatellite.

Surcharges 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 fonction

Destructor for S2RSatellite.

virtual ~S2RSatellite () noexcept;

Méthodes

Create fonction

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

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

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 fonction

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 fonction

Enables potential invocations of handlers .

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

Disables invocations of handlers.

void StopOffer () noexcept;

Opérateurs

operator= fonction 2

Move assignment operator for S2RSatellite.

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

Documentation des méthodes

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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : ee8ec5327419 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation

La méthode de fabrique statique ara::sm::s2r::S2RSatellite::Create sert à l'instanciation synchrone d'un satellite pour la liaison directe avec le S2RHub au sein de la même machine ([SWS_SM_81014]). L'appel ne prend aucun paramètre et renvoie un ara::core::Result<S2RSatellite> qui, en cas de succès, fournit l'objet satellite créé ([SWS_SM_81014]).

Gestion des erreurs

Si, dans la configuration, le commutateur « Force IAM switch » est défini sur true, l'appel échoue et renvoie le code d'erreur ara::sm::SmErrc::kAuthenticationRequired ([SWS_SM_00716]). Dans ce cas, il est impératif d'utiliser à la place le constructeur ara::sm::s2r::S2RSatellite::S2RSatellite ([SWS_SM_81014]). De plus, une AraNotInitialized-Violation est déclenchée si l'environnement d'exécution ARA n'est pas initialisé au moment de l'appel ([SWS_SM_81014]).

Concurrence et contraintes

La fonction est spécifiée comme thread-safe ainsi qu'exception-safe et déclarée avec noexcept ([SWS_SM_81014]). Elle peut donc être appelée en toute sécurité depuis des contextes applicatifs concurrents.

Interaction

Les instances de S2RSatellite sont utilisées dans des applications compatibles S2R pour traiter les notifications avant et après le mode suspendu (SWS StateManagement §7.5.2 « S2R Satellite »). Après une instanciation réussie, l'application s'enregistre auprès du concentrateur via Offer ([SWS_SM_00710]). Avant de détruire l'objet, le désenregistrement doit être appelé au moyen de StopOffer ([SWS_SM_00713]). Interprétation : la méthode Create devrait principalement être prévue pour des scénarios d'application dans lesquels aucune authentification IAM n'est imposée pour le satellite. Question Q-fc41980edcb3f61a (ouverte)

Cette note d’utilisation a été créée par une IA.

Guide de l'implémenteur à venir (complexité 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#6117b65c
Content hash
6117b65c
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

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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 023b44de9187 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La méthode de callback virtuelle pure EnterSuspendMode de la classe ara::sm::s2r::S2RSatellite [SWS_SM_81010] invite une instance satellite à entrer dans le mode suspend [SWS_SM_00711]. L'appel est initié lorsque le S2R Hub ordonne via RequestToEnterSuspendMode à tous les satellites activement enregistrés de passer à l'état suspend [SWS_SM_00701]. La condition préalable à la réception de cet appel est que l'instance satellite ait été préalablement enregistrée avec succès auprès du hub via Offer [SWS_SM_81010] [SWS_SM_00710].

ara::core::Future<void> sert de valeur de retour [SWS_SM_81010]. Si l'application peut entrer avec succès dans le mode suspend, le future est complété avec void [SWS_SM_81010]. Si une erreur survient, le future doit être complété avec le code d'erreur SmErrc::kRejected [SWS_SM_81010]. Si au moins un satellite signale kRejected, la requête du hub fournit le résultat global kAtLeastOneRejected [SWS_SM_00702]. Si un satellite ne répond pas à temps dans le délai d'expiration imparti, la communication s'interrompt avec l'erreur kCommunicationTimeout AUTOSAR_AP_SWS_StateManagement p. 36.

Concernant la concurrence, l'interface est définie comme non thread-safe (not-threadsafe) et non sûre vis-à-vis des exceptions (not exception safe) [SWS_SM_81010]. Avant la destruction de l'objet satellite, StopOffer doit être appelé ; cet appel désenregistre le satellite et bloque jusqu'à ce que les exécutions de callback en cours soient terminées [SWS_SM_00713]. La méthode étant déclarée virtuelle pure, l'implémentation concrète devrait être effectuée dans une classe d'application dérivée afin de persister les états locaux avant le Suspend-to-RAM. Question Q-628b88828075652c (ouverte)

Ce texte a été généré par un système d'IA sur la base de la spécification AUTOSAR R25-11.

Guide de l'implémenteur à venir (complexité 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#99c3a2e8
Content hash
99c3a2e8
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

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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 4c7954c5f9b4 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La méthode virtuelle pure LeaveSuspendMode sert aux applications compatibles S2R (S2R-Aware applications) à quitter le mode suspend et à reprendre le fonctionnement régulier [SWS_SM_81011], SWS StateManagement §7.5.2 « S2R Satellite ». La logique de reprise spécifique à l'application devrait, selon toute interprétation, être implémentée dans une classe dérivée de ara::sm::s2r::S2RSatellite. Question Q-c8e12bf51d76935c (ouverte)

Utilisation et contexte d'appel

L'appel a lieu de manière asynchrone et est provoqué par la réception d'un déclencheur de reprise sur le satellite [SWS_SM_00711]. Ce déclencheur provient de ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode, qui envoie un message à toutes les instances satellites activement enregistrées [SWS_SM_00703]. La méthode n'attend aucun paramètre et renvoie un ara::core::Future<void> [SWS_SM_81011]. En cas de succès, le future est complété avec void dès que le mode suspend a été quitté avec succès [SWS_SM_81011].

Gestion des erreurs

Si des problèmes surviennent lors du réveil, le future échoue avec le code d'erreur SmErrc::kRejected (sémantique de rollback) [SWS_SM_81011]. Cela conduit le hub S2R à retourner kAtLeastOneHadIssuesToLeave comme résultat global [SWS_SM_00707]. Si un satellite ne réagit pas dans le délai imparti, le hub s'interrompt avec kCommunicationTimeout [SWS_SM_00707].

Concurrence et préconditions

  • Enregistrement : l'activation du gestionnaire requiert que Offer ait été préalablement appelé [SWS_SM_81011], assurant ainsi que le satellite est activement enregistré [SWS_SM_00710].
  • Sécurité : l'opération est spécifiée comme not-threadsafe et not exception safe [SWS_SM_81011].
  • Cycle de vie : avant la destruction du satellite, StopOffer doit être appelé ; l'appel bloque jusqu'à ce que les callbacks en cours soient achevés [SWS_SM_00713].

Cette note d'utilisation a été générée automatiquement et repose exclusivement sur les données de spécification d'AUTOSAR Adaptive R25-11.

Guide de l'implémenteur à venir (complexité 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#5b3968eb
Content hash
5b3968eb
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

fonction Offer [SWS_SM_81012] Upstream: RS_SM_00402

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

Enables potential invocations of handlers .

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 4698b0d80386 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La fonction membre synchrone ara::sm::s2r::S2RSatellite::Offer enregistre une instance de satellite auprès du concentrateur S2R central [SWS_SM_00710]. L'appel sans paramètre active la réception des notifications, de sorte que les rappels côté application pour le passage en mode suspendu ainsi que le réveil puissent être appelés [SWS_SM_81012], [SWS_SM_81010], [SWS_SM_81011]. La méthode renvoie un ara::core::Result<void> et est déclarée comme sûre vis-à-vis des exceptions (noexcept) [SWS_SM_81012].

En cas de succès nominal, le Result renvoyé est vide [SWS_SM_81012]. Si le service ne peut pas être fourni en raison d'une communication défaillante avec le démon de State Management, l'appel échoue avec le code d'erreur SmErrc::kOfferFailed [SWS_SM_81012]. De plus, le contexte de processus du satellite doit satisfaire aux exigences IAM pour l'application enregistrée, car les instances non autorisées sont rejetées [SWS_SM_00715]. Interprétation : si l'enregistrement échoue, l'instance devrait demeurer non enregistrée auprès du concentrateur. Question Q-1b445bcf1aecef2d (ouverte)

En ce qui concerne la concurrence, Offer est spécifiée comme non thread-safe (not thread-safe) [SWS_SM_81012] ; des appels parallèles sur la même instance requièrent par conséquent une synchronisation externe. Après une mise à disposition réussie, le satellite reste activement enregistré jusqu'à ce que l'application appelle explicitement ara::sm::s2r::S2RSatellite::StopOffer [SWS_SM_00710]. Le désenregistrement via StopOffer doit avoir lieu avant la destruction du satellite et bloque jusqu'à ce que les rappels en cours soient terminés [SWS_SM_00713].

Ce texte a été généré par une IA et sert de guide d'orientation. Seules les spécifications d'AUTOSAR font foi.

Guide de l'implémenteur à venir (complexité 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#8cc3182c
Content hash
8cc3182c
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

fonction 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#567aa2a9
Content hash
567aa2a9
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

fonction 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#fee02da4
Content hash
fee02da4
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

fonction 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#d2fb61db
Content hash
d2fb61db
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

fonction 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#55eb0385
Content hash
55eb0385
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

fonction StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

void StopOffer () noexcept;

Disables invocations of handlers.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : f065eb564bf8 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation et sémantique

La méthode StopOffer() désenregistre une instance de ara::sm::s2r::S2RSatellite auprès de S2R Hub et désactive les futurs appels de rappels ([SWS_SM_81013], [SWS_SM_00710]). L'appel s'effectue de manière synchrone et bloque jusqu'à ce que toutes les exécutions de rappels en cours soient entièrement achevées ([SWS_SM_00713]). La fonction ne prend aucun paramètre et ne possède aucune valeur de retour.

Cycle de vie et gestion des erreurs

L'interface est déclarée comme noexcept et ne lève aucune exception ; aucun code d'erreur spécifique n'existe ([SWS_SM_81013]). Conformément à la spécification, StopOffer() n'est pas thread-safe (not thread-safe). L'application doit s'assurer que StopOffer() soit soit explicitement appelée avant la destruction de l'objet S2RSatellite, soit – Interprétation : vraisemblablement – exécutée à l'intérieur du destructeur de la classe utilisateur encapsulante (SWS StateManagement §7.5.2 « Deregistration of S2R Satellites at S2R Hub »). Question Q-79aa369fb23871ed (ouverte)

Interaction dans le déroulement du Suspend-to-RAM

Si le S2R Hub se trouve dans l'exécution de RequestToEnterSuspendMode ou RequestToLeaveSuspendMode, il attend tous les satellites ciblés. Si un satellite se désenregistre pendant cette phase via StopOffer(), cela est interprété par le concentrateur comme une réponse positive et empêche l'échec de la transition d'état ([SWS_SM_00702], [SWS_SM_00707]).

Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification AUTOSAR R25-11.

Guide de l'implémenteur à venir (complexité 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#4f255c6e
Content hash
4f255c6e
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

fonction 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#f071bb8a
Content hash
f071bb8a
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

fonction 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#4f799964
Content hash
4f799964
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

fonction ~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#bb5b704c
Content hash
bb5b704c
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