clase ara::diag::DoIPPowerMode

La clase de interfaz ara::diag::DoIPPowerMode permite a las aplicaciones proporcionar el modo de energía DoIP actual a Diagnostic Management a través de la función de callback GetDoIPPowerMode() [SWS_DM_00734]. Tras la instanciación, el manejador debe activarse mediante Offer() y desregistrarse nuevamente mediante StopOffer() antes de su destrucción [SWS_DM_00735], [SWS_DM_00736]. Al ser una instancia única, la clase no se puede copiar ni mover [SWS_DM_01645].

más ›

Contexto

La clase abstracta ara::diag::DoIPPowerMode define la interfaz para proporcionar el modo de energía DoIP actual a Diagnostic Management (DM). En arquitecturas de vehículos que utilizan diagnóstico sobre el protocolo de Internet (DoIP), el protocolo de comunicación debe estar informado sobre el estado operativo de la red del vehículo o el suministro de tensión. El software de aplicación deriva una clase de manejador concreta a partir de ara::diag::DoIPPowerMode e implementa la consulta del modo de energía [SWS_DM_00734]. Los interlocutores son la aplicación de diagnóstico proveedora, que ofrece la interfaz, y el sistema de tiempo de ejecución de DM, que delega las solicitudes entrantes en este manejador [SWS_DM_00735].

Ciclo de vida

Las instancias de ara::diag::DoIPPowerMode se crean internamente en la aplicación y se identifican mediante un prototipo de puerto al que hace referencia un ara::core::InstanceSpecifier [SWS_DM_00732]. Al llamar al constructor, el argumento ConcurrencyType determina si el método de callback GetDoIPPowerMode() debe ejecutarse de forma segura para subprocesos (kConcurrent) o no segura para subprocesos (kNotConcurrent) [SWS_DM_00732]. El constructor en sí está diseñado de forma segura para subprocesos [SWS_DM_00732].

Según la especificación, se trata de una instancia que no se puede copiar ni mover: tanto el constructor de copia [SWS_DM_01645] como el constructor de movimiento [SWS_DM_01646], así como los correspondientes operadores de asignación [SWS_DM_01643], [SWS_DM_01644], están explícitamente eliminados (=delete).

Tras la instanciación, el manejador debe activarse a través de Offer() para que DM pueda reenviar las solicitudes [SWS_DM_00735]. Para finalizar el reenvío de solicitudes, se llama a StopOffer() [SWS_DM_00736]. El destructor virtual ~DoIPPowerMode() [SWS_DM_00733], así como Offer() y StopOffer(), están especificados como no seguros para subprocesos. Presumiblemente, siempre debería ejecutarse StopOffer() antes de llamar al destructor para desconectar adecuadamente las interacciones pendientes con DM. Pregunta Q-85ede935aa303c45 (abierta)

Ruta de uso

El uso típico de ara::diag::DoIPPowerMode sigue una secuencia fija de inicialización, registro del servicio, consulta de modo cíclica o basada en eventos y desregistro:

1. La aplicación instancia su clase derivada con el InstanceSpecifier adecuado y el ConcurrencyType deseado [SWS_DM_00732].
2. La aplicación registra activamente el manejador en Diagnostic Management mediante Offer() [SWS_DM_00735].
3. Tan pronto como el protocolo DoIP requiere el estado, DM llama a la función virtual pura GetDoIPPowerMode() [SWS_DM_00734]. La implementación devuelve un ara::core::Future<PowerModeType>, que se resuelve de forma asíncrona [SWS_DM_00734].
4. Al finalizar el funcionamiento, la aplicación llama a StopOffer() para no aceptar más solicitudes [SWS_DM_00736].
5. La instancia se libera a través del destructor [SWS_DM_00733].

Diagrama de secuencia: flujo típico de registro, consulta de estado asíncrona y desregistro para DoIPPowerMode. Fuentes: [SWS_DM_00732], [SWS_DM_00734], [SWS_DM_00735], [SWS_DM_00736], AUTOSAR_AP_SWS_Diagnostics §8.2 «DoIP Power Mode».

Escenarios de error

Al llamar al constructor pueden producirse infracciones de modelo y de asignación que están documentadas [SWS_DM_00732]:

• InstanceSpecifierMappingIntegrityViolation: el identificador no se puede resolver en el contexto del ejecutable o no hace referencia a un elemento PortPrototype [SWS_DM_00732].
• PortInterfaceMappingViolation: el PortPrototype referenciado no está tipificado mediante un DiagnosticDoIPPowerModeInterface [SWS_DM_00732].
• ProcessMappingViolation: existe una referencia de instancia, pero ningún proceso modelado adecuado para el entorno de tiempo de ejecución [SWS_DM_00732].
• InstanceSpecifierAlreadyInUseViolation: el InstanceSpecifier ya se ha utilizado para otra instancia dentro del mismo proceso [SWS_DM_00732].

Si se llama a Offer() mientras el servicio ya se está ofreciendo activamente, el método devuelve el código de error DiagOfferErrc::kAlreadyOffered a través de ara::core::Result [SWS_DM_00735]. En cambio, el método GetDoIPPowerMode() no define códigos de error estandarizados [SWS_DM_00734].