클래스 ara::shwa::DeviceMonitor

ara::shwa::DeviceMonitor 클래스는 shwa 기능 클러스터에서 하드웨어 장치 상태의 동기식 모니터링을 위해 사용됩니다. 인스턴스는 장치 참조를 기반으로 정적 팩토리 메서드 Create을(를) 통해 생성되며([AP_SWS_SHWA_01407]), 이후 Status() 메서드를 통해 지속적으로 장치 상태를 쿼리할 수 있습니다([AP_SWS_SHWA_01409]). 팩토리 메서드를 통한 생성은 스레드 안전하게 실행되지만, 상태 쿼리 호출은 스레드 안전하지 않으므로 병렬 접근 시 아마도 애플리케이션 측의 동기화가 필요합니다. 질문 (열림)

자세히 ›

컨텍스트

클래스 ara::shwa::DeviceMonitor은 모듈 shwa에서 하드웨어 장치의 상태를 모니터링하기 위한 중앙 인터페이스를 제공합니다. 애플리케이션 소프트웨어는 장치 참조 Device 또는 선택기 요소 DeviceSelector을 통해 식별된 하드웨어 컴포넌트의 작동 상태를 조회하기 위해 이 클래스를 사용합니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). 반환 타입 DeviceStatus([AP_SWS_SHWA_01409]) 내에 상태 확인을 캡슐화함으로써, DeviceMonitor은 호출하는 제어 애플리케이션을 내부 하드웨어 세부 정보로부터 분리하고 주소 지정된 장치의 수명 및 오류 주기를 위한 표준화된 옵저버 역할을 합니다.

수명 주기

매개변수가 없는 기본 생성자가 명시적으로 삭제되었으므로([AP_SWS_SHWA_01402]), DeviceMonitor의 인스턴스는 이를 통해 생성할 수 없습니다. 대신 객체 생성은 두 개의 정적 팩토리 메서드 Create(const Device &device)([AP_SWS_SHWA_01407]) 또는 템플릿 함수 Create(const DeviceSelector &deviceSelector)([AP_SWS_SHWA_01408])를 통해 제어된 방식으로 수행됩니다. 두 팩토리 경로는 모두 ara::core::Result<DeviceMonitor>을 반환하고 예외 안전(exception safe)으로 명시되어 있으며 스레드 안전성을 보장합니다.

소유권 및 값 의미론 측면에서 이 클래스는 유연하게 동작합니다. 복사 생성자([AP_SWS_SHWA_01403])와 복사 할당 연산자([AP_SWS_SHWA_01404])뿐만 아니라 이동 생성자([AP_SWS_SHWA_01405])와 이동 할당 연산자([AP_SWS_SHWA_01406])도 표준화된(default) 예외 안전(noexcept) 연산으로 제공됩니다.

동시성 문제에서는 생성과 사용을 엄격히 구분해야 합니다. 팩토리 함수를 통한 생성은 스레드 안전하지만, 조회 메서드 Status()은 명시적으로 스레드 안전하지 않은 것(not thread-safe)으로 선언되어 있습니다([AP_SWS_SHWA_01409]). 여러 스레드가 동일한 인스턴스에 병렬로 접근하는 경우 애플리케이션 측의 동기화가 필요할 것으로 추정됩니다. 질문 Q-4002d6fb6cac23ce (열림)

사용 경로

일반적인 사용 경로는 모니터 인스턴스 생성, 결과 검증, 그리고 반복적인 장치 상태 조회로 나뉩니다. 먼저 애플리케이션은 팩토리 메서드 Create 중 하나를 호출하고 대상 컴포넌트를 전달합니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). 그런 다음 애플리케이션은 결과인 ara::core::Result의 성공 여부를 확인합니다. 객체가 유효하면 메서드 Status()가 호출되며([AP_SWS_SHWA_01409]), 이는 DeviceStatus 타입의 객체를 동기식으로 반환합니다.

시퀀스 다이어그램: 인스턴스화부터 반복적인 상태 조회까지의 일반적인 호출 흐름. 출처: [AP_SWS_SHWA_01407], [AP_SWS_SHWA_01409]

오류 시나리오

오류는 주로 팩토리 메서드 Create을 통한 생성 시 발생하며 C++ 예외 없이 반환 타입 ara::core::Result에서 ShwaErrorCode를 통해 제공됩니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). 생성을 위해 다음과 같은 오류 상태가 정의되어 있습니다:

• ShwaErrorCode::kRuntime: 초기화 중에 일반적인 런타임 오류가 발생했습니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kResourceBusy: 기본 리소스가 현재 사용 중이어서 모니터 생성을 즉시 완료할 수 없습니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kInvalidParameter: 허용되지 않는 장치 사양 등 유효하지 않은 인수가 호출에 전달되었습니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kFeatureNotSupported: 요청된 모니터링 기능이 대상 플랫폼 또는 하드웨어 구성에서 지원되지 않습니다([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).

실행 중 Status() 호출 시 오류 코드나 예외는 제공되지 않습니다. 이 메서드는 noexcept이며 예외 안전성([AP_SWS_SHWA_01409])을 보장합니다. 따라서 하드웨어 장애나 연결 손실은 반환된 상태 값 DeviceStatus에 반영될 것으로 보입니다. 질문 Q-8e2c8c2c7533b36f (열림)