Watchdog Manager (WdgM)

usar

A função WdgM_Init inicializa o Watchdog Manager de forma síncrona e não é reentrante [SWS_WdgM_00151]. O único parâmetro de entrada utilizado é ConfigPtr, que referencia os dados de configuração post-build (WdgM_ConfigType) [SWS_WdgM_00151]. A função formalmente não possui valor de retorno (void) [SWS_WdgM_00151].

Tratamento de erros e condições de contorno

Antes da inicialização, o Watchdog Manager deve encontrar-se no estado WDGM_GLOBAL_STATUS_DEACTIVATED: se o parâmetro de configuração de desenvolvimento WdgMDevErrorDetect estiver desativado e o módulo não estiver neste estado, WdgM_Init retorna sem qualquer efeito [SWS_WdgM_00390].

Caso o comutador de configuração WdgMOffModeEnabled não esteja ativado e o modo inicial predefinido via ConfigPtr desativasse o watchdog (WDGIF_OFF_MODE), a função aborta sem qualquer ação adicional e reporta o erro de tempo de execução WDGM_E_DISABLE_NOT_ALLOWED ao Default Error Tracer (DET) [SWS_WdgM_00030]. O retorno com E_NOT_OK exigido na especificação deverá ser entendido, em termos de interpretação, como uma interrupção interna por erro, uma vez que a assinatura prescreve void [SWS_WdgM_00151]. Pergunta Q-83a164f8f4669d4d (aberta)

Interação e ordem

• Diagnóstico de erros antes da inicialização: a função WdgM_GetFirstExpiredSEID() deve estar disponível antes da chamada de WdgM_Init para ler o Supervised Entity ID (SEID) que expirou anteriormente [SWS_WdgM_00348].
• Limpeza da RAM: durante a inicialização, WdgM_Init limpa o valor de SEID duplamente invertido da primeira entidade expirada, armazenado na RAM não inicializada [SWS_WdgM_00370].
• Notificação de estado ao DEM: na primeira chamada de WdgM_MainFunction após WdgM_Init, o módulo reporta ao DEM [SWS_WdgM_00408] o estado PASSED para WDGM_E_SUPERVISION se o parâmetro WdgMDemStoppedSupervisionReport estiver definido.

usar

A função síncrona WdgM_DeInit serve para a desinicialização do Watchdog Manager [SWS_WdgM_00261]. A interface possui o Service-ID 0x01, é disponibilizada através do arquivo de cabeçalho WdgM.h e não recebe parâmetros de entrada nem retorna um valor ao chamador [SWS_WdgM_00261]. Como contexto de chamada, presume-se que esteja prevista a sequência ordenada de shutdown da unidade de comando, na qual os monitoramentos ativos são encerrados de forma controlada antes do desligamento. Pergunta Q-50d7e49c71d2dfd3 (aberta)

Escopo funcional e interação

No âmbito da desinicialização, o módulo WdgM para completamente as funções de monitoramento (Supervision Functions) em todos os algoritmos de monitoramento (Supervision Algorithms) configurados e encerra, simultaneamente, a operação do watchdog (Watchdog Handling) [SWS_WdgM_00407].

Tratamento de erros e condições de contorno

Se o Watchdog Manager já se encontrar no estado global WDGM_GLOBAL_STATUS_DEACTIVATED no momento da chamada, o comportamento dependerá do parâmetro de configuração WdgMDevErrorDetect: se essa detecção de desenvolvimento estiver desativada, WdgM_DeInit retorna imediatamente e sem qualquer efeito [SWS_WdgM_00388].

Em relação à concorrência, está definido que a função é não reentrante [SWS_WdgM_00261]. A chamada não deve, portanto, ocorrer de forma interruptiva ou paralela a partir de múltiplos contextos sob hipótese alguma.

Utilização e semântica

A função WdgM_SetMode serve para a comutação síncrona do Watchdog Manager para um dos modos de operação configurados ([SWS_WdgM_00154]). Como parâmetro de passagem, ela espera Mode do tipo WdgM_ModeType. O valor de retorno Std_ReturnType sinaliza com E_OK a realização bem-sucedida da mudança de modo e com E_NOT_OK uma falha ([SWS_WdgM_00154]).

Restrições e tratamento de erros

A função não é reentrante (Non Reentrant) ([SWS_WdgM_00154]). A execução está vinculada ao status global atual do Watchdog Manager:

