DEENESPTFRRUARHIKOZHNL

classe 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

Guide utilisateurGÉNÉRÉ PAR IA

Raccorde la commande du watchdog matériel et la réaction aux erreurs au Platform Health Management.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : ead3ce845973 Provenance Questions ouvertes (3)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Raccorde la commande du watchdog matériel et la réaction aux erreurs au Platform Health Management.

En tant qu'extension de plateforme, la classe apext::phm::WatchdogInterface constitue l'interface entre le Platform Health Management et le watchdog matériel physique. En fonctionnement normal, le PHM notifie l'interface de manière cyclique via AliveNotification(), l'interface devant déclencher de manière autonome une réaction de watchdog en cas d'absence de message [SWS_PHM_01255]. En cas d'erreurs système critiques, le PHM peut en outre forcer immédiatement une réaction d'erreur du matériel de watchdog via FireWatchdogReaction() [SWS_PHM_01256]. En tant que contrainte centrale, les deux méthodes sont spécifiées sûres pour les threads (thread-safe), mais non sécurisées contre les exceptions.

Contexte

Dans le Platform Health Management (PHM) d'AUTOSAR Adaptive, la classe C++ apext::phm::WatchdogInterface représente l'interface vers le matériel de watchdog physique. En tant qu'extension de plateforme (PlatformExtension), elle ne correspond pas à une interface de port AUTOSAR modélisée, mais sert de pont spécifique au constructeur entre le service PHM et le matériel sous-jacent. Le PHM surveille l'exécution des processus et des composants de plateforme. Afin de sécuriser également de manière fiable une défaillance ou un blocage du PHM lui-même, WatchdogInterface raccorde la surveillance matérielle externe ou interne. Via la méthode AliveNotification(), le PHM signale cycliquement son bon fonctionnement à l'interface [SWS_PHM_01255]. Si une erreur système critique survient, le PHM peut demander de manière ciblée la réaction d'erreur côté matériel via la fonction FireWatchdogReaction() [SWS_PHM_01256].

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

Diagramme de contexte : Intégration de WatchdogInterface entre le PHM et le watchdog matériel. Sources : [SWS_PHM_01255], [SWS_PHM_01256]

Cycle de vie

Comme apext::phm::WatchdogInterface fonctionne comme une extension de plateforme, l'instanciation de l'implémentation d'interface et le raccordement au pilote matériel s'effectuent probablement de façon spécifique à la plateforme pendant l'initialisation du service PHM. Question Q-c2235d5c87e0a675 (ouverte) La durée de vie de l'instance est généralement liée au temps d'exécution du PHM, de sorte qu'aucun cycle de vie dynamique avec création ou destruction multiples pendant le fonctionnement de la plateforme n'est prévu. Concernant la concurrence, les deux fonctions membres de l'interface AliveNotification() et FireWatchdogReaction() sont explicitement déclarées comme sûres pour les threads (thread-safe) [SWS_PHM_01255], [SWS_PHM_01256]. Cela permet au PHM de transmettre des signaux de vie et des messages d'erreur à l'interface de watchdog en parallèle à partir de différents threads de travail internes, sans synchronisation côté appelant.

Parcours d'utilisation

L'interaction typique entre le PHM et l'interface se divise en un cycle de surveillance régulier et une escalade d'erreur :

  • Signalement cyclique de vie : le PHM appelle AliveNotification() de manière récurrente dans les limites d'un temps de cycle configuré [SWS_PHM_01255]. Ce temps de cycle ne doit pas nécessairement correspondre à la période de déclenchement réelle du matériel ; l'implémentation met probablement en mémoire tampon ou met à l'échelle en interne les intervalles pour le pilotage du watchdog physique [SWS_PHM_01255]. Question Q-a6c08f102f09c8c1 (ouverte)
  • Déclenchement matériel : en présence de notifications régulières, WatchdogInterface assure le service dans les délais de l'unité de watchdog matériel.
  • Indication d'erreur ciblée : si le PHM détecte un état non récupérable (unrecoverable) dans les entités surveillées, il appelle immédiatement FireWatchdogReaction() [SWS_PHM_01256].
Surveillance cyclique et déclenchement de la réaction du watchdogPHMWatchdogInterfaceHardware-WatchdogUse Case: Cycle de surveillance régulierloopKonfigurierte ZykluszeitAliveNotification()Hardware-Watchdog bedienenUse Case: FehlerfallaltPHM fordert Fehlerreaktion anFireWatchdogReaction()Déclencher la réaction du watchdogAbsence du message alive (timeout)Timeout erkennenDéclencher la réaction du watchdog

Diagramme de séquence : Transmission régulière du signal de vie et déclenchement de la réaction de watchdog. Sources : [SWS_PHM_01255], [SWS_PHM_01256]

Scénarios d'erreur

L'interface prend en charge deux mécanismes complémentaires pour le traitement des défaillances système :

