classe ara::diag::DoIPPowerMode

A classe de interface ara::diag::DoIPPowerMode permite que aplicações forneçam o modo de energia DoIP atual ao gerenciamento de diagnóstico por meio da função de callback GetDoIPPowerMode() [SWS_DM_00734]. Após a instanciação, o manipulador deve ser ativado via Offer() e cancelado antes da destruição via StopOffer() [SWS_DM_00735], [SWS_DM_00736]. Como instância única, a classe não é copiável nem movível [SWS_DM_01645].

mais ›

Contexto

A classe abstrata ara::diag::DoIPPowerMode define a interface para a disponibilização do modo de energia DoIP atual perante o Diagnostic Management (DM). Em arquiteturas veiculares que utilizam diagnóstico sobre Internet Protocol (DoIP), o protocolo de comunicação precisa estar informado sobre o estado operacional da rede do veículo ou sobre a alimentação de tensão. O software da aplicação deriva uma classe de manipulador concreta de ara::diag::DoIPPowerMode e implementa a consulta do modo de energia [SWS_DM_00734]. Os parceiros de interação são a aplicação de diagnóstico que fornece a interface, bem como o sistema de runtime do DM, que delega solicitações recebidas a este manipulador [SWS_DM_00735].

Ciclo de vida

Instâncias de ara::diag::DoIPPowerMode são criadas internamente na aplicação e identificadas por meio de um protótipo de porta referenciado por um ara::core::InstanceSpecifier [SWS_DM_00732]. Ao chamar o construtor, define-se pelo argumento ConcurrencyType se o método de callback GetDoIPPowerMode() deve ser executado de forma thread-safe (kConcurrent) ou não thread-safe (kNotConcurrent) [SWS_DM_00732]. O construtor em si é executado de forma thread-safe [SWS_DM_00732].

De acordo com a especificação, trata-se de uma instância não copiável e não movível: tanto o construtor de cópia [SWS_DM_01645] quanto o construtor de movimento [SWS_DM_01646], assim como os respectivos operadores de atribuição [SWS_DM_01643], [SWS_DM_01644], estão explicitamente excluídos (=delete).

Após a instanciação, o manipulador deve ser ativado via Offer() para que o DM possa encaminhar solicitações [SWS_DM_00735]. Para encerrar o encaminhamento de solicitações, StopOffer() é chamado [SWS_DM_00736]. O destruidor virtual ~DoIPPowerMode() [SWS_DM_00733], bem como Offer() e StopOffer(), são especificados como não thread-safe. Presumivelmente, StopOffer() deve sempre ser executado antes da chamada do destruidor, a fim de desconectar adequadamente interações pendentes com o DM. Pergunta Q-85ede935aa303c45 (aberta)

Caminho de utilização

O uso típico de ara::diag::DoIPPowerMode segue uma sequência fixa de inicialização, registro de serviço, consulta de modo cíclica ou baseada em eventos e cancelamento de registro:

1. A aplicação instancia sua classe derivada com o InstanceSpecifier apropriado e o ConcurrencyType desejado [SWS_DM_00732].
2. A aplicação registra ativamente o manipulador no gerenciamento de diagnóstico por meio de Offer() [SWS_DM_00735].
3. Assim que o protocolo DoIP necessita do status, o DM chama a função puramente virtual GetDoIPPowerMode() [SWS_DM_00734]. A implementação retorna um ara::core::Future<PowerModeType>, que é resolvido de forma assíncrona [SWS_DM_00734].
4. Ao encerrar a operação, a aplicação chama StopOffer() para não aceitar mais nenhuma solicitação [SWS_DM_00736].
5. A instância é liberada por meio do destruidor [SWS_DM_00733].

Diagrama de sequência: Fluxo típico de registro, consulta assíncrona de status e cancelamento de registro para DoIPPowerMode. Fontes: [SWS_DM_00732], [SWS_DM_00734], [SWS_DM_00735], [SWS_DM_00736], AUTOSAR_AP_SWS_Diagnostics §8.2 «DoIP Power Mode».

Cenários de erro

Ao chamar o construtor, podem ocorrer violações de modelo e de mapeamento que estão documentadas [SWS_DM_00732]:

• InstanceSpecifierMappingIntegrityViolation: O identificador não pode ser resolvido no contexto do executável ou não faz referência a um elemento PortPrototype [SWS_DM_00732].
• PortInterfaceMappingViolation: O PortPrototype referenciado não está tipado por um DiagnosticDoIPPowerModeInterface [SWS_DM_00732].
• ProcessMappingViolation: Existe uma referência de instância, porém nenhum processo modelado correspondente ao ambiente de execução [SWS_DM_00732].
• InstanceSpecifierAlreadyInUseViolation: O InstanceSpecifier já foi utilizado para outra instância dentro do mesmo processo [SWS_DM_00732].

Se Offer() for chamado enquanto o serviço já estiver sendo ativamente oferecido, o método retorna o código de erro DiagOfferErrc::kAlreadyOffered por meio do ara::core::Result [SWS_DM_00735]. Por outro lado, o método GetDoIPPowerMode() não define códigos de erro padronizados [SWS_DM_00734].