AUTOSAR RTE

A função Rte_Start aloca e inicializa os recursos de sistema e de comunicação utilizados pela RTE [SWS_Rte_03015]. A API é sempre gerada [SWS_Rte_01309], possui a assinatura Std_ReturnType Rte_Start (void) [SWS_Rte_02569] e deve obrigatoriamente retornar dentro de um tempo de execução finito sem loop infinito [SWS_Rte_02585].

A função pode ser chamada em cada Core exatamente uma vez pelo EcuStateManager a partir de um contexto de OS confiável, após todos os módulos de Basic Software necessários pela RTE terem sido inicializados [SWS_Rte_CONSTR_09035]. A chamada é executada de forma independente em cada Core [SWS_Rte_07615] e realiza as atividades de inicialização específicas de partição para todas as partições atribuídas a este Core [SWS_Rte_07616].

Durante o fluxo, a RTE inicializa as variáveis alocadas para blocos de RAM dependendo da estratégia configurada [SWS_Rte_07632]. Após as inicializações de variáveis, mas ainda antes da execução de Runnables, a RTE chama as funções de inicialização Rte_Rips_Rte_Start de todos os RTE Implementation Plug-Ins participantes [SWS_Rte_80052]. Em seguida, a RTE ativa uma única vez todos os Runnables disparados por InitEvent [SWS_Rte_06761] e inicia a transição para os modos iniciais [SWS_Rte_06766]. Caso a API Rte_StartTiming não exista, Rte_Start também inicia a ativação de Runnables disparados por TimingEvent [SWS_Rte_07575] ou BackgroundEvent [SWS_Rte_07178].

Para o tratamento de erros, a RTE ou o SchM, com RteDevErrorDetectUninit ativado, reporta o erro RTE_E_UNINIT (0x07) se Rte_Start for chamado antes de SchM_Init [SWS_Rte_07683]. Antes da execução de Rte_Start, APIs de tempo de execução da RTE não devem ser chamadas, pois caso contrário isso também leva a RTE_E_UNINIT [SWS_Rte_07682]; Rte_SetMirror, por outro lado, já pode ser chamado antes de Rte_Start [SWS_Rte_07319].

A função Rte_Stop ([SWS_Rte_02570]) é gerada em qualquer configuração ([SWS_Rte_01310]) e serve para finalizar a RTE no Core executor ([SWS_Rte_01262]). Com isso, são liberados todos os recursos de sistema e de comunicação alocados pela RTE neste Core ([SWS_Rte_01262]). A chamada síncrona tem retorno garantido dentro de um tempo de execução finito ([SWS_Rte_02584]).

No sistema global, Rte_Stop deve ser chamada pelo EcuStateManager antes que os módulos de Basic Software necessários pela RTE sejam desativados ([SWS_Rte_CONSTR_09038]). Durante o fluxo, a RTE chama as funções de parada Rte_Rips_Rte_Stop de todos os RTE-Implementation-Plug-Ins participantes ([SWS_Rte_80053]), que devem disponibilizar essas interfaces de ciclo de vida ([SWS_Rte_70047]). Apenas após a conclusão total de Rte_Stop é que SchM_Deinit pode ser executado ([SWS_Rte_CONSTR_09056]).

Após a chamada de Rte_Stop em um Core, a RTE não ativará, iniciará ou liberará mais nenhuma instância de RunnableEntity ali ([SWS_Rte_02538]). Sem ser afetado por isso, Rte_GetMirror continua chamável, desde que o sistema operacional subjacente esteja ativo ([SWS_Rte_07350]).

Em caso de erro, a função retorna RTE_E_LIMIT caso um limite interno tenha sido excedido ou a alocação de um recurso necessário falhe ([SWS_Rte_01262]). Se RteDevErrorDetectUninit estiver ativado, a RTE reporta o erro RTE_E_UNINIT (0x07) se APIs inválidas forem chamadas após Rte_Stop ([SWS_Rte_07682]).

