DEENESPTFRRUARHIKOZHNL

بنية 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

دليل المستخدممولَّد بالذكاء الاصطناعي

يوفر بيانات مفصلة عن المراحل والتقدم والأخطاء لمراقبة حزمة تحديث برامج قيد التشغيل.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5279eba20862 المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر بيانات مفصلة عن المراحل والتقدم والأخطاء لمراقبة حزمة تحديث برامج قيد التشغيل.

يوفر الهيكل ara::diag::SovdSwUpdate::UpdatePackageStatus معلومات الحالة والمرحلة والتقدم لعملية تحديث البرامج لتطبيقات تشخيص SOVD [SWS_DM_01902]. يتم الحصول عليه من خلال استدعاء GetUpdatePackageStatus ويتيح المراقبة المستمرة لمراحل التنفيذ والنسب المئوية للتقدم بالإضافة إلى الخطوات الفردية. في حالة حدوث خطأ، يشير الهيكل إلى الفشل وينقل عبر حقل الخطأ الاختياري رمز الخطأ الدقيق من النطاق DiagSovdErrc [SWS_DM_01909]. ككائن نقل بيانات خالص، يُفترض أن يتطلب الهيكل مزامنة من جانب التطبيق في حالة الوصول المتزامن. سؤال Q-1d228b6cab1b505e (مفتوح)

السياق

يُعد هيكل البيانات ara::diag::SovdSwUpdate::UpdatePackageStatus جزءًا من الوحدة diag في AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 «Struct: UpdatePackageStatus» [SWS_DM_01902]. وهو يعمل في إطار Service-Oriented Vehicle Diagnostics (SOVD) كحامل معلومات قياسي لتسجيل وتوفير الحالة الحالية لحزمة تحديث البرامج. عبر دالة API المسماة ara::diag::SovdSwUpdate::GetUpdatePackageStatus، يتم إنشاء كائن الحالة بواسطة واجهة التشخيص وتمريره إلى المثيلات المستعلمة SWS Diagnostics §8.58.2.1.3.5 «GetUpdatePackageStatus» [SWS_DM_01921].

ضمن بنية النظام، يعمل الهيكل كعنصر فصل بين مكون الخدمة المنفذ SovdSwUpdate وعملاء التشخيص الخارجيين أو الداخليين. بينما تتحكم الخدمة في معالجة الحزمة وتثبيتها الفعليين، يغلف UpdatePackageStatus لقطة سريعة لمراحل المعالجة والتقدم وأي حالات خطأ محتملة [SWS_DM_01902].

دورة الحياة

كحاوية بيانات خالصة (struct)، لا يمتلك UpdatePackageStatus منطق حالة داخلي خاص به ولا يدير الموارد بشكل مستقل SWS Diagnostics §8.58.5 «Struct: UpdatePackageStatus» [SWS_DM_01902]. يتم إنشاء المثيلات أثناء استدعاء GetUpdatePackageStatus، وتعبئتها بقيم الحالة الحالية، وإعادتها بالقيمة إلى المستدعي [SWS_DM_01921]. ترتبط مدة البقاء بنطاق المستلم وتنتهي مع إتلافه.

على الرغم من أن كائن C++ غير فعال ذاتيًا، إلا أن متغيرات الأعضاء الخاصة به تمثل دورة حياة عملية التحديث الأساسية. يصف الحقل phase من النوع SovdUpdatePhase المرحلة الحالية للعملية الكلية SWS Diagnostics §8.58.5.1.2 «phase» [SWS_DM_01903]، بينما يحدد المتغير status من النوع SovdUpdateStatus الحالة الملموسة لهذه المرحلة SWS Diagnostics §8.58.5.1.4 «status» [SWS_DM_01904]. نظرًا لعدم تحديد كائنات كبت متبادل داخلية أو آليات مزامنة، فإن الوصول المتزامن إلى نفس المثيل يتطلب حماية خارجية من قِبل المستخدم.

مسار الاستخدام

