class ara::diag::SovdSwUpdate

[SWS_DM_01874] Upstream: RS_Diag_04265

class SovdSwUpdate {...};

Class to implement the SovdSwUpdate interface.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

User GuideKI-GENERIERT

Dient als Schnittstelle zur Abwicklung von Software-Updates über das ASAM-SOVD-Protokoll im AUTOSAR-Diagnoseserver.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 0456e379cc70 Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient als Schnittstelle zur Abwicklung von Software-Updates über das ASAM-SOVD-Protokoll im AUTOSAR-Diagnoseserver.

Die Klasse stellt die anwendungsseitige Schnittstelle zur Abwicklung standardisierter Software-Updates über das SOVD-Protokoll gemäß ASAM SOVD bereit [SWS_DM_01796]. Nach der Instanziierung aktiviert die Anwendung die Weiterleitung von Diagnoseanfragen an die spezifischen Update-Handler über die Methode Offer() [SWS_DM_01924]. Über asynchrone Methoden werden Pakete registriert, vorbereitet, automatisiert oder manuell installiert sowie wieder gelöscht. Sämtliche datenübertragungs- und lebenszyklusrelevanten Vorgänge werden dabei nicht-blockierend über Futures verarbeitet.

Kontext

Die Klasse ara::diag::SovdSwUpdate definiert die Schnittstelle zur Umsetzung von standardisierten Software-Updates gemäß ASAM SOVD innerhalb der AUTOSAR Adaptive Platform [SWS_DM_01874]. Da die eigentliche Geschäftslogik von Software-Aktualisierungen nicht im Funktionscluster Diagnostic Management (DM) angesiedelt ist, verbleibt die Ausführung bei der jeweiligen Applikation, während sich ara::diag::SovdSwUpdate auf die standardkonforme Abwicklung des zugrunde liegenden SOVD-Protokolls konzentriert AUTOSAR_AP_SWS_Diagnostics §7.4 „SOVD Software Update API - concept“. Für den Upload von Update-Dateien werden hierbei Übertragungsstrategien eingesetzt, wie sie für den UDS-Dienst 0x38 (RequestFileTransfer) spezifiziert sind AUTOSAR_AP_SWS_Diagnostics §7.4 „SOVD Software Update API - concept“, [SWS_DM_01923].

An den Abläufen sind drei wesentliche Komponenten beteiligt: der externe SOVD-Client, die Instanz des Diagnostic Servers (DM) zur Protokoll- und Routenverwaltung sowie die anwendungsspezifische Handler-Implementierung von ara::diag::SovdSwUpdate [SWS_DM_01796], [SWS_DM_01924].

Kontextdiagramm: Zusammenspiel von SOVD-Client, Diagnostic Server (DM) und ara::diag::SovdSwUpdate. Quellen: [SWS_DM_01796], [SWS_DM_01924], AUTOSAR_AP_SWS_Diagnostics §7.4 „SOVD Software Update API - concept“

Lebenszyklus

Die Instanziierung von ara::diag::SovdSwUpdate erfolgt über den Konstruktor unter Angabe eines ara::core::InstanceSpecifier, der auf einen Port-Prototyp eines modellierten DiagnosticSovdUpdateInterface verweist, sowie eines Nebenläufigkeitsmodus (ConcurrencyType: kConcurrent oder kNotConcurrent) [SWS_DM_01910]. Der Konstruktor ist threadsicher und ausnahmesicher spezifiziert [SWS_DM_01910]. Als Repräsentant einer eindeutigen Schnittstelleninstanz sind Kopierkonstruktor und Kopierzuweisungsoperator gelöscht (=delete) und geschützt [SWS_DM_01912], [SWS_DM_01914]. Move-Konstruktion und Move-Zuweisung sind geschützt verfügbar, jedoch nicht threadsicher [SWS_DM_01913], [SWS_DM_01915].

Die Zerstörung des Objekts wird über den virtuellen Destruktor ~SovdSwUpdate() abgewickelt, der als nicht threadsicher gilt [SWS_DM_01911]. Ob die virtuellen Callback-Methoden der Klasse nebenläufig ausgeführt werden müssen, hängt direkt vom beim Konstruktor übergebenen ConcurrencyType ab [SWS_DM_01910], [SWS_DM_01916].

Nutzungspfad

