DEENESPTFRRUARHIKOZHNL

فئة ara::shwa::Platform

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_01101] لم يُستورد النص بعد Upstream: RS_SHWA_00018

class Platform final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

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

دليل المستخدممولَّد بالذكاء الاصطناعي

يعمل كنقطة دخول لتحديد منصات تسريع العتاد المتاحة والأجهزة المرتبطة بها.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 60e95dec807e المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يعمل كنقطة دخول لتحديد منصات تسريع العتاد المتاحة والأجهزة المرتبطة بها.

تعمل الفئة ara::shwa::Platform كنقطة دخول مركزية لاستكشاف مسرعات العتاد في عنقود AUTOSAR المسمى Safe Hardware Acceleration (SWS SafeHardwareAcceleration §1 «Scope of Document»). بعد الحصول على مثيلات المنصة المتاحة عبر أسلوب المصنع الساكن، يقوم التطبيق باستدعاء GetDevices() لتحديد أجهزة التسريع المتصلة لمهام الحوسبة المتوازية ([AP_SWS_SHWA_01108]). ونظرًا لحذف المنشئ الافتراضي وعدم تمتع الأساليب بأمان الخيوط، يجب الحصول على المثيلات عبر أسلوب المصنع ومزامنة عمليات الوصول برمجيًا من جانب التطبيق في بيئات التزامن.

السياق

تشكل الفئة ara::shwa::Platform نقطة الدخول المركزية إلى Functional Cluster المسمى Safe Hardware Acceleration (SHWA) في AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 «Scope of Document»). يهدف هذا العنقود إلى تزويد Adaptive Applications وعناقيد وظيفية أخرى بواجهة قياسية وقابلة للنقل وآمنة لاستخدام مسرعات العتاد (SWS SafeHardwareAcceleration §4.1 «Functional Overview»). يتولى العنقود SHWA مسؤولية عمليات الحوسبة المتوازية مع الامتثال لمتطلبات السلامة الخاصة بالسيارات، واكتشاف الأخطاء وتصحيحها على المسرعات، فضلاً عن مراقبة حالة تشغيل العتاد (SWS SafeHardwareAcceleration §4.1 «Functional Overview»).

في معمارية العنقود، تمثل Platform منصة العتاد العليا التي يتم من خلالها الوصول إلى وحدات تنفيذ محددة (Device) (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»). يتفاعل Adaptive Application مع المنصة لتحديد أجهزة التسريع الموجودة، والتي تعالج بالتكامل مع قوائم الانتظار (Queues) والمخازن المؤقتة (Buffers) المهام كثيفة الحوسبة بشكل متوازٍ (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).

دورة الحياة

تخضع دورة حياة ara::shwa::Platform لعملية إنشاء مثيل منضبطة. تم حذف المنشئ الافتراضي صراحةً ([AP_SWS_SHWA_01102])، بحيث لا تتمكن التطبيقات من إنشاء كائنات المنصة دون سياق. يتم التهيئة حصريًا عبر أسلوب المصنع الساكن GetPlatforms() ([AP_SWS_SHWA_01107]).

تدعم المثيلات المتوفرة دلالات القيمة والنقل الكاملة:

تفسير: نظرًا للإعلان عن جميع معاملات النسخ والنقل كمعايير افتراضية بديهية، يُرجح تصميم Platform كوكيل خفيف الوزن أو واصف لسياق برنامج التشغيل. سؤال Q-d136569f5adb1a20 (مفتوح) وفيما يتعلق بالتزامن، تم تحديد أساليب الفئة صراحةً بأنها غير آمنة للخيوط (not thread-safe) ([AP_SWS_SHWA_01107]، [AP_SWS_SHWA_01108]). وفي حال استخدام المثيلات عبر خيوط متعددة، يجب مزامنة الاستدعاءات من جانب التطبيق.

مسار الاستخدام

يتم دمج ara::shwa::Platform في التطبيق عبر تسلسل خطوات محدد:

  1. يستدعي التطبيق أسلوب المصنع الساكن ara::shwa::Platform::GetPlatforms() للاستعلام عن جميع مثيلات المنصة المتاحة ([AP_SWS_SHWA_01107]).
  2. يختار التطبيق مثيل المنصة المطلوب من متجه النتائج المُعاد.
  3. يتم استدعاء الأسلوب GetDevices() على هذا المثيل للاستعلام عن مسرعات العتاد المرتبطة ([AP_SWS_SHWA_01108]).
  4. تُستخدم كائنات Device الناتجة بعد ذلك لإنشاء قوائم الانتظار والمخازن المؤقتة لتنفيذ العمليات الحسابية على العتاد (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).
استكشاف المنصة والأجهزةالتطبيقara::shwa::PlatformInstanz: PlatformGetPlatforms()Result<Vector<Platform>>altErfolgGetDevices()Result<Vector<Device>>Fehler (kResourceBusy / kRuntime)تنفيذ معالجة الأخطاء

مخطط التسلسل: المسار النموذجي للاستعلام عن المنصة ثم تحديد أجهزة التسريع المتاحة. المصادر: [AP_SWS_SHWA_01107]، [AP_SWS_SHWA_01108]، SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform».

سيناريوهات الأخطاء

