Watchdog Manager (WdgM)

Utilisation

La fonction WdgM_Init initialise le Watchdog Manager de manière synchrone et est non réentrante [SWS_WdgM_00151]. Le seul paramètre transmis est ConfigPtr, qui pointe vers les données de configuration post-build (WdgM_ConfigType) [SWS_WdgM_00151]. La fonction ne possède formellement aucune valeur de retour (void) [SWS_WdgM_00151].

Gestion des erreurs et conditions limites

Avant l'initialisation, le Watchdog Manager doit se trouver dans l'état WDGM_GLOBAL_STATUS_DEACTIVATED : si le paramètre de configuration de développement WdgMDevErrorDetect est désactivé et que le module n'est pas dans cet état, WdgM_Init retourne sans effet [SWS_WdgM_00390].

Si le commutateur de configuration WdgMOffModeEnabled n'est pas activé et que le mode initial spécifié via ConfigPtr désactiverait le watchdog (WDGIF_OFF_MODE), la fonction s'interrompt sans autre action et signale l'erreur d'exécution WDGM_E_DISABLE_NOT_ALLOWED au Default Error Tracer (DET) [SWS_WdgM_00030]. Le retour avec E_NOT_OK exigé dans la spécification devrait être interprété comme une interruption interne sur erreur, étant donné que la signature impose void [SWS_WdgM_00151]. Question Q-83a164f8f4669d4d (ouverte)

Interaction et ordre d'appel

• Diagnostic d'erreurs avant l'initialisation : la fonction WdgM_GetFirstExpiredSEID() doit déjà être disponible avant l'appel de WdgM_Init afin de lire la Supervised Entity ID (SEID) ayant préalablement expiré [SWS_WdgM_00348].
• Nettoyage de la RAM : pendant l'initialisation, WdgM_Init efface la valeur de SEID doublement inversée de la première entité ayant expiré, enregistrée dans la RAM non initialisée [SWS_WdgM_00370].
• Notification d'état au DEM : lors du premier appel de WdgM_MainFunction suivant WdgM_Init, le module signale au DEM [SWS_WdgM_00408] l'état PASSED pour WDGM_E_SUPERVISION lorsque le paramètre WdgMDemStoppedSupervisionReport est activé.

Utilisation

La fonction synchrone WdgM_DeInit sert à la désinitialisation du Watchdog Manager [SWS_WdgM_00261]. L'interface possède le service ID 0x01, est mise à disposition via le fichier d'en-tête WdgM.h, et ne reçoit aucun paramètre d'entrée ni ne renvoie de valeur de retour à l'appelant [SWS_WdgM_00261]. Le contexte d'appel prévu est probablement la séquence d'arrêt ordonnée du calculateur, dans laquelle les surveillances actives sont arrêtées de manière contrôlée avant la mise hors tension. Question Q-50d7e49c71d2dfd3 (ouverte)

Périmètre fonctionnel et interaction

Dans le cadre de la désinitialisation, le module WdgM arrête totalement les fonctions de surveillance (Supervision Functions) pour l'ensemble des algorithmes de surveillance configurés (Supervision Algorithms) et met fin en même temps à la gestion du watchdog (Watchdog Handling) [SWS_WdgM_00407].

Gestion des erreurs et conditions limites

Si le Watchdog Manager se trouve déjà dans l'état global WDGM_GLOBAL_STATUS_DEACTIVATED au moment de l'appel, le comportement dépend du paramètre de configuration WdgMDevErrorDetect : si cette détection de développement est désactivée, WdgM_DeInit retourne immédiatement et sans aucun effet [SWS_WdgM_00388].

En ce qui concerne la concurrence, il est établi que la fonction est non réentrante [SWS_WdgM_00261]. L'appel ne doit donc en aucun cas être effectué de manière interruptive ou parallèle à partir de plusieurs contextes.

Utilisation et sémantique

La fonction WdgM_SetMode sert à basculer de manière synchrone le Watchdog Manager dans l'un des modes de fonctionnement configurés ([SWS_WdgM_00154]). Elle attend comme paramètre de transmission Mode de type WdgM_ModeType. La valeur de retour Std_ReturnType signale par E_OK la réussite du changement de mode et par E_NOT_OK un échec ([SWS_WdgM_00154]).

Restrictions et traitement des erreurs

La fonction n'est pas réentrante (Non Reentrant) ([SWS_WdgM_00154]). L'exécution est liée à l'état global actuel du Watchdog Manager :