Interpretation: Da die bereitgestellten Schnittstellenmethoden rein virtuell (=0) deklariert sind, dürfte eine abgeleitete Anwendungsklasse diese implementieren, um die eigentliche Update-Ausführung vorzunehmen, während die Basisklasse die Plattform-Anbindung regelt. Frage Q-10500d9fc58503ea (offen)

Der reguläre Ablauf gliedert sich in folgende Phasen:

Bereitstellung: Nach Erzeugung des Objekts ruft die Anwendung Offer() auf, um dem Diagnostic Management die Weiterleitung eingehender SOVD-Nachrichten an diese Instanz zu ermöglichen [SWS_DM_01924].
Auskunft und Registrierung: Über GetAllUpdates() können vorhandene Update-Pakete abgefragt werden [SWS_DM_01797], [SWS_DM_01916]. Soll ein neues Paket übertragen werden, fordert der Diagnostic Server über RequestUpdatePackageRegistration() eine Registrierung an, die asynchron eine Schreibsitzung (DataTransferWriteSession) zusammen mit einer Update-Paket-ID bereitstellt [SWS_DM_01923]. Details und Status werden über GetUpdatePackageDetails() und GetUpdatePackageStatus() ermittelt [SWS_DM_01802], [SWS_DM_01917], [SWS_DM_01921].
Installation oder Löschung: Die Installation kann entweder automatisiert mittels PutUpdatePackageAutomated() angestoßen werden [SWS_DM_01799], [SWS_DM_01918] oder in zwei Schritten über PrepareUpdatePackage() [SWS_DM_01800], [SWS_DM_01919] gefolgt von ExecuteUpdatePackage() [SWS_DM_01801], [SWS_DM_01920] erfolgen. Nicht mehr benötigte Pakete werden über DeleteUpdatePackage() entfernt [SWS_DM_01922].
Beendigung: Vor dem Herunterfahren deaktiviert die Anwendung die Nachrichtenweiterleitung durch Aufruf von StopOffer() [SWS_DM_01925].

Sequenzdiagramm: Typischer Ablauf einer Paketregistrierung und -installation über SOVD. Quellen: [SWS_DM_01799], [SWS_DM_01800], [SWS_DM_01801], [SWS_DM_01919], [SWS_DM_01920], [SWS_DM_01923], [SWS_DM_01924]

Fehlerszenarien

Beim Anbieten der Dienste via Offer() können spezifische Fehler im Rückgabetyp ara::core::Result<void> auftreten: DiagOfferErrc::kAlreadyOffered, falls die Instanz bereits angeboten wird, sowie DiagOfferErrc::kConfigurationMismatch, wenn die Konfiguration nicht mit dem Diagnoseextrakt (DEXT) übereinstimmt [SWS_DM_01924].

Wird der Konstruktor mit einem fehlerhaften Modellzustand aufgerufen, werden Architekturverletzungen gemeldet, darunter InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation oder InstanceSpecifierAlreadyInUseViolation [SWS_DM_01910].

Alle funktionalen Update-Operationen geben ein ara::core::Future zurück, das im Fehlerfall Fehlercodes gemäß ASAM SOVD 1.1 bzw. ISO 17978-3 transportiert [SWS_DM_01917], [SWS_DM_01919], [SWS_DM_01920], [SWS_DM_01923]. Zudem empfangen alle asynchronen Methoden einen CancellationHandler, über den ein vorzeitiger Abbruch der laufenden Diagnoseverbindung signalisiert wird [SWS_DM_01916], [SWS_DM_01919], [SWS_DM_01923].

Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive R25-11 und wurde automatisiert erstellt.

Mitgliederkarte

Klassendiagramm

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

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Für dieses Release liegen keine Elementdaten vor

Konstruktoren und Destruktor

SovdSwUpdate function 3

Constructor for SovdSwUpdate.

Überladungen SovdSwUpdate 3

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01910

SovdSwUpdate (SovdSwUpdate const &)=delete; SWS_DM_01912

SovdSwUpdate (SovdSwUpdate &&other) noexcept; SWS_DM_01913

~SovdSwUpdate function

Destructor of class SovdSwUpdate.

virtual ~SovdSwUpdate () noexcept;

Methoden

DeleteUpdatePackage function

Called for SOVD method "Delete Update Package from an SOVD Server".

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

ExecuteUpdatePackage function

Called for SOVD method "Execute Installation of an Update".

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetAllUpdates function

Called for SOVD method "Retrieve List of All Updates".

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

GetUpdatePackageDetails function

