namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>}

Este namespace disponibiliza no Platform Health Management enumerações fortemente tipadas para checkpoints de entidades supervisionadas [SWS_PHM_00424]. Cada entidade supervisionada recebe sua própria enumeração com escopo com o tipo base std::uint32_t, cujos enumeradores declarados são reportados como pontos de controle à interface ara::phm::PhmSupervisedEntityInterface [SWS_PHM_00424], [SWS_PHM_00425]. Com a disponibilização estática no namespace com segurança de tipos, a confusão entre pontos de controle de diferentes entidades é evitada de forma confiável em tempo de compilação.

mais ›

Contexto

O namespace C++ namespace ara::phm::supervised_entities::{ <hierarchical-namespace-list-lower-skeleton>} serve, dentro do Platform Health Management (PHM) da AUTOSAR Adaptive Platform, como área dedicada para pontos de controle (checkpoints) com segurança de tipos de unidades funcionais supervisionadas (Supervised Entities). De acordo com [SWS_PHM_00424], este namespace contém enumerações com escopo no formato enum class {<phmssi-sn>} : std::uint32_t, as quais definem os checkpoints discretos para a interface ara::phm::PhmSupervisedEntityInterface. Para cada elemento configurado da lista de pontos de controle, existe uma declaração de enumerador C++ unívoca [SWS_PHM_00425]. A interação reúne três componentes funcionais centrais: o software de aplicação supervisionado (Supervised Entity), os checkpoints tipados modelados pelo namespace e a interface da plataforma ara::phm::PhmSupervisedEntityInterface, por meio da qual eventos de monitoramento são repassados ao serviço PHM.

Diagrama de contexto: Interação entre o software de aplicação supervisionado, a enumeração de checkpoints tipada e a interface da plataforma. Fontes: [SWS_PHM_00424], [SWS_PHM_00425]

Ciclo de vida

Os tipos e constantes dentro do namespace possuem caráter estático em tempo de compilação. Eles não estão sujeitos a um ciclo de vida dinâmico em tempo de execução por meio de alocação ou liberação na heap, mas são disponibilizados como enumerações com escopo tipadas do C++11 com o tipo base std::uint32_t [SWS_PHM_00424]. Interpretação: As definições são normalmente geradas de forma automatizada a partir da descrição de serviço do AUTOSAR durante o processo de build, uma vez que caminhos e identificadores dependem dos parâmetros de modelo da interface. Para a inclusão, o padrão disponibiliza para cada unidade supervisionada um arquivo de cabeçalho próprio sob #include "ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h", enquanto declarações de tipos gerais podem ser declaradas antecipadamente por meio do cabeçalho de encaminhamento #include "ara/phm/phm_fwd.h" [SWS_PHM_00424]. As constantes de enumerador ficam, assim, à disposição da aplicação de forma imutável durante todo o tempo de vida do processo [SWS_PHM_00425]. Pergunta (aberta)

Caminho de utilização

O caminho de utilização típico para componentes de software que atuam como Supervised Entity divide-se em três etapas consecutivas:

• Inclusão do cabeçalho: A aplicação inclui o cabeçalho gerado da unidade supervisionada por meio do caminho de arquivo ara/phm/supervised_entities/{ <si-namespace-derived-directory-path-lower>}/{<phmssi-sn>}.h ou do encaminhamento central ara/phm/phm_fwd.h [SWS_PHM_00424].
• Inicialização da interface: A aplicação instancia ou vincula a interface ara::phm::PhmSupervisedEntityInterface, para a qual os checkpoints da enumeração foram declarados [SWS_PHM_00424].
• Sinalização de checkpoints: Ao percorrer pontos de controle relevantes no algoritmo, a aplicação seleciona o respectivo enumerador {<symbol-phm-checkpoint>} do namespace [SWS_PHM_00425] e o reporta à instância de ara::phm::PhmSupervisedEntityInterface [SWS_PHM_00424].

Por meio da vinculação ao tipo base std::uint32_t [SWS_PHM_00424] e da atribuição explícita de valor de cada ponto de controle [SWS_PHM_00425], garante-se uma identificação com segurança de tipos e livre de equívocos dos respectivos passos do programa em tempo de execução.

Cenários de erro

Utilizações incorretas deste namespace resultam principalmente de configurações incorretas relacionadas a modelos e tipos. Como se trata de um enum class [SWS_PHM_00424], o sistema de tipos do C++ impede conversões implícitas de tipo; o uso de tipos de dados incorretos ou enumeradores de Supervised Entities externas é, portanto, interceptado já em tempo de compilação. Podem ocorrer erros de tempo de execução se a configuração na descrição do modelo não coincidir exatamente com a lista de enumeradores: de acordo com [SWS_PHM_00425], um enumerador correspondente deve ser declarado para cada checkpoint. Interpretação: Caso uma aplicação passe um valor de std::uint32_t não configurado no modelo para ara::phm::PhmSupervisedEntityInterface devido a uma conversão de tipo indevida ou arquivos de cabeçalho desatualizados, o serviço PHM provavelmente não conseguirá associar este checkpoint e interpretará isso como uma violação de monitoramento. Pergunta Q-b8fb7472f6ea8d10 (aberta)