classe ara::diag::MultipleMonitor

usar

O método ara::diag::MultipleMonitor::ConfigureMonitor inicializa um monitor de diagnóstico para o debounce interno do monitor [SWS_DM_01696]. Através do parâmetro monitorHandle, é endereçado o monitor a ser configurado, enquanto com initMonitor é registrado um callback de notificação para reinicializações e com getFaultDetectionCounter uma função para consulta do valor atual do contador de falhas (FDC) [SWS_DM_01696]. A execução ocorre de forma síncrona e retorna um ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 «ConfigureMonitor».

Tratamento de erros e simultaneidade

Em caso de falha, o resultado de erro DiagErrc::kInvalidArgument é retornado [SWS_DM_01696]. Isto deve ocorrer em particular quando são passados ponteiros de função inválidos ou quando existem estados incompatíveis no debounce interno (interpretação). Pergunta Q-3de0f2b0cc427ef3 (aberta) A operação está especificada como noexcept bem como segura contra exceções (exception safe), mas explicitamente indicada como não segura para threads (not thread-safe) [SWS_DM_01696]. Chamadas na mesma instância de monitor devem, portanto, ser sincronizadas pelo lado da aplicação.

Ordem e interação

Cada sobrecarga de ConfigureMonitor só pode ser chamada exatamente uma vez para um monitor; o monitor só estará operacional após este passo de inicialização [SWS_DM_01696]. No caso de debounce interno do monitor, a aplicação Diagnostic Monitor processa a lógica de debounce de forma autônoma e transmite apenas os resultados finais ao Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 «Monitor-internal debouncing». Para outros mecanismos de debounce, estão disponíveis sobrecargas alternativas para monitoramentos baseados em tempo [SWS_DM_01697], baseados em contador [SWS_DM_01702] ou sem debounce [SWS_DM_01973].

usar

A função-membro síncrona ara::diag::MultipleMonitor::ConfigureMonitor do arquivo de cabeçalho ara/diag/multiple_monitor.h configura um monitor de diagnóstico com debounce baseado em tempo ([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)»). Na chamada, são passados o identificador monitorHandle para identificação do monitor, a função de callback initMonitor do tipo InitMonitorNotifier bem como os parâmetros de debounce defaultValues do tipo TimeBased ([SWS_DM_01697]). Como valor de retorno serve ara::core::Result<void>, e a assinatura da função é declarada como noexcept ([SWS_DM_01697]).

Condições de chamada e simultaneidade

Um monitor só pode ser utilizado após a conclusão deste passo de inicialização ([SWS_DM_01697]). Cada variante sobrecarregada de ConfigureMonitor só pode ser chamada exatamente uma vez por instância de monitor ([SWS_DM_01697]). Embora a interface seja segura contra exceções (exception safe), ela não é segura para threads (not thread-safe), de modo que chamadas paralelas na mesma instância devem ser sincronizadas pelo lado do usuário ([SWS_DM_01697]).

Tratamento de erros

Se a configuração falhar, a chamada retorna um objeto de erro dentro de ara::core::Result, em particular o código de erro DiagErrc::kInvalidArgument ([SWS_DM_01697]).

Interação

O método complementa as funções de inicialização alternativas para debounce baseado em contador ([SWS_DM_01702]), debounce interno do monitor ([SWS_DM_01696]), bem como monitores sem debounce ([SWS_DM_01973]). Para eventos com debounce baseado em tempo, o Diagnostic Manager suporta adicionalmente o congelamento intencional do temporizador de debounce ([SWS_DM_00880]) e a sua posterior continuação a partir do estado congelado ([SWS_DM_00038]).

O método síncrono ConfigureMonitor da classe ara::diag::MultipleMonitor serve para a inicialização de um monitor de diagnóstico com debounce baseado em contador ([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 «ConfigureMonitor»). A declaração é disponibilizada através do arquivo de cabeçalho ara/diag/multiple_monitor.h ([SWS_DM_01702]).

Utilização e parâmetros

A função recebe os seguintes parâmetros de transferência ([SWS_DM_01702]):

• monitorHandle (MonitorHandleType): Identifica o monitor de diagnóstico a ser configurado.
• initMonitor (InitMonitorNotifier): Registra uma função de callback de notificação para a inicialização do monitor.
• defaultValues (CounterBased): Passa valores de configuração padrão para o debounce baseado em contador.

Como valor de retorno, a operação fornece um ara::core::Result<void>, que informa sobre o sucesso ou erro ([SWS_DM_01702]).

Tratamento de erros

Se a configuração falhar, um erro é reportado no valor de retorno. Em caso de argumentos inválidos, o código de erro DiagErrc::kInvalidArgument é retornado ([SWS_DM_01702]). A função é declarada como noexcept e garante segurança contra exceções (exception safe) ([SWS_DM_01702]).

Simultaneidade e restrições

Cada sobrecarga de ConfigureMonitor deve obrigatoriamente ser chamada apenas exatamente uma vez para um monitor; o monitor só pode ser utilizado após este passo de inicialização ([SWS_DM_01702]). Como a operação é classificada como não segura para threads (not thread-safe) ([SWS_DM_01702]), é provável que seja necessária uma sincronização externa quando ocorrerem chamadas através de limites de threads (interpretação). Pergunta Q-fcb809ccb021dd6d (aberta)

Interação

O método é parte da interface de configuração em MultipleMonitor. Ele complementa sobrecargas relacionadas para debounce baseado em tempo com TimeBased ([SWS_DM_01697]), para debounce interno do monitor com função de leitura ([SWS_DM_01696]), bem como para monitores totalmente sem mecanismo de debounce ([SWS_DM_01973]).

O método síncrono ConfigureMonitor serve para a inicialização de um monitor de diagnóstico sem debounce dentro de ara::diag::MultipleMonitor ([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)»). Ele recebe como parâmetros de entrada o identificador do monitor (monitorHandle), bem como uma função de callback (initMonitor) para o registro de uma notificação InitMonitorNotifier ([SWS_DM_01973]). Apenas após este passo de inicialização obrigatório o respectivo monitor poderá ser utilizado ativamente ([SWS_DM_01973]).

Em relação ao contexto de chamada e à concorrência, aplicam-se as seguintes condições de contorno:

• Cada sobrecarga de ConfigureMonitor pode ser chamada exatamente uma vez para cada monitor individual ([SWS_DM_01973]).
• O método está especificado como exception safe, mas classificado como not thread-safe ([SWS_DM_01973]). Portanto, um acesso concorrente ao mesmo monitor provavelmente exigirá uma sincronização externa pela aplicação. Pergunta Q-2272f26f380a5a11 (aberta)

A função retorna como resultado um ara::core::Result<void> ([SWS_DM_01973]). Se a configuração falhar, um erro é retornado, por exemplo DiagErrc::kInvalidArgument ([SWS_DM_01973]). Se for necessário um procedimento de debounce para o monitor de diagnóstico, estão disponíveis, em vez disso, as variantes sobrecarregadas para debounce interno do monitor ([SWS_DM_01696]), debounce baseado em tempo ([SWS_DM_01697]) ou debounce baseado em contador ([SWS_DM_01702]).

A função Offer ativa o encaminhamento de requisições de diagnóstico recebidas pelo Diagnostic Management Daemon (DM) para o respectivo handler [SWS_DM_01699]. A chamada síncrona não possui parâmetros e é especificada como noexcept com segurança de exceção (exception safe) [SWS_DM_01699].

Em caso de sucesso, a função retorna um ara::core::Result<void> vazio [SWS_DM_01699]. Se o registro para o handler já tiver sido executado com sucesso anteriormente, a chamada falha e retorna o código de erro DiagOfferErrc::kAlreadyOffered com semântica de rollback [SWS_DM_01699]; esse estado de erro está ancorado no domínio de erros de diagnóstico [SWS_DM_00514].

Em relação à concorrência, o método é declarado como not thread-safe [SWS_DM_01699]. Interpretação: chamadas na mesma instância de handler presumivelmente não devem ocorrer desprotegidas a partir de diferentes threads, para evitar inconsistências no estado de registro. Pergunta Q-95f2e0895004c73b (aberta)

O padrão do método Offer corresponde ao mecanismo uniforme de disponibilização para handlers de diagnóstico no AUTOSAR Adaptive, conforme utilizado analogamente, por exemplo, para rotinas genéricas [SWS_DM_00557] ou serviços UDS [SWS_DM_00619]. Embora a nomenclatura se baseie na disponibilização de serviços em ara::com, trata-se de uma implementação própria e específica de diagnóstico AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

A função [SWS_DM_01698] serve em ara::diag::MultipleMonitor para reportar informações de status e comandos de debouncing para um monitor de diagnóstico específico ao Diagnostic Manager (DM). Por meio do parâmetro monitorHandle é endereçado o monitor de destino, enquanto action passa o resultado de teste (não) qualificado ou comandos para debouncing e pré-armazenamento.

Em relação ao comportamento de falhas, chamadas com monitorHandle inválido são ignoradas pelo DM [SWS_DM_01698]. Se for passada uma ação não suportada pelo procedimento de debouncing configurado, o DM dispara uma violação (Violation) [SWS_DM_01988]. Além disso, condições de ativação (enable conditions) não satisfeitas podem fazer com que mensagens sejam descartadas (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 «EnableConditions»), o que corresponde a códigos de erro internos [SWS_DM_00514].

Quanto à concorrência e execução:

• O método está declarado como noexcept e, portanto, é seguro contra exceções [SWS_DM_01698].
• A segurança de threads é condicional: se as chamadas precisam ser seguras para threads é determinado pelo ConcurrencyType passado no construtor [SWS_DM_01698].
• Na interação com o debouncing baseado em contador, a mensagem kPrefailed, por exemplo, leva ao incremento do contador interno [SWS_DM_00875]. Interpretação: os mecanismos de debouncing e condições de ativação definidos para monitores individuais presumem-se idênticos para a instância múltipla controlada por handles. Pergunta Q-ff29529143d35ca2 (aberta)

O método StopOffer da classe ara::diag::MultipleMonitor serve para desativar o encaminhamento de mensagens de requisição do Diagnostic Management (DM) para o handler [SWS_DM_01700]. Ele constitui a contrapartida funcional do oferecimento da interface e permite que a aplicação cesse deliberadamente o processamento de requisições de diagnóstico recebidas.

O uso está sujeito às seguintes características e condições de contorno:

• Assinatura e contexto de chamada: a função é declarada por meio do cabeçalho ara/diag/multiple_monitor.h e possui a assinatura void StopOffer() noexcept; [SWS_DM_01700]. Ela não recebe parâmetros e não fornece valor de retorno. A chamada é executada de forma síncrona.
• Tratamento de erros: o método é especificado como noexcept e seguro quanto a exceções (exception safe) [SWS_DM_01700]. Ele não lança exceções e não prevê códigos de erro ou mensagens de erro específicos.
• Concorrência: o elemento é explicitamente classificado como não seguro para threads (not thread-safe) [SWS_DM_01700]. Uma chamada concorrente na mesma instância provavelmente terá de ser sincronizada externamente pela aplicação. Pergunta Q-b73ead392f8b95b2 (aberta)

A semântica de StopOffer segue o padrão de projeto uniforme para handlers de diagnóstico no AUTOSAR Adaptive, no qual os serviços são controlados por meio de Offer e StopOffer AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». O mesmo princípio de desativação do encaminhamento de requisições encontra-se em portas correlatas, como ara::diag::Monitor::StopOffer [SWS_DM_01089], bem como em rotinas genéricas [SWS_DM_00558] e serviços UDS [SWS_DM_00620].