• Si le module ne se trouve ni dans l'état WDGM_GLOBAL_STATUS_OK ni dans WDGM_GLOBAL_STATUS_FAILED, la fonction retourne sans exécuter aucune action ([SWS_WdgM_00145]).
• Si le paramètre de configuration WdgMDevErrorDetect est désactivé, un appel dans l'état WDGM_GLOBAL_STATUS_DEACTIVATED reste sans aucun effet ([SWS_WdgM_00392]).

Interaction et répercussions

En présence d'un état global valide (WDGM_GLOBAL_STATUS_OK ou WDGM_GLOBAL_STATUS_FAILED), WdgM_SetMode met à jour les entités surveillées ainsi que les watchdogs :

• Pour chaque Supervised Entity activée dans le mode cible, l'état actuel est conservé ([SWS_WdgM_00182]).
• Pour chaque Supervised Entity désactivée dans le mode cible, l'état local passe à WDGM_LOCAL_STATUS_DEACTIVATED ; les résultats de Active, Deadline et Logical Supervision sont définis sur correct et le compteur de cycles erronés est réinitialisé à 0 ([SWS_WdgM_00315]). Le passage à un mode comportant la désactivation de l'entité assainit en outre les erreurs qui avaient auparavant conduit à WDGM_GLOBAL_STATUS_FAILED ([SWS_WdgM_00182]).
• Enfin, les paramètres de mode de watchdog configurés sont activés pour chaque watchdog matériel via l'interface WdgIf_SetMode ([SWS_WdgM_00186]).

Utilisation et sémantique

La fonction synchrone signale au Watchdog Manager l'atteinte d'un checkpoint au sein d'une Supervised Entity [SWS_WdgM_00263]. Elle prend en paramètres d'entrée l'identifiant de l'entité surveillée (SEID) ainsi que l'identifiant du checkpoint atteint (CheckpointID) et retourne E_OK en cas de mise à jour réussie du compteur d'activité (Alive) ou E_NOT_OK en cas d'erreurs [SWS_WdgM_00263].

Traitement des erreurs et état

Si le Watchdog Manager se trouve dans l'état WDGM_GLOBAL_STATUS_DEACTIVATED, le comportement dépend de la configuration de l'identifiant de développement : lorsque WdgMDevErrorDetect est activé, la fonction signale l'erreur WDGM_E_UNINIT au Default Error Tracer (DET) et retourne sans autre effet [SWS_WdgM_00279]. Si WdgMDevErrorDetect est désactivé, le retour s'effectue sans notification et sans aucun effet [SWS_WdgM_00394].

Concurrence et échéances

L'appel est spécifié comme réentrant [SWS_WdgM_00263]. Pour déterminer les horodatages et les différences temporelles lors de la surveillance des échéances (deadline), la fonction utilise la fonction d'OS GetElapsedValue avec la CounterID configurée pour l'entité [SWS_WdgM_00373]. La mise à l'échelle des différences temporelles par rapport aux valeurs limites s'effectue via le paramètre OsSecondsPerTick [SWS_WdgM_00374]. Si un Deadline End Checkpoint atteint l'appel en mode actif et que l'horodatage du checkpoint de début associé vaut 0, la fonction se termine avec succès sans mesure de différence [SWS_WdgM_00354].

Utilisation et contexte d'appel

La fonction synchrone WdgM_PerformReset ordonne au Watchdog Manager de provoquer le déclenchement d'une réinitialisation par le watchdog [SWS_WdgM_00264]. L'interface est déclarée via l'en-tête WdgM.h et possède le service ID 0x0f [SWS_WdgM_00264]. Elle n'accepte aucun paramètre d'entrée ni de sortie et ne fournit aucune valeur de retour [SWS_WdgM_00264].

Concurrence et restrictions

Puisque WdgM_PerformReset est définie comme non réentrante (Non Reentrant), aucun appel multiple concurrent ou interruptif ne doit avoir lieu [SWS_WdgM_00264]. Les appelants doivent par conséquent s'assurer que les appels sont synchronisés ou effectués de façon exclusive à partir d'un contexte approprié.

Comportement dépendant de l'état et traitement des erreurs

L'exécution est soumise aux états globaux du Watchdog Manager : si le paramètre de configuration WdgMDevErrorDetect est désactivé et que le module se trouve dans l'état global WDGM_GLOBAL_STATUS_DEACTIVATED, la fonction retourne sans aucun effet [SWS_WdgM_00401]. Une réinitialisation n'a absolument pas lieu dans ce cas. Le comportement avec la détection de développement activée (WdgMDevErrorDetect) n'est pas spécifié dans le contenu ; Interpretation : dans ce cas, une erreur de développement correspondante devrait probablement être signalée à l'état désactivé. Question Q-8a726bba4154540f (ouverte)

