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

사용자 가이드AI 생성

실행 중인 소프트웨어 업데이트 패키지를 모니터링하기 위한 세부 단계, 진행률 및 오류 데이터를 제공합니다.
AI 생성 미검증 모델: 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은(는) AUTOSAR Adaptive Platform의 diag 모듈의 구성 요소입니다 SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902]. 이 구조체는 SOVD(Service-Oriented Vehicle Diagnostics)의 일환으로 소프트웨어 업데이트 패키지의 현재 상태를 기록하고 제공하기 위한 표준화된 정보 전달자 역할을 합니다. 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 호출 과정에서 생성되고 현재 상태 값으로 채워진 후 값(by value)으로 호출자에게 반환됩니다 [SWS_DM_01921]. 수명은 수신자의 스코프에 바인딩되며 해당 스코프의 소멸과 함께 종료됩니다.

C++ 객체 자체는 수동적이지만, 해당 멤버 변수는 기반 업데이트 프로세스의 수명 주기를 나타냅니다. SovdUpdatePhase 형식의 필드 phase은(는) 전체 프로세스의 현재 단계를 기술하며 SWS Diagnostics §8.58.5.1.2 “phase” [SWS_DM_01903], SovdUpdateStatus 형식의 변수 status은(는) 이 단계의 구체적인 상태를 나타냅니다 SWS Diagnostics §8.58.5.1.4 “status” [SWS_DM_01904]. 내부 뮤텍스나 동기화 메커니즘이 지정되어 있지 않으므로, 동일한 인스턴스에 대한 동시 접근 시 사용자에 의한 외부 보호 조치가 필요합니다.

사용 경로

전형적인 사용 경로는 진단 클라이언트에 의한 패키지 업데이트의 주기적 또는 이벤트 기반 모니터링을 포함합니다.

UpdatePackageStatus 조회 및 평가ClientSovdSwUpdateUpdatePackageStatusGetUpdatePackageStatus()생성 및 채움UpdatePackageStatusaltstatus == failederror(DiagSovdErrc) 평가status != failedphase, progress 및 step 읽기

시퀀스 다이어그램: UpdatePackageStatus의 멤버 변수 평가 및 상태 쿼리를 위한 호출 순서. 출처: [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909].

오류 시나리오

업데이트 프로세스의 오류는 데이터 구조체의 특정 속성을 통해 투명하게 공개됩니다.

  • 실패 상태: 프로세스에 문제가 발생하면 필드 status이(가) “failed” 상태를 취합니다 [SWS_DM_01904].
  • 오류 세부 정보: 이러한 오류 상황에서 ara::core::Optional<ara::diag::DiagSovdErrc> 형식의 필드 error은(는) 발생한 오류 코드를 명시합니다 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#2a4ef895
Content hash
2a4ef895
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#8bb42828
Content hash
8bb42828
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#f9055891
Content hash
f9055891
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#55b77e5b
Content hash
55b77e5b
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#8ab5a1c7
Content hash
8ab5a1c7
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#5de516a8
Content hash
5de516a8
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#89bbef30
Content hash
89bbef30
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