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

Класс ara::sm::s2r::S2RHub координирует в State Management переход в состояние Suspend-to-RAM и выход из него для зарегистрированных сателлитных приложений (AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»). Он позволяет управляющему приложению запросить подготовку сателлитов перед переводом операционной системы в спящий режим и вернуть их в штатный режим работы после пробуждения ([SWS_SM_00701], [SWS_SM_81112]). Использование C++-API строго исключает внутренний подход StateMachine и требует верифицированных полномочий IAM ([SWS_SM_00684], [SWS_SM_00706]).

больше ›

Контекст

Класс ara::sm::s2r::S2RHub образует центральный интерфейс State Management для координации переходов Suspend-to-RAM на Adaptive Platform (AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»). Чтобы оптимизировать по времени останов и запуск машины, вместо полного перезапуска системы может использоваться Suspend-to-RAM (AUTOSAR_AP_SWS_StateManagement §7.5 «Interaction with Suspend-to-RAM Functionality»). Основная задача концентратора состоит в том, чтобы обратиться ко всем активно зарегистрированным экземплярам сателлитов (ara::sm::s2r::S2RSatellite) для запуска упорядоченной подготовки перед переводом операционной системы в состояние ожидания и координации возобновления работы после пробуждения ([SWS_SM_00701], [SWS_SM_00703]).

Использование класса S2RHub зарезервировано за выделенными управляющими приложениями, такими как SMControlApplication, и не предназначено для стандартных Adaptive Applications (AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4 «Interfaces for Suspend-to-Ram Notifications»). Доступ к функциональности концентратора может осуществляться либо через C++-API, либо внутренне через подход StateMachine; оба варианта строго взаимно исключают друг друга во избежание состояний гонки и несогласованности состояний (AUTOSAR_AP_SWS_StateManagement §7.5.1 «S2R Hub», AUTOSAR_AP_SWS_StateManagement §7.7.15 «Mutual exclusivity of StateMachine approach and S2RHub API usage», [SWS_SM_00684]). При этом взаимодействие с процессами и сателлитами защищается через Identity and Access Management (IAM) ([SWS_SM_00706], [SWS_SM_00714], [SWS_SM_00715]).

Контекстная диаграмма: встраивание S2RHub между управляющим приложением, сателлитами и операционной системой. Источники: AUTOSAR_AP_EXP_SWArchitecture §9.2.2.1.4, AUTOSAR_AP_SWS_StateManagement §7.5.1, [SWS_SM_81112].

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

Экземпляр ara::sm::s2r::S2RHub создается явно через ara::core::InstanceSpecifier ([SWS_SM_81103]). Во время конструирования выполняется обязательная проверка полномочий IAM, при которой контекст вызывающего процесса валидируется относительно сопоставления модели (SuspendToRamHubMapping.process) ([SWS_SM_00706], [SWS_SM_00714]). Операции копирования для класса полностью запрещены ([SWS_SM_81107], [SWS_SM_81109]). Однако класс поддерживает семантику перемещения с помощью конструктора перемещения и оператора присваивания с перемещением ([SWS_SM_81106], [SWS_SM_81108]).

Что касается параллелизма, параметризованный конструктор, а также операции перемещения специфицированы как потокобезопасные ([SWS_SM_81103], [SWS_SM_81106], [SWS_SM_81108]). Виртуальный деструктор ~S2RHub(), а также оперативные методы для координации ожидания, напротив, не являются потокобезопасными ([SWS_SM_81105], [SWS_SM_81110], [SWS_SM_81111], [SWS_SM_81112]). Поэтому вызывающие стороны должны гарантировать, что уничтожение и выполнение переходов происходят последовательно и без конкурирующих вызовов.

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

Штатная последовательность инициации и завершения Suspend-to-RAM подразделяется на три последовательные фазы:

