struct ara::diag::SovdSwUpdate::UpdatePackageStatus

De structuur ara::diag::SovdSwUpdate::UpdatePackageStatus stelt status-, fase- en voortgangsinformatie van een software-updateproces beschikbaar voor SOVD-diagnose-applicaties [SWS_DM_01902]. Deze wordt verkregen door het aanroepen van GetUpdatePackageStatus en maakt continue bewaking van uitvoeringsfasen, procentuele voortgang en afzonderlijke stappen mogelijk. In geval van een fout signaleert de structuur de mislukking en transporteert via het optionele foutveld de exacte foutcode uit het domein DiagSovdErrc [SWS_DM_01909]. Als zuiver gegevensoverdrachtsobject vereist de structuur vermoedelijk synchronisatie aan de applicatiezijde bij gelijktijdige toegang. Vraag Q-1d228b6cab1b505e (open)

meer ›

Context

De datastructuur ara::diag::SovdSwUpdate::UpdatePackageStatus maakt deel uit van de module diag van het AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902]. Deze fungeert binnen het kader van Service-Oriented Vehicle Diagnostics (SOVD) als gestandaardiseerde informatiedrager voor het vastleggen en beschikbaar stellen van de actuele toestand van een software-updatepakket. Via de API-functie ara::diag::SovdSwUpdate::GetUpdatePackageStatus wordt het statusobject door de diagnose-interface gegenereerd en overgedragen aan opvragende instanties SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921].

Binnen de systeemarchitectuur dient de structuur als ontkoppelingselement tussen de uitvoerende servicecomponent SovdSwUpdate en externe of interne diagnoseclients. Terwijl de service de daadwerkelijke pakketverwerking en installatie bestuurt, kapselt UpdatePackageStatus een momentopname van verwerkingsfasen, voortgang en eventuele fouttoestanden in [SWS_DM_01902].

Levenscyclus

Als zuivere datacontainer (struct) bezit UpdatePackageStatus geen eigen interne toestandslogica en voert geen zelfstandig beheer van resources uit SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902]. Instanties worden aangemaakt bij het aanroepen van GetUpdatePackageStatus, gevuld met de actuele statuswaarden en op basis van waarde aan de aanroeper geretourneerd [SWS_DM_01921]. De levensduur is gebonden aan de scope van de ontvanger en eindigt met de vernietiging daarvan.

Hoewel het C++-object passief is, vertegenwoordigen de membervariabelen de levenscyclus van het onderliggende updateproces. Het veld phase van het type SovdUpdatePhase beschrijft de actuele fase van het totale proces SWS Diagnostics §8.58.5.1.2 “phase” [SWS_DM_01903], terwijl de variabele status van het type SovdUpdateStatus de concrete toestand van deze fase aangeeft SWS Diagnostics §8.58.5.1.4 “status” [SWS_DM_01904]. Aangezien er geen interne mutexen of synchronisatiemechanismen zijn gespecificeerd, vereist een gelijktijdige toegang tot dezelfde instantie een externe beveiliging door de gebruiker.

Gebruikspad

Het typische gebruikstraject omvat de cyclische of gelegenheidsgebonden bewaking van een pakketupdate door een diagnoseclient:

• Statusopvraag: de client roept de methode GetUpdatePackageStatus op de interface SovdSwUpdate aan SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921].
• Fase- en statusbeoordeling: na ontvangst van het object [SWS_DM_01902] controleert de client de variabelen phase [SWS_DM_01903] en status [SWS_DM_01904] om vast te stellen of het verloop regulier vordert of is voltooid.
• Voortgangsanalyse: als er een procentuele totale voortgang beschikbaar is, wordt deze via het optionele member progress geëvalueerd SWS Diagnostics §8.58.5.1.3 “progress” [SWS_DM_01905]. Aanvullende deelfasen kunnen via de vector subprogress worden ingezien [SWS_DM_01906].
• Stapweergave: voor logboekregistratie of gebruikersbegeleiding worden de tekstuele stapaanduiding step [SWS_DM_01907] en de lokalisatiesleutel step_translation_id geraadpleegd [SWS_DM_01908].

Sequentiediagram: aanroepvolgorde voor statusopvraag en evaluatie van de membervariabelen van een UpdatePackageStatus. Bronnen: [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909].

Foutscenario's

Fouten in het updateproces worden inzichtelijk gemaakt via specifieke attributen van de datastructuur:

• Mislukte status: Vertoont het proces een probleem, dan neemt het veld status de toestand “failed” aan [SWS_DM_01904].
• Foutdetail: In dit foutgeval specificeert het veld error van het type ara::core::Optional<ara::diag::DiagSovdErrc> de opgetreden foutcode SWS Diagnostics §8.58.5.1.1 “error” [SWS_DM_01909].
• Regulier verloop: Zolang er geen fout optreedt, blijft het optionele veld error vermoedelijk niet-ingevuld, aangezien het volgens de specificatie expliciet gekoppeld is aan de toestand “failed” [SWS_DM_01909]. Vraag Q-c26d1c1d25d7e938 (open)
• Interfacefout: Mislukt de API-aanroep GetUpdatePackageStatus op platformniveau, dan wordt vermoedelijk in plaats van een statusobject een platformspecifieke fouttoestand geretourneerd [SWS_DM_01921]. Vraag Q-b029f911ee738cb1 (open)