DEENESPTFRRUARHIKOZHNL

类 ara::diag::DoIPTriggerVehicleAnnouncement

[SWS_DM_00820] Upstream: RS_Diag_04242

class DoIPTriggerVehicleAnnouncement {...};

DiagnosticDoIPTriggerVehicleAnnouncement.

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

用户指南人工智能生成

用于在指定网络接口上有针对性地触发 DoIP 车辆通告。
AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： f854d0aec1c7 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用于在指定网络接口上有针对性地触发 DoIP 车辆通告。

类 [SWS_DM_00820] 用于供 Adaptive Applications 显式向 Diagnostic Management 触发在特定网络接口上发送符合 ISO 13400-2 的 DoIP 车辆通告。访问不是通过自身实例化进行，而是通过系统提供的对象引用静态进行（[SWS_DM_00821]）。对于具有依赖于激活线的控制的接口，显式调用是不允许的，因为那里的发送是完全自动进行的（[SWS_DM_00822]）。

上下文

类 ara::diag::DoIPTriggerVehicleAnnouncement（[SWS_DM_00820]）在头文件 ara/diag/doip_trigger_vehicle_announcement.h（AUTOSAR_AP_SWS_Diagnostics §8.36.1 “Class: DoIPTriggerVehicleAnnouncement”）中提供了一个 API，Adaptive Application 可以使用该 API 触发有针对性地发出 DoIP 车辆通告（“Vehicle Announcement Messages”）（[SWS_DM_00815]、[SWS_DM_00822]）。

在符合 ISO 13400-2 的 DoIP 通信中，发送车辆通告主要是 Diagnostic Management（DM）的内部任务（AUTOSAR_AP_SWS_Diagnostics §“About DiagnosticDoIPTriggerVehicleAnnouncementInterface”）。DM 默认在网络启动时将这些消息广播到其他 IP ECU 和网关，以及在检测到外部诊断仪连接时发送（AUTOSAR_AP_SWS_Diagnostics §“About DiagnosticDoIPTriggerVehicleAnnouncementInterface”）。尽管如此，通过 ara::diag::DoIPTriggerVehicleAnnouncement，应用程序仍有机会显式触发针对特定网络接口的此项发送（[SWS_DM_00815]、[SWS_DM_00820]）。

diag_kontext app Adaptive Application api ara::diag::DoIPTriggerVehicleAnnouncement app->api TriggerVehicleAnnouncement() dm Diagnostic Management (DM) api->dm Weiterleitung an DM net DoIP-Netzwerkschnittstelle dm->net Vehicle Announcement (ISO 13400-2)

上下文图：通过 Diagnostic Manager 触发 DoIP 车辆通告时的交互伙伴。来源：[SWS_DM_00815]、[SWS_DM_00820]、AUTOSAR_AP_SWS_Diagnostics §“About DiagnosticDoIPTriggerVehicleAnnouncementInterface”。

生命周期

类 DoIPTriggerVehicleAnnouncement 实例的创建和销毁遵循严格规范：默认构造函数（[SWS_DM_02100]）和析构函数（[SWS_DM_02101]）均被声明为 delete，是私有的，且在具体形式上是特定于供应商的。因此，应用程序既不能直接实例化也不能销毁该类的对象。

对接口的访问通过函数 GetDoIPTriggerVehicleAnnouncement()（[SWS_DM_00821]）静态进行。该函数返回一个 ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>>，从而使调用方获得对 DM 提供的服务对象的引用。解释：由于私有的、已删除的构造函数以及对象引用的返回，该类内部可能由 DM 作为长生命周期的单例进行管理。 问题 Q-cecb961746b3ad13 (未决)

关于并发性，接口查询 GetDoIPTriggerVehicleAnnouncement() 和方法调用 TriggerVehicleAnnouncement() 都被指定为非线程安全（“not thread-safe”）（[SWS_DM_00821]、[SWS_DM_00822]）。因此，来自多个线程的并发访问需要外部同步。这两个方法都被指定为异常安全（“exception safe”）（[SWS_DM_00821]、[SWS_DM_00822]）。

使用路径

请求 DoIP 车辆通告的典型流程分为以下步骤：

  1. 获取实例：应用程序静态调用 ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement()（[SWS_DM_00821]）。
  2. 评估结果：检查生成的 ara::core::Result 是否存在错误；成功时解包该引用。
  3. 请求通告：通过方法 TriggerVehicleAnnouncement(networkInterfaceId) 触发在所需网络接口上的发送（[SWS_DM_00822]）。
  4. DM 发送消息：DM 处理该请求，并在由 networkInterfaceId 标识的接口上发送符合 ISO 13400-2 的车辆通告消息（[SWS_DM_00815]）。
