클래스 ara::shwa::AcceleratorSelector

클래스 ara::shwa::AcceleratorSelector은(는) Hardware Acceleration 모듈에서 선택기 전략([AP_SWS_SHWA_00413])에 따라 적합한 가속기 디바이스를 평가하고 선택하는 역할을 합니다. SelectDevice()을(를) 통해 적합한 Device을(를) 직접 선택할 수 있으며, operator()은(는) 개별 디바이스에 대한 개별 숫자 평가([AP_SWS_SHWA_00412])를 가능하게 합니다. 두 작업 모두 스레드 안전하지 않은 것으로 명시되어 있으므로 동시 사용 시 외부 동기화가 필요합니다. 리소스 사용 중 또는 지원되지 않는 기능과 같은 잠재적 오류는 롤백 없이 ara::core::Result을(를) 통해 반환됩니다.

자세히 ›

컨텍스트

클래스 ara::shwa::AcceleratorSelector은(는) AUTOSAR Adaptive Platform의 모듈 shwa(Hardware Acceleration)에서 하드웨어 가속기 디바이스를 위한 특수화된 선택기로 작동합니다. 클래스 구문에 따르면 기본 인터페이스 DeviceSelector에서 공개 파생됩니다(class AcceleratorSelector : public DeviceSelector). 핵심 작업은 정의된 선택기 전략에 따라 물리적 또는 논리적 가속기 디바이스(Device)를 평가하거나 적합한 디바이스를 선택하는 것입니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

상호 작용 파트너에는 연산 집약적인 작업을 위해 가속기 리소스를 요청하는 상위 애플리케이션 로직, 상속 기본 클래스 DeviceSelector 및 선택기에 의해 분석되거나 반환되는 Device 인스턴스가 포함됩니다. 선택 기준 자체는 선택기 전략의 구체적인 구현에 캡슐화되어 있습니다([AP_SWS_SHWA_00413]).

컨텍스트 다이어그램: 애플리케이션, DeviceSelector 및 Device와의 상호 작용에서 AcceleratorSelector의 위치. 출처: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

수명 주기

AcceleratorSelector의 인스턴스화는 일반적으로 애플리케이션별로 또는 첫 번째 디바이스 요청 전에 해당 팩토리 메커니즘을 통해 수행될 것으로 보입니다. 질문 Q-933e42753f63687c (열림) 소멸은 해당 애플리케이션 컴포넌트에 대해 선택 로직이 더 이상 필요하지 않게 되는 즉시 발생하며, 사양은 특정 중간 상태나 라이프사이클 단계를 규정하지 않습니다.

동시성과 관련하여 제공되는 두 작업 SelectDevice() 및 operator()은(는) 명시적으로 스레드 안전하지 않음("not thread-safe")으로 규정되어 있습니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). 두 메서드 모두 const(으)로 선언되어 있지만 동일한 인스턴스 또는 동일한 기저 하드웨어 리소스에 대한 병렬 호출은 호출자에 의해 외부에서 동기화되어야 합니다.

사용 경로

AcceleratorSelector과의 상호 작용은 두 가지 대체 사용 경로를 통해 이루어집니다. 즉, 직접 자동 선택과 개별 후보 평가입니다. 가상 메서드 SelectDevice()을(를) 통해 애플리케이션은 구현된 전략에 따라 적합한 디바이스의 선택을 직접 요청합니다([AP_SWS_SHWA_00413]). 성공 시 호출은 ara::core::Result에 캡슐화된 Device 인스턴스를 반환합니다.

대안적으로 오버로드된 호출 연산자 operator()은(는) 알려진 개별 디바이스의 단계별 평가를 허용합니다([AP_SWS_SHWA_00412]). operator()에서 반환된 정수 값(int)은 애플리케이션이 직접 순위를 매기거나 필터링을 수행할 수 있는 상대적인 적합도 점수를 나타내는 것으로 보입니다. 해석: SelectDevice()은(는) 전체 선택 전략을 자율적으로 캡슐화하는 반면, operator()은(는) 개별 디바이스의 세분화된 비교를 가능하게 합니다. 질문 Q-e2de44ef0c9e936d (열림)

시퀀스 다이어그램: 디바이스 평가 및 디바이스 선택 시 호출 흐름. 출처: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

오류 시나리오

두 작업 모두 noexcept(으)로 선언되어 있으며 Exception Safety를 보장합니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). 오류는 반환 유형 ara::core::Result을(를) 통해서만 전달됩니다. 영역 ShwaErrorCode의 다음 오류 코드가 명시되어 있습니다:

• ShwaErrorCode::kResourceBusy: 해당 리소스가 현재 사용 중이거나 점유되어 있어 작업을 수행할 수 없습니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).
• ShwaErrorCode::kFeatureNotSupported: 선택 또는 평가를 위해 요청된 속성이 플랫폼이나 디바이스에서 지원되지 않습니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

두 함수 모두 롤백 시맨틱이 존재하지 않는 것(no_rollback_semantics)으로 정의되어 있습니다([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). 오류가 발생하더라도 이전 시스템 또는 하드웨어 상태는 자동으로 복원되지 않습니다. 호출자는 Result 객체의 오류 코드를 확인하고 필요한 경우 재시도 또는 대안적 선택 경로를 시작해야 합니다.