DEENESPTFRRUARHIKOZHNL

क्लास 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

उपयोगकर्ता गाइडएआई जनित

संचार को नियंत्रित करने के लिए अनुप्रयोगों को UDS सेवा 0x28 के नैदानिक अनुरोधों को संसाधित करने में सक्षम बनाता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: ae3aac538bd3 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

संचार को नियंत्रित करने के लिए अनुप्रयोगों को UDS सेवा 0x28 के नैदानिक अनुरोधों को संसाधित करने में सक्षम बनाता है।

AUTOSAR Adaptive में क्लास ara::diag::CommunicationControl संचार चैनलों को स्विच करने के लिए UDS सेवा 0x28 (CommunicationControl) को संसाधित करने के लिए एक इंटरफ़ेस के रूप में कार्य करती है [SWS_DM_00808]। एक InstanceSpecifier के माध्यम से मॉडल-आधारित इंस्टैंसिएशन के बाद, Offer() Diagnostic Manager द्वारा अनुरोधों के अग्रेषण को सक्षम करता है, जिन्हें बाद में CommCtrlRequest के माध्यम से एसिंक्रोनस रूप से संसाधित किया जाता है [SWS_DM_00806], [SWS_DM_00809]। एक सख्त अद्वितीय ऑब्जेक्ट (यूनिक) के रूप में, क्लास कॉपी और मूव संचालन को बाहर करती है और समाप्त करने से पहले StopOffer() [SWS_DM_00810] के माध्यम से अनरजिस्ट्रेशन की आवश्यकता होती है।

संदर्भ

क्लास ara::diag::CommunicationControl AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics, पृ. 70 में UDS डायग्नोस्टिक सेवा 0x28 (CommunicationControl) के निष्पादन के लिए मानकीकृत इंटरफ़ेस को परिभाषित करती है। एक अमूर्त बेस क्लास के रूप में, यह Diagnostic Manager (DM) और एप्लिकेशन-विशिष्ट डायग्नोस्टिक कार्यक्षमता के बीच मध्यस्थता करती है, जिसका उपयोग वाहन नेटवर्क में विशिष्ट संचार संदेशों को भेजने या प्राप्त करने को नियंत्रित करने के लिए किया जाता है। एप्लिकेशन सॉफ़्टवेयर इस क्लास से इनहेरिट करता है और आने वाले नियंत्रण निर्देशों को प्राप्त करने और निष्पादित करने के लिए शुद्ध वर्चुअल मेथड CommCtrlRequest को लागू करता है [SWS_DM_00808]। AUTOSAR सिस्टम मॉडल से बाइंडिंग एक ara::core::InstanceSpecifier के माध्यम से होती है, जो एक DiagnosticComControlInterface के PortPrototype को संदर्भित करता है [SWS_DM_00806]।

जीवनचक्र

एक इंस्टैंस को स्पष्ट रूप से कंस्ट्रक्टर के माध्यम से ara::core::InstanceSpecifier और समवर्ती मॉडल ConcurrencyType (kConcurrent या kNotConcurrent) निर्दिष्ट करके बनाया जाता है [SWS_DM_00806]। क्लास में सख्त अद्वितीय सेमेन्टिक्स हैं और यह न तो कॉपी करने योग्य है और न ही स्थानांतरित करने योग्य: कॉपी कंस्ट्रक्टर [SWS_DM_01677] और मूव कंस्ट्रक्टर [SWS_DM_01678] दोनों के साथ-साथ कॉपी असाइनमेंट ऑपरेटर [SWS_DM_01675] और मूव असाइनमेंट ऑपरेटर [SWS_DM_01676] हटाए गए हैं (=delete)।

निर्माण के बाद, इंस्टेंस प्रारंभ में निष्क्रिय रहता है। Offer() के कॉल के माध्यम से ही Diagnostic Manager को आने वाले नैदानिक अनुरोधों (diagnostic requests) को हैंडलर को अग्रेषित करने के लिए अधिकृत किया जाता है [SWS_DM_00809]। इसके विपरीत, StopOffer() इस सक्षमता को वापस ले लेता है और अग्रेषण को निष्क्रिय कर देता है [SWS_DM_00810]। विनाश वर्चुअल डिस्ट्रक्टर [SWS_DM_00807] के माध्यम से होता है। Interpretation: ऑब्जेक्ट के विनाश से पहले StopOffer() को कॉल करना आवश्यक हो सकता है, ताकि Diagnostic Manager किसी भी लावारिस (orphaned) अग्रेषण को बनाए न रखे। प्रश्न Q-f67e35c9fea508d8 (खुला)

