Watchdog Manager (WdgM)

usar

La función WdgM_Init inicializa el Watchdog Manager de forma síncrona y no es reentrante [SWS_WdgM_00151]. Como único parámetro de transferencia sirve ConfigPtr, que hace referencia a los datos de configuración post-build (WdgM_ConfigType) [SWS_WdgM_00151]. Formalmente, la función no posee ningún valor de retorno (void) [SWS_WdgM_00151].

Tratamiento de errores y condiciones límite

Antes de la inicialización, el Watchdog Manager debe encontrarse en el estado WDGM_GLOBAL_STATUS_DEACTIVATED: si el parámetro de configuración de desarrollo WdgMDevErrorDetect está desactivado y el módulo no se halla en dicho estado, WdgM_Init retorna sin efecto [SWS_WdgM_00390].

Si el interruptor de configuración WdgMOffModeEnabled no está activado y el modo inicial predeterminado a través de ConfigPtr desactivaría el watchdog (WDGIF_OFF_MODE), la función aborta sin realizar ninguna otra acción y notifica el error de tiempo de ejecución WDGM_E_DISABLE_NOT_ALLOWED al Default Error Tracer (DET) [SWS_WdgM_00030]. El retorno exigido en la especificación con E_NOT_OK probablemente deba entenderse como interpretación de una interrupción por error interno, dado que la signatura prescribe void [SWS_WdgM_00151]. Pregunta Q-83a164f8f4669d4d (abierta)

Interacción y orden de ejecución

• Diagnóstico de errores antes de la inicialización: La función WdgM_GetFirstExpiredSEID() debe estar disponible ya antes de la invocación de WdgM_Init para leer el Supervised Entity ID (SEID) que expiró con anterioridad [SWS_WdgM_00348].
• Limpieza de RAM: Durante la inicialización, WdgM_Init borra el valor de SEID doblemente invertido de la primera entidad expirada almacenado en la RAM no inicializada [SWS_WdgM_00370].
• Notificación de estado al DEM: Dentro de la primera llamada a WdgM_MainFunction posterior a WdgM_Init, el módulo notifica al DEM [SWS_WdgM_00408], si el parámetro WdgMDemStoppedSupervisionReport está configurado, el estado PASSED para WDGM_E_SUPERVISION.

usar

La función síncrona WdgM_DeInit sirve para la desinicialización del Watchdog Manager [SWS_WdgM_00261]. La interfaz posee el Service-ID 0x01, se proporciona a través del archivo de cabecera WdgM.h y no recibe parámetros de entrada ni devuelve un valor de retorno al llamador [SWS_WdgM_00261]. Como contexto de llamada, probablemente esté prevista la secuencia ordenada de shutdown de la unidad de control, en la que las supervisiones activas se finalizan de manera controlada antes de la desconexión. Pregunta Q-50d7e49c71d2dfd3 (abierta)

Alcance de funciones e interacción

En el marco de la desinicialización, el módulo WdgM detiene por completo las funciones de supervisión (Supervision Functions) a través de todos los algoritmos de supervisión configurados (Supervision Algorithms) y finaliza al mismo tiempo el servicio del watchdog (Watchdog Handling) [SWS_WdgM_00407].

Tratamiento de errores y condiciones límite

Si en el momento de la llamada el Watchdog Manager ya se encuentra en el estado global WDGM_GLOBAL_STATUS_DEACTIVATED, el comportamiento depende del parámetro de configuración WdgMDevErrorDetect: si esta detección de desarrollo está desactivada, WdgM_DeInit regresa de inmediato y sin efecto alguno [SWS_WdgM_00388].

En cuanto a la concurrencia, se establece que la función no es reentrante [SWS_WdgM_00261]. Por tanto, la llamada no debe realizarse bajo ninguna circunstancia de forma intermitente ni en paralelo desde múltiples contextos.

Uso y semántica

La función WdgM_SetMode sirve para conmutar de forma síncrona el Watchdog Manager a uno de los modos de funcionamiento configurados ([SWS_WdgM_00154]). Como parámetro de entrada espera Mode del tipo WdgM_ModeType. El valor de retorno Std_ReturnType indica con E_OK la ejecución correcta del cambio de modo y con E_NOT_OK un fallo ([SWS_WdgM_00154]).

Restricciones y tratamiento de errores