Utilisation et déroulement cyclique

La fonction WdgM_MainFunction exécute les tâches périodiques du Watchdog Manager [SWS_WdgM_00159]. Elle possède la signature void WdgM_MainFunction(void), ne prend aucun paramètre, ne renvoie aucune valeur de retour et est mise à disposition via l'en-tête SchM_WdgM.h [SWS_WdgM_00159]. Lors du premier appel après l'initialisation du module, elle démarre à la fois l'ensemble des fonctions de surveillance (pour tous les algorithmes de surveillance, y compris les cycles de référence) et la gestion du watchdog [SWS_WdgM_00406].

Surveillance des échéances et détection de timeout

Dans les appels cycliques, WdgM_MainFunction effectue la surveillance des échéances (deadline) pour détecter les dépassements de délai pour toutes les unités ayant une surveillance active et actualise leur résultat [SWS_WdgM_00404] :

• Si la détection est activée via WdgMEnableTimeoutDetection, la fonction contrôle toutes les surveillances de deadline configurées dans le mode actif pour lesquelles le checkpoint de départ a été signalé, mais dont le checkpoint de fin correspondant est encore en attente [SWS_WdgM_00403].
• Si la différence temporelle mesurée par rapport à l'horodatage actuel dépasse le maximum WdgMDeadlineMax, la fonction définit le résultat de surveillance de la Supervised Entity comme étant en erreur (incorrect) [SWS_WdgM_00403].

Interaction avec le système d'exploitation

Pour déterminer les horodatages et les différences, WdgM_MainFunction appelle la fonction d'OS GetElapsedValue avec l'ID de compteur configuré pour l'unité (paramètre WdgMOSCounter) [SWS_WdgM_00373]. La mise à l'échelle des valeurs de différence par rapport aux valeurs limites WdgMDeadlineMin et WdgMDeadlineMax s'effectue à l'aide du paramètre OsSecondsPerTick [SWS_WdgM_00374].

Le type WdgM_Mode est défini comme une Mode Declaration Group de la catégorie EXPLICIT_ORDER et sert à représenter les états de surveillance du module [SWS_WdgM_00334].

Utilisation et plage de valeurs

Le mode initial défini est SUPERVISION_OK [SWS_WdgM_00334]. Des valeurs numériques explicites sont prédéfinies pour les différents modes [SWS_WdgM_00334] :

• SUPERVISION_OK = 0
• SUPERVISION_FAILED = 1
• SUPERVISION_EXPIRED = 2
• SUPERVISION_STOPPED = 3
• SUPERVISION_DEACTIVATED = 4

Pour la valeur de transition (on transition value) entre les modes, la valeur 255 est définie [SWS_WdgM_00334].

Interaction

En raison de son classement dans la catégorie EXPLICIT_ORDER et de l'affectation de valeurs ordinales fixes, le groupe devrait être prévu pour une représentation ordonnée des états au sein du Watchdog Manager [SWS_WdgM_00334]. Question Q-47c55c3bc2e2a23d (ouverte)

Le type WdgM_LocalStatusType est utilisé pour les variables qui représentent l'état de surveillance local actuel d'une entité surveillée individuelle (Supervised Entity) dans le Watchdog Manager [SWS_WdgM_00359]. Le type de données est dérivé du type de base uint8 et est mis à disposition via l'en-tête Rte_WdgM_Type.h [SWS_WdgM_00359].

La plage de valeurs comprend quatre états discrets selon [SWS_WdgM_00359] :

• WDGM_LOCAL_STATUS_OK (valeur 0) : la surveillance de la Supervised Entity ne présente aucune erreur.
• WDGM_LOCAL_STATUS_FAILED (valeur 1) : la surveillance a échoué, mais peut encore être guérie (« healed ») si l'entité revient à un comportement normal. Cela s'applique tant qu'une limite d'erreurs configurable n'est pas dépassée ; dans le cas contraire, l'état bascule vers WDGM_LOCAL_STATUS_EXPIRED.
• WDGM_LOCAL_STATUS_EXPIRED (valeur 2) : la surveillance a échoué de manière permanente ; cet état ne peut plus être quitté.
• WDGM_LOCAL_STATUS_DEACTIVATED (valeur 4) : la surveillance locale de la Supervised Entity est temporairement désactivée.

