classe <RoutineInterface-Namespace>::<RoutineInterface>

La fonction constructeur [SWS_DM_00589] sert à l'instanciation d'une interface de routine (DiagnosticRoutine) via un identifiant d'instance. La déclaration est spécifiée comme noexcept et considérée comme sûre face aux exceptions (exception safe) ainsi que sûre pour les threads (thread-safe) SWS Diagnostics §8.30.2.2.1.8 « {<routine-interface-name-1>} ».

Paramètres et appel

• instanceSpec (ara::core::InstanceSpecifier) : identifiant de l'instance de service spécifique qui est liée à un port de modèle approprié.
• concurrencyType (ara::diag::ConcurrencyType) : détermine si l'interface est exécutée de façon concurrente ou sûre pour les threads (kConcurrent) ou si elle n'est pas sûre pour les threads (kNotConcurrent).

Vérifications à l'exécution et de modèle

Pendant la construction, le framework vérifie la configuration du modèle et du processus. En cas d'associations erronées ou d'utilisations multiples, des violations spécifiques (Violations) sont déclenchées [SWS_DM_00589] :

• InstanceSpecifierMappingIntegrityViolation : le InstanceSpecifier ne peut pas être résolu dans le contexte de l'exécutable ou ne renvoie pas à un PortPrototype.
• PortInterfaceMappingViolation : un PortPrototype typé par DiagnosticRoutineInterface n'est pas référencé par un DiagnosticServiceGenericMapping.
• ProcessMappingViolation : aucun processus modélisé correspondant n'existe à l'exécution pour la référence d'instance existante.
• InstanceSpecifierAlreadyInUseViolation : le InstanceSpecifier spécifié est déjà utilisé par une instance existante au sein du processus courant.

Utilisation et sémantique

La méthode Offer active le Diagnostic Management (DM) pour router les requêtes de diagnostic entrantes vers le gestionnaire de routine associé [SWS_DM_00594]. L'appel s'effectue de manière synchrone et sans paramètre via l'interface typée de la routine et ne lève aucune exception (noexcept) [SWS_DM_00594]. ara::core::Result<void> sert de type de retour, signalant ainsi soit la complétion réussie, soit renvoyant un code d'erreur en cas d'erreur [SWS_DM_00594].

Gestion des erreurs

