estrutura ara::diag::SovdSwUpdate::UpdatePackageStatus

A estrutura ara::diag::SovdSwUpdate::UpdatePackageStatus disponibiliza informações de estado, fase e progresso de um processo de atualização de software para aplicações de diagnóstico SOVD [SWS_DM_01902]. É obtida através da chamada de GetUpdatePackageStatus e permite a monitorização contínua de fases de execução, percentagens de progresso e passos individuais. Em caso de anomalia, a estrutura sinaliza a falha e transporta, através do campo de erro opcional, o código de erro exato do domínio DiagSovdErrc [SWS_DM_01909]. Como mero objeto de transferência de dados, a estrutura requer presumivelmente sincronização por parte da aplicação no caso de acesso concorrente. Pergunta Q-1d228b6cab1b505e (aberta)

mais ›

Contexto

A estrutura de dados ara::diag::SovdSwUpdate::UpdatePackageStatus é parte integrante do módulo diag da AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 «Struct: UpdatePackageStatus» [SWS_DM_01902]. No âmbito do Service-Oriented Vehicle Diagnostics (SOVD), funciona como um suporte de informação padronizado para o registo e a disponibilização do estado atual de um pacote de atualização de software. Através da função da API ara::diag::SovdSwUpdate::GetUpdatePackageStatus, o objeto de estado é gerado pela interface de diagnóstico e transmitido às instâncias consultoras SWS Diagnostics §8.58.2.1.3.5 «GetUpdatePackageStatus» [SWS_DM_01921].

Na arquitetura do sistema, a estrutura serve de elemento de desacoplamento entre o componente de serviço executor SovdSwUpdate e clientes de diagnóstico externos ou internos. Enquanto o serviço comanda o processamento efetivo do pacote e a instalação, UpdatePackageStatus encapsula um instantâneo das fases de processamento, dos progressos e de eventuais estados de erro [SWS_DM_01902].

Ciclo de vida

Como mero contentor de dados (struct), UpdatePackageStatus não possui lógica de estado interna própria e não efetua uma gestão de recursos independente SWS Diagnostics §8.58.5 «Struct: UpdatePackageStatus» [SWS_DM_01902]. As instâncias são criadas durante a chamada de GetUpdatePackageStatus, preenchidas com os valores de estado atuais e devolvidas por valor ao chamador [SWS_DM_01921]. O tempo de vida está vinculado ao escopo do recetor e cessa com a sua destruição.

Embora o objeto C++ seja passivo, as suas variáveis-membro representam o ciclo de vida do processo de atualização subjacente. O campo phase do tipo SovdUpdatePhase descreve a fase atual do processo global SWS Diagnostics §8.58.5.1.2 «phase» [SWS_DM_01903], ao passo que a variável status do tipo SovdUpdateStatus indica o estado concreto dessa fase SWS Diagnostics §8.58.5.1.4 «status» [SWS_DM_01904]. Dado que não estão especificados mutexes nem mecanismos de sincronização internos, um acesso concorrente à mesma instância requer uma salvaguarda externa por parte do utilizador.

Caminho de utilização

O caminho de utilização típico compreende a monitorização cíclica ou baseada em eventos de uma atualização de pacote por parte de um cliente de diagnóstico:

• Consulta de estado: O cliente chama o método GetUpdatePackageStatus na interface SovdSwUpdate SWS Diagnostics §8.58.2.1.3.5 «GetUpdatePackageStatus» [SWS_DM_01921].
• Avaliação de fase e de estado: Após receber o objeto [SWS_DM_01902], o cliente verifica as variáveis phase [SWS_DM_01903] e status [SWS_DM_01904] para determinar se o fluxo progride normalmente ou se está concluído.
• Análise de progresso: Se estiver disponível um progresso global percentual, este é avaliado através do membro opcional progress SWS Diagnostics §8.58.5.1.3 «progress» [SWS_DM_01905]. Subfases adicionais podem ser consultadas através do vetor subprogress [SWS_DM_01906].
• Apresentação do passo: Para fins de registo ou orientação do utilizador, recorre-se à designação textual do passo step [SWS_DM_01907] e à chave de localização step_translation_id [SWS_DM_01908].

Diagrama de sequência: Sequência de chamadas para consulta de estado e avaliação das variáveis-membro de um UpdatePackageStatus. Fontes: [SWS_DM_01921], [SWS_DM_01902], [SWS_DM_01904], [SWS_DM_01909].

Cenários de erro

Os erros no fluxo de atualização tornam-se transparentes através de atributos específicos da estrutura de dados:

• Estado com falha: Se o processo apresentar um problema, o campo status assume o estado «failed» [SWS_DM_01904].
• Detalhe do erro: Nesse cenário de erro, o campo error do tipo ara::core::Optional<ara::diag::DiagSovdErrc> especifica o código de erro ocorrido SWS Diagnostics §8.58.5.1.1 «error» [SWS_DM_01909].
• Fluxo regular: Desde que não ocorra qualquer erro, o campo opcional error deverá permanecer vazio, uma vez que, segundo a especificação, se encontra explicitamente associado ao estado «failed» [SWS_DM_01909]. Pergunta Q-c26d1c1d25d7e938 (aberta)
• Erro de interface: Se a chamada da API GetUpdatePackageStatus falhar ao nível da plataforma, deverá ser retornado um estado de erro específico da plataforma em vez de um objeto de estado [SWS_DM_01921]. Pergunta Q-b029f911ee738cb1 (aberta)