estrutura ara::diag::DoIPGroupIdentification::GidStatus

A estrutura ara::diag::DoIPGroupIdentification::GidStatus serve como contêiner de dados para os dados de resposta positiva na consulta da identificação de grupo DoIP [SWS_DM_00721]. Ela é disponibilizada por uma Adaptive Application quando o Diagnostic Management solicita a identificação de grupo através da interface GetGidStatus em caso de DoIpInstantiation.gid não configurado [SWS_DM_00813]. A estrutura transporta os valores de GID determinados diretamente para o Diagnostic Manager para encaminhamento no protocolo DoIP. Ela é estritamente limitada a respostas bem-sucedidas e não contém mecanismos para cenários de erro.

mais ›

Contexto

A estrutura de dados ara::diag::DoIPGroupIdentification::GidStatus representa os dados de resposta positiva para a identificação de grupo no subsistema DoIP (Diagnostic over IP) da AUTOSAR Adaptive Platform [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». Ela serve como contêiner de resultado padronizado para dados de identificação de grupo (GID) quando clientes externos de diagnóstico solicitam informações sobre identificação de veículo ou de grupo via DoIP. No conjunto do sistema interagem três parceiros principais: o cliente DoIP externo, o AUTOSAR Diagnostic Management (DM) e a Adaptive Application específica da aplicação, que oferece a interface ara::diag::DoIPGroupIdentification. Desde que o GID não esteja definido estaticamente através do parâmetro de configuração DoIpInstantiation.gid, o DM é obrigado, conforme a especificação, a consultar o GID através da interface da aplicação [SWS_DM_00813], AUTOSAR_AP_SWS_Diagnostics §8.34.1 «Providing the GID in DoIP protocol messages using application interface».

Ciclo de vida

Como estrutura de dados C++ (struct), GidStatus não possui ciclo de vida próprio de processo ou serviço, mas atua puramente como objeto de transferência de dados [SWS_DM_00721]. Uma instância de GidStatus é instanciada pela Adaptive Application responsável e preenchida com os dados de identificação atuais assim que o método de consulta GetGidStatus é chamado [SWS_DM_00724], AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 «GetGidStatus». Interpretação: a estrutura provavelmente é criada como objeto de valor temporário na pilha (stack) e repassada ao DM como parte do valor de retorno por semântica de cópia ou movimentação (move), encerrando seu ciclo de vida após o processamento da mensagem DoIP no DM. Pergunta Q-4974fdbc2c6accbb (aberta) Como podem ocorrer múltiplas requisições de diagnóstico ou processamentos paralelos de mensagens DoIP, os dados mantidos dentro da estrutura devem ser disponibilizados de forma thread-safe ou criados isoladamente para cada contexto de consulta.

Caminho de utilização

O uso típico de GidStatus divide-se em uma sequência fixa de interação entre o cliente DoIP, o Diagnostic Management e a Adaptive Application:

Diagrama de sequência: fluxo de disponibilização de GidStatus via GetGidStatus com GID não configurado. Fontes: [SWS_DM_00721], [SWS_DM_00724], [SWS_DM_00813].

1. Um cliente DoIP externo envia uma requisição de diagnóstico ou de identificação para o veículo através da rede DoIP.
2. O Diagnostic Management verifica a configuração: se DoIpInstantiation.gid não estiver configurado, o DM solicita a identificação de grupo à Adaptive Application via GetGidStatus [SWS_DM_00813], [SWS_DM_00724].
3. A Adaptive Application determina os atributos de identificação de grupo, cria uma instância de GidStatus com os dados de resposta positiva e a retorna ao DM [SWS_DM_00721].
4. O DM extrai os dados de GidStatus e envia a mensagem completa de protocolo DoIP ao cliente DoIP externo [SWS_DM_00813].

Cenários de erro

A especificação define GidStatus expressamente como dados de resposta positiva («Response data of positive response message») [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». Interpretação: caso a Adaptive Application não seja capaz de fornecer a identificação de grupo, ou caso ocorra um erro interno, provavelmente nenhuma instância regular de GidStatus será retornada; em vez disso, o método GetGidStatus deverá sinalizar um erro ao DM por meio de mecanismos padronizados de erro da plataforma (como códigos de erro em ara::core::Result). Pergunta Q-01181eb14d27eeb2 (aberta) Além disso, o contexto de interfaces DoIP relacionadas, como ara::diag::DoIPPowerMode [SWS_DM_00814], deixa claro que o DM utiliza valores padrão ou substitutos definidos para interfaces ainda não oferecidas [SWS_DM_01525]; para a identificação de grupo, a ausência de dados de resposta válidos exige um tratamento negativo correspondente no protocolo DoIP, já que sem o GID nenhuma resposta positiva válida pode ser transmitida [SWS_DM_00813].