Si Offer est appelée pour une instance de routine qui a déjà été activement mise à disposition du DM, l'enregistrement échoue. Dans ce cas, la méthode renvoie le code d'erreur DiagOfferErrc::kAlreadyOffered avec une sémantique de rollback [SWS_DM_00594] (défini avec la valeur 101 dans le contexte général du domaine d'erreur de diagnostic [SWS_DM_00514]).

Concurrence et restrictions

Bien que la fonction soit spécifiée comme sûre vis-à-vis des exceptions (exception safe), elle est expressément déclarée comme non thread-safe (not thread-safe) [SWS_DM_00594]. Plusieurs appels sur la même instance ne doivent pas être exécutés simultanément de manière non protégée. Comme la spécification ne prévoit pas d'utilisation concurrente, l'enregistrement devrait typiquement s'effectuer de manière synchrone pendant la phase d'initialisation de l'application de traitement. Question Q-6a0f15497f03ac09 (ouverte)

Interaction au sein du module de diagnostic

Le modèle de mise à disposition via Offer est unifié dans le Diagnostic Management d'AUTOSAR à travers différents types d'interfaces, par exemple pour les routines génériques [SWS_DM_00557], les éléments de données [SWS_DM_00597], les DataIdentifier [SWS_DM_00599] ainsi que les services UDS génériques [SWS_DM_00619]. Bien que la nomenclature s'inspire de ara::com, il s'agit d'une fonctionnalité spécifique au diagnostic qui ne doit pas être confondue avec la médiation de service générale AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ».

Utilisation

La méthode d'interface RequestResult sert à fournir la fonctionnalité RoutineControl pour interroger des résultats de routine au sein d'une interface de diagnostic typée [SWS_DM_00593]. Lors de l'appel destiné à traiter la sous-fonction UDS requestRoutineResults (service 0x31, cf. [SWS_DM_00575]), les arguments d'entrée ordonnés du ArgumentDataPrototype associé, des métadonnées via metaInfo ainsi qu'un cancellationHandler sont transmis AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 « RequestResult ».

Via l'objet cancellationHandler, l'implémentation peut vérifier activement via IsCanceled si la conversation de diagnostic en cours a été annulée, ou enregistrer via SetNotifier une fonction de notification qui sera appelée en cas d'annulation [SWS_DM_00593]. L'exécution s'effectue de manière asynchrone et renvoie un ara::core::Future qui, en cas de succès, contient l'objet résultat conformément à [SWS_DM_00583] [SWS_DM_00593].

Gestion des erreurs

Si une erreur survient lors du traitement, le ara::core::Future est résolu avec une erreur correspondante. Cela comprend des codes de réponse négatifs (NRC selon l'ISO 14229-1) via ara::diag::DiagUdsNrcErrc ou des erreurs spécifiques à l'application via Ap ApplicationError [SWS_DM_00593].

Concurrence et restrictions

La méthode est déclarée comme noexcept et considérée comme sûre face aux exceptions (exception safe), mais elle n'est expressément pas sûre du point de vue des threads (not thread-safe) AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 « RequestResult ». En raison de ce classement, le composant appelant devrait être responsable d'une synchronisation appropriée lors d'appels parallèles sur la même instance. Question Q-aa5788303ddff2bc (ouverte)

La fonction purement virtuelle Start dans la portée de classe <RoutineInterface-Namespace>::<RoutineInterface> sert à fournir une opération RoutineControl dans le rôle Start pour des routines de diagnostic spécifiques au modèle ([SWS_DM_00591]). Elle est déclarée via l'en-tête <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h ([SWS_DM_00591]). L'appel transmet les arguments d'entrée ordonnés de la routine respective, des informations de contexte de diagnostic via metaInfo ainsi que l'objet cancellationHandler pour le contrôle des interruptions de conversation ([SWS_DM_00591]).

Via le paramètre cancellationHandler, l'implémentation peut vérifier avec cancellationHandler.IsCanceled si la conversation associée a été interrompue, TRUE étant renvoyé en cas d'interruption et FALSE dans le cas contraire ([SWS_DM_00591]). En complément, cancellationHandler.SetNotifier permet d'enregistrer une fonction de notification qui est déclenchée en cas d'interruption ([SWS_DM_00591]). Le retour asynchrone s'effectue via un ara::core::Future qui, en cas de succès, fournit l'objet résultat généré StartOutput conformément à [SWS_DM_00581] ([SWS_DM_00591]).

En cas d'erreur, le ara::core::Future doit être renseigné avec un Negative Response Code (NRC) approprié issu de ara::diag::DiagUdsNrcErrc conformément à l'ISO 14229-1 ou avec un ApplicationError spécifique à l'application ([SWS_DM_00591]). La méthode est spécifiée comme noexcept et exception safe, mais est considérée comme not thread-safe ([SWS_DM_00591]). Interprétation : de la classification en tant que not thread-safe, il devrait résulter que les appels concurrents de la même instance doivent être synchronisés de manière externe. Question Q-124d8076818ac2e1 (ouverte) Alors que cette interface dessert des routines générées de manière spécifique au modèle, GenericRoutine::Start offre le pendant fonctionnel pour les routines de diagnostic traitées de manière générique ([SWS_DM_00554]).

La méthode Stop sert à fournir la fonctionnalité RoutineControl pour arrêter une routine de diagnostic au sein d'une interface de routines typée ([SWS_DM_00592]). Un appel devrait généralement être déclenché par le démon de Diagnostic Management lors de la réception d'une requête de diagnostic UDS correspondante (sous-fonction 0x02), de manière analogue à son homologue générique [SWS_DM_00555]. Question Q-cd626f527c6dfe92 (ouverte)

L'appel s'effectue de manière asynchrone et renvoie un ara::core::Future ([SWS_DM_00592]) :

• Paramètres : outre les arguments d'entrée {<routine-interface-stop-in-arg-symbol-0toN>} spécifiques au modèle, des méta-informations sur la requête (metaInfo) ainsi qu'un cancellationHandler sont transmis ([SWS_DM_00592]). Via le cancellationHandler, l'implémentation peut vérifier activement une annulation au moyen de IsCanceled ou enregistrer une notification avec SetNotifier si la conversation de diagnostic est annulée.
• Valeur de retour : en cas d'arrêt réussi, le Future met à disposition un objet StopOutput typé ([SWS_DM_00582]).

Traitement des erreurs : si l'arrêt échoue, le Future renvoyé contient un Negative Response Code (NRC) applicable selon l'ISO 14229-1 via ara::diag::DiagUdsNrcErrc ou un Ap ApplicationError spécifique au modèle ([SWS_DM_00592]).

Concurrence et restrictions : la fonction est spécifiée comme exception safe, mais explicitement comme not thread-safe ([SWS_DM_00592]). Les appels multiples ou concurrents sur la même instance d'interface doivent être coordonnés par l'appelant, et la routine doit libérer les ressources éventuelles ou réagir aux demandes d'annulation du gestionnaire.

La méthode StopOffer dans la portée de <RoutineInterface> sert à désactiver le transfert des messages de requête de diagnostic depuis le Diagnostic Management (DM) vers l'implémentation de la routine [SWS_DM_00595]. La fonction ne comporte aucun paramètre de transmission et ne renvoie aucune valeur [SWS_DM_00595].

• Utilisation et contexte d'appel : L'appel s'effectue de manière synchrone pour annuler l'enregistrement de l'interface de routine auprès du DM. La déclaration a lieu dans le fichier d'en-tête <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h [SWS_DM_00595]. Bien que la dénomination soit inspirée des méthodes de service de ara::com, il s'agit d'une API du DM spécifique au diagnostic, qui ne doit pas être confondue avec la gestion de la communication (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors »).
• Gestion des erreurs : L'opération est déclarée comme noexcept et classée comme sûre face aux exceptions (exception safe) [SWS_DM_00595]. Aucun code d'erreur spécifique ni message d'erreur n'est défini pour cette méthode.
• Concurrence et restrictions : La fonction est spécifiée comme non thread-safe (not thread-safe) [SWS_DM_00595] ; les appels sur la même instance nécessitent donc une synchronisation externe. Interprétation : les appelants devraient devoir terminer de façon ordonnée les exécutions de routine en cours avant l'appel, car le standard décrit uniquement la désactivation du mécanisme de réacheminement. Question Q-b0f524c0f2d7af52 (ouverte)
• Interaction : Le modèle de mise à disposition et de désinscription correspond à l'approche standardisée dans le Diagnostic Management, telle qu'elle est définie de manière analogue pour les routines génériques [SWS_DM_00558], les services UDS génériques [SWS_DM_00620] et les identifiants de données (Data Identifier) [SWS_DM_00600].