DEENESPTFRRUARHIKOZHNL

clase 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"
Scopenamespace apext::phm

Guía del usuarioGENERADO POR IA

Conecta el control del watchdog de hardware y la reacción ante errores con Platform Health Management.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: ead3ce845973 Procedencia Preguntas abiertas (3)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Conecta el control del watchdog de hardware y la reacción ante errores con Platform Health Management.

La clase apext::phm::WatchdogInterface, como extensión de la plataforma, constituye la interfaz entre Platform Health Management y el watchdog físico de hardware. En funcionamiento normal, PHM notifica a la interfaz cíclicamente mediante AliveNotification(); en ausencia de dicha notificación, la interfaz debe desencadenar de forma autónoma una reacción del watchdog [SWS_PHM_01255]. En caso de errores críticos del sistema, PHM también puede forzar inmediatamente una reacción ante errores del hardware del watchdog mediante FireWatchdogReaction() [SWS_PHM_01256]. Como restricción central, ambos métodos están especificados como seguros para hilos, pero no como seguros ante excepciones.

Contexto

La clase C++ apext::phm::WatchdogInterface representa en el Platform Health Management (PHM) de AUTOSAR Adaptive la interfaz con el hardware físico del watchdog. Al ser una extensión de plataforma (PlatformExtension), no mapea una interfaz de puerto AUTOSAR modelada, sino que sirve de puente específico del fabricante entre el servicio PHM y el hardware subyacente. PHM supervisa la ejecución de procesos y componentes de la plataforma. Para cubrir de forma fiable también una caída o un bloqueo del propio PHM, WatchdogInterface conecta la supervisión externa o interna por hardware. A través del método AliveNotification(), PHM notifica cíclicamente su operatividad a la interfaz [SWS_PHM_01255]. Si se produce un error crítico del sistema, PHM puede solicitar de forma específica la reacción ante errores del lado del hardware mediante la función FireWatchdogReaction() [SWS_PHM_01256].

WatchdogKontext PHM PHM WatchdogInterface WatchdogInterface PHM->WatchdogInterface AliveNotification() / FireWatchdogReaction() HardwareWatchdog HardwareWatchdog WatchdogInterface->HardwareWatchdog Triggerung / Watchdog-Reaktion

Diagrama de contexto: integración de WatchdogInterface entre PHM y el watchdog de hardware. Fuentes: [SWS_PHM_01255], [SWS_PHM_01256]

Ciclo de vida

Dado que apext::phm::WatchdogInterface actúa como extensión de plataforma, es probable que la instanciación de la implementación de la interfaz y la vinculación con el controlador de hardware se realicen de forma específica de la plataforma durante la inicialización del servicio PHM. Pregunta Q-c2235d5c87e0a675 (abierta) La vida útil de la instancia suele estar vinculada al tiempo de ejecución de PHM, de modo que no se prevé un ciclo de vida dinámico con creación o destrucción múltiple durante el funcionamiento de la plataforma. Con respecto a la concurrencia, ambas funciones de interfaz AliveNotification() y FireWatchdogReaction() están declaradas explícitamente como seguras para hilos (thread-safe) [SWS_PHM_01255], [SWS_PHM_01256]. Esto permite que PHM transmita señales de vida y notificaciones de error a la interfaz del watchdog desde diferentes hilos de trabajo internos en paralelo y sin sincronización en el lado llamador.

Ruta de uso

La interacción típica entre PHM y la interfaz se divide en el ciclo de supervisión regular y la escalada de errores:

  • Notificación cíclica de señales de vida: PHM llama a AliveNotification() de forma periódica dentro de un tiempo de ciclo configurado [SWS_PHM_01255]. Este tiempo de ciclo no tiene por qué coincidir con el período real de activación (trigger) del hardware; es probable que la implementación almacene en búfer o escale internamente los intervalos para el control del watchdog físico [SWS_PHM_01255]. Pregunta Q-a6c08f102f09c8c1 (abierta)
  • Disparo por hardware: WatchdogInterface se encarga de atender a tiempo la unidad de watchdog de hardware cuando las notificaciones son regulares.
  • Indicación específica de error: Si PHM detecta un estado no recuperable en las entidades supervisadas, llama inmediatamente a FireWatchdogReaction() [SWS_PHM_01256].
Supervisión cíclica y activación de la reacción del watchdogPHMWatchdogInterfaceHardware-WatchdogUse Case: Ciclo de supervisión regularloopKonfigurierte ZykluszeitAliveNotification()Hardware-Watchdog bedienenUse Case: FehlerfallaltPHM fordert Fehlerreaktion anFireWatchdogReaction()Desencadenar reacción del watchdogEl mensaje de vida no llega (timeout)Timeout erkennenDesencadenar reacción del watchdog

Diagrama de secuencia: transmisión periódica de señales de vida y activación de la reacción del watchdog. Fuentes: [SWS_PHM_01255], [SWS_PHM_01256]

Escenarios de error

La interfaz admite dos mecanismos complementarios para el tratamiento de fallos del sistema:

