DEENESPTFRRUARHIKOZHNL

klasse ara::diag::CommunicationControl

[SWS_DM_00804] Upstream: RS_Diag_04278

class CommunicationControl {...};

0x28 CommunicationControl interface

Header-Datei#include "ara/diag/communication_control.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

User GuideAI-GEGENEREERD

Stelt applicaties in staat om diagnoseverzoeken van de UDS-dienst 0x28 voor de besturing van de communicatie te verwerken.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: ae3aac538bd3 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Stelt applicaties in staat om diagnoseverzoeken van de UDS-dienst 0x28 voor de besturing van de communicatie te verwerken.

De klasse ara::diag::CommunicationControl dient in AUTOSAR Adaptive als interface voor de verwerking van de UDS-dienst 0x28 (CommunicationControl) voor het schakelen van communicatiekanalen [SWS_DM_00808]. Na de modelgebaseerde instantiëring via een InstanceSpecifier activeert Offer() het doorsturen van verzoeken door de Diagnostic Manager, die aansluitend via CommCtrlRequest asynchroon worden verwerkt [SWS_DM_00806], [SWS_DM_00809]. Als strikt unicum sluit de klasse kopieer- en verplaatsbewerkingen uit en vereist vóór het afsluiten een deregistratie via StopOffer() [SWS_DM_00810].

Context

De klasse ara::diag::CommunicationControl definieert de gestandaardiseerde interface voor de afhandeling van de UDS-diagnosedienst 0x28 (CommunicationControl) in het AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics, p. 70. Als abstracte basisklasse bemiddelt zij tussen de Diagnostic Manager (DM) en de applicatiespecifieke diagnosefunctionaliteit waarmee het verzenden of ontvangen van bepaalde communicatieberichten in het voertuignetwerk wordt bestuurd. De applicatiesoftware leidt af van deze klasse en implementeert de puur virtuele methode CommCtrlRequest om binnenkomende besturingsinstructies in ontvangst te nemen en uit te voeren [SWS_DM_00808]. De koppeling met het AUTOSAR-systeemmodel vindt plaats via een ara::core::InstanceSpecifier, die refereert aan een PortPrototype van een DiagnosticComControlInterface [SWS_DM_00806].

Levenscyclus

Een instantie wordt expliciet via de constructor gecreëerd onder vermelding van de ara::core::InstanceSpecifier en het concurrency-model ConcurrencyType (kConcurrent of kNotConcurrent) [SWS_DM_00806]. De klasse heeft een strikte unieke semantiek en is noch kopieerbaar noch verplaatsbaar: zowel de kopieerconstructor [SWS_DM_01677] en de verplaatsconstructor [SWS_DM_01678] als de kopieertoewijzingsoperator [SWS_DM_01675] en de verplaatstoewijzingsoperator [SWS_DM_01676] zijn verwijderd (=delete).

Na creatie blijft de instantie aanvankelijk inactief. Pas door het aanroepen van Offer() wordt de Diagnostic Manager geautoriseerd om binnenkomende diagnoseverzoeken door te sturen naar de handler [SWS_DM_00809]. Omgekeerd trekt StopOffer() deze vrijgave in en deactiveert het doorsturen [SWS_DM_00810]. De vernietiging vindt plaats via de virtuele destructor [SWS_DM_00807]. Interpretatie: het is vermoedelijk vereist om vóór de vernietiging van het object StopOffer() aan te roepen, zodat de Diagnostic Manager geen verweesde doorzendingen in stand houdt. Vraag Q-f67e35c9fea508d8 (open)

Wat betreft gelijktijdigheid is de constructor thread-safe [SWS_DM_00806], terwijl de destructor [SWS_DM_00807], Offer() [SWS_DM_00809] en StopOffer() [SWS_DM_00810] niet thread-safe zijn. De uitvoering van CommCtrlRequest is voorwaardelijk thread-safe (conditional): of de implementatie thread-safe moet zijn, wordt bepaald door de in de constructor vastgelegde ConcurrencyType [SWS_DM_00808].

