classe ara::diag::CommunicationControl

A classe ara::diag::CommunicationControl serve no AUTOSAR Adaptive como interface para o processamento do serviço UDS 0x28 (CommunicationControl) para a comutação de canais de comunicação [SWS_DM_00808]. Após a instanciação baseada em modelo via InstanceSpecifier, Offer() ativa o encaminhamento de requisições pelo Diagnostic Manager, que subsequentemente são processadas de forma assíncrona via CommCtrlRequest [SWS_DM_00806], [SWS_DM_00809]. Como elemento único estrito, a classe exclui operações de cópia e movimentação e exige um cancelamento de registro via StopOffer() antes da finalização [SWS_DM_00810].

mais ›

Contexto

A classe ara::diag::CommunicationControl define a interface padronizada para o processamento do serviço de diagnóstico UDS 0x28 (CommunicationControl) na AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics, p. 70. Como classe base abstrata, ela faz a mediação entre o Diagnostic Manager (DM) e a funcionalidade de diagnóstico específica da aplicação, com a qual se controla o envio ou recebimento de determinadas mensagens de comunicação na rede veicular. O software aplicativo deriva dessa classe e implementa o método puramente virtual CommCtrlRequest para receber e executar instruções de controle recebidas [SWS_DM_00808]. A vinculação ao modelo de sistema AUTOSAR ocorre por meio de um ara::core::InstanceSpecifier, que referencia um PortPrototype de um DiagnosticComControlInterface [SWS_DM_00806].

Ciclo de vida

Uma instância é criada explicitamente pelo construtor, especificando o ara::core::InstanceSpecifier bem como o modelo de concorrência ConcurrencyType (kConcurrent ou kNotConcurrent) [SWS_DM_00806]. A classe possui semântica estrita de instância única e não pode ser copiada nem movida: tanto o construtor de cópia [SWS_DM_01677] e o construtor de movimentação [SWS_DM_01678] quanto o operador de atribuição por cópia [SWS_DM_01675] e o operador de atribuição por movimentação [SWS_DM_01676] estão excluídos (=delete).

Após a criação, a instância permanece inicialmente inativa. Somente por meio da chamada de Offer() o Diagnostic Manager é autorizado a encaminhar requisições de diagnóstico recebidas para o handler [SWS_DM_00809]. Inversamente, StopOffer() revoga essa liberação e desativa o encaminhamento [SWS_DM_00810]. A destruição ocorre por meio do destrutor virtual [SWS_DM_00807]. Interpretação: É provável que seja necessário chamar StopOffer() antes da destruição do objeto, para que o Diagnostic Manager não mantenha encaminhamentos órfãos. Pergunta Q-f67e35c9fea508d8 (aberta)

Em relação à concorrência, o construtor é thread-safe [SWS_DM_00806], enquanto o destrutor [SWS_DM_00807], Offer() [SWS_DM_00809] e StopOffer() [SWS_DM_00810] não são thread-safe. A execução de CommCtrlRequest é condicionalmente thread-safe (conditional): se a implementação precisa ser thread-safe é determinado pelo ConcurrencyType definido no construtor [SWS_DM_00808].

Caminho de utilização

O fluxo regular abrange a instanciação da classe derivada, o registro do serviço, o processamento assíncrono de requisições de diagnóstico e o cancelamento final de registro:

1. Inicialização: A aplicação instancia o handler informando o InstanceSpecifier e o ConcurrencyType desejado [SWS_DM_00806].
2. Oferta de serviço: Por meio de Offer(), o serviço é ativado no Diagnostic Manager [SWS_DM_00809].
3. Processamento de requisições: Se chegar uma requisição UDS para o serviço 0x28 com qualquer subfunção, o Diagnostic Manager chama CommCtrlRequest [SWS_DM_00808]. Os parâmetros incluem:
   • controlType (ComCtrlRequestParamsType): Todos os parâmetros de requisição UDS, incluindo elementos opcionais.
   • metaInfo (const MetaInfo&): Metainformações sobre a requisição de diagnóstico.
   • cancellationHandler (CancellationHandler): Serve para consulta de status via IsCanceled(), bem como para o registro de uma função de retorno de cancelamento via SetNotifier().
4. Retorno: O processamento é concluído de forma assíncrona e reporta o resultado por meio de ara::core::Future<void> [SWS_DM_00808].
5. Cancelamento de registro: Antes do encerramento ou finalização, a aplicação interrompe o encaminhamento por meio de StopOffer() [SWS_DM_00810].

Diagrama de sequência: Fluxo típico desde a inicialização, passando pelo processamento da requisição UDS 0x28, até o cancelamento de registro. Fontes: [SWS_DM_00806], [SWS_DM_00808], [SWS_DM_00809], [SWS_DM_00810].

Cenários de erro

Já durante a construção, inconsistências no modelo AUTOSAR podem levar a violações em tempo de execução (Violations) [SWS_DM_00806]:

• InstanceSpecifierMappingIntegrityViolation: O InstanceSpecifier não pode ser resolvido no contexto do executável ou não aponta para um PortPrototype.
• PortInterfaceMappingViolation: O PortPrototype tipificado por DiagnosticComControlInterface não é referenciado por um DiagnosticServiceGenericMapping.
• ProcessMappingViolation: Existe uma referência de instância correspondente, mas não há processo modelado compatível com o processo atual.
• InstanceSpecifierAlreadyInUseViolation: o identificador já está sendo usado por outra instância no mesmo processo.

Durante a operação, Offer() reporta por meio do valor de retorno ara::core::Result<void> o erro DiagOfferErrc::kAlreadyOffered, caso o serviço já tenha sido oferecido anteriormente e ainda esteja ativo [SWS_DM_00809]. Se uma requisição de diagnóstico não puder ser atendida tecnicamente em CommCtrlRequest, o método retorna, por meio do ara::core::Future<void>, um Negative Response Code (NRC) em conformidade com a ISO 14229-1 via DiagUdsNrcErrc [SWS_DM_00808].