• Se o módulo não estiver nem no status WDGM_GLOBAL_STATUS_OK nem em WDGM_GLOBAL_STATUS_FAILED, a função retorna sem executar nenhuma ação ([SWS_WdgM_00145]).
• Se o parâmetro de configuração WdgMDevErrorDetect estiver desativado, uma chamada no status WDGM_GLOBAL_STATUS_DEACTIVATED permanece sem qualquer efeito ([SWS_WdgM_00392]).

Interação e impactos

Se houver um status global válido (WDGM_GLOBAL_STATUS_OK ou WDGM_GLOBAL_STATUS_FAILED), WdgM_SetMode atualizará as entidades monitoradas bem como os watchdogs:

• Para cada Supervised Entity ativada no modo de destino, o estado atual é mantido ([SWS_WdgM_00182]).
• Para cada Supervised Entity desativada no modo de destino, o estado local muda para WDGM_LOCAL_STATUS_DEACTIVATED; os resultados de Active, Deadline e Logical Supervision são definidos como corretos e o contador de ciclos de falha é redefinido para 0 ([SWS_WdgM_00315]). A mudança para um modo com desativação da entidade também limpa erros que anteriormente levaram a WDGM_GLOBAL_STATUS_FAILED ([SWS_WdgM_00182]).
• Por fim, os parâmetros configurados do modo de watchdog para cada hardware watchdog são ativados por meio da interface WdgIf_SetMode ([SWS_WdgM_00186]).

Utilização e semântica

A função síncrona reporta ao Watchdog Manager o alcance de um checkpoint dentro de uma Supervised Entity [SWS_WdgM_00263]. Recebe como parâmetros de entrada o identificador da entidade monitorizada (SEID), bem como o identificador do checkpoint alcançado (CheckpointID), e retorna E_OK em caso de atualização bem-sucedida do contador de alive ou E_NOT_OK em caso de erros [SWS_WdgM_00263].

Tratamento de erros e estado

Se o Watchdog Manager estiver no estado WDGM_GLOBAL_STATUS_DEACTIVATED, o comportamento depende da configuração do identificador de desenvolvimento: com WdgMDevErrorDetect ativado, a função reporta o erro WDGM_E_UNINIT ao Default Error Tracer (DET) e retorna sem qualquer outro efeito [SWS_WdgM_00279]. Se WdgMDevErrorDetect estiver desativado, o retorno ocorre sem mensagem e sem qualquer efeito [SWS_WdgM_00394].

Concorrência e deadlines

A chamada está especificada como reentrante [SWS_WdgM_00263]. Para determinar timestamps e diferenças de tempo na monitorização de deadline, a função utiliza a função do OS GetElapsedValue com o CounterID configurado para a entidade [SWS_WdgM_00373]. O escalonamento das diferenças de tempo para os valores-limite ocorre através do parâmetro OsSecondsPerTick [SWS_WdgM_00374]. Se um checkpoint final de deadline atingir a chamada no modo ativo e o timestamp do checkpoint inicial correspondente for 0, a função termina com sucesso sem medição de diferença [SWS_WdgM_00354].

Utilização e contexto de chamada

A função síncrona WdgM_PerformReset instrui o Watchdog Manager a provocar o disparo de um reset de watchdog [SWS_WdgM_00264]. A interface é declarada através do cabeçalho WdgM.h e possui o Service-ID 0x0f [SWS_WdgM_00264]. Ela não recebe parâmetros de entrada nem de saída e não retorna nenhum valor [SWS_WdgM_00264].

Simultaneidade e restrições

Como WdgM_PerformReset está definida como não reentrante (Non Reentrant), não deve ocorrer nenhuma chamada múltipla concorrente ou interruptiva [SWS_WdgM_00264]. Os chamadores devem, portanto, assegurar que as chamadas sejam sincronizadas ou emitidas de forma exclusiva a partir de um contexto apropriado.

Comportamento dependente do estado e tratamento de erros

A execução está sujeita aos estados globais do Watchdog Manager: se o parâmetro de configuração WdgMDevErrorDetect estiver desativado e o módulo se encontrar no status global WDGM_GLOBAL_STATUS_DEACTIVATED, a função retorna sem qualquer efeito [SWS_WdgM_00401]. Nesse caso, um reset deixa completamente de ocorrer. O comportamento com a detecção de desenvolvimento ativada (WdgMDevErrorDetect) não está especificado no payload; interpretação: nesse caso, presume-se que um erro de desenvolvimento correspondente seja reportado no estado desativado. Pergunta Q-8a726bba4154540f (aberta)

