namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>}

Dieser Namespace stellt im Platform Health Management stark typisierte Enumerationen für Checkpoints überwachter Entitäten bereit [SWS_PHM_00424]. Jede überwachte Entität erhält eine eigene Scoped Enumeration mit dem Basistyp std::uint32_t, deren deklarierte Enumeratoren als Kontrollpunkte an die Schnittstelle ara::phm::PhmSupervisedEntityInterface gemeldet werden [SWS_PHM_00424], [SWS_PHM_00425]. Durch die statische Bereitstellung im typsicheren Namensraum wird die Verwechslung von Kontrollpunkten verschiedener Entitäten zur Compile-Zeit zuverlässig verhindert.

mehr ›

Kontext

Der C++-Namespace namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>} dient innerhalb des Platform Health Managements (PHM) der AUTOSAR Adaptive Platform als dedizierter Bereich für typsichere Kontrollpunkte (Checkpoints) überwachter Funktionseinheiten (Supervised Entities). Gemäß [SWS_PHM_00424] enthält dieser Namensraum Scoped Enumerations des Formats enum class {<phmssi-sn>} : std::uint32_t, welche die diskreten Checkpoints für die Schnittstelle ara::phm::PhmSupervisedEntityInterface definieren. Für jedes konfigurierte Element der Kontrollpunktliste existiert eine eindeutige C++-Enumerator-Deklaration [SWS_PHM_00425]. Das Zusammenspiel bindet drei funktionale Kernkomponenten zusammen: die überwachte Anwendungssoftware (Supervised Entity), die durch den Namespace modellierten typisierten Checkpoints sowie die Plattform-Schnittstelle ara::phm::PhmSupervisedEntityInterface, über die Überwachungsereignisse an den PHM-Dienst weitergereicht werden.

Kontextdiagramm: Zusammenspiel zwischen überwachter Anwendungssoftware, typisierter Checkpoint-Enumeration und Plattform-Schnittstelle. Quellen: [SWS_PHM_00424], [SWS_PHM_00425]

Lebenszyklus

Die Typen und Konstanten innerhalb des Namensraums besitzen statischen Compile-Time-Charakter. Sie unterliegen keinem dynamischen Laufzeit-Lebenszyklus durch Allokation oder Freigabe auf dem Heap, sondern werden als typisierte C++11 Scoped Enumerations mit dem Basistyp std::uint32_t bereitgestellt [SWS_PHM_00424]. Interpretation: Die Definitionen werden typischerweise während des Erstellungsprozesses aus der AUTOSAR-Dienstbeschreibung automatisiert generiert, da Pfade und Bezeichner von den Modellparametern der Schnittstelle abhängen. Frage (offen) Für die Inklusion stellt der Standard pro überwachter Einheit eine eigene Header-Datei unter #include "ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h" zur Verfügung, während allgemeine Typdeklarationen über den Forwarding-Header #include "ara/phm/phm_fwd.h" vorwärtsdeklariert werden können [SWS_PHM_00424]. Die Enumerator-Konstanten stehen der Anwendung somit während der gesamten Prozesslebensdauer unveränderlich zur Verfügung [SWS_PHM_00425].

Nutzungspfad

Der typische Nutzungspfad für Softwarekomponenten, die als Supervised Entity agieren, gliedert sich in drei aufeinander aufbauende Schritte:

• Header-Einbindung: Die Anwendung bindet den generierten Header der überwachten Einheit über den Dateipfad ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h oder die zentrale Weiterleitung ara/phm/phm_fwd.h ein [SWS_PHM_00424].
• Schnittstelleninitialisierung: Die Anwendung instanziiert bzw. bindet die Schnittstelle ara::phm::PhmSupervisedEntityInterface, für welche die Checkpoints der Enumeration deklariert wurden [SWS_PHM_00424].
• Checkpoint-Signalisierung: Beim Durchlaufen relevanter Kontrollstellen im Algorithmus wählt die Anwendung den zugehörigen Enumerator {<symbol-phm-checkpoint>} aus dem Namespace aus [SWS_PHM_00425] und meldet diesen an die Instanz von ara::phm::PhmSupervisedEntityInterface [SWS_PHM_00424].

Durch die Bindung an den Basistyp std::uint32_t [SWS_PHM_00424] und die explizite Wertzuweisung jedes Kontrollpunkts [SWS_PHM_00425] wird eine typsichere und verwechslungsfreie Identifikation der jeweiligen Programmschritte zur Laufzeit garantiert.

Fehlerszenarien

Fehlerhafte Nutzungen dieses Namensraums resultieren vor allem aus modellbezogenen und typbezogenen Fehlkonfigurationen. Da es sich um eine enum class handelt [SWS_PHM_00424], verhindert das C++-Typsystem implizite Typkonvertierungen; die Verwendung fehlerhafter Datentypen oder Enumeratoren fremder Supervised Entities wird somit bereits zur Übersetzungszeit abgefangen. Zu Laufzeitfehlern kann es führen, wenn die Konfiguration in der Modellbeschreibung nicht exakt mit der Enumerator-Liste übereinstimmt: Gemäß [SWS_PHM_00425] muss für jeden Checkpoint ein entsprechender Enumerator deklariert sein. Interpretation: Sollte eine Anwendung durch unzulässige Typumwandlung oder veraltete Header-Dateien einen nicht im Modell konfigurierten std::uint32_t-Wert an ara::phm::PhmSupervisedEntityInterface übergeben, dürfte der PHM-Dienst diesen Checkpoint nicht zuordnen können und dies als Überwachungsverletzung werten. Frage Q-b8fb7472f6ea8d10 (offen)