Serve como classe base abstrata para plug-ins de transporte UDS visando à transmissão e ao encaminhamento de mensagens de diagnóstico.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 8b34a053e223ProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Serve como classe base abstrata para plug-ins de transporte UDS visando à transmissão e ao encaminhamento de mensagens de diagnóstico.
A classe abstrata serve a plug-ins de transporte UDS como interface base para a conexão padronizada ao gerenciamento de diagnóstico adaptativo (AUTOSAR_AP_SWS_Diagnostics §7.1.1 «Support of UDS Transport Layer»). Uma implementação derivada encaminha mensagens de diagnóstico recebidas para o gerenciador de protocolos e transmite mensagens de resposta geradas através de canais específicos da rede para o testador de diagnóstico. O ciclo de vida está sujeito a uma sequência estrita de criação, inicialização separada, inicialização assíncrona e parada ordenada ([SWS_DM_00329]). Após a instanciação, as chamadas de métodos operacionais não são seguras para threads e exigem um controle coordenado pelo núcleo de diagnóstico.
Contexto
A classe apext::diag::uds_transport::UdsTransportProtocolHandler é uma classe base abstrata dentro do módulo diag da AUTOSAR Adaptive Platform. Ela define a interface padronizada por meio da qual plug-ins de transporte UDS proprietários ou específicos de protocolo são conectados ao gerenciamento de diagnóstico (DM) adaptativo (AUTOSAR_AP_SWS_Diagnostics §7.1.1 «Support of UDS Transport Layer», [SWS_DM_00315]). Cada protocolo de transporte concreto – por exemplo, para diagnóstico sobre mídias de rede automotivas – implementa essa interface como uma subclasse derivada. Supõe-se que o DM possua e gerencie com exclusividade a respectiva instância de manipulador durante todo o seu ciclo de vida operacional. Pergunta Q-ef308265bfdf6cec (aberta) A interação entre o núcleo de diagnóstico e o plug-in ocorre por meio da referência transportprotocolManager do tipo UdsTransportProtocolMgr&, que é passada no construtor e armazenada de forma protegida ([SWS_DM_09015], [SWS_DM_09025]). Cada manipulador é identificado por um UdsTransportProtocolHandlerID numérico, que pode ser consultado via GetHandlerID() ([SWS_DM_00325]).
Ciclo de vida
O ciclo de vida de um manipulador de protocolo de transporte UDS é controlado de forma estritamente sequencial pelo DM ([SWS_DM_00329]). Após a instanciação pelo construtor UdsTransportProtocolHandler ([SWS_DM_09015]), o método Initialize() separa a inicialização real do protocolo da criação do objeto ([SWS_DM_00319]). Com exceção de uma consulta opcional via GetPeriodicHandler(), o DM não deve chamar nenhum método no manipulador antes do retorno bem-sucedido de InitializationResult::kInitializeOk ([SWS_DM_01746], [SWS_DM_09017]). Após a inicialização bem-sucedida, a chamada de Start() coloca o manipulador no estado de processamento ativo ([SWS_DM_00322]). Para minimizar o tempo de inicialização, Start() é concebido como uma operação assíncrona; supõe-se que o DM coordene internamente a inicialização paralela de múltiplos manipuladores. Pergunta Q-66e5a53d55e6d812 (aberta) Se o DM transitar para o estado ApplicationState.kTerminating durante o encerramento, ele instrui o manipulador a finalizar via Stop() ([SWS_DM_00323], [SWS_DM_00333]). O DM aguarda a conclusão, a qual o manipulador confirma chamando UdsTransportProtocolMgr::HandlerStopped() ([SWS_DM_00340]). Após o retorno de Stop(), qualquer chamada de método do plug-in para o gerenciador, exceto HandlerStopped(), é proibida ([SWS_DM_01741]). A liberação dos recursos ocorre, por fim, por meio do destrutor virtual ([SWS_DM_09016]). Enquanto o construtor é seguro para threads, os métodos de interface operacionais são declarados como não seguros para threads.
Na operação de diagnóstico regular, o manipulador processa mensagens de entrada e transmite respostas. Assim que na interface de rede estiverem disponíveis, no mínimo, endereço de origem, endereço de destino, tipo de endereço (físico ou funcional), comprimento total da mensagem e, no caso de dados úteis de múltiplos bytes, os dois primeiros bytes (payloadInfo), a implementação notifica a solicitação ao gerenciador por meio de UdsTransportProtocolMgr::IndicateMessage() ([SWS_DM_00342], AUTOSAR_AP_SWS_Diagnostics §7.1.1.3 «UDS message transmission on a UDS TransportLayer»). Cada solicitação é atribuída a um canal exclusivo (AUTOSAR_AP_SWS_Diagnostics §7.1.1.4 «Channel Notifications»). Para responder, o DM passa a resposta de diagnóstico para o mesmo manipulador e canal por meio de Transmit(message, channelId) ([SWS_DM_00327], [SWS_DM_00348]). Após a transmissão física, o manipulador retorna o objeto de mensagem recebido ao gerenciador via UdsTransportProtocolMgr::TransmitConfirmation() ([SWS_DM_00327], [SWS_DM_00351]). Um caminho de uso especializado diz respeito a resets de ECU (serviço UDS 0x11) com resposta positiva após a reinicialização: aqui, o DM solicita antes do reset, via NotifyReestablishment(channelId), que o manipulador salve as informações de conexão de forma não volátil; após a reinicialização e novo Start(), o manipulador notifica a restauração do mesmo canal via ChannelReestablished() ([SWS_DM_00326], [SWS_DM_01744]).
Se a inicialização da camada de transporte falhar e Initialize() retornar o status InitializationResult::kInitializeFailed, o DM interrompe imediatamente o processo de inicialização desse protocolo e não chama nenhum outro método nessa instância ([SWS_DM_01745], [SWS_DM_09017]). Se transmissões periódicas não forem suportadas no protocolo de transporte, a chamada de GetPeriodicHandler() retorna um ara::core::Result com o código de erro kConfigurationMismatch ([SWS_DM_01068]). Se uma restauração de canal solicitada para um reset de ECU não puder ser assegurada, NotifyReestablishment() falha e sinaliza isso por meio do valor de retorno false ([SWS_DM_00326]). Caso, por fim, o processo de envio de uma resposta de diagnóstico na camada de rede falhe, o manipulador deve informar isso na confirmação ao gerenciador, definindo o argumento result em TransmitConfirmation() como kTransmitFailed ([SWS_DM_00351]).
Este guia foi gerado automaticamente com base na especificação AUTOSAR R25-11.
Initializes UDS Transport Protocol handler. This methods needs to be called before a call of Start(). It is meant to separate the actual initialization of the UDS Transport Protocol handler from the constructor.
Tells the UdsTransportProtocolHandler, to notify the DM core via UdsTransportProtocol Mgr::ChannelReestablished() if the given channel has been re-established after next Uds TransportProtocolHandler::Start(). The main purpose of this method is to allow the DM to provide an ECU-Reset (0x11 service), with configuration option "positive response AFTER reset". In this scenario, the request for 0x11 will be received on a certain channel (GlobalChannel Identifier), then the ECU-Reset takes place and after ECU-Restart, all UdsProtocol Handlers/-plugins get restarted via call to UdsTransportProtocolHandler::Start().
Start processing the UDS Transport Protocol. Within the implementation there might be some stack specific implementation. The method is asynchronous to allow the DM to start multiple UdsTransportProtocolHandler in parallel to reduce startup time.
Method to indicate that this UdsTransportProtocolHandler should terminate. If UdsTransportProtocolHandler has stopped, it shall call UdsTransportProtocolMgr:: HandlerStopped(UdsTransportProtocolHandlerID).
If periodic transmissions are supported on this transport protocol, a reference to UdsTransportProtocolPeriodicHandler is returned, and if not supported, an error (kConfigurationMismatch).
Fehler
Fehlercode
Beschreibung
kConfigurationMismatch
Request a governed re-review of this record. The record is not changed immediately.
Initializes UDS Transport Protocol handler. This methods needs to be called before a call of Start(). It is meant to separate the actual initialization of the UDS Transport Protocol handler from the constructor.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 2d1a514affd8ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método puramente virtual Initialize serve para a inicialização explícita de uma instância de apext::diag::uds_transport::UdsTransportProtocolHandler e separa formalmente esse processo da construção do objeto [SWS_DM_00319]. Ele é chamado de forma síncrona e sem parâmetros pelo Diagnostic Manager (DM), não lança exceções (noexcept) e retorna um InitializationResult[SWS_DM_00319][SWS_DM_09017].
O método sinaliza o resultado por meio do enumerador InitializationResult::kInitializeOk ou InitializationResult::kInitializeFailed[SWS_DM_09017]. O comportamento posterior do DM depende diretamente do valor de retorno:
Em caso de retorno bem-sucedido com kInitializeOk, o DM tem permissão para chamar métodos subsequentes do handler; antes desse valor de retorno bem-sucedido, com exceção de GetPeriodicHandler, nenhuma outra chamada de método é permitida [SWS_DM_01746].
Se o handler retornar kInitializeFailed, o DM aborta completamente o processo de inicialização desse protocolo de transporte e não chama mais nenhum outro método na instância afetada [SWS_DM_01745].
Este texto foi gerado por uma IA com base no AUTOSAR R25-11.
Tells the UdsTransportProtocolHandler, to notify the DM core via UdsTransportProtocol Mgr::ChannelReestablished() if the given channel has been re-established after next Uds TransportProtocolHandler::Start(). The main purpose of this method is to allow the DM to provide an ECU-Reset (0x11 service), with configuration option "positive response AFTER reset". In this scenario, the request for 0x11 will be received on a certain channel (GlobalChannel Identifier), then the ECU-Reset takes place and after ECU-Restart, all UdsProtocol Handlers/-plugins get restarted via call to UdsTransportProtocolHandler::Start().
Now there are two expectations, when this method has been called before and returned "TRUE": If the same remote client connects to the UdsProtocolHandler, it shall get a channel identification with the same identifying as the last time. It consecutively calls UdsTransportProtocolMgr::ChannelReestablished(Global ChannelIdentifier).
The detection/decision, whether the "same" client reconnects as before is an UdsProtocol Handler implementation specific decision.
The general expectation is:
If the channel is set up from exactly the same remote network-endpoint, it typically gets the same ChannelID. To support this functionality, the implementation at least has to store non-volatile, that this notification has to be done. Further it might be needed to store some additional connection specific info non-volatile to make sure, that the same ChannelID can be reassigned. This is the case if the mapping of protocol specific channel info -> channelID isn’t a
stable bijective mapping!
Small example:
The underlying network protocol, which UdsProtocolHandler implements is based on TCP. At the point in time, where the 0x11 Service Identifier request is received on channel identified by the DM calls UdsTransportProtocolHandler::NotifyReestablishment() on this ChannelID.
Now the implementation of UdsProtocolHandler stores non-volatile in the context of this call:
• NetworkEndpoint (IP-address and port number) of the channel. • NetworkEndpoint (IP-address and port number) of the local port (because in this example, the UdsTransportProtocolHandler listens on/supports different ports). • ChannelID it has currently assigned. After restart this ChannelID is only reused for a channel with exactly the same Network Endpoint addresses as stored non-volatile.
If this ChannelID then gets reassigned, then UdsTransportProtocolMgr::Channel Reestablished() has to be called.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 677bdfc28d3dProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método NotifyReestablishment é chamado sincronicamente pelo Diagnostic Manager (DM) quando, no âmbito de um reinício da unidade de controle (serviço UDS 0x11), uma resposta positiva só deve ser enviada após a conclusão do reinício ([SWS_DM_00326], [SWS_DM_00360]). Através do parâmetro channelId, é passado o canal de transporte a ser monitorado ([SWS_DM_00326]).
Com a chamada, a implementação do protocolo de transporte é instruída a persistir a solicitação de monitoramento ([SWS_DM_00359]). Após a reinicialização do sistema e o novo arranque dos manipuladores, o manipulador de protocolo reporta a nova disponibilidade do canal de forma assíncrona ao DM por meio de [SWS_DM_00313] ([SWS_DM_00358]). O valor de retorno booleano sinaliza com true que a solicitação de notificação foi aceita e pode ser atendida; caso contrário, é retornado false ([SWS_DM_00326]).
No que diz respeito à concorrência e ao tratamento de erros, aplica-se o seguinte:
A função é especificada como not thread-safe; chamadas paralelas devem ser sincronizadas pelo chamador ([SWS_DM_00326]).
Para permitir a identificação do mesmo canal após o reinício, os dados de ponto de extremidade específicos da conexão devem ser salvos, a menos que exista um mapeamento bijetivo estável ([SWS_DM_00326]).
Esta nota de uso foi criada por uma IA com base na especificação.
The channelID, whose re-establishment shall be notified to Uds TransportProtocolMgr
Rückgabewert
Typ
Beschreibung
bool
TRUE, if notification request is accepted and can be fulfilled, else FALSE
Hinweise: The UdsTransportProtocolHandler will call UdsTransportProtocolMgr::Channel Reestablished() after UdsTransportProtocolHandler::Start() is called and as soon as it detects that the remote client/tester is reachable again.
Request a governed re-review of this record. The record is not changed immediately.
Start processing the UDS Transport Protocol. Within the implementation there might be some stack specific implementation. The method is asynchronous to allow the DM to start multiple UdsTransportProtocolHandler in parallel to reduce startup time.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: b5781ddbed6cProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método Start da interface apext::diag::uds_transport::UdsTransportProtocolHandler inicia o processamento de protocolo de um plugin de transporte UDS no Diagnostic Management (DM) de acordo com [SWS_DM_00322]. Ele não recebe parâmetros e não retorna nenhum valor. A execução é concebida de forma assíncrona para que o DM possa iniciar várias instâncias em paralelo e, assim, reduzir o tempo de inicialização de todo o sistema ([SWS_DM_00322]). Como a assinatura declara void, o processamento assíncrono deverá ser tratado de forma específica da pilha através de mecanismos internos de segundo plano. Pergunta Q-d1023a05a1f3e2ab (aberta)
Pré-condições: Antes da chamada, a inicialização através de Initialize ([SWS_DM_00319]) deve obrigatoriamente ter sido concluída com o resultado kInitializeOk ([SWS_DM_01746]). Se, pelo contrário, a inicialização fornecer kInitializeFailed, o DM aborta o processo e não deve chamar Start ([SWS_DM_01745]).
Pós-condições: Apenas após a chamada bem-sucedida de Start é que o DM pode acionar funções posteriores como Transmit ou Stop no manipulador ([SWS_DM_01743]). Além disso, o DM processa notificações via ChannelReestablished ([SWS_DM_00313]) exclusivamente se Start tiver sido executado anteriormente ([SWS_DM_01744]), o que é essencial, entre outros, para cenários de reinicialização de ECU com reconexão ([SWS_DM_00326]).
O método é declarado como noexcept e, portanto, é seguro contra exceções, mas é explicitamente especificado como não seguro para threads (not thread-safe) ([SWS_DM_00322]). Os chamadores devem, portanto, assegurar que as chamadas de instância ocorram de forma sincronizada.
Esta nota de uso foi gerada automaticamente com base nos dados de especificação.
Method to indicate that this UdsTransportProtocolHandler should terminate. If UdsTransportProtocolHandler has stopped, it shall call UdsTransportProtocolMgr:: HandlerStopped(UdsTransportProtocolHandlerID).
After return from Stop(), the handler-plugin shall NOT call to UdsTransportProtocolMgr with any other method but UdsTransportProtocolMgr::HandlerStopped().
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: e507b828b86bProcedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método Stop da interface apext::diag::uds_transport::UdsTransportProtocolHandler sinaliza a uma instância de protocolo de transporte UDS que ela deve terminar [SWS_DM_00323]. A chamada é acionada pelo Diagnostic Management (DM) assim que este transita para o estado ApplicationState.kTerminating[SWS_DM_00333]. A função é sem parâmetros, não possui valor de retorno, é declarada como noexcept e especificada como segura contra exceções (exception safe) [SWS_DM_00323].
Para o contexto de chamada e a concorrência aplicam-se as seguintes condições:
Concorrência: A operação é especificada como não thread-safe (not thread-safe) [SWS_DM_00323].
Restrição de chamada: Após o retorno de Stop, o plug-in do manipulador não deve chamar nenhum outro método em apext::diag::uds_transport::UdsTransportProtocolMgr, com a única exceção da confirmação HandlerStopped[SWS_DM_01741][SWS_DM_00323].
A interação com o DM ocorre de forma assíncrona: após o manipulador ter desfeito suas conexões de rede e liberado recursos, ele deve notificar o DM via apext::diag::uds_transport::UdsTransportProtocolMgr::HandlerStopped, passando seu handlerId[SWS_DM_00314]. O DM aguarda obrigatoriamente esse callback de confirmação após a chamada de Stop antes de encerrar definitivamente o processo [SWS_DM_00340].
Este texto foi gerado automaticamente com base na especificação AUTOSAR Adaptive R25-11.
Transmit a UDS message via the underlying UDS Transport Protocol channel.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 5022cdfe42a5ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Em relação à ordem e ao ciclo de vida, o Diagnostic Manager só pode chamar Transmit depois que a inicialização do manipulador com kInitializeOk tiver sido concluída ([SWS_DM_01746]) e o método Start tiver sido chamado ([SWS_DM_01743]). Uma vez que a operação é especificada como not thread-safe e exception safe ([SWS_DM_00327]), a coordenação de ordens de envio paralelas deverá, segundo a interpretação, ocorrer do lado do chamador no Diagnostic Manager. Pergunta Q-6edd917928b60e55 (aberta)
A função não retorna nenhum valor de forma síncrona. O manipulador de transporte é obrigado a devolver o ponteiro da mensagem de forma assíncrona através de apext::diag::uds_transport::UdsTransportProtocolMgr::TransmitConfirmation ao Diagnostic Manager após a transmissão ([SWS_DM_00327], [SWS_DM_00312]). Em caso de envio bem-sucedido ao nível da rede, o resultado kTransmitOk é reportado, caso contrário kTransmitFailed ([SWS_DM_00351]).
Esta nota de uso baseia-se na especificação AUTOSAR Adaptive R25-11.
The message to be transmitted as a UdsMessage::Ptr (unique_ptr style). UdsTransportProtocolHandler has to give back this Uds Message::Ptr via UdsTransportProtocolMgr::Transmit Confirmation() to signal, that it is done with this message.
channelId
Identification of channel on which to transmit.
Rückgabewert
Typ
Beschreibung
None
Hinweise: This transmit API covers T_Data.req of ISO 14229-2[25] Figure 2.
Request a governed re-review of this record. The record is not changed immediately.
The handler ID used by DM to identify this handler. This is just a number/identification given by the DM core, when instantiating a UdsTransportProtocolHandler instance, to be able to distinguish it from other handler-plugins or built-in UdsTransportProtocolHandler implementation(s).
transportProtocolMgr
Reference to UdsTransportProtocolMgr owned by this DM, with which UdsTransportProtocolHandler instance shall interact.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Original em alemão