触发 DoIP 车辆通告的序列Adaptive ApplicationDoIPTriggerVehicleAnnouncement诊断管理DoIP-NetzwerkGetDoIPTriggerVehicleAnnouncement()Result<reference_wrapper<DoIPTriggerVehicleAnnouncement>>TriggerVehicleAnnouncement(networkInterfaceId)触发发送Vehicle Announcement Message (ISO 13400-2)Result<void>

序列图：触发 DoIP 车辆通告的调用顺序。来源：[SWS_DM_00815]、[SWS_DM_00821]、[SWS_DM_00822]。

错误场景

使用 TriggerVehicleAnnouncement 时的核心错误场景涉及依赖于激活线的网络接口：如果传入的 networkInterfaceId 属于设置了属性 isActivationLineDependent = TRUE 的接口配置（DoIPNetworkConfiguration），则调用会导致错误（[SWS_DM_00822]）。在此类接口上，一旦激活线处于活动状态并分配了 IP 地址，DM 就会自动触发通告消息的发送（[SWS_DM_00816]、[SWS_DM_00822]）。

针对函数 GetDoIPTriggerVehicleAnnouncement() 和 TriggerVehicleAnnouncement() 未指定标准化的错误码（[SWS_DM_00821]、[SWS_DM_00822]）。任何运行时错误或特定于供应商的错误状态都在返回的 ara::core::Result 中传递，并且必须由调用方应用程序进行检查。

此分类指南是基于 AUTOSAR Adaptive 规范 R25-11 生成的。

成员图

构造函数和析构函数

2
DoIPTriggerVehicleAnnouncement~DoIPTriggerVehicleAnnouncement

方法

2
GetDoIPTriggerVehicleAnnouncementTriggerVehicleAnnouncement

类图

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

G nara__diag__DoIPTriggerVehicleAnnouncement193 DoIPTriggerVehicleAnnouncement + GetDoIPTriggerVehicleAnnouncement() + TriggerVehicleAnnouncement() + DoIPTriggerVehicleAnnouncement() + ~DoIPTriggerVehicleAnnouncement()

详细视图

请在大纲中选择一个条目。

构造函数和析构函数

DoIPTriggerVehicleAnnouncement 函数

Ctor is vendor-specific.

DoIPTriggerVehicleAnnouncement ()=delete;
~DoIPTriggerVehicleAnnouncement 函数

Dtor is vendor-specific.

~DoIPTriggerVehicleAnnouncement () noexcept=delete;

方法

GetDoIPTriggerVehicleAnnouncement 函数

Get DoIPTriggerVehicleAnnouncement interface from DM.

static ara::core::Result< std::reference_wrapper< DoIPTriggerVehicle Announcement > > GetDoIPTriggerVehicleAnnouncement () noexcept;
TriggerVehicleAnnouncement 函数

Called by application to trigger DM sending out vehicle announcements on the given network interface Id.

virtual ara::core::Result< void > TriggerVehicleAnnouncement (std::uint8_t networkInterfaceId) noexcept=0;

方法文档

函数 DoIPTriggerVehicleAnnouncement [SWS_DM_02100] Upstream: RS_Diag_04242

DoIPTriggerVehicleAnnouncement ()=delete;

Ctor is vendor-specific.

Header-Datei#include "ara/diag/doip_trigger_vehicle_announcement.h"
Scopeclass ara::diag::DoIPTriggerVehicleAnnouncement
Sichtbarkeitprivate

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

Record
AUTOSAR/AP/record/SWS_DM_02100
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02100@rel:R25-11#c31a6a44
Content hash
c31a6a44
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02100
Status: valid/unmigrated Version: rel:R25-11#1d989e18 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_02100@rel:R25-11#1d989e18
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#2f98fe402026-09-30
  • R24-11rel:R24-11#1d989e182026-10-14
  • R25-11rel:R25-11#1d989e182026-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

函数 GetDoIPTriggerVehicleAnnouncement [SWS_DM_00821] Upstream: RS_Diag_04242

static ara::core::Result< std::reference_wrapper< DoIPTriggerVehicle Announcement > > GetDoIPTriggerVehicleAnnouncement () noexcept;

Get DoIPTriggerVehicleAnnouncement interface from DM.

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

Rückgabewert

