класс 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

Руководство пользователяСОЗДАНО ИИ

Принимает уведомления Suspend-to-RAM для приложений с целью скоординированной подготовки и возобновления работы.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: c425edf7dbdd Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Принимает уведомления Suspend-to-RAM для приложений с целью скоординированной подготовки и возобновления работы.

Интерфейс ara::sm::s2r::S2RSatellite служит для Adaptive Applications получателем уведомлений Suspend-to-RAM от State Management ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»). После инициализации и активации через Offer() вызываются реализованные функции обратного вызова EnterSuspendMode() и LeaveSuspendMode() для асинхронного управления специфичными для приложения подготовительными действиями, такими как сохранение данных или перезапуск служб ([SWS_SM_00710], [SWS_SM_81010], [SWS_SM_81011]). Регистрация на центральном хабе при этом обязательно предполагает наличие надлежащим образом смоделированного и аутентифицированного IAM контекста процесса ([SWS_SM_00715]).

Контекст

Абстрактный базовый класс ara::sm::s2r::S2RSatellite определяет интерфейс для Adaptive Applications для приёма уведомлений о переходе в состояние «prepared for Suspend-to-RAM» и из него ([SWS_SM_81002], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»). В то время как центральный S2RHub внутри State Management управляет координацией процессов приостановки (AUTOSAR_AP_SWS_StateManagement §7.5.1 «S2R Hub»), экземпляр S2RSatellite действует как локальная конечная точка в соответствующем приложении. Adaptive Application реализует абстрактные функции обратного вызова для выполнения специфичных для приложения подготовительных действий, таких как сохранение персистентных данных, прекращение предоставления сервисов или остановка критически важных для безопасности активностей (AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»).

Контекстная диаграмма: взаимодействие между Adaptive Application, S2RSatellite, S2RHub и Identity Access Management. Источники: [SWS_SM_00710], [SWS_SM_00715], AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications», AUTOSAR_AP_SWS_StateManagement §7.5.1 «S2R Hub».

Регистрация и взаимодействие подлежат проверкам безопасности со стороны Identity and Access Management (IAM): S2RHub разрешает регистрацию только в том случае, если контекст процесса сателлита совпадает со сконфигурированным SuspendToRamSatelliteMapping ([SWS_SM_00715]).

Жизненный цикл

Создание экземпляра осуществляется через явный конструктор S2RSatellite(const ara::core::InstanceSpecifier&) ([SWS_SM_81003]) или через статический фабричный метод Create() ([SWS_SM_81014]). Конструктор по умолчанию удалён ([SWS_SM_81004]). Класс обладает строгой семантикой владения: конструктор копирования и оператор присваивания копированием явно удалены ([SWS_SM_81007], [SWS_SM_81009]), тогда как конструктор перемещения и присваивание перемещением разрешены, безопасны к исключениям и потокобезопасны ([SWS_SM_81006], [SWS_SM_81008]).

После инстанцирования объект находится в неактивном состоянии. Только после вызова Offer() сателлит активно регистрируется в хабе и активирует вызовы обработчиков ([SWS_SM_00710], [SWS_SM_81012]). Сателлит остаётся активно зарегистрированным до тех пор, пока не будет вызван StopOffer() ([SWS_SM_00710], [SWS_SM_81013]). При уничтожении через виртуальный деструктор ~S2RSatellite() ([SWS_SM_81005]) регистрация экземпляра, вероятно, должна быть предварительно отменена, либо он освобождается неявно. Вопрос Q-bbccd3c283007ce8 (открытый) В то время как конструкторы и присваивания потокобезопасны, Offer(), StopOffer(), деструктор, а также обработчики не являются потокобезопасными ([SWS_SM_81003], [SWS_SM_81005], [SWS_SM_81010], [SWS_SM_81011], [SWS_SM_81012], [SWS_SM_81013]).

Путь использования

Регулярный процесс включает предоставление, обработку смены состояний и заключительную отмену регистрации:

