structure ara::diag::GenericDataIdentifier::OperationOutput

La structure de données ara::diag::GenericDataIdentifier::OperationOutput encapsule les données utiles pour les messages de réponse positive dans le cadre d'opérations de diagnostic de DID génériques ([SWS_DM_00641]). Lors d'une requête de diagnostic entrante, l'application instancie la structure et remplit le membre responseData avec les données de sortie déterminées avant qu'elle ne soit transmise au Diagnostic Management ([SWS_DM_00631]). La contrainte essentielle est alors que responseData doit contenir exclusivement les données utiles pures et en aucun cas le Data Identifier proprement dit. Après le transfert dans le message de réponse UDS, le cycle de vie de l'objet-valeur éphémère prend fin.

plus ›

Contexte

La structure de données ara::diag::GenericDataIdentifier::OperationOutput fait partie intégrante du module diag dans l'AUTOSAR Adaptive Platform et est mise à disposition via l'en-tête ara/diag/generic_data_identifier.h ([SWS_DM_00641], [SWS_DM_00631]). Au sein de l'architecture de diagnostic, la structure agit comme un conteneur de données spécialisé pour les données de résultat d'un message de réponse de diagnostic positive relatif à un identifiant de données générique (Data Identifier, DID) (AUTOSAR_AP_SWS_Diagnostics §8.19.2 « Struct: OperationOutput »).

Dans l'interaction des composants d'architecture impliqués, OperationOutput constitue le lien entre la fonction de service de diagnostic spécifique à l'application et le Diagnostic Management central. Alors que l'application est responsable de la lecture et de la préparation des données utiles, le système d'exécution de diagnostic prend en charge le traitement du protocole de niveau supérieur vis-à-vis du testeur de diagnostic externe. Pour la transmission des données de réponse, la structure déclare la variable membre publique responseData de type ara::core::Vector<std::uint8_t> ([SWS_DM_00631], AUTOSAR_AP_SWS_Diagnostics §8.19.2.1.1 « responseData »). Ce vecteur d'octets transporte la charge utile du message de réponse positive, l'identifiant de données lui-même ne devant pas être contenu dans le vecteur ([SWS_DM_00631]).

Cycle de vie

En tant que struct légère de transfert de données sans méthodes propres, ara::diag::GenericDataIdentifier::OperationOutput est soumise à un cycle de vie de valeur simple et transitoire ([SWS_DM_00641]). L'instanciation s'effectue à la demande au sein de la routine de traitement spécifique à l'application dès qu'une opération de lecture ou d'interrogation correspondante pour un DID générique a été traitée avec succès. Le vecteur contenu responseData est ici rempli avec les données utiles de diagnostic demandées ([SWS_DM_00631]).

Les relations de possession sont strictement séquentielles : l'application génératrice conserve d'abord l'instance localement et la transmet au framework de diagnostic une fois terminée. La durée de vie de l'instance prend fin dès que le Diagnostic Management a intégré les données utiles dans le message de réponse de diagnostic sortant. Le retour vers le système d'exécution s'effectue vraisemblablement de manière économe en ressources par sémantique de déplacement ou encapsulé dans un conteneur asynchrone tel que ara::core::Future ou ara::core::Result. La structure n'offre pas de synchronisation interne pour l'accès concurrent ; toutefois, comme elle est remplie et transmise de manière transitoire au sein du thread de travail exécutant l'opération, interprétation : une protection inter-threads n'est pas requise en fonctionnement normal. Question Q-6e8dadb21e01d4fb (ouverte)

Parcours d'utilisation

L'ordre d'appel typique lors du traitement d'une interrogation générique de données de diagnostic se décompose en les étapes suivantes :

1. Un testeur de diagnostic externe initie une interrogation (par exemple un service UDS de lecture par identifiant de données), qui est reçue par le Diagnostic Management du véhicule.
2. Le système de diagnostic délègue la requête de lecture à l'instance compétente de ara::diag::GenericDataIdentifier de l'application.
3. L'application détermine les données de capteur ou les paramètres internes requis et instancie ara::diag::GenericDataIdentifier::OperationOutput ([SWS_DM_00641]).
4. L'application affecte au vecteur responseData les octets déterminés ([SWS_DM_00631]). La valeur du DID elle-même ne doit pas être stockée dans responseData (AUTOSAR_AP_SWS_Diagnostics §8.19.2.1.1 « responseData »).
5. L'instance remplie est renvoyée au Diagnostic Management, qui préfixe le DID, assemble le télégramme de réponse positive complet et le transmet au testeur de diagnostic.

Diagramme de séquence : déroulement du traitement d'une interrogation générique de données à l'aide d'OperationOutput. Sources : [SWS_DM_00641], [SWS_DM_00631], AUTOSAR_AP_SWS_Diagnostics §8.19.2 « Struct: OperationOutput ».