Called for SOVD method "Get Details of Update".

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetUpdatePackageStatus function

Called for SOVD method "Get Status of an Update".

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Offer function

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;

PrepareUpdatePackage function

Called for SOVD method "Prepare Installation of an Update".

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

PutUpdatePackageAutomated function

Called for SOVD method "Automated Installation of an Update".

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

RequestUpdatePackageRegistration function

Called for SOVD method "Register an Update at the SOVD Server".

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

StopOffer function

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () const noexcept;

Operatoren

operator= function 2

SovdSwUpdate shall be a single not assignable instance.

Überladungen = 2

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete; SWS_DM_01914

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept; SWS_DM_01915

Eingebettete Typen

SubProgress class

UpdatePackageDetails class

UpdatePackageStatus class

Klicke auf einen Eintrag, um seine Bezüge zu sehen.

Dokumentation der Methoden

function DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Delete Update Package from an SOVD Server".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 8b58fd563e10 Herkunft

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die rein virtuelle Funktion DeleteUpdatePackage der Klasse ara::diag::SovdSwUpdate wird gemäß [SWS_DM_01803] von der Instanz des Diagnostic Servers aufgerufen, wenn die SOVD-Methode „Delete Update Package from an SOVD Server“ ausgeführt werden soll ([SWS_DM_01922]). Sie stößt das serverseitige Entfernen eines Update-Pakets an.

Der Aufruf erfolgt asynchron und liefert ein ara::core::Future<void> zurück, welches den erfolgreichen Abschluss anzeigt oder ein Fehlerobjekt bereitstellt [SWS_DM_01922]. Die Signatur verlangt folgende Eingabeparameter:

updatePackageId: Bezeichnet als ara::core::String die eindeutige ID des zu löschenden Update-Pakets.
metaInfo: Übergibt als MetaInfo const& zusätzliche Kontextinformationen der Anfrage.
cancellationHandler: Übermittelt ein Objekt vom Typ CancellationHandler, das darüber informiert, ob die aktuelle Konversation abgebrochen wurde.

Tritt während der Verarbeitung ein Fehler auf, wird das Future mit einem entsprechenden SOVD-Fehler belegt. Die Spezifikation schreibt hierfür die Verwendung passender Fehlercodes aus ASAM SOVD 1.1 oder ISO 17978-3 vor [SWS_DM_01922].

In Bezug auf die Nebenläufigkeit ist die Methode als bedingt threadsicher definiert: Ob die Implementierung thread-safe oder non-thread-safe ausgeführt sein muss, wird über den im Konstruktor übergebenen ConcurrencyType festgelegt [SWS_DM_01922]. Zudem ist die Funktion als noexcept und exceptionsicher deklariert, weshalb keine Ausnahmen entweichen dürfen.

Dieser Nutzungshinweis basiert auf der Spezifikation AUTOSAR Adaptive R25-11 und wurde durch eine KI generiert.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id to be deleted
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01922
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01922@rel:R25-11#6203bff4
Content hash: 6203bff4
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01922

Status: valid/unmigrated Version: rel:R25-11#3e5d5362 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_01922@rel:R25-11#3e5d5362

Recorded Revisions (4):

R25-11rel:R25-11#6203bff42026-09-30
R23-11rel:R23-11#af1834882026-10-14
R24-11rel:R24-11#113a04fa2026-10-14
R25-11rel:R25-11#3e5d53622026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Execute Installation of an Update".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: df9b45c15e08 Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die pure-virtual-Methode ExecuteUpdatePackage der Schnittstelle ara::diag::SovdSwUpdate dient der Ausführung der SOVD-Methode „Execute Installation of an Update“ [SWS_DM_01920]. Die Deklaration findet sich im Header ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 „ExecuteUpdatePackage“. Als Eingabeparameter werden die Kennung des Update-Pakets (updatePackageId) sowie Anforderungsdaten (metaInfo) übergeben [SWS_DM_01920]. Zusätzlich informiert das Objekt cancellationHandler darüber, falls die laufende Konversation abgebrochen wurde [SWS_DM_01920]. Der Aufruf erfolgt asynchron und liefert ein ara::core::Future<void> zurück, welches ein positives Ergebnis bereitstellt oder einen SOVD-Fehler meldet [SWS_DM_01920].

Fehlerbehandlung