يتضمن مسار الاستخدام النموذجي المراقبة الدورية أو المستندة إلى مناسبة لتحديث الحزمة بواسطة عميل التشخيص:

  • استعلام الحالة: يستدعي العميل الطريقة GetUpdatePackageStatus على الواجهة SovdSwUpdate SWS Diagnostics §8.58.2.1.3.5 «GetUpdatePackageStatus» [SWS_DM_01921].
  • تقييم المرحلة والحالة: بعد استلام الكائن [SWS_DM_01902]، يفحص العميل المتغيرين phase [SWS_DM_01903] وstatus [SWS_DM_01904] لتحديد ما إذا كان المسار يتقدم بشكل نظامي أو أنه قد اكتمل.
  • تحليل التقدم: في حال توفر تقدم إجمالي كنسبة مئوية، يتم تقييمه عبر العضو الاختياري progress SWS Diagnostics §8.58.5.1.3 «progress» [SWS_DM_01905]. ويمكن الاطلاع على مراحل فرعية إضافية عبر المتجه subprogress [SWS_DM_01906].
  • عرض الخطوات: تُستخدم التسمية النصية للخطوة step [SWS_DM_01907] وكذلك مفتاح التوطين step_translation_id لأغراض التسجيل في السجل أو توجيه المستخدم [SWS_DM_01908].
الاستعلام عن UpdatePackageStatus وتقييمهاClientSovdSwUpdateUpdatePackageStatusGetUpdatePackageStatus()يُنشئ ويملأUpdatePackageStatusaltstatus == failedيقيم error (DiagSovdErrc)status != failedيقرأ phase وprogress وstep

مخطط تسلسلي: تسلسل الاستدعاءات للاستعلام عن الحالة وتقييم المتغيرات الأعضاء لكائن UpdatePackageStatus. المصادر: [SWS_DM_01921]، [SWS_DM_01902]، [SWS_DM_01904]، [SWS_DM_01909].

سيناريوهات الأخطاء

يتم توضيح الأخطاء في مسار التحديث بشفافية عبر سمات محددة لهيكل البيانات:

  • حالة الفشل: إذا طرأت مشكلة على العملية، يتخذ الحقل status الحالة «failed» [SWS_DM_01904].
  • تفاصيل الخطأ: في حالة الخطأ هذه، يحدد الحقل error من النوع ara::core::Optional<ara::diag::DiagSovdErrc> رمز الخطأ الذي حدث SWS Diagnostics §8.58.5.1.1 «error» [SWS_DM_01909].
  • المسار النظامي: طالما لا يوجد خطأ، يُتوقع أن يظل الحقل الاختياري error غير مشغول، نظراً لأنه مرتبط صراحةً بالحالة «failed» وفقاً للمواصفة [SWS_DM_01909]. سؤال Q-c26d1c1d25d7e938 (مفتوح)
  • خطأ في الواجهة: إذا فشل استدعاء API GetUpdatePackageStatus على مستوى المنصة، يُتوقع إرجاع حالة خطأ خاصة بالمنصة بدلاً من كائن الحالة [SWS_DM_01921]. سؤال Q-b029f911ee738cb1 (مفتوح)

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive Platform الإصدار R25-11.

خريطة الأعضاء

الثوابت

7
errorphaseprogressstatusstepstep_translation_idsubprogress

مخطط الفئة

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

عرض التفاصيل

اختر عنصرًا من المخطط.

الثوابت

error متغير

Specifies the error if status is failed.

ara::core::Optional<ara::diag::DiagSovdErrc> error;
phase متغير

Specifies the Update Status phase.

SovdUpdatePhase phase;
progress متغير

Specifies the progress of the Update phase in percentage.

ara::core::Optional<std::uint8_t> progress;
status متغير

Specifies the status of the Update phase.

SovdUpdateStatus status;
step متغير

Specifies the current step of the Update.

ara::core::String step;
step_translation_id متغير

Specifies the step_translation_id.

ara::core::String step_translation_id;
subprogress متغير

Specifies the progress of the Update phase in percent.

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

توثيق الثوابت / المتغيرات

متغير 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#14e25e68
Content hash
14e25e68
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

متغير 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#f7770fb9
Content hash
f7770fb9
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

متغير 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#3490e288
Content hash
3490e288
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

متغير 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#837fe221
Content hash
837fe221
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

متغير 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#bcc358e8
Content hash
bcc358e8
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

متغير 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#f1d296c0
Content hash
f1d296c0
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

متغير 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#890d57dd
Content hash
890d57dd
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