struct apext::com::secoc::FVContainer

Die Struktur apext::com::secoc::FVContainer dient im Modul Communication Management als Transportbehälter für Frischewerte zur Absicherung der On-Board-Kommunikation [SWS_CM_11286]. Sie kapselt die Bitlänge des Werts im Feld length sowie den eigentlichen Frischewert als Byte-Vektor im Feld value [SWS_CM_11344]. Je nach Verwendungskontext transportiert der Vektor vollständige oder gekürzte Werte, wobei mangels interner Synchronisationsmechanismen eine externe Synchronisation bei Nebenläufigkeit erforderlich ist.

mehr ›

Kontext

Die Datenstruktur apext::com::secoc::FVContainer ist Bestandteil der Plattform-Erweiterungsschnittstellen (Platform Extension Interfaces) des Moduls Communication Management und im Header apext/com/secoc/fvm.h deklariert [SWS_CM_11286]. Gemäß der Architektur der AUTOSAR Adaptive Platform dienen Platform Extension Interfaces dazu, von Fahrzeugherstellern (OEM) oder Integratoren genutzt oder implementiert zu werden, um die Plattformfunktionalität an projektspezifische Anforderungen anzupassen (AUTOSAR_AP_SWS_CommunicationManagement S. 536 §C „Platform Extension Interfaces“).

Innerhalb der sicheren On-Board-Kommunikation (Secure Onboard Communication, SecOC) dient apext::com::secoc::FVContainer als standardisierter Datentransferbehälter für Frischewerte (Freshness Values) [SWS_CM_11286]. Die Struktur bündelt zwei zusammengehörige Informationen: die exakte Länge des Frischewerts in Bits im Feld length [SWS_CM_11344] sowie die Rohdaten des Frischewerts als Byte-Vektor im Feld value [SWS_CM_11345]. Sie fungiert dabei als direkte Schnittstelle zwischen dem AUTOSAR Communication Management und einer herstellerspezifischen Implementierung des Freshness Value Managers (FVM).

Kontextdiagramm: Einbettung von FVContainer als Datentransferobjekt zwischen Communication Management und FVM-Plattform-Erweiterung. Quellen: [SWS_CM_11286], AUTOSAR_AP_SWS_CommunicationManagement S. 536 §C „Platform Extension Interfaces“.

Lebenszyklus

Als C++-Struktur (struct) [SWS_CM_11286] mit ausschließlich öffentlichen Elementvariablen folgt apext::com::secoc::FVContainer dem Entwurfsmuster eines reinen Wertobjekts. Die Instanziierung erfolgt bedarfsorientiert entweder auf dem Stack oder dynamisch im Heap durch den Aufrufer oder den Aufgerufenen, abhängig davon, ob ein Frischewert an eine Methode übergeben oder als Rückgabewert bereitgestellt wird [SWS_CM_11345].

Die Lebensdauer einer Instanz ist maßgeblich an den enthaltenen Vektor ara::core::Vector<std::uint8_t> [SWS_CM_11345] gebunden. Beim Verlassen des Gültigkeitsbereichs werden alle für den Frischewert allozierten Speicherressourcen deterministisch freigegeben. Kopier- und Verschiebeoperationen richten sich nach der Standardsemantik der Typen std::uint64_t [SWS_CM_11344] und ara::core::Vector [SWS_CM_11345]. Die Struktur besitzt keine internen Synchronisationsmechanismen; der nebenläufige Zugriff über Thread-Grenzen hinweg dürfte daher vollständig in der Verantwortung der nutzenden Komponenten liegen (Interpretation). Frage Q-24fe9a6468a61804 (offen)

Nutzungspfad

Der typische Nutzungspfad umfasst die Erzeugung, Initialisierung und anschließende Auswertung des Containers beim Austausch von Frischewerten zur Nachrichtensicherung oder -verifikation. Je nachdem, ob apext::com::secoc::FVContainer als Methodenparameter oder als Rückgabewert fungiert, enthält der Vektor value entweder den vollständigen Frischewert oder einen gekürzten Wert (truncated value) [SWS_CM_11345].

Im Verifikations- oder Signierungsprozess fordert das Communication Management zunächst einen Frischewert an. Der Freshness Value Manager instantiiert den Container, legt die signifikante Bitlänge im Feld length fest [SWS_CM_11344] und befüllt den Vektor value mit den Byte-Werten [SWS_CM_11345]. Nach Rückgabe des Containers liest das Communication Management length und value aus, wobei die Bitlänge vermutlich die exakte Grenze definiert und ungenutzte Füllbits im letzten Byte des Vektors ignoriert werden (Interpretation). Frage Q-c3cfaf1bae1ad3ac (offen)

Sequenzdiagramm: Typische Bereitstellung und Auswertung des Frischewerts über den FVContainer. Quellen: [SWS_CM_11286], [SWS_CM_11344], [SWS_CM_11345].