struct ara::diag::SovdSwUpdate::UpdatePackageStatus

Die Struktur ara::diag::SovdSwUpdate::UpdatePackageStatus stellt Status-, Phasen- und Fortschrittsinformationen eines Software-Aktualisierungsprozesses für SOVD-Diagnoseanwendungen bereit [SWS_DM_01902]. Sie wird durch den Aufruf von GetUpdatePackageStatus bezogen und ermöglicht die kontinuierliche Überwachung von Ausführungsphasen, prozentualen Fortschritten sowie Einzelschritten. Im Falle eines Fehlers signalisiert die Struktur den Fehlschlag und transportiert über das optionale Fehlerfeld den genauen Fehlercode aus der Domäne DiagSovdErrc [SWS_DM_01909]. Als reines Datenübertragungsobjekt erfordert die Struktur vermutlich eine anwendungsseitige Synchronisation bei nebenläufigem Zugriff. Frage Q-1d228b6cab1b505e (offen)

mehr ›

Kontext

Die Datenstruktur ara::diag::SovdSwUpdate::UpdatePackageStatus ist Bestandteil des Moduls diag der AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 „Struct: UpdatePackageStatus“ [SWS_DM_01902]. Sie fungiert im Rahmen von Service-Oriented Vehicle Diagnostics (SOVD) als standardisierter Informationsträger zur Erfassung und Bereitstellung des aktuellen Zustands eines Software-Aktualisierungspakets. Über die API-Funktion ara::diag::SovdSwUpdate::GetUpdatePackageStatus wird das Statusobjekt von der Diagnoseschnittstelle generiert und an abfragende Instanzen übergeben SWS Diagnostics §8.58.2.1.3.5 „GetUpdatePackageStatus“ [SWS_DM_01921].

Innerhalb der Systemarchitektur dient die Struktur als Entkopplungselement zwischen der ausführenden Service-Komponente SovdSwUpdate und externen oder internen Diagnose-Clients. Während der Service die eigentliche Paketverarbeitung und Installation steuert, kapselt UpdatePackageStatus eine Momentaufnahme über Verarbeitungsphasen, Fortschritte und eventuelle Fehlerzustände [SWS_DM_01902].

Lebenszyklus

Als reiner Datenbehälter (struct) besitzt UpdatePackageStatus keine eigene interne Zustandslogik und betreibt kein eigenständiges Ressourcenmanagement SWS Diagnostics §8.58.5 „Struct: UpdatePackageStatus“ [SWS_DM_01902]. Instanzen werden im Zuge des Aufrufs von GetUpdatePackageStatus erzeugt, mit den aktuellen Statuswerten befüllt und per Wert an den Aufrufer zurückgeliefert [SWS_DM_01921]. Die Lebensdauer ist an den Scope des Empfängers gebunden und endet mit dessen Zerstörung.

Obwohl das C++-Objekt passiv ist, repräsentieren seine Member-Variablen den Lebenszyklus des zugrunde liegenden Aktualisierungsprozesses. Das Feld phase vom Typ SovdUpdatePhase beschreibt die aktuelle Phase des Gesamtprozesses SWS Diagnostics §8.58.5.1.2 „phase“ [SWS_DM_01903], während die Variable status vom Typ SovdUpdateStatus den konkreten Zustand dieser Phase angibt SWS Diagnostics §8.58.5.1.4 „status“ [SWS_DM_01904]. Da keine internen Mutexe oder Synchronisationsmechanismen spezifiziert sind, erfordert ein nebenläufiger Zugriff auf dieselbe Instanz eine externe Absicherung durch den Verwender.

Nutzungspfad

Der typische Nutzungspfad umfasst die zyklische oder anlassbezogene Überwachung einer Paketaktualisierung durch einen Diagnose-Client:

• Statusabfrage: Der Client ruft die Methode GetUpdatePackageStatus an der Schnittstelle SovdSwUpdate auf SWS Diagnostics §8.58.2.1.3.5 „GetUpdatePackageStatus“ [SWS_DM_01921].
• Phasen- und Statusbewertung: Nach Erhalt des Objekts [SWS_DM_01902] prüft der Client die Variablen phase [SWS_DM_01903] und status [SWS_DM_01904], um festzustellen, ob der Ablauf regulär fortschreitet oder abgeschlossen ist.
• Fortschrittsanalyse: Liegt ein prozentualer Gesamtfortschritt vor, wird dieser über das optionale Member progress ausgewertet SWS Diagnostics §8.58.5.1.3 „progress“ [SWS_DM_01905]. Zusätzliche Teilphasen können über den Vektor subprogress eingesehen werden [SWS_DM_01906].
• Schrittanzeige: Zur Protokollierung oder Benutzerführung werden die textuelle Schrittbezeichnung step [SWS_DM_01907] sowie der Lokalisierungsschlüssel step_translation_id herangezogen [SWS_DM_01908].

Sequenzdiagramm: Aufrufabfolge zur Statusabfrage und Auswertung der Member-Variablen eines UpdatePackageStatus. Quellen: [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909].

Fehlerszenarien

Fehler im Update-Ablauf werden über spezifische Attribute der Datenstruktur transparent gemacht:

• Fehlgeschlagener Status: Weist der Prozess ein Problem auf, nimmt das Feld status den Zustand „failed“ an [SWS_DM_01904].
• Fehlerdetail: In diesem Fehlerfall spezifiziert das Feld error vom Typ ara::core::Optional<ara::diag::DiagSovdErrc> den aufgetretenen Fehlercode SWS Diagnostics §8.58.5.1.1 „error“ [SWS_DM_01909].
• Regulärer Ablauf: Sofern kein Fehler vorliegt, dürfte das optionale Feld error unbesetzt bleiben, da es laut Spezifikation explizit an den Zustand „failed“ gekoppelt ist [SWS_DM_01909]. Frage Q-c26d1c1d25d7e938 (offen)
• Schnittstellenfehler: Schlägt der API-Aufruf GetUpdatePackageStatus auf Plattformebene fehl, dürfte anstelle eines Statusobjekts ein plattformspezifischer Fehlerzustand zurückgegeben werden [SWS_DM_01921]. Frage Q-b029f911ee738cb1 (offen)