DEENESPTFRRUARHIKOZHNL
AUTOSAR_SWS_Persistency FIG-633f95abbaab8c25 819 × 585 px 2 Release(s)

Figure 7.1: Typical usage of Persistency within an Adaptive Application

SHA-256 Inhalts-Fingerabdruck: 633f95abbaab8c25e65d104ba567a8d9ec89badf309a4f8af5e7d19554d2b164

Im Versions-Explorer öffnen

Kanonischer Bildausschnitt (144 DPI WebP, gerendert aus Original-Vektorgrafik) · nicht öffentlich, nur mit Anmeldung und Freigabe
✦ KI-generierte Bildanalyse & technische Beschreibung Modell: gemini-3.8-flash (via agy) · Rezept figure-description@2 · erstellt am 2026-10-07

1. Diagrammtyp & Architektur-Kontext

  • Klassifikation: Informelles Block- und Architektur-Strukturdiagramm (Komponenten- und Kapselungsmodell der AUTOSAR Adaptive Platform).
  • Technischer Zweck & Einordnung: Illustration der Speicherabstraktion innerhalb des Functional Clusters Persistency (ara::per) für eine Adaptive Application (AdaptiveApplicationSwComponentType). Es visualisiert die Koexistenz und Kapselung der beiden komplementären Persistenzmechanismen – schlüsselbasierter strukturierter Datenzugriff (Key-Value Storage) und dateibasierter Bytestream-Zugriff (File-Proxy) – gegenüber dem persistenten Hardwarespeicher.

2. Komponenten, Entitäten & Schnittstellen

  • Application (AdaptiveApplicationSwComponentType): Der ausführende Anwendungsprozess im Userspace des POSIX-Betriebssystems, in dessen Kontext die Persistenzinstanzen instanziiert und betrieben werden.
  • Persistency (ara::per): Das funktionale Persistenz-Cluster, das als anwendungslokale C++-Bibliothek realisiert ist und die Low-Level-Interaktion mit dem darunterliegenden Dateisystem bzw. Flash/NVRAM kapselt.
  • Key-Value-Storage (A & B):
    • Repräsentiert diskrete Schlüssel-Wert-Datenbanken (ara::per::KeyValueStorage).
    • Modellierung im AUTOSAR-Manifest über PortPrototype (P-Port / R-Port), typisiert durch ein PersistencyKeyValueDatabaseInterface.
    • Hält typisierte Schlüssel-Wert-Paare (KeyA1 = Value1, KeyB1 = Value1, etc.), serialisiert über AUTOSAR-Datentypen.
    • Kardinalität: 1 … n Key-Value-Datenbanken pro Softwarekomponente; jede Datenbank verwaltet 0 … m Schlüssel-Wert-Paare.
  • File-Proxy (A):
    • Repräsentiert ein isoliertes virtuelles Verzeichnis (ara::per::FileStorage / File-Proxy-Container).
    • Modellierung im AUTOSAR-Manifest über PortPrototype, typisiert durch ein PersistencyFileProxyInterface.
    • Verwaltet raw Byte-Streams bzw. diskrete Dateien (File1.ext ... Filen.ext).
    • Kardinalität: 1 … n File-Proxies pro Komponente; jeder Proxy kapselt 0 … k Files (ara::per::ReadAccessor, ara::per::ReadWriteAccessor).
  • Hardware: Physikalischer nichtflüchtiger Speicher (eMMC, UFS, NOR/NAND-Flash, NVMe-SSD), angebunden über Betriebssystemtreiber und VFS (dargestellt durch den bidirektionalen Datenfluss-Pfeil zu Persistency).

3. Dynamisches Verhalten & Sequenzablauf

  • Initialisierung & Pre-Deployment:
    • Vordefinierte Key-Value-Paare und Init-Dateien werden während der Installations- bzw. Updatephase durch das Update and Configuration Management (UCM) auf Basis des Deployments und Manifests auf dem Hardware-Speicher bereitgestellt.
  • Laufzeit-Zugriff (CRUD-Operationen):
    • Key-Value-Storage: Synchrone/asynchrone API-Calls (GetValue, SetValue, SyncToStorage). Modifikationen im RAM-Cache werden synchron oder verzögert über SyncToStorage() redundant und transaktionssicher (Crash-Konsistenz) auf die Hardware geflusht.
    • File-Proxy: Öffnen und Modifizieren via Stream-Operatoren (OpenFileReadStream, OpenFileWriteStream). Sperren/Locks auf File-Ebene verhindern nebenläufige Konflikte innerhalb desselben Prozesses.
  • Fehler- und Abbruchverhalten:
    • Fehler (z. B. I/O-Fehler, Quota-Überschreitung, Korruption) werden über ara::core::Result<T> mit spezifischen PerErrc-Fehlercodes zurückgegeben.
    • Bei Datenkorruption greifen persistenzspezifische Integritätsprüfungen (CRC/Redundanz gemäß Redundancy Handling).

4. Normative Relevanz & Entwickler-Hinweise

  • Architektur & Manifest-Design:
    • Jede Instanz von Key-Value-Storage oder File-Proxy erfordert im AUTOSAR-Modell ein dediziertes Interface (PersistencyKeyValueDatabaseInterface bzw. PersistencyFileProxyInterface) sowie die Port-Konfiguration (PRPortPrototype) am SwComponentType.
    • Deployment-Deskriptoren definieren Speichergrenzen (Quota), Redundanzmechanismen (z. B. M-out-of-N-Kopien, CRC) und URI/Pfad-Mappings.
  • API-Nutzung & Performanz (ara::per):
    • Key-Value: Optimal für Statusdaten, Zähler, Kalibrierwerte und Konfigurationen mit kleinen bis mittleren Nutzdatenmengen.
    • File-Proxy: Zwingend für große, unstrukturierte oder streaming-basierte Artefakte (Log-Dateien, Core-Dumps, ML-Modelle, Zertifikats-Blobs).
    • Speicherzyklus & Wear-Leveling: Entwickler müssen zwingend die Persistenzstrategie (SyncToStorage) steuern, um unkontrollierte Schreibzugriffe und die Degradation von Flash-Zellen zu verhindern.
  • Sicherheits- & Zugriffskapselung:
    • Standardmäßig sind Instanzen streng an die jeweilige AdaptiveApplication isoliert. Ein prozessübergreifender Datenaustausch über Persistency ist architektonisch untersagt und muss über ara::com erfolgen.

Versionsvergleich KI-generiert · gemini-3.8-flash (via agy)

R18-10_R4.4.0_R1.5.0 → R19-03 keine inhaltliche Änderung Nachfolger: FIG-a3aa323d1cfd6bec

Keine inhaltlichen Änderungen erkennbar.

Zugeordnete Anforderungen

Diese Angaben zeigt der Versions-Explorer.

Aus dem Dokument extrahierter Text & Kontext

Begleitender Spezifikationstext:

Specification of Persistency AUTOSAR AP Release 18-10 Figure 7.1: Typical usage of Persistency within an Adaptive Application The functional cluster Persistency offers two different mechanisms to access persistent memory as shown in Figure 7.1. Key-Value-Storage offers access to one or multiple Key-Value-Databases for every AdaptiveApplicationSwComponentType. Every Key-Value-Database is represented by a PortPrototype typed by a PersistencyKeyValueDatabaseInterface in the application design for the respective AdaptiveApplicationSwComponentType. Every Key-Value-Database can hold multiple Key-Value-Pairs. A Key-Value database with predefined Key-Value pairs can be deployed with default data during installation or update of an Adaptive Application. This operation is triggered by the UCM module (see [6]) during installation or update using the deployment information and data provided by the installation package of the Adaptive Application. See section 7.4. File-Proxies offer access to a set of files, they are similar to a directory of a file system. Every File-Proxy is represented by a PortPrototype typed by a PersistencyFileProxyInterface in the application design for the respective AdaptiveApplicationSwComponentType. Every File-Proxy can hold multiple files as described in [2]. Similar to the Key-Value Pairs mentioned above, additional files can be created by the Adaptive Application using the Persistency API (see 8.2.7.9 and 8.2.7.11). A File-Proxy with predefined files with in

Vorkommen in AUTOSAR-Releases (3)

Release Dokument Seite Nr. Bildunterschrift im Dokument
R18-10_R4.4.0_R1.5.0 AUTOSAR_SWS_Persistency S. 19 7.1 Figure 7.1: Typical usage of Persistency within an Adaptive Application
R18-10_R4.4.0_R1.5.0 AUTOSAR_SWS_Persistency S. 19 7.1 Figure 7.1: Typical usage of Persistency within an Adaptive Application
R18-10-1 AUTOSAR_SWS_Persistency S. 19 7.1 Figure 7.1: Typical usage of Persistency within an Adaptive Application