classe <RoutineInterface-Namespace>::<RoutineInterface>

A função construtora [SWS_DM_00589] serve para a instanciação de uma interface de rotina (DiagnosticRoutine) através de um identificador de instância. A declaração é especificada como noexcept e é considerada segura contra exceções (exception safe), bem como segura para threads (thread-safe) SWS Diagnostics §8.30.2.2.1.8 «{<routine-interface-name-1>}».

Parâmetros e chamada

• instanceSpec (ara::core::InstanceSpecifier): Identificador da instância de serviço específica que está vinculada a uma porta de modelo correspondente.
• concurrencyType (ara::diag::ConcurrencyType): Determina se a interface é executada de forma concorrente ou segura para threads (kConcurrent) ou se não é segura para threads (kNotConcurrent).

Verificações de tempo de execução e de modelo

Durante a construção, o framework verifica a configuração do modelo e do processo. Em caso de associações incorretas ou reutilizações múltiplas, são disparadas violações (Violations) específicas [SWS_DM_00589]:

• InstanceSpecifierMappingIntegrityViolation: O InstanceSpecifier não pode ser resolvido no contexto do executável ou não aponta para um PortPrototype.
• PortInterfaceMappingViolation: Um PortPrototype tipificado por DiagnosticRoutineInterface não é referenciado por um DiagnosticServiceGenericMapping.
• ProcessMappingViolation: Não existe nenhum processo modelado correspondente em tempo de execução para a referência de instância existente.
• InstanceSpecifierAlreadyInUseViolation: O InstanceSpecifier especificado já está a ser utilizado por uma instância existente dentro do processo atual.

Utilização e semântica

O método Offer habilita o Diagnostic Management (DM) a encaminhar requisições de diagnóstico recebidas para o manipulador de rotinas correspondente [SWS_DM_00594]. A chamada é síncrona e sem parâmetros através da interface tipada da rotina, e não lança exceções (noexcept) [SWS_DM_00594]. Como tipo de retorno serve ara::core::Result<void>, sinalizando a conclusão bem-sucedida ou retornando um código de erro em caso de falha [SWS_DM_00594].

Tratamento de erros

Se Offer for chamado para uma instância de rotina que já foi disponibilizada ativamente ao DM, o registro falha. Nesse caso, o método retorna o código de erro DiagOfferErrc::kAlreadyOffered com semântica de rollback [SWS_DM_00594] (definido com o valor 101 no contexto geral do domínio de erros de diagnóstico [SWS_DM_00514]).

Simultaneidade e restrições

Embora a função esteja especificada como segura contra exceções (exception safe), ela está expressamente declarada como não thread-safe (not thread-safe) [SWS_DM_00594]. Várias chamadas na mesma instância não podem ser executadas concorrentemente de forma desprotegida. Como a especificação não prevê uso concorrente, o registro presumivelmente ocorre tipicamente de forma síncrona durante a fase de inicialização da aplicação processadora. Pergunta Q-6a0f15497f03ac09 (aberta)

Interação no módulo de diagnóstico

O padrão de disponibilização via Offer é unificado no gerenciamento de diagnóstico AUTOSAR em diferentes tipos de interface, como em rotinas genéricas [SWS_DM_00557], elementos de dados [SWS_DM_00597], DataIdentifiers [SWS_DM_00599] e serviços UDS genéricos [SWS_DM_00619]. Embora a nomenclatura seja inspirada em ara::com, trata-se de uma funcionalidade específica de diagnóstico que não deve ser confundida com a mediação geral de serviços AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

usar

O método de interface RequestResult serve para fornecer a funcionalidade RoutineControl para consulta de resultados de rotina dentro de uma interface de diagnóstico tipificada [SWS_DM_00593]. Na chamada para processamento da subfunção UDS requestRoutineResults (Service 0x31, cf. [SWS_DM_00575]), são passados os argumentos de entrada ordenados do respectivo ArgumentDataPrototype, metainformações via metaInfo, bem como um cancellationHandler AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 «RequestResult».

Por meio do objeto cancellationHandler, a implementação pode verificar ativamente via IsCanceled se a conversação de diagnóstico em andamento foi cancelada, ou registrar via SetNotifier uma função de notificação que é chamada no caso de cancelamento [SWS_DM_00593]. A execução ocorre de forma assíncrona e retorna um ara::core::Future que, em caso de sucesso, contém o objeto de resultado conforme [SWS_DM_00583] [SWS_DM_00593].

Tratamento de erros

Se ocorrer um erro durante o processamento, o ara::core::Future é resolvido com um erro correspondente. Isso inclui Negative Response Codes (NRCs de acordo com a ISO 14229-1) via ara::diag::DiagUdsNrcErrc ou erros específicos da aplicação via Ap ApplicationError [SWS_DM_00593].

Simultaneidade e restrições

O método é declarado como noexcept e considerado seguro contra exceções (exception safe), mas expressamente não é thread-safe (not thread-safe) AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 «RequestResult». Devido a essa classificação, o componente chamador deve ser responsável por uma sincronização adequada em caso de chamadas paralelas na mesma instância. Pergunta Q-aa5788303ddff2bc (aberta)