D'une part, une absence passive de messages entraîne une réaction du système : si le PHM ne se signale pas dans le délai configuré via AliveNotification(), WatchdogInterface a l'obligation d'engager de manière autonome la réaction de watchdog [SWS_PHM_01255]. De cette façon, les plantages ou interblocages du service PHM lui-même sont interceptés de manière fiable par le matériel.

D'autre part, il existe le chemin d'erreur actif : l'appel explicite de FireWatchdogReaction() déclenche une réaction d'erreur définie du watchdog [SWS_PHM_01256]. Dans les deux cas, l'impact final au niveau du système devrait généralement consister en une réinitialisation matérielle (hardware reset) ou en une transition vers un état sûr. Question Q-817baa072cc94a19 (ouverte)

En ce qui concerne le comportement face aux erreurs dans le code, les deux fonctions membres sont spécifiées comme non sécurisées contre les exceptions (not exception safe) [SWS_PHM_01255], [SWS_PHM_01256]. Le composant appelant ne peut donc s'appuyer sur aucune garantie de traitement d'exception, et l'implémentation de l'interface ne doit émettre aucune exception C++ non gérée.

Ce guide résume la spécification de apext::phm::WatchdogInterface conformément à AUTOSAR Adaptive R25-11.

Diagramme de classes UML

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

G napext__phm__WatchdogInterface47 WatchdogInterface + AliveNotification() + FireWatchdogReaction()

Méthodes

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

Documentation des méthodes

fonction 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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : cb75c45d42c3 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La fonction AliveNotification de l'en-tête apext/phm/watchdog_interface.h appartient à la classe apext::phm::WatchdogInterface et sert à la surveillance de vie cyclique de Platform Health Management (PHM) [SWS_PHM_01255]. L'interface possède la signature void AliveNotification(), ne prend aucun paramètre et ne renvoie aucune valeur [SWS_PHM_01255].

Contexte d'appel et comportement temporel

L'appel de AliveNotification est effectué périodiquement par PHM selon un temps de cycle configurable [SWS_PHM_01255]. Cette fréquence d'appel est logiquement découplée du pilotage du watchdog matériel physique réel, de sorte que la période configurée de PHM peut différer du temps de déclenchement du watchdog matériel [SWS_PHM_01255].

Réaction aux erreurs et scénarios de défaillance

Si PHM ne signale pas son état de vie avec succès dans l'intervalle de temps configuré à cet effet, le WatchdogInterface a pour consigne d'initier une réaction de watchdog [SWS_PHM_01255]. Aucun code d'erreur spécifique n'est prévu. Interprétation : l'interface étant classée comme non sûre vis-à-vis des exceptions, les états d'erreur inattendus devraient être propagés sous forme d'exceptions C++ dans le contexte de l'appelant [SWS_PHM_01255]. Question Q-a9e59a992db9913f (ouverte)

Concurrence et sécurité vis-à-vis des exceptions

La fonction est spécifiée comme thread-safe (thread-safe), ce pourquoi les accès parallèles sont autorisés, mais elle est considérée comme non sûre vis-à-vis des exceptions (not exception safe) [SWS_PHM_01255].

Ce texte a été rédigé par une IA et résume l'état de spécification d'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#0b452176
Content hash
0b452176
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

fonction FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

void FireWatchdogReaction ();

Interface to fire an error reaction of the Watchdog.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 28a89e0724c4 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La fonction FireWatchdogReaction sert d'interface dédiée au sein du module Platform Health Management (PHM) pour déclencher de manière ciblée une réaction d'erreur du watchdog [SWS_PHM_01256]. Elle est associée à la portée de la classe apext::phm::WatchdogInterface et est fournie via le fichier d'en-tête apext/phm/watchdog_interface.h [SWS_PHM_01256].

Lors de l'utilisation, il convient de tenir compte des aspects suivants :

  • Appel et interface : avec la signature void FireWatchdogReaction ();, la fonction ne prend aucun paramètre d'entrée et ne fournit aucune valeur de retour [SWS_PHM_01256]. L'appel déclenche immédiatement la réaction d'erreur du watchdog.
  • Concurrence : l'opération est spécifiée comme thread-safe [SWS_PHM_01256]. Elle peut par conséquent être appelée de manière concurrente depuis plusieurs threads sans synchronisation externe supplémentaire.
  • Sécurité vis-à-vis des exceptions et gestion des erreurs : la fonction est déclarée comme not exception safe [SWS_PHM_01256]. Interprétation : aucune sécurité vis-à-vis des exceptions n'étant garantie, les exceptions survenant en cas d'erreur devraient être propagées directement à l'appelant, qui devrait donc être paré à d'éventuelles exceptions. Question Q-f53d689332369cd7 (ouverte)

La fonction offre ainsi un point d'accès standardisé pour intervenir activement sur le comportement du watchdog en cas d'erreurs graves et déclencher des mesures de protection définies [SWS_PHM_01256].

Ce texte a été généré par une IA. Il est basé sur 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#73a8caea
Content hash
73a8caea
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