DEENESPTFRRUARHIKOZHNL

类 ara::shwa::DeviceMonitor

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_SHWA_01401] 原文尚未导入 Upstream: RS_SHWA_00004

class DeviceMonitor final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/device_monitor.h"
Scopenamespace ara::shwa

用户指南人工智能生成

允许监视硬件设备并查询其当前运行状态。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 7b51b19e11ac 来源 未决问题(2)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

允许监视硬件设备并查询其当前运行状态。

类 ara::shwa::DeviceMonitor 用于功能集群 shwa 中硬件设备状态的同步监视。实例通过静态工厂方法 Create 根据设备引用创建 ([AP_SWS_SHWA_01407]),随后可以通过方法 Status() 持续查询设备状态 ([AP_SWS_SHWA_01409])。虽然通过工厂方法的创建以线程安全方式执行,但用于状态查询的调用不是线程安全的,在并行访问时可能需要应用程序端进行同步。 问题 (未决)

上下文

类 ara::shwa::DeviceMonitor 在模块 shwa 中提供了用于监视硬件设备状态的核心接口。应用软件使用该类查询通过设备引用 Device 或通过选择器元素 DeviceSelector 识别的硬件组件的运行状态 ([AP_SWS_SHWA_01407]、[AP_SWS_SHWA_01408])。通过将状态确定封装在返回类型 DeviceStatus ([AP_SWS_SHWA_01409]) 中,DeviceMonitor 将调用控制应用程序与内部硬件细节解耦,并充当所寻址设备的生命周期和故障周期的标准化观察者。

生命周期

由于无参默认构造函数已被显式删除 ([AP_SWS_SHWA_01402]),因此无法通过该构造函数创建 DeviceMonitor 的实例。对象的创建是通过两个静态工厂方法受控进行的:Create(const Device &device) ([AP_SWS_SHWA_01407]) 或模板函数 Create(const DeviceSelector &deviceSelector) ([AP_SWS_SHWA_01408])。这两个工厂路径均返回 ara::core::Result<DeviceMonitor>,被指定为异常安全 (exception safe) 并保证线程安全性。

在所有权和值语义方面,该类表现得很灵活:复制构造函数 ([AP_SWS_SHWA_01403]) 和复制赋值运算符 ([AP_SWS_SHWA_01404]) 以及移动构造函数 ([AP_SWS_SHWA_01405]) 和移动赋值运算符 ([AP_SWS_SHWA_01406]) 均作为标准化 (default) 且异常安全 (noexcept) 的操作提供。

在并发性方面,必须严格区分构造与使用:虽然通过工厂函数进行的创建是线程安全的,但查询方法 Status() 明确声明为非线程安全 (not thread-safe) ([AP_SWS_SHWA_01409])。当多个线程并行访问同一实例时,可能需要应用程序端进行同步。 问题 Q-4002d6fb6cac23ce (未决)

使用路径

典型的使用路径分为监视器实例的创建、结果的验证以及设备状态的重复查询。首先,应用程序调用工厂方法 Create 之一并传入目标组件 ([AP_SWS_SHWA_01407]、[AP_SWS_SHWA_01408])。随后,应用程序检查生成的 ara::core::Result 是否成功。如果对象有效,则调用方法 Status() ([AP_SWS_SHWA_01409]),该方法同步返回类型为 DeviceStatus 的对象。

DeviceMonitor 的使用路径应用DeviceMonitorCreate(device)Result<DeviceMonitor>altResult 包含值Status()DeviceStatusResult 包含错误Auswertung von ShwaErrorCode

时序图:从实例化到重复状态查询的典型调用流程。来源:[AP_SWS_SHWA_01407]、[AP_SWS_SHWA_01409]

错误场景

错误主要发生在通过工厂方法 Create 进行创建期间,并且不使用 C++ 异常,而是在返回类型 ara::core::Result 中通过 ShwaErrorCode 提供 ([AP_SWS_SHWA_01407]、[AP_SWS_SHWA_01408])。针对创建定义了以下错误状态:

在运行期间调用 Status() 时,未规定任何错误代码或异常;该方法为 noexcept 并保证异常安全 ([AP_SWS_SHWA_01409])。因此,硬件故障或连接丢失大概会反映在返回的状态值 DeviceStatus 中。 问题 Q-8e2c8c2c7533b36f (未决)

本指南基于 AUTOSAR Adaptive Platform R25-11 规范的规定。

成员图

构造函数和析构函数

1

运算符

1

详细视图

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

构造函数和析构函数

DeviceMonitor 函数 3

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