कनकcurrency के संबंध में, कंस्ट्रक्टर thread-safe [SWS_DM_00806] है, जबकि डिस्ट्रक्टर [SWS_DM_00807], Offer() [SWS_DM_00809] और StopOffer() [SWS_DM_00810] thread-safe नहीं हैं। CommCtrlRequest का निष्पादन सशर्त रूप से thread-safe (conditional) है: कार्यान्वयन का thread-safe होना आवश्यक है या नहीं, यह कंस्ट्रक्टर में निर्दिष्ट ConcurrencyType [SWS_DM_00808] द्वारा निर्धारित होता है।

उपयोग पथ

नियमित प्रवाह में व्युत्पन्न क्लास का इंस्टेंटिएशन, सेवा पंजीकरण, नैदानिक अनुरोधों का एसिंक्रोनस प्रोसेसिंग और अंतिम अपंजीकरण (deregistration) शामिल हैं:

  1. आरंभीकरण: अनुप्रयोग InstanceSpecifier और वांछित ConcurrencyType [SWS_DM_00806] निर्दिष्ट करते हुए हैंडलर को इंस्टेंटिएट करता है।
  2. सेवा प्रस्ताव: Offer() के माध्यम से Diagnostic Manager में सेवा को सक्रिय (armed) किया जाता है [SWS_DM_00809]।
  3. अनुरोध प्रोसेसिंग: यदि किसी भी सब-फ़ंक्शन के साथ सेवा 0x28 के लिए कोई UDS अनुरोध आता है, तो Diagnostic Manager CommCtrlRequest को कॉल करता है [SWS_DM_00808]। पैरामीटर्स में शामिल हैं:
    • controlType (ComCtrlRequestParamsType): वैकल्पिक तत्वों सहित सभी UDS अनुरोध पैरामीटर।
    • metaInfo (const MetaInfo&): नैदानिक अनुरोध के बारे में मेटा-जानकारी।
    • cancellationHandler (CancellationHandler): IsCanceled() के माध्यम से स्थिति पूछताछ के साथ-साथ SetNotifier() के माध्यम से एक कैंसलेशन कॉलबैक फ़ंक्शन को पंजीकृत करने के लिए उपयोग किया जाता है।
  4. प्रतिक्रिया: प्रोसेसिंग एसिंक्रोनस रूप से पूरी होती है और परिणाम ara::core::Future<void> के माध्यम से रिपोर्ट किया जाता है [SWS_DM_00808]।
  5. अपंजीकरण: शटडाउन या समाप्ति से पहले, अनुप्रयोग StopOffer() [SWS_DM_00810] का उपयोग करके अग्रेषण को रोकता है।
CommunicationControl (0x28) के लिए कॉल और प्रोसेसिंग अनुक्रमएप्लिकेशनCommunicationControlDiagnostic ManagerKonstruktor(specifier, concurrencyType)Offer()UDS 0x28 के लिए पंजीकरणपुष्टि (या kAlreadyOffered)Result<void>Use Case: Diagnoseanfrage bearbeitenCommCtrlRequest(controlType, metaInfo, cancellationHandler)Verarbeitung / Abfrage cancellationHandlerFuture<void> (सफलता या DiagUdsNrcErrc)Use Case: Dienst deregistrierenStopOffer()Weiterleitung beenden

अनुक्रम आरेख: आरंभीकरण से लेकर UDS 0x28 अनुरोध प्रोसेसिंग और अपंजीकरण तक का विशिष्ट प्रवाह। स्रोत: [SWS_DM_00806], [SWS_DM_00808], [SWS_DM_00809], [SWS_DM_00810]।

त्रुटि परिदृश्य

