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] texto ainda não 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

Guia do utilizadorGERADO POR IA

Serve como ponto de entrada para a determinação de plataformas de aceleração de hardware disponíveis e dos seus dispositivos associados.
GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 60e95dec807e Procedência Perguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

Serve como ponto de entrada para a determinação de plataformas de aceleração de hardware disponíveis e dos seus dispositivos associados.

A classe ara::shwa::Platform serve como ponto de entrada central para a descoberta de aceleradores de hardware no cluster Safe Hardware Acceleration (SWS SafeHardwareAcceleration §1 «Scope of Document») do AUTOSAR. Após a obtenção de instâncias de plataforma disponíveis através do método estático de fábrica, a aplicação chama GetDevices() para determinar os dispositivos aceleradores conectados para tarefas de computação paralela ([AP_SWS_SHWA_01108]). Como o construtor padrão está excluído e os métodos não são thread-safe, as instâncias devem ser obtidas através do método de fábrica e os acessos devem ser sincronizados do lado da aplicação em caso de concorrência.

Contexto

A classe ara::shwa::Platform constitui o ponto de entrada central no cluster funcional Safe Hardware Acceleration (SHWA) da AUTOSAR Adaptive Platform (SWS SafeHardwareAcceleration §1 «Scope of Document»). O objetivo deste cluster é disponibilizar a Adaptive Applications e a outros clusters funcionais uma interface padronizada, portátil e segura para a utilização de aceleradores de hardware (SWS SafeHardwareAcceleration §4.1 «Functional Overview»). O cluster SHWA é responsável por operações de computação paralela em conformidade com os requisitos de segurança automotiva, pela detecção e correção de erros em aceleradores, bem como pelo monitoramento do estado operacional do hardware (SWS SafeHardwareAcceleration §4.1 «Functional Overview»).

Na arquitetura do cluster, Platform representa a plataforma de hardware de nível superior através da qual é realizado o acesso a unidades de execução específicas (Device) (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»). Uma Adaptive Application interage com a plataforma para determinar os dispositivos aceleradores existentes, os quais processam em paralelo tarefas computacionalmente intensivas em conjunto com filas (queues) e buffers (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).

Ciclo de vida

O ciclo de vida de ara::shwa::Platform está sujeito a uma instanciação controlada. O construtor padrão está explicitamente excluído ([AP_SWS_SHWA_01102]), de modo que as aplicações não podem criar objetos de plataforma sem contexto. A inicialização ocorre exclusivamente através do método estático de fábrica GetPlatforms() ([AP_SWS_SHWA_01107]).

As instâncias disponibilizadas suportam semântica completa de valor e de movimentação:

Interpretação: Como todos os operadores de cópia e movimentação são declarados como padrão trivial, Platform deverá ter sido concebido como um representante leve ou descritor para o contexto do driver. Pergunta Q-d136569f5adb1a20 (aberta) No que diz respeito à concorrência, os métodos da classe são expressamente especificados como não thread-safe (not thread-safe) ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Caso instâncias sejam utilizadas entre threads, as chamadas deverão ser sincronizadas do lado da aplicação.

Caminho de utilização

A integração de ara::shwa::Platform em uma aplicação segue uma sequência fixa de etapas:

  1. A aplicação chama o método estático de fábrica ara::shwa::Platform::GetPlatforms() para consultar todas as instâncias de plataforma disponíveis ([AP_SWS_SHWA_01107]).
  2. A partir do vetor de resultados retornado, a aplicação seleciona a instância de plataforma pretendida.
  3. Nessa instância, o método GetDevices() é chamado para consultar os aceleradores de hardware associados ([AP_SWS_SHWA_01108]).
  4. Os objetos Device resultantes são subsequentemente utilizados para a criação de filas e buffers a fim de executar operações de computação no hardware (SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform»).
Reconhecimento de plataforma e dispositivoAplicaçãoara::shwa::PlatformInstanz: PlatformGetPlatforms()Result<Vector<Platform>>altErfolgGetDevices()Result<Vector<Device>>Fehler (kResourceBusy / kRuntime)Executar tratamento de erro

Diagrama de sequência: fluxo típico da consulta à plataforma e subsequente determinação de dispositivos aceleradores disponíveis. Fontes: [AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108], SWS SafeHardwareAcceleration §7 «High Level Design of Safe Hardware Acceleration in an Adaptive Platform».

Cenários de erro

As operações de ara::shwa::Platform são declaradas como noexcept e não lançam exceções C++ ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Situações de erro são transmitidas através do tipo de erro do valor de retorno ara::core::Result. Tanto em GetPlatforms() quanto em GetDevices(), estão especificados os seguintes códigos de erro:

  • ShwaErrorCode::kResourceBusy: A operação solicitada não pôde ser executada porque o recurso de hardware ou de software afetado está atualmente ocupado ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]).
  • ShwaErrorCode::kRuntime: Ocorreu um erro geral de tempo de execução ([AP_SWS_SHWA_01107], [AP_SWS_SHWA_01108]). Não está prevista semântica de rollback (no_rollback_semantics) para este erro, razão pela qual o estado interno não é revertido automaticamente e a aplicação deve tratar a ocorrência.

Este guia de classe foi elaborado para a AUTOSAR Adaptive Platform Release R25-11 com base nas especificações do módulo Safe Hardware Acceleration.

Mapa de membros

Construtores e destrutor

1

Operadores

1

Vista de detalhes

Selecione uma entrada no índice.

Construtores e destrutor

Platform função 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 função

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

ara::core::Result< ara::core::Vector< Device > > GetDevices () noexcept;
GetPlatforms função

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= função 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

Detalhes

função 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#dc17c8bd
Content hash
dc17c8bd
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

função 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#95f040a7
Content hash
95f040a7
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

função 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#c4d9539d
Content hash
c4d9539d
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

função 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#3559d579
Content hash
3559d579
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

função 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#e9d42528
Content hash
e9d42528
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

função 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#0f3b8b47
Content hash
0f3b8b47
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

função 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#0c689be1
Content hash
0c689be1
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