重载 DeviceMonitor 3
DeviceMonitor ()=delete; AP_SWS_SHWA_01402
DeviceMonitor (DeviceMonitor &&devMonitor) noexcept=default; AP_SWS_SHWA_01405
DeviceMonitor (DeviceMonitor const &devMonitor) noexcept=default; AP_SWS_SHWA_01403

方法

Create 函数 2

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

重载 Create 2
static ara::core::Result< DeviceMonitor > Create (const Device &device) noexcept; AP_SWS_SHWA_01407
template <typename DeviceSelector> static ara::core::Result< DeviceMonitor > Create (const DeviceSelector &deviceSelector) noexcept; AP_SWS_SHWA_01408
Status 函数

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

DeviceStatus Status () const noexcept;

运算符

operator= 函数 2

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

重载 = 2
DeviceMonitor & operator= (const DeviceMonitor &devMonitor) noexcept=default; AP_SWS_SHWA_01404
DeviceMonitor & operator= (DeviceMonitor &&devMonitor) noexcept=default; AP_SWS_SHWA_01406

详细信息

函数 DeviceMonitor [AP_SWS_SHWA_01402] Upstream: RS_SHWA_00004

DeviceMonitor ()=delete;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::DeviceMonitor

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01402
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01402@rel:R25-11#23561f29
Content hash
23561f29
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01402
Status: valid/unmigrated Version: rel:R25-11#259dd759 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01402@rel:R25-11#259dd759
Point-in-Time History:
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

函数 DeviceMonitor [AP_SWS_SHWA_01405] Upstream: RS_SHWA_00004, RS_SHWA_00018

DeviceMonitor (DeviceMonitor &&devMonitor) noexcept=default;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::DeviceMonitor
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01405
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01405@rel:R25-11#e2972a70
Content hash
e2972a70
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01405
Status: valid/unmigrated Version: rel:R25-11#62075007 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01405@rel:R25-11#62075007
Point-in-Time History:
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= [AP_SWS_SHWA_01404] Upstream: RS_SHWA_00004

DeviceMonitor & operator= (const DeviceMonitor &devMonitor) noexcept=default;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::DeviceMonitor
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01404
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01404@rel:R25-11#41b6b993
Content hash
41b6b993
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01404
Status: valid/unmigrated Version: rel:R25-11#ef73e799 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01404@rel:R25-11#ef73e799
Point-in-Time History:
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= [AP_SWS_SHWA_01406] Upstream: RS_SHWA_00004

DeviceMonitor & operator= (DeviceMonitor &&devMonitor) noexcept=default;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::DeviceMonitor
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01406
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01406@rel:R25-11#8c26f998
Content hash
8c26f998
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01406
Status: valid/unmigrated Version: rel:R25-11#6e7296b5 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01406@rel:R25-11#6e7296b5
Point-in-Time History:
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

函数 DeviceMonitor [AP_SWS_SHWA_01403] Upstream: RS_SHWA_00004

DeviceMonitor (DeviceMonitor const &devMonitor) noexcept=default;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::DeviceMonitor
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01403
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01403@rel:R25-11#c5eb10ce
Content hash
c5eb10ce
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01403
Status: valid/unmigrated Version: rel:R25-11#5df7fddf Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01403@rel:R25-11#5df7fddf
Point-in-Time History:
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

函数 Create [AP_SWS_SHWA_01407] Upstream: RS_SHWA_00004, RS_SHWA_00007

static ara::core::Result< DeviceMonitor > Create (const Device &device) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::DeviceMonitor
Thread Safetythread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01407
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01407@rel:R25-11#894ae926
Content hash
894ae926
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01407
Status: valid/unmigrated Version: rel:R25-11#b38e96c2 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01407@rel:R25-11#b38e96c2
Point-in-Time History:
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

函数 Create [AP_SWS_SHWA_01408] Upstream: RS_SHWA_00004, RS_SHWA_00007

template <typename DeviceSelector> static ara::core::Result< DeviceMonitor > Create (const DeviceSelector &deviceSelector) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::DeviceMonitor
Thread Safetythread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01408
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01408@rel:R25-11#c6429d43
Content hash
c6429d43
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01408
Status: valid/unmigrated Version: rel:R25-11#56df0a2e Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01408@rel:R25-11#56df0a2e
Point-in-Time History:
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

函数 Status [AP_SWS_SHWA_01409] Upstream: RS_SHWA_00004

DeviceStatus Status () const noexcept;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::DeviceMonitor
Thread Safetynot thread-safe
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01409
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01409@rel:R25-11#0f800f39
Content hash
0f800f39
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01409
Status: valid/unmigrated Version: rel:R25-11#174997a6 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_01409@rel:R25-11#174997a6
Point-in-Time History:
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