namespace ara::exec

O namespace disponibiliza interfaces para a gestão de processos e o controlo de grupos de funções na AUTOSAR Adaptive Platform. Os processos utilizam o cliente para, após uma inicialização bem-sucedida, comunicar o seu estado de execução kRunning ao Execution Management [SWS_EM_02000]. O State Management solicita transições de grupos de funções através de interfaces, enquanto transições de estado inadmissíveis ou erros de comunicação são registados através de códigos de erro padronizados [SWS_EM_02281]. O cumprimento rigoroso da ordem de transição é estritamente obrigatório.

mais ›

Contexto

O namespace ara::exec disponibiliza as interfaces do Execution Management na AUTOSAR Adaptive Platform. O módulo é responsável pelo arranque, controlo e monitorização de processos, bem como pela coordenação de estados de sistema e de grupos de funções de nível superior. Entre os intervenientes centrais contam-se os processos de aplicação, o State Management e o próprio Execution Management. Os processos utilizam a classe ExecutionClient para comunicar o seu estado de runtime interno ao Execution Management. O State Management utiliza, por sua vez, a interface StateClient para solicitar transições de estado entre grupos de funções (FunctionGroup e FunctionGroupState). Para eventos de erro ao nível de um grupo de funções, é utilizado o alias de tipo ExecutionError [SWS_EM_02541], que pode ser transportado via ExecutionErrorEvent.

Ciclo de vida

O ciclo de vida de execução de um processo é controlado pelo Execution Management [SWS_EM_02000]. Após o escalonamento, um processo recém-iniciado encontra-se inicialmente num estado implícito Initializing, no qual ainda não foi executado código de programa aplicativo. O Execution Management assume que este estado de inicialização perdura até que o processo reporte ativamente o estado ExecutionState::kRunning através do seu ExecutionClient [SWS_EM_02000]. A enumeração ExecutionState limita-se estritamente aos estados que podem ser comunicados pelos processos ao Execution Management, contendo por isso exclusivamente o estado kRunning [SWS_EM_02000]. Se o Execution Management solicitar a finalização, o processo transita para a fase Terminating, que conclui com o término definitivo do processo [SWS_EM_02000].

Diagrama de estados: ciclo de vida de um processo sob a perspetiva do Execution Management com estados implícitos e a comunicação de kRunning. Fontes: [SWS_EM_02000]

Caminho de utilização

Um fluxo típico de utilização divide-se nas seguintes fases:

• Após o arranque do sistema, o processo é criado pelo Execution Management e procede à sua inicialização interna [SWS_EM_02000].
• Assim que a inicialização estiver concluída com sucesso, o processo comunica o estado ExecutionState::kRunning ao Execution Management através de uma instância de ExecutionClient [SWS_EM_02000].
• O Execution Management confirma esta transição; contudo, se kRunning for comunicado quando o processo já se encontra em execução, tal é rejeitado como transição inadmissível ExecErrc::kInvalidTransition [SWS_EM_02281].
• No funcionamento subsequente, o State Management solicita, se necessário, transições coordenadas de estado para grupos de funções através de StateClient.

Diagrama de sequência: sequência de chamadas na comunicação de estado através do ExecutionClient e tratamento de transições incorretas. Fontes: [SWS_EM_02000], [SWS_EM_02281]

Cenários de erro

Situações de erro são mapeadas no namespace ara::exec através do tipo de enumeração ExecErrc e do domínio de erro ExecErrorDomain [SWS_EM_02281]. Uma referência para o objeto de domínio global é fornecida pela função GetExecErrorDomain() [SWS_EM_02290], segura para threads e exceções. Objetos de erro concretos do tipo ara::core::ErrorCode são criados através da função auxiliar MakeErrorCode() com a passagem do código de erro e de dados de contexto específicos do fabricante [SWS_EM_02291]; para o tratamento de exceções está adicionalmente disponível a classe ExecException.

Entre as causas de erro especificadas contam-se, nomeadamente, [SWS_EM_02281]:

• ExecErrc::kNoCommunication: sinaliza erro de comunicação entre o cliente e o Execution Management ou entre o State Management e o Execution Management. Ao nível do sistema, um tal estado exigirá provavelmente a entrada num estado irrecuperável [SWS_EM_02281]. Pergunta Q-ad08207b6a16c6f9 (aberta)
• ExecErrc::kInvalidTransition: transição inválida, por exemplo, se um processo comunicar kRunning repetidamente [SWS_EM_02281].
• ExecErrc::kOperationFailed: uma operação falha, por exemplo, se uma transição de grupo de funções não puder ser concluída porque kRunning não foi comunicado atempadamente [SWS_EM_02281].
• ExecErrc::kOperationCanceled: uma mudança de estado de um grupo de funções foi abortada por uma solicitação mais recente [SWS_EM_02281].
• ExecErrc::kIntegrityOrAuthenticityCheckFailed: a verificação de integridade ou autenticidade de um processo a iniciar falha [SWS_EM_02281].
• ExecErrc::kUnexpectedTermination: cancelamento anormal durante uma transição [SWS_EM_02281].
• ExecErrc::kInvalidMetaModelIdentifier bem como ExecErrc::kInvalidArgument: identificadores de metamodelo inadmissíveis ou valores de parâmetros inválidos [SWS_EM_02281].