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] wording not yet importedUpstream: RS_SHWA_00018
class Platform final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
Serves as an entry point for discovering available hardware acceleration platforms and their associated devices.
AI-GENERATEDunreviewedModel: gemini-3.8-flash-medium · Effort: medium · Temperature: not controllable · Prompt: 60e95dec807eProvenanceOpen questions (1)
translated from the German guidegemini-3.8-flash-low · 2026-10-13 · German original
Serves as an entry point for discovering available hardware acceleration platforms and their associated devices.
The class ara::shwa::Platform serves as a central entry point for exploring hardware accelerators in the AUTOSAR Safe Hardware Acceleration cluster (SWS SafeHardwareAcceleration §1 “Scope of Document”). After obtaining available platform instances via the static factory method, the application calls GetDevices() to determine the connected accelerator devices for parallel computation tasks ([AP_SWS_SHWA_01108]). Because the default constructor is deleted and the methods are not thread-safe, instances must be obtained via the factory method and access under concurrency must be synchronized on the application side.
Context
The class ara::shwa::Platform forms the central entry point into the Safe Hardware Acceleration (SHWA) functional cluster of the AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 “Scope of Document”). The goal of this cluster is to provide Adaptive Applications and other functional clusters with a standardized, portable, and secure interface for using hardware accelerators (SWS SafeHardwareAcceleration §4.1 “Functional Overview”). The SHWA cluster is responsible for parallel computing operations in compliance with automotive safety requirements, error detection and error correction on accelerators, as well as monitoring the operational state of the hardware (SWS SafeHardwareAcceleration §4.1 “Functional Overview”).
The lifecycle of ara::shwa::Platform is subject to controlled instantiation. The default constructor is explicitly deleted ([AP_SWS_SHWA_01102]) so that applications cannot create platform objects without context. Initialization takes place exclusively via the static factory method GetPlatforms() ([AP_SWS_SHWA_01107]).
Provided instances support complete value and move semantics:
Interpretation: Since all copy and move operators are declared as trivial default, Platform is likely designed as a lightweight proxy or descriptor for the driver context. Question Q-d136569f5adb1a20 (open) Regarding concurrency, the methods of the class are explicitly specified as not thread-safe (not thread-safe) ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). If instances are used across threads, calls must be synchronized on the application side.
Usage Path
The integration of ara::shwa::Platform into an application follows a fixed sequence of steps:
The application calls the static factory method ara::shwa::Platform::GetPlatforms() to query all available platform instances ([AP_SWS_SHWA_01107]).
From the returned result vector, the application selects the desired platform instance.
On this instance, the method GetDevices() is called to query the assigned hardware accelerators ([AP_SWS_SHWA_01108]).
The operations of ara::shwa::Platform are declared as noexcept and do not throw C++ exceptions ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Error situations are reported via the error type of the return value ara::core::Result. The following error codes are specified for both GetPlatforms() and GetDevices():
ShwaErrorCode::kResourceBusy: The requested operation could not be executed because the affected hardware or software resource is currently busy ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
ShwaErrorCode::kRuntime: A general runtime error occurred ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). No rollback semantics (no_rollback_semantics) are provided for this error, which is why the internal state is not automatically reset and the application must handle the operation.
This class guide was curated for AUTOSAR Adaptive Platform Release R25-11 based on the specifications of the Safe Hardware Acceleration module.
gemini-3.8-flash-low· 2026-10-13 · German original