La función no es reentrante (Non Reentrant) ([SWS_WdgM_00154]). Su ejecución está vinculada al estado global actual del Watchdog Manager:

• Si el módulo no se encuentra ni en el estado WDGM_GLOBAL_STATUS_OK ni en WDGM_GLOBAL_STATUS_FAILED, la función regresa sin ejecutar ninguna acción ([SWS_WdgM_00145]).
• Si el parámetro de configuración WdgMDevErrorDetect está desactivado, una llamada en el estado WDGM_GLOBAL_STATUS_DEACTIVATED permanece sin efecto alguno ([SWS_WdgM_00392]).

Interacción y efectos

Si existe un estado global válido (WDGM_GLOBAL_STATUS_OK o WDGM_GLOBAL_STATUS_FAILED), WdgM_SetMode actualiza tanto las entidades supervisadas como los watchdogs:

• Para cada Supervised Entity activada en el modo de destino, se mantiene el estado actual ([SWS_WdgM_00182]).
• Para cada Supervised Entity desactivada en el modo de destino, el estado local cambia a WDGM_LOCAL_STATUS_DEACTIVATED; los resultados de Active, Deadline y Logical Supervision se establecen en correcto y el contador de ciclos fallidos se restablece a 0 ([SWS_WdgM_00315]). Mediante el cambio a un modo con desactivación de la entidad, también se corrigen los fallos que previamente habían provocado WDGM_GLOBAL_STATUS_FAILED ([SWS_WdgM_00182]).
• Por último, los parámetros de modo de watchdog configurados para cada hardware watchdog se vuelven efectivos a través de la interfaz WdgIf_SetMode ([SWS_WdgM_00186]).

Uso y semántica

La función síncrona notifica al Watchdog Manager la llegada a un checkpoint dentro de una Supervised Entity [SWS_WdgM_00263]. Recibe como parámetros de entrada el identificador de la entidad supervisada (SEID) y el identificador del checkpoint alcanzado (CheckpointID), y devuelve E_OK en caso de actualización exitosa del contador alive o E_NOT_OK en caso de error [SWS_WdgM_00263].

Tratamiento de errores y estado

Si el Watchdog Manager se encuentra en el estado WDGM_GLOBAL_STATUS_DEACTIVATED, el comportamiento depende de la configuración del identificador de desarrollo: con WdgMDevErrorDetect activado, la función notifica el error WDGM_E_UNINIT al Default Error Tracer (DET) y retorna sin más efecto [SWS_WdgM_00279]. Si WdgMDevErrorDetect está desactivado, el retorno se produce sin notificación y sin efecto alguno [SWS_WdgM_00394].

Concurrencia y deadlines

La llamada está especificada como reentrante [SWS_WdgM_00263]. Para determinar marcas de tiempo y diferencias temporales en la supervisión de deadline, la función utiliza la función del OS GetElapsedValue con la CounterID configurada para la entidad [SWS_WdgM_00373]. El escalado de las diferencias temporales respecto a los valores límite se efectúa mediante el parámetro OsSecondsPerTick [SWS_WdgM_00374]. Si una llamada recibe un Deadline End Checkpoint en el modo activo y la marca de tiempo del checkpoint de inicio correspondiente es 0, la función concluye con éxito sin medición de diferencia [SWS_WdgM_00354].

Uso y contexto de llamada

La función síncrona WdgM_PerformReset instruye al Watchdog Manager para que provoque la activación de un reset de watchdog [SWS_WdgM_00264]. La interfaz se declara a través del encabezado WdgM.h y posee el Service-ID 0x0f [SWS_WdgM_00264]. No recibe parámetros de entrada ni de salida y no devuelve ningún valor de retorno [SWS_WdgM_00264].

Concurrencia y restricciones

Dado que WdgM_PerformReset se define como no reentrante (Non Reentrant), no debe realizarse ninguna llamada múltiple concurrente o interruptiva [SWS_WdgM_00264]. Por lo tanto, los llamadores deben asegurarse de que las llamadas se sincronicen o se emitan de forma exclusiva desde un contexto adecuado.

Comportamiento dependiente del estado y tratamiento de errores

