class ara::diag::SovdOperationExecution

Die Schnittstelle dient der anwendungsspezifischen Steuerung und Überwachung einer laufenden SOVD-Operation im Diagnostic Management [SWS_DM_02197]. Über geschützte Methoden verarbeitet sie Statusabfragen sowie Anforderungen zur Ausführung spezieller Fähigkeiten oder zum Abbruch der Operation. Alle Rückgaben erfolgen asynchron über Futures, wobei Fehler zwingend als standardisierte SOVD-Fehlercodes nach ISO 17978-3 übermittelt werden [SWS_DM_02384]. Zudem müssen Implementierungen threadsicher sein und übergebene Cancellation-Handler strikt an die Operationslebensdauer binden.

mehr ›

Kontext

Die Klasse ara::diag::SovdOperationExecution definiert die Programmierschnittstelle zur Steuerung und Überwachung laufender SOVD-Operationsausführungen (Service-Oriented Vehicle Diagnostics) innerhalb des Moduls diag der AUTOSAR Adaptive Platform [SWS_DM_02197], SWS Diagnostics §8.62.5 „Class: SovdOperationExecution“. Sie fungiert als Bindeglied zwischen dem Diagnostic Management (DM) und der ausführenden Anwendungslogik für diagnosebezogene Routinen nach ASAM SOVD und ISO 17978-3.

Wenn ein externer SOVD-Client das Starten einer Operation initiiert [SWS_DM_01396] und die optionale Validierung der Proximity Challenge erfolgreich durchlaufen wurde [SWS_DM_02174], instanziiert bzw. bindet das DM die Ausführung an eine eindeutige Kennung (execution-id) [SWS_DM_02177]. Alle nachfolgenden Methodenaufrufe zu dieser laufenden Operation – insbesondere Statusabfragen und Abbruchbefehle – leitet das DM an diejenige Instanz von ara::diag::SovdOperationExecution weiter, die dieser Kennung zugewiesen ist [SWS_DM_02180].

Kontextdiagramm: Einbindung von SovdOperationExecution zwischen SOVD-Client, Diagnostic Management und anwendungsspezifischer Operationslogik. Quellen: [SWS_DM_01396], [SWS_DM_02180], [SWS_DM_02197].

Lebenszyklus

Die Klasse besitzt einen als noexcept=default deklarierten Standardkonstruktor [SWS_DM_02198] sowie einen virtuellen Destruktor, der ebenfalls als noexcept=default definiert ist [SWS_DM_02199]. Da sämtliche fachlichen Methoden – ExecuteCapability [SWS_DM_02384], GetStatus [SWS_DM_02201] und Terminate [SWS_DM_02202] – rein virtuell (= 0) und geschützt (protected) sind, ist die Klasse nicht direkt instanziierbar. Interpretation: Anwendungsentwickler leiten eigene Klassen von SovdOperationExecution ab, um die anwendungsspezifischen Routinen zu implementieren. Frage Q-c1d622c7aa17382d (offen)

Jede aktive Operationsausführung wird im DM einer execution-id zugeordnet [SWS_DM_02177], [SWS_DM_02180]. Die Spezifikation hebt hervor, dass Operationen in vielen Fällen lediglich eine einzige gleichzeitige Instanz erlauben SWS Diagnostics §7.3.3.5.5.6 „Operations – Terminate execution of an operation“. Alle Schnittstellenmethoden sind als threadsicher (thread-safe) und ausnahmesicher (exception safe) spezifiziert [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Hinsichtlich des Speichermanagements und der Lebensdauern gelten strenge Vorgaben: Der Parameter sovd_content_data bleibt solange gültig, bis das zugehörige Promise erfüllt oder die Verarbeitung über den cancellation_handler abgebrochen wurde [SWS_DM_02384]. Das Objekt cancellation_handler selbst darf unter keinen Umständen über die Lebensdauer der jeweiligen Operation hinaus gespeichert oder aufgerufen werden [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Nutzungspfad

Der typische Ablauf zur Begleitung einer SOVD-Operation gliedert sich in folgende Schritte:

• Fähigkeiten anfordern: Das DM kann für eine laufende Operation über die Methode ExecuteCapability Aktionen wie Ausführen, Einfrieren oder Zurücksetzen anfordern [SWS_DM_02384].
• Status abfragen: Empfängt das DM den SOVD-Aufruf „Read the Status of an operation“ und gelingt die geforderte Proximity-Validierung [SWS_DM_02173], ruft es GetStatus der zugewiesenen SovdOperationExecution-Instanz auf [SWS_DM_02180], [SWS_DM_02201]. Nach erfolgreicher Rückkehr antwortet das DM dem Client mit den Attributen status (aus GetStatusResponse.status), capability (Wert execute) und parameters (abgeleitet aus GetStatusResponse.Parameters) [SWS_DM_02181].
• Operation terminieren: Geht beim Diagnostic Server die SOVD-Methode „Terminate execution of an Operation“ ein [SWS_DM_01392], wird nach Validierung der Proximity-Antwort [SWS_DM_01391] die Methode Terminate unter Angabe des Grundes (TerminateOperationExecutionReason) an der Instanz aufgerufen [SWS_DM_02179], [SWS_DM_02202].

Sequenzdiagramm: Interaktionsabfolge zwischen Diagnostic Management und SovdOperationExecution bei Statusabfragen und kontrollierter Terminierung. Quellen: [SWS_DM_02180], [SWS_DM_02181], [SWS_DM_02179], [SWS_DM_02202].

Fehlerszenarien

Alle auszuführenden Methoden (ExecuteCapability, GetStatus, Terminate) arbeiten asynchron und geben ein ara::core::Future zurück [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202]. Schlägt die Verarbeitung innerhalb der Anwendung fehl, muss das Future mit einem anwendbaren SOVD-Fehlercode gemäß ISO 17978-3 bzw. ASAM SOVD 1.1 erfüllt werden [SWS_DM_02384], [SWS_DM_02201], [SWS_DM_02202].

Wird eine laufende Anforderung seitens des Diagnose-Frameworks storniert, signalisiert das DM dies über das mitgegebene Objekt ara::diag::CancellationHandler [SWS_DM_02384]. Die Implementierung muss den Abbruchzustand dieses Handlers berücksichtigen und die Bearbeitung unverzüglich beenden, um blockierende Zustände zu verhindern.