DEENESPTFRRUARHIKOZHNL

class 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] Wortlaut noch nicht übernommen 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

User GuideKI-GENERIERT

Dient als Einstiegspunkt zur Ermittlung verfügbarer Hardware-Beschleunigungsplattformen und deren zugeordneter Geräte.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 60e95dec807e Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient als Einstiegspunkt zur Ermittlung verfügbarer Hardware-Beschleunigungsplattformen und deren zugeordneter Geräte.

Die Klasse ara::shwa::Platform dient als zentraler Einstiegspunkt zur Erkundung von Hardwarebeschleunigern im AUTOSAR-Cluster Safe Hardware Acceleration (SWS SafeHardwareAcceleration §1 „Scope of Document“). Nach dem Bezug verfügbarer Plattforminstanzen über die statische Fabrikmethode ruft die Anwendung GetDevices() auf, um die angebundenen Beschleunigergeräte für parallele Berechnungsaufgaben zu ermitteln ([AP_SWS_SHWA_01108]). Da der Standardkonstruktor gelöscht ist und die Methoden nicht threadsicher sind, müssen Instanzen über die Fabrikmethode bezogen und Zugriffe bei Nebenläufigkeit anwendungsseitig synchronisiert werden.

Kontext

Die Klasse ara::shwa::Platform bildet den zentralen Einstiegspunkt in das funktionale Cluster Safe Hardware Acceleration (SHWA) der AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 „Scope of Document“). Ziel dieses Clusters ist es, Adaptive Applications und anderen funktionalen Clustern eine standardisierte, portable und sichere Schnittstelle zur Nutzung von Hardwarebeschleunigern bereitzustellen (SWS SafeHardwareAcceleration §4.1 „Functional Overview“). Das Cluster SHWA verantwortet parallele Rechenoperationen unter Einhaltung automobiler Sicherheitsvorgaben, die Fehlererkennung und Fehlerkorrektur auf Beschleunigern sowie die Überwachung des Arbeitszustands der Hardware (SWS SafeHardwareAcceleration §4.1 „Functional Overview“).

In der Cluster-Architektur repräsentiert Platform die übergeordnete Hardwareplattform, über die der Zugriff auf spezifische Ausführungseinheiten (Device) erfolgt (SWS SafeHardwareAcceleration §7 „High Level Design of Safe Hardware Acceleration in an Adaptive Platform“). Eine Adaptive Application interagiert mit der Plattform, um die vorhandenen Beschleunigergeräte zu ermitteln, welche im Zusammenspiel mit Warteschlangen (Queues) und Puffern (Buffers) rechenintensive Aufgaben parallel verarbeiten (SWS SafeHardwareAcceleration §7 „High Level Design of Safe Hardware Acceleration in an Adaptive Platform“).

Lebenszyklus

Der Lebenszyklus von ara::shwa::Platform unterliegt einer kontrollierten Instanziierung. Der Standardkonstruktor ist explizit gelöscht ([AP_SWS_SHWA_01102]), sodass Anwendungen Plattformobjekte nicht ohne Kontext erzeugen können. Die Initialisierung erfolgt ausschließlich über die statische Fabrikmethode GetPlatforms() ([AP_SWS_SHWA_01107]).

Bereitgestellte Instanzen unterstützen vollständige Werte- und Verschiebesemantik:

Interpretation: Da sämtliche Kopier- und Verschiebeoperatoren als trivialer Standard deklariert sind, dürfte Platform als leichtgewichtiger Stellvertreter oder Deskriptor für den Treiberkontext konzipiert sein. Frage Q-d136569f5adb1a20 (offen) Bezüglich der Nebenläufigkeit sind die Methoden der Klasse ausdrücklich als nicht threadsicher (not thread-safe) spezifiziert ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Werden Instanzen threadübergreifend verwendet, müssen Aufrufe anwendungsseitig synchronisiert werden.

Nutzungspfad

Die Einbindung von ara::shwa::Platform in eine Anwendung erfolgt in einer festen Schrittfolge:

  1. Die Anwendung ruft die statische Fabrikmethode ara::shwa::Platform::GetPlatforms() auf, um alle verfügbaren Plattforminstanzen abzufragen ([AP_SWS_SHWA_01107]).
  2. Aus dem zurückgelieferten Ergebnisvektor wählt die Anwendung die gewünschte Plattforminstanz aus.
  3. Auf dieser Instanz wird die Methode GetDevices() aufgerufen, um die zugeordneten Hardwarebeschleuniger abzufragen ([AP_SWS_SHWA_01108]).
  4. Die resultierenden Device-Objekte werden anschließend zur Erstellung von Warteschlangen und Puffern genutzt, um Rechenoperationen auf der Hardware auszuführen (SWS SafeHardwareAcceleration §7 „High Level Design of Safe Hardware Acceleration in an Adaptive Platform“).
Plattform- und GeräteerkundungAnwendungara::shwa::PlatformInstanz: PlatformGetPlatforms()Result<Vector<Platform>>altErfolgGetDevices()Result<Vector<Device>>Fehler (kResourceBusy / kRuntime)Fehlerbehandlung durchführen

Sequenzdiagramm: Typischer Ablauf der Plattformabfrage und anschließenden Ermittlung verfügbarer Beschleunigergeräte. Quellen: [AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108], SWS SafeHardwareAcceleration §7 „High Level Design of Safe Hardware Acceleration in an Adaptive Platform“.

Fehlerszenarien

Die Operationen von ara::shwa::Platform sind als noexcept deklariert und werfen keine C++-Ausnahmen ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Fehlersituationen werden über den Fehlertyp des Rückgabewerts ara::core::Result übermittelt. Sowohl bei GetPlatforms() als auch bei GetDevices() sind folgende Fehlercodes spezifiziert:

  • ShwaErrorCode::kResourceBusy: Die angeforderte Operation konnte nicht ausgeführt werden, da die betroffene Hardware- oder Softwareressource derzeit belegt ist ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
  • ShwaErrorCode::kRuntime: Es ist ein allgemeiner Laufzeitfehler aufgetreten ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Für diesen Fehler ist keine Rollback-Semantik (no_rollback_semantics) vorgesehen, weshalb der interne Zustand nicht automatisch zurückgesetzt wird und die Anwendung den Vorgang behandeln muss.

Dieser Klassen-Leitfaden wurde für AUTOSAR Adaptive Platform Release R25-11 anhand der Spezifikationen des Moduls Safe Hardware Acceleration kuratiert.

Mitgliederkarte

Konstruktoren und Destruktor

1

Operatoren

1

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

Platform function 3

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

Überladungen 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

Methoden

GetDevices function

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

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

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;

Operatoren

operator= function 2

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

Überladungen = 2
Platform & operator= (const Platform &ptfm) noexcept=default; AP_SWS_SHWA_01104
Platform & operator= (Platform &&ptfm) noexcept=default; AP_SWS_SHWA_01106

Details

function 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#5f0e5b74
Content hash
5f0e5b74
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

function 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#55be7f30
Content hash
55be7f30
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

function 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#4f68176d
Content hash
4f68176d
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

function 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#c17dcc96
Content hash
c17dcc96
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

function 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#a94b2acc
Content hash
a94b2acc
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

function 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#7cfbd613
Content hash
7cfbd613
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

function 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#5546e8ef
Content hash
5546e8ef
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