struct ara::diag::DiagnosticSovdContentData

De structuur ara::diag::DiagnosticSovdContentData dient als gestandaardiseerde datacontainer voor het inkapselen van diagnose-inhoud voor SOVD-diensten in AUTOSAR Adaptive ([SWS_DM_02385]). Zij bewaart de payload in een publieke vector van inhoudelementen ([SWS_DM_02386]), waaruit Diagnostic Management bij bewerkings- en statusterugmeldingen het SOVD-attribuut parameters genereert. Als zuiver waardeoverdrachtsobject biedt de structuur geen interne threadsynchronisatie, waardoor gelijktijdige modificaties applicatie-intern moeten worden beveiligd.

meer ›

Context

De datastructuur ara::diag::DiagnosticSovdContentData maakt deel uit van de diagnosemodule (diag) van het AUTOSAR Adaptive Platform en is gedeclareerd in de header ara/diag/diagnostic_sovd_content_data.h (AUTOSAR_AP_SWS_Diagnostics §8.59 “Header: ara/diag/diagnostic_sovd_content_data.h”, [SWS_DM_02385]). Zij fungeert als gestandaardiseerde gegevensdrager voor het inkapselen van diagnose-inhoud bij servicegerichte voertuigdiagnose conform ASAM SOVD.

Binnen het platform bemiddelt de structuur tussen de diagnoseserver (Diagnostic Management, DM) en de dienstaanbieders van een Adaptive Application ([SWS_DM_01396], [SWS_DM_02174]). Wordt door een externe SOVD-client een bewerking of een statusopvraag geïnitieerd, dan delegeert het DM de aanroep naar de implementerende softwarecomponent. De gegenereerde uitvoergegevens worden door de applicatie opgeslagen in een instantie van DiagnosticSovdContentData ([SWS_DM_02386]). Vervolgens zet het DM deze inhoud over naar de SOVD-antwoordbody, met name in het gestandaardiseerde attribuut parameters ([SWS_DM_02176], [SWS_DM_02181]).

Contextdiagram: Inbedding van DiagnosticSovdContentData in de gegevensuitwisseling tussen SOVD-client, Diagnostic Management en diagnosedienstaanbieder. Bronnen: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02385], [SWS_DM_02386].

Levenscyclus

De definitie als C++-struct (AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 “Public Member Variables”, [SWS_DM_02385]) kent aan DiagnosticSovdContentData de rol van datacontainer toe. De structuur bezit de openbare lidvariabele elements van het type ara::core::Vector<DiagnosticSovdContentElementData> ([SWS_DM_02386]), waarin de afzonderlijke inhoudelementen dynamisch worden beheerd.

Het aanmaken van de instantie gebeurt typisch lokaal binnen de methoden van de dienstaanbieder zodra diagnosedata worden samengesteld voor een terugmelding. Bij asynchrone interfaces zoals Read (AUTOSAR_AP_SWS_Diagnostics §8.x “Read”) wordt het object ingekapseld in een ara::core::Future<DiagnosticSovdContentData>. Interpretatie: hierbij gaat de structuur vermoedelijk via waardeoverdracht of move-semantiek over in het bezit van de aanroeper, zodat de levensduur ervan gebonden is aan het verwerkende Future-object. Vraag Q-564c59896de41f85 (open)

Wat betreft gelijktijdigheid bevat de structuur geen interne synchronisatieprimitieven. Interpretatie: aangezien het om een zuiver waardeoverdrachtsobject (Value Object) gaat, bestaat er vermoedelijk geen interne thread-beveiliging; gelijktijdige toegangen tot dezelfde instantie moeten derhalve door de aanroepende applicatielogica worden gesynchroniseerd. Vraag (open) De vernietiging van de instantie vindt automatisch plaats bij het verlaten van de scope van de beherende context.

Gebruikspad

Het primaire gebruikspad van DiagnosticSovdContentData ligt in het beschikbaar stellen van gebruikersgegevens bij synchrone bewerkingsuitvoeringen alsmede bij statusopvragingen binnen het SOVD-framework:

1. Een externe SOVD-client verzendt een verzoek tot start van een bewerking conform ASAM SOVD naar het voertuig ([SWS_DM_01396]).
2. Na validatie van de randvoorwaarden delegeert Diagnostic Management de uitvoering aan de bevoegde bewerking via ara::diag::GenericDiagnosticSovdOperation::StartExecution ([SWS_DM_02174]).
3. De servicetoepassing voert de diagnosebewerking uit, instantieert DiagnosticSovdContentData en vult het lid elements met de gegenereerde elementgegevens ([SWS_DM_02386]).
4. Het object wordt in het kader van de retourwaarde voor synchrone uitvoeringen overgedragen aan Diagnostic Management ([SWS_DM_02176]).
5. Diagnostic Management leest de waarden uit DiagnosticSovdContentData uit, draagt deze over naar het attribuut parameters van de SOVD-antwoordbody en verzendt het antwoord naar de client ([SWS_DM_02176]).

Een analoog pad geldt voor de statusopvraag via SovdOperationExecution::GetStatus ([SWS_DM_02180]), waarbij het attribuut parameters eveneens wordt afgeleid van de doorgegeven DiagnosticSovdContentData ([SWS_DM_02181]). Evenzo gebruiken inhoudsproviders dezelfde structuur als retourtype via Read (AUTOSAR_AP_SWS_Diagnostics §8.x “Read”).

Sequentiediagram: beschikbaarstelling van gebruikersdata via DiagnosticSovdContentData bij een synchrone bewerkingsuitvoering. Bronnen: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02386].