클래스 ara::shwa::Platform

클래스 ara::shwa::Platform은 AUTOSAR Safe Hardware Acceleration 클러스터(SWS SafeHardwareAcceleration §1 “Scope of Document”)에서 하드웨어 가속기를 탐색하기 위한 중앙 진입점 역할을 합니다. 정적 팩토리 메서드를 통해 사용 가능한 플랫폼 인스턴스를 획득한 후, 애플리케이션은 병렬 계산 작업을 위한 연결된 가속기 장치를 식별하기 위해 GetDevices()을(를) 호출합니다([AP_SWS_SHWA_01108]). 기본 생성자가 삭제되었고 메서드가 스레드 안전하지 않으므로, 인스턴스는 팩토리 메서드를 통해 획득해야 하며 동시성 발생 시 접근은 애플리케이션 측에서 동기화되어야 합니다.

자세히 ›

컨텍스트

ara::shwa::Platform 클래스는 AUTOSAR Adaptive Platform의 Safe Hardware Acceleration(SHWA) 기능 클러스터에 대한 중앙 진입점을 형성합니다(SWS SafeHardwareAcceleration §1 “Scope of Document”). 이 클러스터의 목표는 Adaptive Applications 및 다른 기능 클러스터에 하드웨어 가속기를 사용하기 위한 표준화되고 이식 가능하며 안전한 인터페이스를 제공하는 것입니다(SWS SafeHardwareAcceleration §4.1 “Functional Overview”). SHWA 클러스터는 차량 안전 요구사항을 준수하는 병렬 연산 작업, 가속기에서의 오류 감지 및 오류 수정, 하드웨어 작동 상태 모니터링을 담당합니다(SWS SafeHardwareAcceleration §4.1 “Functional Overview”).

클러스터 아키텍처에서 Platform은 특정 실행 단위(Device)에 대한 접근이 이루어지는 상위 하드웨어 플랫폼을 나타냅니다(SWS SafeHardwareAcceleration §7 “High Level Design of Safe Hardware Acceleration in an Adaptive Platform”). Adaptive Application은 플랫폼과 상호작용하여 사용 가능한 가속기 디바이스를 확인하며, 이러한 디바이스는 큐(Queue) 및 버퍼(Buffer)와 연계하여 연산 집약적인 작업을 병렬로 처리합니다(SWS SafeHardwareAcceleration §7 “High Level Design of Safe Hardware Acceleration in an Adaptive Platform”).

수명 주기

ara::shwa::Platform의 라이프사이클은 제어된 인스턴스화의 적용을 받습니다. 기본 생성자는 명시적으로 삭제(deleted)되어 있으므로([AP_SWS_SHWA_01102]), 애플리케이션이 컨텍스트 없이 플랫폼 객체를 생성할 수 없습니다. 초기화는 정적 팩토리 메서드 GetPlatforms()를 통해서만 수행됩니다([AP_SWS_SHWA_01107]).

제공된 인스턴스는 완전한 값 및 이동 시맨틱을 지원합니다:

• 복사 생성자([AP_SWS_SHWA_01103])와 복사 대입 연산자([AP_SWS_SHWA_01104])는 default 및 noexcept로 선언되어 있습니다.
• 이동 생성자([AP_SWS_SHWA_01105])와 이동 대입 연산자([AP_SWS_SHWA_01106]) 또한 default 및 noexcept로 정의되어 있습니다.

Interpretation: 모든 복사 및 이동 연산자가 trivial default로 선언되어 있으므로, Platform은 드라이버 컨텍스트에 대한 경량 프록시 또는 디스크립터로 설계되었을 것으로 보입니다. 질문 Q-d136569f5adb1a20 (열림) 동시성과 관련하여 클래스의 메서드는 명시적으로 스레드 안전하지 않음(not thread-safe)으로 지정되어 있습니다([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). 인스턴스를 스레드 간에 사용하는 경우 애플리케이션 측에서 호출을 동기화해야 합니다.

사용 경로

애플리케이션에 ara::shwa::Platform을 통합하는 작업은 정해진 단계 순서에 따라 진행됩니다:

1. 애플리케이션은 사용 가능한 모든 플랫폼 인스턴스를 조회하기 위해 정적 팩토리 메서드 ara::shwa::Platform::GetPlatforms()을 호출합니다([AP_SWS_SHWA_01107]).
2. 애플리케이션은 반환된 결과 벡터에서 원하는 플랫폼 인스턴스를 선택합니다.
3. 해당 인스턴스에서 할당된 하드웨어 가속기를 조회하기 위해 GetDevices() 메서드가 호출됩니다([AP_SWS_SHWA_01108]).
4. 결과로 생성된 Device 객체는 이후 하드웨어에서 연산 작업을 실행하기 위한 큐와 버퍼를 생성하는 데 사용됩니다(SWS SafeHardwareAcceleration §7 “High Level Design of Safe Hardware Acceleration in an Adaptive Platform”).

시퀀스 다이어그램: 플랫폼 조회 및 후속 사용 가능한 가속기 디바이스 확인의 전형적인 흐름. 출처: [AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108], SWS SafeHardwareAcceleration §7 “High Level Design of Safe Hardware Acceleration in an Adaptive Platform”.

오류 시나리오

ara::shwa::Platform의 연산은 noexcept로 선언되어 있으며 C++ 예외를 발생시키지 않습니다([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). 오류 상황은 반환값 ara::core::Result의 오류 타입을 통해 전달됩니다. GetPlatforms() 및 GetDevices() 모두에 대해 다음과 같은 오류 코드가 지정되어 있습니다:

• ShwaErrorCode::kResourceBusy: 관련 하드웨어 또는 소프트웨어 리소스가 현재 점유되어 있어 요청된 연산을 실행할 수 없습니다([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
• ShwaErrorCode::kRuntime: 일반적인 런타임 오류가 발생했습니다([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). 이 오류에는 롤백 시맨틱(no_rollback_semantics)이 제공되지 않으므로 내부 상태가 자동으로 리셋되지 않으며, 애플리케이션이 해당 프로세스를 처리해야 합니다.