DEENESPTFRRUARHIKOZHNL

서비스 인터페이스 StateMachineService

Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).

사용자 가이드AI 생성

제어 애플리케이션이 구성된 상태 머신에 대해 상태 전환을 요청할 수 있도록 지원합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: e242ff13fc20 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

제어 애플리케이션이 구성된 상태 머신에 대해 상태 전환을 요청할 수 있도록 지원합니다.

서비스 인터페이스 StateMachineService은(는) SMControlApplication이(가) 메서드 RequestTransition을(를) 통해 목표 상태 전환을 요청할 수 있도록 State Management에 의해 구성된 각 상태 머신에 대해 제공됩니다[SWS_SM_00600], [SWS_SM_91107]. 서비스는 상태 머신의 시작 단계가 성공적으로 처리된 직후 제공되며, Fire-and-Forget 시맨틱 없이 요청을 확인(응답)합니다. 그러나 전달된 값이 유효하지 않거나, 현재 상태에서의 전이가 허용되지 않거나, 업데이트 또는 복구 세션이 동시에 활성화된 경우 요청은 특정 오류와 함께 거부됩니다[SWS_SM_91107].

서비스 인터페이스의 역할 및 시스템 컨텍스트

서비스 인터페이스 StateMachineService은(는) Functional Cluster State Management(SM)에 의해 표준화된 서비스 포트를 통해 제공됩니다[SWS_SM_91021]. 공식 인터페이스 정의 [SWS_SM_91022]에 따라 State Management는 StateMachine의 개별 구성된 각 인스턴스에 대해 이 ara::com 기반 서비스를 인스턴스화하고 제공합니다[SWS_SM_00600].

이 인터페이스의 기본 소비자로는 SMControlApplication이(가) 동작하며, 서비스를 통해 상태 머신과 직접 상호작용하여 상태 전환을 요청합니다SWS StateManagement §9.2.2 “StateMachine service”. 일반 어댑티브 애플리케이션에 대한 도달 상태 알림은 주로 별도의 서비스 인터페이스 StateMachineNotification을(를) 통해 이루어지는 반면[SWS_SM_00665], StateMachineService은(는) 전이를 시작하기 위한 활성 제어 인터페이스를 구성합니다.

메서드 및 호출 시맨틱

인터페이스는 참조된 StateMachine에서 상태 변경을 유도하기 위해 SMControlApplication에 의해 호출되어야 하는 메서드 RequestTransition을(를) 정의합니다[SWS_SM_91107]. 이 메서드는 기본 TransitionRequestTable 내에서 요청된 전환 값을 나타내는 TransitionRequestType 타입의 입력 매개변수 TransitionRequest을(를) 기대합니다[SWS_SM_91107], SWS StateManagement §7.x “TransitionRequestTable”.

RequestTransition의 경우 Fire & Forget 속성이 false(으)로 설정되어 있습니다[SWS_SM_91107]. 따라서 호출 애플리케이션은 요청에 대한 확정적인 확인 응답을 수신합니다. 해석: ara::com 프록시-스켈레톤 패턴 내에서 응답은 일반적으로 성공 시 완료되거나 오류 시 특정 오류 상태를 전달하는 ara::core::Future 또는 해당 결과 객체를 통해 제공될 것으로 보입니다. 질문 Q-41fa67738672c735 (열림)

수명 주기 및 상태 종속성

시작할 StateMachine에 대해 구성된 각 ara::com 서비스(StateMachineService 포함)는 ActionListItem “StartStateMachine”이(가) 성공적으로 처리되는 즉시 사용 가능하고 제공(Offer)되어야 합니다[SWS_SM_00618]. 이를 통해 SMControlApplication은(는) 상태 머신이 해당 시점에 아직 초기 ActionList을(를) 처리 중이더라도 상태 머신이 성공적으로 생성된 직후 즉시 전이를 요청할 수 있습니다SWS StateManagement §7.x “StateMachine service interfaces - Offer”.

서비스 제공은 해당 상태 머신을 중지하기 위한 처리가 수행되는 즉시 중지(StopOffer)됩니다[SWS_SM_00619]. 또한 호출에는 기능적 전제 조건이 적용됩니다. 시스템에서 현재 업데이트 세션이 실행 중인 경우 상태 전환 시작은 원칙적으로 허용되지 않습니다[SWS_SM_91107].

오류 처리 및 Application Errors

RequestTransition 실행 중 특정 Application Error가 발생할 수 있으며, 이는 State Management에 의해 호출자에게 반환됩니다[SWS_SM_91107]:

  • kInvalidValue: 전달된 값이 TransitionRequestTable의 어떤 전이에도 할당되어 있지 않습니다[SWS_SM_91107].
  • kTransitionNotAllowed: 요청된 상태 전이는 StateMachine의 현재 상태를 기준으로 허용되지 않습니다[SWS_SM_91107].
  • kRecoveryTransitionOngoing: 현재 복구(Recovery)가 수행 중이므로 요청이 폐기됩니다[SWS_SM_91107].
  • kTransitionFailed: 대상 상태로의 전이를 실행하는 동안 오류가 발생했습니다[SWS_SM_91107].
  • kOperationCanceled: 더 새로운 요청으로 대체되었기 때문에 요청이 중단되었습니다[SWS_SM_91107].
  • kUpdateInProgress: 현재 업데이트 세션이 활성화되어 있으므로 해당 작업이 금지됩니다[SWS_SM_91107].
