classe apext::diag::uds_transport::UdsTransportProtocolMgr

usar

O método ChannelReestablished da classe apext::diag::uds_transport::UdsTransportProtocolMgr serve como retorno de uma implementação de protocolo de transporte UDS ao Diagnostic Management (DM) de que um canal de comunicação está disponível novamente após uma (re)inicialização [SWS_DM_00313]. A implementação do protocolo de transporte chama este método exatamente uma vez assim que a redisponibilidade do canal de rede representado por ChannelID for detectada [SWS_DM_00358]. Como parâmetro é passado globalChannelId, composto pela tupla de handlerIdent próprio e a ChannelID [SWS_DM_00358].

Zusammenspiel e ciclo de vida

O pré-requisito para a notificação é uma chamada anterior de NotifyReestablishment [SWS_DM_00313], [SWS_DM_00356]. Um caso de uso típico é a execução de um reset de ECU (serviço UDS 0x11) com a opção de uma resposta positiva após a reinicialização [SWS_DM_00326]. Para garantir a notificação mesmo após uma reinicialização do DM, a solicitação de notificação deve ser armazenada de forma persistente pelo protocolo de transporte [SWS_DM_00359].

Tratamento de erros e simultaneidade

A função não possui valor de retorno e é especificada como noexcept (exception safe) [SWS_DM_00313]. Como a interface é classificada como não segura para threads (not thread-safe) [SWS_DM_00313], os handlers chamadores presumivelmente devem sincronizar o acesso externamente. Pergunta Q-aaf14893457cceb6 (aberta) Como restrição temporal, aplica-se que o DM só pode processar a chamada de ChannelReestablished após a chamada de UdsTransportProtocolHandler::Start [SWS_DM_01744].

O método HandleMessage serve para passar uma mensagem de solicitação UDS válida e completamente recebida da camada de transporte para a camada de sessão do Diagnostic Management ([SWS_DM_00311]). Isto corresponde ao serviço T_Data.ind de acordo com a ISO 14229-2 ([SWS_DM_00311], AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.2 «HandleMessage»).

Chamada e parâmetros

Assim que a implementação do protocolo de transporte tiver preenchido a carga útil do buffer solicitado anteriormente via IndicateMessage ([SWS_DM_00388]), ela chama HandleMessage na instância de apext::diag::uds_transport::UdsTransportProtocolMgr ([SWS_DM_00345]). Como argumento, é passado message do tipo UdsMessagePtr. Através da semântica std::unique_ptr, a posse da mensagem UDS retorna ao núcleo genérico de DM ([SWS_DM_00311]). A função não fornece valor de retorno.

Semântica, concorrência e tratamento de erros

• Assincronismo: A chamada deve retornar imediatamente («instantly returns») ([SWS_DM_00311]). Interpretação: O processamento propriamente dito da solicitação de diagnóstico deverá continuar de forma assíncrona no núcleo de DM, num contexto de execução separado. Pergunta Q-b8dd1a5f3d2dcdf0 (aberta)
• Caso de erro: O método é declarado como noexcept e seguro contra exceções ([SWS_DM_00311]). Se a receção ou o preenchimento da mensagem falhar, nenhuma chamada de HandleMessage deve ocorrer; em vez disso, o erro deve ser reportado através de NotifyMessageFailure ([SWS_DM_00310]).
• Segurança de threads: A operação é especificada como not thread-safe ([SWS_DM_00311]). Os chamadores devem sincronizar acessos paralelos à mesma instância.

Interação

A interface pertence à camada de protocolo de transporte e deve ser distinguida do método de processamento de serviços do lado da aplicação ara::diag::GenericUDSService::HandleMessage ([SWS_DM_00618]).

O método de callback puramente virtual HandlerStopped da interface de gerenciamento apext::diag::uds_transport::UdsTransportProtocolMgr serve como retorno de um plugin de transporte UDS para o Diagnostic Manager (DM), indicando que sua execução foi encerrada e que todos os recursos associados, bem como as conexões de rede, foram completamente liberados [SWS_DM_00314]. Esta chamada é esperada como resposta obrigatória do handler a uma chamada prévia de UdsTransportProtocolHandler::Stop() [SWS_DM_00314], [SWS_DM_00323].

Contexto de chamada e parâmetros: O plugin afetado se identifica na chamada através do parâmetro de entrada handlerId do tipo UdsTransportProtocolHandlerID [SWS_DM_00314]. O método não possui valor de retorno (void) e garante total segurança contra exceções (exception safe) por meio de sua especificação como noexcept [SWS_DM_00314]. Códigos de erro específicos, reações a erros ou notificações para DET ou DEM não estão definidos para esta interface.

Fluxo e restrições: Se o Diagnostic Manager mudar para o estado ApplicationState.kTerminating no âmbito do procedimento de encerramento, ele chama primeiramente Stop() em cada implementação de protocolo de transporte UDS iniciada [SWS_DM_00333]. Após o retorno de Stop(), vigora uma estrita proibição de chamadas: o plugin handler não deve mais chamar nenhum outro método em relação a UdsTransportProtocolMgr, exceto HandlerStopped [SWS_DM_01741], [SWS_DM_00323]. Antes do encerramento definitivo do processo do DM, este aguarda a chegada do respectivo callback HandlerStopped com o handlerId correspondente [SWS_DM_00340]. A interface é indicada como não thread-safe (not thread-safe) [SWS_DM_00314]. Interpretação: Uma vez que o DM aguarda a chegada do callback separadamente, é provável que o encerramento efetivo das conexões de rede no plugin ocorra de forma assíncrona em relação ao retorno do método Stop(). Pergunta Q-40829d46bd661337 (aberta)

O método IndicateMessage [SWS_DM_00309] da classe apext::diag::uds_transport::UdsTransportProtocolMgr é chamado de forma síncrona por um UdsTransportProtocolHandler quando o início da recepção de uma mensagem UDS deve ser sinalizado e o handler suporta isso. O chamador passa os endereços de origem e de destino (sourceAddr, targetAddr), o tipo de endereçamento type (físico ou funcional), o ID do canal globalChannelId, o tamanho total esperado size, bem como, opcionalmente, uma visualização em bytes dos dados úteis já recebidos (payloadInfo). A disponibilização de pelo menos dois bytes em payloadInfo é recomendada para que o Diagnostic Management Core possa reconhecer requisições funcionais como Tester-Present (lógica de bypass) mesmo durante o processamento em andamento AUTOSAR_AP_SWS_Diagnostics §7.1 «UDS Transport Layer».

Como valor de retorno, a chamada síncrona e segura contra exceções fornece um std::pair composto por IndicationResult [SWS_DM_00384] e um UdsMessagePtr [SWS_DM_00309]:

• Aceitação: Se a mensagem puder ser processada, o DM Core retorna IndicationResult::kIndicationOk juntamente com um UdsMessagePtr válido, cuja capacidade mínima é de pelo menos um byte [SWS_DM_00385].
• Rejeição e casos de erro: Se o DM estiver sobrecarregado, ele responde com kIndicationOccupied e nullptr [SWS_DM_00386]. Em caso de endereço de destino inválido, kIndicationUnknownTargetAddress é retornado com um ponteiro nulo. Outros valores de status definidos são kIndicationOverflow [SWS_DM_00384].

Com relação à concorrência e ao tempo de vida, o método está especificado como não thread-safe (not thread-safe) [SWS_DM_00309]; as chamadas devem, portanto, ocorrer com a sincronização adequada. A visualização passada via payloadInfo é volátil e deve ser utilizada exclusivamente no âmbito desta chamada de função [SWS_DM_00309].

No decorrer do processo, mediante o retorno de kIndicationOk, a camada de transporte preenche o buffer disponibilizado via GetPayload [SWS_DM_00301] até o limite de capacidade ou até o comprimento total da mensagem [SWS_DM_00388]. Após o preenchimento bem-sucedido, HandleMessage é chamado [SWS_DM_00345]. Se a recepção da mensagem falhar prematuramente, o handler deve devolver o buffer ao DM via NotifyMessageFailure [SWS_DM_00310].

usar

O método virtual puro NotifyMessageFailure é disponibilizado por meio do cabeçalho apext/diag/uds_transport/protocol_mgr.h na interface apext::diag::uds_transport::UdsTransportProtocolMgr [SWS_DM_00310]. Ele serve para a implementação do protocolo de transporte indicar ao Diagnostic Management que uma mensagem previamente sinalizada via IndicateMessage() falhou e que nenhuma chamada final de HandleMessage() [SWS_DM_00345] ocorrerá mais [SWS_DM_00310]. Como parâmetro, é passado o ponteiro message do tipo UdsMessagePtr, devolvendo a mensagem afetada à camada de sessão [SWS_DM_00310]. Não existe valor de retorno (void).

Tratamento de erros e simultaneidade

A função é declarada como noexcept e segura contra exceções [SWS_DM_00310]. Ela não lança exceções e reporta interrupções de transmissão puramente por meio da interface de parâmetros. Em relação à concorrência, o método é classificado como não seguro para threads (not thread-safe) [SWS_DM_00310]. Interpretação: em caso de processamento paralelo no nível do protocolo de transporte, os chamadores presumivelmente devem garantir sincronização externa. Pergunta Q-8d9b3a3561b9b6ac (aberta)

Interação e fluxo

No fluxo regular, o protocolo de transporte preenche a carga útil de UdsMessage [SWS_DM_00388] após um IndicateMessage() bem-sucedido e a encaminha ao Diagnostic Management via HandleMessage() [SWS_DM_00345]. No entanto, se a transmissão falhar – por exemplo, em caso de erros durante a recepção de uma requisição multi-frame –, NotifyMessageFailure é chamado em seu lugar [SWS_DM_00310]. Isso impede chamadas de processamento subsequentes e afeta o gerenciamento de sessão: enquanto o temporizador S3Server é parado no início da recepção [SWS_DM_00383], um erro de recepção de uma mensagem multi-frame faz com que o temporizador S3Server seja reiniciado e conte novamente desde o início (SWS Diagnostics §7.3.2.7 «Session handling» / [SWS_DM_00310]).

usar

O método puramente virtual PeriodicTransmitConfirmation é parte integrante da classe apext::diag::uds_transport::UdsTransportProtocolMgr e é declarado através do arquivo de cabeçalho apext/diag/uds_transport/protocol_mgr.h [SWS_DM_01069]. Ele serve para a confirmação de mensagens de diagnóstico periódicas enviadas, bem como para a transmissão da quantidade de mensagens enviadas com sucesso AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.6 «PeriodicTransmitConfirmation».

Na chamada, dois parâmetros de entrada são passados, enquanto o método não fornece valor de retorno:

• messages (ara::core::Vector<UdsMessageConstPtr>): A mesma lista ordenada de mensagens que foi passada anteriormente para o método UdsTransportProtocolPeriodicHandler::PeriodicTransmit() [SWS_DM_01069].
• numberOfSentMessages (std::size_t): A quantidade de mensagens transmitidas com sucesso a partir da lista messages [SWS_DM_01069].

Tratamento de erros e segurança contra exceções

Em relação à segurança de exceção, a interface é especificada como exception safe e provida do identificador noexcept [SWS_DM_01069]. Ela, portanto, não lança exceções C++. Códigos de erro ou mensagens de erro específicos através de DET ou DEM não estão definidos na especificação para esta função de confirmação.

Simultaneidade e condições marginais

A função está classificada como não segura para threads (not thread-safe) de acordo com a especificação [SWS_DM_01069]. Chamadas simultâneas na mesma instância, portanto, não estão protegidas e devem ser coordenadas pelo chamador.

Interação

A função conecta-se diretamente ao fluxo de envio periódico: ela recebe a confirmação sobre as mensagens efetivamente despachadas após uma chamada de UdsTransportProtocolPeriodicHandler::PeriodicTransmit() AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.6 «PeriodicTransmitConfirmation». No nível de requisitos, a função está atribuída ao requisito upstream RS_Diag_04215 [SWS_DM_01069].

usar

O método virtual puro TransmitConfirmation da interface apext::diag::uds_transport::UdsTransportProtocolMgr serve para notificar o Diagnostic Management (DM) sobre a conclusão de uma ordem de envio previamente iniciada pelo DM via UdsTransportProtocolHandler::Transmit [SWS_DM_00312] [SWS_DM_00348]. A função implementa o serviço primitivo T_Data.con de acordo com a ISO 14229-2 [SWS_DM_00312].

Na chamada, são passados dois parâmetros [SWS_DM_00312]:

• message (UdsMessageConstPtr): Ponteiro para a mensagem UDS previamente disponibilizada em IndicateMessage() e cuja transmissão é confirmada [SWS_DM_00312].
• result (TransmissionResult): Indica o resultado da transmissão. Se a camada de rede conseguiu enviar com sucesso a resposta UDS para a rede, o valor deve ser definido como kTransmitOk, caso contrário como kTransmitFailed [SWS_DM_00351] SWS Diagnostics §7.1.1.3 «Confirmation Result».

O método não possui valor de retorno (void) e é declarado como noexcept, razão pela qual deve ser executado de forma segura contra exceções [SWS_DM_00312].

Concorrência e comportamento do sistema

A interface é explicitamente especificada como não segura para threads [SWS_DM_00312]. Chamadas a partir de contextos concorrentes de rede ou de manipuladores deverão, portanto, exigir sincronização externa pela implementação do protocolo de transporte. Pergunta Q-e540ca89c3f61ecb (aberta)

Além disso, a chamada influencia o gerenciamento de autenticação: se um cliente se encontrar na sessão padrão e no estado kAuthenticated, o Diagnostic Server coloca-o no estado kDeAuthenticated se, após o último TransmitConfirmation, nenhuma nova solicitação for recebida durante o período de authenticationTimeout [SWS_DM_01210].