구조체 ara::diag::CounterBased

ara::diag::CounterBased 구조체는 진단 이벤트의 카운터 기반 디바운싱을 위한 임계값, 스텝 크기 및 점프 매개변수를 정의합니다[SWS_DM_00538]. 이는 애플리케이션에 의해 인스턴스화되고 결함 및 정상 판정 기준을 정의하기 위해 ara::diag::Monitor의 생성자로 전달됩니다[SWS_DM_00549]. Diagnostic Management는 Diagnostic Extract(DEXT)에 우선순위가 있는 디바운싱 데이터가 저장되어 있지 않은 한 이 매개변수를 사용하여 카운터를 업데이트합니다.

자세히 ›

컨텍스트

ara::diag::CounterBased 구조체는 AUTOSAR Adaptive Platform 사양SWS Diagnostics §7.3.4.1.5.1 “Counter-based debouncing”에 따른 진단 이벤트의 카운터 기반 디바운싱[SWS_DM_00538]을 위한 구성 매개변수를 나타냅니다. 진단 하위 시스템 내에서 이는 적용되는 모니터 구현과 Diagnostic Management(DM) 간에 디바운싱 매개변수를 교환하는 역할을 합니다.

상호작용은 기본적으로 네 개의 인터페이스 파트너를 통해 이루어집니다:

• 진단 애플리케이션은 CounterBased을 인스턴스화하고 이벤트 한계값을 채웁니다.
• ara::diag::Monitor의 모니터 생성자는 모니터 내부 디바운싱을 설정하기 위해 구조체를 구성 인수로 수신합니다[SWS_DM_00549], SWS Diagnostics §8.40.1.1.2.2 “Monitor constructor for Monitors with Monitor-internal debouncing”.
• Diagnostic Extract(DEXT)는 상위 디바운싱 매개변수를 정의합니다. DEXT에 일치하는 매개변수가 존재하면 해당 매개변수가 반드시 우선하며, 생성자를 통해 전달된 값은 DM에 의해 무시됩니다[SWS_DM_01099].
• Diagnostic Management는 DEXT 구성이 없는 경우 CounterBased의 값을 평가하고[SWS_DM_01101] 런타임에 이벤트별 카운터를 유지 관리합니다SWS Diagnostics §7.3.4.1.5.1 “Internal debounce counter incrementation”.

컨텍스트 다이어그램: 애플리케이션, Monitor, CounterBased, Diagnostic Management 및 DEXT의 상호작용. 출처: [SWS_DM_00538], [SWS_DM_00549], [SWS_DM_01099], [SWS_DM_01101].

수명 주기

C++ 데이터 구조(struct)인 SWS Diagnostics §8.41.2 “Struct: CounterBased”, CounterBased는 순수 값 컨테이너로서 적용 소프트웨어 컴포넌트에 의해 스택 또는 힙에 생성됩니다. 해당 수명주기는 일반적으로 ara::diag::Monitor 생성 전의 구성 및 초기화 단계로 제한됩니다.

속성이 정의된 후 구조체는 값으로 Monitor의 생성자에 전달됩니다[SWS_DM_00549]. 구조체 자체는 내부 동적 상태를 유지하지 않으며 상태 머신도 없습니다. 지속적인 카운터 관리는 전적으로 Diagnostic Management의 몫입니다. CounterBased는 수동적 데이터 구조로 설계되었고 내부 동기화 메커니즘이 없으므로, 해석상 모니터로 전달하기 전에 구성을 스레드 로컬 또는 동기화된 방식으로 수행해야 합니다.

사용 경로

일반적인 사용법은 디바운싱 매개변수 정의, 모니터로의 전달, 런타임 카운터 평가로 나뉩니다:

1. 애플리케이션은 CounterBased의 인스턴스를 생성하고 결함 판정을 위한 failedThreshold[SWS_DM_00621] 및 정상 인식을 위한 passedThreshold[SWS_DM_00622]과 같은 한계값을 설정합니다.
2. 스텝 크기는 보고된 결함 상태를 위한 failedStepsize[SWS_DM_00623] 및 정상 보고를 위한 passedStepsize[SWS_DM_00624]를 통해 정의됩니다.
3. 선택적으로 점프 조정이 구성됩니다. useJumpToFailed [SWS_DM_00627] 및 failedJumpValue [SWS_DM_00625]을 통해 최소 결함 값으로의 점프가 활성화됩니다. 마찬가지로 useJumpToPassed [SWS_DM_00628] 및 passedJumpValue [SWS_DM_00626]은 정상 상태 방향으로의 점프를 제어합니다.
4. 채워진 구조체는 Monitor의 생성자에 전달됩니다[SWS_DM_00549]. DEXT 정의가 없는 경우 DM은 이러한 값을 사용합니다[SWS_DM_01101].
5. 런타임에 모니터링은 ReportMonitorAction을 통해 모니터 동작을 보고합니다SWS Diagnostics §7.3.4.1.5.1 “Internal debounce counter incrementation”. kPrefailed의 경우 DM은 모든 점프 조건을 검사하고[SWS_DM_00022] 카운터를 failedStepsize만큼 증가시킵니다[SWS_DM_00875].
6. 카운터가 failedThreshold에 도달하면 DM은 이벤트를 kFinallyDefective로 분류합니다[SWS_DM_00024]. passedStepsize을 통한 정상 보고에도 동일하게 적용됩니다[SWS_DM_00876].

시퀀스 다이어그램: 매개변수 구성 및 모니터 초기화부터 카운터 판정까지의 절차. 출처: [SWS_DM_00549], [SWS_DM_00875], [SWS_DM_00022], [SWS_DM_00024].

오류 시나리오

CounterBased을 사용할 때는 몇 가지 제약 조건과 우선순위 규칙을 준수해야 합니다:

• DEXT 우선순위 충돌: DEXT에 디바운싱 매개변수가 있는 경우 DM은 CounterBased에 정의된 매개변수를 완전히 무시합니다[SWS_DM_01099]. 정적 DEXT 값이 활성 상태임에도 애플리케이션 개발자가 생성자를 통한 동적 매개변수 변경을 기대할 때 잘못된 구성이 발생합니다.
• DEXT 값 누락: DEXT에 정보가 없는 경우 DM은 생성자가 유효한 CounterBased 인스턴스를 제공하는 데 반드시 의존해야 합니다[SWS_DM_01101].
• 임계값 초과: failedStepsize의 가산으로 인해 내부 디바운싱 카운터가 임계값 failedThreshold을 초과하여 증가하는 경우, DM은 카운터를 정확히 이 임계값으로 재설정하고 결함을 판정합니다[SWS_DM_00024], [SWS_DM_00875].
• 조건부 점프 로직: useJumpToFailed이 설정된 경우 증가 전 카운터 값이 failedJumpValue보다 진성으로 작을 때만 failedJumpValue로의 점프가 실행됩니다[SWS_DM_00022]. useJumpToPassed의 경우에도 마찬가지로 카운터가 passedJumpValue보다 커야 합니다[SWS_DM_00023].