estructura ara::diag::DiagnosticSovdContentData

La estructura ara::diag::DiagnosticSovdContentData sirve como contenedor de datos estandarizado para encapsular contenidos de diagnóstico destinados a servicios SOVD en AUTOSAR Adaptive ([SWS_DM_02385]). Mantiene los datos útiles en un vector público de elementos de contenido ([SWS_DM_02386]), a partir de los cuales Diagnostic Management genera el atributo SOVD parameters en las respuestas de operaciones y de estado. Al tratarse de un objeto de transferencia de valores puro, la estructura no ofrece sincronización interna de hilos, por lo que las modificaciones concurrentes deben asegurarse internamente en la aplicación.

más ›

Contexto

La estructura de datos ara::diag::DiagnosticSovdContentData forma parte del módulo de diagnóstico (diag) de AUTOSAR Adaptive Platform y está declarada en el encabezado ara/diag/diagnostic_sovd_content_data.h (AUTOSAR_AP_SWS_Diagnostics §8.59 «Header: ara/diag/diagnostic_sovd_content_data.h», [SWS_DM_02385]). Funciona como un portador de datos estandarizado para encapsular contenidos de diagnóstico en el diagnóstico vehicular orientado a servicios según ASAM SOVD.

Dentro de la plataforma, la estructura actúa como intermediaria entre el servidor de diagnóstico (Diagnostic Management, DM) y los proveedores de servicios de una Adaptive Application ([SWS_DM_01396], [SWS_DM_02174]). Si un cliente SOVD externo desencadena una operación o una consulta de estado, el DM delega la llamada en el componente de software implementador. La aplicación almacena los datos de salida generados en una instancia de DiagnosticSovdContentData ([SWS_DM_02386]). A continuación, el DM transfiere estos contenidos al cuerpo de respuesta SOVD, en concreto al atributo estandarizado parameters ([SWS_DM_02176], [SWS_DM_02181]).

Diagrama de contexto: integración de DiagnosticSovdContentData en el intercambio de datos entre el cliente SOVD, Diagnostic Management y el proveedor del servicio de diagnóstico. Fuentes: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02385], [SWS_DM_02386].

Ciclo de vida

La definición como struct de C++ (AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 «Public Member Variables», [SWS_DM_02385]) asigna a DiagnosticSovdContentData el rol de un contenedor de datos. La estructura cuenta con la variable miembro pública elements del tipo ara::core::Vector<DiagnosticSovdContentElementData> ([SWS_DM_02386]), en la que se gestionan dinámicamente los distintos elementos de contenido.

La creación de la instancia se realiza típicamente de forma local dentro de los métodos del proveedor de servicios tan pronto como se recopilan los datos de diagnóstico para una respuesta. En interfaces asíncronas como Read (AUTOSAR_AP_SWS_Diagnostics §8.x «Read»), el objeto se encapsula en un ara::core::Future<DiagnosticSovdContentData>. Interpretación: en este caso, se presume que la estructura pasa a ser propiedad del invocador por paso de valor o semántica de movimiento, de modo que su tiempo de vida queda vinculado al objeto Future procesador. Pregunta Q-564c59896de41f85 (abierta)

En lo relativo a la concurrencia, la estructura no contiene primitivas de sincronización interna. Interpretación: al tratarse de un objeto de transferencia por valor (Value Object) puro, es de suponer que no exista protección interna de hilos; por tanto, los accesos concurrentes a la misma instancia deben sincronizarse mediante la lógica de la aplicación invocadora. Pregunta (abierta) La destrucción de la instancia se produce automáticamente al salir del ámbito de validez del contexto administrador.

Ruta de uso

La vía de uso principal de DiagnosticSovdContentData reside en la provisión de datos útiles en ejecuciones de operaciones síncronas así como en consultas de estado dentro del marco SOVD:

1. Un cliente SOVD externo envía al vehículo una solicitud para iniciar una operación según ASAM SOVD ([SWS_DM_01396]).
2. Tras validar las condiciones de contorno, Diagnostic Management delega la ejecución en la operación responsable a través de ara::diag::GenericDiagnosticSovdOperation::StartExecution ([SWS_DM_02174]).
3. La aplicación de servicio ejecuta la operación de diagnóstico, instancia DiagnosticSovdContentData y rellena el miembro elements con los datos de elementos generados ([SWS_DM_02386]).
4. El objeto se transfiere a Diagnostic Management como parte del valor de retorno para ejecuciones síncronas ([SWS_DM_02176]).
5. Diagnostic Management lee los valores de DiagnosticSovdContentData, los transfiere al atributo parameters del cuerpo de respuesta SOVD y envía la respuesta al cliente ([SWS_DM_02176]).

Una ruta análoga es válida para la consulta de estado a través de SovdOperationExecution::GetStatus ([SWS_DM_02180]), en la que el atributo parameters también se deriva a partir de los DiagnosticSovdContentData entregados ([SWS_DM_02181]). Asimismo, los proveedores de contenidos utilizan la misma estructura como tipo de retorno a través de Read (AUTOSAR_AP_SWS_Diagnostics §8.x «Read»).

Diagrama de secuencia: provisión de datos útiles mediante DiagnosticSovdContentData en una ejecución síncrona de operación. Fuentes: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], [SWS_DM_02386].