struct ara::diag::DoIPGroupIdentification::GidStatus

Die Struktur ara::diag::DoIPGroupIdentification::GidStatus dient als Datenbehälter für die positiven Antwortdaten bei der Abfrage der DoIP-Gruppenidentifikation [SWS_DM_00721]. Sie wird von einer Adaptive Application bereitgestellt, wenn das Diagnostic Management die Gruppenidentifikation bei nicht konfigurierter DoIpInstantiation.gid über die Schnittstelle GetGidStatus anfordert [SWS_DM_00813]. Die Struktur transportiert die ermittelten GID-Werte direkt an den Diagnostic Manager zur Weiterleitung im DoIP-Protokoll. Sie ist strikt auf erfolgreiche Antworten beschränkt und enthält keine Mechanismen für Fehlerszenarien.

mehr ›

Kontext

Die Datenstruktur ara::diag::DoIPGroupIdentification::GidStatus repräsentiert die positiven Antwortdaten für die Gruppenidentifikation im DoIP-Subsystem (Diagnostic over IP) der AUTOSAR Adaptive Platform [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 „Struct: GidStatus“. Sie dient als standardisierter Ergebnisbehälter für Gruppenidentifikationsdaten (GID), wenn externe Diagnose-Clients Informationen zur Fahrzeug- oder Gruppenidentifikation über DoIP anfordern. Im Systemverbund interagieren dabei drei Hauptpartner: der externe DoIP-Client, das AUTOSAR Diagnostic Management (DM) sowie die anwendungsspezifische Adaptive Application, welche die Schnittstelle ara::diag::DoIPGroupIdentification anbietet. Sofern die GID nicht statisch über den Konfigurationsparameter DoIpInstantiation.gid hinterlegt ist, ist das DM spezifikationsgemäß verpflichtet, die GID über die Anwendungsschnittstelle abzurufen [SWS_DM_00813], AUTOSAR_AP_SWS_Diagnostics §8.34.1 „Providing the GID in DoIP protocol messages using application interface“.

Lebenszyklus

Als C++-Datenstruktur (struct) besitzt GidStatus keinen eigenständigen Prozess- oder Dienstlebenszyklus, sondern fungiert als reines Datentransferobjekt [SWS_DM_00721]. Eine Instanz von GidStatus wird von der zuständigen Adaptive Application instanziiert und mit den aktuellen Identifikationsdaten befüllt, sobald die Abfragemethode GetGidStatus aufgerufen wird [SWS_DM_00724], AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 „GetGidStatus“. Interpretation: Die Struktur dürfte typischerweise als temporäres Wertobjekt auf dem Stack erzeugt und als Bestandteil des Rückgabewertes per Kopie oder Move-Semantik an das DM übergeben werden, womit ihr Lebenszyklus nach der Verarbeitung der DoIP-Botschaft im DM endet. Frage Q-4974fdbc2c6accbb (offen) Da mehrere Diagnoseanfragen oder parallele DoIP-Nachrichtenverarbeitungen auftreten können, müssen die innerhalb der Struktur gehaltenen Daten thread-sicher bereitgestellt oder für jeden Abfragekontext isoliert erzeugt werden.

Nutzungspfad

Der typische Einsatz von GidStatus gliedert sich in eine feste Interaktionsabfolge zwischen dem DoIP-Client, dem Diagnostic Management und der Adaptive Application:

Sequenzdiagramm: Ablauf der Bereitstellung von GidStatus über GetGidStatus bei unkonfigurierter GID. Quellen: [SWS_DM_00721], [SWS_DM_00724], [SWS_DM_00813].

1. Ein externer DoIP-Client sendet eine Diagnose- oder Identifikationsanfrage über das DoIP-Netzwerk an das Fahrzeug.
2. Das Diagnostic Management prüft die Konfiguration: Ist DoIpInstantiation.gid nicht konfiguriert, fordert das DM die Gruppenidentifikation über GetGidStatus von der Adaptive Application an [SWS_DM_00813], [SWS_DM_00724].
3. Die Adaptive Application ermittelt die Gruppenidentifikationsmerkmale, erzeugt eine Instanz von GidStatus mit den positiven Antwortdaten und gibt diese an das DM zurück [SWS_DM_00721].
4. Das DM entnimmt die Daten aus GidStatus und sendet die vollständige DoIP-Protokollnachricht an den externen DoIP-Client [SWS_DM_00813].

Fehlerszenarien

Die Spezifikation definiert GidStatus ausdrücklich als positive Antwortdaten („Response data of positive response message“) [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 „Struct: GidStatus“. Interpretation: Falls die Adaptive Application nicht in der Lage ist, die Gruppenidentifikation bereitzustellen, oder falls ein interner Fehler vorliegt, dürfte keine reguläre GidStatus-Instanz zurückgegeben werden; stattdessen dürfte die Methode GetGidStatus über standardisierte Fehlermechanismen der Plattform (wie Fehlercodes in ara::core::Result) einen Fehler an das DM signalisieren. Frage Q-01181eb14d27eeb2 (offen) Zudem verdeutlicht der Kontext verwandter DoIP-Schnittstellen wie ara::diag::DoIPPowerMode [SWS_DM_00814], dass das DM bei noch nicht angebotenen Schnittstellen definierte Default- oder Ersatzwerte verwendet [SWS_DM_01525]; für die Gruppenidentifikation erfordert ein Ausbleiben valider Antwortdaten eine entsprechende negative Handhabung im DoIP-Protokoll, da ohne GID keine gültige positive Antwort übermittelt werden kann [SWS_DM_00813].