1. Подготовка состояния ожидания: перед приостановкой операционной системы функциональные группы с неподдерживающими процессами должны быть остановлены (AUTOSAR_AP_SWS_StateManagement §7.5). Затем управляющее приложение вызывает RequestToEnterSuspendMode() на концентраторе ([SWS_SM_81110]). Концентратор уведомляет все зарегистрированные через Offer сателлиты через EnterSuspendMode ([SWS_SM_00701], [SWS_SM_00710], [SWS_SM_00711]). Метод возвращает ara::core::Future<void>, завершающийся только после того, как все адресованные сателлиты ответят, отменят регистрацию или истечет таймаут ([SWS_SM_00702], [SWS_SM_81110]).
2. Запуск System-Suspend: после успешного ответа всех сателлитов вызывающая сторона через синхронную функцию EnterSuspendToRamOs() инициирует перевод машины операционной системой в режим Suspend-to-RAM ([SWS_SM_81112]).
3. Возобновление работы после пробуждения: как только операционная система снова пробуждается, управляющее приложение инициирует возобновление штатной работы через RequestToLeaveSuspendMode() ([SWS_SM_81111]). Концентратор запрашивает у всех активных сателлитов через их функцию обратного вызова выход из режима ожидания ([SWS_SM_00703], [SWS_SM_00711]). Возвращенный future разрешается положительно, если все сателлиты подтверждают операцию успешно или отменяют регистрацию через StopOffer ([SWS_SM_00707], [SWS_SM_81111]).

Диаграмма последовательности: типичный порядок вызовов для подготовки к приостановке, выполнения OS-Suspend и последующей повторной активации. Источники: [SWS_SM_00701], [SWS_SM_00702], [SWS_SM_00703], [SWS_SM_00707], [SWS_SM_81110], [SWS_SM_81111], [SWS_SM_81112].

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

Условия ошибок сигнализируются в S2RHub в зависимости от фазы через нарушения архитектуры (violations) или коды ошибок в ara::core::Future:

• Ошибки конструирования и нарушения: если проверка полномочий вызывающего процесса завершается неудачно, генерируются нарушение InsufficientPermissionsViolation и событие безопасности SEV_ACCESS_CONTROL_SM_IAM_ACCESS_DENIED ([SWS_SM_00706], [SWS_SM_81103]). Другие определенные нарушения включают InstanceSpecifierMappingIntegrityViolation (недействительность идентификатора модели), PortInterfaceMappingViolation (несовместимый тип интерфейса), ProcessMappingViolation (отсутствие привязки к процессу), InstanceSpecifierAlreadyInUseViolation (многократное использование в одном и том же процессе) и AraNotInitializedViolation (отсутствие инициализации Adaptive Platform) ([SWS_SM_81103]).
• Ошибки при переходе в состояние ожидания: если связь на нижних уровнях нарушается, future метода RequestToEnterSuspendMode() завершается сбоем с SmErrc::kCommunicationFailed ([SWS_SM_81110]). Если хотя бы один сателлит не отвечает в течение конфигурируемого временного интервала (по умолчанию: 1000 мс), это приводит к SmErrc::kCommunicationTimeout ([SWS_SM_81110]). Обе ошибки обладают семантикой отката. Если хотя бы один сателлит сообщает об отклонении перехода, future возвращает ошибку SmErrc::kAtLeastOneRejected без семантики отката ([SWS_SM_81110]).
• Ошибки при выходе из состояния ожидания: аналогично проблемы со связью или таймауты при RequestToLeaveSuspendMode() приводят к SmErrc::kCommunicationFailed или SmErrc::kCommunicationTimeout соответственно ([SWS_SM_00707], [SWS_SM_81111]). Если сателлит отвечает с kRejected, future сообщает код ошибки SmErrc::kAtLeastOneHadIssuesToLeave ([SWS_SM_00707], [SWS_SM_81111]).
• Отклоненная регистрация сателлита: попытки регистрации сателлитов отклоняются концентратором, если их контекст процесса не совпадает с конфигурацией модели ([SWS_SM_00715]).