A função Rte_StartTiming serve para, após a conclusão da inicialização da RTE, liberar a ativação de RunnableEntitys disparados por TimingEvents ou BackgroundEvents ([SWS_Rte_06753], [SWS_Rte_06756]). Ela é implementada como uma função sem parâmetros e sem valor de retorno ([SWS_Rte_06754], [SWS_Rte_06758]) e deve retornar dentro de um tempo de execução finito ([SWS_Rte_06757]).

Em relação ao contexto de chamada e à ordem, a API está sujeita a condições de contorno estritas:

• A função só pode ser chamada após a RTE ter sido completamente inicializada, concretamente após a conclusão da chamada de Rte_Start ([SWS_Rte_CONSTR_09061]).
• Ela é prevista para ser executada após a última chamada de uma função Rte_Init ([SWS_Rte_06753]).
• A API é gerada ou disponibilizada assim que pelo menos uma API Rte_Init for gerada ([SWS_Rte_06755]).

Se Rte_StartTiming for chamada, ela inicia imediatamente as ativações periódicas e baseadas em segundo plano ([SWS_Rte_06759], [SWS_Rte_06760]). Se, por outro lado, a API não existir na configuração, a chamada de Rte_Start assume a liberação dos runnables disparados por TimingEvents e BackgroundEvents ([SWS_Rte_07178], [SWS_Rte_07575]). Códigos de erro ou valores de retorno específicos não estão definidos para esta chamada ([SWS_Rte_06754]).

Utilização e semântica

A função SchM_Init aloca e inicializa os recursos de sistema utilizados pelo Basic Software Scheduler (SchM) da RTE no Core chamador ([SWS_Rte_08060]). A interface é sempre gerada ([SWS_Rte_07271]) e possui a assinatura void SchM_Init(const SchM_ConfigType* ConfigPtr) ([SWS_Rte_07270]). Ela é executada de forma síncrona e deve obrigatoriamente retornar dentro de um tempo de execução finito, sem entrar em loop infinito ([SWS_Rte_07273]).

Durante o fluxo de inicialização, SchM_Init executa as seguintes etapas:

• Inicia para cada instância de máquina de modos pertencente ao Basic Software Scheduler a transição para o modo inicial ([SWS_Rte_07532]).
• Inicia a ativação de instâncias de BswSchedulableEntity acionadas por eventos de BswBackgroundEvent ([SWS_Rte_07584]).
• Chama as funções de inicialização Rte_Rips_SchM_Init de todos os RTE Implementation Plug-Ins envolvidos ([SWS_Rte_80051]).

Contexto de chamada e condições de ordenação

O SchM_Init pode ser chamado em cada Core apenas exatamente uma vez pelo EcuStateManager, assim que os módulos BSW necessários pelo Basic Software Scheduler tiverem sido inicializados ([SWS_Rte_CONSTR_09055]). APIs subsequentes, tais como Rte_Start, só podem ser chamadas após a conclusão completa de SchM_Init ([SWS_Rte_CONSTR_09036]).

Tratamento de erros

Se SchM_Init for chamado com um ponteiro NULL como parâmetro, o Basic Software Scheduler reporta o erro RTE_E_DET_ILLEGAL_VARIANT_CRITERION_VALUE (0x02) ([SWS_Rte_07684]). Se APIs do Scheduler (como SchM_Switch, SchM_Mode ou SchM_Start) ou Rte_Start forem chamadas antes de SchM_Init, com o RteDevErrorDetectUninit ativado é reportado o erro RTE_E_UNINIT (0x07) ([SWS_Rte_07683]).

usar

A função SchM_Start serve para a colocação em funcionamento do Basic Software Scheduler no módulo RTE e é fundamentalmente sempre disponibilizada no âmbito da geração de interfaces [SWS_Rte_04547]. Ela apresenta a assinatura C sem parâmetros void SchM_Start(void) [SWS_Rte_04546] e não retorna nenhum valor. Para a execução, aplica-se a determinação vinculativa de que a chamada deve retornar dentro de um tempo de execução finito e em hipótese alguma deve entrar em um loop infinito [SWS_Rte_04548]. Na ausência de mecanismos de callback assíncronos, presume-se que se trate de uma chamada de inicialização síncrona bloqueante. Pergunta Q-b6ad9ed696841d7a (aberta)

