DEENESPTFRRUARHIKOZHNL

clase 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] texto aún no importado 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

Guía del usuarioGENERADO POR IA

Sirve como punto de entrada para determinar las plataformas de aceleración por hardware disponibles y sus dispositivos asignados.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 60e95dec807e Procedencia Preguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Sirve como punto de entrada para determinar las plataformas de aceleración por hardware disponibles y sus dispositivos asignados.

La clase ara::shwa::Platform sirve como punto de entrada central para la exploración de aceleradores de hardware en el clúster de AUTOSAR Safe Hardware Acceleration (SWS SafeHardwareAcceleration §1 «Scope of Document»). Tras obtener las instancias de plataforma disponibles a través del método factory estático, la aplicación llama a GetDevices() para determinar los dispositivos aceleradores vinculados para tareas de cómputo paralelo ([AP_SWS_SHWA_01108]). Dado que el constructor predeterminado está eliminado y los métodos no son seguros para subprocesos, las instancias deben obtenerse a través del método factory y los accesos concurrentes deben sincronizarse en la aplicación.

Contexto

La clase ara::shwa::Platform constituye el punto de entrada central al clúster funcional Safe Hardware Acceleration (SHWA) de la AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 «Scope of Document»). El objetivo de este clúster es proporcionar a las Adaptive Applications y a otros clústeres funcionales una interfaz estandarizada, portable y segura para el uso de aceleradores de hardware (SWS SafeHardwareAcceleration §4.1 «Functional Overview»). El clúster SHWA se encarga de las operaciones de cómputo en paralelo cumpliendo las especificaciones de seguridad automotriz, de la detección y corrección de errores en los aceleradores, así como de la supervisión del estado operativo del hardware (SWS SafeHardwareAcceleration §4.1 «Functional Overview»).

En la arquitectura del clúster, Platform representa la plataforma de hardware de nivel superior a través de la cual se accede a unidades de ejecución específicas (Device) (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»). Una Adaptive Application interactúa con la plataforma para determinar los dispositivos aceleradores presentes, los cuales procesan en paralelo tareas de cómputo intensivo en interacción con colas (queues) y búferes (buffers) (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).

Ciclo de vida

El ciclo de vida de ara::shwa::Platform está sujeto a una instanciación controlada. El constructor predeterminado está explícitamente eliminado ([AP_SWS_SHWA_01102]), por lo que las aplicaciones no pueden crear objetos de plataforma sin contexto. La inicialización se realiza exclusivamente a través del método factory estático GetPlatforms() ([AP_SWS_SHWA_01107]).

Las instancias proporcionadas admiten semántica completa de valor y de movimiento:

Interpretación: Puesto que todos los operadores de copia y de movimiento están declarados como estándar trivial, es probable que Platform esté concebida como un representante ligero o descriptor para el contexto del controlador. Pregunta Q-d136569f5adb1a20 (abierta) Respecto a la concurrencia, los métodos de la clase están especificados expresamente como no seguros para subprocesos (not thread-safe) ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Si las instancias se utilizan en varios subprocesos, las llamadas deben sincronizarse del lado de la aplicación.

Ruta de uso

La integración de ara::shwa::Platform en una aplicación sigue una secuencia fija de pasos:

  1. La aplicación llama al método factory estático ara::shwa::Platform::GetPlatforms() para consultar todas las instancias de plataforma disponibles ([AP_SWS_SHWA_01107]).
  2. A partir del vector de resultados devuelto, la aplicación selecciona la instancia de plataforma deseada.
  3. En esta instancia se invoca el método GetDevices() para consultar los aceleradores de hardware asignados ([AP_SWS_SHWA_01108]).
  4. Los objetos Device resultantes se utilizan a continuación para crear colas y búferes con el fin de ejecutar operaciones de cálculo en el hardware (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).
Exploración de plataformas y dispositivosAplicaciónara::shwa::PlatformInstanz: PlatformGetPlatforms()Result<Vector<Platform>>altErfolgGetDevices()Result<Vector<Device>>Fehler (kResourceBusy / kRuntime)Realizar tratamiento de errores

Diagrama de secuencias: flujo típico de la consulta de plataforma y posterior determinación de los dispositivos aceleradores disponibles. Fuentes: [AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108], SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform».

Escenarios de error

Las operaciones de ara::shwa::Platform están declaradas como noexcept y no lanzan excepciones C++ ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Las situaciones de error se transmiten a través del tipo de error del valor de retorno ara::core::Result. Tanto para GetPlatforms() como para GetDevices() se especifican los siguientes códigos de error:

  • ShwaErrorCode::kResourceBusy: La operación solicitada no pudo ejecutarse porque el recurso de hardware o software afectado se encuentra ocupado actualmente ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
  • ShwaErrorCode::kRuntime: Se ha producido un error general de tiempo de ejecución ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Para este error no se prevé ninguna semántica de reversión (no_rollback_semantics), razón por la cual el estado interno no se restablece automáticamente y la aplicación debe gestionar el proceso.

Esta guía de clase ha sido elaborada para AUTOSAR Adaptive Platform Release R25-11 basándose en las especificaciones del módulo Safe Hardware Acceleration.

Mapa de miembros

Constructores y destructor

1

Operadores

1

Vista de detalle

Selecciona una entrada en el índice.

Constructores y destructor

Platform función 3

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

Sobrecargas 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étodos

GetDevices función

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

ara::core::Result< ara::core::Vector< Device > > GetDevices () noexcept;
GetPlatforms función

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;

Operadores

operator= función 2

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

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

Detalles

función 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#130e8028
Content hash
130e8028
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

función 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#d7c0ba27
Content hash
d7c0ba27
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

función 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#240f5bd2
Content hash
240f5bd2
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

función 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#b9a61f5d
Content hash
b9a61f5d
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

función 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#e9081a58
Content hash
e9081a58
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

función 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#b4c48e62
Content hash
b4c48e62
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

función 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#574e0244
Content hash
574e0244
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