classe ara::diag::ServiceValidation

O método Confirmation da interface ara::diag::ServiceValidation ([SWS_DM_00775], declarado em ara/diag/service_validation.h) serve como notificação sobre a conclusão e o resultado de um pedido de diagnóstico previamente processado.

Utilização e semântica

A função virtual de callback é chamada de forma síncrona pelo Diagnostic Management assim que o processamento do pedido estiver concluído. Não possui valor de retorno (void) e recebe dois parâmetros de entrada ([SWS_DM_00775]):

• status (ConfirmationStatusType): Sinaliza o estado final ou o resultado do processamento do serviço ([SWS_DM_00775]).
• metaInfo (const Meta Info &): Contém metainformações associadas do pedido de diagnóstico ([SWS_DM_00775]).

Tratamento de erros e simultaneidade

A função está especificada como segura contra exceções (exception safe) e declarada com o identificador noexcept ([SWS_DM_00775]). As sobreposições no lado da aplicação não podem, portanto, propagar exceções para o exterior. Códigos de erro específicos, tais como mensagens DET ou DEM, não estão definidos para este método. Relativamente à concorrência, Confirmation está classificado como não seguro para threads (not thread-safe) ([SWS_DM_00775]); o acesso a estados internos da aplicação dentro do callback requer uma sincronização correspondente em execuções paralelas.

Interação

O acionamento da notificação está associado ao fim do ciclo de vida de um pedido de diagnóstico ([SWS_DM_00775]). Este ciclo é concluído assim que uma resposta positiva ou negativa tenha sido transmitida ou suprimida (AUTOSAR_AP_SWS_Diagnostics §7.3.2.1.2 «Life-cycle of a Diagnostic Conversation»). Interpretação: ao nível de módulo, o Diagnostic Management só deverá despoletar o callback Confirmation quando a transmissão através da camada de transporte tiver sido confirmada por meio de TransmitConfirmation e do resultado kTransmitOk ou kTransmitFailed ([SWS_DM_00307], [SWS_DM_00351]). Pergunta Q-97c38586ef5e3704 (aberta)

usar

A função-membro Offer da classe ara::diag::ServiceValidation (cabeçalho ara/diag/service_validation.h) ativa o encaminhamento de solicitações de diagnóstico de entrada pelo Diagnostic Manager (DM) para este manipulador de validação específico [SWS_DM_00776]. A chamada ocorre de forma síncrona e sem parâmetros de entrada por meio da assinatura ara::core::Result<void> Offer() noexcept; [SWS_DM_00776]. Como valor de retorno, serve um ara::core::Result<void>, que é vazio em caso de sucesso ou encapsula o código de erro ocorrido em caso de falha [SWS_DM_00776].

Tratamento de erros

Se o registro falhar, o método retorna um Result com erro. Se o serviço já tiver sido oferecido anteriormente para a respectiva instância, o código de erro DiagOfferErrc::kAlreadyOffered é retornado [SWS_DM_00776]. Aqui se aplica uma semântica de rollback, de modo que o estado anterior da instância permaneça inalterado [SWS_DM_00776].

Simultaneidade e restrições

A função é especificada como segura contra exceções (exception safe), porém expressamente como não segura para threads (not thread-safe) [SWS_DM_00776]. Os acessos paralelos à mesma instância devem ser coordenados pela aplicação chamadora. Em relação à ordem, Offer deve ser chamado antes que o Diagnostic Manager possa encaminhar requisições de serviço para validação [SWS_DM_00776].

Interação

A oferta de interfaces via Offer é um padrão de projeto consistente do diagnóstico AUTOSAR Adaptive e é empregada de forma análoga, entre outros, em rotinas ([SWS_DM_00557], [SWS_DM_00594]), serviços UDS genéricos ([SWS_DM_00619]), funções DoIP ([SWS_DM_00725], [SWS_DM_00735]), bem como acessos de segurança ([SWS_DM_00766]). Enquanto uma interface não tiver sido disponibilizada via Offer, o DM descarta requisições ou recorre a valores substitutos definidos ([SWS_DM_01525], [SWS_DM_01527]). Paralelos conceituais com ara::com são motivados funcionalmente, mas representam uma implementação independente do diagnóstico (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»).

