classe ara::diag::SovdSwUpdate

A função puramente virtual DeleteUpdatePackage da classe ara::diag::SovdSwUpdate é chamada pela instância do Diagnostic Server de acordo com [SWS_DM_01803] quando o método SOVD “Delete Update Package from an SOVD Server” deve ser executado ([SWS_DM_01922]). Ela inicia a remoção de um pacote de atualização no lado do servidor.

A chamada ocorre de forma assíncrona e retorna um ara::core::Future<void>, que indica a conclusão bem-sucedida ou disponibiliza um objeto de erro [SWS_DM_01922]. A assinatura requer os seguintes parâmetros de entrada:

• updatePackageId: Designa como ara::core::String o ID unívoco do pacote de atualização a ser excluído.
• metaInfo: Passa como MetaInfo const& informações de contexto adicionais da requisição.
• cancellationHandler: Transmite um objeto do tipo CancellationHandler, que informa se a conversa atual foi cancelada.

Se ocorrer um erro durante o processamento, o Future é preenchido com um erro SOVD correspondente. Para isso, a especificação prescreve o uso de códigos de erro adequados da ASAM SOVD 1.1 ou ISO 17978-3 [SWS_DM_01922].

Em relação à concorrência, o método é definido como condicionalmente thread-safe: se a implementação deve ser executada como thread-safe ou non-thread-safe é determinado por meio do ConcurrencyType passado no construtor [SWS_DM_01922]. Além disso, a função é declarada como noexcept e segura contra exceções, razão pela qual nenhuma exceção pode escapar.

usar

O método pure-virtual ExecuteUpdatePackage da interface ara::diag::SovdSwUpdate serve para executar o método SOVD “Execute Installation of an Update” [SWS_DM_01920]. A declaração encontra-se no cabeçalho ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 «ExecuteUpdatePackage». Como parâmetros de entrada, são passados o identificador do pacote de atualização (updatePackageId) e dados da requisição (metaInfo) [SWS_DM_01920]. Adicionalmente, o objeto cancellationHandler informa caso a conversa em andamento tenha sido cancelada [SWS_DM_01920]. A chamada ocorre de forma assíncrona e retorna um ara::core::Future<void>, que disponibiliza um resultado positivo ou reporta um erro SOVD [SWS_DM_01920].

Tratamento de erros

A interface é especificada como noexcept e segura contra exceções (“exception safe”) [SWS_DM_01920]. Consequentemente, erros durante a execução não devem ser lançados por meio de exceções C++, mas sim retornados assincronamente via ara::core::Future com códigos de erro aplicáveis da ASAM SOVD 1.1 ou ISO 17978-3 [SWS_DM_01920].

Simultaneidade e condições marginais

Em relação à segurança de threads, existe um requisito condicional (“conditional”): se a função deve ser implementada como thread-safe ou não-thread-safe é determinado por meio do parâmetro ConcurrencyType passado ao construtor [SWS_DM_01920]. A implementação presumivelmente deverá avaliar o cancellationHandler para finalizar de forma ordenada a instalação do pacote em caso de cancelamento da conversa [SWS_DM_01920]. Pergunta Q-8fe6950e8f5a168c (aberta)

A função-membro ara::diag::SovdSwUpdate::Offer registra o handler para atualizações de software SOVD no Diagnostic Management (DM), para permitir a este o encaminhamento de mensagens de requisição de entrada para o handler [SWS_DM_01924]. A chamada ocorre de forma síncrona e sem parâmetros através do cabeçalho ara/diag/sovd_sw_update.h e, de acordo com noexcept, não lança exceções C++ [SWS_DM_01924].

O resultado da operação é retornado como ara::core::Result<void> [SWS_DM_01924]. Se a disponibilização falhar, a função retorna um erro com semântica de rollback [SWS_DM_01924]:

• DiagOfferErrc::kAlreadyOffered: O serviço já foi oferecido com sucesso anteriormente para este handler [SWS_DM_01924].
• DiagOfferErrc::kConfigurationMismatch: A configuração de monitoramento não coincide com a configuração DEXT [SWS_DM_01924].

Em relação à concorrência, o método é especificado como exception safe, mas expressamente como não seguro para threads (not thread-safe) [SWS_DM_01924]. Interpretação: em acessos a partir de múltiplas threads, presumivelmente deverá ser necessária uma sincronização externa no lado da aplicação. O princípio de disponibilização via Offer corresponde ao esquema geral para handlers de diagnóstico, tais como [SWS_DM_00557] ou [SWS_DM_00735], nos quais o DM só pode encaminhar requisições assim que a respectiva interface for oferecida ativamente [SWS_DM_01525]. Pergunta Q-4636ad27701d59df (aberta)

O método puramente virtual PrepareUpdatePackage da interface ara::diag::SovdSwUpdate serve para preparar a instalação de um pacote de atualização de software no âmbito do método SOVD “Prepare Installation of an Update” de acordo com [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 «PrepareUpdatePackage»).

Chamada e parâmetros

A função é disponibilizada por meio do cabeçalho ara/diag/sovd_sw_update.h e aceita os seguintes parâmetros:

• updatePackageId: Identificador (ara::core::String) do pacote de atualização a ser preparado.
• metaInfo: Metadados (MetaInfo const&) para a requisição SOVD de entrada.
• cancellationHandler: Objeto de monitoramento (CancellationHandler) que informa sobre o cancelamento da conversa atual.

A chamada é especificada como noexcept e comporta-se de forma exception-safe. O resultado assíncrono é disponibilizado por meio de um ara::core::Future<void>, que sinaliza a conclusão bem-sucedida ou fornece um erro [SWS_DM_01919].

