클래스 ara::diag::MultipleMonitor

사용

메서드 ara::diag::MultipleMonitor::ConfigureMonitor는 모니터 내부 디바운싱을 위한 진단 모니터를 초기화합니다 [SWS_DM_01696]. 매개변수 monitorHandle를 통해 구성할 모니터가 지정되며, initMonitor을 통해서는 재초기화를 위한 알림 콜백이, getFaultDetectionCounter를 통해서는 현재 오류 카운터 값(FDC)을 조회하기 위한 함수가 등록됩니다 [SWS_DM_01696]. 실행은 동기식으로 이루어지며 ara::core::Result<void>을(를) 반환합니다 AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 “ConfigureMonitor”.

오류 처리 및 동시성

오류 발생 시 오류 결과 DiagErrc::kInvalidArgument이(가) 반환됩니다 [SWS_DM_01696]. 이는 특히 유효하지 않은 함수 포인터가 전달되거나 내부 디바운싱 시 호환되지 않는 상태가 존재할 때 발생할 것으로 보입니다(해석). 질문 Q-3de0f2b0cc427ef3 (열림) 해당 연산은 noexcept 및 예외 안전(exception safe)으로 명시되어 있으나, 명시적으로 스레드 안전하지 않음(not thread-safe)으로 표시되어 있습니다 [SWS_DM_01696]. 따라서 동일한 모니터 인스턴스에 대한 호출은 애플리케이션 측에서 동기화되어야 합니다.

순서 및 상호작용

ConfigureMonitor의 각 오버로드는 하나의 모니터에 대해 정확히 한 번만 호출될 수 있으며, 모니터는 이 초기화 단계를 거친 후에야 비로소 사용 준비가 완료됩니다 [SWS_DM_01696]. 모니터 내부 디바운싱의 경우, 진단 모니터 애플리케이션이 디바운싱 로직을 자체적으로 처리하고 최종 결과만을 Diagnostic Management로 전달합니다 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 “Monitor-internal debouncing”. 다른 디바운싱 메커니즘을 위해 시간 기반 [SWS_DM_01697], 카운터 기반 [SWS_DM_01702] 또는 디바운싱되지 않는 모니터링 [SWS_DM_01973]을 위한 대체 오버로드가 제공됩니다.

사용

헤더 파일 ara/diag/multiple_monitor.h의 동기 멤버 함수 ara::diag::MultipleMonitor::ConfigureMonitor는 시간 기반 디바운싱([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)”)을 사용하는 진단 모니터를 구성합니다. 호출 시 모니터 식별을 위한 핸들 monitorHandle, InitMonitorNotifier 타입의 콜백 함수 initMonitor, TimeBased 타입의 디바운싱 매개변수 defaultValues이(가) 전달됩니다([SWS_DM_01697]). 반환값으로는 ara::core::Result<void>이(가) 사용되며, 함수 시그니처는 noexcept(으)로 선언되어 있습니다([SWS_DM_01697]).

호출 조건 및 동시성

모니터는 이 초기화 단계가 완료된 후에야 비로소 사용될 수 있습니다([SWS_DM_01697]). ConfigureMonitor의 각 오버로드된 변형은 모니터 인스턴스당 정확히 한 번만 호출되어야 합니다([SWS_DM_01697]). 이 인터페이스는 예외 안전(exception safe)하지만 스레드 안전하지는 않으므로(not thread-safe), 동일한 인스턴스에 대한 병렬 호출은 사용자 측에서 동기화해야 합니다([SWS_DM_01697]).

오류 처리

구성에 실패하면 호출은 ara::core::Result 내의 오류 객체, 특히 오류 코드 DiagErrc::kInvalidArgument을(를) 반환합니다([SWS_DM_01697]).

상호 작용

이 메서드는 카운터 기반 디바운싱([SWS_DM_01702]), 모니터 내부 디바운싱([SWS_DM_01696]) 및 디바운싱이 없는 모니터([SWS_DM_01973])를 위한 대체 초기화 함수들을 보완합니다. 시간 기반으로 디바운싱되는 이벤트의 경우, Diagnostic Manager는 디바운싱 타이머의 선택적 고정([SWS_DM_00880]) 및 고정된 상태로부터의 추후 재개([SWS_DM_00038])도 지원합니다.

