struct ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse

De datastructuur ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse dient als retourcontainer voor de resultaatgegevens van een synchroon uitgevoerde SOVD-diagnoseoperatie [SWS_DM_02208]. Na succesvolle voorafgaande controle van een eventuele proximity_challenge roept het Diagnostic Management de applicatiemethode StartExecution aan [SWS_DM_02174]. Uit de in de antwoordstructuur opgenomen gegevens leidt het Diagnostic Management het parameters-attribuut van de SOVD-response-body conform ASAM SOVD af [SWS_DM_02176]. Het mechanisme vereist dwingend dat de diagnoseoperatie is ontworpen voor een synchrone uitvoering.

meer ›

Context

De structuur ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse maakt deel uit van de diagnose-interface (module diag) in het AUTOSAR Adaptive Platform en wordt formeel gedefinieerd in [SWS_DM_02208] en in AUTOSAR_AP_SWS_Diagnostics §8.62.4 “Struct: StartSynchronousExecutionResponse”. Haar primaire taak bestaat uit het transport van de antwoordgegevens bij de synchrone uitvoering van een diagnoseoperatie via het gestandaardiseerde SOVD-protocol (Service-Oriented Vehicle Diagnostics).

In deze context communiceren drie essentiële systeempartners met elkaar: een externe client verzoekt via een Diagnostic Server-instantie om de start van een SOVD-operatie [SWS_DM_01396]. Het Diagnostic Management (DM) verwerkt het verzoek en roept de applicatiespecifieke interface ara::diag::GenericDiagnosticSovdOperation::StartExecution aan [SWS_DM_02174]. Voor zover de uitvoering synchroon plaatsvindt, neemt het DM de instantie van StartSynchronousExecutionResponse in ontvangst en genereert daaruit de SOVD-conforme response body voor de client [SWS_DM_02176], zoals gespecificeerd in AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 “Operations – Start execution of an operation”.

Levenscyclus

Als datastructuur heeft StartSynchronousExecutionResponse het karakter van een zuiver waarde- en overdrachtsobject zonder zelfstandige toestandsmachine. De structuur wordt door de individuele applicatielogica geïnstantieerd tijdens de aanroep van StartExecution. Interpretatie: De aanmaak vindt vermoedelijk typisch plaats als retourwaarde direct in de lokale stackcontext van de synchrone verwerkingsmethode van de applicatie. Vraag (open)

Na voltooiing van de operatielogica wordt het object overgedragen aan de aanroepende context van het DM. Dit extraheert de daarin opgenomen payload (DiagnosticSovdContentData) om de vereiste SOVD-attributen in te vullen [SWS_DM_02176]. Na afronding van de transformatie en verzending van het antwoordbericht eindigt de levensduur van het antwoordobject. De levenscyclus is daarmee strikt gebonden aan de synchrone aanroepduur van de operatie; een persistent beheer of gelijktijdige synchronisatie vervalt.

Gebruikspad

Het reguliere verloop voltrekt zich in de volgende stappen:

1. Een client roept de SOVD-methode voor het starten van een operatie aan, die door de Diagnostic Server-instantie beschikbaar wordt gesteld [SWS_DM_01396].
2. Het DM controleert het verzoek en voert indien nodig een validatie van de nabijheidscontrole (proximity_challenge) uit [SWS_DM_02174].
3. Na succesvolle controle delegeert het DM de aanroep via ara::diag::GenericDiagnosticSovdOperation::StartExecution naar de applicatie [SWS_DM_02174].
4. De applicatie handelt de operatie synchroon af en maakt de instantie StartSynchronousExecutionResponse aan, waarin de resultaatgegevens worden opgeslagen [SWS_DM_02208].
5. Het DM leidt uit het in het antwoord opgenomen DiagnosticSovdContentData het attribuut parameters af en retourneert de volledige SOVD-response-body conform ASAM SOVD [SWS_DM_02176].

Sequentiediagram: Verloop bij de synchrone start van een SOVD-operatie en verdere verwerking van StartSynchronousExecutionResponse. Bronnen: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 “Operations – Start execution of an operation”

Foutscenario's

De uitvoering en evaluatie van het antwoord zijn onderworpen aan gedefinieerde voorwaarden:

• Mislukte randvoorwaarde: Is een validatie van proximity_challenge vereist en faalt deze, dan roept het DM StartExecution in het geheel niet aan [SWS_DM_02174]. In dat geval wordt er geen instantie van StartSynchronousExecutionResponse geïnstantieerd.
• Niet-synchrone uitvoering: Werd de operatie niet als synchrone SOVD-operatie geconfigureerd of gestart, dan is de afhandeling via StartSynchronousExecutionResponse niet van toepassing [SWS_DM_02176].
• Applicatiefout: Interpretatie: Treedt er bij de interne afhandeling in de applicatie een fout op, dan treedt vermoedelijk in plaats van een reguliere StartSynchronousExecutionResponse een fouttraject in werking, waardoor er geen geldige DiagnosticSovdContentData voor het afleiden van het attribuut parameters beschikbaar wordt gesteld. Vraag Q-5faaee7b9b008dde (open)