Default Error Tracer (DET)

El Default Error Tracer recibe de forma centralizada los mensajes de error de los módulos BSW y de las SW-Cs. Para ello dispone de Det_ReportError para errores de desarrollo, Det_ReportRuntimeError para errores de tiempo de ejecución y Det_ReportTransientFault para errores transitorios, cada uno con identificación de módulo, de instancia, de API y de error. El DET reenvía cada mensaje a todos los hooks o callouts configurados del integrador [SWS_Det_00501]. Det_Init y Det_Start inician el funcionamiento desde el EcuM. La condición de contorno más importante: en R20-11, Det_ReportError no retorna al invocador, sino que detiene el flujo del programa como una aserción [SWS_Det_00009].

más ›

El Default Error Tracer es el punto central de recopilación de mensajes de error procedentes del software básico y de los componentes de software. Ofrece tres servicios de notificación estructurados de forma idéntica con los parámetros ModuleId, InstanceId, ApiId y ErrorId o FaultId: Det_ReportError para errores de desarrollo, Det_ReportRuntimeError para errores de tiempo de ejecución y Det_ReportTransientFault para errores transitorios ([SWS_Det_00009], [SWS_Det_01001], [SWS_Det_01003]). El EcuM pone en funcionamiento el DET con Det_Init y posteriormente con Det_Start ([SWS_Det_00008], SWS DET Fig. 1 p. 34).

Diagrama de contexto: el DET recibe mensajes de módulos BSW y SW-Cs y los reenvía a los hooks del integrador y, opcionalmente, a Dlt. Fuentes: SWS DET Fig. 2 p. 28, [SWS_Det_00202]

El DET no evalúa los mensajes por sí mismo. Cada servicio de notificación invoca todos los hooks o callouts configurados para él (DetErrorHook, DetReportRuntimeErrorCallout, DetReportTransientFaultCallout), concretamente con los mismos parámetros que el mensaje [SWS_Det_00501]. A través de este código del integrador, el DET también accede a DEM o a la memoria de errores. Los callouts deben limitarse a acciones breves y adecuadas ErrorDescription p. 10.

Las SW-Cs notifican a través de la interfaz cliente-servidor DETService. La RTE añade ModuleId y InstanceId como «port defined argument values» procedentes de la configuración del DET; la SW-C siempre recibe como retorno E_OK ([SWS_Det_00203], [SWS_Det_00204]).

Para los casos de error, es determinante cómo retornan los tres servicios. En R20-11, Det_ReportError no retorna: tras los hooks, se detiene el flujo de control, al igual que en una aserción ([SWS_Det_00009], RS BSWGeneral p. 33). Por el contrario, los mensajes de tiempo de ejecución retornan con E_OK. Los mensajes transitorios transmiten el valor del callout, y sin callout retornan E_OK SWS DET Fig. 6 p. 36. Los errores transitorios se suprimen con R24-11, y las llamadas a Dlt con R25-11 SWS DET p. 1.

Diagrama de secuencia: ante un error de desarrollo, el DET invoca todos los hooks configurados y a continuación se detiene sin retornar al emisor de la notificación. Fuentes: SWS DET Fig. 9.2 p. 34, [SWS_Det_00009]

más ›

Rol del Default Error Tracer en el límite del sistema

El Default Error Tracer (DET) es el punto central de recopilación al que los módulos del software básico y los componentes de software notifican los errores detectados. En R20-11 ofrece para ello tres servicios de notificación estructurados de forma idéntica: Det_ReportError para errores de desarrollo [SWS_Det_00009], Det_ReportRuntimeError para errores de tiempo de ejecución [SWS_Det_01001] y Det_ReportTransientFault para errores transitorios [SWS_Det_01003]. A estos se suman los servicios de administración Det_Init, Det_Start y Det_GetVersionInfo ([SWS_Det_00008], [SWS_Det_00010], [SWS_Det_00011]). El DET no evalúa por sí mismo el contenido de los mensajes. Notifica a los error hooks configurados con cada mensaje recibido SWS DET p. 16.

