structure ara::diag::CommunicationControl::ComCtrlRequestParamsType

La structure de données regroupe l'ensemble des paramètres d'entrée d'une requête de service UDS 0x28 pour le contrôle adaptatif de la communication conformément à [SWS_DM_00805]. Lors de la réception d'un tel message de diagnostic, la plateforme désérialise les types de commande et de communication ainsi que l'identifiant de nœud, puis transmet la structure renseignée au gestionnaire de service correspondant. Le logiciel d'application évalue les valeurs contenues afin d'influencer de manière ciblée le comportement d'émission et de réception de segments de réseau définis (AUTOSAR_AP_SWS_Diagnostics §8.7.2 « Struct: ComCtrlRequestParamsType »). En tant que conteneur de données sans état, la structure ne possède aucune synchronisation de concurrence propre, raison pour laquelle les accès doivent demeurer dans le contexte d'exécution du gestionnaire.

plus ›

Contexte

La structure ara::diag::CommunicationControl::ComCtrlRequestParamsType est un type de transfert de données central au sein de l'interface de diagnostic fonctionnelle d'AUTOSAR Adaptive [SWS_DM_00805]. Elle est déclarée dans le fichier d'en-tête ara/diag/communication_control.h et sert de conteneur de paramètres standardisé qui encapsule tous les paramètres d'entrée d'une requête de diagnostic du service UDS 0x28 (CommunicationControl) (AUTOSAR_AP_SWS_Diagnostics §8.7.2 « Struct: ComCtrlRequestParamsType »).

Dans le système global, la structure agit comme intermédiaire entre la gestion du diagnostic AUTOSAR (Diagnostic Management) et le logiciel d'application adaptatif chargé du contrôle de la communication spécifique au véhicule. Les commandes de diagnostic entrantes provenant de testeurs externes sont désérialisées au niveau de la plateforme et transmises à l'application par l'intermédiaire de cette structure. La structure comprend trois variables membres publiques (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 « Public Member Variables ») :

• controlType ([SWS_DM_01562], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.2 « controlType ») : Défini comme std::uint8_t, ce champ transporte la sous-fonction extraite de la requête UDS pour spécifier l'opération de commande à exécuter.
• communicationType ([SWS_DM_01563], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.1 « communicationType ») : Également du type std::uint8_t, ce champ représente le type de communication indiqué dans la requête UDS (comme par ex. la communication normale ou de gestion de réseau).
• nodeIdentificationNumber ([SWS_DM_01564], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.3 « nodeIdentificationNumber ») : Définie comme std::uint16_t, cette variable identifie le nœud cible concret ou le sous-réseau auquel l'instruction de commande est destinée.

Cycle de vie

En tant que structure C++ élémentaire (struct) [SWS_DM_00805], ComCtrlRequestParamsType présente les caractéristiques d'un type de valeur simple (Plain Old Data / POD). Elle ne possède pas de machine à états interne, pas de pointeurs de fonction virtuelle et pas de zones de mémoire allouées dynamiquement (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 « Public Member Variables »).

La création d'une instance est typiquement effectuée de manière volatile par le framework Diagnostic Management : dès qu'un message UDS 0x28 a été reçu et formellement validé, la pile instancie la structure et initialise les variables membres avec les données utiles décodées (interprétation : la création de l'objet incombe entièrement au middleware dans le cadre de la réception de la requête). Question Q-1abe8049ce5759f2 (ouverte) Les relations de propriété sont strictement limitées au contexte de l'appel de méthode. La plateforme transmet habituellement l'instance par valeur ou par référence constante au gestionnaire de service de l'application ; l'application réceptrice ne prend pas la propriété durable de l'instance.

Par conséquent, il n'existe pas de phases de cycle de vie ni de transitions d'état complexes. La destruction de l'instance s'effectue automatiquement lors de la sortie de la portée de l'appel de rappel respectif. En ce qui concerne la concurrence, ComCtrlRequestParamsType n'implémente aucun mécanisme de synchronisation propre. Comme les membres sont en règle générale évalués en lecture seule par le logiciel d'application après leur initialisation par la plateforme, l'accès devrait être thread-safe, pour autant que l'instance soit transmise de manière locale au thread au contexte de traitement (interprétation : aucun verrou externe n'est requis pour l'évaluation). Question Q-d654753d06273bca (ouverte)

Parcours d'utilisation

Le chemin d'utilisation typique dans le cadre du traitement du diagnostic s'effectue selon une séquence d'étapes fixe, du message réseau jusqu'à la réaction de l'application (AUTOSAR_AP_SWS_Diagnostics §8.7.2 « Struct: ComCtrlRequestParamsType ») :

1. Réception du message de diagnostic : Un testeur de diagnostic externe envoie une requête UDS 0x28 au calculateur. L'Adaptive Diagnostic Management reçoit le paquet de données au niveau de la couche transport.
2. Désérialisation et instanciation : La pile de diagnostic analyse la charge utile, crée une instance de ComCtrlRequestParamsType [SWS_DM_00805] et affecte les valeurs transmises aux champs controlType [SWS_DM_01562], communicationType [SWS_DM_01563] ainsi que nodeIdentificationNumber [SWS_DM_01564].
3. Transmission au gestionnaire de service : Le middleware achemine l'instance vers la méthode de rappel implémentée de l'interface CommunicationControl dans l'application adaptative.
4. Évaluation des paramètres et exécution : L'application adaptative lit la structure. À l'aide de nodeIdentificationNumber [SWS_DM_01564], il est déterminé si son propre nœud ou un sous-réseau est adressé. Ensuite, les modes d'émission et de réception correspondants sont activés ou désactivés via controlType [SWS_DM_01562] et communicationType [SWS_DM_01563].
5. Retour d'information : Une fois l'exécution effectuée, l'application confirme l'opération au Diagnostic Management, qui transmet la réponse positive UDS conforme au standard au testeur de diagnostic.

Diagramme de séquence : Déroulement typique du traitement de la requête, du message UDS 0x28 jusqu'à l'évaluation des paramètres dans l'application. Sources : [SWS_DM_00805], AUTOSAR_AP_SWS_Diagnostics §8.7.2 « Struct: ComCtrlRequestParamsType »