Utilização e execução cíclica

A função WdgM_MainFunction executa as tarefas periódicas do Watchdog Manager [SWS_WdgM_00159]. Possui a assinatura void WdgM_MainFunction(void), não recebe parâmetros, não retorna nenhum valor e é disponibilizada através do cabeçalho SchM_WdgM.h [SWS_WdgM_00159]. Na primeira chamada após a inicialização do módulo, inicia tanto todas as funções de monitorização (para todos os algoritmos de monitorização, incluindo os ciclos de referência) como o tratamento do watchdog [SWS_WdgM_00406].

Monitorização de deadline e deteção de timeout

Nas chamadas cíclicas, WdgM_MainFunction executa a monitorização de deadline para a deteção de timeouts para todas as unidades com monitorização ativa e atualiza o respetivo resultado [SWS_WdgM_00404]:

• Se a deteção através de WdgMEnableTimeoutDetection estiver ativada, a função verifica todas as monitorizações de deadline configuradas no modo ativo nas quais o checkpoint inicial foi reportado, mas o checkpoint final correspondente ainda está pendente [SWS_WdgM_00403].
• Se a diferença de tempo medida em relação ao timestamp atual exceder o máximo WdgMDeadlineMax, a função define o resultado de monitorização da Supervised Entity como incorreto (incorrect) [SWS_WdgM_00403].

Interação com o sistema operativo

Para determinar timestamps e diferenças, WdgM_MainFunction chama a função do OS GetElapsedValue com o ID de contador configurado para a unidade (parâmetro WdgMOSCounter) [SWS_WdgM_00373]. O escalonamento dos valores de diferença para os valores-limite WdgMDeadlineMin e WdgMDeadlineMax é efetuado com base no parâmetro OsSecondsPerTick [SWS_WdgM_00374].

O tipo WdgM_Mode está definido como Mode Declaration Group da categoria EXPLICIT_ORDER e serve para representar estados de monitorização do módulo [SWS_WdgM_00334].

Utilização e gama de valores

O modo inicial definido é SUPERVISION_OK [SWS_WdgM_00334]. Para os modos individuais estão predefinidos valores numéricos explícitos [SWS_WdgM_00334]:

• SUPERVISION_OK = 0
• SUPERVISION_FAILED = 1
• SUPERVISION_EXPIRED = 2
• SUPERVISION_STOPPED = 3
• SUPERVISION_DEACTIVATED = 4

Para o valor de transição (on transition value) entre modos está definido o valor 255 [SWS_WdgM_00334].

Interação

Devido à classificação na categoria EXPLICIT_ORDER e à atribuição de valores ordinais fixos, é provável que o grupo esteja previsto para um mapeamento ordenado de estados dentro do Watchdog Manager [SWS_WdgM_00334]. Pergunta Q-47c55c3bc2e2a23d (aberta)

O tipo WdgM_LocalStatusType é utilizado para variáveis que mapeiam o estado de monitorização local atual de uma entidade monitorizada individual (Supervised Entity) no Watchdog Manager [SWS_WdgM_00359]. O tipo de dados é derivado do tipo base uint8 e é disponibilizado através do cabeçalho Rte_WdgM_Type.h [SWS_WdgM_00359].

A faixa de valores abrange quatro estados distintos conforme [SWS_WdgM_00359]:

• WDGM_LOCAL_STATUS_OK (valor 0): a monitorização da Supervised Entity não apresenta erros.
• WDGM_LOCAL_STATUS_FAILED (valor 1): a monitorização falhou, mas ainda pode ser recuperada («healed») caso a entidade retorne ao comportamento normal. Isto aplica-se desde que um limite de erros configurável não seja ultrapassado; caso contrário, o estado transita para WDGM_LOCAL_STATUS_EXPIRED.
• WDGM_LOCAL_STATUS_EXPIRED (valor 2): a monitorização falhou permanentemente; já não é possível sair deste estado.
• WDGM_LOCAL_STATUS_DEACTIVATED (valor 4): a monitorização local da Supervised Entity está temporariamente desativada.

