estructura ara::diag::DoIPEntityIdentification::EntityId

La estructura ara::diag::DoIPEntityIdentification::EntityId sirve como contenedor de datos para el identificador de entidad (EID) de seis bytes de una instancia DoIP según ISO 13400-2 ([SWS_DM_01496]). Con la configuración correspondiente, el Diagnostic Manager recupera este identificador desde la aplicación adaptativa mediante el método ara::diag::DoIPEntityIdentification::GetEntityId para incrustarlo en mensajes del protocolo DoIP, tales como el anuncio de vehículo ([SWS_DM_01361]). Si la interfaz aún no estuviera disponible o la recuperación fallara, se recurre obligatoriamente como condición de contorno a un valor de sustitución fijo compuesto en su totalidad por bytes con el valor 0xFF ([SWS_DM_01528]).

más ›

Contexto

La estructura de datos ara::diag::DoIPEntityIdentification::EntityId sirve para la representación del identificador de entidad estandarizado (Entity Identification, EID) para la comunicación de diagnóstico sobre el protocolo de Internet (DoIP) según ISO 13400-2 ([SWS_DM_01496], AUTOSAR_AP_SWS_Diagnostics §8.33 «Header: ara/diag/doip_entity_identification.h»). Dentro de AUTOSAR Adaptive Platform está definida como un tipo de estructura público dentro de la clase de API ara::diag::DoIPEntityIdentification ([SWS_DM_01362], [SWS_DM_01496]).

Su responsabilidad principal consiste en la encapsulación del valor de identificación de exactamente seis bytes de longitud de una entidad DoIP ([SWS_DM_01496]). En la arquitectura de la plataforma interactúan tres actores principales: en primer lugar, la aplicación adaptativa, que gestiona el identificador de entidad o lo lee desde el hardware. En segundo lugar, la clase de interfaz ara::diag::DoIPEntityIdentification, que ofrece el método para proporcionar el identificador ([SWS_DM_01362]). En tercer lugar, el Diagnostic Manager (DM), que recupera el EID en el marco de la identificación del vehículo para mensajes DoIP salientes ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Diagrama de contexto: integración de EntityId entre Diagnostic Manager, clase de interfaz y aplicación adaptativa. Fuentes: [SWS_DM_01361], [SWS_DM_01496].

Ciclo de vida

Como estructura de datos con el único miembro entityIdentification de tipo ara::core::Array<std::uint8_t, 6>, EntityId presenta las propiedades de un objeto de valor ligero de C++ ([SWS_DM_01496]). Interpretación: ante la ausencia de asignación dinámica de recursos, es de esperar que la estructura admita de forma predeterminada operaciones regulares de copia y movimiento y no esté sujeta a transiciones de estado internas complejas. Pregunta Q-4a6f7d6e7368b436 (abierta)

La instanciación de EntityId la realiza la aplicación adaptativa en cuanto el Diagnostic Manager solicita los datos de identidad a través de la llamada a ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]). El tiempo de vida de una instancia está vinculado típicamente al ciclo de retorno y procesamiento de la llamada al método. Mientras que la clase de servicio envolvente ara::diag::DoIPEntityIdentification dispone de constructores ([SWS_DM_01364], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.2.1 «DoIPEntityIdentification») y destructores ([SWS_DM_01365], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.1.1 «Destructor») explícitos, el objeto de valor EntityId se libera automáticamente al salir del ámbito tras la lectura de los datos de campo por parte del Diagnostic Manager.

Ruta de uso

El uso regular de EntityId sigue una secuencia definida en el flujo del protocolo de diagnóstico:

• Comprobación de la configuración: el Diagnostic Manager comprueba el atributo DoIpNetworkConfiguration.eidRetrieval. Si allí se ha configurado DoIpEidRetrievalEnum.eidUseApi, el DM debe recuperar obligatoriamente el identificador a través de la API ([SWS_DM_01361]).
• Recuperación por API: el Diagnostic Manager invoca el método ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]).
• Provisión de datos: la aplicación crea una instancia de EntityId, completa el miembro entityIdentification con el identificador de 6 bytes según ISO 13400-2 ([SWS_DM_01496]) y entrega la estructura.
• Uso en el protocolo: el Diagnostic Manager extrae el identificador y lo inserta en mensajes DoIP tales como el anuncio de vehículo (Vehicle Announcement Message) ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Diagrama de secuencia: flujo de recuperación y procesamiento posterior de EntityId incluyendo la alternativa por fallo. Fuentes: [SWS_DM_01361], [SWS_DM_01496], [SWS_DM_01528].

Escenarios de error

Un escenario de fallo central se produce cuando la aplicación adaptativa aún no ofrece la interfaz ara::diag::DoIPEntityIdentification en el momento de consulta requerido o cuando la recuperación a través de GetEntityId falla ([SWS_DM_01528], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Para no bloquear permanentemente el envío de mensajes DoIP, la especificación prescribe en este caso un comportamiento de valor de sustitución vinculante: el Diagnostic Manager debe transmitir, en lugar de los datos regulares de la aplicación, un campo EID de 6 bytes con el valor fijo 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF ([SWS_DM_01528]). A nivel de tipos, el array fijo ara::core::Array<std::uint8_t, 6> descarta errores de longitud y desbordamientos de búfer en tiempo de compilación ([SWS_DM_01496]).