클래스 apext::phm::WatchdogInterface

[SWS_PHM_01257] Upstream: RS_PHM_00101

class WatchdogInterface {...};

class for interface to hardware watchdog Note: class WatchdogInterface although identifiable in code as an interface, it is a PlatformExtension - i.e. no modelled interface - nothing to do here

Header-Datei	#include "apext/phm/watchdog_interface.h"
Forwarding-Header	#include "apext/phm/phm_fwd.h"
Scope	namespace apext::phm

사용자 가이드AI 생성

하드웨어 워치독 제어 및 오류 반응을 Platform Health Management에 연결합니다.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ead3ce845973 출처 열린 질문 (3)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

하드웨어 워치독 제어 및 오류 반응을 Platform Health Management에 연결합니다.

apext::phm::WatchdogInterface 클래스는 플랫폼 확장으로서 Platform Health Management와 물리적 하드웨어 워치독 간의 인터페이스를 형성합니다. PHM은 정상 작동 시 AliveNotification()을(를) 통해 인터페이스에 주기적으로 알림을 보내며, 알림이 누락될 경우 인터페이스는 독자적으로 워치독 반응을 트리거해야 합니다 [SWS_PHM_01255]. 심각한 시스템 오류가 발생하는 경우 PHM은 FireWatchdogReaction()을(를) 통해 워치독 하드웨어의 오류 반응을 즉시 강제할 수도 있습니다 [SWS_PHM_01256]. 핵심적인 제약 조건으로서 두 메서드 모두 스레드 안전하지만 예외 안전하지 않은 것으로 명시되어 있습니다.

컨텍스트

C++ 클래스 apext::phm::WatchdogInterface은(는) AUTOSAR Adaptive의 Platform Health Management(PHM)에서 물리적 워치독 하드웨어에 대한 인터페이스를 나타냅니다. 플랫폼 확장(PlatformExtension)으로서 모델링된 AUTOSAR 포트 인터페이스를 묘사하지 않고, PHM 서비스와 기본 하드웨어 사이의 제조사별 브릿지 역할을 합니다. PHM은 프로세스 및 플랫폼 컴포넌트의 실행을 모니터링합니다. PHM 자체의 장애나 교착 상태까지도 안정적으로 보호하기 위해 WatchdogInterface은(는) 외부 또는 내부 하드웨어 모니터링을 연결합니다. AliveNotification() 메서드를 통해 PHM은 인터페이스에 자신의 기능 상태를 주기적으로 보고합니다 [SWS_PHM_01255]. 치명적인 시스템 오류가 발생하는 경우 PHM은 FireWatchdogReaction() 함수를 통해 하드웨어 측 오류 반응을 구체적으로 요청할 수 있습니다 [SWS_PHM_01256].

컨텍스트 다이어그램: PHM과 하드웨어 워치독 사이의 WatchdogInterface 연계. 출처: [SWS_PHM_01255], [SWS_PHM_01256]

수명 주기

apext::phm::WatchdogInterface은(는) 플랫폼 확장으로 작동하므로, 인터페이스 구현체의 인스턴스화 및 하드웨어 드라이버 연결은 PHM 서비스 초기화 중에 플랫폼별로 수행될 것으로 추정됩니다. 질문 Q-c2235d5c87e0a675 (열림) 인스턴스의 수명은 일반적으로 PHM의 실행 시간에 바인딩되므로, 플랫폼 작동 중 다중 생성 또는 소멸을 수반하는 동적 수명 주기는 제공되지 않습니다. 동시성과 관련하여 두 인터페이스 함수 AliveNotification() 및 FireWatchdogReaction()은(는) 모두 명시적으로 스레드 안전(thread-safe)(으)로 선언되어 있습니다 [SWS_PHM_01255], [SWS_PHM_01256]. 이를 통해 PHM은 다양한 내부 워커 스레드의 생존 신호와 오류 메시지를 호출자 측 동기화 없이 병렬로 워치독 인터페이스에 전달할 수 있습니다.

사용 경로

PHM과 인터페이스 간의 일반적인 상호작용은 정기적인 모니터링 주기와 오류 에스컬레이션으로 구분됩니다:

