clase ara::diag::CommunicationControl

La clase ara::diag::CommunicationControl sirve en AUTOSAR Adaptive como interfaz para procesar el servicio UDS 0x28 (CommunicationControl) destinado a la conmutación de canales de comunicación [SWS_DM_00808]. Tras la instanciación basada en modelos a través de un InstanceSpecifier, Offer() activa el reenvío de solicitudes por parte del Diagnostic Manager, las cuales se procesan posteriormente de forma asíncrona mediante CommCtrlRequest [SWS_DM_00806], [SWS_DM_00809]. Al tratarse de una instancia única estricta, la clase excluye operaciones de copia y de movimiento, y exige una desregistración mediante StopOffer() antes de finalizar [SWS_DM_00810].

más ›

Contexto

La clase ara::diag::CommunicationControl define la interfaz estandarizada para la gestión del servicio de diagnóstico UDS 0x28 (CommunicationControl) en la AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics, p. 70. Como clase base abstracta, actúa de intermediaria entre el Diagnostic Manager (DM) y la funcionalidad de diagnóstico específica de la aplicación con la que se controla el envío o la recepción de determinados mensajes de comunicación en la red del vehículo. El software de aplicación deriva de esta clase e implementa el método puramente virtual CommCtrlRequest para recibir y ejecutar instrucciones de control entrantes [SWS_DM_00808]. La vinculación con el modelo de sistema de AUTOSAR se realiza mediante un ara::core::InstanceSpecifier, el cual referencia un PortPrototype de un DiagnosticComControlInterface [SWS_DM_00806].

Ciclo de vida

Una instancia se crea explícitamente a través del constructor indicando el ara::core::InstanceSpecifier y el modelo de concurrencia ConcurrencyType (kConcurrent o kNotConcurrent) [SWS_DM_00806]. La clase cuenta con una semántica estricta de instancia única y no es copiable ni movible: tanto el constructor de copia [SWS_DM_01677] y el constructor de movimiento [SWS_DM_01678] como el operador de asignación por copia [SWS_DM_01675] y el operador de asignación por movimiento [SWS_DM_01676] están eliminados (=delete).

Tras su creación, la instancia permanece inicialmente inactiva. Solo mediante la llamada a Offer() se autoriza al Diagnostic Manager a reenviar las solicitudes de diagnóstico entrantes al manejador [SWS_DM_00809]. A la inversa, StopOffer() revoca esta autorización y desactiva el reenvío [SWS_DM_00810]. La destrucción se lleva a cabo mediante el destructor virtual [SWS_DM_00807]. Interpretación: es probable que sea necesario llamar a StopOffer() antes de destruir el objeto para que el Diagnostic Manager no mantenga reenvíos huérfanos. Pregunta Q-f67e35c9fea508d8 (abierta)

En cuanto a la concurrencia, el constructor es seguro para subprocesos (thread-safe) [SWS_DM_00806], mientras que el destructor [SWS_DM_00807], Offer() [SWS_DM_00809] y StopOffer() [SWS_DM_00810] no son seguros para subprocesos. La ejecución de CommCtrlRequest es condicionalmente segura para subprocesos (conditional): el ConcurrencyType establecido en el constructor determina si la implementación debe ser segura para subprocesos [SWS_DM_00808].

Ruta de uso

El flujo regular comprende la instanciación de la clase derivada, el registro del servicio, el procesamiento asíncrono de solicitudes de diagnóstico y la desregistración final:

1. Inicialización: La aplicación instancia el manejador indicando el InstanceSpecifier y el ConcurrencyType deseado [SWS_DM_00806].
2. Oferta de servicio: Mediante Offer() se habilita el servicio en el Diagnostic Manager [SWS_DM_00809].
3. Procesamiento de solicitudes: Si llega una solicitud UDS para el servicio 0x28 con cualquier subfunción, el Diagnostic Manager llama a CommCtrlRequest [SWS_DM_00808]. Los parámetros comprenden:
   • controlType (ComCtrlRequestParamsType): Todos los parámetros de solicitud UDS, incluidos los elementos opcionales.
   • metaInfo (const MetaInfo&): Metainformación sobre la solicitud de diagnóstico.
   • cancellationHandler (CancellationHandler): Sirve para la consulta de estado mediante IsCanceled(), así como para el registro de una función de devolución de llamada (callback) de cancelación vía SetNotifier().
4. Respuesta: El procesamiento finaliza de forma asíncrona y notifica el resultado mediante ara::core::Future<void> [SWS_DM_00808].
5. Desregistración: Antes de apagar o finalizar, la aplicación detiene el reenvío mediante StopOffer() [SWS_DM_00810].

Diagrama de secuencias: Flujo típico desde la inicialización y el procesamiento de la solicitud UDS 0x28 hasta la desregistración. Fuentes: [SWS_DM_00806], [SWS_DM_00808], [SWS_DM_00809], [SWS_DM_00810].

Escenarios de error

Ya durante la construcción, las incoherencias en el modelo AUTOSAR pueden provocar violaciones en tiempo de ejecución (violations) [SWS_DM_00806]:

• InstanceSpecifierMappingIntegrityViolation: El InstanceSpecifier no se puede resolver en el contexto del ejecutable o no apunta a un PortPrototype.
• PortInterfaceMappingViolation: El PortPrototype tipificado por DiagnosticComControlInterface no está referenciado por un DiagnosticServiceGenericMapping.
• ProcessMappingViolation: Existe una referencia de instancia coincidente, pero no hay ningún proceso modelado que coincida con el proceso actual.
• InstanceSpecifierAlreadyInUseViolation: el identificador ya está siendo utilizado en el mismo proceso por otra instancia.

Durante el funcionamiento normal, Offer() notifica mediante el valor de retorno ara::core::Result<void> el error DiagOfferErrc::kAlreadyOffered en caso de que el servicio ya se haya ofrecido con anterioridad y aún se encuentre activo [SWS_DM_00809]. Si una solicitud de diagnóstico no se puede satisfacer técnicamente en CommCtrlRequest, el método devuelve un Negative Response Code (NRC) conforme a ISO 14229-1 a través del ara::core::Future<void> mediante DiagUdsNrcErrc [SWS_DM_00808].