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

사용자 가이드AI 생성

애플리케이션이 통신 제어를 위한 UDS 서비스 0x28의 진단 요청을 처리할 수 있도록 합니다.
AI 생성 미검증 모델: 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]. 엄격한 고유 인스턴스(Unikat)로서 이 클래스는 복사 및 이동 작업을 배제하며, 종료 전 StopOffer()을 통한 등록 취소를 요구합니다 [SWS_DM_00810].

컨텍스트

ara::diag::CommunicationControl 클래스는 AUTOSAR Adaptive Platform에서 UDS 진단 서비스 0x28(CommunicationControl) 처리를 위한 표준화된 인터페이스를 정의합니다 AUTOSAR_AP_SWS_Diagnostics, 70쪽. 추상 기본 클래스로서, Diagnostic Manager(DM)와 차량 네트워크 내 특정 통신 메시지의 송수신을 제어하는 애플리케이션별 진단 기능 사이를 중개합니다. 애플리케이션 소프트웨어는 이 클래스로부터 파생되어 수신된 제어 지시를 수락하고 실행하기 위해 순수 가상 메서드 CommCtrlRequest를 구현합니다 [SWS_DM_00808]. AUTOSAR 시스템 모델로의 바인딩은 DiagnosticComControlInterface의 PortPrototype를 참조하는 ara::core::InstanceSpecifier를 통해 수행됩니다 [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가 수신된 진단 요청을 핸들러로 전달하도록 승인됩니다 [SWS_DM_00809]. 반대로 StopOffer()는 이 권한을 철회하고 전달을 비활성화합니다 [SWS_DM_00810]. 소멸은 가상 소멸자 [SWS_DM_00807]를 통해 이루어집니다. 해석: Diagnostic Manager가 분리된 고아 전달을 유지하지 않도록 객체 소멸 전에 StopOffer()를 호출해야 할 것으로 보입니다. 질문 Q-f67e35c9fea508d8 (열림)

동시성과 관련하여 생성자는 스레드 안전하지만 [SWS_DM_00806], 소멸자 [SWS_DM_00807], Offer() [SWS_DM_00809] 및 StopOffer() [SWS_DM_00810]는 스레드 안전하지 않습니다. CommCtrlRequest의 실행은 조건부 스레드 안전(conditional)입니다. 구현이 스레드 안전해야 하는지 여부는 생성자에서 지정된 ConcurrencyType이 결정합니다 [SWS_DM_00808].

사용 경로

정규 흐름에는 파생 클래스의 인스턴스화, 서비스 등록, 진단 요청의 비동기 처리 및 최종 등록 취소가 포함됩니다:

  1. 초기화: 애플리케이션은 InstanceSpecifier 및 원하는 ConcurrencyType을 지정하여 핸들러를 인스턴스화합니다 [SWS_DM_00806].
  2. 서비스 제공: Offer()을 통해 Diagnostic Manager에 서비스가 활성화됩니다 [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 모델의 불일치로 인해 런타임 위반(Violation)이 발생할 수 있습니다 [SWS_DM_00806]:

  • InstanceSpecifierMappingIntegrityViolation: InstanceSpecifier을 실행 파일의 컨텍스트에서 확인할 수 없거나 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

중첩 타입

메서드 문서

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 8fa21d673414 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

순수 가상 메서드 ara::diag::CommunicationControl::CommCtrlRequest([SWS_DM_00808])는 UDS 서비스 0x28(CommunicationControl)의 진단 요청을 처리하기 위해 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가 처리(resolved)되기 전에 백그라운드에서 통신 모드의 실제 전환이 비동기식으로 이루어질 것으로 보입니다. 질문 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#b18d7dc6
Content hash
b18d7dc6
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#3a87b5ae
Content hash
3a87b5ae
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#9ae597cf
Content hash
9ae597cf
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#9c8c683e
Content hash
9c8c683e
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.

AI 생성 미검증 모델: 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]. 이 오류 상태는 DiagErrc [SWS_DM_00514] 및 DiagReportingErrc [SWS_DM_00560] 등에 명시된 바와 같이 Adaptive AUTOSAR의 진단 제안에 대한 통일된 오류 처리에 해당합니다.

동시성 및 제약사항

이 함수는 noexcept(으)로 선언되어 예외 안전(exception safe)하지만, 명시적으로 스레드 안전하지는 않습니다(not thread-safe) [SWS_DM_00809]. 따라서 등록 시 경쟁 상태(race condition)를 방지하기 위해 동일한 인스턴스에 대한 호출은 호출 애플리케이션에 의해 동기화되어야 합니다.

상호 작용

Offer에 의해 구현된 등록 패턴은 Diagnostic Management의 핵심 관용구이며, 예를 들어 루틴 [SWS_DM_00557], 일반 UDS 서비스 [SWS_DM_00619], 보안 액세스 인터페이스 [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#d80b91ec
Content hash
d80b91ec
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.

AI 생성 미검증 모델: 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).

오류 처리와 관련하여 이 함수는 noexcept(으)로 선언되어 있으며 예외 안전(exception safe)한 것으로 명시되어 있습니다 [SWS_DM_00810]. 오류 코드가 반환되지 않으며 오류 발생 시 특정 오류 메시지(예: DEM 또는 DET 이벤트)가 발생하지도 않습니다.

동시성과 관련하여 StopOffer은(는) 명시적으로 스레드 안전하지 않음(not thread-safe)으로 분류되어 있습니다 [SWS_DM_00810]. 따라서 CommunicationControl의 동일한 인스턴스에 대한 동시 호출은 애플리케이션 측에서 동기화되어야 합니다. 또한, 예를 들어 통신 제어를 일시적으로 사용할 수 없거나 애플리케이션이 종료되는 경우와 같이, 이전에 서비스가 제공된 후에 호출하는 것이 합리적일 것입니다. 질문 Q-c9079c49581363f7 (열림)

이 개념은 어댑티브 진단 서비스를 위한 표준화된 패턴을 따릅니다. ara::diag::Authentication [SWS_DM_01131], ara::diag::DownloadService [SWS_DM_00793], ara::diag::EcuResetRequest [SWS_DM_01017] 및 ara::diag::GenericUDSService [SWS_DM_00620]과(와) 같은 관련 클래스도 유사한 시맨틱으로 StopOffer을(를) 사용합니다. 사양에서 설명하듯이, 명명 방식은 ara::com의 서비스 오퍼링을 기반으로 하지만 진단 인터페이스를 위한 독립적인 구현이며 이와 혼동되어서는 안 됩니다 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#828a53e7
Content hash
828a53e7
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#87ca8658
Content hash
87ca8658
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#8f031640
Content hash
8f031640
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#1cafa6a8
Content hash
1cafa6a8
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