structure ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse

La structure de données ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse sert de conteneur de retour pour les données de résultat d'une opération de diagnostic SOVD exécutée de manière synchrone [SWS_DM_02208]. Après la vérification préalable réussie d'une éventuelle proximity_challenge, le Diagnostic Management appelle la méthode d'application StartExecution [SWS_DM_02174]. À partir des données contenues dans la structure de réponse, le Diagnostic Management dérive l'attribut parameters du corps de réponse SOVD selon ASAM SOVD [SWS_DM_02176]. Le mécanisme suppose obligatoirement que l'opération de diagnostic soit conçue pour une exécution synchrone.

plus ›

Contexte

La structure ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse fait partie de l'interface de diagnostic (module diag) dans l'AUTOSAR Adaptive Platform et est formellement définie dans [SWS_DM_02208] ainsi que dans AUTOSAR_AP_SWS_Diagnostics §8.62.4 « Struct: StartSynchronousExecutionResponse ». Sa tâche principale consiste à transporter les données de réponse lors de l'exécution synchrone d'une opération de diagnostic via le protocole standardisé SOVD (Service-Oriented Vehicle Diagnostics).

Dans ce contexte, trois partenaires système essentiels interagissent : un client externe demande le démarrage d'une opération SOVD via une instance de serveur de diagnostic [SWS_DM_01396]. Le Diagnostic Management (DM) traite la requête et appelle l'interface spécifique à l'application ara::diag::GenericDiagnosticSovdOperation::StartExecution [SWS_DM_02174]. Dès lors que l'exécution s'effectue de manière synchrone, le DM réceptionne l'instance de StartSynchronousExecutionResponse et génère à partir de celle-ci le corps de réponse conforme à SOVD pour le client [SWS_DM_02176], tel que spécifié dans AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 « Operations – Start execution of an operation ».

Cycle de vie

En tant que structure de données, StartSynchronousExecutionResponse possède le caractère d'un pur objet de valeur et de transmission sans machine à états autonome. La structure est instanciée par la logique applicative individuelle lors de l'appel de StartExecution. Interprétation : la création devrait généralement s'effectuer en tant que valeur de retour directement dans le contexte de pile local de la méthode de traitement synchrone de l'application. Question (ouverte)

Une fois la logique de l'opération terminée, l'objet est transmis au contexte appelant du DM. Celui-ci extrait les données utiles contenues (DiagnosticSovdContentData) afin de renseigner les attributs SOVD requis [SWS_DM_02176]. Après l'achèvement de la transformation et l'envoi du message de réponse, la durée de vie de l'objet de réponse prend fin. Le cycle de vie est ainsi strictement lié à la durée de l'appel synchrone de l'opération ; une gestion persistante ou une synchronisation concurrente ne s'applique pas.

Parcours d'utilisation

Le déroulement nominal s'effectue selon les étapes suivantes :

1. Un client appelle la méthode SOVD de démarrage d'une opération, mise à disposition par l'instance de serveur de diagnostic [SWS_DM_01396].
2. Le DM vérifie la requête et effectue, si nécessaire, une validation du contrôle de proximité (proximity_challenge) [SWS_DM_02174].
3. Après vérification réussie, le DM délègue l'appel à l'application via ara::diag::GenericDiagnosticSovdOperation::StartExecution [SWS_DM_02174].
4. L'application traite l'opération de manière synchrone et crée l'instance StartSynchronousExecutionResponse, dans laquelle les données de résultat sont stockées [SWS_DM_02208].
5. Le DM dérive l'attribut parameters à partir du DiagnosticSovdContentData contenu dans la réponse et renvoie le corps de réponse SOVD complet conformément à ASAM SOVD [SWS_DM_02176].

Diagramme de séquence : déroulement lors du démarrage synchrone d'une opération SOVD et traitement ultérieur de StartSynchronousExecutionResponse. Sources : [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 »

Scénarios d'erreur

L'exécution et l'évaluation de la réponse sont soumises à des conditions définies :

• Précondition non satisfaite : si une validation de proximity_challenge est requise et échoue, le DM n'appelle même pas StartExecution [SWS_DM_02174]. Dans ce cas, aucune instance de StartSynchronousExecutionResponse n'est instanciée.
• Exécution non synchrone : si l'opération n'a pas été configurée ou démarrée en tant qu'opération SOVD synchrone, le traitement via StartSynchronousExecutionResponse ne s'applique pas [SWS_DM_02176].
• Erreur d'application : Interprétation : si une erreur survient lors du traitement interne dans l'application, une branche d'erreur devrait être empruntée au lieu d'une StartSynchronousExecutionResponse normale, ce qui fait qu'aucune DiagnosticSovdContentData valide n'est fournie pour la dérivation de l'attribut parameters. Question Q-5faaee7b9b008dde (ouverte)