Die Schnittstelle ist als noexcept und ausnahmesicher („exception safe“) spezifiziert [SWS_DM_01920]. Fehler während der Ausführung dürfen folglich nicht über C++-Exceptions geworfen werden, sondern sind asynchron über das ara::core::Future mit anwendbaren Fehlercodes aus ASAM SOVD 1.1 oder ISO 17978-3 zurückzugeben [SWS_DM_01920].

Nebenläufigkeit und Randbedingungen

Hinsichtlich der Thread-Sicherheit besteht eine bedingte Anforderung („conditional“): Ob die Funktion threadsicher oder nicht-threadsicher implementiert werden muss, wird über den Parameter ConcurrencyType festgelegt, der dem Konstruktor übergeben wurde [SWS_DM_01920]. Die Implementierung dürfte den cancellationHandler auswerten müssen, um die Paketinstallation bei einem Abbruch der Konversation geordnet zu beenden [SWS_DM_01920]. Frage Q-8fe6950e8f5a168c (offen)

Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe. Verbindlich sind ausschließlich die offiziellen AUTOSAR-Spezifikationen.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be executed
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01920
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01920@rel:R25-11#da839410
Content hash: da839410
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01920

Status: valid/unmigrated Version: rel:R25-11#250ba828 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_01920@rel:R25-11#250ba828

Recorded Revisions (4):

R25-11rel:R25-11#da8394102026-09-30
R23-11rel:R23-11#c3f2b7802026-10-14
R24-11rel:R24-11#f4456b492026-10-14
R25-11rel:R25-11#250ba8282026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for SOVD method "Retrieve List of All Updates".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
targetVersion	Optional parameter to be used if the target-version query parameter is used in the request. If the parameter is not set the String shall be left empty. set in the request the String shall be left empty
origin	Optional parameter to be used if the origin query parameter is used in the request. If the parameter is not set the String shall be left empty
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<ara::core::Vector<ara::core::String > >	A future with a span of all update package ids. The span shall not be modified until the releaseHandler is called.

Fehler

Fehlercode	Beschreibung
This function does not specify any standardized errors.

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

Record: AUTOSAR/AP/record/SWS_DM_01916
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01916@rel:R25-11#cfb37af3
Content hash: cfb37af3
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01916

Status: valid/unmigrated Version: rel:R25-11#fa31eee5 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_01916@rel:R25-11#fa31eee5

Recorded Revisions (4):

R25-11rel:R25-11#cfb37af32026-09-30
R23-11rel:R23-11#1313500b2026-10-14
R24-11rel:R24-11#2fff52ce2026-10-14
R25-11rel:R25-11#fa31eee52026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Details of Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageDetails >	A future with the details of the requested update package or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01917
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01917@rel:R25-11#5194b7fa
Content hash: 5194b7fa
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01917

Status: valid/unmigrated Version: rel:R25-11#08879f75 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_01917@rel:R25-11#08879f75

Recorded Revisions (4):

R25-11rel:R25-11#5194b7fa2026-09-30
R23-11rel:R23-11#bed00f3c2026-10-14
R24-11rel:R24-11#71be4b722026-10-14
R25-11rel:R25-11#08879f752026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Status of an Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of which the status shall be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageStatus >	A future with either the current UpdatePackageStatus or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01921
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01921@rel:R25-11#6c5291e8
Content hash: 6c5291e8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01921

Status: valid/unmigrated Version: rel:R25-11#a8720fc8 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_01921@rel:R25-11#a8720fc8

Recorded Revisions (4):

R25-11rel:R25-11#6c5291e82026-09-30
R23-11rel:R23-11#6a27c4202026-10-14
R24-11rel:R24-11#f41bfa0b2026-10-14
R25-11rel:R25-11#a8720fc82026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function Offer [SWS_DM_01924] Upstream: RS_Diag_04265

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 5d09bdcb924c Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Elementfunktion ara::diag::SovdSwUpdate::Offer registriert den Handler für SOVD-Software-Updates beim Diagnostic Management (DM), um diesem die Weiterleitung eingehender Anfrage-Nachrichten an den Handler zu ermöglichen [SWS_DM_01924]. Der Aufruf erfolgt synchron und parameterlos über den Header ara/diag/sovd_sw_update.h und löst gemäß noexcept keine C++-Ausnahmen aus [SWS_DM_01924].

Das Ergebnis der Operation wird als ara::core::Result<void> zurückgegeben [SWS_DM_01924]. Schlägt die Bereitstellung fehl, liefert die Funktion einen Fehler mit Rollback-Semantik [SWS_DM_01924]:

DiagOfferErrc::kAlreadyOffered: Der Dienst wurde für diesen Handler bereits zuvor erfolgreich angeboten [SWS_DM_01924].
DiagOfferErrc::kConfigurationMismatch: Die Monitor-Konfiguration stimmt nicht mit der DEXT-Konfiguration überein [SWS_DM_01924].

Bezüglich der Nebenläufigkeit ist die Methode als exception safe, aber ausdrücklich als nicht threadsicher (not thread-safe) spezifiziert [SWS_DM_01924]. Interpretation: Bei Zugriffen aus mehreren Threads dürfte daher eine externe, anwendungsseitige Synchronisation erforderlich sein. Frage Q-4636ad27701d59df (offen) Das Bereitstellungsprinzip via Offer entspricht dem generellen Schema für Diagnose-Handler wie [SWS_DM_00557] oder [SWS_DM_00735], bei denen der DM Anfragen erst weiterleiten kann, sobald die entsprechende Schnittstelle aktiv angeboten wird [SWS_DM_01525].

Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagOfferErrc::kConfigurationMismatch	rollback_semantics monitor configuration does not match DEXT
DiagOfferErrc::kAlreadyOffered	rollback_semantics The service is already offered.

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

Record: AUTOSAR/AP/record/SWS_DM_01924
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01924@rel:R25-11#4434cb65
Content hash: 4434cb65
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01924

Status: valid/unmigrated Version: rel:R25-11#1b6fc58c 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_01924@rel:R25-11#1b6fc58c

Recorded Revisions (4):

R25-11rel:R25-11#4434cb652026-09-30
R23-11rel:R23-11#032ce7bb2026-10-14
R24-11rel:R24-11#438685592026-10-14
R25-11rel:R25-11#1b6fc58c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Prepare Installation of an Update".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 90a902e7c6d4 Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die rein virtuelle Methode PrepareUpdatePackage der Schnittstelle ara::diag::SovdSwUpdate dient der Vorbereitung der Installation eines Software-Update-Pakets im Rahmen der SOVD-Methode „Prepare Installation of an Update“ gemäß [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 „PrepareUpdatePackage“).

Aufruf und Parameter

Die Funktion wird über den Header ara/diag/sovd_sw_update.h bereitgestellt und nimmt folgende Parameter entgegen:

updatePackageId: Bezeichner (ara::core::String) des vorzubereitenden Update-Pakets.
metaInfo: Metadaten (MetaInfo const&) zur eingehenden SOVD-Anforderung.
cancellationHandler: Überwachungsobjekt (CancellationHandler), das über den Abbruch der aktuellen Konversation informiert.

Der Aufruf ist als noexcept spezifiziert und verhält sich exception-safe. Das asynchrone Ergebnis wird über ein ara::core::Future<void> bereitgestellt, welches entweder den erfolgreichen Abschluss signalisiert oder einen Fehler bereitstellt [SWS_DM_01919].

Fehlerbehandlung und Nebenläufigkeit

Tritt während der Vorbereitung ein Fehler auf, ist im Future ein passender Fehlercode gemäß ASAM SOVD 1.1 oder ISO 17978-3 zurückzugeben [SWS_DM_01919]. Hinsichtlich der Thread-Sicherheit gilt eine bedingte Anforderung (conditional): Ob die Funktion threadsicher implementiert werden muss, wird über den bei der Instanziierung im Konstruktor angegebenen ConcurrencyType festgelegt [SWS_DM_01919]. Über das Objekt cancellationHandler dürfte die Anwendung langwierige Vorbereitungsschritte abbrechen können, falls die Anfrage vorzeitig beendet wird. Frage Q-be4c53d9a0427ed5 (offen)

Dieser Text wurde von einer KI auf Basis der AUTOSAR-Spezifikation erstellt.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be prepared
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01919
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01919@rel:R25-11#d529788a
Content hash: d529788a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01919

Status: valid/unmigrated Version: rel:R25-11#7bdc8dcb 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_01919@rel:R25-11#7bdc8dcb

Recorded Revisions (4):