Предоставление: приложение создаёт экземпляр своего производного класса сателлита и вызывает Offer() для установления готовности к коммуникации с S2RHub ([SWS_SM_00710], [SWS_SM_81012]).
Запрос на приостановку: если State Management инициирует процесс приостановки ([SWS_SM_00701]), сателлит вызывает чисто виртуальный метод EnterSuspendMode() ([SWS_SM_00711], [SWS_SM_81010]). Приложение выполняет свои подпрограммы сохранения и асинхронно сигнализирует о готовности через возвращённый ara::core::Future<void> ([SWS_SM_81010]).
Запрос на возобновление: после пробуждения хаб запрашивает выход из режима приостановки ([SWS_SM_00703]). Сателлит выполняет метод LeaveSuspendMode() ([SWS_SM_00711], [SWS_SM_81011]), после чего приложение повторно активирует сервисы.
Завершение: перед завершением работы приложение вызывает StopOffer(), в результате чего сателлит снимается с регистрации в хабе и обработчики деактивируются ([SWS_SM_00713], [SWS_SM_81013]).

Диаграмма последовательности: типичный процесс регистрации, уведомления Suspend-to-RAM, возобновления и отмены регистрации. Источники: [SWS_SM_00701], [SWS_SM_00703], [SWS_SM_00710], [SWS_SM_00711], [SWS_SM_00713], [SWS_SM_81010], [SWS_SM_81011], [SWS_SM_81012], [SWS_SM_81013].

Сценарии ошибок

Ошибки могут возникать уже при инстанцировании. Статический метод Create() возвращает ошибку ara::sm::SmErrc::kAuthenticationRequired, если активна принудительная смена IAM; в этом случае вместо него необходимо использовать параметризованный конструктор с InstanceSpecifier ([SWS_SM_00716], [SWS_SM_81014]). Конструктор S2RSatellite(const ara::core::InstanceSpecifier&) проверяет состояния моделирования и платформы и при ошибках вызывает нарушения времени выполнения:

AraNotInitializedViolation, если среда выполнения платформы не инициализирована ([SWS_SM_81003]).
InstanceSpecifierMappingIntegrityViolation, если идентификатор не может быть разрешён или не ссылается на PortPrototype ([SWS_SM_81003]).
PortInterfaceMappingViolation, если тип интерфейса не соответствует ожидаемому сопоставлению интерфейсов ([SWS_SM_81003]).
ProcessMappingViolation, если для ссылки на экземпляр не существует подходящего смоделированного процесса ([SWS_SM_81003]).
InstanceSpecifierAlreadyInUseViolation, если идентификатор экземпляра уже используется в процессе ([SWS_SM_81003]).

Если регистрация при Offer() завершается сбоем из-за проблем со связью с демоном State Management, вызов возвращает ara::core::Result с ошибкой SmErrc::kOfferFailed ([SWS_SM_81012]). При возникновении проблем во время выполнения EnterSuspendMode() или LeaveSuspendMode() сателлит через возвращённый Future сигнализирует об ошибке SmErrc::kRejected ([SWS_SM_81010], [SWS_SM_81011]). Это приводит на стороне хаба при выходе из режима приостановки к общему результату kAtLeastOneHadIssuesToLeave ([SWS_SM_00707]).

Настоящее руководство основано исключительно на документах спецификации релиза AUTOSAR R25-11.

Карта членов

Диаграмма классов

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

Подробный вид

Выберите элемент в оглавлении.

Для этого релиза нет данных об элементах

Конструкторы и деструктор

S2RSatellite функция 4

Creation of an S2RSatellite.

Перегрузки S2RSatellite 4

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

S2RSatellite ()=delete; SWS_SM_81004

S2RSatellite (S2RSatellite &&ra) noexcept; SWS_SM_81006

S2RSatellite (const S2RSatellite &)=delete; SWS_SM_81007

~S2RSatellite функция

Destructor for S2RSatellite.

virtual ~S2RSatellite () noexcept;

Методы

Create функция

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

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

EnterSuspendMode функция

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 функция

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

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

Offer функция

Enables potential invocations of handlers .

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

StopOffer функция

Disables invocations of handlers.

void StopOffer () noexcept;

Операторы

operator= функция 2

Move assignment operator for S2RSatellite.

Перегрузки = 2

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

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

Нажмите на элемент, чтобы увидеть его связи.

