estrutura ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse

A estrutura de dados ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse serve como contentor de retorno para os dados de resultado de uma operação de diagnóstico SOVD executada de forma síncrona [SWS_DM_02208]. Após a pré-verificação bem-sucedida de um eventual proximity_challenge, o Diagnostic Management chama o método de aplicação StartExecution [SWS_DM_02174]. A partir dos dados contidos na estrutura de resposta, o Diagnostic Management deriva o atributo parameters do corpo de resposta SOVD de acordo com o ASAM SOVD [SWS_DM_02176]. O mecanismo pressupõe obrigatoriamente que a operação de diagnóstico esteja concebida para uma execução síncrona.

mais ›

Contexto

A estrutura ara::diag::GenericDiagnosticSovdOperation::StartSynchronousExecutionResponse é parte integrante da interface de diagnóstico (módulo diag) na AUTOSAR Adaptive Platform e é formalmente definida em [SWS_DM_02208] bem como em AUTOSAR_AP_SWS_Diagnostics §8.62.4 «Struct: StartSynchronousExecutionResponse». A sua função primordial consiste no transporte dos dados de resposta durante a execução síncrona de uma operação de diagnóstico através do protocolo padronizado SOVD (Service-Oriented Vehicle Diagnostics).

Neste contexto, interagem três intervenientes essenciais do sistema: um cliente externo solicita o início de uma operação SOVD através de uma instância de servidor de diagnóstico [SWS_DM_01396]. O Diagnostic Management (DM) processa o pedido e chama a interface específica da aplicação ara::diag::GenericDiagnosticSovdOperation::StartExecution [SWS_DM_02174]. Se a execução for síncrona, o DM recebe a instância de StartSynchronousExecutionResponse e gera, a partir desta, o corpo de resposta em conformidade com o SOVD para o cliente [SWS_DM_02176], conforme especificado em AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 «Operations – Start execution of an operation».

Ciclo de vida

Como estrutura de dados, StartSynchronousExecutionResponse assume o caráter de um mero objeto de valor e de transferência sem máquina de estados autónoma. A estrutura é instanciada pela lógica de aplicação individual durante a chamada de StartExecution. Interpretação: a criação deverá ocorrer tipicamente como valor de retorno diretamente no contexto de pilha local do método de processamento síncrono da aplicação. Pergunta (aberta)

Após a conclusão da lógica de operação, o objeto é passado para o contexto chamador do DM. Este extrai os dados úteis contidos (DiagnosticSovdContentData) para preencher os atributos SOVD necessários [SWS_DM_02176]. Após a conclusão da transformação e do envio da mensagem de resposta, a vida útil do objeto de resposta termina. O ciclo de vida fica, assim, estritamente vinculado à duração da chamada síncrona da operação; não há gestão persistente nem sincronização concorrente.

Caminho de utilização

O fluxo regular realiza-se nos seguintes passos:

1. Um cliente chama o método SOVD para iniciar uma operação disponibilizado pela instância do servidor de diagnóstico [SWS_DM_01396].
2. O DM verifica o pedido e realiza, se necessário, uma validação do teste de proximidade (proximity_challenge) [SWS_DM_02174].
3. Após verificação bem-sucedida, o DM delega a chamada à aplicação através de ara::diag::GenericDiagnosticSovdOperation::StartExecution [SWS_DM_02174].
4. A aplicação processa a operação de forma síncrona e cria a instância StartSynchronousExecutionResponse, na qual os dados de resultado são guardados [SWS_DM_02208].
5. O DM deriva o atributo parameters a partir do DiagnosticSovdContentData contido na resposta e devolve o corpo de resposta SOVD completo em conformidade com o ASAM SOVD [SWS_DM_02176].

Diagrama de sequência: fluxo no início síncrono de uma operação SOVD e processamento posterior de StartSynchronousExecutionResponse. Fontes: [SWS_DM_01396], [SWS_DM_02174], [SWS_DM_02176], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.5.5 «Operations – Start execution of an operation»

Cenários de erro

A execução e a avaliação da resposta estão sujeitas a condições definidas:

• Pré-condição falhada: se uma validação de proximity_challenge for necessária e falhar, o DM nem sequer chama StartExecution [SWS_DM_02174]. Neste caso, nenhuma instância de StartSynchronousExecutionResponse é instanciada.
• Execução não síncrona: se a operação não tiver sido configurada ou iniciada como operação SOVD síncrona, o processamento através de StartSynchronousExecutionResponse não se aplica [SWS_DM_02176].
• Erro de aplicação: Interpretação: se ocorrer um erro durante o processamento interno na aplicação, deverá intervir um caminho de erro em vez de um StartSynchronousExecutionResponse regular, pelo que não são disponibilizados nenhuns DiagnosticSovdContentData válidos para a derivação do atributo parameters. Pergunta Q-5faaee7b9b008dde (aberta)