주기적 생존 신호 보고: PHM은 구성된 주기 시간 내에 AliveNotification()을(를) 반복적으로 호출합니다 [SWS_PHM_01255]. 이 주기 시간이 하드웨어의 실제 트리거 주기와 일치할 필요는 없으며, 구현체가 물리적 워치독 제어를 위한 간격을 내부적으로 버퍼링하거나 스케일링할 것으로 추정됩니다 [SWS_PHM_01255]. 질문 Q-a6c08f102f09c8c1 (열림)
하드웨어 트리거링: WatchdogInterface은(는) 정기적인 보고가 있을 때 하드웨어 워치독 장치를 제때 서비스하도록 보장합니다.
목표 오류 표시: PHM은 모니터링 대상 엔티티에서 unrecoverable 상태를 감지하면 즉시 FireWatchdogReaction()을(를) 호출합니다 [SWS_PHM_01256].

시퀀스 다이어그램: 정기적인 생존 신호 전송 및 워치독 반응 트리거. 출처: [SWS_PHM_01255], [SWS_PHM_01256]

오류 시나리오

인터페이스는 시스템 장애 처리를 위한 두 가지 상호 보완적인 메커니즘을 지원합니다:

한편으로 수동적인 메시지 누락은 시스템 반응을 초래합니다. PHM이 구성된 시간 범위 내에 AliveNotification()을(를) 통해 보고하지 않으면, WatchdogInterface은(는) 자체적으로 워치독 반응을 시작해야 할 의무가 있습니다 [SWS_PHM_01255]. 이를 통해 PHM 서비스 자체의 비정상 종료나 데드락을 하드웨어가 안정적으로 방어합니다.

다른 한편으로는 능동적인 오류 경로가 존재합니다. FireWatchdogReaction()의 명시적 호출을 통해 정의된 워치독 오류 반응이 트리거됩니다 [SWS_PHM_01256]. 두 경우 모두 시스템 수준에서의 최종 영향은 일반적으로 하드웨어 리셋 또는 안전 상태로의 전환일 것으로 추정됩니다. 질문 Q-817baa072cc94a19 (열림)

코드 내 오류 동작과 관련하여 두 멤버 함수 모두 예외 안전하지 않은 것(not exception safe)(으)로 명시되어 있습니다 [SWS_PHM_01255], [SWS_PHM_01256]. 따라서 호출 컴포넌트는 어떠한 예외 처리 보장에도 의존할 수 없으며, 인터페이스 구현은 처리되지 않은 C++ 예외를 발생시켜서는 안 됩니다.

이 가이드는 AUTOSAR Adaptive R25-11에 따른 apext::phm::WatchdogInterface 사양을 요약합니다.

UML 클래스 다이어그램

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

이 릴리스에 대한 요소 데이터가 없습니다

메서드

AliveNotification 함수

Called cyclically by PHM in configurable cycle time. Note: This time might differ from the cycle time of triggering the "real" hardware watchdog. If PHM does not report aliveness in configured time, WatchdogInterface shall initiate watchdog reaction

void AliveNotification ();

FireWatchdogReaction 함수

Interface to fire an error reaction of the Watchdog.

void FireWatchdogReaction ();

메서드 문서

함수 AliveNotification [SWS_PHM_01255] Upstream: RS_PHM_00101, RS_PHM_09240

void AliveNotification ();

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: cb75c45d42c3 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

"헤더 apext/phm/watchdog_interface.h의 AliveNotification 함수는 apext::phm::WatchdogInterface 클래스에 속하며 Platform Health Management(PHM)의 주기적인 활성 모니터링에 사용됩니다 [SWS_PHM_01255]. 인터페이스는 void AliveNotification() 시그니처를 가지며, 매개변수를 받지 않고 값을 반환하지 않습니다 [SWS_PHM_01255]."

"호출 컨텍스트 및 시간 동작"

"AliveNotification의 호출은 구성 가능한 주기 시간에 따라 PHM에 의해 주기적으로 수행됩니다 [SWS_PHM_01255]. 이 호출 주기는 실제 물리적 하드웨어 워치독의 제어와 논리적으로 분리되어 있으므로, PHM의 구성된 주기는 하드웨어 워치독의 트리거 시간과 다를 수 있습니다 [SWS_PHM_01255]."

"오류 대응 및 고장 시나리오"

