struct ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse

Die Datenstruktur ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse dient als Rückgabebehälter für die Ergebnisdaten einer synchron ausgeführten SOVD-Diagnoseoperation [SWS_DM_02208]. Nach erfolgreicher Vorabprüfung einer eventuellen proximity_challenge ruft das Diagnostic Management die Anwendungsmethode StartExecution auf [SWS_DM_02174]. Aus den in der Antwortstruktur enthaltenen Daten leitet das Diagnostic Management das parameters-Attribut des SOVD-Antwortkörpers nach ASAM SOVD ab [SWS_DM_02176]. Der Mechanismus setzt zwingend voraus, dass die Diagnoseoperation für eine synchrone Ausführung ausgelegt ist.

mehr ›

Kontext

Die Struktur ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse ist Bestandteil der Diagnoseschnittstelle (Modul diag) in der AUTOSAR Adaptive Platform und wird formal in [SWS_DM_02208] sowie in AUTOSAR_AP_SWS_Diagnostics §8.62.4 „Struct: StartSynchronousExecutionResponse“ definiert. Ihre primäre Aufgabe besteht im Transport der Antwortdaten bei der synchronen Ausführung einer Diagnoseoperation über das standardisierte SOVD-Protokoll (Service-Oriented Vehicle Diagnostics).

In diesem Kontext interagieren drei wesentliche Systempartner: Ein externer Client fordert über eine Diagnoseserver-Instanz den Start einer SOVD-Operation an [SWS_DM_01396]. Das Diagnostic Management (DM) verarbeitet die Anfrage und ruft die anwendungsspezifische Schnittstelle ara::diag::GenericDiagnosticSovdOperation::StartExecution auf [SWS_DM_02174]. Sofern die Ausführung synchron erfolgt, nimmt der DM die Instanz von StartSynchronousExecutionResponse entgegen und generiert daraus den SOVD-konformen Antwortkörper für den Client [SWS_DM_02176], wie in AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 „Operations – Start execution of an operation“ spezifiziert.

Lebenszyklus

Als Datenstruktur besitzt StartSynchronousExecutionResponse den Charakter eines reinen Wert- und Übergabeobjekts ohne eigenständige Zustandsmaschine. Die Struktur wird von der individuellen Anwendungslogik während des Aufrufs von StartExecution instanziiert. Interpretation: Die Erzeugung dürfte typischerweise als Rückgabewert direkt im lokalen Stack-Kontext der synchronen Verarbeitungsmethode der Anwendung erfolgen. Frage (offen)

Nach Fertigstellung der Operationslogik wird das Objekt an den aufrufenden Kontext des DM übergeben. Dieser extrahiert die enthaltenen Nutzdaten (DiagnosticSovdContentData), um die erforderlichen SOVD-Attribute zu belegen [SWS_DM_02176]. Nach Abschluss der Transformation und Versendung der Antwortnachricht endet die Lebensdauer des Antwortobjekts. Der Lebenszyklus ist somit strikt an die synchrone Aufrufdauer der Operation gebunden; eine persistente Verwaltung oder nebenläufige Synchronisation entfällt.

Nutzungspfad

Der reguläre Ablauf vollzieht sich in folgenden Schritten:

1. Ein Client ruft die SOVD-Methode zum Starten einer Operation auf, die von der Diagnoseserver-Instanz bereitgestellt wird [SWS_DM_01396].
2. Der DM prüft die Anfrage und führt bei Bedarf eine Validierung der Näherungsprüfung (proximity_challenge) durch [SWS_DM_02174].
3. Nach erfolgreicher Prüfung delegiert der DM den Aufruf über ara::diag::GenericDiagnosticSovdOperation::StartExecution an die Anwendung [SWS_DM_02174].
4. Die Anwendung wickelt die Operation synchron ab und erzeugt die Instanz StartSynchronousExecutionResponse, in welche die Ergebnisdaten abgelegt werden [SWS_DM_02208].
5. Der DM leitet aus dem in der Antwort enthaltenen DiagnosticSovdContentData das Attribut parameters ab und liefert den vollständigen SOVD-Antwortkörper gemäß ASAM SOVD zurück [SWS_DM_02176].

Sequenzdiagramm: Ablauf beim synchronen Start einer SOVD-Operation und Weiterverarbeitung von StartSynchronousExecutionResponse. Quellen: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 „Operations – Start execution of an operation“

Fehlerszenarien

Die Ausführung und Auswertung der Antwort unterliegt definierten Bedingungen:

• Fehlgeschlagene Vorbedingung: Ist eine Validierung von proximity_challenge erforderlich und schlägt diese fehl, ruft der DM StartExecution gar nicht erst auf [SWS_DM_02174]. In diesem Fall wird keine Instanz von StartSynchronousExecutionResponse instanziiert.
• Nicht-synchrone Ausführung: Wurde die Operation nicht als synchrone SOVD-Operation konfiguriert oder gestartet, findet die Abwicklung über StartSynchronousExecutionResponse keine Anwendung [SWS_DM_02176].
• Anwendungsfehler: Interpretation: Tritt bei der internen Abarbeitung in der Anwendung ein Fehler auf, dürfte anstelle einer regulären StartSynchronousExecutionResponse ein Fehlerpfad greifen, wodurch keine gültigen DiagnosticSovdContentData zur Ableitung des Attributs parameters bereitgestellt werden. Frage Q-5faaee7b9b008dde (offen)