Hacia el exterior, el DET cuenta con una conectividad reducida. Como única interfaz prevista, la especificación menciona el reenvío opcional a Dlt mediante Dlt_DetForwardErrorTrace desde Dlt_Det.h ([SWS_Det_00211], SWS DET Fig. 2 p. 28). El DET solo accede a DEM y a la RTE a través de código específico del integrador en los callouts ErrorDescription p. 10.

Diagrama de contexto: el DET recibe mensajes de módulos BSW y, a través de la RTE, de SW-Cs. Es arrancado por el EcuM y solo transmite mensajes al código del integrador configurado y, opcionalmente, a Dlt. Fuentes: SWS DET Fig. 2 p. 28, [SWS_Det_00202], [SWS_Det_00211], ErrorDescription p. 10

Arranque: inicialización e inicio mediante el EcuM

El ECU State Manager inicializa el DET con Det_Init (Service-ID 0x00). Para ello, transmite un puntero al conjunto de configuración seleccionado de tipo Det_ConfigType, cuyo contenido es específico de la implementación ([SWS_Det_00008], [SWS_Det_00210]). A continuación, Det_Start (Service-ID 0x02) inicia el tracer [SWS_Det_00010]. Ambos servicios son síncronos y no reentrantes. El diagrama de R20-11 muestra ambas llamadas de forma sucesiva desde el EcuM SWS DET Fig. 1 p. 34. De manera correspondiente, el EcuM gestiona Det_Init y Det_ReportError como interfaces opcionales SWS EcuM p. 142.

La especificación no justifica por qué la inicialización y el inicio están separados. Interpretación: es probable que la división en dos partes permita inicializar el DET en una fase muy temprana del arranque y habilitar el funcionamiento normal únicamente en un paso posterior [SWS_Det_00010]. Pregunta Q-fee4462bdf189dcf (abierta)

Diagrama de secuencia: el EcuM invoca primero de forma síncrona Det_Init con el puntero de configuración y, a continuación, Det_Start. Fuentes: SWS DET Fig. 1 p. 34, [SWS_Det_00008], [SWS_Det_00010]

Tres vías de notificación y sus identificadores

Los tres servicios de notificación tienen la misma estructura de parámetros:

• ModuleId (uint16);
• InstanceId (uint8), en módulos de instancia única el valor 0;
• ApiId (uint8);
• ErrorId o FaultId (uint8).

Los identificadores de API y de error son determinados en cada caso por la SWS del módulo emisor ([SWS_Det_00009], [SWS_Det_01001], [SWS_Det_01003]). El ID de módulo procede de la lista de módulos del software básico. De esta lista, el software básico solo utiliza el rango 0..255 EXP LSA p. 157.

La vía correcta se deduce de la clasificación de errores. Las condiciones previas fundamentales que se hayan vulnerado son errores de desarrollo y se tratan como una aserción; algunos ejemplos son errores de software, integración errónea o configuración inválida. Los demás errores son errores de tiempo de ejecución o de producción EXP LSA p. 154. Si la detección de errores de desarrollo está configurada, los módulos BSW notifican los errores de desarrollo con su ID de módulo asignado mediante Det_ReportError SWS BSWGeneral p. 57. Un conmutador de preprocesador como SPI_DEV_ERROR_DETECT activa o desactiva la llamada EXP LSA p. 113.

Diagrama de actividades: si se vulnera una condición previa fundamental, se notifica un error de desarrollo mediante Det_ReportError. En caso contrario, la relevancia diagnóstica discrimina entre error de producción y error de tiempo de ejecución (Det_ReportRuntimeError). Fuentes: EXP LSA p. 154, [SWS_Det_00009], [SWS_Det_01001]