La ejecución está sujeta a los estados globales del Watchdog Manager: si el parámetro de configuración WdgMDevErrorDetect está desactivado y el módulo se encuentra en el estado global WDGM_GLOBAL_STATUS_DEACTIVATED, la función regresa sin efecto alguno [SWS_WdgM_00401]. En este caso, no se produce ningún reset. El comportamiento con la detección de desarrollo activada (WdgMDevErrorDetect) no está especificado en el payload; interpretación: en este caso, en estado desactivado probablemente se notificaría el correspondiente error de desarrollo. Pregunta Q-8a726bba4154540f (abierta)

Uso y secuencia cíclica

La función WdgM_MainFunction ejecuta las tareas periódicas del Watchdog Manager [SWS_WdgM_00159]. Posee la signatura void WdgM_MainFunction(void), no recibe parámetros, no devuelve ningún valor de retorno y se proporciona a través del encabezado SchM_WdgM.h [SWS_WdgM_00159]. En la primera llamada tras la inicialización del módulo, inicia tanto todas las funciones de supervisión (para todos los algoritmos de supervisión, incluidos los ciclos de referencia) como la gestión del watchdog [SWS_WdgM_00406].

Supervisión de deadline y detección de timeouts

En las llamadas cíclicas, WdgM_MainFunction realiza la supervisión de deadline para detectar timeouts en todas las unidades con supervisión activa y actualiza su resultado [SWS_WdgM_00404]:

• Si la detección está activada mediante WdgMEnableTimeoutDetection, la función comprueba todas las supervisiones de deadline configuradas en el modo activo en las que se notificó el checkpoint inicial, pero cuyo checkpoint final correspondiente aún está pendiente [SWS_WdgM_00403].
• Si la diferencia de tiempo medida respecto a la marca temporal actual supera el máximo WdgMDeadlineMax, la función establece el resultado de supervisión de la Supervised Entity como erróneo (incorrect) [SWS_WdgM_00403].

Interacción con el sistema operativo

Para determinar marcas temporales y diferencias, WdgM_MainFunction invoca la función del OS GetElapsedValue con el ID de contador configurado para la unidad (parámetro WdgMOSCounter) [SWS_WdgM_00373]. El escalado de los valores diferenciales respecto a los valores límite WdgMDeadlineMin y WdgMDeadlineMax se realiza en función del parámetro OsSecondsPerTick [SWS_WdgM_00374].

El tipo WdgM_Mode está definido como Mode Declaration Group de la categoría EXPLICIT_ORDER y sirve para representar estados de supervisión del módulo [SWS_WdgM_00334].

Uso y rango de valores

Como modo inicial se establece SUPERVISION_OK [SWS_WdgM_00334]. Para los distintos modos se prescriben valores numéricos explícitos [SWS_WdgM_00334]:

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

Para el valor de transición (on transition value) entre modos se define el valor 255 [SWS_WdgM_00334].

Interacción

Debido a la clasificación en la categoría EXPLICIT_ORDER y a la asignación de valores ordinales fijos, es de suponer que el grupo esté previsto para una representación ordenada de estados dentro del Watchdog Manager [SWS_WdgM_00334]. Pregunta Q-47c55c3bc2e2a23d (abierta)

El tipo WdgM_LocalStatusType se utiliza para variables que representan el estado de supervisión local actual de una entidad supervisada individual (Supervised Entity) en el Watchdog Manager [SWS_WdgM_00359]. El tipo de datos deriva del tipo base uint8 y se proporciona a través del encabezado Rte_WdgM_Type.h [SWS_WdgM_00359].

El rango de valores comprende cuatro estados discretos según [SWS_WdgM_00359]:

• WDGM_LOCAL_STATUS_OK (valor 0): La supervisión de la Supervised Entity no presenta fallos.
• WDGM_LOCAL_STATUS_FAILED (valor 1): La supervisión ha fallado, pero todavía puede subsanarse («healed») si la entidad regresa a un comportamiento normal. Esto aplica mientras no se haya superado un límite de fallos configurable; en caso contrario, el estado pasa a WDGM_LOCAL_STATUS_EXPIRED.
• WDGM_LOCAL_STATUS_EXPIRED (valor 2): La supervisión ha fallado de forma permanente; no es posible salir de este estado.
• WDGM_LOCAL_STATUS_DEACTIVATED (valor 4): La supervisión local de la Supervised Entity está temporalmente desactivada.

Debido a su definición en Rte_WdgM_Type.h, es de suponer que el tipo esté destinado principalmente al intercambio de estados de supervisión entre componentes de software y a través de la RTE [SWS_WdgM_00359]. Pregunta Q-a9e584dc4c7cfa3b (abierta)