Gebruikspad

Het reguliere verloop omvat de instantiëring van de afgeleide klasse, de serviceregistratie, de asynchrone verwerking van diagnoseverzoeken en de afsluitende deregistratie:

  1. Initialisatie: De applicatie instantieert de handler onder opgave van de InstanceSpecifier en het gewenste ConcurrencyType [SWS_DM_00806].
  2. Dienstaanbod: Via Offer() wordt de dienst bij de Diagnostic Manager geactiveerd [SWS_DM_00809].
  3. Verzoekverwerking: Komt er een UDS-verzoek voor dienst 0x28 met een willekeurige subfunctie binnen, dan roept de Diagnostic Manager CommCtrlRequest aan [SWS_DM_00808]. De parameters omvatten:
    • controlType (ComCtrlRequestParamsType): Alle UDS-verzoekparameters inclusief optionele elementen.
    • metaInfo (const MetaInfo&): Metainformatie over het diagnoseverzoek.
    • cancellationHandler (CancellationHandler): Dient voor statusopvraag via IsCanceled() evenals voor de registratie van een annulerings-callbackfunctie via SetNotifier().
  4. Terugmelding: De verwerking wordt asynchroon afgerond en meldt het resultaat terug via ara::core::Future<void> [SWS_DM_00808].
  5. Deregistratie: Vóór het afsluiten of beëindigen stopt de applicatie het doorsturen middels StopOffer() [SWS_DM_00810].
Aanroep- en verwerkingsverloop voor CommunicationControl (0x28)AnwendungCommunicationControlDiagnostic ManagerKonstruktor(specifier, concurrencyType)Offer()Registratie voor UDS 0x28Bevestiging (of kAlreadyOffered)Result<void>Use Case: Diagnoseanfrage bearbeitenCommCtrlRequest(controlType, metaInfo, cancellationHandler)Verarbeitung / Abfrage cancellationHandlerFuture<void> (succes of DiagUdsNrcErrc)Use Case: Dienst deregistrierenStopOffer()Weiterleitung beenden

Sequentiediagram: Typisch verloop van de initialisatie via de verwerking van UDS-0x28-verzoeken tot de deregistratie. Bronnen: [SWS_DM_00806], [SWS_DM_00808], [SWS_DM_00809], [SWS_DM_00810].

Foutscenario's

Reeds bij de constructie kunnen inconsistenties in het AUTOSAR-model leiden tot runtime-overtredingen (violations) [SWS_DM_00806]:

  • InstanceSpecifierMappingIntegrityViolation: De InstanceSpecifier kan in de context van de executable niet worden omgezet of verwijst niet naar een PortPrototype.
  • PortInterfaceMappingViolation: De door DiagnosticComControlInterface getypeerde PortPrototype wordt niet gerefereerd door een DiagnosticServiceGenericMapping.
  • ProcessMappingViolation: Er bestaat een passende instantie-referentie, maar er is geen gemodelleerd proces dat bij het actuele proces past.
  • InstanceSpecifierAlreadyInUseViolation: De identifier wordt in hetzelfde proces al door een andere instantie gebruikt.

Tijdens bedrijf meldt Offer() via de retourwaarde ara::core::Result<void> de fout DiagOfferErrc::kAlreadyOffered indien de dienst reeds eerder is aangeboden en nog actief is [SWS_DM_00809]. Kan een diagnoseverzoek in CommCtrlRequest functioneel niet worden ingewilligd, dan retourneert de methode via de ara::core::Future<void> een Negative Response Code (NRC) conform ISO 14229-1 middels DiagUdsNrcErrc [SWS_DM_00808].

Deze klassehandleiding is opgesteld door een AI-curatie-assistent op basis van AUTOSAR Adaptive R25-11.

Ledenkaart

Constructors en destructor

2
CommunicationControl~CommunicationControl