usar

O método StopOffer() da classe ara::diag::ServiceValidation (arquivo de cabeçalho ara/diag/service_validation.h) serve para desativar o encaminhamento de mensagens de solicitação de entrada do Diagnostic Management (DM) para a instância de validação de serviços [SWS_DM_00777]. A chamada ocorre de forma síncrona, não aceita parâmetros de entrada e não fornece valor de retorno [SWS_DM_00777].

Tratamento de erros e simultaneidade

A função é declarada como noexcept e considerada segura para exceções (exception safe), de modo que nenhuma exceção C++ ocorre durante a execução [SWS_DM_00777]. Códigos de erro específicos ou retornos para o gerenciamento de erros não estão definidos para esta chamada [SWS_DM_00777].

Em relação à simultaneidade, o método é especificado como não seguro para threads (not thread-safe) [SWS_DM_00777]. Interpretação: A aplicação chamadora deve garantir que chamadas concorrentes na mesma instância de StopOffer() sejam sincronizadas, para evitar inconsistências de dados. Pergunta Q-dde3c015d30a9db1 (aberta)

Interação

A disponibilização e a revogação de interfaces através de Offer() e StopOffer() orientam-se pela semântica conhecida de ara::com, mas representam uma funcionalidade independente na área de diagnóstico AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». O padrão para desativação do encaminhamento de solicitações do DM é utilizado de forma consistente na norma para outros manipuladores de diagnóstico, como para serviços de autenticação [SWS_DM_01131], controle de comunicação [SWS_DM_00810], serviços de download [SWS_DM_00793], bem como solicitações de reset de ECU [SWS_DM_01017].

usar

O método virtual ara::diag::ServiceValidation::Validate é chamado para cada mensagem de solicitação de diagnóstico de entrada [SWS_DM_00774]. Através dele, o Diagnostic Server (DM) executa verificações de serviço específicas do fabricante [SWS_DM_01252] e específicas do fornecedor [SWS_DM_01253] configuradas de acordo com a ISO 14229-1. A atribuição como verificação do fabricante ou do fornecedor baseia-se na modelagem no construtor [SWS_DM_00772].

A função recebe os dados de diagnóstico, incluindo o Service Identifier (SID), através de requestData, bem como metainformações através de metaInfo [SWS_DM_00774]. O buffer requestData permanece válido até que o ara::core::Future<void> retornado seja cumprido por meio do Promise associado ou que a execução seja cancelada [SWS_DM_00774]. Se a validação for concluída com sucesso sem erros, o Diagnostic Server prossegue com o processamento da solicitação em conformidade com a ISO 14229-1 [SWS_DM_01254].

Tratamento de erros e condições de contorno

Se a verificação falhar, um NRC apropriado em conformidade com a ISO 14229-1 deve ser retornado por meio de DiagUdsNrcErrc [SWS_DM_00774]. Se Validate retornar o erro kNoProcessingNoResponse, a instância do Diagnostic Server descarta a mensagem sem resposta adicional [SWS_DM_00860].

Em relação à simultaneidade, Validate é especificado como seguro para exceções (exception safe), mas não seguro para threads (not thread-safe) [SWS_DM_00774]. Interpretação: Como a função não é segura para threads, o Diagnostic Server provavelmente serializa chamadas para a mesma instância ou exclui acessos concorrentes. Pergunta Q-e150c15ad709602c (aberta) O contexto de chamada é determinado pela sequência de NRCs da ISO 14229-1 antes da execução propriamente dita do serviço [SWS_DM_00772].