R25-11rel:R25-11#d529788a2026-09-30
R23-11rel:R23-11#cb96813b2026-10-14
R24-11rel:R24-11#124b85892026-10-14
R25-11rel:R25-11#7bdc8dcb2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Automated Installation of an Update".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: a14ff9457ed9 Herkunft

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die rein virtuelle Methode PutUpdatePackageAutomated wird im Kontext der SOVD-Methode „Automated Installation of an Update“ aufgerufen [SWS_DM_01918]. Sie ist im Header ara/diag/sovd_sw_update.h innerhalb der Klasse ara::diag::SovdSwUpdate deklariert AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 „PutUpdatePackageAutomated“. Die Funktion dient dazu, ein durch seine Kennung spezifiziertes Update-Paket automatisiert zu installieren.

Die Schnittstelle erwartet die folgenden Eingabeparameter:

updatePackageId (ara::core::String): Kennung des Update-Pakets, das der automatisierten Installation übergeben werden soll [SWS_DM_01918].
metaInfo (MetaInfo const &): Metainformationen der eingehenden Dienstanforderung [SWS_DM_01918].
cancellationHandler (CancellationHandler): Informiert die Operation darüber, ob die laufende Konversation abgebrochen wurde [SWS_DM_01918].

Der Aufruf besitzt eine asynchrone Semantik. Als Rückgabewert dient ein ara::core::Future<void>, das nach Abschluss entweder die erfolgreiche Durchführung anzeigt oder einen Fehlerzustand enthält [SWS_DM_01918].

Fehlerbehandlung und Nebenläufigkeit

Im Fehlerfall ist über das Future ein anwendbarer Fehlercode aus ASAM SOVD 1.1 oder ISO 17978-3 zurückzugeben [SWS_DM_01918]. Die Methode ist als ausnahmesicher (exception safe) spezifiziert und wirft als noexcept-Funktion keine C++-Ausnahmen AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 „PutUpdatePackageAutomated“.

Die Thread-Sicherheit der Methode ist bedingt (conditional): Ob die Implementierung thread-safe oder non-thread-safe ausgeführt werden muss, wird über den beim Konstruktoraufruf übergebenen ConcurrencyType festgelegt [SWS_DM_01918].

Dieser Nutzungshinweis wurde automatisiert anhand der AUTOSAR-Spezifikation für das Release R25-11 erstellt.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be put to automated
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01918
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01918@rel:R25-11#cde948f4
Content hash: cde948f4
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01918

Status: valid/unmigrated Version: rel:R25-11#befb20e2 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_01918@rel:R25-11#befb20e2

Recorded Revisions (4):

R25-11rel:R25-11#cde948f42026-09-30
R23-11rel:R23-11#97eae9312026-10-14
R24-11rel:R24-11#0f5da9f52026-10-14
R25-11rel:R25-11#befb20e22026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function RequestUpdatePackageRegistration [SWS_DM_01923] Upstream: RS_Diag_04265

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

Called for SOVD method "Register an Update at the SOVD Server".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: bf978796d20b Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die rein virtuelle Funktion RequestUpdatePackageRegistration der Klasse ara::diag::SovdSwUpdate bedient die SOVD-Methode „Register an Update at the SOVD Server“ [SWS_DM_01923]. Sie leitet die Registrierung eines Update-Pakets auf dem Server ein und initiiert die zugehörige Übertragungssitzung AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 „RequestUpdatePackageRegistration“.

Der Aufruf erfolgt asynchron und liefert ein ara::core::Future zurück, das im Erfolgsfall ein Tupel bestehend aus einer DataTransferWriteSession und einer ara::core::String mit der Update-Paket-ID enthält [SWS_DM_01923]. Beim Aufruf werden folgende Parameter übergeben:

metaInfo: Metainformationen der eingehenden Anfrage.
expectedSize: optionale erwartete Gesamtgröße des Pakets (ara::core::Optional<uint64_t>), sofern in der Anfrage deklariert.
cancellationHandler: signalisiert, falls die aktuelle Konversation abgebrochen wird.

Die Methode ist als noexcept definiert und ausnahmesicher [SWS_DM_01923]. Fehler werden folglich nicht über C++-Exceptions gemeldet, sondern asynchron über das Future bereitgestellt; hierfür sind die entsprechenden Fehlercodes aus ASAM SOVD 1.1 bzw. ISO 17978-3 einzusetzen [SWS_DM_01923].

Die Thread-Sicherheit ist bedingt („conditional“): Ob die Methode threadsicher implementiert werden muss, wird über den im Konstruktor angegebenen ConcurrencyType festgelegt [SWS_DM_01923]. Die konkrete Implementierung dürfte daher je nach Instanziierung eigene Synchronisationsmechanismen erfordern. Frage Q-7e80e557bdd7627a (offen)

Dieser Text wurde durch eine KI erstellt und dient der Unterstützung bei der Nutzung des API-Elements.

Implementer's Guide folgt (Komplexität I1)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
metaInfo	MetaInfo of the request.
expectedSize	Specifies the expected size if available in the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, ara::core::String > >	A future with either an instance of a "SOVD file writing session" with the corresponding update package id or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

Record: AUTOSAR/AP/record/SWS_DM_01923
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01923@rel:R25-11#0245e3c0
Content hash: 0245e3c0
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01923

Status: valid/unmigrated Version: rel:R25-11#b092f8d8 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_01923@rel:R25-11#b092f8d8

Recorded Revisions (4):

R25-11rel:R25-11#0245e3c02026-09-30
R23-11rel:R23-11#c6f57bb12026-10-14
R24-11rel:R24-11#5e5e1b832026-10-14
R25-11rel:R25-11#b092f8d82026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function SovdSwUpdate [SWS_DM_01910] Upstream: RS_Diag_04265, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept;

Constructor for SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Verletzungen (Violations)	InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticSovdUpdatePortMapping needs to be typed by a DiagnosticSovdUpdateInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

Parameter	Beschreibung
instanceSpecifier	InstanceSpecifier to a PortPrototype of a DiagnosticSovdUpdateInterface service instance in the manifest.
concurrencyType	Specifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

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

Record: AUTOSAR/AP/record/SWS_DM_01910
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01910@rel:R25-11#5bc9aa6d
Content hash: 5bc9aa6d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01910

Status: valid/unmigrated Version: rel:R25-11#39b10a70 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_01910@rel:R25-11#39b10a70

Recorded Revisions (4):

R25-11rel:R25-11#5bc9aa6d2026-09-30
R23-11rel:R23-11#cb3f1d3a2026-10-14
R24-11rel:R24-11#71a1ee492026-10-14
R25-11rel:R25-11#39b10a702026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function SovdSwUpdate [SWS_DM_01912] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not copy-able instance.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Sichtbarkeit	protected

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

Record: AUTOSAR/AP/record/SWS_DM_01912
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01912@rel:R25-11#29457c01
Content hash: 29457c01
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01912

Status: valid/unmigrated Version: rel:R25-11#a9b2eed0 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_01912@rel:R25-11#a9b2eed0

Recorded Revisions (4):

R25-11rel:R25-11#29457c012026-09-30
R23-11rel:R23-11#920c2b292026-10-14
R24-11rel:R24-11#a9b2eed02026-10-14
R25-11rel:R25-11#a9b2eed02026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function SovdSwUpdate [SWS_DM_01913] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate &&other) noexcept;

Move constructs an instance of SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	unsafe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

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

Record: AUTOSAR/AP/record/SWS_DM_01913
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01913@rel:R25-11#662a98ac
Content hash: 662a98ac
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01913

Status: valid/unmigrated Version: rel:R25-11#4c757859 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_01913@rel:R25-11#4c757859

Recorded Revisions (4):

R25-11rel:R25-11#662a98ac2026-09-30
R23-11rel:R23-11#2175e3ea2026-10-14
R24-11rel:R24-11#4c7578592026-10-14
R25-11rel:R25-11#4c7578592026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function StopOffer [SWS_DM_01925] Upstream: RS_Diag_04265

void StopOffer () const noexcept;

This StopOffer will disable the forwarding of request messages from DM.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: dee04ad7b94a Herkunft Offene Fragen (1)

KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die Methode ara::diag::SovdSwUpdate::StopOffer beendet das Anbieten des Dienstes und deaktiviert die Weiterleitung eingehender Anfrage-Nachrichten vom Diagnostic Management (DM) an die Software-Update-Komponente [SWS_DM_01925]. Der Aufruf erfolgt über die Schnittstelle aus ara/diag/sovd_sw_update.h, ist parameterlos und liefert keinen Rückgabewert [SWS_DM_01925]. Das Beenden der Dienstbereitstellung erfolgt synchron und entspricht der konzeptionellen Deaktivierung von Diagnosefunktionalitäten in AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 „Monitors“.

Fehlerbehandlung und Nebenläufigkeit

