classe ara::diag::MultipleMonitor

Utilisation

La méthode ara::diag::MultipleMonitor::ConfigureMonitor initialise un moniteur de diagnostic pour l'anti-rebond interne au moniteur [SWS_DM_01696]. Le moniteur à configurer est adressé via le paramètre monitorHandle, tandis que initMonitor enregistre un callback de notification pour les réinitialisations et getFaultDetectionCounter une fonction d'interrogation de la valeur actuelle du compteur de défauts (FDC) [SWS_DM_01696]. L'exécution s'effectue de manière synchrone et renvoie un ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 « ConfigureMonitor ».

Gestion des erreurs et concurrence

En cas d'erreur, le résultat d'erreur DiagErrc::kInvalidArgument est renvoyé [SWS_DM_01696]. Cela devrait se produire en particulier lorsque des pointeurs de fonction non valides sont transmis ou que des états incompatibles sont présents lors d'un anti-rebond interne (interprétation). Question Q-3de0f2b0cc427ef3 (ouverte) L'opération est spécifiée comme noexcept et sûre vis-à-vis des exceptions (exception safe), mais explicitement désignée comme non sécurisée pour les threads (not thread-safe) [SWS_DM_01696]. Les appels sur la même instance de moniteur doivent donc être synchronisés côté application.

Ordre et interaction

Chaque surcharge de ConfigureMonitor ne doit être appelée qu'exactement une fois pour un moniteur donné ; le moniteur n'est opérationnel qu'après cette étape d'initialisation [SWS_DM_01696]. En cas d'anti-rebond interne au moniteur, l'application de surveillance de diagnostic traite la logique d'anti-rebond de manière autonome et transmet uniquement les résultats finaux au Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 « Monitor-internal debouncing ». Pour d'autres mécanismes d'anti-rebond, des surcharges alternatives sont disponibles pour les surveillances basées sur le temps [SWS_DM_01697], basées sur un compteur [SWS_DM_01702] ou sans anti-rebond [SWS_DM_01973].

Utilisation

La fonction membre synchrone ara::diag::MultipleMonitor::ConfigureMonitor issue du fichier d'en-tête ara/diag/multiple_monitor.h configure un moniteur de diagnostic avec anti-rebond temporel ([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 « ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased) »). Lors de l'appel, le descripteur monitorHandle pour identifier le moniteur, la fonction de callback initMonitor de type InitMonitorNotifier ainsi que les paramètres d'anti-rebond defaultValues de type TimeBased sont transmis ([SWS_DM_01697]). La valeur de retour est ara::core::Result<void>, et la signature de la fonction est déclarée comme noexcept ([SWS_DM_01697]).

Conditions d'appel et concurrence

Un moniteur ne peut être utilisé qu'après l'achèvement de cette étape d'initialisation ([SWS_DM_01697]). Chaque variante surchargée de ConfigureMonitor ne doit être appelée qu'exactement une fois par instance de moniteur ([SWS_DM_01697]). L'interface est certes sûre vis-à-vis des exceptions (exception safe), mais non sécurisée pour les threads (not thread-safe), de sorte que les appels parallèles sur la même instance doivent être synchronisés côté utilisateur ([SWS_DM_01697]).

Gestion des erreurs

Si la configuration échoue, l'appel renvoie un objet d'erreur au sein de ara::core::Result, en particulier le code d'erreur DiagErrc::kInvalidArgument ([SWS_DM_01697]).

Interaction

La méthode complète les fonctions d'initialisation alternatives pour l'anti-rebond basé sur un compteur ([SWS_DM_01702]), l'anti-rebond interne au moniteur ([SWS_DM_01696]) ainsi que les moniteurs sans anti-rebond ([SWS_DM_01973]). Pour les événements avec anti-rebond temporel, le Diagnostic Manager prend en outre en charge le gel ciblé du temporisateur d'anti-rebond ([SWS_DM_00880]) et sa reprise ultérieure à partir de l'état gelé ([SWS_DM_00038]).