"PHM이 이를 위해 구성된 시간 간격 내에 활성 상태를 성공적으로 보고하지 않으면 WatchdogInterface은(는) 워치독 대응을 시작하도록 지시받습니다 [SWS_PHM_01255]. 특정 오류 코드는 정의되어 있지 않습니다. 해석: 인터페이스가 예외 안전하지 않은 것으로 분류되어 있으므로, 예기치 않은 오류 상태는 C++ 예외로서 호출자 컨텍스트로 전파될 것으로 보입니다 [SWS_PHM_01255]." 질문 Q-a9e59a992db9913f (열림)

동시성 및 예외 안전성

"이 함수는 스레드 안전(thread-safe)한 것으로 명시되어 병렬 접근이 허용되지만, 예외 안전하지 않은 것(not exception safe)으로 간주됩니다 [SWS_PHM_01255]."

"이 텍스트는 AI에 의해 작성되었으며 AUTOSAR Adaptive R25-11의 사양 상태를 요약합니다."

Header-Datei	#include "apext/phm/watchdog_interface.h"
Scope	class apext::phm::WatchdogInterface
Exception-Sicherheit	not exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PHM_01255
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PHM_01255@rel:R25-11#90e4e170
Content hash: 90e4e170
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01255

Status: valid/unmigrated Version: rel:R25-11#3204f230 Versionshistorie & Revisions (1 transition, 3 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PHM_01255@rel:R25-11#3204f230

Recorded Revisions (3):

R25-11rel:R25-11#756ef89a2026-09-30
R24-11rel:R24-11#b0affe0c2026-10-14
R25-11rel:R25-11#3204f2302026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

void FireWatchdogReaction ();

Interface to fire an error reaction of the Watchdog.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 28a89e0724c4 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

"FireWatchdogReaction 함수는 Platform Health Management(PHM) 모듈 내의 전용 인터페이스 역할을 하여 워치독의 오류 대응을 의도적으로 트리거합니다 [SWS_PHM_01256]. 이 함수는 apext::phm::WatchdogInterface 클래스의 스코프에 할당되어 있으며 헤더 파일 apext/phm/watchdog_interface.h을(를) 통해 제공됩니다 [SWS_PHM_01256]."

사용 시 다음 사항에 유의해야 합니다:

"호출 및 인터페이스: void FireWatchdogReaction (); 시그니처를 가진 이 함수는 전달 매개변수를 받지 않으며 반환값을 제공하지 않습니다 [SWS_PHM_01256]. 호출 즉시 워치독의 오류 대응이 시작됩니다."
"동시성: 작업은 thread-safe(으)로 명시되어 있습니다 [SWS_PHM_01256]. 따라서 추가적인 외부 동기화 없이 여러 스레드에서 동시에 호출할 수 있습니다."
"예외 안전성 및 오류 처리: 함수는 not exception safe(으)로 선언되어 있습니다 [SWS_PHM_01256]. 해석: 예외 안전성이 보장되지 않으므로 오류 발생 시 나타나는 예외는 호출자에게 직접 전파될 것으로 보이며, 따라서 호출자는 가능한 예외에 대비해야 합니다." 질문 Q-f53d689332369cd7 (열림)

"따라서 이 함수는 심각한 오류 발생 시 워치독의 동작에 적극적으로 개입하여 정의된 보호 조치를 실행할 수 있는 표준화된 접근 지점을 제공합니다 [SWS_PHM_01256]."

"이 텍스트는 AI에 의해 생성되었습니다. 이는 AUTOSAR Adaptive R25-11을 기반으로 합니다."

Header-Datei	#include "apext/phm/watchdog_interface.h"
Scope	class apext::phm::WatchdogInterface
Exception-Sicherheit	not exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PHM_01256
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PHM_01256@rel:R25-11#c87e2a9c
Content hash: c87e2a9c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01256

Status: valid/unmigrated Version: rel:R25-11#9d382947 Versionshistorie & Revisions (1 transition, 3 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PHM_01256@rel:R25-11#9d382947

Recorded Revisions (3):

R25-11rel:R25-11#8b20aac12026-09-30
R24-11rel:R24-11#e80c13872026-10-14
R25-11rel:R25-11#9d3829472026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

클래스 apext::phm::WatchdogInterface

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

UML 클래스 다이어그램

메서드

메서드 문서

함수 AliveNotification [SWS_PHM_01255] Upstream: RS_PHM_00101, RS_PHM_09240

"호출 컨텍스트 및 시간 동작"

"오류 대응 및 고장 시나리오"

동시성 및 예외 안전성

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: