네임스페이스 ara::sm

네임스페이스 ara::sm은 AUTOSAR Adaptive의 State Management를 위한 도메인별 오류 처리 및 조정 구조를 제공합니다(AUTOSAR_AP_SWS_StateManagement §7.5 34쪽). 이는 SmErrc, SmErrorDomain 및 MakeErrorCode를 통해 통신 오류, 타임아웃, 그리고 Suspend-to-RAM과 같은 동기화된 상태 전환 시의 거부를 기록하기 위한 표준화된 메커니즘을 정의합니다([SWS_SM_81240], [SWS_SM_81244]). 주요 제약 조건은 자동화된 상태 머신 제어와 조정 인스턴스에 대한 직접적인 API 접근 간의 상호 배제입니다([SWS_SM_00684]).

자세히 ›

컨텍스트

네임스페이스 ara::sm은 AUTOSAR Adaptive Platform의 State Management를 위한 기초적인 인터페이스를 형성하며 오류 처리 및 머신 전체의 상태 구성을 제어하기 위한 타입을 제공합니다. 중앙 오류 도메인 SmErrorDomain과 관련 예외 타입 SmException 외에도, 이 모듈은 특히 AUTOSAR_AP_SWS_StateManagement §7.5 “Interaction with Suspend-to-RAM Functionality” 34쪽에 따른 Suspend-to-RAM 기능 범위 내에서 시스템 상태를 동기화하기 위한 기능적 메커니즘을 포함합니다. 주요 상호작용 파트너에는 SMControlApplication와 같은 제어 애플리케이션, State Management 데몬의 내부 StateMachine 컨트롤러, 그리고 위성을 통해 연결된 프로세스(AUTOSAR_AP_SWS_StateManagement §7.5.1 “S2R Hub” 35쪽)가 포함됩니다.

이 아키텍처는 선언적 상태 머신과 프로그래밍 방식의 제어를 엄격하게 분리합니다. 시스템이 StateMachine 방식을 따르는 경우, 제어 인스턴스가 조정을 내부적으로 통합하므로 외부 애플리케이션은 S2RHub의 C++ API에 대한 직접 접근이 거부됩니다([SWS_SM_00684]; AUTOSAR_AP_SWS_StateManagement §7.7.15 96쪽). 보안 관련 상호작용은 또한 공인된 프로세스만이 등록을 수행하거나 상태 변경을 요청할 수 있도록 보장하기 위해 Identity and Access Management(IAM)의 검사를 받습니다([SWS_SM_00706], [SWS_SM_00714], [SWS_SM_00715]).

컨텍스트 다이어그램: 제어 애플리케이션, State Management 데몬, 위성 및 오류 도메인 간의 역할 분담 및 상호작용 경로. 출처: [SWS_SM_00684], [SWS_SM_00701], [SWS_SM_00710], [SWS_SM_81240], [SWS_SM_81251].

사용 경로

이 네임스페이스의 일반적인 사용은 애플리케이션 측 프로세스 등록, 조정된 전환 트리거, 그리고 결과 오류 코드의 평가로 구성됩니다. Suspend-to-RAM 기능을 보유한 프로세스의 경우, 주기는 Offer을 통한 인터페이스 제공으로 시작됩니다([SWS_SM_00710]). 운영체제가 절전 상태로 전환되기 전에, 제어 인스턴스는 RequestToEnterSuspendMode를 사용하여 등록된 모든 위성에 요청을 보내며, 이에 따라 해당 콜백 EnterSuspendMode이 트리거됩니다([SWS_SM_00701], [SWS_SM_00711]).

조정 기능은 참여하는 모든 위성이 응답하거나 등록 취소될 때까지 전환을 차단하거나 모니터링합니다([SWS_SM_00702]). 웨이크업 시에는 유사하게 RequestToLeaveSuspendMode의 호출이 발생하며, 이는 LeaveSuspendMode를 통해 정상 동작을 복원합니다([SWS_SM_00703], [SWS_SM_00711]). 통신 또는 상태 전환 시 중단이 발생하는 경우, 모듈은 열거형 SmErrc을 기반으로 특정 ara::core::ErrorCode 인스턴스를 생성하여 호출 애플리케이션에 제공하기 위해 비멤버 함수 MakeErrorCode를 사용합니다([SWS_SM_81244]).

시퀀스 다이어그램: 위성과의 서스펜드 조정 및 오류 처리의 일반적인 흐름. 출처: [SWS_SM_00701], [SWS_SM_00702], [SWS_SM_00707], [SWS_SM_81240], [SWS_SM_81244].

오류 시나리오

ara::sm의 오류 처리는 엄격하게 타입화되어 있으며 열거형 SmErrc을 기반으로 합니다([SWS_SM_81240]). 정의된 오류 코드에는 다음이 포함됩니다:

• kOfferFailed: State Management 데몬과의 통신에 실패하여 서비스를 제공할 수 없습니다([SWS_SM_81240]).
• kCommunicationFailed: 위성과의 통신 시 하위 전송 계층에서의 오류입니다([SWS_SM_81240]).
• kCommunicationTimeout: 호출된 위성이 지정된 응답 시간을 초과했습니다([SWS_SM_81240], [SWS_SM_00707]).
• kAtLeastOneRejected: 최소 하나 이상의 위성이 서스펜드 상태로 올바르게 진입하지 못했습니다([SWS_SM_81240]).
• kAtLeastOneHadIssuesToLeave: 최소 하나 이상의 위성이 서스펜드 모드를 벗어날 때 kRejected을 보고했습니다([SWS_SM_81240], [SWS_SM_00707]).
• kAuthenticationRequired: IAM 인증이 강제 적용되며 위성의 명시적인 신원 확인을 요구합니다([SWS_SM_81240], [SWS_SM_00716]).

GetSmDomain([SWS_SM_81251])을 통한 전역 오류 도메인의 제공 및 MakeErrorCode([SWS_SM_81244])를 통한 오류 코드 생성은 noexcept로 선언되어 있으며 예외 및 스레드 안전성을 보장합니다. 해석: SmException의 발생은 기능적 인터페이스가 오류 발생 시 일반적으로 ara::core::ErrorCode을 반환하는 반면, 호출자가 SmErrorDomain의 오류 코드를 예외 기반 제어 흐름으로 변환하고자 할 때 주로 적용될 것으로 추정됩니다. 질문 Q-5afcc13f11bdf19b (열림)