DEENESPTFRRUARHIKOZHNL

structure ara::diag::SovdSwUpdate::UpdatePackageStatus

[SWS_DM_01902] Upstream: RS_Diag_04265

struct UpdatePackageStatus {...};

Definition of Update Status.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::SovdSwUpdate

Guide utilisateurGÉNÉRÉ PAR IA

Fournit des données détaillées de phase, de progression et d’erreur pour la surveillance d’un paquet de mise à jour logicielle en cours.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 5279eba20862 Provenance Questions ouvertes (3)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Fournit des données détaillées de phase, de progression et d’erreur pour la surveillance d’un paquet de mise à jour logicielle en cours.

La structure ara::diag::SovdSwUpdate::UpdatePackageStatus fournit des informations d’état, de phase et de progression d’un processus de mise à jour logicielle pour les applications de diagnostic SOVD [SWS_DM_01902]. Elle est obtenue par l’appel de GetUpdatePackageStatus et permet la surveillance continue des phases d’exécution, de la progression en pourcentage ainsi que des étapes individuelles. En cas d’erreur, la structure signale l’échec et transmet, via le champ d’erreur optionnel, le code d’erreur exact issu du domaine DiagSovdErrc [SWS_DM_01909]. En tant que simple objet de transfert de données, la structure requiert vraisemblablement une synchronisation côté application en cas d’accès concurrent. Question Q-1d228b6cab1b505e (ouverte)

Contexte

La structure de données ara::diag::SovdSwUpdate::UpdatePackageStatus fait partie du module diag de l’AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 « Struct: UpdatePackageStatus » [SWS_DM_01902]. Elle agit dans le cadre de Service-Oriented Vehicle Diagnostics (SOVD) comme un vecteur d’information standardisé pour l’acquisition et la mise à disposition de l’état actuel d’un paquet de mise à jour logicielle. L’objet d’état est généré par l’interface de diagnostic via la fonction API ara::diag::SovdSwUpdate::GetUpdatePackageStatus et transmis aux instances demandeuses SWS Diagnostics §8.58.2.1.3.5 « GetUpdatePackageStatus » [SWS_DM_01921].

Au sein de l’architecture système, la structure sert d’élément de découplage entre le composant de service exécutant SovdSwUpdate et les clients de diagnostic externes ou internes. Tandis que le service pilote le traitement réel du paquet et son installation, UpdatePackageStatus encapsule un instantané des phases de traitement, de la progression et des états d’erreur éventuels [SWS_DM_01902].

Cycle de vie

En tant que simple conteneur de données (struct), UpdatePackageStatus ne possède pas de logique d’état interne propre et ne gère pas de ressources de manière autonome SWS Diagnostics §8.58.5 « Struct: UpdatePackageStatus » [SWS_DM_01902]. Les instances sont créées lors de l’appel de GetUpdatePackageStatus, remplies avec les valeurs d’état actuelles et renvoyées par valeur à l’appelant [SWS_DM_01921]. La durée de vie est liée à la portée du récepteur et se termine avec sa destruction.

Bien que l’objet C++ soit passif, ses variables membres représentent le cycle de vie du processus de mise à jour sous-jacent. Le champ phase de type SovdUpdatePhase décrit la phase actuelle de l’ensemble du processus SWS Diagnostics §8.58.5.1.2 « phase » [SWS_DM_01903], tandis que la variable status de type SovdUpdateStatus indique l’état concret de cette phase SWS Diagnostics §8.58.5.1.4 « status » [SWS_DM_01904]. Comme aucun mutex interne ni mécanisme de synchronisation n’est spécifié, un accès concurrent à la même instance requiert une protection externe par l’utilisateur.

Parcours d'utilisation

Le chemin d’utilisation typique comprend la surveillance cyclique ou ponctuelle d’une mise à jour de paquet par un client de diagnostic :

Interrogation et évaluation de UpdatePackageStatusClientSovdSwUpdateUpdatePackageStatusGetUpdatePackageStatus()créé et renseignéUpdatePackageStatusaltstatus == failedévalue error (DiagSovdErrc)status != failedlit phase, progress et step

Diagramme de séquence : séquence d’appels pour l’interrogation d’état et l’évaluation des variables membres d’un UpdatePackageStatus. Sources : [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909].

Scénarios d'erreur

Les erreurs dans le déroulement de la mise à jour sont rendues transparentes via des attributs spécifiques de la structure de données :

Ce guide est basé sur la spécification AUTOSAR Adaptive Platform Release R25-11.

Carte des membres

Diagramme de classes

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__SovdSwUpdate__UpdatePackageStatus558 «struct» UpdatePackageStatus + error + phase + progress + status + step + step_translation_id + subprogress

Vue détaillée

Sélectionnez une entrée dans le plan.

Constantes

error variable

