클래스 ara::shwa::CpuSelector

클래스 ara::shwa::CpuSelector은(는) 모듈 shwa에서 특정 선택기 전략에 따라 하드웨어 디바이스를 평가하고 맞춤형으로 선택하는 역할을 합니다 [AP_SWS_SHWA_00410]. 애플리케이션 소프트웨어는 operator()을(를) 통해 개별 디바이스 후보를 평가하거나 메서드 SelectDevice()을(를) 통해 적합한 대상 디바이스를 즉시 결정할 수 있습니다 [AP_SWS_SHWA_00409]. 주요 제약 조건으로서 인터페이스는 스레드 안전하지 않은 것으로 명시되어 있고, 롤백 시맨틱을 제공하지 않으며, 리소스 점유와 같은 잠재적 오류를 ara::core::Result을(를) 통해서만 전달합니다.

자세히 ›

컨텍스트

클래스 ara::shwa::CpuSelector은(는) AUTOSAR Adaptive Platform 내의 하드웨어 가속 모듈(shwa)의 구성 요소입니다. 이 클래스는 기본 인터페이스 DeviceSelector에서 파생되며 실행 디바이스의 기능적 선택을 특수화합니다. 기본 책임은 선택기 전략을 기반으로 하드웨어 디바이스(Device)를 평가하거나 적합한 디바이스를 직접 선택하는 것입니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

전체 시스템에서 CpuSelector은(는) 요청 소프트웨어 컴포넌트와 사용 가능한 하드웨어 장치 사이의 연결고리 역할을 합니다. DeviceSelector이(가) 일반 인터페이스를 제공하는 반면, 클래스 이름이 시사하듯 CpuSelector은(는) 선택기 전략으로서 특히 CPU 기반 하드웨어 리소스를 대상으로 할 것으로 보입니다. 질문 Q-32abbae13e272c68 (열림) 애플리케이션 소프트웨어는 작업 인계 전에 리소스 적합성에 대한 근거 있는 결정을 내리기 위해 이 클래스를 포함합니다.

수명 주기

선택 전략을 제공하기 위해 애플리케이션 컨텍스트에서 또는 상위 관리자 인스턴스에 의해 CpuSelector의 인스턴스가 생성됩니다. 핵심적인 평가 및 선택 연산은 const(으)로 선언되어 있으므로, 인스턴스는 사용되는 동안 외부적으로 상태를 유지하지 않는(stateless) 방식으로 동작하며 내부 선택 상태를 수정하지 않습니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

동시성과 관련하여 SelectDevice() [AP_SWS_SHWA_00410] 및 operator() [AP_SWS_SHWA_00409] 모두 스레드 안전하지 않습니다(not thread-safe). 해당 메서드들이 스레드 안전하지 않은 것으로 명시되어 있으므로, CpuSelector의 동일한 인스턴스에 대한 동시 접근은 호출자에 의해 동기화되어야 할 것으로 보입니다. 질문 Q-fced1ce242dea2c2 (열림) 수명 주기가 끝나면 선택기는 별도의 롤백 절차 없이 해제됩니다.

사용 경로

CpuSelector와의 일반적인 상호작용에는 개별 후보에 대한 개별 평가 또는 최적 대상 장치에 대한 직접적인 조회가 포함됩니다. 후보 검증을 위해 호출자는 장치 참조를 operator()(const Device &device) [AP_SWS_SHWA_00409]에 전달합니다. operator()이(가) ara::core::Result<int>(으)로 반환하는 값은 전달된 Device에 대한 수치적 평가 메트릭(Score)을 나타낼 것으로 보이며, 이를 바탕으로 여러 장치를 비교할 수 있습니다. 질문 Q-33885b34ba761592 (열림)

애플리케이션이 선택을 전적으로 전략에 위임하고자 하는 경우 SelectDevice()을(를) 호출합니다 [AP_SWS_SHWA_00410]. 이 메서드는 내부적으로 적절한 장치를 결정하고, 선택된 대상 장치를 캡슐화하는 ara::core::Result<Device>을(를) 반환합니다.

시퀀스 다이어그램: CpuSelector를 통한 대상 장치 평가 및 선택의 일반적인 흐름. 출처: [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

오류 시나리오

두 메서드 모두 noexcept(으)로 선언되어 완전한 예외 안전성(exception safe)을 보장합니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410]. 발생하는 오류 조건은 C++ 예외를 통해 보고되지 않고, ara::core::Result의 오류 도메인을 통해 반환됩니다.

두 메서드에 대해 ShwaErrorCode의 다음 오류 값이 명시되어 있습니다:

• ShwaErrorCode::kResourceBusy: 대상 리소스가 현재 사용 중이어서 평가 또는 선택을 실행할 수 없습니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].
• ShwaErrorCode::kFeatureNotSupported: 요청된 장치 속성 또는 선택기 기능을 시스템에서 지원하지 않습니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

operator()의 전제 조건으로 유효한 Device 참조가 준비되어 있어야 합니다. 두 함수 모두 롤백 시맨틱을 배제하므로(no_rollback_semantics), 오류 발생 시 이전 시스템 상태에 대한 자동 정리가 수행되지 않습니다 [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].