clase <RoutineInterface-Namespace>::<RoutineInterface>

La función constructora [SWS_DM_00589] sirve para la instanciación de una interfaz de rutina (DiagnosticRoutine) mediante un identificador de instancia. La declaración está especificada como noexcept y se considera segura frente a excepciones (exception safe), así como segura para subprocesos (thread-safe) SWS Diagnostics §8.30.2.2.1.8 «{<routine-interface-name-1>}».

Parámetros y llamada

• instanceSpec (ara::core::InstanceSpecifier): identificador de la instancia de servicio específica que está vinculada a un puerto del modelo adecuado.
• concurrencyType (ara::diag::ConcurrencyType): determina si la interfaz se ejecuta de forma concurrente o segura para subprocesos (kConcurrent) o si no es segura para subprocesos (kNotConcurrent).

Comprobaciones de tiempo de ejecución y del modelo

Durante la construcción, el framework verifica la configuración del modelo y del proceso. En caso de asignaciones erróneas o reutilizaciones, se desencadenan infracciones (Violations) específicas [SWS_DM_00589]:

• InstanceSpecifierMappingIntegrityViolation: El InstanceSpecifier no se puede resolver en el contexto del ejecutable o no apunta a un PortPrototype.
• PortInterfaceMappingViolation: un PortPrototype tipificado por DiagnosticRoutineInterface no está referenciado por un DiagnosticServiceGenericMapping.
• ProcessMappingViolation: para la referencia de instancia existente no existe ningún proceso modelado coincidente en tiempo de ejecución.
• InstanceSpecifierAlreadyInUseViolation: el InstanceSpecifier especificado ya está siendo utilizado por una instancia existente dentro del proceso actual.

Uso y semántica

El método Offer habilita Diagnostic Management (DM) para reenviar solicitudes de diagnóstico entrantes al manejador de rutinas correspondiente [SWS_DM_00594]. La llamada se realiza de forma síncrona y sin parámetros a través de la interfaz tipificada de la rutina, y no lanza excepciones (noexcept) [SWS_DM_00594]. Como tipo de retorno sirve ara::core::Result<void>, por lo que o bien se señaliza la finalización correcta o bien se devuelve un código de error en caso de fallo [SWS_DM_00594].

Manejo de errores

Si se llama a Offer para una instancia de rutina que ya se proporcionó de forma activa al DM, el registro falla. En este caso, el método devuelve el código de error DiagOfferErrc::kAlreadyOffered con semántica de reversión [SWS_DM_00594] (definido con el valor 101 en el contexto general del dominio de errores de diagnóstico [SWS_DM_00514]).

Concurrencia y restricciones

Aunque la función está especificada como segura frente a excepciones (exception safe), está declarada expresamente como no segura para subprocesos (not thread-safe) [SWS_DM_00594]. Múltiples llamadas sobre la misma instancia no deben ejecutarse de forma concurrente sin protección. Dado que la especificación no contempla un uso concurrente, el registro típicamente debería realizarse de forma síncrona durante la fase de inicialización de la aplicación de procesamiento. Pregunta Q-6a0f15497f03ac09 (abierta)

Interacción en el módulo de diagnóstico

El patrón de provisión a través de Offer está unificado en la gestión de diagnóstico de AUTOSAR en diversos tipos de interfaz; por ejemplo, en rutinas genéricas [SWS_DM_00557], elementos de datos [SWS_DM_00597], identificadores de datos [SWS_DM_00599], así como servicios UDS genéricos [SWS_DM_00619]. Aunque la nomenclatura se basa en ara::com, se trata de una funcionalidad específica de diagnóstico que no debe confundirse con la intermediación general de servicios AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

usar

El método de interfaz RequestResult sirve para proporcionar la funcionalidad RoutineControl para consultar resultados de rutinas dentro de una interfaz de diagnóstico tipificada [SWS_DM_00593]. En la llamada para procesar la subfunción UDS requestRoutineResults (servicio 0x31, véase [SWS_DM_00575]), se pasan los argumentos de entrada ordenados del ArgumentDataPrototype correspondiente, metainformación a través de metaInfo y un cancellationHandler AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 «RequestResult».

Mediante el objeto cancellationHandler, la implementación puede comprobar activamente a través de IsCanceled si la conversación de diagnóstico en curso se ha cancelado, o bien registrar a través de SetNotifier una función de notificación a la que se llamará en caso de cancelación [SWS_DM_00593]. La ejecución se realiza de forma asíncrona y devuelve un ara::core::Future que, en caso de éxito, contiene el objeto de resultado según [SWS_DM_00583] [SWS_DM_00593].

Manejo de errores

Si se produce un error durante el procesamiento, el ara::core::Future se resuelve con un error correspondiente. Esto incluye códigos de respuesta negativa (NRC según ISO 14229-1) a través de ara::diag::DiagUdsNrcErrc o errores específicos de la aplicación a través de Ap ApplicationError [SWS_DM_00593].

Concurrencia y restricciones

El método está declarado como noexcept y se considera seguro frente a excepciones (exception safe), pero expresamente no es seguro para subprocesos (not thread-safe) AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 «RequestResult». Debido a esta clasificación, es de suponer que el componente llamador sea responsable de una sincronización adecuada en llamadas paralelas sobre la misma instancia. Pregunta Q-aa5788303ddff2bc (abierta)

