namespace apext::tsync

De namespace apext::tsync stelt interfaces en datacontainers beschikbaar voor het Freshness Value Management van de Adaptive-tijdsynchronisatie. Via de interface FVM worden actualiteitswaarden ingekapseld in FVContainer-instanties om tijdsberichten te beveiligen tegen replay-aanvallen. Als bij de initialisatie een niet-herstelbare fout optreedt of als een waarde tijdelijk niet beschikbaar is, wordt dit gerepresenteerd via de foutcodes van de TsyncFvmErrorDomain [SWS_TS_14202]. De instantiëring van gestandaardiseerde foutobjecten vindt daarbij exceptieveilig en thread-veilig plaats via MakeErrorCode [SWS_TS_14213].

meer ›

Context

De namespace apext::tsync vormt een platformspecifieke uitbreiding van de AUTOSAR-Adaptive-tijdsynchronisatie (ara::tsync). Zijn centrale taak is het Freshness Value Management (FVM), dat mechanismen biedt om de actualiteit van tijdsinformatie te waarborgen, teneinde replay-aanvallen en verouderde toestanden in tijdgesynchroniseerde netwerken te voorkomen. Tot de kernonderdelen behoren de interface FVM, de datacontainer FVContainer, het foutdomein TsyncFvmErrorDomain en de exceptieklasse TsyncFvmException.

De klasse FVContainer kapselt een actualiteitswaarde in door zowel de lengte ervan in bits als de waarde zelf in de vorm van een bytevector te beheren. De interface FVM fungeert als functionele brug voor ara::tsync. FVM fungeert vermoedelijk als abstractie-interface waarmee tijdssynchroniserende instanties van ara::tsync actuele freshness values opvragen of verifiëren. Vraag Q-f92f53d92ec347e5 (open) Het foutdomein TsyncFvmErrorDomain en bijbehorende hulpfuncties waarborgen de gestandaardiseerde foutrapportage [SWS_TS_14212].

Contextdiagram: Componenten van de namespace apext::tsync en hun interactie met ara::tsync. Bronnen: [SWS_TS_14202], [SWS_TS_14212].

Levenscyclus

De levenscyclus van de componenten in de namespace apext::tsync is onderverdeeld in initialisatie-, bedrijfs- en beëindigingsfasen. Voor de initialisatiefase definieert de enumeratie TsyncFvmErrc de foutwaarde kFVInitializeFailed (= 2), die is gespecificeerd als niet-herstelbare fout (unrecoverable error) en aangeeft dat de Freshness Value Manager niet kon worden gebruikt [SWS_TS_14202]. De fout kFVInitializeFailed wijst er vermoedelijk op dat voorafgaand aan het opvragen van Freshness Values een initialisatiefase van de FVM moet worden doorlopen, waarvan het mislukken verder gebruik uitsluit. Vraag Q-d9c097d736bae053 (open)

Tijdens de operationele werking hebben FVContainer-instanties een tijdelijke levensduur: ze worden naar behoefte geïnstantieerd, gevuld met de vector en de bitlengte en overgedragen aan de synchroniserende protocolinstanties. Daarentegen heeft het foutdomein-object TsyncFvmErrorDomain een statische levensduur gedurende de gehele procesperiode. De functie GetTsyncFvmErrorDomain() retourneert een referentie naar het globale instantie-object [SWS_TS_14212]. Zowel GetTsyncFvmErrorDomain() als de factory-functie MakeErrorCode() zijn gedeclareerd als constexpr en noexcept en gespecificeerd als exceptieveilig en thread-veilig [SWS_TS_14212], [SWS_TS_14213]. Dit maakt gelijktijdige foutgeneratie en -opvraging zonder synchronisatielocks mogelijk.

Gebruikspad

Het typische gebruikspad in het samenspel met de tijdsynchronisatie omvat het beschikbaar stellen en evalueren van actualiteitswaarden:

1. Een component uit ara::tsync vraagt ter beveiliging van een tijdsbericht een actuele freshness value aan via de interface FVM.
2. Bij een succesvolle waardebepaling genereert respectievelijk vult FVM een instantie van FVContainer met de bitlengte en de bytevector van de waarde en levert deze terug aan de aanroeper.
3. Als de freshness value tijdens runtime tijdelijk niet beschikbaar kan worden gesteld, meldt FVM de herstelbare fout kFVNotAvailable [SWS_TS_14202]. Hiertoe wordt via MakeErrorCode() een passend ara::core::ErrorCode-object met fabrikantspecifieke aanvullende gegevens gegenereerd [SWS_TS_14213].
4. De aanroepende component evalueert het resultaat en beslist over nieuwe pogingen of vervangende maatregelen.

Sequentiediagram: Opvragen van een actualiteitswaarde en afhandeling van mogelijke fouttoestanden. Bronnen: [SWS_TS_14202], [SWS_TS_14213].

Foutscenario's

De foutafhandeling in apext::tsync is gebaseerd op de architectuur van ara::core::ErrorDomain en ara::core::ErrorCode. De foutcodes van de TsyncFvmErrorDomain zijn opgenomen in de enumeratie TsyncFvmErrc, waarvan het basistype ara::core::ErrorDomain::CodeType is [SWS_TS_14202]:

• kFVNotAvailable (= 1): Herstelbare fout (recoverable error), die signaleert dat de Freshness Value momenteel niet beschikbaar is [SWS_TS_14202]. Aanroepers kunnen het verzoek opnieuw indienen of de huidige verwerkingscyclus overslaan.
• kFVInitializeFailed (= 2): Niet-herstelbare fout (unrecoverable error), die inhoudt dat de Freshness Value Manager niet kon worden geïnitialiseerd of gebruikt [SWS_TS_14202]. Dit leidt tot het afbreken van de afhankelijke tijdsynchronisatieservices.

Het genereren van concrete foutobjecten geschiedt via de hulpfunctie MakeErrorCode(TsyncFvmErrc code, ara::core::ErrorDomain::SupportDataType data), die de enumerator en fabrikantspecifieke aanvullende gegevens in ontvangst neemt [SWS_TS_14213]. De declaraties bevinden zich in de header apext/tsync/fvm_error_domain.h, terwijl forward declarations kunnen worden verkregen via apext/tsync/tsync_fwd.h [SWS_TS_14202]. Voor op excepties gebaseerde foutpaden stelt de namespace de klasse TsyncFvmException beschikbaar. TsyncFvmException zal vermoedelijk worden geworpen wanneer fouten van de TsyncFvmErrorDomain in exceptiecontexten in plaats van via ara::core::ErrorCode worden gemeld. Vraag Q-a779e133b471f03d (open)