estrutura ara::diag::DoIPEntityIdentification::EntityId

A estrutura ara::diag::DoIPEntityIdentification::EntityId serve de contentor de dados para o identificador de entidade (EID) de seis bytes de uma instância DoIP de acordo com a ISO 13400-2 ([SWS_DM_01496]). Com a configuração correspondente, o Diagnostic Manager obtém este identificador da aplicação adaptativa através do método ara::diag::DoIPEntityIdentification::GetEntityId, para o incorporar em mensagens de protocolo DoIP, tais como o anúncio de veículo ([SWS_DM_01361]). Se a interface ainda não estiver disponível ou a obtenção falhar, aplica-se, como condição limite obrigatória, um recurso ao valor de substituição fixo composto exclusivamente por bytes com o valor 0xFF ([SWS_DM_01528]).

mais ›

Contexto

A estrutura de dados ara::diag::DoIPEntityIdentification::EntityId serve para representar o identificador de entidade padronizado (Entity Identification, EID) para a comunicação de diagnóstico através do protocolo de Internet (DoIP) de acordo com a ISO 13400-2 ([SWS_DM_01496], AUTOSAR_AP_SWS_Diagnostics §8.33 «Header: ara/diag/doip_entity_identification.h»). Dentro da AUTOSAR Adaptive Platform, está definida como um tipo de estrutura público dentro da classe de API ara::diag::DoIPEntityIdentification ([SWS_DM_01362], [SWS_DM_01496]).

A sua responsabilidade primária consiste no encapsulamento do valor de identificação de exatamente seis bytes de uma entidade DoIP ([SWS_DM_01496]). Na arquitetura da plataforma, três intervenientes principais interagem neste processo: em primeiro lugar, a aplicação adaptativa, que gere o identificador de entidade ou o lê do hardware. Em segundo lugar, a classe de interface ara::diag::DoIPEntityIdentification, que disponibiliza o método para fornecimento do identificador ([SWS_DM_01362]). Em terceiro lugar, o Diagnostic Manager (DM), que obtém o EID no âmbito da identificação do veículo para mensagens DoIP de saída ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Diagrama de contexto: integração de EntityId entre Diagnostic Manager, classe de interface e aplicação adaptativa. Fontes: [SWS_DM_01361], [SWS_DM_01496].

Ciclo de vida

Como estrutura de dados com o único membro entityIdentification do tipo ara::core::Array<std::uint8_t, 6>, EntityId apresenta as propriedades de um objeto de valor C++ leve ([SWS_DM_01496]). Interpretação: na ausência de alocação dinâmica de recursos, a estrutura deverá suportar por padrão operações regulares de cópia e movimento e não estar sujeita a transições de estado internas complexas. Pergunta Q-4a6f7d6e7368b436 (aberta)

A instanciação de EntityId é realizada pela aplicação adaptativa assim que o Diagnostic Manager consulta os dados de identidade através da chamada de ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]). O tempo de vida de uma instância está tipicamente vinculado ao ciclo de retorno e processamento da chamada de método. Enquanto a classe de serviço envolvente ara::diag::DoIPEntityIdentification dispõe de construtores ([SWS_DM_01364], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.2.1 «DoIPEntityIdentification») e destrutores ([SWS_DM_01365], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.1.1 «Destructor») explícitos, o objeto de valor EntityId é libertado automaticamente ao sair do âmbito de validade, após a leitura dos dados de campo pelo Diagnostic Manager.

Caminho de utilização

A utilização regular de EntityId segue uma sequência definida no fluxo do protocolo de diagnóstico:

• Verificação da configuração: o Diagnostic Manager verifica o atributo DoIpNetworkConfiguration.eidRetrieval. Se DoIpEidRetrievalEnum.eidUseApi estiver aí configurado, o DM tem obrigatoriamente de obter o identificador através da API ([SWS_DM_01361]).
• Obtenção através da API: o Diagnostic Manager chama o método ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]).
• Disponibilização de dados: a aplicação cria uma instância de EntityId, preenche o membro entityIdentification com o identificador de 6 bytes de acordo com a ISO 13400-2 ([SWS_DM_01496]) e transmite a estrutura.
• Utilização no protocolo: o Diagnostic Manager extrai o identificador e insere-o em mensagens DoIP, tais como o anúncio de veículo (Vehicle Announcement Message) ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Diagrama de sequência: sequência na obtenção e processamento posterior de EntityId, incluindo recurso em caso de erro. Fontes: [SWS_DM_01361], [SWS_DM_01496], [SWS_DM_01528].

Cenários de erro

Um cenário de erro central ocorre se a interface ara::diag::DoIPEntityIdentification ainda não for disponibilizada pela aplicação adaptativa no momento de consulta exigido ou se a obtenção através de GetEntityId falhar ([SWS_DM_01528], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Para não bloquear permanentemente o envio de mensagens DoIP, a especificação prescreve, neste caso, um comportamento obrigatório de valor de substituição: o Diagnostic Manager tem de transmitir, em vez dos dados regulares da aplicação, um campo EID de 6 bytes com o valor fixo 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF ([SWS_DM_01528]). Ao nível do tipo, o array fixo ara::core::Array<std::uint8_t, 6> exclui erros de comprimento e estouros de buffer em tempo de compilação ([SWS_DM_01496]).