निर्माण के समय ही, AUTOSAR मॉडल में विसंगतियां रनटाइम उल्लंघनों (Violations) का कारण बन सकती हैं [SWS_DM_00806]:

  • InstanceSpecifierMappingIntegrityViolation: InstanceSpecifier को निष्पादन योग्य (Executable) के संदर्भ में हल नहीं किया जा सकता है या यह किसी PortPrototype को संदर्भित नहीं करता है।
  • PortInterfaceMappingViolation: DiagnosticComControlInterface द्वारा टाइप किया गया PortPrototype किसी DiagnosticServiceGenericMapping द्वारा संदर्भित नहीं है।
  • ProcessMappingViolation: एक उपयुक्त इंस्टेंस संदर्भ मौजूद है, लेकिन कोई ऐसा मॉडल किया गया प्रोसेस नहीं है जो वर्तमान प्रोसेस से मेल खाता हो।
  • InstanceSpecifierAlreadyInUseViolation: पहचानकर्ता पहले से ही उसी प्रक्रिया में किसी अन्य इंस्टेंस द्वारा उपयोग में है।

चल रहे संचालन में, Offer() रिटर्न मान ara::core::Result<void> के माध्यम से त्रुटि DiagOfferErrc::kAlreadyOffered की रिपोर्ट करता है, यदि सेवा पहले से ही प्रस्तुत की गई थी और अभी भी सक्रिय है [SWS_DM_00809]। यदि CommCtrlRequest में नैदानिक अनुरोध तकनीकी रूप से पूरा नहीं किया जा सकता है, तो विधि ara::core::Future<void> के माध्यम से DiagUdsNrcErrc का उपयोग करके ISO 14229-1 के अनुसार एक Negative Response Code (NRC) लौटाती है [SWS_DM_00808]।

यह क्लास गाइड AUTOSAR Adaptive R25-11 के आधार पर एक AI क्यूरेशन सहायक द्वारा बनाया गया था।

सदस्य मानचित्र

कंस्ट्रक्टर और डिस्ट्रक्टर

2
CommunicationControl~CommunicationControl

मेथड

3
CommCtrlRequestOfferStopOffer

ऑपरेटर

1
operator=

नेस्टेड टाइप

1
ComCtrlRequestParamsType

क्लास आरेख

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

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

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

कंस्ट्रक्टर और डिस्ट्रक्टर

CommunicationControl फ़ंक्शन 3

Constructor of CommunicationControl.

ओवरलोड 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 फ़ंक्शन

Destructor of class CommunicationControl.

virtual ~CommunicationControl () noexcept;

मेथड

CommCtrlRequest फ़ंक्शन

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 फ़ंक्शन

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

ara::core::Result< void > Offer () noexcept;
StopOffer फ़ंक्शन

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

void StopOffer () noexcept;

ऑपरेटर

operator= फ़ंक्शन 2

CommunicationControl shall be a single not assignable instance.

ओवरलोड = 2
CommunicationControl & operator= (CommunicationControl &)=delete; SWS_DM_01675
CommunicationControl & operator= (CommunicationControl &&)=delete; SWS_DM_01676

नेस्टेड टाइप

ComCtrlRequestParamsType क्लास

मेथड का प्रलेखन

फ़ंक्शन 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.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 8fa21d673414 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

UDS सेवा 0x28 (CommunicationControl) के डायग्नोस्टिक अनुरोधों को संसाधित करने के लिए शुद्ध वर्चुअल विधि ara::diag::CommunicationControl::CommCtrlRequest ([SWS_DM_00808]) को Diagnostic-Server-इंस्टेंस द्वारा कॉल किया जाता है ([SWS_DM_00865], SWS Diagnostics §7.3.2.8.10 “Service 0x28 – CommunicationControl”)। सबफ़ंक्शन सहित सभी UDS अनुरोध पैरामीटर संरचना controlType के माध्यम से बंडल किए गए रूप में पास किए जाते हैं ([SWS_DM_00808])। कॉल एक ara::core::Future<void> लौटाता है, जिसके द्वारा प्रसंस्करण एसिंक्रोनस रूप से होता है। पैरामीटर cancellationHandler के माध्यम से, एप्लिकेशन IsCanceled() का उपयोग करके रद्दीकरण स्थिति की क्वेरी कर सकता है या SetNotifier() के माध्यम से वार्तालाप रद्दीकरण के लिए कॉलबैक पंजीकृत कर सकता है ([SWS_DM_00808])।