Los errores de tiempo de ejecución son notificados, por ejemplo, por el controlador ADC con ADC_E_BUSY o por Dds en caso de mensajes descartados, en cada caso mediante Det_ReportRuntimeError (SWS Adc p. 95, SWS Dds p. 53). Un módulo BSW describe sus necesidades con el tipo de ServiceNeeds ErrorTracerNeeds. Este reconoce los roles Det_ReportError, Det_ReportRuntimeError y Det_ReportTransientFault TPS BSWMDT p. 266.

Hooks y callouts como puente hacia el código del integrador

Cada llamada a Det_ReportError invoca todas las funciones configuradas en DetErrorHook. Del mismo modo, Det_ReportRuntimeError y Det_ReportTransientFault invocan todos los callouts de DetReportRuntimeErrorCallout y DetReportTransientFaultCallout, respectivamente [SWS_Det_00501]. Los hooks y callouts presentan la firma del servicio desencadenante y reciben los mismos parámetros ([SWS_Det_00181], [SWS_Det_00184], [SWS_Det_00187], SWS DET p. 16). La interfaz de hook <User_Error_Hooks> tiene el Service-ID 0x10. Es síncrona y reentrante, y siempre devuelve E_OK SWS DET p. 25.

Las acciones que realizan los callouts son decisión del integrador. En errores de tiempo de ejecución y transitorios, deben limitarse a pocas acciones: registrar el evento, invocar el DEM o ejecutar otra acción breve y apropiada ErrorDescription p. 10. Tras una llamada a Det_ReportRuntimeError, el DET siempre retorna con E_OK, independientemente de que haya callouts configurados o no (SWS DET Fig. 4 p. 35, SWS DET Fig. 5 p. 35).

Diagrama de secuencia: Det_ReportRuntimeError invoca todos los callouts configurados y retorna en cualquier caso al emisor con E_OK. Fuentes: SWS DET Fig. 4 p. 35, SWS DET Fig. 5 p. 35, [SWS_Det_00501]

En cambio, con Det_ReportTransientFault, el DET transfiere el valor de retorno del callout al emisor. Si no hay callout, devuelve E_OK (SWS DET Fig. 6 p. 36, SWS DET Fig. 7 p. 36). Para múltiples callouts, una versión posterior describe una operación lógica OR de los valores de retorno: E_OK solo se devuelve si todos los callouts proporcionan E_OK. Es de suponer que esta regla ya sea aplicable a R20-11 SWS DET p. 24. Pregunta (abierta)

Diagrama de secuencia: Det_ReportTransientFault transmite los valores de retorno de los callouts al emisor; si no hay callout, devuelve E_OK. La operación OR en caso de múltiples callouts está identificada como una suposición. Fuentes: SWS DET Fig. 6 p. 36, SWS DET Fig. 7 p. 36, SWS DET p. 24

Conexión de componentes de software mediante puertos de servicio

Las SW-Cs acceden al DET a través de la interfaz cliente-servidor DETService. Sus operaciones invocan Det_ReportError o la notificación de tiempo de ejecución con el ID de módulo del puerto [SWS_Det_00202]. La propia SW-C no transmite ModuleId ni InstanceId. La RTE los añade como «port defined argument values», cuyos valores proceden de DetModuleId y DetInstanceId de la configuración del DET ([SWS_Det_00204], [SWS_Det_00205], [SWS_Det_00206]). Para las SW-Cs, ApiId y ErrorId no están estandarizados y pueden asignarse libremente en el rango 0x00..0xFF. El valor de retorno es siempre E_OK [SWS_Det_00203]. La interfaz de puerto utiliza los tipos de datos uint8 y uint16 de AUTOSAR [SWS_Det_00200].

Diagrama de secuencia: la SW-C solo transmite ApiId y ErrorId. La RTE añade ModuleId y InstanceId a partir de la configuración; el retorno es E_OK. Fuentes: [SWS_Det_00202], [SWS_Det_00203], [SWS_Det_00204], SWS DET Fig. 3 p. 33

Configuración de las notificaciones