StateMachineService를 통한 전이 요청 절차SMControlApplicationStateMachineServiceState ManagementUse Case: Service-BereitstellungStartStateMachine verarbeitet: OfferService()Use Case: 상태 전이 요청RequestTransition(TransitionRequest)Zustandswechsel verarbeitenalt성공적인 전환TransitionRequestTable에 따라 전이 수행Erfolg피드백: 성공Fehlerfall (z. B. kTransitionNotAllowed, kUpdateInProgress)Application Error오류 코드와 함께 피드백 반환

시퀀스 다이어그램: 서비스 제공, 성공 응답 및 오류 처리를 포함한 StateMachineService를 통한 전이 요청 흐름. 출처: [SWS_SM_91107], [SWS_SM_00618], SWS StateManagement §7.x “StateMachine service interfaces - Offer”.

이 가이드는 AUTOSAR 사양 R25-11을 기반으로 AI에 의해 생성되었습니다.

Mitglieder

멤버 맵

상세 보기

개요에서 항목을 선택하세요.

메서드

RequestTransition 서비스 메서드

Has to be called by a SMControlApplication to request a change in the referenced StateMachine.

RequestTransition (IN TransitionRequestType TransitionRequest)

데이터 타입

TransitionRequestType 데이터 타입

애플리케이션 오류

kInvalidValue 애플리케이션 오류

The provided value is not mapped to any transition.

kOperationCanceled 애플리케이션 오류

The request was replaced by a newer one and therefore it was cancelled

kRecoveryTransitionOngoing 애플리케이션 오류

Request will not be carried out, because currently recovery is ongoing.

kTransitionFailed 애플리케이션 오류

During transition to the requested state an error occurred.

kTransitionNotAllowed 애플리케이션 오류

Requested transition is not possible from current StateMachine state.

kUpdateInProgress 애플리케이션 오류

Requested operation is not allowed as update session is in progress.

문서

서비스 메서드 RequestTransition [SWS_SM_91107] Upstream: RS_SM_00001, RS_SM_00004

RequestTransition (IN TransitionRequestType TransitionRequest)

Has to be called by a SMControlApplication to request a change in the referenced StateMachine.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: e769039e5880 출처
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

서비스 메서드 RequestTransition은(는) 참조된 StateMachine의 상태 전환을 요청하기 위해 인터페이스 StateMachineService에서 SMControlApplication에 의해 호출됩니다([SWS_SM_91107], SWS StateManagement §7.7 “SMControlApplication”). 파라미터로 TransitionRequest이(가) 전달됩니다. 이 메서드는 반환값을 가지며 Fire-and-Forget 원칙에 따라 작동하지 않습니다. State Management는 현재 상태에 따라 TransitionRequestTable을(를) 통해 입력값을 후속 상태에 매핑하고([SWS_SM_00607]), 그 결과인 Function Group States을(를) SetState()을(를) 통해 Execution Management에 요청합니다(AP EXP SWArchitecture §11.1 “Change System State”).

오류 처리

오류 발생 시 처리가 중단되고 RequestTransition은(는) 특정 애플리케이션 오류를 반환합니다([SWS_SM_91107]):

  • kInvalidValue: TransitionRequest에 전달된 값이 TransitionRequestTable에 구성되어 있지 않습니다([SWS_SM_00604]).
  • kTransitionNotAllowed: 구성에 따르면 StateMachine의 현재 상태로부터의 전환이 허용되지 않습니다([SWS_SM_00603]).
  • kRecoveryTransitionOngoing: 내부 오류 복구가 활성화되어 있어 요청이 더 이상 처리되지 않습니다([SWS_SM_00605]).
  • kUpdateInProgress: 활성 업데이트 세션 중에는 상태 변경이 허용되지 않습니다([SWS_SM_91107]).
  • kTransitionFailed: ActionListItems 처리 중 오류가 발생했습니다([SWS_SM_00650]).

동시성 및 제약사항

동일한 StateMachine에 대해 이전 RequestTransition 호출이 아직 대기 중인 상태에서 새로운 전환 요청이 수락되면 이전 요청은 취소되고 kOperationCanceled(으)로 확인 처리됩니다([SWS_SM_00606]). Sleep ActionListItem와(과) 같은 시간 제어 동작은 들어오는 트리거를 차단하지 않으므로, RequestTransition 호출은 이러한 대기 시간 중에도 상태 변경을 트리거할 수 있습니다(SWS StateManagement §7.7.9 “ActionListItem Sleep”).

이 사용 지침은 자동으로 생성되었으며 전적으로 AUTOSAR R25-11의 명세를 기반으로 합니다.

구현자 가이드 준비 중 (복잡도 I2)

Scopeservice interface StateMachineService
Fire & Forgetfalse
Version1.0

Parameter

NameRichtungTypBeschreibung
TransitionRequestINTransitionRequestTypeRepresents the value to be used as TransitionRequest value in the Transition RequestTable.

Application Errors

FehlerBeschreibung
kInvalidValueThe provided value is not mapped to any transition.
kTransitionNotAllowedRequested transition is not possible from current StateMachine state.
kRecoveryTransitionOngoingRequest will not be carried out, because currently recovery is ongoing.
kTransitionFailedDuring transition to the requested state an error occurred.
kOperationCanceledThe request was replaced by a newer one and therefore it was cancelled
kUpdateInProgressRequested operation is not allowed as update session is in progress.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_91107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_91107@rel:R25-11#aa1d08d0
Content hash
aa1d08d0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_91107
Status: valid/unmigrated Version: rel:R25-11#d4767b6b Versionshistorie & Revisions (1 transition, 3 revision)
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_91107@rel:R25-11#d4767b6b
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a5b9b5c32026-09-30
  • R24-11rel:R24-11#75ea2a2c2026-10-14
  • R25-11rel:R25-11#d4767b6b2026-10-14 active
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