clase ara::diag::DownloadService

usar

El método [SWS_DM_00790] se llama para procesar datos para el servicio UDS TransferData (0x36) tras una petición de descarga iniciada previamente (AUTOSAR_AP_SWS_Diagnostics §8.14.1.1.3.1 «DownloadData»). La ejecución se realiza de forma asíncrona a través de ara::core::Future<OperationOutput>.

Como entradas se pasan un ara::core::Span<const std::uint8_t> con los datos que se van a transferir (transferRequestParameterRecord), datos de contexto vía MetaInfo, así como un CancellationHandler. Los datos útiles siguen siendo válidos hasta que se cumpla la promesa o se cancele la operación. En caso de conclusión con éxito, los datos de respuesta se almacenan en OperationOutput.responseData y se ubican detrás del contador correlativo de bloques en el mensaje de respuesta positiva [SWS_DM_00786].

Manejo de errores

Si se produce un error durante el procesamiento, la promesa se concluye con un ErrorCode adecuado procedente de DiagUdsNrcErrc (NRC según ISO 14229-1) como respuesta negativa UDS [SWS_DM_00790].

Concurrencia y restricciones

La función está declarada como noexcept. Si la implementación debe ejecutarse de forma segura frente a hilos se determina de manera condicional mediante el ConcurrencyType pasado en el constructor [SWS_DM_00790]. A través del CancellationHandler se puede consultar el estado de cancelación (IsCanceled) o registrar un callback de notificación vía SetNotifier.

Interacción

La operación materializa el procesamiento de TransferData [SWS_DM_00137] después de que previamente se haya iniciado la sesión de descarga mediante RequestDownload (0x34) [SWS_DM_00869]. Presumiblemente, la entrega de los bloques de datos se realiza de forma secuencial conforme al orden de la sesión UDS. Pregunta Q-fe18230bf7fcdf47 (abierta)

El método Offer de la clase ara::diag::DownloadService habilita el reenvío de solicitudes de descarga entrantes por parte del daemon de Diagnostic Management (DM) al handler específico [SWS_DM_00792]. La llamada se realiza de forma síncrona y sin parámetros, sin desencadenar excepciones de C++ (noexcept) [SWS_DM_00792]. Habitualmente, la puesta a disposición suele llamarse durante la fase de inicialización de la aplicación de procesamiento, antes de que lleguen solicitudes de diagnóstico externas. Pregunta Q-0180c707edea0eec (abierta)

Como valor de retorno, la función proporciona un ara::core::Result<void> [SWS_DM_00792]. Si el registro se realizó con éxito, el resultado está vacío. Si el servicio ya se había ofrecido al DM con anterioridad, la operación falla con el código de error DiagOfferErrc::kAlreadyOffered, garantizándose una semántica de reversión [SWS_DM_00792].

En cuanto a concurrencia y seguridad, se aplican las siguientes condiciones:

• Seguridad frente a subprocesos: La función está clasificada como no segura para subprocesos (not thread-safe) [SWS_DM_00792]; las llamadas paralelas en la misma instancia del servicio deben sincronizarse por parte de la aplicación.
• Seguridad frente a excepciones: La interfaz está especificada como segura frente a excepciones (exception safe) [SWS_DM_00792].

El patrón mediante Offer responde al procedimiento uniforme para servicios de diagnóstico en AUTOSAR Adaptive, tal y como se define análogamente también para UploadService [SWS_DM_00802], SecurityAccess [SWS_DM_00766] o servicios UDS genéricos [SWS_DM_00619]. A pesar de coincidir en el nombre con otros subsistemas, se trata de una implementación de diagnóstico específica AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

usar

El método RequestDownload de la clase ara::diag::DownloadService es llamado por la Diagnostic Server instance para procesar el servicio UDS 0x34 (RequestDownload) según [SWS_DM_00128] y [SWS_DM_00867]. Acepta dataFormatIdentifier, addressAndLengthFormatIdentifier, el rango de memoria memoryAddressAndSize, metaInfo así como un cancellationHandler [SWS_DM_00789]. El procesamiento se realiza de forma asíncrona y devuelve un ara::core::Future<void>; la validez de los datos en memoryAddressAndSize se mantiene hasta que se cumpla la promise asociada o se cancele el proceso [SWS_DM_00789].

Manejo de errores

En caso de éxito, el future se establece a void, lo que da lugar a una respuesta positiva, tras lo cual se notifica un evento de seguridad SEV_UDS_REQUEST_UP_DOWNLOAD_SUCCESSFUL al IdsM [SWS_DM_02031]. Si la solicitud falla, el future debe completarse con un código de error adecuado de DiagUdsNrcErrc según la norma ISO 14229-1 [SWS_DM_00789].