El tipo de datos WdgM_GlobalStatusType sirve para la definición de variables que representan el estado de supervisión global del módulo Watchdog Manager [SWS_WdgM_00360]. Deriva del tipo base uint8 y se pone a disposición mediante el encabezado Rte_WdgM_Type.h [SWS_WdgM_00360].

El rango de valores comprende cinco estados de supervisión definidos [SWS_WdgM_00360]:

• WDGM_GLOBAL_STATUS_OK (0): La supervisión no presenta ningún tipo de fallo.
• WDGM_GLOBAL_STATUS_FAILED (1): La supervisión ha fallado, pero se encuentra aún dentro del límite admisible de fallos.
• WDGM_GLOBAL_STATUS_EXPIRED (2): La supervisión ha fallado y se ha superado el límite admisible de fallos, pero todavía no se ha ordenado al controlador del watchdog que suspenda el disparo (triggering).
• WDGM_GLOBAL_STATUS_STOPPED (3): Se ha superado el límite de fallos y se ha ordenado al controlador del watchdog que detenga el disparo, de modo que un reinicio por watchdog es inminente.
• WDGM_GLOBAL_STATUS_DEACTIVATED (4): El módulo WdgM no está inicializado y, por consiguiente, no pilota los watchdogs.

A través de estos estados, el tipo representa el ciclo completo de supervisión, comenzando por la desactivación previa a la inicialización, pasando por el funcionamiento regular o tolerante a fallos, hasta la escalada multinivel con el subsiguiente reinicio por watchdog en caso de fallos persistentes [SWS_WdgM_00360].

El tipo de datos WdgM_ModeType sirve para distinguir unívocamente los diferentes modos configurados para el Watchdog Manager [SWS_WdgM_00358]. Se proporciona para componentes de software y módulos de software básico a través del archivo de cabecera Rte_WdgM_Type.h [SWS_WdgM_00358].

Según la especificación [SWS_WdgM_00358], el tipo presenta las siguientes propiedades:

• Tipo base: WdgM_ModeType deriva del tipo de datos estándar uint8 [SWS_WdgM_00358].
• Rango de valores: el rango de valores abarca de 0 a <Number of Modes> [SWS_WdgM_00358].
• Dependencia de la configuración: el límite superior real del rango de valores depende del número de modos configurados para el Watchdog Manager [SWS_WdgM_00358].

Dado que se trata de una definición de tipo, no existen parámetros de tiempo de ejecución, códigos de error ni semánticas de asincronía. Interpretación: debido a la declaración en Rte_WdgM_Type.h, es probable que WdgM_ModeType se utilice principalmente para el intercambio de información de modo a través de interfaces RTE entre el software de aplicación y el Watchdog Manager. Pregunta Q-27975280bc68720e (abierta)

El elemento globalmode está definido según la especificación [SWS_WdgM_00150] como un puerto proporcionado (Provided Port Interface) del Watchdog Manager (WdgM) en la plataforma AUTOSAR Classic en el release R20-11. Como tipo de interfaz se indica WdgM_GlobalMode. El elemento sirve en el sistema global como interfaz de puerto formal a través de la cual el módulo expone su estado para otros componentes de software.

Respecto al uso concreto, los parámetros, valores de retorno o estructuras de datos, la especificación [SWS_WdgM_00150] no proporciona más detalles. Como interpretación, es probable que la interfaz de puerto sirva primordialmente para suministrar a entidades de nivel superior como el BswM o SW-Cs de aplicación el estado de supervisión global actual del Watchdog Manager. Pregunta Q-6a0217eb1d28c1b4 (abierta) A falta de indicaciones discrepantes en las fuentes, la provisión del modo probablemente se gestione de forma síncrona a través de la RTE.

En lo que respecta al tratamiento de errores, notificaciones DET o DEM y códigos de error específicos, [SWS_WdgM_00150] guarda total silencio. Asimismo, no constan en el payload especificaciones normativas relativas a reentrancia, prioridades o contextos de llamada; no obstante, como interpretación, el acceso probablemente esté sujeto a las reglas generales de concurrencia de la gestión de estados del WdgM. Pregunta Q-28fa9de4b06e3b0d (abierta) No constan requisitos relacionados para este elemento.