Specifies the error if status is failed.

phase variable

Specifies the Update Status phase.

progress variable

Specifies the progress of the Update phase in percentage.

status variable

Specifies the status of the Update phase.

step variable

Specifies the current step of the Update.

Specifies the step_translation_id.

ara::core::String step_translation_id;
subprogress variable

Specifies the progress of the Update phase in percent.

Documentation des constantes / variables

variable error [SWS_DM_01909] Upstream: RS_Diag_04265

ara::core::Optional<ara::diag::DiagSovdErrc> error;

Specifies the error if status is failed.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolerror
Typara::core::Optional< ara::diag::DiagSovdErrc >

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01909
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01909@rel:R25-11#4a4c2651
Content hash
4a4c2651
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01909
Status: valid/unmigrated Version: rel:R25-11#cfd3d293 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01909@rel:R25-11#cfd3d293
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#4a4c26512026-09-30
  • R23-11rel:R23-11#cfd3d2932026-10-14
  • R24-11rel:R24-11#cfd3d2932026-10-14
  • R25-11rel:R25-11#cfd3d2932026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable phase [SWS_DM_01903] Upstream: RS_Diag_04265

SovdUpdatePhase phase;

Specifies the Update Status phase.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolphase
TypSovdUpdatePhase

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01903
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01903@rel:R25-11#308e0d2b
Content hash
308e0d2b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01903
Status: valid/unmigrated Version: rel:R25-11#a843f38b Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01903@rel:R25-11#a843f38b
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#308e0d2b2026-09-30
  • R23-11rel:R23-11#a843f38b2026-10-14
  • R24-11rel:R24-11#a843f38b2026-10-14
  • R25-11rel:R25-11#a843f38b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable progress [SWS_DM_01905] Upstream: RS_Diag_04265

ara::core::Optional<std::uint8_t> progress;

Specifies the progress of the Update phase in percentage.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolprogress
Typara::core::Optional< std::uint8_t >

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01905
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01905@rel:R25-11#34e3e47e
Content hash
34e3e47e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01905
Status: valid/unmigrated Version: rel:R25-11#33e52ed5 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01905@rel:R25-11#33e52ed5
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#34e3e47e2026-09-30
  • R23-11rel:R23-11#33e52ed52026-10-14
  • R24-11rel:R24-11#33e52ed52026-10-14
  • R25-11rel:R25-11#33e52ed52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable status [SWS_DM_01904] Upstream: RS_Diag_04265

SovdUpdateStatus status;

Specifies the status of the Update phase.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolstatus
TypSovdUpdateStatus

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01904
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01904@rel:R25-11#685ed700
Content hash
685ed700
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01904
Status: valid/unmigrated Version: rel:R25-11#c3381562 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01904@rel:R25-11#c3381562
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#685ed7002026-09-30
  • R23-11rel:R23-11#c33815622026-10-14
  • R24-11rel:R24-11#c33815622026-10-14
  • R25-11rel:R25-11#c33815622026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable step [SWS_DM_01907] Upstream: RS_Diag_04265

ara::core::String step;

Specifies the current step of the Update.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolstep
Typara::core::String

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01907
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01907@rel:R25-11#19d1f039
Content hash
19d1f039
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01907
Status: valid/unmigrated Version: rel:R25-11#5eacde13 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01907@rel:R25-11#5eacde13
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#19d1f0392026-09-30
  • R23-11rel:R23-11#5eacde132026-10-14
  • R24-11rel:R24-11#5eacde132026-10-14
  • R25-11rel:R25-11#5eacde132026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable step_translation_id [SWS_DM_01908] Upstream: RS_Diag_04265

ara::core::String step_translation_id;

Specifies the step_translation_id.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolstep_translation_id
Typara::core::String

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01908
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01908@rel:R25-11#6b35d3a1
Content hash
6b35d3a1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01908
Status: valid/unmigrated Version: rel:R25-11#f97411b0 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01908@rel:R25-11#f97411b0
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6b35d3a12026-09-30
  • R23-11rel:R23-11#f97411b02026-10-14
  • R24-11rel:R24-11#f97411b02026-10-14
  • R25-11rel:R25-11#f97411b02026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable subprogress [SWS_DM_01906] Upstream: RS_Diag_04265

ara::core::Vector<SubProgress> subprogress;

Specifies the progress of the Update phase in percent.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopestruct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbolsubprogress
Typara::core::Vector< SubProgress >

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01906
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01906@rel:R25-11#5034457c
Content hash
5034457c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01906
Status: valid/unmigrated Version: rel:R25-11#51179198 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01906@rel:R25-11#51179198
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5034457c2026-09-30
  • R23-11rel:R23-11#511791982026-10-14
  • R24-11rel:R24-11#511791982026-10-14
  • R25-11rel:R25-11#511791982026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill