DEENESPTFRRUARHIKOZHNL

klasse <DataElement-Namespace>::<DataElementInterface>

[SWS_DM_00603] Upstream: RS_Diag_04169

class <DataElementInterface> {...};

DiagnosticDataElementInterface class

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Forwarding-Header#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }/<DataElementShortname>_fwd.h"
Scopenamespace <DataElement-Namespace>

User GuideAI-GEGENEREERD

Stelt applicaties in staat om diagnose-leesopdrachten voor de Diagnostic Manager beschikbaar te stellen en te beantwoorden.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 70357181b1bf Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Stelt applicaties in staat om diagnose-leesopdrachten voor de Diagnostic Manager beschikbaar te stellen en te beantwoorden.

De interface dient voor Adaptive-applicaties om diagnostische gegevens beschikbaar te stellen voor leestoegangen van Diagnostic Management. Na instantiatie via een instantiespecificatie moet de applicatie de dienst actief aanbieden, zodat binnenkomende leesverzoeken kunnen worden ontvangen [SWS_DM_00597]. Binnenkomende verzoeken worden verwerkt via de asynchrone leesmethode, die de opgevraagde uitvoergegevens of negatieve responscodes beschikbaar stelt in een future [SWS_DM_00596]. Omdat kopieer- en verplaatsbewerkingen zijn verwijderd, is elke instantie vast gebonden aan haar context.

Context

De gegenereerde C++-klasse <DataElementInterface> fungeert binnen het functionele cluster diag (AUTOSAR Adaptive Platform) als gestandaardiseerde serverinterface voor het beschikbaar stellen van leesbare diagnosedata AUTOSAR_AP_SWS_Diagnostics p. 68. Concreet beeldt zij een DiagnosticDataElementInterface in de rol read af, waarmee een Adaptive-applicatie datawaarden voor diagnoseverzoeken (zoals UDS ReadDataByIdentifier) naar de Diagnostic Manager (DM) verzendt [SWS_DM_00596].

Belangrijke interactiepartners zijn het Diagnostic Management van de platformdaemon, die binnenkomende diagnoseverzoeken coördineert, evenals de implementerende Adaptive-applicatie, die van deze interface overerft en de aanbiedingslogica formuleert. De instantiatie en toewijzing aan de softwarearchitectuur vindt plaats via een gemodelleerd poortprototype dat via een ara::core::InstanceSpecifier wordt gekoppeld [SWS_DM_00587]. De uitvoergegevens worden daarbij ingekapseld in een typespecifieke structuur waarvan de argumenten worden gerepresenteerd door overeenkomstige uitvoerelementen [SWS_DM_80023], [SWS_DM_00581].

Levenscyclus

Het aanmaken van een instantie vindt plaats via de constructor onder vermelding van de ara::core::InstanceSpecifier en de concurrency-modus ara::diag::ConcurrencyType [SWS_DM_00587]. Om een eenduidige toewijzing binnen het proces te waarborgen, zijn zowel de copy-constructor als de move-constructor verwijderd [SWS_DM_01661], [SWS_DM_01662]. Evenzo zijn de copy- en move-assignment-operators expliciet verwijderd [SWS_DM_01659], [SWS_DM_01660]. Een instantie blijft zodoende vast verbonden aan haar aangemaakte adres.

Wat de werking betreft, doorloopt het object gedefinieerde fasen:

  • Niet aangeboden (Not Offered): na constructie bevindt het object zich eerst in een inactieve toestand, waarin de DM geen leesverzoeken aflevert.
  • Aangeboden (Offered): door het aanroepen van Offer() wordt de service bij de DM geactiveerd, zodat binnenkomende leesverzoeken worden doorgestuurd [SWS_DM_00597].
  • Afgemeld: de aanroep van StopOffer() deactiveert het doorsturen van toekomstige diagnoseverzoeken door de DM [SWS_DM_00617].
  • Vernietiging: de virtuele destructor ~<DataElementInterface>() beëindigt de levenscyclus van de interface-instantie [SWS_DM_00588].

Terwijl de constructor als thread-safe is gespecificeerd [SWS_DM_00587], zijn Offer(), StopOffer(), Read() en de destructor niet thread-safe [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00596], [SWS_DM_00588]. De parameter concurrencyType in de constructor bepaalt of de handler-implementatie thread-safe (kConcurrent) of niet thread-safe (kNotConcurrent) is uitgevoerd [SWS_DM_00587].

Lifecycle Uninitialized Uninitialized NotOffered NotOffered Uninitialized->NotOffered Konstruktor Offered Offered NotOffered->Offered Offer() Destructed Destructed NotOffered->Destructed Destruktor Offered->NotOffered StopOffer() Offered->Destructed Destruktor

Toestandsdiagram: toestandsfasen van een interface-instantie tussen initialisatie, publicatiestatus en vernietiging. Bronnen: [SWS_DM_00587], [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00588].

Gebruikspad

Het reguliere verloop voor het opvragen van gegevens volgt een vaste opeenvolging van stappen:

  1. Instantiëring: de applicatie instantieert de afgeleide handler-klasse met de gewenste instanceSpec en concurrencyType [SWS_DM_00587].
  2. Vrijgave van de service: de applicatie roept Offer() aan, waardoor de DM in staat wordt gesteld om leesverzoeken door te sturen [SWS_DM_00597].
  3. Verwerking van leesverzoeken: arriveert er een leesverzoek bij de DM, dan roept deze de zuiver virtuele methode Read(metaInfo, cancellationHandler) op de handler aan [SWS_DM_00596]. De applicatie evalueert metaInfo en kan via cancellationHandler.IsCanceled() controleren of de conversatie is afgebroken, of een callback via cancellationHandler.SetNotifier registreren [SWS_DM_00596].
  4. Terugkoppeling: interpretatie: het daadwerkelijke bepalen van de uitvoergegevens gebeurt vermoedelijk typisch asynchroon; het resultaat wordt in een ara::core::Future met het bijbehorende ReadOutput-object beschikbaar gesteld [SWS_DM_00596], [SWS_DM_00581]. Vraag Q-ce317bd1275e4fd9 (open)
  5. Beëindiging van de service: voorafgaand aan het afsluiten roept de applicatie StopOffer() aan om het doorsturen te verhinderen [SWS_DM_00617], gevolgd door de objectvernietiging [SWS_DM_00588].
Aanroepsequentie voor het beschikbaar stellen en uitlezen van een diagnosedata-elementDiagnostic ManagementDataElement HandlerAnwendungskernUse Case: DienstregistrierungOffer()Result<void> (kSuccess)Use Case: Leseanfrage verarbeitenRead(metaInfo, cancellationHandler)Daten abfragen / ermittelnaltErfolgreich gelesenReadOutput bereitstellenFuture met ReadOutputFehlerfall / NRCFehler aufgetretenFuture met DiagUdsNrcErrcUse Case: DienstabmeldungStopOffer()

Sequentiediagram: aanroepsequentie vanaf de service-aanmelding via het asynchrone lezen tot aan de afmelding. Bronnen: [SWS_DM_00597], [SWS_DM_00596], [SWS_DM_00617].

Foutscenario's

In geval van fouten moeten de verschillende levensfasen gedifferentieerd worden bekeken:

Reeds bij de constructie kunnen integriteitsschendingen optreden, die via specifieke violations worden gesignaleerd [SWS_DM_00587]:

  • InstanceSpecifierMappingIntegrityViolation: de instantiespecificator kan in het model van het executable niet worden herleid of verwijst niet naar een PortPrototype.
  • PortInterfaceMappingViolation: een door het DiagnosticDataElementInterface getypeerde PortPrototype wordt niet gerefereerd door een DiagnosticDataPortMapping.
  • ProcessMappingViolation: er bestaat weliswaar een passende InstanceRef, maar er is geen passend gemodelleerd proces gevonden dat overeenkomt met het runtimeproces.
  • InstanceSpecifierAlreadyInUseViolation: de constructor is aangeroepen met een InstanceSpecifier die in het huidige proces al wordt gebruikt.

Wordt Offer() aangeroepen voor een reeds aangeboden service, dan retourneert de methode een ara::core::Result met de foutcode DiagOfferErrc::kAlreadyOffered (rollback-semantiek) [SWS_DM_00597].

Kan een leesverzoek in Read() niet succesvol worden beantwoord, dan moet het geretourneerde ara::core::Future een overeenkomstige ISO 14229-1 Negative Response Code (NRC) via DiagUdsNrcErrc of een ApApplicationError bevatten [SWS_DM_00596].

Deze handleiding is gebaseerd op de specificatie AUTOSAR AP release R25-11 en vat de vereisten van de module diag samen.

Ledenkaart

Methoden

5
<DataElementInterface>OfferReadStopOffer~<DataElementInterface>

Operatoren

1
operator=

Constanten

1
<DataElementOutArg>

Geneste typen

1
<DataElement>ReadOutput

Klassendiagram

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

G n_DataElement_Namespace____DataElementInterface_750 <DataElementInterface> + <DataElementOutArg> + Offer() + Read() + StopOffer() + operator=() + <DataElementInterface>() + ~<DataElementInterface>()

Detailweergave

Kies een item in de inhoudsopgave.

Methoden

<DataElementInterface> functie 3

Construct a DataElement from an ara::core::InstanceSpecifier

Overloads <DataElementInterface> 3
<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_00587
<DataElementInterface2> (const <DataElementInterface2> &other)=delete; SWS_DM_01661
<DataElementInterface4> (<DataElementInterface4> &&other)=delete; SWS_DM_01662
Offer functie

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

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

Provision of a Read DataElement (DiagnosticDataElementInterface in the role read)

virtual ara::core::Future< <DataElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;
StopOffer functie

This StopOffer will disable the forwarding of request messages from DM

void StopOffer () noexcept;
~<DataElementInterface> functie

Destruction of a DataElement

virtual ~<DataElementInterface6> () noexcept;

Operatoren

operator= functie 2

Copy assignment constructor deletion

Overloads = 2
<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete; SWS_DM_01659
<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete; SWS_DM_01660

Constanten

<DataElementOutArg> variabele

Member declaration representing an out argument in an Output.

<DataElementOutArgType> <DataElementOutArg>;

Geneste typen

<DataElement>ReadOutput klasse

Documentatie van de methoden

functie <DataElementInterface> [SWS_DM_00587] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept;

Construct a DataElement from an ara::core::InstanceSpecifier

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 838df6a198bf Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De constructorfunctie [SWS_DM_00587] dient voor het instantiëren van een <DataElementInterface> via een ara::core::InstanceSpecifier conform AUTOSAR_AP_SWS_Diagnostics §8.28.2.2.1.6.

Gebruik en parameters:

  • instanceSpec: Specificeert de concrete instantie van de dienst in de modelcontext.
  • concurrencyType: Bepaalt het gelijktijdigheidsgedrag en legt vast of de interface thread-safe (kConcurrent) of niet thread-safe (kNotConcurrent) wordt uitgevoerd.

Gelijktijdigheid en exceptieveiligheid: De functie is gedeclareerd als noexcept en in de specificatie geclassificeerd als thread-safe en exception-safe [SWS_DM_00587].

Foutafhandeling en modelleringsschendingen: Fouten leiden niet tot C++-excepties, maar tot gespecificeerde violations:

  • InstanceSpecifierMappingIntegrityViolation: Treedt op wanneer instanceSpec in de procescontext niet kan worden omgezet of niet verwijst naar een PortPrototype.
  • PortInterfaceMappingViolation: Wordt gemeld wanneer een via DiagnosticDataElementInterface getypeerde PortPrototype niet wordt gerefereerd door een DiagnosticDataPortMapping.
  • ProcessMappingViolation: Doet zich voor wanneer er een instantieverwijzing aanwezig is, maar er geen passend gemodelleerd proces voor het runtimeproces bestaat.
  • InstanceSpecifierAlreadyInUseViolation: Wordt verzonden wanneer de instanceSpec in hetzelfde proces al bezet is door een constructoraanroep.

Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitthread-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 typed by a pingViolation DiagnosticDataElementInterface needs to be referenced by a DiagnosticDataPortMapping. 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)

ParameterBeschreibung
instanceSpecThe specifier of a specific instance of a service.
concurrencyTypeSpecifies 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_00587
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00587@rel:R25-11#609f42b6
Content hash
609f42b6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00587
Status: valid/unmigrated Version: rel:R25-11#3137c965 Versionshistorie & Revisions (1 transition, 8 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_00587@rel:R25-11#3137c965
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5035bc322026-09-30
  • R19-11rel:R19-11#362db1312026-10-14
  • R20-11rel:R20-11#2280335d2026-10-14
  • R21-11rel:R21-11#90eaccce2026-10-14
  • R22-11rel:R22-11#163504222026-10-14
  • R23-11rel:R23-11#bbe3ec942026-10-14
  • R24-11rel:R24-11#5f9d4fbd2026-10-14
  • R25-11rel:R25-11#3137c9652026-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

functie <DataElementInterface> [SWS_DM_01661] Upstream: RS_AP_00147

<DataElementInterface2> (const <DataElementInterface2> &other)=delete;

Copy constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01661
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01661@rel:R25-11#38b5258f
Content hash
38b5258f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01661
Status: valid/unmigrated Version: rel:R25-11#2f60d744 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_01661@rel:R25-11#2f60d744
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#1cd9fb522026-09-30
  • R23-11rel:R23-11#0016469c2026-10-14
  • R24-11rel:R24-11#de93ef5f2026-10-14
  • R25-11rel:R25-11#2f60d7442026-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

functie <DataElementInterface> [SWS_DM_01662] Upstream: RS_AP_00147

<DataElementInterface4> (<DataElementInterface4> &&other)=delete;

Move constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01662
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01662@rel:R25-11#3a061d2b
Content hash
3a061d2b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01662
Status: valid/unmigrated Version: rel:R25-11#2bcbb47c 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_01662@rel:R25-11#2bcbb47c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#91b60d862026-09-30
  • R23-11rel:R23-11#df8de15a2026-10-14
  • R24-11rel:R24-11#05b223222026-10-14
  • R25-11rel:R25-11#2bcbb47c2026-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

functie Offer [SWS_DM_00597] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04169, RS_Diag_04224

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

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 9d47ee9edbd8 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De synchrone methode Offer van een DataElementInterface activeert het doorsturen van binnenkomende diagnoseverzoeken door de Diagnostic Management Daemon (DM) naar de bijbehorende handler ([SWS_DM_00597]). Deze accepteert geen parameters, garandeert uitzonderingsveiligheid (exception safe / noexcept) en retourneert een ara::core::Result<void> ([SWS_DM_00597]).

Voor foutafhandeling, gelijktijdigheid en volgorde gelden de volgende richtlijnen:

  • Foutafhandeling: Als de dienst al eerder is aangeboden, mislukt de aanroep en levert deze de foutcode DiagOfferErrc::kAlreadyOffered met rollback-semantiek ([SWS_DM_00597]).
  • Gelijktijdigheid: De functie is gespecificeerd als niet-thread-safe (not thread-safe) ([SWS_DM_00597]). Gelijktijdige aanroepen op dezelfde instantie moeten aan de applicatiezijde worden gesynchroniseerd.
  • Volgordevoorwaarden: Zolang Offer niet is aangeroepen door de Adaptive Application, stuurt DM geen verzoeken door naar de handler respectievelijk gebruikt interne fallback-waarden ([SWS_DM_01525], [SWS_DM_01527]). De aanroep vindt vermoedelijk typisch plaats tijdens de opstartfase van de applicatie (interpretatie). Vraag Q-dca0925e698789c5 (open)

Het concept van beschikbaarstelling via Offer wordt consistent ook gebruikt bij andere DM-handlers zoals routines ([SWS_DM_00594]) en data-identifiers ([SWS_DM_00599]). De benaming is weliswaar ontleend aan ara::com, maar vormt een zelfstandige DM-implementatie (SWS Diagnostics §7.3.4.1.2 “Monitors”).

Deze tekst is door een AI gegenereerd op basis van de specificatiegegevens.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: diag::DiagOfferErrc

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_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_00597
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00597@rel:R25-11#f3b5e233
Content hash
f3b5e233
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00597
Status: valid/unmigrated Version: rel:R25-11#dc11c9cd Versionshistorie & Revisions (1 transition, 8 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_00597@rel:R25-11#dc11c9cd
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#872cc3392026-09-30
  • R19-11rel:R19-11#aef2a6c42026-10-14
  • R20-11rel:R20-11#dc31bf0e2026-10-14
  • R21-11rel:R21-11#38b1f8ef2026-10-14
  • R22-11rel:R22-11#3ac4d67f2026-10-14
  • R23-11rel:R23-11#c2a3f2c12026-10-14
  • R24-11rel:R24-11#9279c3692026-10-14
  • R25-11rel:R25-11#dc11c9cd2026-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

functie Read [SWS_DM_00596] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< <DataElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a Read DataElement (DiagnosticDataElementInterface in the role read)

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 4be12ba12f01 Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De methode Read dient voor het beschikbaar stellen van een gegevenselement binnen een DiagnosticDataElementInterface-instantie in de rol read [SWS_DM_00596]. De aanroep geschiedt asynchroon door de Diagnostic Manager voor het verwerken van diagnostische leesverzoeken.

Gebruik en signatuur

De interface levert een ara::core::Future met een getypeerd ReadOutput-object conform [SWS_DM_00581] terug [SWS_DM_00596]. Via de meegegeven parameters verwerkt de implementatie het verzoek:

  • metaInfo: Geeft metainformatie door over het binnenkomende diagnoseverzoek [SWS_DM_00596].
  • cancellationHandler: Maakt bewaking van een voortijdig afbreken van de diagnoseconversatie via cancellationHandler.IsCanceled() mogelijk, evenals de registratie van een notificatiefunctie via cancellationHandler.SetNotifier() [SWS_DM_00596].

Foutafhandeling en gelijktijdigheid

Als het gegevenselement niet succesvol kan worden uitgelezen, retourneert de ara::core::Future geen waarde, maar een fout. Als foutcode moet een passende UDS-Negative-Response-Code (NRC) conform ISO 14229-1 via DiagUdsNrcErrc of een ApApplicationError worden ingesteld [SWS_DM_00596]. De functie is gespecificeerd als noexcept en uitzonderingsveilig (exception safe).

Wat betreft de uitvoeringscontext is Read gedeclareerd als not thread-safe [SWS_DM_00596]. De interactie komt overeen met het algemene patroon van adaptieve diagnose-leesbewerkingen, zoals analoog gedefinieerd voor data-identifiers ([SWS_DM_00640]) of extended-data-records ([SWS_DM_02156]).

Deze gebruiksinstructie is automatisch gegenereerd op basis van de AUTOSAR-specificatie.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
metaInfoMetaInfo of the request.
cancellationHandlerThis 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.

Rückgabewert

TypBeschreibung
ara::core::Future< {<data-element-name>}ReadOutput >• If successful: an ara::core::Future containing a ReadOutput object as per [SWS_DM_00581] • If unsuccessful: an ara::core::Future containing a corresponding DiagUdsNrcErrc or ApApplicationError.

Fehler

FehlercodeBeschreibung
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.

Record
AUTOSAR/AP/record/SWS_DM_00596
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00596@rel:R25-11#fd3e33b9
Content hash
fd3e33b9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00596
Status: valid/unmigrated Version: rel:R25-11#db56d6b8 Versionshistorie & Revisions (1 transition, 8 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_00596@rel:R25-11#db56d6b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#46170e3a2026-09-30
  • R19-11rel:R19-11#27ec1d4b2026-10-14
  • R20-11rel:R20-11#7e478e7b2026-10-14
  • R21-11rel:R21-11#86f986be2026-10-14
  • R22-11rel:R22-11#d7f279f42026-10-14
  • R23-11rel:R23-11#05b772b12026-10-14
  • R24-11rel:R24-11#47e253022026-10-14
  • R25-11rel:R25-11#db56d6b82026-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

functie StopOffer [SWS_DM_00617] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 91119add8e3c Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De methode StopOffer op de interface <DataElement-Namespace>::<DataElementInterface> deactiveert het doorsturen van binnenkomende verzoekberichten vanuit Diagnostic Management (DM) naar het betreffende gegevenselement [SWS_DM_00617]. De aanroep geschiedt synchroon, vereist geen overdrachtsparameters en levert geen retourwaarde op [SWS_DM_00617].

Wat betreft de foutafhandeling is de functie gespecificeerd als exception safe en gedeclareerd met noexcept [SWS_DM_00617]. Er worden geen C++-exceptions gegenereerd en er worden geen foutcodes teruggegeven. Interpretatie: aangezien de specificatie uitsluitend voorziet in het verhinderen van het doorsturen van berichten, zal de methode-aanroep vermoedelijk uitsluitend toekomstige diagnoseverzoeken weigeren, terwijl verwerkingen die op het moment van aanroepen al lopen, onaangetast blijven. Vraag Q-a741bb87f41cfe59 (open)

Met betrekking tot de gelijktijdigheid is de interface gedefinieerd als not thread-safe [SWS_DM_00617]. Aanroepers moeten parallelle toegangen tot dezelfde instantie daarom beveiligen via synchronisatiemechanismen aan applicatiezijde. Hoewel de naam is gekozen in navolging van ara::com, betreft het een zelfstandige, diagnosespecifieke interface van het functionele cluster Diagnostics AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

Het deactiveren past binnen het algemene architectuurpatroon van DM: analoge StopOffer-methoden bestaan voor data-identifiers [SWS_DM_00600], generieke routines [SWS_DM_00558], generieke UDS-diensten [SWS_DM_00620] en reset-verzoeken [SWS_DM_01017], telkens om het doorsturen van verzoeken naar de overeenkomstige handler gecontroleerd te beëindigen.

Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de specificatie AUTOSAR AP R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_00617
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00617@rel:R25-11#4c0aa5e1
Content hash
4c0aa5e1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00617
Status: valid/unmigrated Version: rel:R25-11#f93e3c48 Versionshistorie & Revisions (1 transition, 8 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_00617@rel:R25-11#f93e3c48
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c087b5492026-09-30
  • R19-11rel:R19-11#4686d8712026-10-14
  • R20-11rel:R20-11#302902f52026-10-14
  • R21-11rel:R21-11#60b4eb6e2026-10-14
  • R22-11rel:R22-11#630d49a22026-10-14
  • R23-11rel:R23-11#d3c624d92026-10-14
  • R24-11rel:R24-11#a0e4aac82026-10-14
  • R25-11rel:R25-11#f93e3c482026-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

functie operator= [SWS_DM_01659] Upstream: RS_AP_00147

<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete;

Copy assignment constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01659
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01659@rel:R25-11#c78b1dff
Content hash
c78b1dff
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01659
Status: valid/unmigrated Version: rel:R25-11#af6f33fc 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_01659@rel:R25-11#af6f33fc
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#473419de2026-09-30
  • R23-11rel:R23-11#9013eaab2026-10-14
  • R24-11rel:R24-11#bd96b8662026-10-14
  • R25-11rel:R25-11#af6f33fc2026-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

functie operator= [SWS_DM_01660] Upstream: RS_AP_00147

<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete;

Move assignment constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01660
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01660@rel:R25-11#ce53914f
Content hash
ce53914f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01660
Status: valid/unmigrated Version: rel:R25-11#5711e300 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_01660@rel:R25-11#5711e300
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e5b157292026-09-30
  • R23-11rel:R23-11#1e4f2e112026-10-14
  • R24-11rel:R24-11#92f17c3c2026-10-14
  • R25-11rel:R25-11#5711e3002026-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

functie ~<DataElementInterface> [SWS_DM_00588] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<DataElementInterface6> () noexcept;

Destruction of a DataElement

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_00588
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00588@rel:R25-11#152e4730
Content hash
152e4730
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00588
Status: valid/unmigrated Version: rel:R25-11#ad7733a4 Versionshistorie & Revisions (1 transition, 8 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_00588@rel:R25-11#ad7733a4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b88cfb3b2026-09-30
  • R19-11rel:R19-11#4c53dc262026-10-14
  • R20-11rel:R20-11#b2fa29ed2026-10-14
  • R21-11rel:R21-11#0f467e0d2026-10-14
  • R22-11rel:R22-11#b00f6d462026-10-14
  • R23-11rel:R23-11#28e88b432026-10-14
  • R24-11rel:R24-11#2cdc2f6c2026-10-14
  • R25-11rel:R25-11#ad7733a42026-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

Documentatie van constanten / variabelen

variabele <DataElementOutArg> [SWS_DM_80023] Upstream: RS_Diag_04224, RS_Diag_04169

<DataElementOutArgType> <DataElementOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Symbol<DataElementOutArg>
Typ<DataElementOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_80023
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_80023@rel:R25-11#d3d95e0d
Content hash
d3d95e0d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_80023
Status: valid/unmigrated Version: rel:R25-11#caed5afa Versionshistorie & Revisions (1 transition, 3 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_80023@rel:R25-11#caed5afa
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#98e36acc2026-09-30
  • R24-11rel:R24-11#b1ac80b72026-10-14
  • R25-11rel:R25-11#caed5afa2026-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