Las funciones de notificación residen en el contenedor opcional DetNotification (multiplicidad 0..1). Este contiene las listas DetErrorHook y DetReportRuntimeErrorCallout (cada una 0..*). DetErrorHook se configura en tiempo de precompilación y requiere el tipo de función Std_ReturnType (*f)(uint16, uint8, uint8, uint8) SWS DET p. 37. En R20-11 se añade DetReportTransientFaultCallout [SWS_Det_00501]. El diagrama de parámetros muestra además el contenedor obligatorio DetGeneral con DetVersionInfoApi y DetForwardToDlt SWS DET (alt) Fig. 6 p. 43. A partir de DetConfigSet/DetModule y DetModuleInstance, la configuración genera los puertos Det_{Name} junto con la identificación de módulo y de instancia [SWS_Det_00205].

Comportamiento en caso de error

Los errores de desarrollo se tratan como aserciones. Tras invocar los hooks configurados, el flujo de control normal no continúa y el DET detiene la ejecución, por ejemplo mediante un bucle infinito o una instrucción de parada RS BSWGeneral p. 33. Con esto coincide la entrada para Det_ReportError en R20-11 bajo Sync/Async: «Not Applicable: The function never returns» [SWS_Det_00009]. Los esquemas muestran este HALT con y sin hook configurado (SWS DET Fig. 9.2 p. 34, SWS DET Fig. 9.3 p. 35).

Diagrama de secuencia: un módulo BSW detecta un error de desarrollo e invoca Det_ReportError. El DET invoca todos los hooks configurados y a continuación se detiene sin retornar al emisor. Fuentes: SWS DET Fig. 9.2 p. 34, SWS DET Fig. 9.3 p. 35, [SWS_Det_00009], [SWS_Det_00501]

Algunos esquemas difieren de esto. Un diagrama de secuencia señala que el comportamiento síncrono o asíncrono depende de la implementación y representa un retorno al invocador SWS DET Fig. 5 p. 36. También el diagrama de Dio muestra un retorno tras Det_ReportError SWS Dio Fig. 5 p. 41. Para R20-11, el carácter normativo corresponde a [SWS_Det_00009]. La aclaración de la especificación Sync/Async no llegó hasta R21-11 SWS DET p. 1.

Los errores de tiempo de ejecución y transitorios no interrumpen el flujo del programa: el DET retorna al emisor con un valor de retorno ([SWS_Det_01001], [SWS_Det_01003]). El propio DET solo reconoce un único error de desarrollo propio. DET_E_PARAM_POINTER (0x01) se produce cuando Det_GetVersionInfo se invoca con un puntero nulo [SWS_Det_00301]. Una versión posterior estipula que este error se notifique a todos los callouts configurados. Es de suponer que también en R20-11 se concibiera así SWS DET p. 18. Pregunta Q-3a7f5865d61186d4 (abierta)

Más evidencia detallada

• [SWS_Det_00009]: firma de Det_ReportError, Service-ID 0x01, no retorna.
• [SWS_Det_01001], [SWS_Det_01003]: notificaciones de tiempo de ejecución y transitorias con los Service-IDs 0x04 y 0x05.
• [SWS_Det_00501]: obligación de invocar todos los hooks y callouts configurados.
• [SWS_Det_00181], [SWS_Det_00184], [SWS_Det_00187]: firmas de los hooks y callouts con los Service-IDs 0x10, 0x11 y 0x12.
• [SWS_Det_00202] a [SWS_Det_00206]: modelo de puerto de servicio para SW-Cs.
• [SWS_Det_00008], [SWS_Det_00010], [SWS_Det_00210]: arranque y tipo de configuración.
• [SWS_Det_00211], [SWS_Det_00301]: reenvío a Dlt y error de desarrollo propio.

Versiones posteriores modifican el alcance funcional. Una versión de R23-11/R24-11 marca Det_ReportTransientFault como OBSOLETE SWS DET p. 24. Según el historial de cambios, los errores transitorios se suprimen con R24-11 y las llamadas a Dlt con R25-11 SWS DET p. 1. En R20-11, ambas funciones forman parte todavía de la especificación ([SWS_Det_01003], [SWS_Det_00211]).