Contexto de chamada e concorrência

Para o contexto de chamada e a interação com outros componentes do sistema, aplicam-se restrições estritas:

• Chamador e frequência: a função pode ser chamada em cada núcleo de processador exclusivamente pelo EcuStateManager e apenas exatamente uma vez em cada [SWS_Rte_CONSTR_09055].
• Condições de ordem: a chamada só pode ocorrer após todos os módulos de Basic Software terem sido completamente inicializados que sejam necessários pela parte do Basic Software Scheduler da RTE [SWS_Rte_CONSTR_09055].
• Interação na inicialização do sistema: após a execução, o Basic Software Scheduler fica operacional; a chamada deve ocorrer obrigatoriamente antes da inicialização do BSW Manager via BswM_Init() [SWS_Rte_07273].

Tratamento de erros

Códigos de erro específicos, valores de retorno ou notificações para o DET ou DEM não estão definidos no payload para esta função.

usar

A função SchM_StartTiming possui a assinatura sem parâmetros void SchM_StartTiming(void) [SWS_Rte_04549] e é sempre gerada pelo gerador da RTE [SWS_Rte_04550]. A sua chamada inicia eventos periódicos para o BSW e para SWCs [SWS_Rte_04548], desencadeando a ativação de instâncias de BswSchedulableEntity acionadas por BswTimingEvents [SWS_Rte_07574]. A função tem de retornar dentro de um tempo de execução finito e não pode executar nenhum ciclo infinito [SWS_Rte_04551].

Contexto de chamada e restrições

Antes da chamada de SchM_StartTiming, SchM_Init tem de ter sido obrigatoriamente chamado [SWS_Rte_04548]. Além disso, aplica-se a restrição vinculativa de que SchM_StartTiming apenas pode ser chamada em cada Core exatamente uma vez pelo EcuStateManager, após terem sido inicializados todos os módulos de software básico necessários para o Basic Software Scheduler [SWS_Rte_CONSTR_09055].

Tratamento de erros

Se SchM_StartTiming for chamada antes de SchM_Init, o Basic Software Scheduler ou a RTE reporta o erro RTE_E_UNINIT (0x07), desde que a deteção de erros de desenvolvimento RteDevErrorDetectUninit esteja ativada [SWS_Rte_07683].

Utilização e âmbito de funções

A função SchM_Deinit destina-se a finalizar a parte do Basic Software Scheduler da RTE no Core em que é chamada [SWS_Rte_04551]. Durante este procedimento, o serviço libera todos os recursos de sistema que foram ocupados pelo escalonador de BSW nesse Core [SWS_Rte_04551]. A função não possui parâmetros nem valor de retorno (void SchM_Deinit(void)) [SWS_Rte_07274] e é, por princípio, sempre gerada pelo gerador da RTE [SWS_Rte_07275]. No que diz respeito ao comportamento temporal, a especificação exige que SchM_Deinit retorne dentro de um tempo de execução finito [SWS_Rte_07277].

Contexto de chamada e condições de ordenação

Para a chamada durante a fase de desligamento da ECU, aplicam-se regras de ordenação vinculativas:

• A função SchM_Deinit só pode ser utilizada após a RTE ter sido completamente finalizada, ou seja, após o término de Rte_Stop [SWS_Rte_CONSTR_09056].
• A chamada deve ser efetuada pelo EcuStateManager antes de serem encerradas as camadas base necessárias para o funcionamento do Basic Software Scheduler [SWS_Rte_CONSTR_09057].
• Após SchM_Deinit ter sido chamada num Core, o escalonador de BSW nesse Core já não pode ativar nem iniciar quaisquer instâncias de BswSchedulableEntity [SWS_Rte_07586].