यदि एप्लिकेशन बिना किसी त्रुटि के प्रसंस्करण पूरा करता है, तो Diagnostic Server एक सकारात्मक UDS प्रतिक्रिया भेजता है ([SWS_DM_00199])। यदि कोई त्रुटि होती है, तो इसे ISO 14229-1 के अनुसार ara::diag::DiagUdsNrcErrc के माध्यम से एक उपयुक्त Negative Response Code (NRC) के रूप में रिपोर्ट किया जाना चाहिए ([SWS_DM_00808]); सर्वर तब इस त्रुटि कोड के साथ सेवा अनुरोध का नकारात्मक उत्तर देता है ([SWS_DM_00866])। गैर-कॉन्फ़िगर किए गए सबफ़ंक्शनों को सर्वर पहले ही NRC 0x12 (kSubFunctionNotSupported) के साथ अस्वीकार कर देता है ([SWS_DM_00252])।

विधि को noexcept के साथ घोषित किया गया है और यह अपवाद-सुरक्षित है ([SWS_DM_00808], SWS Diagnostics §8.7.1.1.3.1 “CommCtrlRequest”)। इसकी थ्रेड सुरक्षा सशर्त है: क्या फ़ंक्शन को थ्रेड-सुरक्षित रूप से कार्यान्वित किया जाना चाहिए, यह इंस्टेंस के कंस्ट्रक्टर पैरामीटर ConcurrencyType द्वारा निर्धारित किया जाता है ([SWS_DM_00808])। Future के हल होने से पहले संचार मोड का वास्तविक स्विचिंग संभवतः पृष्ठभूमि में एसिंक्रोनस रूप से होता है। प्रश्न Q-8a8e1bd2585fa859 (खुला)

यह पाठ एक AI द्वारा बनाया और क्यूरेट किया गया था। सभी कथन विशेष रूप से AUTOSAR R25-11 के विनिर्देश दस्तावेज़ों पर आधारित हैं।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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#cb0a0aad
Content hash
cb0a0aad
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

फ़ंक्शन 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#9c855599
Content hash
9c855599
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

फ़ंक्शन 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#5338498c
Content hash
5338498c
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

फ़ंक्शन 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#94c7792a
Content hash
94c7792a
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