Por un lado, una ausencia pasiva de notificaciones provoca una reacción del sistema: si PHM no envía una notificación mediante AliveNotification() dentro del intervalo de tiempo configurado, WatchdogInterface tiene la obligación de iniciar de forma autónoma la reacción del watchdog [SWS_PHM_01255]. De este modo, las caídas o bloqueos mutuos del propio servicio PHM quedan interceptados de manera fiable por el hardware.

Por otro lado, existe la ruta de error activa: mediante la llamada explícita a FireWatchdogReaction() se desencadena una reacción ante errores definida del watchdog [SWS_PHM_01256]. En ambos casos, el impacto final a nivel de sistema consistiría típicamente en un reinicio por hardware o en la transición a un estado seguro. Pregunta Q-817baa072cc94a19 (abierta)

En cuanto al comportamiento ante errores en el código, ambas funciones miembro están especificadas como no seguras ante excepciones (not exception safe) [SWS_PHM_01255], [SWS_PHM_01256]. Por lo tanto, el componente llamador no puede apoyarse en garantías de manejo de excepciones, y la implementación de la interfaz no debe emitir excepciones C++ no controladas.

Esta guía resume la especificación de apext::phm::WatchdogInterface conforme a AUTOSAR Adaptive R25-11.

Diagrama de clases UML

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

G napext__phm__WatchdogInterface47 WatchdogInterface + AliveNotification() + FireWatchdogReaction()

Métodos

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 ();

Interface to fire an error reaction of the Watchdog.

void FireWatchdogReaction ();

Documentación de los métodos

función AliveNotification [SWS_PHM_01255] Upstream: RS_PHM_00101, RS_PHM_09240

void 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

GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: cb75c45d42c3 Procedencia Preguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

La función AliveNotification de la cabecera apext/phm/watchdog_interface.h pertenece a la clase apext::phm::WatchdogInterface y sirve para la supervisión cíclica de actividad de Platform Health Management (PHM) [SWS_PHM_01255]. La interfaz posee la firma void AliveNotification(), no recibe parámetros y no devuelve ningún valor [SWS_PHM_01255].

Contexto de invocación y comportamiento temporal

La invocación de AliveNotification se realiza periódicamente por PHM en un tiempo de ciclo configurable [SWS_PHM_01255]. Esta frecuencia de invocación está desacoplada lógicamente del control del watchdog de hardware físico real, de modo que el periodo configurado de PHM puede diferir del tiempo de disparo del watchdog de hardware [SWS_PHM_01255].

Reacción ante fallos y escenarios de fallo

Si PHM no notifica con éxito su actividad dentro del intervalo de tiempo configurado para ello, el WatchdogInterface tiene la instrucción de iniciar una reacción de watchdog [SWS_PHM_01255]. No se prevén códigos de error específicos. Interpretación: Dado que la interfaz está clasificada como no segura frente a excepciones, es probable que los estados de error imprevistos se propaguen como excepciones de C++ al contexto del invocador [SWS_PHM_01255]. Pregunta Q-a9e59a992db9913f (abierta)

Concurrencia y seguridad frente a excepciones

La función está especificada como segura para subprocesos (thread-safe), por lo que se permiten los accesos paralelos, pero se considera no segura frente a excepciones (not exception safe) [SWS_PHM_01255].

Este texto ha sido elaborado por una IA y sintetiza el estado de la especificación de AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
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#85051b0c
Content hash
85051b0c
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

función FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

void FireWatchdogReaction ();

Interface to fire an error reaction of the Watchdog.

GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 28a89e0724c4 Procedencia Preguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

La función FireWatchdogReaction sirve como interfaz dedicada dentro del módulo Platform Health Management (PHM) para desencadenar selectivamente una reacción de error del watchdog [SWS_PHM_01256]. Está asignada al alcance de la clase apext::phm::WatchdogInterface y se proporciona mediante el archivo de cabecera apext/phm/watchdog_interface.h [SWS_PHM_01256].

Al utilizarla deben tenerse en cuenta los siguientes aspectos:

  • Invocación e interfaz: Con la firma void FireWatchdogReaction ();, la función no recibe parámetros de entrada ni devuelve ningún valor [SWS_PHM_01256]. La invocación desencadena de inmediato la reacción de error del watchdog.
  • Concurrencia: La operación está especificada como thread-safe [SWS_PHM_01256]. Por consiguiente, se permite invocarla concurrentemente desde múltiples subprocesos sin sincronización externa adicional.
  • Seguridad frente a excepciones y tratamiento de errores: La función está declarada como not exception safe [SWS_PHM_01256]. Interpretación: Dado que no se garantiza la seguridad frente a excepciones, es probable que las excepciones que ocurran en caso de error se propaguen directamente al invocador, por lo que este debería estar preparado para posibles excepciones. Pregunta Q-f53d689332369cd7 (abierta)

La función ofrece así un punto de acceso estandarizado para intervenir activamente en el comportamiento del watchdog ante errores graves y poner en marcha medidas de protección definidas [SWS_PHM_01256].

Este texto ha sido generado por una IA. Se basa en AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
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#a03eede6
Content hash
a03eede6
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill