AUTOSAR_SWS_Persistency FIG-a3aa323d1cfd6bec 819 × 584 px 2 Release(s)

Figure 7.1: Typical usage of Persistency within an Adaptive Application

SHA-256 Inhalts-Fingerabdruck: a3aa323d1cfd6bec404d56dfc6cc170bfa616776bcd3dcda294fca9935e11927

✦ KI-generierte Bildanalyse & technische Beschreibung Modell: gemini-3.8-flash (via agy) · Rezept figure-series@1 · erstellt am 2026-10-08

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 Vorgänger: FIG-633f95abbaab8c25

Keine inhaltlichen Änderungen erkennbar.

R19-11 → R20-11 normative Änderung Nachfolger: FIG-08c78db8ef539276

Hardware & Verbindungspfeil: Der physische Speicherblock „Hardware“ am unteren Bildrand und der bidirektionale Verbindungspfeil zu „Persistency“ wurden entfernt.
Persistenzmechanismus (File Storage statt File-Proxy): Der Container „File-Proxy A“ mit den Dateien File1.ext ... Filen.ext wurde ersetzt durch zwei separate Speicherinstanzen „File Storage C“ (mit File_C1, File_C2, ...) und „File Storage D“ (mit File_D1, File_D2, ...), getrennt durch vertikale Auslassungspunkte ....
Äußerer Komponentenrahmen: Umbenennung von „Application“ zu „Adaptive Application“.
Subsystem Persistency: Der Titeltext „Persistency“ wurde von gelber Typografie auf zentrierte schwarze Schrift umgestellt.
Key-Value Storage: Bindestrich im Bezeichner entfernt („Key-Value Storage“ statt zuvor „Key-Value-Storage“), Schlüssel-Wert-Syntax vereinheitlicht (Key_A1 = Value_A1 statt KeyA1 = Value1) und vertikale Auslassungspunkte ... zwischen Speicher A und B ergänzt.

Zugeordnete Anforderungen

Diese Angaben zeigt der Versions-Explorer.

Erkannte Spezifikationsbelege & Anforderungen auf dieser Seite

RS_PER_00017 RS_PER_00018 SWS_PER_00405 SWS_PER_00406 SWS_PER_00407 SWS_PER_00408 SWS_PER_00409 SWS_PER_00410

Aus dem Dokument extrahierter Text & Kontext

Begleitender Spezifikationstext:

Specification of Persistency AUTOSAR AP R19-11 [RS_PER_00017] Persistency shall be able to report the amount of currently used storage [SWS_PER_00405] [SWS_PER_00406] [SWS_PER_00407] [RS_PER_00018] Persistency shall support central initialization and shutdown [SWS_PER_00408] [SWS_PER_00409] [SWS_PER_00410] 7 Functional specification 7.1 Architecture The typical usage of the Persistency within an Adaptive Application is depicted in Figure 7.1. As shown there, an Adaptive Application can use a combination of multiple Key-Value Storages and multiple File Storages. 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 Storages for every AdaptiveApplicationSwComponentType. Every Key-Value Storage is represented by a PortPrototype typed by a PersistencyKeyValueDatabaseInterface in the application design for the respective AdaptiveApplication- 26 of 113 — AUTOSAR CONFIDENTIAL — Document ID 858: AUTOSAR_SWS_Persistency

Vorkommen in AUTOSAR-Releases (4)

Release	Dokument	Seite	Nr.	Bildunterschrift im Dokument
R19-03	AUTOSAR_SWS_Persistency	S. 23	7.1	Figure 7.1: Typical usage of Persistency within an Adaptive Application
R19-03	AUTOSAR_SWS_Persistency	S. 23	7.1	Figure 7.1: Typical usage of Persistency within an Adaptive Application
R19-11	AUTOSAR_SWS_Persistency	S. 26	7.1	Figure 7.1: Typical usage of Persistency within an Adaptive Application
R19-11	AUTOSAR_SWS_Persistency	S. 26	7.1	Figure 7.1: Typical usage of Persistency within an Adaptive Application