Die Funktion besitzt die Spezifikation noexcept und ist damit ausnahmesicher; Fehlerzustände über Ausnahmen oder Fehlercodes sind nicht vorgesehen [SWS_DM_01925]. Für den Aufrufkontext gilt, dass die Funktion als nicht threadsicher („not thread-safe“) definiert ist [SWS_DM_01925]. Parallele Aufrufe auf derselben Instanz müssen anwendungsseitig synchronisiert werden. Interpretation: Ein wiederholter Aufruf von StopOffer im bereits inaktiven Zustand dürfte ohne Fehlerwirkung bleiben, da keine Fehlerbehandlung existiert. Frage Q-efaccde5507eb444 (offen)

Zusammenspiel

Im Gesamtsystem fügt sich die Funktion in das einheitliche Schema des DM-Dienstlebenszyklus ein. Sie bildet das funktionale Pendant zum Anbieten des Dienstes und verhält sich analog zu den Deaktivierungsoperationen anderer Diagnosedienste wie ara::diag::DownloadService [SWS_DM_00793], ara::diag::GenericUDSService [SWS_DM_00620] sowie ara::diag::EcuResetRequest [SWS_DM_01017].

Dieser Text wurde von einer KI auf Basis der Spezifikation AUTOSAR R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_DM_01925
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01925@rel:R25-11#60438b2c
Content hash: 60438b2c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01925

Status: valid/unmigrated Version: rel:R25-11#b5890de5 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_01925@rel:R25-11#b5890de5

Recorded Revisions (4):

R25-11rel:R25-11#60438b2c2026-09-30
R23-11rel:R23-11#aac09bc62026-10-14
R24-11rel:R24-11#b5890de52026-10-14
R25-11rel:R25-11#b5890de52026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function operator= [SWS_DM_01914] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not assignable instance.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Sichtbarkeit	protected

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

Record: AUTOSAR/AP/record/SWS_DM_01914
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01914@rel:R25-11#f9334917
Content hash: f9334917
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01914

Status: valid/unmigrated Version: rel:R25-11#193efe55 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_01914@rel:R25-11#193efe55

Recorded Revisions (4):

R25-11rel:R25-11#f93349172026-09-30
R23-11rel:R23-11#bd4a8b212026-10-14
R24-11rel:R24-11#193efe552026-10-14
R25-11rel:R25-11#193efe552026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function operator= [SWS_DM_01915] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept;

Move assigns an instance of SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
SovdSwUpdate &	Reference to self

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

Record: AUTOSAR/AP/record/SWS_DM_01915
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01915@rel:R25-11#9f73c122
Content hash: 9f73c122
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01915

Status: valid/unmigrated Version: rel:R25-11#1ed1cfe6 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_01915@rel:R25-11#1ed1cfe6

Recorded Revisions (4):

R25-11rel:R25-11#9f73c1222026-09-30
R23-11rel:R23-11#7eb86d6a2026-10-14
R24-11rel:R24-11#1ed1cfe62026-10-14
R25-11rel:R25-11#1ed1cfe62026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

function ~SovdSwUpdate [SWS_DM_01911] Upstream: RS_Diag_04265

virtual ~SovdSwUpdate () noexcept;

Destructor of class SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

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

Record: AUTOSAR/AP/record/SWS_DM_01911
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01911@rel:R25-11#7b4f357a
Content hash: 7b4f357a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01911

Status: valid/unmigrated Version: rel:R25-11#2b411c6a 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_01911@rel:R25-11#2b411c6a

Recorded Revisions (4):

R25-11rel:R25-11#7b4f357a2026-09-30
R23-11rel:R23-11#0a7ddd152026-10-14
R24-11rel:R24-11#5ddc97882026-10-14
R25-11rel:R25-11#2b411c6a2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

class ara::diag::SovdSwUpdate

User GuideKI-GENERIERT

Kontext

Lebenszyklus

Nutzungspfad

Fehlerszenarien

Mitgliederkarte

Konstruktoren und Destruktor

Methoden

Operatoren

Eingebettete Typen

Klassendiagramm

Detailansicht

Konstruktoren und Destruktor

Methoden

Operatoren

Eingebettete Typen

Dokumentation der Methoden

function DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

Verwendung

Fehlerbehandlung

Nebenläufigkeit und Randbedingungen

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function Offer [SWS_DM_01924] Upstream: RS_Diag_04265

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

Aufruf und Parameter

Fehlerbehandlung und Nebenläufigkeit

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

function PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

Verwendung