classe ara::diag::DoIPEntityIdentification

La classe ara::diag::DoIPEntityIdentification permet aux applications adaptatives de fournir de manière dynamique l'identification d'entité (EID) pour le protocole de diagnostic DoIP [SWS_DM_01361]. Après l'instanciation, l'application active la transmission au moyen de Offer() et répond aux interrogations du Diagnostic Management via la méthode virtuelle pure GetEntityId() de manière asynchrone au moyen d'un Future [SWS_DM_01366], [SWS_DM_01367]. Si l'interface n'est pas encore mise à disposition lors d'une interrogation, le Diagnostic Management envoie à titre de remplacement une valeur 0xFF standardisée [SWS_DM_01528].

plus ›

Contexte

La classe ara::diag::DoIPEntityIdentification sert à fournir de manière dynamique l'identification d'entité (EID) pour le protocole DoIP (Diagnostic over IP) [SWS_DM_01361]. Dans un environnement AUTOSAR Adaptive, elle forme la passerelle fonctionnelle entre une application adaptative individuelle et le Diagnostic Management (DM) AUTOSAR_AP_SWS_Diagnostics, p. 107. Si, dans la configuration, DoIpNetworkConfiguration.eidRetrieval est réglé sur le mode DoIpEidRetrievalEnum.eidUseApi, le Diagnostic Management demande l'EID via cette interface de programmation [SWS_DM_01361]. La liaison à l'architecture logicielle s'effectue via un ara::core::InstanceSpecifier, qui fait référence à un PortPrototype d'un DiagnosticDoIPEntityIdentificationInterface [SWS_DM_01364].

Cycle de vie

La création s'effectue via le constructeur explicite, auquel est transmis, outre le InstanceSpecifier, le paramètre ConcurrencyType (kConcurrent ou kNotConcurrent) [SWS_DM_01364]. Ce dernier détermine si les interrogations ultérieures de l'interface doivent être traitées de manière thread-safe [SWS_DM_01364], [SWS_DM_01366]. Après la construction, l'objet demeure initialement dans l'état inactif. L'appel de Offer() débloque l'interface pour le Diagnostic Management et active le transfert des requêtes vers le gestionnaire [SWS_DM_01367]. Avant la destruction de l'objet ou à l'arrêt du fonctionnement, StopOffer() interrompt de nouveau le transfert [SWS_DM_01368]. La destruction s'effectue enfin via le destructeur virtuel [SWS_DM_01365]. Ni Offer(), StopOffer() ni le destructeur ne sont thread-safe et nécessitent donc une synchronisation coordonnée dans le code d'application [SWS_DM_01365], [SWS_DM_01367], [SWS_DM_01368].

Diagramme d'états : cycle de vie et phases d'enregistrement de l'identification d'entité DoIP. Sources : [SWS_DM_01364], [SWS_DM_01365], [SWS_DM_01367], [SWS_DM_01368].

Parcours d'utilisation

Dans le scénario d'utilisation type, l'application adaptative dérive sa propre classe d'implémentation de ara::diag::DoIPEntityIdentification et surcharge la méthode purement virtuelle GetEntityId() [SWS_DM_01366]. Après instanciation avec un identifiant valide, l'application enregistre le gestionnaire à l'aide de Offer() [SWS_DM_01367]. Dès que le Diagnostic Management a besoin de l'ID d'entité pour composer des messages DoIP, il appelle GetEntityId() [SWS_DM_01361], [SWS_DM_01366]. La méthode renvoie un ara::core::Future<EntityId>, ce qui permet de déterminer et de mettre à disposition les données d'identification de manière asynchrone [SWS_DM_01366]. Lorsque le fonctionnement prend fin, l'application retire l'offre via StopOffer() [SWS_DM_01368].

Diagramme de séquence : ordre d'appel type pour l'enregistrement et l'interrogation de l'EID par le Diagnostic Management. Sources : [SWS_DM_01361], [SWS_DM_01364], [SWS_DM_01366], [SWS_DM_01367], [SWS_DM_01368].

Scénarios d'erreur

Des configurations de modèle erronées lors de la construction entraînent des violations d'exécution spécifiques : si le InstanceSpecifier ne peut pas être résolu dans le modèle ou ne fait pas référence à un PortPrototype, il en résulte une InstanceSpecifierMappingIntegrityViolation [SWS_DM_01364]. Si le mappage de port ne fait pas référence à un DiagnosticDoIPEntityIdentificationInterface, il s'agit d'une PortInterfaceMappingViolation, tandis qu'une correspondance de processus manquante déclenche une ProcessMappingViolation [SWS_DM_01364]. Si le même identifiant est utilisé plusieurs fois au sein du processus, une InstanceSpecifierAlreadyInUseViolation s'ensuit [SWS_DM_01364].

Si Offer() est appelée alors que le service est déjà activement proposé, la méthode renvoie un ara::core::Result avec le code d'erreur DiagOfferErrc::kAlreadyOffered [SWS_DM_01367]. Si le Diagnostic Management ne parvient pas à interroger l'EID – par exemple parce que l'interface n'était pas encore proposée au moment de la demande –, un repli de protocole défini s'applique : le Diagnostic Management envoie en remplacement une valeur d'EID de 6 octets de 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF dans les messages DoIP [SWS_DM_01528].