Methoden

3
CommCtrlRequestOfferStopOffer

Operatoren

1
operator=

Geneste typen

1
ComCtrlRequestParamsType

Klassendiagram

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

G nara__diag__CommunicationControl599 CommunicationControl + CommunicationControl() + operator=() + ~CommunicationControl() + CommCtrlRequest() + Offer() + StopOffer()

Detailweergave

Kies een item in de inhoudsopgave.

Constructors en destructor

CommunicationControl functie 3

Constructor of CommunicationControl.

Overloads CommunicationControl 3
explicit CommunicationControl (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_00806
CommunicationControl (CommunicationControl &)=delete; SWS_DM_01677
CommunicationControl (CommunicationControl &&) noexcept=delete; SWS_DM_01678
~CommunicationControl functie

Destructor of class CommunicationControl.

virtual ~CommunicationControl () noexcept;

Methoden

CommCtrlRequest functie

Called for CommunicationControl (0x28) with any subfunction as subfunction value is part of the argument list.

virtual ara::core::Future< void > CommCtrlRequest (ComCtrlRequest ParamsType controlType, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
Offer functie

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

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

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

void StopOffer () noexcept;

Operatoren

operator= functie 2

CommunicationControl shall be a single not assignable instance.

Overloads = 2
CommunicationControl & operator= (CommunicationControl &)=delete; SWS_DM_01675
CommunicationControl & operator= (CommunicationControl &&)=delete; SWS_DM_01676

Geneste typen

Documentatie van de methoden

functie CommCtrlRequest [SWS_DM_00808] Upstream: RS_AP_00119, RS_AP_00138, RS_Diag_04170, RS_Diag_04278

virtual ara::core::Future< void > CommCtrlRequest (ComCtrlRequest ParamsType controlType, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for CommunicationControl (0x28) with any subfunction as subfunction value is part of the argument list.

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

De zuiver virtuele methode ara::diag::CommunicationControl::CommCtrlRequest ([SWS_DM_00808]) wordt aangeroepen door de Diagnostic Server-instantie om diagnoseverzoeken van de UDS-dienst 0x28 (CommunicationControl) te verwerken ([SWS_DM_00865], SWS Diagnostics §7.3.2.8.10 “Service 0x28 – CommunicationControl”). Alle UDS-verzoekparameters inclusief de subfunctie worden gebundeld doorgegeven via de structuur controlType ([SWS_DM_00808]). De aanroep retourneert een ara::core::Future<void>, waardoor de verwerking asynchroon plaatsvindt. Via de parameter cancellationHandler kan de applicatie middels IsCanceled() de annuleringsstatus opvragen of via SetNotifier() een callback voor het afbreken van de conversatie registreren ([SWS_DM_00808]).

Rondt de applicatie de verwerking zonder fouten af, dan verzendt de Diagnostic Server een positief UDS-antwoord ([SWS_DM_00199]). Treedt er een fout op, dan moet deze als passende Negative Response Code (NRC) conform ISO 14229-1 via ara::diag::DiagUdsNrcErrc worden gemeld ([SWS_DM_00808]); de server beantwoordt het serviceverzoek vervolgens negatief met deze foutcode ([SWS_DM_00866]). Niet-geconfigureerde subfuncties wijst de server vooraf al af met NRC 0x12 (kSubFunctionNotSupported) ([SWS_DM_00252]).

De methode is gedeclareerd met noexcept en uitzonderingsveilig ([SWS_DM_00808], SWS Diagnostics §8.7.1.1.3.1 “CommCtrlRequest”). De thread-safety ervan is voorwaardelijk: of de functie thread-safe moet worden geïmplementeerd, wordt bepaald via de constructorparameter ConcurrencyType van de instantie ([SWS_DM_00808]). De daadwerkelijke omschakeling van de communicatiemodi vindt vermoedelijk asynchroon op de achtergrond plaats voordat de future wordt voltooid. Vraag Q-8a8e1bd2585fa859 (open)

Deze tekst is opgesteld en gecureerd door een AI. Alle verklaringen zijn uitsluitend gebaseerd op de specificatiedocumenten van AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
controlTypeAll UDS request parameters packed into a structure since it holds optional elements
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< void >Returns nothing or an error.

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_00808
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00808@rel:R25-11#e0056a3c
Content hash
e0056a3c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00808
Status: valid/unmigrated Version: rel:R25-11#727dd05b 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_00808@rel:R25-11#727dd05b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#424df4222026-09-30
  • R19-11rel:R19-11#70e59b9a2026-10-14
  • R20-11rel:R20-11#35c65b602026-10-14
  • R21-11rel:R21-11#aa3f917f2026-10-14
  • R22-11rel:R22-11#21c3e83e2026-10-14
  • R23-11rel:R23-11#62deb4992026-10-14
  • R24-11rel:R24-11#f7c711472026-10-14
  • R25-11rel:R25-11#727dd05b2026-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 CommunicationControl [SWS_DM_00806] Upstream: RS_AP_00137, RS_Diag_04278, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit CommunicationControl (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept;

Constructor of CommunicationControl.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl
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 DiagnosticComControlInterface 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)

ParameterBeschreibung
specifierInstanceSpecifier to a PortPrototype of a DiagnosticComControlInterface.
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_00806
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00806@rel:R25-11#8ae075d3
Content hash
8ae075d3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00806
Status: valid/unmigrated Version: rel:R25-11#b906b7ef 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_00806@rel:R25-11#b906b7ef
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ca8fdfa92026-09-30
  • R19-11rel:R19-11#d7fe0baa2026-10-14
  • R20-11rel:R20-11#036e26a62026-10-14
  • R21-11rel:R21-11#036e26a62026-10-14
  • R22-11rel:R22-11#b571889a2026-10-14
  • R23-11rel:R23-11#934addf22026-10-14
  • R24-11rel:R24-11#726b2cfe2026-10-14
  • R25-11rel:R25-11#b906b7ef2026-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 CommunicationControl [SWS_DM_01677] Upstream: RS_AP_00147

CommunicationControl (CommunicationControl &)=delete;

CommunicationControl shall be a single not copy-able instance.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl

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

Record
AUTOSAR/AP/record/SWS_DM_01677
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01677@rel:R25-11#e2aad406
Content hash
e2aad406
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01677
Status: valid/unmigrated Version: rel:R25-11#5a19d864 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_01677@rel:R25-11#5a19d864
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e585da4b2026-09-30
  • R23-11rel:R23-11#0dccfa442026-10-14
  • R24-11rel:R24-11#5a19d8642026-10-14
  • R25-11rel:R25-11#5a19d8642026-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 CommunicationControl [SWS_DM_01678] Upstream: RS_AP_00147

CommunicationControl (CommunicationControl &&) noexcept=delete;

Move constructor of CommunicationControl.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl

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

Record
AUTOSAR/AP/record/SWS_DM_01678
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01678@rel:R25-11#39511a30
Content hash
39511a30
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01678
Status: valid/unmigrated Version: rel:R25-11#6048a835 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_01678@rel:R25-11#6048a835
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#2554e0632026-09-30
  • R23-11rel:R23-11#dd6e581d2026-10-14
  • R24-11rel:R24-11#6048a8352026-10-14
  • R25-11rel:R25-11#6048a8352026-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_00809] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04278

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: e8c1958af1e8 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De methode Offer van de klasse ara::diag::CommunicationControl (header #include "ara/diag/communication_control.h") stelt Diagnostic Management (DM) in staat om inkomende diagnoseverzoeken voor communicatiebesturing door te sturen naar de beschikbaarstellende handler-instantie [SWS_DM_00809]. De aanroep geschiedt parameterloos en retourneert het type ara::core::Result<void> [SWS_DM_00809]. Aangezien er geen ara::core::Future of callback-mechanisme wordt gebruikt, moet de uitvoering als synchroon worden geïnterpreteerd.

Foutafhandeling

Bij succes levert de functie een lege ara::core::Result op. Werd de dienst voor deze instantie al eerder aangeboden, dan mislukt de aanroep en levert deze de foutcode DiagOfferErrc::kAlreadyOffered op met rollback-semantiek [SWS_DM_00809]. Deze fouttoestand komt overeen met de uniforme foutafhandeling voor diagnose-aanbiedingen in Adaptive AUTOSAR, zoals die bijvoorbeeld in DiagErrc [SWS_DM_00514] en DiagReportingErrc [SWS_DM_00560] is gespecificeerd.

Gelijktijdigheid en beperkingen

De functie is gedeclareerd als noexcept en uitzonderingsveilig (exception safe), maar expliciet niet-thread-safe (not thread-safe) [SWS_DM_00809]. Aanroepen op dezelfde instantie moeten daarom door de aanroepende applicatie worden gesynchroniseerd om race conditions bij de registratie te voorkomen.

Samenspel

Het door Offer gerealiseerde registratiepatroon is een centraal idioom in Diagnostic Management en wordt consistent over handlers heen gebruikt, bijvoorbeeld bij routines [SWS_DM_00557], algemene UDS-diensten [SWS_DM_00619], security-access-interfaces [SWS_DM_00766] en up- en downloaddiensten [SWS_DM_00792] [SWS_DM_00802]. Daarbij moet worden gelet op de afbakening ten opzichte van de communicatie-infrastructuur: zoals in AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors” wordt benadrukt, gaat het om een diagnosespecifieke implementatie die niet mag worden verward met ara::com.

Deze gebruiksinstructie is door een AI gecureerd voor de release R25-11 en is uitsluitend gebaseerd op de specificatiedocumenten van AUTOSAR Adaptive.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

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

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_00809
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00809@rel:R25-11#72b9d4fb
Content hash
72b9d4fb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00809
Status: valid/unmigrated Version: rel:R25-11#5af0f990 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_00809@rel:R25-11#5af0f990
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#a85f13212026-09-30
  • R19-11rel:R19-11#9f02ccdb2026-10-14
  • R20-11rel:R20-11#2be7c40f2026-10-14
  • R21-11rel:R21-11#6e3abbe82026-10-14
  • R22-11rel:R22-11#65d2217e2026-10-14
  • R23-11rel:R23-11#bbb1cf592026-10-14
  • R24-11rel:R24-11#246db6952026-10-14
  • R25-11rel:R25-11#5af0f9902026-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_00810] Upstream: RS_Diag_04278

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: 5bbcf442e7ca Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De lidfunctie StopOffer van de klasse ara::diag::CommunicationControl dient ertoe om het doorsturen van inkomende diagnoseverzoekberichten (request messages) vanuit Diagnostic Management (DM) naar de instantie te deactiveren [SWS_DM_00810]. De interface wordt via het headerbestand ara/diag/communication_control.h ingevoegd AUTOSAR_AP_SWS_Diagnostics §8.7.1.1.3.3 “StopOffer”. De methode accepteert geen overdrachtsparameters en heeft geen retourwaarde (void).

Wat de foutafhandeling betreft, is de functie gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) [SWS_DM_00810]. Er worden noch foutcodes geretourneerd, noch specifieke foutmeldingen (zoals DEM- of DET-gebeurtenissen) geactiveerd in geval van een fout.

Met betrekking tot gelijktijdigheid is StopOffer expliciet geclassificeerd als niet-thread-safe (not thread-safe) [SWS_DM_00810]. Gelijktijdige aanroepen op dezelfde instantie van CommunicationControl moeten daarom aan de applicatiezijde worden gesynchroniseerd. Bovendien zou een aanroep redelijkerwijs pas moeten plaatsvinden nadat de service eerder is aangeboden, bijvoorbeeld wanneer de communicatiebesturing tijdelijk niet beschikbaar is of de applicatie wordt afgesloten. Vraag Q-c9079c49581363f7 (open)

Het concept volgt het gestandaardiseerde schema voor adaptieve diagnoseservices: ook verwante klassen zoals ara::diag::Authentication [SWS_DM_01131], ara::diag::DownloadService [SWS_DM_00793], ara::diag::EcuResetRequest [SWS_DM_01017] en ara::diag::GenericUDSService [SWS_DM_00620] gebruiken StopOffer met een analoge semantiek. Zoals in de specificatie wordt toegelicht, is de naamgeving weliswaar gebaseerd op het service-offering uit ara::com, maar vormt deze een zelfstandige implementatie voor diagnose-interfaces en mag deze er niet mee worden verward AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

Deze gebruiksinstructie is gegenereerd door een AI op basis van de specificatie AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl
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_00810
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00810@rel:R25-11#9316e745
Content hash
9316e745
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00810
Status: valid/unmigrated Version: rel:R25-11#c84b3f30 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_00810@rel:R25-11#c84b3f30
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#e7d48b8a2026-09-30
  • R19-11rel:R19-11#28eab4cf2026-10-14
  • R20-11rel:R20-11#ee8709992026-10-14
  • R21-11rel:R21-11#ff87dbf12026-10-14
  • R22-11rel:R22-11#ae33a1b32026-10-14
  • R23-11rel:R23-11#4f252d562026-10-14
  • R24-11rel:R24-11#be84a84f2026-10-14
  • R25-11rel:R25-11#c84b3f302026-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_01675] Upstream: RS_AP_00147

CommunicationControl & operator= (CommunicationControl &)=delete;

CommunicationControl shall be a single not assignable instance.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl

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

Record
AUTOSAR/AP/record/SWS_DM_01675
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01675@rel:R25-11#25dfdb80
Content hash
25dfdb80
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01675
Status: valid/unmigrated Version: rel:R25-11#6b33e9a5 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_01675@rel:R25-11#6b33e9a5
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#732d4ac82026-09-30
  • R23-11rel:R23-11#d435003d2026-10-14
  • R24-11rel:R24-11#6b33e9a52026-10-14
  • R25-11rel:R25-11#6b33e9a52026-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_01676] Upstream: RS_AP_00147

CommunicationControl & operator= (CommunicationControl &&)=delete;

Move assignment operator of CommunicationControl.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl

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

Record
AUTOSAR/AP/record/SWS_DM_01676
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01676@rel:R25-11#8a837aeb
Content hash
8a837aeb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01676
Status: valid/unmigrated Version: rel:R25-11#3330d235 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_01676@rel:R25-11#3330d235
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#cfa3ff932026-09-30
  • R23-11rel:R23-11#fd2c0d6a2026-10-14
  • R24-11rel:R24-11#3330d2352026-10-14
  • R25-11rel:R25-11#3330d2352026-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 ~CommunicationControl [SWS_DM_00807] Upstream: RS_AP_00134, RS_Diag_04278

virtual ~CommunicationControl () noexcept;

Destructor of class CommunicationControl.

Header-Datei#include "ara/diag/communication_control.h"
Scopeclass ara::diag::CommunicationControl
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_00807
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00807@rel:R25-11#7bec9421
Content hash
7bec9421
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00807
Status: valid/unmigrated Version: rel:R25-11#fef30cdd 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_00807@rel:R25-11#fef30cdd
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0d1c8e412026-09-30
  • R19-11rel:R19-11#50d5e63a2026-10-14
  • R20-11rel:R20-11#83d511c52026-10-14
  • R21-11rel:R21-11#3df09df82026-10-14
  • R22-11rel:R22-11#cf774c8f2026-10-14
  • R23-11rel:R23-11#b59cefc12026-10-14
  • R24-11rel:R24-11#058998e02026-10-14
  • R25-11rel:R25-11#fef30cdd2026-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