structure ara::diag::DoIPGroupIdentification::GidStatus

La structure ara::diag::DoIPGroupIdentification::GidStatus sert de conteneur de données pour les données de réponse positive lors de l'interrogation de l'identification de groupe DoIP [SWS_DM_00721]. Elle est fournie par une Adaptive Application lorsque le Diagnostic Management demande l'identification de groupe via l'interface GetGidStatus en cas de DoIpInstantiation.gid non configuré [SWS_DM_00813]. La structure transporte les valeurs GID déterminées directement vers le Diagnostic Manager en vue de leur transmission dans le protocole DoIP. Elle est strictement limitée aux réponses positives et ne contient aucun mécanisme pour les scénarios d'erreur.

plus ›

Contexte

La structure de données ara::diag::DoIPGroupIdentification::GidStatus représente les données de réponse positive pour l'identification de groupe dans le sous-système DoIP (Diagnostic over IP) de l'AUTOSAR Adaptive Platform [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 « Struct: GidStatus ». Elle sert de conteneur de résultat standardisé pour les données d'identification de groupe (GID) lorsque des clients de diagnostic externes demandent des informations relatives à l'identification du véhicule ou du groupe via DoIP. Trois partenaires principaux interagissent alors au sein du système : le client DoIP externe, l'AUTOSAR Diagnostic Management (DM) ainsi que l'Adaptive Application spécifique à l'application qui propose l'interface ara::diag::DoIPGroupIdentification. Pour autant que le GID ne soit pas enregistré de manière statique via le paramètre de configuration DoIpInstantiation.gid, le DM est tenu, conformément aux spécifications, de récupérer le GID via l'interface applicative [SWS_DM_00813], AUTOSAR_AP_SWS_Diagnostics §8.34.1 « Providing the GID in DoIP protocol messages using application interface ».

Cycle de vie

En tant que structure de données C++ (struct), GidStatus ne possède pas de cycle de vie propre de processus ou de service, mais fait office de pur objet de transfert de données [SWS_DM_00721]. Une instance de GidStatus est instanciée par l'Adaptive Application compétente et remplie avec les données d'identification actuelles dès que la méthode d'interrogation GetGidStatus est appelée [SWS_DM_00724], AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 « GetGidStatus ». Interprétation : la structure devrait typiquement être créée sur la pile comme objet valeur temporaire et transmise au DM en tant qu'élément de la valeur de retour par copie ou par sémantique de déplacement, ce qui met fin à son cycle de vie après le traitement du message DoIP dans le DM. Question Q-4974fdbc2c6accbb (ouverte) Étant donné que plusieurs requêtes de diagnostic ou traitements parallèles de messages DoIP peuvent survenir, les données conservées au sein de la structure doivent être fournies de manière thread-safe ou être créées de manière isolée pour chaque contexte d'interrogation.

Parcours d'utilisation

L'utilisation typique de GidStatus s'articule en une séquence d'interactions fixe entre le client DoIP, le Diagnostic Management et l'Adaptive Application :

Diagramme de séquence : déroulement de la mise à disposition de GidStatus via GetGidStatus en cas de GID non configuré. Sources : [SWS_DM_00721], [SWS_DM_00724], [SWS_DM_00813].

1. Un client DoIP externe envoie une requête de diagnostic ou d'identification au véhicule via le réseau DoIP.
2. Le Diagnostic Management vérifie la configuration : si DoIpInstantiation.gid n'est pas configuré, le DM demande l'identification de groupe à l'Adaptive Application via GetGidStatus [SWS_DM_00813], [SWS_DM_00724].
3. L'Adaptive Application détermine les caractéristiques d'identification de groupe, crée une instance de GidStatus avec les données de réponse positive et la renvoie au DM [SWS_DM_00721].
4. Le DM extrait les données de GidStatus et envoie le message de protocole DoIP complet au client DoIP externe [SWS_DM_00813].

Scénarios d'erreur

La spécification définit explicitement GidStatus comme des données de réponse positive (« Response data of positive response message ») [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 « Struct: GidStatus ». Interprétation : si l'Adaptive Application n'est pas en mesure de fournir l'identification de groupe, ou en présence d'une erreur interne, aucune instance régulière de GidStatus ne devrait être renvoyée ; la méthode GetGidStatus devrait plutôt signaler une erreur au DM par le biais de mécanismes d'erreur standardisés de la plateforme (tels que des codes d'erreur dans ara::core::Result). Question Q-01181eb14d27eeb2 (ouverte) De plus, le contexte d'interfaces DoIP apparentées telles que ara::diag::DoIPPowerMode [SWS_DM_00814] met en évidence que le DM utilise des valeurs par défaut ou de substitution définies pour les interfaces qui ne sont pas encore proposées [SWS_DM_01525] ; pour l'identification de groupe, l'absence de données de réponse valides requiert une gestion négative correspondante dans le protocole DoIP, car aucune réponse positive valide ne peut être transmise sans GID [SWS_DM_00813].