Ermöglicht der Applikation die Bereitstellung von Steuergerätedaten für UDS-Uploads an das Diagnostic Management.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: e2e1ae703412HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Ermöglicht der Applikation die Bereitstellung von Steuergerätedaten für UDS-Uploads an das Diagnostic Management.
Die Klasse ara::diag::UploadService dient als anwendungsseitige Serviceschnittstelle zur Bereitstellung von Steuergerätedaten für externe Diagnose-Uploads gemäß UDS [SWS_DM_00797]. Nach erfolgreicher Aktivierung über Offer() bearbeitet der Handler asynchron die aufeinanderfolgenden Anfragen zur Upload-Initiierung, Datenblockübertragung und Transferbeendigung [SWS_DM_00802]. Die nicht kopierbare Dienstinstanz unterstützt dabei sowohl blockweise Datenübergaben als auch den vorzeitigen Abbruch über einen Stornierungshandler. Fehlerhafte Anfragen quittiert der Handler über negative UDS-Rückgabecodes innerhalb der asynchronen Antwort-Futures.
Kontext
Die Klasse ara::diag::UploadService definiert die zentrale Dienstschnittstelle für Diagnose-Upload-Operationen innerhalb der AUTOSAR Adaptive Platform [SWS_DM_00797]. Sie fungiert als anwendungsseitiger Handler zur Auslesung und Bereitstellung fahrzeuginterner Daten an externe Prüfgeräte gemäß dem Diagnosestandard UDS (ISO 14229-1) [SWS_DM_00799].
In der Systemarchitektur interagiert ara::diag::UploadService im Wesentlichen mit zwei Partnern: dem externen Diagnose-Client (Tester) und dem plattformseitigen Diagnose-Dämon Diagnostic Management (DM) [SWS_DM_00799], [SWS_DM_00802]. Das DM nimmt eingehende UDS-Dienstanforderungen wie RequestUpload, TransferData und RequestTransferExit auf Protokollebene entgegen, validiert diese und leitet die fachlichen Abfragen an den registrierten Handler der Applikation weiter [SWS_DM_00799], [SWS_DM_00800], [SWS_DM_00801]. Die Applikationsinstanz implementiert die virtuellen Methoden der Schnittstelle, um die eigentlichen Datenblöcke aus dem Speicher zu lesen und zurückzugeben [SWS_DM_00800].
Kontextdiagramm: Einbindung des Upload-Dienstes zwischen Diagnose-Client, Diagnostic Management und Applikationshandler. Quellen: [SWS_DM_00797], [SWS_DM_00799], [SWS_DM_00802].
Lebenszyklus
Eine Instanz von ara::diag::UploadService wird unter Angabe eines ara::core::InstanceSpecifier sowie des Nebenläufigkeitsverhaltens concurrencyType konstruiert [SWS_DM_00797]. Der Spezifizierer verknüpft die Instanz mit einem modellierten Port-Prototyp des Typs DiagnosticUploadInterface[SWS_DM_00797]. Der Konstruktor ist ausnahmesicher und threadsicher spezifiziert [SWS_DM_00797]. Um eine eindeutige Zuordnung der Dienstinstanz zu garantieren, sind Kopier- und Verschiebekonstruktoren sowie Zuweisungsoperatoren explizit gelöscht [SWS_DM_01671], [SWS_DM_01672], [SWS_DM_01673], [SWS_DM_01674].
Nach der Instanziierung befindet sich der Dienst zunächst im inaktiven Zustand; das DM leitet noch keine Anfragen weiter. Erst durch den expliziten Aufruf von Offer() wird die Weiterleitung aktiviert [SWS_DM_00802]. Über StopOffer() kann das Weiterleiten von Anforderungen jederzeit wieder unterbunden werden [SWS_DM_00803]. Sowohl Offer() als auch StopOffer() sind als nicht threadsicher definiert und bedürfen einer externen Synchronisation bei Aufrufen aus mehreren Threads [SWS_DM_00802], [SWS_DM_00803].
Die Zerstörung erfolgt über den virtuellen Destruktor ~UploadService(), welcher ebenfalls nicht threadsicher ist [SWS_DM_00798]. Vor Freigabe des Objekts sollte der Dienst daher ordnungsgemäß via StopOffer() deregistriert werden [SWS_DM_00803]. Ob die virtuellen Bearbeitungsmethoden intern threadsicher ausgeführt werden müssen, bestimmt der bei der Konstruktion konfigurierte ConcurrencyType (kConcurrent oder kNotConcurrent) [SWS_DM_00797], [SWS_DM_00799].
Nutzungspfad
Der reguläre Ablauf einer Upload-Sitzung vollzieht sich in mehreren aufeinanderfolgenden Schritten:
Dienstbereitstellung: Die Applikation initialisiert den Handler und ruft Offer() auf, um eingehende Diagnoseanfragen vom DM entgegenzunehmen [SWS_DM_00802].
Upload anfordern (RequestUpload): Trifft eine UDS-Anfrage zur Upload-Initiierung ein, ruft das DM die Methode RequestUpload() auf [SWS_DM_00799]. Der Handler prüft Datenformat, Adressierungsformat sowie Speicheradresse und -länge (memoryAddressAndSize). Der übergebene Speicherbereich bleibt gültig, bis das zurückgegebene ara::core::Future<void> erfüllt ist oder der Vorgang abgebrochen wird [SWS_DM_00799].
Datenblöcke übertragen (UploadData): Nach erfolgreicher Initiierung sendet der Tester UDS-TransferData-Anfragen. Das DM ruft daraufhin wiederholt UploadData() auf [SWS_DM_00800]. Die Applikation liest den angeforderten Datenblock und liefert ihn über ein ara::core::Future<OperationOutput> zurück; die Bytes in OperationOutput.responseData werden in der positiven Antwort hinter dem Blockzähler platziert [SWS_DM_00800]. Interpretation: Die Pufferbegrenzung numBytesToReturn dürfte hierbei als maximale Chunk-Größe für die interne Pufferung des DM fungieren, sodass umfangreichere Speicherbereiche sequenziell über aufeinanderfolgende Aufrufe segmentiert werden. Frage Q-6ede2e3041d99294 (offen)
Transfer beenden (RequestUploadExit): Zum Abschluss ruft das DM RequestUploadExit() auf und übergibt die herstellerspezifischen Transfer-Parameter im transferRequestParameterRecord[SWS_DM_00801]. Der Handler validiert den Abschluss und liefert optionale Rückgabeparameter im OperationOutput zurück [SWS_DM_00801].
Dienst deaktivieren: Nach Abschluss aller Upload-Transaktionen oder beim Herunterfahren beendet die Applikation die Weiterleitung mit StopOffer()[SWS_DM_00803].
Während der gesamten Datenübertragung erhält der Handler ein CancellationHandler-Objekt. Über dieses kann mittels IsCanceled() aktiv der Stornierungsstatus abgefragt oder über SetNotifier() ein Callback registriert werden, falls der Tester den Dialog vorzeitig abbricht [SWS_DM_00799], [SWS_DM_00800], [SWS_DM_00801].
Fehlerzustände können bei der Konstruktion, während der Aktivierung sowie bei der eigentlichen Datenabwicklung auftreten:
Modell- und Konfigurationsverletzungen: Stimmt die Konfiguration nicht mit dem ARXML-Modell überein, treten beim Konstruktoraufruf Verletzungen auf [SWS_DM_00797]. Hierzu zählen InstanceSpecifierMappingIntegrityViolation (Spezifizierer verweist nicht auf einen PortPrototype), PortInterfaceMappingViolation (fehlende Verknüpfung via DiagnosticServiceGenericMapping), ProcessMappingViolation (keine Übereinstimmung mit dem modellierten Prozess) sowie InstanceSpecifierAlreadyInUseViolation (mehrfache Nutzung desselben Spezifizierers innerhalb eines Prozesses) [SWS_DM_00797].
Mehrfache Dienstaktivierung: Wird Offer() aufgerufen, während der Dienst bereits angeboten wird, schlägt der Aufruf fehl und liefert im ara::core::Result<void> den Fehlercode DiagOfferErrc::kAlreadyOffered zurück [SWS_DM_00802].
UDS-Fehlerantworten (Negative Response): Kann der Handler eine Anforderung in RequestUpload(), UploadData() oder RequestUploadExit() fachlich nicht bedienen (z. B. unzulässige Speicheradressen, Formatfehler oder ungültige Sequenzzähler), signalisiert er dies durch Bereitstellung eines Fehlercodes aus DiagUdsNrcErrc im zurückgegebenen Future[SWS_DM_00799], [SWS_DM_00800], [SWS_DM_00801]. Das DM generiert daraufhin eine standardkonforme negative UDS-Antwort (NRC) an das externe Prüfgerät [SWS_DM_00799].
Dieser Leitfaden basiert ausschließlich auf der Spezifikation AUTOSAR Adaptive Platform Release R25-11.
This Offer will enable the DM to forward request messages to this handler.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: dce89cbe34efHerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung und Semantik
Die synchrone Member-Funktion Offer der Klasse ara::diag::UploadService ([SWS_DM_00802]) aktiviert die Weiterleitung von Diagnoseanfragen durch das Diagnostic Management (DM) an den registrierten Handler. Der Aufruf nimmt keine Parameter entgegen und deklariert die Exception-Sicherheit noexcept ([SWS_DM_00802]). Als Rückgabetyp fungiert ara::core::Result<void>, worüber die erfolgreiche Bereitstellung oder ein aufgetretener Fehler abgebildet wird ([SWS_DM_00802]).
Fehlerbehandlung und Nebenläufigkeit
Fehlercodes: Falls der Service bereits zuvor angeboten wurde, schlägt die Ausführung mit dem Fehlercode DiagOfferErrc::kAlreadyOffered fehl ([SWS_DM_00802]); hierbei gilt Rollback-Semantik.
Thread-Sicherheit: Die Funktion ist explizit als not thread-safe spezifiziert ([SWS_DM_00802]). Nebenläufige Aufrufe auf derselben Service-Instanz müssen anwendungsseitig synchronisiert werden.
Zusammenspiel im Diagnose-Subsystem
Die Operation fügt sich in das einheitliche Bereitstellungsmuster adaptiver Diagnose-Handler ein, wie es unter anderem bei DownloadService ([SWS_DM_00792]) oder GenericUDSService ([SWS_DM_00619]) zum Einsatz kommt. Solange die Bereitstellung nicht erfolgt ist, leitet der DM keine eingehenden Diagnosenachrichten an den Handler weiter (vgl. analoge Verhaltensweisen in [SWS_DM_01525]). Interpretation: Der Aufruf von Offer dürfte typischerweise während der Initialisierungsphase der Anwendung erfolgen, bevor Diagnoseverkehr entgegengenommen wird. Frage Q-aba091d233b5e45b (offen)
Dieser Nutzungshinweis wurde automatisiert anhand der AUTOSAR-Spezifikation R25-11 generiert.
dataFormatIdentifier und addressAndLengthFormatIdentifier: UDS-Formatkennungen für Daten, Speicheradresse und Längenangaben.
memoryAddressAndSize: Ein ara::core::Span mit Speicheradresse und -größe, dessen Gültigkeit bis zur Erfüllung des Promises bzw. zum Abbruch der Verarbeitung garantiert ist.
metaInfo: Metainformationen zur Diagnoseanforderung.
cancellationHandler: Dient der Abfrage des Abbruchstatus via cancellationHandler.IsCanceled und der Registrierung von Benachrichtigungsfunktionen mittels cancellationHandler.SetNotifier.
Die Verarbeitung erfolgt asynchron mit dem Rückgabetyp ara::core::Future<void>[SWS_DM_00799].
Fehlerbehandlung
Im Fehlerfall stellt das ara::core::Future einen passenden UDS-NRC-Fehlercode gemäß ISO 14229-1 über DiagUdsNrcErrc bereit, woraufhin eine negative Rückmeldung erfolgt [SWS_DM_00799]. Bei positiver Antwort meldet der Diagnostic Manager das Sicherheitsereignis SEV_UDS_REQUEST_UP_DOWNLOAD_SUCCESSFUL an das IdsM [SWS_DM_02031], bei negativer Antwort das Ereignis SEV_UDS_REQUEST_UP_DOWNLOAD_FAILED[SWS_DM_02033].
Nebenläufigkeit und Zusammenspiel
Die Funktion ist als noexcept deklariert und ausnahmesicher. Ob die Methode threadsicher implementiert sein muss, ist bedingt und wird über den im Konstruktor übergebenen ConcurrencyType festgelegt [SWS_DM_00799].
Nach erfolgreicher Bestätigung von RequestUpload wird der eigentliche Upload-Datentransfer bei nachfolgenden Anfragen des UDS-Dienstes 0x36 (TransferData) über UploadData fortgeführt [SWS_DM_00800][SWS_DM_01096].
Dieser Nutzungshinweis wurde durch eine künstliche Intelligenz auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.
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
dataFormatIdentifier
UDS dataFormat Identifier
addressAndLengthFormatIdentifier
UDS addressAndLengthFormatIdentifier
memoryAddressAndSize
memoryAddress and memorySize part of the request. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c83d03772031HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung und Aufrufkontext
Die Methode RequestUploadExit der Klasse ara::diag::UploadService (SWS Diagnostics §8.27.1.1.3.3 „RequestUploadExit“) wird von der Diagnose-Server-Instanz aufgerufen, wenn die Beendigung eines Datentransfers über den UDS-Dienst RequestTransferExit (0x37) verarbeitet werden soll [SWS_DM_00141], [SWS_DM_00801].
Die Schnittstelle nimmt folgende Parameter entgegen [SWS_DM_00801]:
transferRequestParameterRecord: Enthält herstellerspezifische Parameter zur Unterstützung des Transfers im Format ara::core::Span<const std::uint8_t>. Die Daten bleiben gültig, bis das zugehörige Promise erfüllt oder die Bearbeitung abgebrochen wird. Interpretation: Die Auswertung dieser Parameter dürfte vorrangig herstellerspezifischen Validierungen beim Abschluss des Uploads dienen. Frage Q-d3989837f58761d7 (offen)
metaInfo: Übergibt Meta-Informationen der aktuellen Diagnoseanforderung.
cancellationHandler: Ermöglicht das Abfragen des Abbruchstatus via cancellationHandler.IsCanceled() oder das Registrieren eines Benachrichtigungs-Callbacks mittels cancellationHandler.SetNotifier().
Rückgabewerte und Fehlerbehandlung
Die Ausführung erfolgt asynchron und liefert ein ara::core::Future<OperationOutput> zurück [SWS_DM_00801]. Im Erfolgsfall wird das Future mit einer Instanz von OperationOutput erfüllt. Die darin übergebenen Daten aus responseData werden nach der Service-ID als transferResponseParameterRecord in die positive Diagnoseantwort eingefügt [SWS_DM_00796], [SWS_DM_00801]. Im Fehlerfall ist das Future mit einem passenden Fehlercode aus DiagUdsNrcErrc gemäß ISO 14229-1 zu komplettieren [SWS_DM_00801].
Nebenläufigkeit und Einschränkungen
Die Methode ist als noexcept spezifiziert [SWS_DM_00801]. Die Anforderung an die Thread-Sicherheit ist bedingt: Ob die Funktion threadsicher ausgeführt werden muss, wird über den im Konstruktor von UploadService übergebenen ConcurrencyType festgelegt [SWS_DM_00801].
Dieser Verwendungshinweis basiert auf den Spezifikationen in AUTOSAR AP SWS Diagnostics R25-11.
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
transferRequestParameterRecord
This parameter record contains parameter(s), which are required by the server to support the transfer of data. Format and length of this parameter(s) are vehicle manufacturer specific. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
A Future, which either gets readied to OperationOutput (transfer ResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in OperationOutput.responseData will be placed after SID as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
This StopOffer will disable the forwarding of request messages from DM.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: e7cdc33ba5c7HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die Methode StopOffer() der Klasse ara::diag::UploadService ([SWS_DM_00803], deklariert in #include "ara/diag/upload.h") deaktiviert die Weiterleitung eingehender Diagnoseanfragen aus dem Diagnostic Management (DM) an den Upload-Dienst. Die Funktion besitzt die Signatur void StopOffer() noexcept;, nimmt keine Parameter entgegen und liefert keinen Rückgabewert. Der Aufruf erfolgt synchron und beendet die Weiterleitung von Anfragen unmittelbar.
Fehlerbehandlung
Die Operation ist als ausnahmesicher (exception safe) spezifiziert und mit dem Bezeichner noexcept deklariert [SWS_DM_00803]. Es werden somit keine C++-Exceptions ausgelöst. Spezifische Fehlercodes oder Fehlermeldungen sind für diesen Aufruf nicht vorgesehen.
Nebenläufigkeit und Einschränkungen
Gemäß Spezifikation ist StopOffer() nicht threadsicher (not thread-safe) [SWS_DM_00803]. Die aufrufende Adaptive Application muss daher eigenständig sicherstellen, dass Aufrufe an derselben Instanz nicht nebenläufig aus mehreren Threads ohne externe Synchronisation erfolgen. Hinsichtlich der Reihenfolge dürfte die Methode typischerweise erst nach einem vorangegangenen Anbieten des Dienstes aufgerufen werden, um diesen kontrolliert wieder abzumelden. Frage Q-90ce659f307f54ca (offen)
Zusammenspiel
Die Schnittstelle reiht sich in das einheitliche Bereitstellungsmuster der AUTOSAR-Adaptive-Diagnose ein, das für Service-Instanzen getrennte Methoden zur Aktivierung und Deaktivierung vorsieht AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 „Monitors“. Die Methode bildet das funktionale Gegenstück zu ara::diag::DownloadService::StopOffer ([SWS_DM_00793]), welches denselben Upstream-Anforderungen unterliegt. Analoge Deaktivierungsfunktionen existieren zudem für weitere Diagnosekomponenten wie generische Routinen ([SWS_DM_00558]), UDS-Dienste ([SWS_DM_00620]) sowie Authentifizierungsschnittstellen ([SWS_DM_01131]).
Dieser Nutzungshinweis wurde automatisiert erstellt auf Basis der Spezifikation AUTOSAR Adaptive R25-11.
numBytesToReturn: Spezifiziert die Anzahl an Bytes, die der Diagnostic Manager (DM) aufgrund seiner internen Puffergröße für diesen Datenblock maximal aufnehmen kann ([SWS_DM_00800]). Interpretation: Die Anwendung dürfte die Blockgröße streng auf diesen Grenzwert beschränken. Frage Q-89de95e70e1e6223 (offen)
metaInfo: Stellt Metainformationen zur eingehenden Diagnoseanfrage bereit ([SWS_DM_00800]).
cancellationHandler: Dient der Überwachung laufender Konversationen via cancellationHandler.IsCanceled() sowie der Registrierung von Benachrichtigungen über cancellationHandler.SetNotifier() im Falle eines Abbruchs ([SWS_DM_00800]).
Die Rückgabe erfolgt asynchron über ara::core::Future<OperationOutput> ([SWS_DM_00800]). Im Erfolgsfall werden die in OperationOutput.responseData bereitgestellten Nutzdaten ([SWS_DM_00796]) in der positiven Antwort direkt hinter dem Zähler blockSequenceCounter als transferResponseParameterRecord platziert ([SWS_DM_00800]).
Fehlerbehandlung und Validierung
Im Fehlerfall wird das Future mit einem passenden Fehlercode (NRC) gemäß ISO 14229-1 aus DiagUdsNrcErrc aufgelöst ([SWS_DM_00800]). Abgesehen von grundlegenden NRC-Prüfungen nach [SWS_DM_00101] und [SWS_DM_00103] führt der Diagnostic Manager keine weitere Dienstvalidierung durch; sämtliche übrigen geforderten NRC-Prüfungen müssen durch die aufgerufene Anwendung selbst implementiert werden ([SWS_DM_01096]).
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
numBytesToReturn
number of bytes DM accepts (due to its internal buffer) for this chunk.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
A Future, which either gets readied to OperationOutput (transfer ResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for a negative response message). Data in OperationOutput.responseData will be placed after block SequenceCounter as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
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 typed by a pingViolation DiagnosticUploadInterface needs to be referenced by a DiagnosticServiceGenericMapping. 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
specifier
InstanceSpecifier to a PortPrototype of a DiagnosticUploadInterface.
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.
gemini-3.8-flash-medium· 2026-10-13