Базовый классПроизводныеИспользуетИспользуется вНаследованиеудалено начиная сВстречается вНет связей внутри этого классаФункцииКомментарий ИИОткрыть страницу классаНе удалось загрузить страницу класса.Изменить порядокИзменить ширинуИзменить ширину структурыРазделыВремя чтенияСсылки SWSДиаграммыВернуть в серединуИзменить порядок или перетащить на строку заголовкаОткрепить – показать в содержимомПереместить в среднюю колонкуЗакрепить вкладкой в строке заголовкаЭлементыМодель ИИОткрыть аудиторское досьеДосьеОткрыть краткую версиюОткрыть среднюю версиюОткрыть полную версиюВосстановить вид по умолчаниюВид по умолчанию восстановленОтменитьЗакрыть подробный видСигнатураОбщие сведенияЗначенияПоследнее изменение до выбранного релизаСледующее изменение после негоЩелчок: выбрать релизЗдесь нельзя отпустить: перетащите на строку заголовка, чтобы закрепить, или в среднюю колонку, чтобы открепить.новыйизменёнбез измененийудалённе включёнИзмененияСодержание не изменилосьВпервые вУдалён вДанные о версиях недоступны.Загрузка данных о версиях …ТекстФормулировка в этом релизе не зафиксированаНаведите или щёлкните ячейку: сравнить с выбранным релизом · Щелчок по заголовку релиза: выбрать релизВыбрать релизСведенияРелизЭлементТолько один релиз с формулировкойесть в PDF, текст ещё не импортированТекст сохранён впервыебез изменений с {rel}Цвета выпусковсамый ранний выпусксамый новый выпуск

Документация методов

функция 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.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ee8ec5327419 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Статический фабричный метод ara::sm::s2r::S2RSatellite::Create служит для синхронного инстанцирования сателлита для прямого соединения с S2RHub в пределах одной и той же машины ([SWS_SM_81014]). Вызов не принимает параметров и возвращает ara::core::Result<S2RSatellite>, который в случае успешного выполнения предоставляет созданный объект сателлита ([SWS_SM_81014]).

Обработка ошибок

Если в конфигурации переключатель «Force IAM switch» установлен в true, вызов завершается ошибкой и возвращает код ошибки ara::sm::SmErrc::kAuthenticationRequired ([SWS_SM_00716]). В этом случае вместо этого обязательно должен использоваться конструктор ara::sm::s2r::S2RSatellite::S2RSatellite ([SWS_SM_81014]). Кроме того, инициируется AraNotInitialized-Violation, если среда выполнения ARA не инициализирована на момент вызова ([SWS_SM_81014]).

Параллелизм и граничные условия

Функция специфицирована как thread-safe, а также exception-safe и объявлена с noexcept ([SWS_SM_81014]). Таким образом, её можно безопасно вызывать из параллельных контекстов приложения.

Взаимодействие

Экземпляры S2RSatellite используются в поддерживающих S2R приложениях для обработки уведомлений до и после режима Suspend (SWS StateManagement §7.5.2 «S2R Satellite»). После успешного инстанцирования приложение регистрируется в хабе через Offer ([SWS_SM_00710]). Перед уничтожением объекта должна быть вызвана отмена регистрации с помощью StopOffer ([SWS_SM_00713]). Интерпретация: метод Create, вероятно, предназначен в первую очередь для сценариев использования, в которых аутентификация IAM для сателлита не является обязательной. Вопрос Q-fc41980edcb3f61a (открытый)

Данное указание по использованию создано ИИ.