La méthode synchrone ConfigureMonitor de la classe ara::diag::MultipleMonitor sert à initialiser un moniteur de diagnostic avec anti-rebond basé sur un compteur ([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 « ConfigureMonitor »). La déclaration est fournie via le fichier d'en-tête ara/diag/multiple_monitor.h ([SWS_DM_01702]).

Utilisation et paramètres

La fonction prend en compte les paramètres de transmission suivants ([SWS_DM_01702]) :

• monitorHandle (MonitorHandleType) : identifie le moniteur de diagnostic à configurer.
• initMonitor (InitMonitorNotifier) : enregistre une fonction de callback de notification pour l'initialisation du moniteur.
• defaultValues (CounterBased) : transmet des valeurs de configuration par défaut pour l'anti-rebond basé sur un compteur.

Comme valeur de retour, l'opération fournit un ara::core::Result<void>, qui renseigne sur le succès ou l'erreur ([SWS_DM_01702]).

Gestion des erreurs

Si la configuration échoue, une erreur est signalée dans la valeur de retour. En cas d'arguments non valides, le code d'erreur DiagErrc::kInvalidArgument est renvoyé ([SWS_DM_01702]). La fonction est déclarée comme noexcept et garantit la sécurité des exceptions (exception safe) ([SWS_DM_01702]).

Concurrence et restrictions

Chaque surcharge de ConfigureMonitor ne doit impérativement être appelée qu'exactement une fois pour un moniteur donné ; le moniteur n'est utilisable qu'après cette étape d'initialisation ([SWS_DM_01702]). L'opération étant classée comme non sécurisée pour les threads (not thread-safe) ([SWS_DM_01702]), une synchronisation externe devrait être requise lorsque des appels ont lieu à travers les limites de threads (interprétation). Question Q-fcb809ccb021dd6d (ouverte)

Interaction

La méthode fait partie de l'interface de configuration dans MultipleMonitor. Elle complète des surcharges associées pour l'anti-rebond temporel avec TimeBased ([SWS_DM_01697]), pour l'anti-rebond interne au moniteur avec fonction de lecture ([SWS_DM_01696]) ainsi que pour des moniteurs entièrement dépourvus de mécanisme d'anti-rebond ([SWS_DM_01973]).

La méthode synchrone ConfigureMonitor sert à initialiser un moniteur de diagnostic sans anti-rebond au sein de ara::diag::MultipleMonitor ([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 « ConfigureMonitor(MonitorHandleType, InitMonitorNotifier) »). Elle prend comme paramètres d'entrée le descripteur du moniteur (monitorHandle) ainsi qu'une fonction de callback (initMonitor) pour enregistrer une notification de InitMonitorNotifier ([SWS_DM_01973]). Ce n'est qu'après cette étape d'initialisation obligatoire que le moniteur concerné peut être activement utilisé ([SWS_DM_01973]).

Concernant le contexte d'appel et la concurrence, les contraintes suivantes s'appliquent :

• Chaque surcharge de ConfigureMonitor ne doit être appelée qu'exactement une fois pour chaque moniteur individuel ([SWS_DM_01973]).
• La méthode est spécifiée comme exception safe, mais classée comme not thread-safe ([SWS_DM_01973]). Un accès concurrent au même moniteur devrait donc nécessiter une synchronisation externe par l'application. Question Q-2272f26f380a5a11 (ouverte)

La fonction renvoie un ara::core::Result<void> comme résultat ([SWS_DM_01973]). Si la configuration échoue, une erreur est renvoyée, par exemple DiagErrc::kInvalidArgument ([SWS_DM_01973]). Si une méthode d'anti-rebond est requise pour le moniteur de diagnostic, les variantes surchargées pour le debouncing interne au moniteur ([SWS_DM_01696]), le debouncing temporel ([SWS_DM_01697]) ou le debouncing basé sur un compteur ([SWS_DM_01702]) sont disponibles à la place.

La fonction Offer active le transfert des requêtes de diagnostic entrantes par le démon Diagnostic Management (DM) vers le gestionnaire respectif [SWS_DM_01699]. L'appel synchrone est sans paramètre et spécifié comme noexcept avec sécurité vis-à-vis des exceptions (exception safe) [SWS_DM_01699].

En cas de succès, la fonction renvoie un ara::core::Result<void> vide [SWS_DM_01699]. Si l'enregistrement pour le gestionnaire a déjà été exécuté avec succès auparavant, l'appel échoue et renvoie le code d'erreur DiagOfferErrc::kAlreadyOffered avec une sémantique de rollback [SWS_DM_01699] ; cet état d'erreur est ancré dans le domaine d'erreur de diagnostic [SWS_DM_00514].

En ce qui concerne la concurrence, la méthode est déclarée comme not thread-safe [SWS_DM_01699]. Interprétation : les appels sur la même instance de gestionnaire ne doivent probablement pas être effectués sans protection à partir de threads différents, afin d'éviter des incohérences dans l'état d'enregistrement. Question Q-95f2e0895004c73b (ouverte)

Le modèle de la méthode Offer correspond au mécanisme de mise à disposition uniforme pour les gestionnaires de diagnostic dans AUTOSAR Adaptive, tel qu'il est par exemple utilisé de manière analogue pour les routines génériques [SWS_DM_00557] ou les services UDS [SWS_DM_00619]. Bien que la désignation soit inspirée de la mise à disposition de services dans ara::com, il s'agit d'une implémentation autonome spécifique au diagnostic AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ».

La fonction [SWS_DM_01698] sert dans ara::diag::MultipleMonitor à signaler des informations d'état et des commandes de filtrage antirebond pour un moniteur de diagnostic spécifique au Diagnostic Manager (DM). Le paramètre monitorHandle permet d'adresser le moniteur cible, tandis que action transmet le résultat de test (non) qualifié ou des commandes de filtrage antirebond et de pré-mémorisation.

En ce qui concerne le comportement face aux erreurs, les appels avec un monitorHandle invalide sont ignorés par le DM [SWS_DM_01698]. Si une action non prise en charge par la méthode de filtrage antirebond configurée est transmise, le DM déclenche une violation [SWS_DM_01988]. De plus, des conditions d'activation (enable conditions) non satisfaites peuvent conduire au rejet de messages (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 « EnableConditions »), ce qui correspond à des codes d'erreur internes [SWS_DM_00514].

Concernant la concurrence et l'exécution :

• La méthode est déclarée comme noexcept et donc sûre vis-à-vis des exceptions [SWS_DM_01698].
• La sécurité des threads est conditionnelle : le fait que les appels doivent être thread-safe est déterminé par le ConcurrencyType transmis lors du constructeur [SWS_DM_01698].
• En interaction avec le filtrage antirebond basé sur compteur, la notification kPrefailed entraîne par exemple l'incrémentation du compteur interne [SWS_DM_00875]. Interprétation : les mécanismes de filtrage antirebond et les conditions d'activation définis pour les moniteurs individuels s'appliquent vraisemblablement de façon identique pour l'instance multiple pilotée par des handles. Question Q-ff29529143d35ca2 (ouverte)

La méthode StopOffer de la classe ara::diag::MultipleMonitor sert à désactiver le transfert des messages de requête depuis le Diagnostic Management (DM) vers le gestionnaire [SWS_DM_01700]. Elle constitue le pendant fonctionnel de la proposition de l'interface et permet à l'application d'interrompre de manière ciblée le traitement des requêtes de diagnostic entrantes.

L'utilisation est soumise aux caractéristiques et conditions aux limites suivantes :

• Signature et contexte d'appel : la fonction est déclarée via l'en-tête ara/diag/multiple_monitor.h et possède la signature void StopOffer() noexcept; [SWS_DM_01700]. Elle ne prend aucun paramètre et ne fournit aucune valeur de retour. L'appel est exécuté de manière synchrone.
• Gestion des erreurs : la méthode est spécifiée comme noexcept et sûre face aux exceptions (exception safe) [SWS_DM_01700]. Elle ne lève aucune exception et ne prévoit aucun code d'erreur ni message d'erreur spécifique.
• Concurrence : l'élément est explicitement classé comme non thread-safe (not thread-safe) [SWS_DM_01700]. Un appel concurrent sur la même instance devrait devoir être synchronisé de manière externe par l'application. Question Q-b73ead392f8b95b2 (ouverte)

La sémantique de StopOffer suit le patron de conception uniforme pour les gestionnaires de diagnostic dans AUTOSAR Adaptive, dans lequel les services sont commandés via Offer et StopOffer AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ». Le même principe de désactivation du transfert des requêtes se retrouve sur des ports apparentés tels que ara::diag::Monitor::StopOffer [SWS_DM_01089] ainsi que sur les routines génériques [SWS_DM_00558] et les services UDS [SWS_DM_00620].