TypBeschreibung
ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement > >DoIPTriggerVehicleAnnouncement object

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_DM_00821
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00821@rel:R25-11#4213a62d
Content hash
4213a62d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00821
Status: valid/unmigrated Version: rel:R25-11#e62d6a96 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_00821@rel:R25-11#e62d6a96
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#6119e35a2026-09-30
  • R19-11rel:R19-11#e173afea2026-10-14
  • R20-11rel:R20-11#41c521af2026-10-14
  • R21-11rel:R21-11#41c521af2026-10-14
  • R22-11rel:R22-11#db12de522026-10-14
  • R23-11rel:R23-11#df1fdca12026-10-14
  • R24-11rel:R24-11#bfe464be2026-10-14
  • R25-11rel:R25-11#e62d6a962026-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

函数 TriggerVehicleAnnouncement [SWS_DM_00822] Upstream: RS_Diag_04242

virtual ara::core::Result< void > TriggerVehicleAnnouncement (std::uint8_t networkInterfaceId) noexcept=0;

Called by application to trigger DM sending out vehicle announcements on the given network interface Id.

AI 生成 未审核 模型： gemini-3.8-flash-medium · 推理强度： medium · 温度： 不可控 · 提示词： fd0a2f72ec5a 来源 未决问题（1）
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

接口 ara::diag::DoIPTriggerVehicleAnnouncement [SWS_DM_00820] 的方法 TriggerVehicleAnnouncement 用于促使 Diagnostic Management（DM）在指定的网络接口上根据 ISO 13400-2 发送 DoIP 车辆公告 [SWS_DM_00815]、[SWS_DM_00822]。

用法与语义

该函数接收用于标识目标网络接口的参数 networkInterfaceId（std::uint8_t），并返回 ara::core::Result<void> [SWS_DM_00822]。它声明为 noexcept 且不抛出异常 [SWS_DM_00822]。

错误处理与边界条件

针对该方法未定义标准化错误码 [SWS_DM_00822]。如果传入的 networkInterfaceId 属于具有属性 isActivationLineDependent = TRUE 的网络配置，则视为出错 [SWS_DM_00822]。在此类接口上，激活激活线或分配 IP 地址后，便已自动触发发送 [SWS_DM_00816]、[SWS_DM_00822]。解读：由于不存在标准化错误码，该错误可能通过 Result 对象中的特定于制造商的错误码来指示。 问题 Q-ee2ea52f0b3064ce (未决)

并发性与交互

该操作被指定为非线程安全（not thread-safe）[SWS_DM_00822]。此外规范指出，该公告主要代表 DM 内部功能，在概念上实际上并不预期由 Adaptive Application 显式触发 AUTOSAR_AP_SWS_Diagnostics §7.x “About DiagnosticDoIPTriggerVehicleAnnouncementInterface”。

本使用说明由 AI 基于 AUTOSAR Adaptive R25-11 规范生成。

实现者指南即将推出（复杂度 I1）

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

Parameter (in)

ParameterBeschreibung
networkInterfaceIdnetwork interface id on which a vehicle announcement shall be sent.

Rückgabewert

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

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.
Hinweise: If the reported DoIPNetworkConfiguration.networkInterfaceId belongs to a DoIPNetwork Configuration with property isActivationLineDependent = TRUE, this is an error as on those interfaces sending of announcements happens automatically after activation line going up/IP address assignment.

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

Record
AUTOSAR/AP/record/SWS_DM_00822
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00822@rel:R25-11#6b5f2ca1
Content hash
6b5f2ca1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00822
Status: valid/unmigrated Version: rel:R25-11#a555ed27 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_00822@rel:R25-11#a555ed27
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b92e3a472026-09-30
  • R19-11rel:R19-11#fc8292e52026-10-14
  • R20-11rel:R20-11#f9a672462026-10-14
  • R21-11rel:R21-11#c73179122026-10-14
  • R22-11rel:R22-11#5dc1998b2026-10-14
  • R23-11rel:R23-11#fee398c12026-10-14
  • R24-11rel:R24-11#bed5c8df2026-10-14
  • R25-11rel:R25-11#a555ed272026-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

函数 ~DoIPTriggerVehicleAnnouncement [SWS_DM_02101] Upstream: RS_Diag_04242

~DoIPTriggerVehicleAnnouncement () noexcept=delete;

Dtor is vendor-specific.

Header-Datei#include "ara/diag/doip_trigger_vehicle_announcement.h"
Scopeclass ara::diag::DoIPTriggerVehicleAnnouncement
Sichtbarkeitprivate

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

Record
AUTOSAR/AP/record/SWS_DM_02101
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02101@rel:R25-11#8f8d1394
Content hash
8f8d1394
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02101
Status: valid/unmigrated Version: rel:R25-11#23915694 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_02101@rel:R25-11#23915694
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a098acdb2026-09-30
  • R24-11rel:R24-11#239156942026-10-14
  • R25-11rel:R25-11#239156942026-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