structure ara::diag::DiagnosticSovdContentData

La structure ara::diag::DiagnosticSovdContentData sert de conteneur de données standardisé pour l'encapsulation de contenus de diagnostic pour les services SOVD dans AUTOSAR Adaptive ([SWS_DM_02385]). Elle conserve les données utiles dans un vecteur public d'éléments de contenu ([SWS_DM_02386]), à partir desquels le Diagnostic Management génère l'attribut SOVD parameters lors des retours d'opérations et d'états. En tant que pur objet de transfert de valeur, la structure n'offre aucune synchronisation de threads interne, raison pour laquelle les modifications concurrentes doivent être sécurisées de manière interne à l'application.

plus ›

Contexte

La structure de données ara::diag::DiagnosticSovdContentData fait partie du module de diagnostic (diag) de l'AUTOSAR Adaptive Platform et est déclarée dans l'en-tête ara/diag/diagnostic_sovd_content_data.h (AUTOSAR_AP_SWS_Diagnostics §8.59 « Header: ara/diag/diagnostic_sovd_content_data.h », [SWS_DM_02385]). Elle fait office de support de données standardisé pour l'encapsulation de contenus de diagnostic lors du diagnostic de véhicules orienté services selon ASAM SOVD.

Au sein de la plateforme, la structure fait l'intermédiaire entre le serveur de diagnostic (Diagnostic Management, DM) et les fournisseurs de services d'une Adaptive Application ([SWS_DM_01396], [SWS_DM_02174]). Si une opération ou une interrogation d'état est déclenchée par un client SOVD externe, le DM délègue l'appel au composant logiciel assurant l'implémentation. Les données de sortie générées sont déposées par l'application dans une instance de DiagnosticSovdContentData ([SWS_DM_02386]). Ensuite, le DM transfère ces contenus dans le corps de réponse SOVD, à savoir dans l'attribut standardisé parameters ([SWS_DM_02176], [SWS_DM_02181]).

Diagramme de contexte : Intégration de DiagnosticSovdContentData dans l'échange de données entre le client SOVD, le Diagnostic Management et le fournisseur de services de diagnostic. Sources : [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02385], [SWS_DM_02386].

Cycle de vie

La définition en tant que struct C++ (AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 « Public Member Variables », [SWS_DM_02385]) attribue à DiagnosticSovdContentData le rôle d'un conteneur de données. La structure possède la variable membre publique elements du type ara::core::Vector<DiagnosticSovdContentElementData> ([SWS_DM_02386]), dans laquelle les différents éléments de contenu sont gérés de manière dynamique.

La création de l'instance s'effectue typiquement localement au sein des méthodes du fournisseur de services dès que des données de diagnostic sont assemblées pour une réponse. Avec des interfaces asynchrones telles que Read (AUTOSAR_AP_SWS_Diagnostics §8.x « Read »), l'objet est encapsulé dans un ara::core::Future<DiagnosticSovdContentData>. Interprétation : ici, la structure devrait passer en possession de l'appelant par transmission de valeur ou par sémantique de déplacement, de sorte que sa durée de vie soit liée à l'objet Future assurant le traitement. Question Q-564c59896de41f85 (ouverte)

En ce qui concerne la concurrence, la structure ne contient aucune primitive de synchronisation interne. Interprétation : comme il s'agit d'un pur objet de transfert de valeur (Value Object), aucune protection interne de thread ne devrait exister ; les accès concurrents à la même instance doivent donc être synchronisés par la logique applicative appelante. Question (ouverte) La destruction de l'instance a lieu automatiquement lorsque la portée du contexte de gestion est quittée.

Parcours d'utilisation

Le chemin d'utilisation primaire de DiagnosticSovdContentData réside dans la fourniture de données utiles lors d'exécutions d'opérations synchrones ainsi que lors d'interrogations d'état dans le cadre SOVD :

1. Un client SOVD externe envoie une requête de démarrage d'une opération conforme à ASAM SOVD au véhicule ([SWS_DM_01396]).
2. Après validation des conditions limites, le Diagnostic Management délègue l'exécution à l'opération compétente via ara::diag::GenericDiagnosticSovdOperation::StartExecution ([SWS_DM_02174]).
3. L'application de service exécute l'opération de diagnostic, instancie DiagnosticSovdContentData et remplit le membre elements avec les données d'éléments générées ([SWS_DM_02386]).
4. L'objet est transmis au Diagnostic Management dans le cadre de la valeur de retour pour les exécutions synchrones ([SWS_DM_02176]).
5. Le Diagnostic Management lit les valeurs de DiagnosticSovdContentData, les transfère dans l'attribut parameters du corps de réponse SOVD et envoie la réponse au client ([SWS_DM_02176]).

Un chemin analogue s'applique à l'interrogation d'état via SovdOperationExecution::GetStatus ([SWS_DM_02180]), où l'attribut parameters est également dérivé des DiagnosticSovdContentData transmis ([SWS_DM_02181]). De même, les fournisseurs de contenu utilisent la même structure comme type de retour via Read (AUTOSAR_AP_SWS_Diagnostics §8.x « Read »).

Diagramme de séquence : Fourniture de données utiles au moyen de DiagnosticSovdContentData lors d'une exécution synchrone d'opération. Sources : [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02386].