A função virtual pura Start no escopo de classe <RoutineInterface-Namespace>::<RoutineInterface> serve para disponibilizar uma operação RoutineControl no papel Start para rotinas de diagnóstico específicas do modelo ([SWS_DM_00591]). Ela é declarada por meio do cabeçalho <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h ([SWS_DM_00591]). A chamada passa os argumentos de entrada ordenados da respectiva rotina, informações de contexto de diagnóstico via metaInfo, bem como o objeto cancellationHandler para controle de cancelamentos de conversação ([SWS_DM_00591]).

Por meio do parâmetro cancellationHandler, a implementação pode verificar com cancellationHandler.IsCanceled se a conversação associada foi cancelada, retornando TRUE em caso de cancelamento e FALSE caso contrário ([SWS_DM_00591]). Adicionalmente, pode-se registrar com cancellationHandler.SetNotifier uma função de notificação que é disparada em caso de cancelamento ([SWS_DM_00591]). O retorno assíncrono ocorre por meio de um ara::core::Future, que, em caso de sucesso, disponibiliza o objeto de resultado gerado StartOutput de acordo com [SWS_DM_00581] ([SWS_DM_00591]).

Em caso de erro, o ara::core::Future deve ser preenchido com um Negative Response Code (NRC) apropriado de ara::diag::DiagUdsNrcErrc conforme a ISO 14229-1 ou um ApplicationError específico da aplicação ([SWS_DM_00591]). O método é especificado como noexcept e exception safe, mas é considerado not thread-safe ([SWS_DM_00591]). Interpretação: A partir da classificação como not thread-safe, deduz-se que chamadas concorrentes à mesma instância devem ser sincronizadas externamente. Pergunta Q-124d8076818ac2e1 (aberta) Enquanto esta interface atende a rotinas geradas especificamente para o modelo, GenericRoutine::Start oferece a contraparte funcional para rotinas de diagnóstico tratadas genericamente ([SWS_DM_00554]).

O método Stop serve para fornecer a funcionalidade RoutineControl para interromper uma rotina de diagnóstico dentro de uma interface de rotinas tipificada ([SWS_DM_00592]). Uma chamada deverá tipicamente ser disparada pelo daemon do Diagnostic Management ao receber uma solicitação de diagnóstico UDS correspondente (subfunção 0x02), de forma análoga à contraparte genérica [SWS_DM_00555]. Pergunta Q-cd626f527c6dfe92 (aberta)

A chamada ocorre de forma assíncrona e retorna um ara::core::Future ([SWS_DM_00592]):

• Parâmetros: Além dos argumentos de entrada específicos do modelo {<routine-interface-stop-in-arg-symbol-0toN>}, são passadas metainformações da solicitação (metaInfo), bem como um cancellationHandler ([SWS_DM_00592]). Através do cancellationHandler, a implementação pode consultar ativamente um cancelamento via IsCanceled ou registar uma notificação com SetNotifier caso a conversação de diagnóstico seja cancelada.
• Valor de retorno: Em caso de interrupção bem-sucedida, o Future disponibiliza um objeto StopOutput tipificado ([SWS_DM_00582]).

Tratamento de erros: Se a interrupção falhar, o Future retornado contém um Negative Response Code (NRC) aplicável de acordo com a ISO 14229-1 via ara::diag::DiagUdsNrcErrc ou um Ap ApplicationError específico do modelo ([SWS_DM_00592]).

Concorrência e restrições: A função é especificada como exception safe, mas explicitamente como not thread-safe ([SWS_DM_00592]). Chamadas múltiplas ou concorrentes na mesma instância de interface devem ser coordenadas pelo chamador, e a rotina deve libertar eventuais recursos ou responder a solicitações de cancelamento do manipulador.

O método StopOffer no escopo de <RoutineInterface> serve para desativar o encaminhamento de mensagens de solicitação de diagnóstico do Diagnostic Management (DM) para a implementação da rotina [SWS_DM_00595]. A função não possui parâmetros de entrada e não retorna nenhum valor [SWS_DM_00595].

• Uso e contexto de chamada: A chamada ocorre de forma síncrona para cancelar o registro da interface de rotina junto ao DM. A declaração é feita no arquivo de cabeçalho <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h [SWS_DM_00595]. Embora a nomenclatura seja inspirada nos métodos de serviço de ara::com, trata-se de uma API específica de diagnóstico do DM, que não deve ser confundida com o gerenciamento de comunicação (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»).
• Tratamento de erros: A operação é declarada como noexcept e classificada como segura quanto a exceções (exception safe) [SWS_DM_00595]. Códigos de erro ou mensagens de erro específicos não são definidos para este método.
• Simultaneidade e restrições: A função é especificada como não thread-safe (not thread-safe) [SWS_DM_00595]; portanto, chamadas na mesma instância requerem sincronização externa. Interpretação: Os chamadores provavelmente devem concluir de forma ordenada as execuções de rotinas em andamento antes da chamada, uma vez que o padrão descreve apenas a desativação do mecanismo de encaminhamento. Pergunta Q-b0f524c0f2d7af52 (aberta)
• Interação: O padrão de disponibilização e desregistro corresponde à abordagem padronizada no Diagnostic Management, conforme prescrito de forma análoga para rotinas genéricas [SWS_DM_00558], serviços UDS genéricos [SWS_DM_00620] e identificadores de dados [SWS_DM_00600].