Tratamento de erros e simultaneidade

Se ocorrer um erro durante a preparação, deve ser retornado no Future um código de erro adequado de acordo com a ASAM SOVD 1.1 ou ISO 17978-3 [SWS_DM_01919]. Em relação à segurança de threads, aplica-se um requisito condicional (conditional): se a função deve ser implementada como thread-safe é determinado por meio do ConcurrencyType especificado no construtor durante a instanciação [SWS_DM_01919]. Por meio do objeto cancellationHandler, a aplicação presumivelmente deverá ser capaz de cancelar etapas demoradas de preparação, caso a requisição seja finalizada prematuramente. Pergunta Q-be4c53d9a0427ed5 (aberta)

usar

O método puramente virtual PutUpdatePackageAutomated é chamado no contexto do método SOVD “Automated Installation of an Update” [SWS_DM_01918]. Ele é declarado no cabeçalho ara/diag/sovd_sw_update.h dentro da classe ara::diag::SovdSwUpdate AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated». A função serve para instalar de forma automatizada um pacote de atualização especificado por seu identificador.

A interface espera os seguintes parâmetros de entrada:

• updatePackageId (ara::core::String): Identificador do pacote de atualização a ser passado para a instalação automatizada [SWS_DM_01918].
• metaInfo (MetaInfo const &): Metainformações da requisição de serviço de entrada [SWS_DM_01918].
• cancellationHandler (CancellationHandler): Informa a operação se a conversa em andamento foi cancelada [SWS_DM_01918].

A chamada possui semântica assíncrona. Como valor de retorno, serve um ara::core::Future<void> que, após a conclusão, indica a execução bem-sucedida ou contém um estado de erro [SWS_DM_01918].

Tratamento de erros e simultaneidade

Em caso de falha, deve ser retornado por meio do Future um código de erro aplicável da ASAM SOVD 1.1 ou ISO 17978-3 [SWS_DM_01918]. O método é especificado como seguro contra exceções (exception safe) e, como função noexcept, não lança exceções C++ AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated».

A segurança de threads do método é condicional (conditional): se a execução da implementação deve ser thread-safe ou non-thread-safe é determinado por meio do ConcurrencyType passado na chamada do construtor [SWS_DM_01918].

A função puramente virtual RequestUpdatePackageRegistration da classe ara::diag::SovdSwUpdate atende ao método SOVD “Register an Update at the SOVD Server” [SWS_DM_01923]. Ela inicia o registro de um pacote de atualização no servidor e dá início à respectiva sessão de transferência AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 «RequestUpdatePackageRegistration».

A chamada ocorre de forma assíncrona e retorna um ara::core::Future que, em caso de sucesso, contém uma tupla composta por uma DataTransferWriteSession e uma ara::core::String com o ID do pacote de atualização [SWS_DM_01923]. Na chamada, são passados os seguintes parâmetros:

• metaInfo: Metainformações da requisição de entrada.
• expectedSize: Tamanho total esperado opcional do pacote (ara::core::Optional<uint64_t>), caso declarado na requisição.
• cancellationHandler: Sinaliza caso a conversa atual seja cancelada.

O método é definido como noexcept e seguro contra exceções [SWS_DM_01923]. Consequentemente, os erros não são reportados por meio de exceções C++, mas sim disponibilizados assincronamente via Future; para isso, devem ser empregados os códigos de erro correspondentes da ASAM SOVD 1.1 ou ISO 17978-3 [SWS_DM_01923].

A segurança de threads é condicional (“conditional”): se o método deve ser implementado como thread-safe é determinado por meio do ConcurrencyType especificado no construtor [SWS_DM_01923]. A implementação concreta, portanto, presumivelmente deverá exigir mecanismos de sincronização próprios, dependendo da instanciação. Pergunta Q-7e80e557bdd7627a (aberta)

usar

O método ara::diag::SovdSwUpdate::StopOffer encerra a oferta do serviço e desativa o encaminhamento de mensagens de requisição de entrada do Diagnostic Management (DM) para o componente de atualização de software [SWS_DM_01925]. A chamada ocorre por meio da interface de ara/diag/sovd_sw_update.h, não possui parâmetros e não fornece valor de retorno [SWS_DM_01925]. O encerramento da disponibilização do serviço ocorre de forma síncrona e corresponde à desativação conceitual de funcionalidades de diagnóstico no AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Tratamento de erros e simultaneidade

A função possui a especificação noexcept e é, portanto, segura contra exceções; estados de erro por meio de exceções ou códigos de erro não estão previstos [SWS_DM_01925]. Para o contexto de chamada, aplica-se que a função é definida como não segura para threads (“not thread-safe”) [SWS_DM_01925]. Chamadas paralelas na mesma instância devem ser sincronizadas no lado da aplicação. Interpretação: uma chamada repetida de StopOffer no estado já inativo presumivelmente deverá permanecer sem efeito de erro, visto que não existe tratamento de erros. Pergunta Q-efaccde5507eb444 (aberta)

Interação

No sistema como um todo, a função integra-se ao esquema uniforme do ciclo de vida de serviços do DM. Ela constitui a contraparte funcional da oferta do serviço e comporta-se de forma análoga às operações de desativação de outros serviços de diagnóstico, tais como ara::diag::DownloadService [SWS_DM_00793], ara::diag::GenericUDSService [SWS_DM_00620] bem como ara::diag::EcuResetRequest [SWS_DM_01017].