DEENESPTFRRUARHIKOZHNL

classe 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] libellé pas encore importé 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

Guide utilisateurGÉNÉRÉ PAR IA

Sert de point d'entrée pour déterminer les plateformes d'accélération matérielle disponibles et leurs périphériques associés.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 60e95dec807e Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Sert de point d'entrée pour déterminer les plateformes d'accélération matérielle disponibles et leurs périphériques associés.

La classe ara::shwa::Platform sert de point d'entrée central pour la découverte d'accélérateurs matériels dans le cluster AUTOSAR Safe Hardware Acceleration (SWS SafeHardwareAcceleration §1 « Scope of Document »). Après avoir obtenu les instances de plateforme disponibles via la méthode fabrique statique, l'application appelle GetDevices() pour déterminer les périphériques accélérateurs connectés pour des tâches de calcul parallèle ([AP_SWS_SHWA_01108]). Comme le constructeur par défaut est supprimé et que les méthodes ne sont pas sûres au niveau des threads, les instances doivent être obtenues via la méthode fabrique et les accès doivent être synchronisés côté application en cas de concurrence.

Contexte

La classe ara::shwa::Platform constitue le point d'entrée central dans le cluster fonctionnel Safe Hardware Acceleration (SHWA) de l'AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 « Scope of Document »). L'objectif de ce cluster est de fournir aux Adaptive Applications et à d'autres clusters fonctionnels une interface standardisée, portable et sûre pour l'utilisation d'accélérateurs matériels (SWS SafeHardwareAcceleration §4.1 « Functional Overview »). Le cluster SHWA est responsable des opérations de calcul parallèle dans le respect des exigences de sécurité automobile, de la détection et de la correction des erreurs sur les accélérateurs ainsi que de la surveillance de l'état de fonctionnement du matériel (SWS SafeHardwareAcceleration §4.1 « Functional Overview »).

Dans l'architecture du cluster, Platform représente la plateforme matérielle de niveau supérieur par l'intermédiaire de laquelle s'effectue l'accès aux unités d'exécution spécifiques (Device) (SWS SafeHardwareAcceleration §7 « High Level Design of Safe Hardware Acceleration in an Adaptive Platform »). Une Adaptive Application interagit avec la plateforme pour déterminer les périphériques accélérateurs présents qui, en interaction avec des files d'attente (queues) et des tampons (buffers), traitent des tâches de calcul intensif en parallèle (SWS SafeHardwareAcceleration §7 « High Level Design of Safe Hardware Acceleration in an Adaptive Platform »).

Cycle de vie

Le cycle de vie de ara::shwa::Platform est soumis à une instanciation contrôlée. Le constructeur par défaut est explicitement supprimé ([AP_SWS_SHWA_01102]), de sorte que les applications ne peuvent pas créer d'objets de plateforme hors contexte. L'initialisation s'effectue exclusivement via la méthode fabrique statique GetPlatforms() ([AP_SWS_SHWA_01107]).

Les instances mises à disposition prennent en charge une sémantique complète de valeur et de déplacement :

Interprétation : comme tous les opérateurs de copie et de déplacement sont déclarés comme triviaux par défaut, Platform devrait être conçue comme un mandataire (proxy) ou descripteur léger pour le contexte de pilote. Question Q-d136569f5adb1a20 (ouverte) Concernant la concurrence, les méthodes de la classe sont expressément spécifiées comme non sûres au niveau des threads (not thread-safe) ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Si des instances sont utilisées sur plusieurs threads, les appels doivent être synchronisés côté application.

Parcours d'utilisation

L'intégration de ara::shwa::Platform dans une application s'effectue selon une séquence d'étapes définie :

  1. L'application appelle la méthode fabrique statique ara::shwa::Platform::GetPlatforms() pour interroger toutes les instances de plateforme disponibles ([AP_SWS_SHWA_01107]).
  2. Dans le vecteur de résultats renvoyé, l'application sélectionne l'instance de plateforme souhaitée.
  3. Sur cette instance, la méthode GetDevices() est appelée pour interroger les accélérateurs matériels associés ([AP_SWS_SHWA_01108]).
  4. Les objets Device résultants sont ensuite utilisés pour créer des files d'attente et des tampons afin d'exécuter des opérations de calcul sur le matériel (SWS SafeHardwareAcceleration §7 « High Level Design of Safe Hardware Acceleration in an Adaptive Platform »).
Exploration de la plateforme et des périphériquesApplicationara::shwa::PlatformInstanz: PlatformGetPlatforms()Result<Vector<Platform>>altErfolgGetDevices()Result<Vector<Device>>Fehler (kResourceBusy / kRuntime)Effectuer le traitement des erreurs

Diagramme de séquence : déroulement typique de l'interrogation de plateforme et de la détermination ultérieure des périphériques accélérateurs disponibles. Sources : [AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108], SWS SafeHardwareAcceleration §7 « High Level Design of Safe Hardware Acceleration in an Adaptive Platform ».

Scénarios d'erreur

Les opérations de ara::shwa::Platform sont déclarées comme noexcept et ne lèvent aucune exception C++ ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Les situations d'erreur sont transmises via le type d'erreur de la valeur de retour ara::core::Result. Tant pour GetPlatforms() que pour GetDevices(), les codes d'erreur suivants sont spécifiés :

  • ShwaErrorCode::kResourceBusy : l'opération demandée n'a pas pu être exécutée car la ressource matérielle ou logicielle concernée est actuellement occupée ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
  • ShwaErrorCode::kRuntime : une erreur générale d'exécution s'est produite ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Aucune sémantique de rollback (no_rollback_semantics) n'est prévue pour cette erreur, raison pour laquelle l'état interne n'est pas automatiquement réinitialisé et l'application doit traiter l'opération.

Ce guide de classe a été élaboré pour l'AUTOSAR Adaptive Platform Release R25-11 à partir des spécifications du module Safe Hardware Acceleration.

Carte des membres

Constructeurs et destructeur

1

Opérateurs

1

Vue détaillée

Sélectionnez une entrée dans le plan.

Constructeurs et destructeur

Platform fonction 3

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

Surcharges 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

Méthodes

GetDevices fonction

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

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

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;

Opérateurs

operator= fonction 2

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

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

Détails

fonction 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#8566f8d9
Content hash
8566f8d9
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

fonction 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#108c429a
Content hash
108c429a
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

fonction 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#830450cf
Content hash
830450cf
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

fonction 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#3f33e22a
Content hash
3f33e22a
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

fonction 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#a42cb797
Content hash
a42cb797
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

fonction 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#33e400a2
Content hash
33e400a2
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

fonction 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#2f1d426c
Content hash
2f1d426c
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