estructura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface6>StartOutput

La estructura <RoutineInterface6>StartOutput del módulo diag de AUTOSAR Adaptive Platform encapsula todos los argumentos de salida para la operación de inicio de una rutina de diagnóstico. Al recibir una solicitud de inicio, la implementación de rutina específica de la aplicación rellena los campos de datos de la estructura con los valores resultantes y entrega la instancia a la plataforma, presumiblemente embebida en un objeto de retorno asíncrono. Pregunta (abierta) En concordancia con la interpretación, los estados de error no se señalan en la propia estructura de datos, sino a través de códigos de error independientes, por lo que antes de la devolución todos los parámetros de salida requeridos siempre deben estar inicializados de forma completa y coherente.

más ›

Contexto

La estructura <RoutineInterface6>StartOutput forma parte del módulo diag de AUTOSAR Adaptive Platform en el release R25-11. Dentro de este módulo de diagnóstico, el tipo sirve como contenedor de datos que agrupa los argumentos de salida para la operación de inicio de una rutina de diagnóstico. Al ejecutar funciones de diagnóstico mediante control de rutinas, habitualmente interactúan entre sí una implementación de servicio específica de la aplicación y la infraestructura de diagnóstico de la plataforma. La estructura actúa en este contexto en la interfaz entre la implementación concreta de la rutina y la capa de gestión de solicitudes de diagnóstico.

En este conjunto, <RoutineInterface6>StartOutput asume el rol de proporcionar de forma agrupada todos los datos de salida que genera una aplicación al ejecutar el comando de inicio. Interpretación: presumiblemente, la estructura sirve como un mero objeto de transferencia de datos (Data Transfer Object, DTO) sin lógica de negocio propia, cuyos campos miembro específicos se corresponden con los parámetros de salida de la rutina definidos en el modelo de interfaz. Pregunta Q-99209f0267b43982 (abierta) Mediante esta encapsulación se garantiza que la gestión de diagnóstico llamadora pueda recibir de forma conjunta los valores de retorno y acondicionarlos para su posterior procesamiento o para la notificación a testers de diagnóstico externos.

Ciclo de vida

El ciclo de vida de <RoutineInterface6>StartOutput está estrechamente acoplado al contexto de ejecución de la operación de inicio de la rutina de diagnóstico. Una instancia de esta estructura se instancia por la implementación de la rutina ejecutora de la aplicación tan pronto como se procesa una solicitud para iniciar la rutina. Durante el procesamiento, la aplicación asigna a los atributos individuales de la estructura los datos resultantes del proceso de inicio.

En cuanto a las relaciones de propiedad, el control sobre el objeto recae inicialmente a nivel local en la rutina ejecutora. De tener lugar la devolución a la gestión de diagnóstico, esto ocurre típicamente mediante paso por valor o semántica de movimiento, por ejemplo en el contexto de estructuras de retorno asíncronas de la plataforma. Pregunta (abierta) Tras la recepción por parte del entorno de ejecución de la plataforma y el reenvío de los datos a la capa del protocolo de diagnóstico, finaliza el ciclo de vida del objeto, tras lo cual la estructura se destruye y la memoria ocupada se libera. Puesto que la estructura está concebida como un mero contenedor de datos, no posee una máquina de estados interna propia; las fases de vida se limitan a la creación, el rellenado, el retorno y la liberación.

Ruta de uso

La secuencia típica para el uso de <RoutineInterface6>StartOutput se divide en una sucesión fija de pasos dentro del procesamiento de la rutina:

• Inicialización: al recibir una solicitud de inicio, la aplicación proveedora crea una instancia de <RoutineInterface6>StartOutput en la pila o dentro del contexto de ejecución competente.
• Rellenado de los campos de datos: la aplicación lleva a cabo las comprobaciones funcionales y las acciones para poner en marcha la rutina. Los datos de salida determinados en dicho proceso se asignan a los campos de la estructura.
• Respuesta: la estructura completamente rellenada se devuelve al sistema de diagnóstico como resultado de la función. Presumiblemente, la devolución tiene lugar embebida en un contenedor tipificado como ara::core::Result o ara::core::Future, a fin de cumplir con la convención de interfaz asíncrona de Adaptive Platform. Pregunta Q-08976b247fab2180 (abierta)
• Procesamiento por parte de la plataforma: la plataforma lee los valores contenidos, los traslada al telegrama de respuesta de diagnóstico correspondiente y concluye el proceso de tramitación.

Para los desarrolladores de aplicaciones de diagnóstico, la tarea principal consiste en garantizar la asignación correcta y completa de todos los valores de salida requeridos antes de salir del método.

Escenarios de error

Dado que <RoutineInterface6>StartOutput está definida como estructura de datos para parámetros de salida regulares, no encapsula por sí misma códigos de error ni tratamientos de excepciones. Los escenarios de error ocurren sobre todo cuando la rutina no se puede iniciar adecuadamente o se generan valores de salida no válidos.

Interpretación: si falla la ejecución de la operación de inicio, los errores de diagnóstico resultantes probablemente no se transmitan a través de los campos de esta estructura, sino mediante el modelo de errores de la plataforma, por ejemplo mediante códigos de error estandarizados en ara::core::ErrorCode. Pregunta Q-fe76c79ba073f321 (abierta) La precondición para el uso satisfactorio de la estructura es que la acción desencadenante de inicio fuera admisible y se cumplan las condiciones exigidas para la ejecución de la rutina. Como poscondición rige que todos los parámetros de salida de la estructura declarados en la interfaz se dejen en un estado válido y consistente antes de realizarse la entrega al sistema de diagnóstico.