La función virtual pura Start en el ámbito de clase <RoutineInterface-Namespace>::<RoutineInterface> sirve para proporcionar una operación RoutineControl en el rol Start para rutinas de diagnóstico específicas del modelo ([SWS_DM_00591]). Se declara a través del encabezado <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h ([SWS_DM_00591]). La llamada transmite los argumentos de entrada ordenados de la rutina respectiva, información de contexto de diagnóstico a través de metaInfo, así como el objeto cancellationHandler para el control de cancelaciones de conversación ([SWS_DM_00591]).

A través del parámetro cancellationHandler, la implementación puede verificar con cancellationHandler.IsCanceled si la conversación asociada se ha cancelado, devolviendo TRUE en caso de cancelación y FALSE en caso contrario ([SWS_DM_00591]). De forma complementaria, con cancellationHandler.SetNotifier se puede registrar una función de notificación que se activa en caso de cancelación ([SWS_DM_00591]). El retorno asíncrono se produce a través de un ara::core::Future, que en caso de éxito proporciona el objeto de resultado generado StartOutput conforme a [SWS_DM_00581] ([SWS_DM_00591]).

En caso de error, el ara::core::Future debe completarse con un Negative Response Code (NRC) adecuado de ara::diag::DiagUdsNrcErrc conforme a ISO 14229-1 o un ApplicationError específico de la aplicación ([SWS_DM_00591]). El método está especificado como noexcept y exception safe, pero se considera not thread-safe ([SWS_DM_00591]). Interpretación: De la clasificación como not thread-safe es probable que se deduzca que las llamadas concurrentes a la misma instancia deban sincronizarse externamente. Pregunta Q-124d8076818ac2e1 (abierta) Mientras que esta interfaz atiende a rutinas generadas específicamente a partir del modelo, GenericRoutine::Start ofrece el equivalente funcional para rutinas de diagnóstico tratadas de forma genérica ([SWS_DM_00554]).

El método Stop sirve para proporcionar la funcionalidad RoutineControl para detener una rutina de diagnóstico dentro de una interfaz de rutinas tipificada ([SWS_DM_00592]). Es de prever que una llamada sea desencadenada típicamente por el demonio del Diagnostic Management al recibir una solicitud de diagnóstico UDS correspondiente (subfunción 0x02), de manera análoga a la contraparte genérica [SWS_DM_00555]. Pregunta Q-cd626f527c6dfe92 (abierta)

La llamada se realiza de forma asíncrona y devuelve un ara::core::Future ([SWS_DM_00592]):

• Parámetros: además de los argumentos de entrada específicos del modelo {<routine-interface-stop-in-arg-symbol-0toN>}, se pasan metainformaciones de la solicitud (metaInfo), así como un cancellationHandler ([SWS_DM_00592]). A través de cancellationHandler, la implementación puede consultar activamente una cancelación mediante IsCanceled o registrar una notificación con SetNotifier en caso de que la conversación de diagnóstico se cancele.
• Valor de retorno: en caso de detención exitosa, el Future proporciona un objeto StopOutput tipificado ([SWS_DM_00582]).

Tratamiento de errores: si la detención falla, el Future devuelto contiene un código de respuesta negativa (NRC) aplicable según la norma ISO 14229-1 mediante ara::diag::DiagUdsNrcErrc o un Ap ApplicationError específico del modelo ([SWS_DM_00592]).

Concurrencia y restricciones: la función está especificada como exception safe, pero explícitamente como not thread-safe ([SWS_DM_00592]). Las llamadas múltiples o concurrentes en la misma instancia de la interfaz deben ser coordinadas por el emisor de la llamada, y la rutina debe liberar los recursos que correspondan o reaccionar a las solicitudes de cancelación del manejador.

El método StopOffer en el ámbito de <RoutineInterface> sirve para desactivar el reenvío de mensajes de solicitud de diagnóstico desde Diagnostic Management (DM) a la implementación de la rutina [SWS_DM_00595]. La función no tiene parámetros de entrada y no devuelve ningún valor [SWS_DM_00595].

• Uso y contexto de llamada: La llamada se realiza de forma síncrona para anular el registro de la interfaz de rutina en el DM. La declaración se realiza en el archivo de cabecera <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h [SWS_DM_00595]. Aunque la denominación se basa en los métodos de servicio de ara::com, se trata de una API específica de diagnóstico del DM que no debe confundirse con la gestión de comunicación (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»).
• Tratamiento de fallos: La operación está declarada como noexcept y clasificada como segura frente a excepciones (exception safe) [SWS_DM_00595]. Para este método no se definen códigos de error ni mensajes de fallo específicos.
• Concurrencia y restricciones: La función está especificada como no segura para subprocesos (not thread-safe) [SWS_DM_00595]; por lo tanto, las llamadas sobre la misma instancia requieren sincronización externa. Interpretación: Los invocadores tendrían que finalizar de forma ordenada las ejecuciones de rutinas en curso antes de la llamada, ya que el estándar solo describe la desactivación del mecanismo de reenvío. Pregunta Q-b0f524c0f2d7af52 (abierta)
• Interacción: El patrón de provisión y cancelación de registro se corresponde con el enfoque estandarizado en Diagnostic Management, tal como se prescribe de forma análoga para rutinas genéricas [SWS_DM_00558], servicios UDS genéricos [SWS_DM_00620] e identificadores de datos [SWS_DM_00600].