classe ara::diag::Event

A classe ara::diag::Event fornece, no AUTOSAR Adaptive, operações para monitorar eventos de diagnóstico e seus status de debouncing e de erro. As aplicações instanciam o objeto por meio de um InstanceSpecifier, registram notificações opcionais de alteração e consultam informações de diagnóstico e de DTC de forma assíncrona [SWS_DM_00647]. Como restrição central, a instância não pode ser copiada nem movida, e a maioria dos métodos de consulta exige sincronização por parte da aplicação em caso de acesso concorrente, devido à falta de thread safety [SWS_DM_00649].

mais ›

Contexto

A classe ara::diag::Event serve, na AUTOSAR Adaptive Platform, como a interface primária para interação com eventos de diagnóstico. Ela atua como elo de ligação entre o software específico da aplicação e o gerenciamento central de diagnóstico. Por meio dessa interface, as aplicações monitoram o status atual de diagnóstico e de debouncing de um evento ou são informadas sobre alterações de status.

No contexto do sistema, três partes estão essencialmente envolvidas na interação:

• Software aplicativo: instancia a classe, inicia consultas de status e recebe atualizações assíncronas de status.
• ara::diag::Event: encapsula a porta de diagnóstico tipificada (PortPrototype de um DiagnosticEventInterface) e disponibiliza métodos de consulta entre threads e entre processos.
• Diagnostic Management (DM): executa no lado do servidor a detecção de erros, mapeamentos de DTC e o comportamento de debouncing.

Diagrama de contexto: enquadramento da classe Event entre o software aplicativo e o Diagnostic Management. Fontes: [SWS_DM_00647], [SWS_DM_00653]

Ciclo de vida

A instanciação ocorre explicitamente por meio da passagem de um ara::core::InstanceSpecifier [SWS_DM_00647]. O identificador deve fazer referência a um PortPrototype tipificado por meio de um DiagnosticEventInterface. O construtor é exception-safe e thread-safe [SWS_DM_00647].

Em relação às relações de posse, ara::diag::Event é definida como uma instância única não copiável e não movível: tanto o construtor de cópia [SWS_DM_01681] quanto o construtor de movimento [SWS_DM_01682], bem como os operadores de atribuição associados ([SWS_DM_01679], [SWS_DM_01680]), foram explicitamente excluídos (=delete). Um InstanceSpecifier não pode ser instanciado mais de uma vez por processo [SWS_DM_00647].

A destruição ocorre por meio do destrutor ~Event() [SWS_DM_00648]. Diferentemente do construtor, o destrutor não é thread-safe. As demais funções-membro (com exceção de GetDTCNumber) também são especificadas como não thread-safe, razão pela qual chamadas paralelas na mesma instância devem ser sincronizadas pela aplicação. No release R25-11, a terminologia relacionada foi harmonizada de reentrancy para concurrency AUTOSAR_AP_SWS_Diagnostics §1 «Change History».

Caminho de utilização

Um caso de utilização típico divide-se nas seguintes chamadas:

1. Inicialização: a aplicação cria a instância por meio de seu InstanceSpecifier [SWS_DM_00647]. A vinculação deve estabelecer a conexão com o daemon de diagnóstico no momento da inicialização. Pergunta Q-78e4462a0d147cfb (aberta)
2. Registrar notificador: para monitoramento, registra-se opcionalmente um callback por meio de SetEventStatusChangedNotifier [SWS_DM_00650]. Uma chamada subsequente sobrescreve o notificador definido anteriormente.
3. Consultas de estado: durante a operação, a aplicação consulta dados de diagnóstico de forma assíncrona por meio de ara::core::Future:
   • GetEventStatus() determina o byte de status atual [SWS_DM_00649].
   • GetDebouncingStatus() retorna o estado atual de debouncing [SWS_DM_00654].
   • GetFaultDetectionCounter() consulta o contador de detecção de falhas (FDC) [SWS_DM_00656].
   • GetTestComplete() verifica se o teste foi concluído (o FDC atinge -128 ou 127) [SWS_DM_00655].
   • GetDTCNumber(dtcFormat) fornece o número de DTC correspondente no formato selecionado e é implementado de forma thread-safe [SWS_DM_00653].

Diagrama de sequência: sequência típica de interação entre aplicação, instância de Event e Diagnostic Management. Fontes: [SWS_DM_00647], [SWS_DM_00650], [SWS_DM_00649], [SWS_DM_00653]

Cenários de erro

Condições de erro ocorrem na forma de violações de modelagem (violations) durante a instanciação ou como códigos de erro em tempo de execução:

• Violações na chamada do construtor [SWS_DM_00647]:
  • InstanceSpecifierMappingIntegrityViolation: o identificador não é resolvível no modelo ou não faz referência a um PortPrototype.
  • PortInterfaceMappingViolation: o PortPrototype referenciado não está tipificado como DiagnosticEventInterface.
  • ProcessMappingViolation: nenhum contexto modelado compatível com o processo foi encontrado.
  • InstanceSpecifierAlreadyInUseViolation: o identificador já está sendo utilizado por uma instância ativa no mesmo processo.
• Códigos de erro em tempo de execução via ara::core::Result ou ara::core::Future:
  • DiagErrc::kServiceNotAvailable: ocorre em todas as consultas de status ([SWS_DM_00649], [SWS_DM_00653], [SWS_DM_00654], [SWS_DM_00655], [SWS_DM_00656]) se funcionalidades essenciais de segundo plano do Diagnostic Management não estiverem disponíveis. Presume-se que a comunicação seja processada de forma assíncrona via IPC. Pergunta (aberta)
  • DiagErrc::kNoSuchDTC: é reportado por GetDTCNumber se nenhum DTC estiver configurado para o evento [SWS_DM_00653].
  • DiagErrc::kInvalidArgument: é retornado por SetEventStatusChangedNotifier, por exemplo, em caso de valores de passagem inválidos [SWS_DM_00650].