تم الإعلان عن عمليات ara::shwa::Platform كـ noexcept ولا تطلق استثناءات C++ ([AP_SWS_SHWA_01107]، [AP_SWS_SHWA_01108]). يتم نقل حالات الخطأ عبر نوع الخطأ لقيمة الإرجاع ara::core::Result. تم تحديد رموز الخطأ التالية لكل من GetPlatforms() وGetDevices():

  • ShwaErrorCode::kResourceBusy: تعذر تنفيذ العملية المطلوبة لأن مورد العتاد أو البرمجيات المعني مشغول حاليًا ([AP_SWS_SHWA_01107]، [AP_SWS_SHWA_01108]).
  • ShwaErrorCode::kRuntime: حدث خطأ تشغيل عام ([AP_SWS_SHWA_01107]، [AP_SWS_SHWA_01108]). لا تتوفر دلالات التراجع (no_rollback_semantics) لهذا الخطأ، ولهذا السبب لا تتم إعادة ضبط الحالة الداخلية تلقائيًا ويجب على التطبيق معالجة هذه العملية.

تم تنسيق دليل الفئات هذا لـ AUTOSAR Adaptive Platform الإصدار R25-11 استنادًا إلى مواصفات الموديول Safe Hardware Acceleration.

خريطة الأعضاء

المُنشئات والمُتلف

1

الدوال الأعضاء

2

المعاملات

1

عرض التفاصيل

اختر عنصرًا من المخطط.

المُنشئات والمُتلف

Platform دالة 3

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

التحميلات الزائدة Platform 3
Platform ()=delete; AP_SWS_SHWA_01102
Platform (Platform &&ptfm) noexcept=default; AP_SWS_SHWA_01105
Platform (Platform const &ptfm) noexcept=default; AP_SWS_SHWA_01103

الدوال الأعضاء

GetDevices دالة

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

ara::core::Result< ara::core::Vector< Device > > GetDevices () noexcept;
GetPlatforms دالة

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

static ara::core::Result< ara::core::Vector< Platform > > GetPlatforms () noexcept;

المعاملات

operator= دالة 2

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

التحميلات الزائدة = 2
Platform & operator= (const Platform &ptfm) noexcept=default; AP_SWS_SHWA_01104
Platform & operator= (Platform &&ptfm) noexcept=default; AP_SWS_SHWA_01106

التفاصيل

دالة Platform [AP_SWS_SHWA_01102] Upstream: RS_SHWA_00018

Platform ()=delete;

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

Scopeclass ara::shwa::Platform

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01102
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01102@rel:R25-11#31ccd714
Content hash
31ccd714
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01102
Status: valid/unmigrated Version: rel:R25-11#5f0e5b74 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_01102@rel:R25-11#5f0e5b74
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

دالة Platform [AP_SWS_SHWA_01105] Upstream: RS_SHWA_00018

Platform (Platform &&ptfm) noexcept=default;

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

Scopeclass ara::shwa::Platform
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01105
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01105@rel:R25-11#b287bbf2
Content hash
b287bbf2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01105
Status: valid/unmigrated Version: rel:R25-11#55be7f30 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_01105@rel:R25-11#55be7f30
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_01104] Upstream: RS_SHWA_00018

Platform & operator= (const Platform &ptfm) noexcept=default;

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

Scopeclass ara::shwa::Platform
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01104
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01104@rel:R25-11#b9d6b284
Content hash
b9d6b284
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01104
Status: valid/unmigrated Version: rel:R25-11#4f68176d 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_01104@rel:R25-11#4f68176d
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_01106] Upstream: RS_SHWA_00018

Platform & operator= (Platform &&ptfm) noexcept=default;

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

Scopeclass ara::shwa::Platform
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01106
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01106@rel:R25-11#a0c8a7d0
Content hash
a0c8a7d0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01106
Status: valid/unmigrated Version: rel:R25-11#c17dcc96 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_01106@rel:R25-11#c17dcc96
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

دالة Platform [AP_SWS_SHWA_01103] Upstream: RS_SHWA_00018

Platform (Platform const &ptfm) noexcept=default;

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

Scopeclass ara::shwa::Platform
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01103
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01103@rel:R25-11#217d6af3
Content hash
217d6af3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01103
Status: valid/unmigrated Version: rel:R25-11#a94b2acc 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_01103@rel:R25-11#a94b2acc
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

دالة GetDevices [AP_SWS_SHWA_01108] Upstream: RS_SHWA_00018, RS_SHWA_00007

ara::core::Result< ara::core::Vector< Device > > GetDevices () noexcept;

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

Scopeclass ara::shwa::Platform
Thread Safetynot thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error no_rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01108
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01108@rel:R25-11#0fd7b07e
Content hash
0fd7b07e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01108
Status: valid/unmigrated Version: rel:R25-11#7cfbd613 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_01108@rel:R25-11#7cfbd613
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

دالة GetPlatforms [AP_SWS_SHWA_01107] Upstream: RS_SHWA_00018, RS_SHWA_00007

static ara::core::Result< ara::core::Vector< Platform > > GetPlatforms () noexcept;

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

Scopeclass ara::shwa::Platform
Thread Safetynot thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error no_rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01107@rel:R25-11#fb61603f
Content hash
fb61603f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01107
Status: valid/unmigrated Version: rel:R25-11#5546e8ef 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_01107@rel:R25-11#5546e8ef
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