구조체 ara::diag::DoIPEntityIdentification::EntityId

구조체 ara::diag::DoIPEntityIdentification::EntityId은 ISO 13400-2에 따른 DoIP 인스턴스의 6바이트 개체 식별자(EID)를 위한 데이터 컨테이너 역할을 합니다([SWS_DM_01496]). 해당 설정 시, Diagnostic Manager는 차량 안내와 같은 DoIP 프로토콜 메시지에 포함하기 위해 적응형 애플리케이션으로부터 메서드 ara::diag::DoIPEntityIdentification::GetEntityId를 통해 이 식별자를 가져옵니다([SWS_DM_01361]). 인터페이스가 아직 준비되지 않았거나 조회가 실패할 경우, 필수 제약 조건으로서 값이 0xFF인 바이트로만 구성된 고정 대체 값으로의 폴백이 적용됩니다([SWS_DM_01528]).

자세히 ›

컨텍스트

데이터 구조 ara::diag::DoIPEntityIdentification::EntityId은 ISO 13400-2에 따른 인터넷 프로토콜 기반 진단 통신(DoIP)을 위한 표준화된 개체 식별자(Entity Identification, EID)를 표현하는 역할을 합니다([SWS_DM_01496], AUTOSAR_AP_SWS_Diagnostics §8.33 “Header: ara/diag/doip_entity_identification.h”). AUTOSAR Adaptive Platform 내에서는 API 클래스 ara::diag::DoIPEntityIdentification 내부의 공개 구조체 타입으로 정의되어 있습니다([SWS_DM_01362], [SWS_DM_01496]).

이 구조체의 주요 책임은 DoIP 개체의 정확히 6바이트 길이 식별 값을 캡슐화하는 것입니다([SWS_DM_01496]). 플랫폼 아키텍처에서는 세 가지 주요 주체가 상호작용합니다: 첫째, 개체 식별자를 관리하거나 하드웨어에서 읽어오는 적응형 애플리케이션입니다. 둘째, 식별자를 제공하기 위한 메서드를 제공하는 인터페이스 클래스 ara::diag::DoIPEntityIdentification입니다([SWS_DM_01362]). 셋째, 나가는 DoIP 메시지를 위한 차량 식별 프레임워크 내에서 EID를 가져오는 Diagnostic Manager(DM)입니다([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 “Providing EID in DoIP protocol messages using Application Interface”).

컨텍스트 다이어그램: Diagnostic Manager, 인터페이스 클래스 및 적응형 애플리케이션 간의 EntityId 통합. 출처: [SWS_DM_01361], [SWS_DM_01496].

수명 주기

ara::core::Array<std::uint8_t, 6> 타입의 유일한 멤버 entityIdentification을 가진 데이터 구조로서, EntityId는 경량 C++ 값 객체(value object)의 특성을 갖습니다([SWS_DM_01496]). 해석: 동적 리소스 할당이 없으므로, 구조체는 기본적으로 일반적인 복사 및 이동 작업을 지원하며 복잡한 내부 상태 전이를 겪지 않을 것으로 보입니다. 질문 Q-4a6f7d6e7368b436 (열림)

EntityId의 인스턴스화는 Diagnostic Manager가 ara::diag::DoIPEntityIdentification::GetEntityId 호출을 통해 식별 데이터를 쿼리할 때 적응형 애플리케이션에 의해 수행됩니다([SWS_DM_01361]). 인스턴스의 수명은 일반적으로 메서드 호출의 반환 및 처리 주기에 바인딩됩니다. 둘러싸고 있는 서비스 클래스 ara::diag::DoIPEntityIdentification에는 명시적 생성자([SWS_DM_01364], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.2.1 “DoIPEntityIdentification”) 및 소멸자([SWS_DM_01365], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.1.1 “Destructor”)가 있는 반면, 값 객체 EntityId은 Diagnostic Manager가 필드 데이터를 읽은 후 유효 범위를 벗어날 때 자동으로 해제됩니다.

사용 경로

EntityId의 정상적인 사용은 진단 프로토콜 흐름에서 정의된 시퀀스를 따릅니다:

• 구성 확인: Diagnostic Manager는 DoIpNetworkConfiguration.eidRetrieval 속성을 확인합니다. 그곳에 DoIpEidRetrievalEnum.eidUseApi이 설정되어 있으면 DM은 반드시 API를 통해 식별자를 가져와야 합니다([SWS_DM_01361]).
• API를 통한 조회: Diagnostic Manager가 메서드 ara::diag::DoIPEntityIdentification::GetEntityId을 호출합니다([SWS_DM_01361]).
• 데이터 제공: 애플리케이션은 EntityId의 인스턴스를 생성하고, ISO 13400-2에 따른 6바이트 식별자로 멤버 entityIdentification을 채운 후([SWS_DM_01496]) 구조체를 전달합니다.
• 프로토콜 사용: Diagnostic Manager는 식별자를 추출하여 차량 안내 메시지(Vehicle Announcement Message)와 같은 DoIP 메시지에 삽입합니다([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 “Providing EID in DoIP protocol messages using Application Interface”).

시퀀스 다이어그램: 오류 폴백을 포함한 EntityId 검색 및 후속 처리 절차. 출처: [SWS_DM_01361], [SWS_DM_01496], [SWS_DM_01528].

오류 시나리오

필요한 조회 시점에 적응형 애플리케이션에 의해 인터페이스 ara::diag::DoIPEntityIdentification이 아직 제공되지 않거나 GetEntityId을 통한 조회가 실패할 때 주요 오류 시나리오가 발생합니다([SWS_DM_01528], AUTOSAR_AP_SWS_Diagnostics §8.33 “Providing EID in DoIP protocol messages using Application Interface”).

DoIP 메시지 전송이 영구적으로 차단되는 것을 방지하기 위해, 명세는 이 경우 필수적인 대체 값 동작을 규정합니다: Diagnostic Manager는 정상적인 애플리케이션 데이터 대신 고정 값 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF을 가진 6바이트 EID 필드를 전송해야 합니다([SWS_DM_01528]). 타입 수준에서 고정 배열 ara::core::Array<std::uint8_t, 6>는 컴파일 시점에 길이 오류 및 버퍼 오버플로를 방지합니다([SWS_DM_01496]).