struct apext::com::secoc::FVContainer

De structuur apext::com::secoc::FVContainer dient in de module Communication Management als transportcontainer voor versheidswaarden ter beveiliging van de on-board-communicatie [SWS_CM_11286]. Deze kapselt de bitlengte van de waarde in het veld length en de eigenlijke versheidswaarde als bytevector in het veld value in [SWS_CM_11344]. Afhankelijk van de gebruikscontext transporteert de vector volledige of ingekorte waarden, waarbij wegens het ontbreken van interne synchronisatiemechanismen externe synchronisatie bij gelijktijdigheid vereist is.

meer ›

Context

De datastructuur apext::com::secoc::FVContainer maakt deel uit van de platformuitbreidingsinterfaces (Platform Extension Interfaces) van de module Communication Management en is gedeclareerd in header apext/com/secoc/fvm.h [SWS_CM_11286]. Conform de architectuur van het AUTOSAR Adaptive Platform dienen Platform Extension Interfaces ertoe door voertuigfabrikanten (OEM) of integrators te worden gebruikt of geïmplementeerd om de platformfunctionaliteit aan projectspecifieke eisen aan te passen (AUTOSAR_AP_SWS_CommunicationManagement p. 536 §C “Platform Extension Interfaces”).

Binnen de veilige on-board-communicatie (Secure Onboard Communication, SecOC) dient apext::com::secoc::FVContainer als gestandaardiseerde gegevensoverdrachtscontainer voor versheidswaarden (Freshness Values) [SWS_CM_11286]. De structuur bundelt twee bij elkaar horende gegevens: de exacte lengte van de versheidswaarde in bits in het veld length [SWS_CM_11344] en de ruwe data van de versheidswaarde als bytevector in het veld value [SWS_CM_11345]. Deze fungeert daarbij als directe interface tussen het AUTOSAR Communication Management en een fabrikantspecifieke implementatie van de Freshness Value Manager (FVM).

Contextdiagram: Inbedding van FVContainer als dataoverdrachtsobject tussen Communication Management en FVM-platformuitbreiding. Bronnen: [SWS_CM_11286], AUTOSAR_AP_SWS_CommunicationManagement p. 536 §C “Platform Extension Interfaces”.

Levenscyclus

Als C++-structuur (struct) [SWS_CM_11286] met uitsluitend publieke lidvariabelen volgt apext::com::secoc::FVContainer het ontwerppatroon van een zuiver waarde-object. De instantiëring vindt naar behoefte plaats, hetzij op de stack, hetzij dynamisch op de heap door de aanroeper of de aangeroepene, afhankelijk van het feit of een versheidswaarde aan een methode wordt doorgegeven of als retourwaarde beschikbaar wordt gesteld [SWS_CM_11345].

De levensduur van een instantie is primair gebonden aan de ingesloten vector ara::core::Vector<std::uint8_t> [SWS_CM_11345]. Bij het verlaten van de scope worden alle voor de versheidswaarde gealloceerde geheugenbronnen deterministisch vrijgegeven. Kopieer- en verplaatsingsoperaties richten zich naar de standaardsemantiek van de typen std::uint64_t [SWS_CM_11344] en ara::core::Vector [SWS_CM_11345]. De structuur bevat geen interne synchronisatiemechanismen; gelijktijdige toegang over threadgrenzen heen valt daarom vermoedelijk volledig onder de verantwoordelijkheid van de gebruikende componenten (interpretatie). Vraag Q-24fe9a6468a61804 (open)

Gebruikspad

Het typische gebruikspad omvat het aanmaken, initialiseren en aansluitend evalueren van de container bij het uitwisselen van versheidswaarden voor berichtbeveiliging of -verificatie. Afhankelijk van de vraag of apext::com::secoc::FVContainer fungeert als methodeparameter of als retourwaarde, bevat de vector value de volledige versheidswaarde of een ingekorte waarde (truncated value) [SWS_CM_11345].

In het verificatie- of ondertekeningsproces vraagt het Communication Management eerst een versheidswaarde aan. De Freshness Value Manager instantieert de container, legt de significante bitlengte vast in het veld length [SWS_CM_11344] en vult de vector value met de bytewaarden [SWS_CM_11345]. Na teruggave van de container leest het Communication Management length en value uit, waarbij de bitlengte vermoedelijk de exacte grens definieert en ongebruikte opvulbits in de laatste byte van de vector worden genegeerd (interpretatie). Vraag Q-c3cfaf1bae1ad3ac (open)

Sequentiediagram: Typische beschikbaarstelling en evaluatie van de versheidswaarde via de FVContainer. Bronnen: [SWS_CM_11286], [SWS_CM_11344], [SWS_CM_11345].