클래스 ara::diag::MultipleMonitor의 동기 메서드 ConfigureMonitor는 카운터 기반 디바운싱([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 “ConfigureMonitor”)을 사용하는 진단 모니터의 초기화에 사용됩니다. 선언은 헤더 파일 ara/diag/multiple_monitor.h을(를) 통해 제공됩니다([SWS_DM_01702]).

사용법 및 매개변수

이 함수는 다음과 같은 전달 매개변수를 받습니다([SWS_DM_01702]):

• monitorHandle (MonitorHandleType): 구성할 진단 모니터를 식별합니다.
• initMonitor (InitMonitorNotifier): 모니터 초기화를 위한 알림 콜백 함수를 등록합니다.
• defaultValues (CounterBased): 카운터 기반 디바운싱을 위한 기본 구성 값을 전달합니다.

연산은 반환값으로 성공 또는 오류에 대한 정보를 제공하는 ara::core::Result<void>을(를) 반환합니다([SWS_DM_01702]).

오류 처리

구성에 실패하면 반환값에 오류가 보고됩니다. 유효하지 않은 인수가 전달된 경우 오류 코드 DiagErrc::kInvalidArgument이(가) 반환됩니다([SWS_DM_01702]). 이 함수는 noexcept(으)로 선언되어 있으며 예외 안전성(exception safe)을 보장합니다([SWS_DM_01702]).

동시성 및 제약사항

ConfigureMonitor의 각 오버로드는 모니터에 대해 반드시 정확히 한 번만 호출되어야 하며, 모니터는 이 초기화 단계를 거친 후에만 사용할 수 있습니다([SWS_DM_01702]). 해당 연산이 스레드 안전하지 않음(not thread-safe)으로 분류되어 있으므로([SWS_DM_01702]), 스레드 경계를 넘어 호출이 발생하는 경우 외부 동기화가 필요할 것으로 보입니다(해석). 질문 Q-fcb809ccb021dd6d (열림)

상호 작용

이 메서드는 MultipleMonitor의 구성 인터페이스의 일부입니다. 이는 TimeBased을(를) 사용하는 시간 기반 디바운싱([SWS_DM_01697]), 판독 기능을 갖춘 모니터 내부 디바운싱([SWS_DM_01696]), 디바운싱 메커니즘이 전혀 없는 모니터([SWS_DM_01973])를 위한 관련 오버로드들을 보완합니다.

동기 메서드 ConfigureMonitor는 ara::diag::MultipleMonitor 내에서 디바운싱이 없는 진단 모니터를 초기화하는 역할을 합니다([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 “ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)”). 이 메서드는 입력 매개변수로 모니터의 핸들(monitorHandle)과 InitMonitorNotifier 알림을 등록하기 위한 콜백 함수(initMonitor)를 받습니다([SWS_DM_01973]). 이 필수 초기화 단계를 거친 후에야 비로소 해당 모니터를 활성 상태로 사용할 수 있습니다([SWS_DM_01973]).

호출 컨텍스트 및 동시성과 관련하여 다음과 같은 제약 조건이 적용됩니다:

• ConfigureMonitor의 각 오버로드는 개별 모니터마다 정확히 한 번만 호출되어야 합니다([SWS_DM_01973]).
• 이 메서드는 exception safe(으)로 명시되어 있으나 not thread-safe(으)로 분류되어 있습니다([SWS_DM_01973]). 따라서 동일한 모니터에 대한 동시 접근에는 애플리케이션에 의한 외부 동기화가 필요할 것으로 보입니다. 질문 Q-2272f26f380a5a11 (열림)

이 함수는 결과로 ara::core::Result<void>을(를) 반환합니다([SWS_DM_01973]). 구성에 실패하면 예를 들어 DiagErrc::kInvalidArgument와(과) 같은 오류가 반환됩니다([SWS_DM_01973]). 진단 모니터에 디바운싱 방식이 필요한 경우에는 대신 모니터 내부 디바운싱([SWS_DM_01696]), 시간 기반 디바운싱([SWS_DM_01697]) 또는 카운터 기반 디바운싱([SWS_DM_01702])을 위한 오버로드된 변형이 제공됩니다.

함수 Offer은(는) Diagnostic Management Daemon(DM)에서 해당 핸들러로 들어오는 진단 요청의 전달을 활성화합니다 [SWS_DM_01699]. 이 동기식 호출은 매개변수가 없으며 예외 안전성(exception safe)을 갖춘 noexcept(으)로 지정되어 있습니다 [SWS_DM_01699].

성공 시 이 함수는 빈 ara::core::Result<void>을(를) 반환합니다 [SWS_DM_01699]. 핸들러에 대한 등록이 이전에 이미 성공적으로 실행된 경우, 호출이 실패하고 롤백 시맨틱을 갖는 오류 코드 DiagOfferErrc::kAlreadyOffered을(를) 반환합니다 [SWS_DM_01699]. 이 오류 상태는 진단 오류 도메인에 정의되어 있습니다 [SWS_DM_00514].

동시성과 관련하여 이 메서드는 not thread-safe로 선언되어 있습니다 [SWS_DM_01699]. 해석: 등록 상태의 불일치를 방지하기 위해, 동일한 핸들러 인스턴스에 대한 호출이 서로 다른 스레드에서 보호되지 않은 상태로 발생해서는 안 될 것으로 보입니다. 질문 Q-95f2e0895004c73b (열림)

Offer 메서드의 패턴은 일반 루틴 [SWS_DM_00557] 또는 UDS 서비스 [SWS_DM_00619] 등에서 유사하게 사용되는 AUTOSAR Adaptive의 진단 핸들러용 표준화된 제공 메커니즘과 일치합니다. 이름은 ara::com의 서비스 제공을 참조하였지만, 독립적인 진단 전용 구현입니다 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

함수 [SWS_DM_01698]은(는) ara::diag::MultipleMonitor에서 특정 진단 모니터의 상태 정보 및 디바운스 명령을 Diagnostic Manager(DM)에 보고하는 데 사용됩니다. 매개변수 monitorHandle을(를) 통해 대상 모니터가 어드레싱되는 반면, action은(는) (비)한정된 테스트 결과 또는 디바운싱 및 사전 저장을 위한 명령을 전달합니다.

오류 동작과 관련하여 유효하지 않은 monitorHandle을(를) 사용한 호출은 DM에 의해 무시됩니다 [SWS_DM_01698]. 구성된 디바운스 절차에서 지원하지 않는 동작이 전달되면 DM은 위반(Violation)을 발생시킵니다 [SWS_DM_01988]. 또한 Enable 조건을 충족하지 못하면 메시지가 폐기될 수 있으며(AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 “EnableConditions”), 이는 내부 오류 코드와 일치합니다 [SWS_DM_00514].

동시성 및 실행 정보:

• 이 메서드는 noexcept(으)로 선언되어 있으므로 예외에 안전합니다 [SWS_DM_01698].
• 스레드 안전성은 조건부입니다: 호출이 스레드 안전해야 하는지 여부는 생성자에 전달된 ConcurrencyType을(를) 통해 결정됩니다 [SWS_DM_01698].
• 카운터 기반 디바운싱과의 상호작용에서, 예를 들어 메시지 kPrefailed은(는) 내부 카운터의 증가로 이어집니다 [SWS_DM_00875]. 해석: 개별 모니터에 대해 정의된 디바운스 메커니즘 및 Enable 조건은 핸들을 통해 제어되는 다중 인스턴스에도 동일하게 적용될 것으로 추정됩니다. 질문 Q-ff29529143d35ca2 (열림)

ara::diag::MultipleMonitor 클래스의 StopOffer 메서드는 Diagnostic Management(DM)로부터의 요청 메시지가 핸들러로 전달되는 것을 비활성화하는 데 사용됩니다 [SWS_DM_01700]. 이는 인터페이스 제공의 기능적 대응물 역할을 하며, 애플리케이션이 들어오는 진단 요청의 처리를 선택적으로 중단할 수 있도록 합니다.

사용 시 다음과 같은 특성 및 제약 조건이 적용됩니다:

• 시그니처 및 호출 컨텍스트: 이 함수는 헤더 ara/diag/multiple_monitor.h을(를) 통해 선언되며 void StopOffer() noexcept; [SWS_DM_01700] 시그니처를 가집니다. 매개변수를 받지 않으며 반환값을 제공하지 않습니다. 호출은 동기식으로 실행됩니다.
• 오류 처리: 이 메서드는 noexcept(으)로 지정되어 있으며 예외 안전(exception safe)합니다 [SWS_DM_01700]. 예외를 발생시키지 않으며 특정 오류 코드나 오류 메시지를 제공하지 않습니다.
• 동시성: 이 요소는 명시적으로 스레드 안전하지 않음(not thread-safe)으로 분류되어 있습니다 [SWS_DM_01700]. 동일한 인스턴스에 대한 동시 호출은 애플리케이션에 의해 외부에서 동기화되어야 할 것으로 보입니다. 질문 Q-b73ead392f8b95b2 (열림)

StopOffer의 시맨틱은 Offer 및 StopOffer을(를) 통해 서비스가 제어되는 AUTOSAR Adaptive의 진단 핸들러용 표준화된 설계 패턴을 따릅니다 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”. 요청 전달 비활성화의 동일한 원칙은 일반 루틴 [SWS_DM_00558] 및 UDS 서비스 [SWS_DM_00620]뿐만 아니라 ara::diag::Monitor::StopOffer [SWS_DM_01089]와(과) 같은 관련 포트에서도 찾아볼 수 있습니다.