Limpeza de plug-ins

No âmbito da desinicialização, a RTE chama obrigatoriamente, dentro de SchM_Deinit, as funções Rte_Rips_SchM_Deinit de todos os RTE Implementation Plug-Ins participantes, a fim de concluir a sua limpeza [SWS_Rte_80054].

A função de handler <name of the Invocation Handler> assume, no módulo Rte, a chamada síncrona de diferentes tipos de runnable através de um transformador [SWS_Rte_89015]. Entre as unidades suportadas estão server runnables, hard-error runnables, ASCR runnables bem como runnables acionados por disparo [SWS_Rte_89015].

A interface não possui parâmetros de entrada, de entrada/saída ou de saída e não retorna nenhum valor (assinatura void (void)) [SWS_Rte_89015]. A chamada é processada de forma síncrona e é identificada pelo ID de serviço 0xEE [SWS_Rte_89015]. A declaração é disponibilizada através do arquivo de cabeçalho Rte_Rips_<PlugIn>.h [SWS_Rte_89015].

Em relação à concorrência, a função é declarada como condicionalmente reentrante (Conditional Reentrant) [SWS_Rte_89015]. Isto deve significar que uma chamada concorrente só é permitida se existirem contextos de execução diferentes ou instâncias de plug-in separadas. Pergunta Q-24aabb36a2be58f4 (aberta) O identificador <name of the Invocation Handler> bem como a designação do cabeçalho <PlugIn> representam marcadores de posição; o nome real é presumivelmente estabelecido na configuração do plug-in.

A função Rte_Rips_SchM_Deinit serve para a desinicialização dos componentes de um RTE Implementation Plug-In que são relevantes para as operações do Basic Software Scheduler (SchM) [SWS_Rte_89019]. Ela pertence às interfaces obrigatórias de ciclo de vida que devem ser disponibilizadas por todo RTE Implementation Plug-In além de Rte_Rips_SchM_Init, Rte_Rips_Rte_Start e Rte_Rips_Rte_Stop [SWS_Rte_70047].

Para a integração e utilização, aplicam-se as seguintes definições:

• Contexto de chamada e fluxo: A interface possui a assinatura void Rte_Rips_SchM_Deinit (void), não recebe parâmetros e não retorna nenhum valor [SWS_Rte_89019]. Ela é executada de forma síncrona [SWS_Rte_89019]. A chamada não é realizada por componentes de software, mas é coordenada pela RTE dentro de SchM_Deinit para todos os plug-ins participantes [SWS_Rte_80054].
• Inclusão de arquivo e identificador: A declaração está disponível por meio do cabeçalho Rte_Rips_<PlugIn>.h; a função possui o Service-ID 0xF3 [SWS_Rte_89019].
• Simultaneidade e restrições: A função é especificada como não reentrante (Non Reentrant) [SWS_Rte_89019]. Disso provavelmente deduz-se que, durante a chamada em SchM_Deinit, nenhuma atividade concorrente do SchM pode mais acessar o plug-in. Pergunta Q-60aec1abc9e891b2 (aberta)
• Tratamento de erros: A especificação não prevê códigos de erro nem valores de retorno para Rte_Rips_SchM_Deinit e não define mensagens de erro para o DET ou DEM [SWS_Rte_89019].

O tipo de dados Rte_Rips_SwitchNotificationStatusType ([SWS_Rte_91113]) é baseado em uint8 e é disponibilizado por meio de Rte_Type.h. Ele serve para sinalizar o status de operações de enqueue e dequeue em uma fila de modos (Mode Queue) no contexto de RTE Implementation Plug-Ins.

O intervalo de valores compreende códigos de status para ambas as direções de operação ([SWS_Rte_91113]):

• RTE_SWITCH_NOTIFICATION_SKIP (0x00): a notificação de mudança de modo não pode ser desenfileirada.
• RTE_SWITCH_NOTIFICATION_ENQUEUED_FIRST (0x01): A notificação foi enfileirada em uma fila vazia.
• RTE_SWITCH_NOTIFICATION_ENQUEUED_NOT_FIRST (0x02): A notificação foi enfileirada em uma fila já ocupada.
• RTE_SWITCH_NOTIFICATION_ENQUEUE_FAILED (0x03): o enfileiramento em uma fila não vazia falhou.
• RTE_SWITCH_NOTIFICATION_DEQUEUED_LAST (0x04): A última notificação de mudança de modo foi retirada da fila.
• RTE_SWITCH_NOTIFICATION_DEQUEUED_NOT_LAST (0x05): Uma notificação foi retirada; outras notificações permanecem na fila.

Em termos de uso, o tipo surge em duas interfaces síncronas e reentrantes: a função Rte_Rips_<PlugIn>_Switch_<BswSwcI>_<MMI> ([SWS_Rte_91114]) recebe o status como parâmetro de entrada switchNotificationStatus para notificar o plug-in sobre procedimentos de enqueue. Em contrapartida, a função Rte_Rips_<PlugIn>_DequeueModeSwitch_<MMI>_<OsTask> ([SWS_Rte_91115]) fornece o tipo como valor de retorno quando, após o término da última On-Entry ExecutableEntity, uma notificação é retirada da fila.

Erros no enfileiramento são reportados funcionalmente por meio do valor de estado RTE_SWITCH_NOTIFICATION_ENQUEUE_FAILED ([SWS_Rte_91113]); entradas específicas de DET ou DEM não estão indicadas no payload. Interpretação: o texto da especificação “was enqueued from mode queue” nas constantes de dequeue deve ter motivação redacional e refere-se à operação de retirada. Pergunta Q-6e9e040dcd341f66 (aberta) O elemento bem como as interfaces associadas estão marcados como rascunho (Draft) ([SWS_Rte_91113]).

O tipo de dados Rte_DsmqStatusType é baseado em uint8 e é definido conforme [SWS_Rte_80085] bem como [SWS_Rte_91102] juntamente com seus literais no arquivo de cabeçalho Rte_Type.h. Ele serve para sinalizar o status de operações de enqueue e dequeue para notificações de mudança de modo em uma Distributed Shared Mode Queue (DSMQ) [SWS_Rte_91102].

O intervalo de valores compreende os seguintes literais [SWS_Rte_91102]:

• RTE_DSMQ_ENQUEUED_FIRST (0x01): A notificação foi enfileirada em uma DSMQ previamente vazia.
• RTE_DSMQ_ENQUEUED_NOT_FIRST (0x02): O enfileiramento ocorreu em uma DSMQ já preenchida (não vazia).
• RTE_DSMQ_ENQUEUE_FAILED (0x03): O enfileiramento em uma DSMQ não vazia falhou.
• RTE_DSMQ_DEQUEUED_LAST (0x04): a última notificação de mudança de modo foi desenfileirada da DSMQ.
• RTE_DSMQ_DEQUEUED_NOT_LAST (0x05): Uma notificação foi retirada enquanto outras notificações permanecem na fila.

Para o tratamento de erros, o literal RTE_DSMQ_ENQUEUE_FAILED sinaliza uma falha no processo de enfileiramento quando a fila não está vazia [SWS_Rte_91102].

O tipo é utilizado como parâmetro de passagem dsmqstatus em interfaces do RTE Implementation Plug-In (RIPS). A função Rte_Rips_<PlugIn>_DsmqSwitch_<BswSwcI>_<MMI> informa o plug-in de forma síncrona sobre o enfileiramento em uma DSMQ [SWS_Rte_91103]. Além disso, Rte_Rips_<PlugIn>_DsmqTransitionEnd_<BswSwcI>_<MMI> notifica de forma síncrona a conclusão de uma transição de modo em uma DSMQ-Transition-OsTask ao RIPS [SWS_Rte_91106]. Ambos os serviços de callback são declarados como síncronos e reentrantes [SWS_Rte_91103], [SWS_Rte_91106].