estrutura ara::diag::GenericDataIdentifier::OperationOutput

A estrutura de dados ara::diag::GenericDataIdentifier::OperationOutput encapsula os dados úteis para mensagens de resposta positiva no âmbito de operações de diagnóstico de DID genéricas ([SWS_DM_00641]). Mediante um pedido de diagnóstico recebido, a aplicação instancia a estrutura e preenche o membro responseData com os dados de saída apurados antes de esta ser transmitida ao Diagnostic Management ([SWS_DM_00631]). Aplica-se aqui a condição limite essencial de que responseData deve conter exclusivamente os dados úteis puros e, sob nenhuma circunstância, o Data Identifier propriamente dito. Após a transferência para a mensagem de resposta UDS, o ciclo de vida do objeto de valor efémero termina.

mais ›

Contexto

A estrutura de dados ara::diag::GenericDataIdentifier::OperationOutput faz parte do módulo diag na AUTOSAR Adaptive Platform e é disponibilizada através do cabeçalho ara/diag/generic_data_identifier.h ([SWS_DM_00641], [SWS_DM_00631]). Na arquitetura de diagnóstico, a estrutura atua como contentor de dados especializado para os dados de resultado de uma mensagem de resposta de diagnóstico positiva referente a um identificador de dados genérico (Data Identifier, DID) (AUTOSAR_AP_SWS_Diagnostics §8.19.2 «Struct: OperationOutput»).

Na interação dos componentes arquiteturais envolvidos, OperationOutput estabelece a ligação entre a função de serviço de diagnóstico específica da aplicação e o Diagnostic Management central. Enquanto a aplicação é responsável pela leitura e preparação dos dados úteis, o sistema de runtime de diagnóstico assume o processamento do protocolo de nível superior perante o tester de diagnóstico externo. Para a transmissão dos dados de resposta, a estrutura declara a variável de elemento pública responseData do tipo ara::core::Vector<std::uint8_t> ([SWS_DM_00631], AUTOSAR_AP_SWS_Diagnostics §8.19.2.1.1 «responseData»). Este vetor de bytes transporta o payload da mensagem de resposta positiva, não podendo o identificador de dados em si constar no vetor ([SWS_DM_00631]).

Ciclo de vida

Como struct de transmissão de dados leve e sem métodos próprios, ara::diag::GenericDataIdentifier::OperationOutput está sujeito a um ciclo de vida de valor simples e transitório ([SWS_DM_00641]). A instanciação ocorre a pedido dentro da rotina de tratamento específica da aplicação, assim que uma respetiva operação de leitura ou consulta para um DID genérico tenha sido processada com sucesso. O vetor contido responseData é aqui preenchido com os dados úteis de diagnóstico solicitados ([SWS_DM_00631]).

A titularidade é estritamente sequencial: a aplicação geradora mantém inicialmente a instância localmente e, após a conclusão, transmite-a ao framework de diagnóstico. O tempo de vida da instância termina assim que o Diagnostic Management tiver transferido os dados úteis para a mensagem de resposta de diagnóstico de saída. Presumivelmente, a devolução ao sistema de runtime ocorre de forma eficiente em termos de recursos via semântica de movimento (move semantics) ou empacotada num contentor assíncrono como ara::core::Future ou ara::core::Result. Pergunta Q-6e8dadb21e01d4fb (aberta) A estrutura não oferece sincronização interna para acesso concorrente; no entanto, como é preenchida e transmitida de forma transitória dentro da worker thread executora da operação, interpretação: não é necessária uma proteção inter-threads no funcionamento regular.

Caminho de utilização

A sequência de chamada típica no processamento de uma consulta genérica de dados de diagnóstico divide-se nos seguintes passos:

1. Um tester de diagnóstico externo inicia uma consulta (por exemplo, um serviço UDS de leitura por identificador de dados), a qual é recebida pelo Diagnostic Management do veículo.
2. O sistema de diagnóstico delega o pedido de leitura na instância competente de ara::diag::GenericDataIdentifier da aplicação.
3. A aplicação apura os dados de sensor ou parâmetros internos solicitados e instancia ara::diag::GenericDataIdentifier::OperationOutput ([SWS_DM_00641]).
4. A aplicação atribui ao vetor responseData os bytes apurados ([SWS_DM_00631]). Neste processo, o valor do DID em si não pode ser armazenado em responseData (AUTOSAR_AP_SWS_Diagnostics §8.19.2.1.1 «responseData»).
5. A instância preenchida é devolvida ao Diagnostic Management, o qual prefixa o DID, monta o telegrama de resposta positiva completo e o transmite ao tester de diagnóstico.

Diagrama de sequência: fluxo de processamento de uma consulta de dados genérica com recurso a OperationOutput. Fontes: [SWS_DM_00641], [SWS_DM_00631], AUTOSAR_AP_SWS_Diagnostics §8.19.2 «Struct: OperationOutput».