फ़ंक्शन 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.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: e8c1958af1e8 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::diag::CommunicationControl (हेडर #include "ara/diag/communication_control.h") की विधि Offer Diagnostic Management (DM) को संचार नियंत्रण के लिए आने वाले डायग्नोस्टिक अनुरोधों को प्रदान करने वाले हैंडलर इंस्टेंस को अग्रेषित करने में सक्षम बनाती है [SWS_DM_00809]। कॉल बिना पैरामीटर के होती है और ara::core::Result<void> प्रकार लौटाती है [SWS_DM_00809]। चूंकि किसी ara::core::Future या कॉलबैक तंत्र का उपयोग नहीं किया जाता है, इसलिए निष्पादन को समकालिक माना जाना चाहिए।

त्रुटि प्रबंधन

सफलता की स्थिति में, फ़ंक्शन एक खाली ara::core::Result लौटाता है। यदि इस इंस्टेंस के लिए सेवा पहले ही प्रदान की जा चुकी है, तो कॉल विफल हो जाती है और रोलबैक शब्दार्थ के साथ त्रुटि कोड DiagOfferErrc::kAlreadyOffered लौटाती है [SWS_DM_00809]। यह त्रुटि स्थिति Adaptive AUTOSAR में डायग्नोस्टिक प्रस्तावों के लिए एकीकृत त्रुटि प्रबंधन के अनुरूप है, जैसा कि उदाहरण के लिए DiagErrc [SWS_DM_00514] और DiagReportingErrc [SWS_DM_00560] में निर्दिष्ट है।

समवर्तीता और प्रतिबंध

फ़ंक्शन को noexcept के रूप में घोषित किया गया है और यह अपवाद-सुरक्षित (exception safe) है, लेकिन स्पष्ट रूप से थ्रेड-सुरक्षित (not thread-safe) नहीं है [SWS_DM_00809]। इसलिए, पंजीकरण के दौरान रेस स्थितियों को रोकने के लिए कॉलिंग एप्लिकेशन द्वारा उसी इंस्टेंस पर कॉल को सिंक्रनाइज़ किया जाना चाहिए।

इंटरैक्शन

Offer द्वारा कार्यान्वित पंजीकरण पैटर्न Diagnostic Management में एक केंद्रीय मुहावरा है और इसे हैंडलर में सुसंगत रूप से उपयोग किया जाता है, उदाहरण के लिए रूटीन [SWS_DM_00557], सामान्य UDS सेवाओं [SWS_DM_00619], Security-Access इंटरफ़ेस [SWS_DM_00766] तथा अपलोड और डाउनलोड सेवाओं [SWS_DM_00792] [SWS_DM_00802] में। संचार अवसंरचना से इसके अंतर पर ध्यान दिया जाना चाहिए: जैसा कि AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors” में रेखांकित किया गया है, यह एक डायग्नोस्टिक-विशिष्ट कार्यान्वयन है जिसे ara::com के साथ भ्रमित नहीं किया जाना चाहिए।

यह उपयोग संबंधी निर्देश R25-11 रिलीज़ के लिए AI द्वारा संकलित किया गया था और यह केवल AUTOSAR Adaptive के विनिर्देश दस्तावेज़ों पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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#9ac85984
Content hash
9ac85984
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

फ़ंक्शन StopOffer [SWS_DM_00810] Upstream: RS_Diag_04278

void StopOffer () noexcept;

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

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 5bbcf442e7ca उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

वर्ग ara::diag::CommunicationControl का तत्व फ़ंक्शन StopOffer Diagnostic Management (DM) से आने वाले डायग्नोस्टिक अनुरोध संदेशों (Request Messages) को इंस्टेंस पर अग्रेषित करने को निष्क्रिय करने का कार्य करता है [SWS_DM_00810]। इंटरफ़ेस को हेडर फ़ाइल ara/diag/communication_control.h के माध्यम से शामिल किया गया है AUTOSAR_AP_SWS_Diagnostics §8.7.1.1.3.3 “StopOffer”। मेथड कोई इनपुट पैरामीटर स्वीकार नहीं करता है और इसका कोई रिटर्न मान नहीं है (void)।

त्रुटि प्रबंधन (error handling) के संबंध में, फ़ंक्शन को noexcept के रूप में घोषित किया गया है और अपवाद-सुरक्षित (exception safe) के रूप में विनिर्दिष्ट किया गया है [SWS_DM_00810]। त्रुटि की स्थिति में न तो त्रुटि कोड लौटाए जाते हैं और न ही विशिष्ट त्रुटि संदेश (जैसे DEM या DET घटनाएँ) ट्रिगर किए जाते हैं।

समवर्तीता (concurrency) के संबंध में, StopOffer को स्पष्ट रूप से थ्रेड-सुरक्षित नहीं (not thread-safe) के रूप में वर्गीकृत किया गया है [SWS_DM_00810]। परिणामस्वरूप, CommunicationControl के समान इंस्टेंस पर समवर्ती कॉल को अनुप्रयोग पक्ष (application side) पर सिंक्रनाइज़ किया जाना चाहिए। इसके अलावा, एक कॉल उचित रूप से सेवा के पूर्व प्रस्ताव (offering) के बाद ही होनी चाहिए, उदाहरण के लिए जब संचार नियंत्रण अस्थायी रूप से उपलब्ध न हो या अनुप्रयोग को शट डाउन किया जा रहा हो। प्रश्न Q-c9079c49581363f7 (खुला)

यह अवधारणा अनुकूली नैदानिक सेवाओं (adaptive diagnostic services) के मानकीकृत स्कीमा का अनुसरण करती है: ara::diag::Authentication [SWS_DM_01131], ara::diag::DownloadService [SWS_DM_00793], ara::diag::EcuResetRequest [SWS_DM_01017] और ara::diag::GenericUDSService [SWS_DM_00620] जैसी संबंधित वर्ग (classes) भी अनुरूप शब्दार्थ (semantics) के साथ StopOffer का उपयोग करती हैं। जैसा कि विनिर्देश में समझाया गया है, यद्यपि नामकरण ara::com से सेवा की पेशकश (service offering) पर आधारित है, यह नैदानिक इंटरफेस (diagnostic interfaces) के लिए एक स्वतंत्र कार्यान्वयन का प्रतिनिधित्व करता है और इसे इसके साथ भ्रमित नहीं किया जाना चाहिए AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”।

यह उपयोग नोट AUTOSAR Adaptive R25-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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#420ae3e4
Content hash
420ae3e4
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

फ़ंक्शन 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#f96b3e52
Content hash
f96b3e52
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

फ़ंक्शन 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#de68de86
Content hash
de68de86
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

फ़ंक्शन ~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#720cc3c0
Content hash
720cc3c0
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