Concurrencia e interacción

El método está especificado como exception safe, mientras que la seguridad de hilos es condicional y depende del ConcurrencyType pasado en el constructor [SWS_DM_00789]. A través de cancellationHandler.IsCanceled() o de un notificador registrado mediante cancellationHandler.SetNotifier se puede procesar una cancelación de la conversación [SWS_DM_00789]. Tras la ejecución exitosa de RequestDownload se continúa típicamente con la transferencia de los datos mediante DownloadData [SWS_DM_00790]. Interpretación: Es de suponer que la aplicación implementadora valide la validez de la dirección y el tamaño de la memoria antes de cumplir el future, tal como sugiere el contexto para servicios UDS relacionados con la memoria AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.2 «Common service processing items». Pregunta Q-728d2e5f7d09e605 (abierta)

El método RequestDownloadExit de la clase ara::diag::DownloadService es llamado por la instancia del servidor de diagnóstico para procesar el servicio UDS RequestTransferExit (0x37) en el marco de una secuencia de descarga ([SWS_DM_00141], [SWS_DM_00871], SWS Diagnostics §7.3.2.8.19 «Service 0x37 – RequestTransferExit»).

En la llamada se pasan los siguientes parámetros ([SWS_DM_00791]):

• transferRequestParameterRecord: Un ara::core::Span<const std::uint8_t> con parámetros específicos del fabricante del vehículo para dar soporte a la transferencia de datos. La validez de esta memoria se mantiene hasta que se cumpla la promise asociada o se cancele el procesamiento.
• metaInfo: Metainformación sobre la solicitud de diagnóstico.
• cancellationHandler: Sirve para consultar el estado mediante cancellationHandler.IsCanceled() así como para registrar una función de notificación a través de cancellationHandler.SetNotifier().

La función trabaja de forma asíncrona y devuelve un ara::core::Future<OperationOutput> ([SWS_DM_00791]). En caso de éxito, el future se cumple con OperationOutput; los datos contenidos en OperationOutput::responseData ([SWS_DM_00786]) se incrustan como transferResponseParameterRecord en la respuesta positiva tras el ID de servicio ([SWS_DM_00791]).

Si se produce un error, el future debe completarse con un código de error adecuado de DiagUdsNrcErrc (Negative Response Code según ISO 14229-1) ([SWS_DM_00791]). La interfaz está especificada como noexcept; su seguridad de hilos es condicional y se determina a través del ConcurrencyType en la creación del objeto ([SWS_DM_00791]).

Uso y contexto de llamada

La función StopOffer de la clase ara::diag::DownloadService (AUTOSAR_AP_SWS_Diagnostics §8.14.1.1.3.5 «StopOffer», [SWS_DM_00793]) sirve para desactivar el reenvío de mensajes de solicitud de diagnóstico entrantes desde Diagnostic Management (DM) a la instancia de servicio. La interfaz síncrona posee la firma void StopOffer () noexcept;, no recibe parámetros y no devuelve ningún valor ([SWS_DM_00793]). La llamada se realiza a través de la cabecera #include "ara/diag/download.h" ([SWS_DM_00793]).

Tratamiento de errores y concurrencia

En cuanto al tratamiento de errores, el método está declarado como seguro frente a excepciones (exception safe) y con noexcept; no se lanzan excepciones ni se generan códigos de error ([SWS_DM_00793]). En lo respectivo a la concurrencia, StopOffer no es seguro para hilos (not thread-safe) ([SWS_DM_00793]). Por consiguiente, las llamadas simultáneas desde varios hilos sobre la misma instancia deben sincronizarse del lado de la aplicación.

Interacción en el sistema de diagnóstico

La desactivación de servicios mediante StopOffer sigue un patrón uniforme dentro de AUTOSAR Adaptive: para los servicios de carga existe la contraparte funcional ara::diag::UploadService::StopOffer ([SWS_DM_00803]), así como métodos análogos para CommunicationControl ([SWS_DM_00810]), Authentication ([SWS_DM_01131]) y EcuResetRequest ([SWS_DM_01017]). La nomenclatura se basa en las convenciones de la plataforma, pero representa una implementación de diagnóstico independiente (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»). Interpretación: tras la llamada a StopOffer, es de suponer que el DM ya no reenvíe ni descarte las solicitudes de descarga UDS entrantes hasta que el servicio se ofrezca de nuevo. Pregunta Q-a45cc70b6ae09431 (abierta)