Руководство разработчика реализации в подготовке (сложность 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#bf184d41
Content hash: bf184d41
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

функция 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().

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 023b44de9187 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Чисто виртуальный метод обратного вызова EnterSuspendMode класса ara::sm::s2r::S2RSatellite [SWS_SM_81010] запрашивает у экземпляра-сателлита переход в режим ожидания (suspend) [SWS_SM_00711]. Вызов инициируется, когда S2R Hub через RequestToEnterSuspendMode дает команду всем активно зарегистрированным сателлитам перейти в состояние suspend [SWS_SM_00701]. Необходимым условием для приема этого вызова является предварительная успешная регистрация экземпляра-сателлита на концентраторе через Offer [SWS_SM_81010] [SWS_SM_00710].

В качестве возвращаемого значения служит ara::core::Future<void> [SWS_SM_81010]. Если приложение может успешно перейти в режим suspend, future завершается с void [SWS_SM_81010]. При возникновении ошибки future должно завершиться с кодом ошибки SmErrc::kRejected [SWS_SM_81010]. Если хотя бы один сателлит сообщает kRejected, запрос концентратора возвращает общий результат kAtLeastOneRejected [SWS_SM_00702]. Если сателлит не отвечает вовремя в пределах тайм-аута, связь прерывается с ошибкой kCommunicationTimeout AUTOSAR_AP_SWS_StateManagement с. 36.

Что касается параллелизма, интерфейс определен как непотокобезопасный (not-threadsafe) и небезопасный относительно исключений (not exception safe) [SWS_SM_81010]. Перед уничтожением объекта-сателлита необходимо вызвать StopOffer; этот вызов отменяет регистрацию сателлита и блокирует выполнение до завершения текущих выполнений обратного вызова [SWS_SM_00713]. Поскольку метод объявлен чисто виртуальным, конкретная реализация, вероятно, выполняется в производном классе приложения для сохранения локальных состояний перед Suspend-to-RAM. Вопрос Q-628b88828075652c (открытый)

Этот текст был сгенерирован ИИ-системой на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность 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#7551e6bc
Content hash: 7551e6bc
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

функция 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().

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 4c7954c5f9b4 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Чисто виртуальный метод LeaveSuspendMode служит для приложений с поддержкой S2R (S2R-Aware applications) средством выхода из режима suspend и возобновления штатной работы [SWS_SM_81011], SWS StateManagement §7.5.2 «S2R Satellite». При этом специфичная для приложения логика возобновления, согласно интерпретации, должна реализовываться в классе, производном от ara::sm::s2r::S2RSatellite. Вопрос Q-c8e12bf51d76935c (открытый)

Использование и контекст вызова

Вызов происходит асинхронно и инициируется приемом триггера resume на сателлите [SWS_SM_00711]. Этот триггер исходит от ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode, который отправляет сообщение всем активно зарегистрированным экземплярам-сателлитам [SWS_SM_00703]. Метод не принимает параметров и возвращает ara::core::Future<void> [SWS_SM_81011]. В случае успеха future завершается с void, как только режим suspend был успешно покинут [SWS_SM_81011].

Обработка ошибок

Если при пробуждении возникают проблемы, future завершается с ошибкой с кодом ошибки SmErrc::kRejected (семантика отката) [SWS_SM_81011]. Это побуждает S2R-концентратор выдать в качестве общего результата kAtLeastOneHadIssuesToLeave [SWS_SM_00707]. Если сателлит не реагирует в течение установленного срока, концентратор прерывает операцию с kCommunicationTimeout [SWS_SM_00707].

Параллелизм и предварительные условия

Регистрация: Активация обработчика требует, чтобы предварительно был вызван Offer [SWS_SM_81011], благодаря чему сателлит становится активно зарегистрированным [SWS_SM_00710].
Безопасность: Операция специфицирована как not-threadsafe и not exception safe [SWS_SM_81011].
Жизненный цикл: Перед уничтожением сателлита необходимо вызвать StopOffer; вызов блокируется до завершения выполняющихся обратных вызовов [SWS_SM_00713].

Этот указание по использованию было сгенерировано автоматически и основано исключительно на данных спецификации AUTOSAR Adaptive R25-11.

Руководство разработчика реализации в подготовке (сложность 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#5e70d6da
Content hash: 5e70d6da
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

функция Offer [SWS_SM_81012] Upstream: RS_SM_00402

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

Enables potential invocations of handlers .

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 4698b0d80386 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронная функция-член ara::sm::s2r::S2RSatellite::Offer регистрирует экземпляр сателлита в центральном S2R-хабе [SWS_SM_00710]. Вызов без параметров активирует приём уведомлений, благодаря чему могут вызываться обратные вызовы на стороне приложения для перехода в режим ожидания (Suspend), а также последующего пробуждения [SWS_SM_81012], [SWS_SM_81010], [SWS_SM_81011]. Метод возвращает ara::core::Result<void> и объявлен безопасным относительно исключений (noexcept) [SWS_SM_81012].

В штатном случае успешного выполнения возвращаемый Result пуст [SWS_SM_81012]. Если служба не может быть предоставлена из-за нарушения связи с демоном State Management, вызов завершается ошибкой с кодом SmErrc::kOfferFailed [SWS_SM_81012]. Кроме того, контекст процесса сателлита должен соответствовать предписаниям IAM для зарегистрированного приложения, поскольку неавторизованные экземпляры отклоняются [SWS_SM_00715]. Интерпретация: в случае сбоя регистрации экземпляр, вероятно, остаётся незарегистрированным в хабе. Вопрос Q-1b445bcf1aecef2d (открытый)

Что касается параллелизма, Offer специфицирована как непотокобезопасная (not thread-safe) [SWS_SM_81012]; параллельные вызовы одного и того же экземпляра поэтому требуют внешней синхронизации. После успешного предложения сателлит остаётся активно зарегистрированным до тех пор, пока приложение явно не вызовет ara::sm::s2r::S2RSatellite::StopOffer [SWS_SM_00710]. Отмена регистрации через StopOffer должна быть выполнена до уничтожения сателлита и блокирует выполнение до завершения текущих обратных вызовов [SWS_SM_00713].

Этот текст был сгенерирован ИИ и служит в качестве справочного материала. Обязательную силу имеют исключительно спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность 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#05953f80
Content hash: 05953f80
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

функция 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#206cfe3b
Content hash: 206cfe3b
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

функция 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#cb1e482f
Content hash: cb1e482f
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

функция 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#200b212e
Content hash: 200b212e
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

функция 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#c8af87c6
Content hash: c8af87c6
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

функция StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

void StopOffer () noexcept;

Disables invocations of handlers.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: f065eb564bf8 Происхождение Открытые вопросы (1)

переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование и семантика

Метод StopOffer() отменяет регистрацию экземпляра ara::sm::s2r::S2RSatellite в S2R Hub и деактивирует будущие вызовы функций обратного вызова ([SWS_SM_81013], [SWS_SM_00710]). Вызов выполняется синхронно и блокирует выполнение до тех пор, пока все выполняемые в данный момент обратные вызовы не будут полностью завершены ([SWS_SM_00713]). Функция не принимает параметров и не имеет возвращаемого значения.

Жизненный цикл и обработка ошибок

Интерфейс объявлен как noexcept и не генерирует исключений; специфические коды ошибок отсутствуют ([SWS_SM_81013]). Согласно спецификации, StopOffer() не является потокобезопасным (not thread-safe). Приложение должно обеспечить, чтобы StopOffer() вызывался либо явно перед уничтожением объекта S2RSatellite, либо — интерпретация: предположительно — выполнялся внутри деструктора инкапсулирующего пользовательского класса (SWS StateManagement §7.5.2 «Deregistration of S2R Satellites at S2R Hub»). Вопрос Q-79aa369fb23871ed (открытый)

Взаимодействие в последовательности процессов Suspend-to-RAM

Если S2R Hub находится в процессе выполнения RequestToEnterSuspendMode или RequestToLeaveSuspendMode, он ожидает все адресованные сателлиты. Если сателлит на этой фазе отменяет регистрацию через StopOffer(), это расценивается хабом как положительный ответ и предотвращает сбой смены состояния ([SWS_SM_00702], [SWS_SM_00707]).

Это указание по использованию было создано автоматически на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность 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#0b78997e
Content hash: 0b78997e
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

функция 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#f740a0f7
Content hash: f740a0f7
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

функция 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#ab9670d7
Content hash: ab9670d7
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

функция ~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#09ba00e3
Content hash: 09ba00e3
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

класс ara::sm::s2r::S2RSatellite

Руководство пользователяСОЗДАНО ИИ

Контекст

Жизненный цикл

Путь использования

Сценарии ошибок

Карта членов

Конструкторы и деструктор

Методы

Операторы

Диаграмма классов

Подробный вид

Конструкторы и деструктор

Методы

Операторы

Документация методов

функция Create [SWS_SM_81014] Upstream: RS_SM_00402

Использование

Обработка ошибок

Параллелизм и граничные условия

Взаимодействие

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция EnterSuspendMode [SWS_SM_81010] Upstream: RS_SM_00402

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция LeaveSuspendMode [SWS_SM_81011] Upstream: RS_SM_00402

Использование и контекст вызова

Обработка ошибок

Параллелизм и предварительные условия

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция Offer [SWS_SM_81012] Upstream: RS_SM_00402

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция S2RSatellite [SWS_SM_81003] Upstream: RS_SM_00402

Parameter (in)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция S2RSatellite [SWS_SM_81004] Upstream: RS_SM_00402

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция S2RSatellite [SWS_SM_81006] Upstream: RS_SM_00402

Parameter (in)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция S2RSatellite [SWS_SM_81007] Upstream: RS_SM_00402

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция StopOffer [SWS_SM_81013] Upstream: RS_SM_00402

Использование и семантика

Жизненный цикл и обработка ошибок

Взаимодействие в последовательности процессов Suspend-to-RAM

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция operator= [SWS_SM_81008] Upstream: RS_SM_00402

Parameter (in)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

функция operator= [SWS_SM_81009] Upstream: RS_SM_00402