En raison de sa définition dans Rte_WdgM_Type.h, le type devrait être principalement destiné à l'échange d'états de surveillance entre composants logiciels et à travers la RTE [SWS_WdgM_00359]. Question Q-a9e584dc4c7cfa3b (ouverte)

Le type de données WdgM_GlobalStatusType sert à la définition de variables représentant l'état de surveillance global du module Watchdog Manager [SWS_WdgM_00360]. Il est dérivé du type de base uint8 et est mis à disposition via l'en-tête Rte_WdgM_Type.h [SWS_WdgM_00360].

La plage de valeurs comprend cinq états de surveillance définis [SWS_WdgM_00360] :

• WDGM_GLOBAL_STATUS_OK (0) : la surveillance ne présente aucune erreur.
• WDGM_GLOBAL_STATUS_FAILED (1) : la surveillance a échoué, mais se trouve encore dans la limite d'erreurs admissible.
• WDGM_GLOBAL_STATUS_EXPIRED (2) : la surveillance a échoué et la limite d'erreurs admissible a été dépassée, mais le pilote du watchdog n'a pas encore reçu l'instruction d'arrêter le déclenchement.
• WDGM_GLOBAL_STATUS_STOPPED (3) : la limite d'erreurs a été dépassée et le pilote du watchdog a reçu l'instruction d'arrêter le déclenchement, de sorte qu'un reset du watchdog est imminent.
• WDGM_GLOBAL_STATUS_DEACTIVATED (4) : le module WdgM n'est pas initialisé et ne pilote donc pas les watchdogs.

À travers ces états, le type modélise l'ensemble du cycle de surveillance, depuis la désactivation avant l'initialisation jusqu'à l'escalade à plusieurs niveaux avec reset final du watchdog en cas d'erreurs persistantes, en passant par le fonctionnement normal ou tolérant aux pannes [SWS_WdgM_00360].

Le type de données WdgM_ModeType sert à distinguer sans ambiguïté les différents modes configurés pour le Watchdog Manager [SWS_WdgM_00358]. Il est mis à disposition des composants logiciels et des modules du logiciel de base via le fichier d'en-tête Rte_WdgM_Type.h [SWS_WdgM_00358].

Conformément à la spécification [SWS_WdgM_00358], le type présente les propriétés suivantes :

• Type de base : WdgM_ModeType est dérivé du type de données standard uint8 [SWS_WdgM_00358].
• Plage de valeurs : la plage de valeurs s'étend de 0 à <Number of Modes> [SWS_WdgM_00358].
• Dépendance vis-à-vis de la configuration : la limite supérieure réelle de la plage de valeurs dépend du nombre de modes configurés pour le Watchdog Manager [SWS_WdgM_00358].

Comme il s'agit d'une définition de type, aucun paramètre d'exécution, code d'erreur ou sémantique d'asynchronisme n'existe. Interprétation : en raison de la déclaration dans Rte_WdgM_Type.h, WdgM_ModeType devrait principalement être utilisé pour l'échange d'informations de mode via des interfaces RTE entre le logiciel d'application et le Watchdog Manager. Question Q-27975280bc68720e (ouverte)

L'élément globalmode est défini, conformément à la spécification [SWS_WdgM_00150], en tant que port fourni (Provided Port Interface) du Watchdog Manager (WdgM) dans la plateforme AUTOSAR Classic de la version R20-11. Le type d'interface indiqué est WdgM_GlobalMode. L'élément sert dans le système global d'interface de port formelle par le biais de laquelle le module expose son état aux autres composants logiciels.

La spécification [SWS_WdgM_00150] ne fournit pas de détails supplémentaires concernant l'utilisation concrète, les paramètres, les valeurs de retour ou les structures de données. Selon l'interprétation, l'interface de port devrait principalement servir à fournir l'état global actuel de surveillance du Watchdog Manager à des instances de niveau supérieur telles que le BswM ou des SW-C applicatifs. Question Q-6a0217eb1d28c1b4 (ouverte) En l'absence d'indications divergentes dans les sources, la mise à disposition du mode s'effectue vraisemblablement de façon synchrone via la RTE.

En matière de traitement des erreurs, de notifications DET ou DEM ainsi que de codes d'erreur spécifiques, [SWS_WdgM_00150] reste entièrement silencieux. De même, aucune disposition normative relative à la réentrance, aux priorités ou aux contextes d'appel n'est consignée dans la charge utile ; selon l'interprétation, l'accès devrait néanmoins être soumis aux règles générales de concurrence de la gestion d'états de WdgM. Question Q-28fa9de4b06e3b0d (ouverte) Aucune exigence associée n'est disponible pour cet élément.