Devido à definição em Rte_WdgM_Type.h, o tipo deverá destinar-se principalmente à troca de estados de monitorização entre componentes de software e através da RTE [SWS_WdgM_00359]. Pergunta Q-a9e584dc4c7cfa3b (aberta)

O tipo de dados WdgM_GlobalStatusType serve para a definição de variáveis que representam o estado de monitorização global do módulo Watchdog Manager [SWS_WdgM_00360]. É derivado do tipo base uint8 e é disponibilizado através do cabeçalho Rte_WdgM_Type.h [SWS_WdgM_00360].

O intervalo de valores abrange cinco estados de monitorização definidos [SWS_WdgM_00360]:

• WDGM_GLOBAL_STATUS_OK (0): a monitorização não apresenta qualquer erro.
• WDGM_GLOBAL_STATUS_FAILED (1): a monitorização falhou, mas ainda se encontra dentro do limite admissível de erros.
• WDGM_GLOBAL_STATUS_EXPIRED (2): a monitorização falhou e o limite admissível de erros foi ultrapassado, mas o controlador do watchdog ainda não foi instruído a interromper o desencadeamento.
• WDGM_GLOBAL_STATUS_STOPPED (3): o limite de erros foi ultrapassado e o controlador do watchdog foi instruído a parar o desencadeamento, de modo que um reset do watchdog está iminente.
• WDGM_GLOBAL_STATUS_DEACTIVATED (4): o módulo WdgM não está inicializado e, portanto, não controla os watchdogs.

Através destes estados, o tipo mapeia todo o ciclo de monitorização, começando na desativação antes da inicialização, passando pela operação regular ou tolerante a falhas, até à escalada em vários níveis com reset final do watchdog em caso de erros persistentes [SWS_WdgM_00360].

O tipo de dados WdgM_ModeType serve para a distinção unívoca dos diferentes modos projetados para o Watchdog Manager [SWS_WdgM_00358]. Ele é disponibilizado para componentes de software e módulos de software básico através do arquivo de cabeçalho Rte_WdgM_Type.h [SWS_WdgM_00358].

De acordo com a especificação [SWS_WdgM_00358], o tipo apresenta as seguintes propriedades:

• Tipo base: WdgM_ModeType é derivado do tipo de dados padrão uint8 [SWS_WdgM_00358].
• Faixa de valores: a faixa de valores compreende de 0 a <Number of Modes> [SWS_WdgM_00358].
• Dependência de configuração: o limite superior real da faixa de valores depende do número de modos configurados para o Watchdog Manager [SWS_WdgM_00358].

Por se tratar de uma definição de tipo, não existem parâmetros de tempo de execução, códigos de erro ou semânticas de assincronia. Interpretação: devido à declaração em Rte_WdgM_Type.h, WdgM_ModeType provavelmente deve ser utilizado primariamente para a troca de informações de modo por meio de interfaces RTE entre o software de aplicação e o Watchdog Manager. Pergunta Q-27975280bc68720e (aberta)

O elemento globalmode está definido conforme a especificação [SWS_WdgM_00150] como uma porta fornecida (Provided Port Interface) do Watchdog Manager (WdgM) na plataforma AUTOSAR Classic na release R20-11. Como tipo de interface é indicado WdgM_GlobalMode. O elemento serve, no sistema global, como interface formal de porta através da qual o módulo expõe o seu estado a outros componentes de software.

A especificação [SWS_WdgM_00150] não fornece mais detalhes relativos à utilização concreta, aos parâmetros, valores de retorno ou estruturas de dados. Como interpretação, a interface de porta deverá servir primariamente para fornecer a instâncias superiores, como o BswM ou SW-Cs de aplicação, o estado de monitorização global atual do Watchdog Manager. Pergunta Q-6a0217eb1d28c1b4 (aberta) Na falta de outras indicações nas fontes, a disponibilização do modo é presumivelmente processada de forma síncrona através da RTE.

No que diz respeito ao tratamento de erros, mensagens DET ou DEM, bem como códigos de erro específicos, [SWS_WdgM_00150] é totalmente omisso. Da mesma forma, não constam no payload definições normativas sobre reentrância, prioridades ou contextos de chamada; contudo, em termos de interpretação, o acesso deverá estar sujeito às regras gerais de concorrência da gestão de estados do WdgM. Pergunta Q-28fa9de4b06e3b0d (aberta) Não existem requisitos relacionados para este elemento.