BSW Mode Manager (BswM)

A função BswM_BswMPartitionRestarted destina-se a notificar o módulo BswM sobre o reinício da partição na qual o BswM é executado [SWS_BswM_00193].

Utilização e semântica

A chamada ocorre de forma síncrona pela Restart-Task do sistema operacional assim que a partição tiver sido restaurada após um reinício [SWS_BswM_00193]. A função possui o Service-ID 0x1e e é declarada por meio do arquivo de cabeçalho BswM.h [SWS_BswM_00193]. Ela não aceita parâmetros de passagem (nem parâmetros de entrada nem de saída) e não possui valor de retorno (void) [SWS_BswM_00193].

Simultaneidade e execução

De acordo com a especificação, BswM_BswMPartitionRestarted é classificada como reentrante [SWS_BswM_00193]. Isso possibilita a chamada no contexto da Restart-Task, devendo o chamador assegurar que o reinício da referida partição tenha sido devidamente iniciado antes da chamada.

Tratamento de erros e interação

A especificação não define valores de retorno específicos ou códigos de erro DET/DEM para este serviço [SWS_BswM_00193]. A interação restringe-se à OS-Restart-Task, que dispara essa notificação para que o BswM possa reagir à partição reiniciada [SWS_BswM_00193].

Uso e assinatura

A função BswM_CanSM_CurrentState é chamada pelo CAN State Manager (CanSM) para reportar ao BSW Mode Manager (BswM) o estado atual de um canal CAN [SWS_BswM_00049]. Ela possui o Service ID 0x05 e é disponibilizada por meio do arquivo de cabeçalho BswM_CanSM.h [SWS_BswM_00049].

A chamada ocorre de forma síncrona e não retorna nenhum valor de retorno (void) [SWS_BswM_00049]. A interface processa dois parâmetros de entrada [SWS_BswM_00049]:

• Network (tipo NetworkHandleType): designa o canal CAN afetado ao qual se refere a mudança de estado reportada [SWS_BswM_00049].
• CurrentState (tipo CanSM_BswMCurrentStateType): passa o novo estado assumido do respectivo canal CAN [SWS_BswM_00049].

Nenhum parâmetro de saída ou de entrada/saída está previsto para esta função de serviço [SWS_BswM_00049].

Simultaneidade e restrições

A especificação designa BswM_CanSM_CurrentState como reentrante [SWS_BswM_00049]. Portanto, ela pode ser chamada concorrentemente no caso de eventos paralelos de múltiplos canais de rede. Como a chamada ocorre de forma síncrona e nenhuma restrição específica de tarefa é estabelecida, o contexto de chamada deve corresponder ao contexto de execução do CanSM chamador [SWS_BswM_00049]. Pergunta Q-0edc8b6c1cb10f6d (aberta)

Tratamento de erros e interação

Na especificação, não estão documentados códigos de erro específicos, valores de retorno ou notificações para DET ou DEM para esta chamada de função [SWS_BswM_00049]. A função serve como interface de notificação definida na interação entre CanSM e BswM, por meio da qual o estado atual do canal é incorporado ao gerenciamento de modos do BswM [SWS_BswM_00049].

No módulo AUTOSAR Classic BswM (Basic Software Mode Manager), a função BswM_ComM_CurrentMode serve como interface de notificação padronizada para o Communication Manager (ComM) [SWS_BswM_00047]. Ela é chamada pelo ComM para indicar ao BswM o modo de comunicação atual de um determinado canal de comunicação [SWS_BswM_00047]. A declaração desta interface é disponibilizada por meio do arquivo de cabeçalho BswM_ComM.h, e o Service ID hexadecimal 0x0e está atribuído ao serviço [SWS_BswM_00047].

A assinatura da função é void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode) e requer dois parâmetros de entrada invariáveis [SWS_BswM_00047]:

• Network (tipo de dados NetworkHandleType): designa o canal de comunicação ComM concreto para o qual o status é indicado e ao qual o estado corresponde [SWS_BswM_00047].
• RequestedMode (tipo de dados ComM_ModeType): transmite o estado atual ou modo do canal de comunicação ComM especificado para o módulo BswM [SWS_BswM_00047].

A interface não possui valor de retorno (void); da mesma forma, parâmetros de saída (out) ou parâmetros combinados de entrada/saída (inout) não estão definidos na especificação [SWS_BswM_00047]. O comportamento de execução da função é definido como síncrono (Synchronous) [SWS_BswM_00047]. Em relação à concorrência e ao contexto de chamadas simultâneas, BswM_ComM_CurrentMode é classificada como reentrante (Reentrant) [SWS_BswM_00047].

No que diz respeito ao tratamento de erros, a especificação do elemento não prevê códigos de erro específicos, valores de retorno ou mensagens de erro para o DET ou DEM para esta função [SWS_BswM_00047]. Condições adicionais de ordenação ou dependências em relação a requisitos correlacionados também não estão registradas [SWS_BswM_00047].

A função BswM_ComM_CurrentPNCMode serve como interface de notificação entre o Communication Manager e o BSW Mode Manager. De acordo com [SWS_BswM_00148], ela é chamada pelo ComM para transmitir o modo atual de um Partial Network Cluster (PNC) para o BswM.

Utilização e contexto de chamada

A interface está disponível por meio do arquivo de cabeçalho BswM_ComM.h e possui o Service ID 0x15 ([SWS_BswM_00148]). A chamada é executada de forma síncrona e não retorna nenhum valor de retorno (void). São passados exclusivamente dois parâmetros de entrada:

• PNC (tipo PNCHandleType): O handle do Partial Network Cluster afetado cujo estado está sendo reportado.
• CurrentPncMode (tipo ComM_PncModeType): O modo atualmente assumido do PNC especificado.

Parâmetros adicionais de entrada ou saída não estão previstos de acordo com [SWS_BswM_00148].

Simultaneidade e restrições

Em relação à concorrência, BswM_ComM_CurrentPNCMode está especificada como reentrante de acordo com [SWS_BswM_00148], tornando admissíveis chamadas simultâneas a partir do ComM. Códigos de erro específicos ou mecanismos para tratamento de erros via DET ou DEM não estão definidos no payload. Os estados transmitidos devem servir internamente no BswM como gatilhos para avaliações de regras e ações (Interpretação: O payload comprova a indicação de modo, mas não especifica ações internas do BswM). Pergunta Q-2527fc2eda881b62 (aberta)

A função BswM_ComM_InitiateReset é chamada pelo Communication Manager (ComM) para sinalizar ao BswM um desligamento pendente [SWS_BswM_00217].

Interface e semântica de chamada

A interface possui a assinatura void BswM_ComM_InitiateReset(void) e é declarada por meio do arquivo de cabeçalho BswM_ComM.h [SWS_BswM_00217]. Ela não processa parâmetros de entrada, saída ou entrada/saída e não possui valor de retorno [SWS_BswM_00217]. A chamada é processada de forma síncrona e está especificada com o Service-ID 0x22 [SWS_BswM_00217].

Simultaneidade e restrições

A função é definida como não reentrante (Non Reentrant) [SWS_BswM_00217]. O chamador deve, portanto, garantir que as chamadas ocorram sequencialmente e que não ocorram execuções paralelas ou sobrepostas. Como o processamento ocorre de forma síncrona, a chamada bloqueia o contexto de execução até a conclusão do processamento no BswM.

Tratamento de erros e interação

Nas especificações não estão previstos códigos de erro específicos, valores de retorno ou mensagens de erro para DET ou DEM para este serviço [SWS_BswM_00217]. A interação restringe-se, de acordo com a especificação, ao recebimento da sinalização de encerramento do ComM [SWS_BswM_00217]; interpretação: a mensagem provavelmente deve servir no BswM como gatilho para ações configuradas de execução do desligamento ou do reset. Pergunta Q-adf160d8d0fe2c97 (aberta)

Utilização e contexto de chamada

A função BswM_Dcm_ApplicationUpdated é chamada de acordo com [SWS_BswM_00158] pelo Diagnostic Communication Manager (DCM) para reportar ao BswM a atualização bem-sucedida de uma aplicação. O serviço está declarado no arquivo de cabeçalho BswM_Dcm.h e possui o Service ID 0x14. A interface não espera parâmetros de passagem (void) e não retorna valor ao chamador.

Sincronismo e concorrência

De acordo com [SWS_BswM_00158], a função está especificada como síncrona e reentrante. O chamador permanece, portanto, no contexto de execução do DCM até que o processamento imediato da chamada dentro do BswM seja concluído. A propriedade declarada de reentrância permite, em princípio, acessar a interface de forma concorrente a partir de diferentes contextos de tarefas.

Tratamento de erros e interação

Para BswM_Dcm_ApplicationUpdated, não estão previstos em [SWS_BswM_00158] códigos de erro específicos nem notificações para o DET ou DEM. A chamada serve puramente para notificação de status ao gerenciamento de modos do BSW. A notificação deve servir no BswM como indicador e gatilho para a reavaliação de regras internas, bem como para trocas subsequentes de modo, a fim de adaptar todo o sistema ao software de aplicação modificado. Pergunta Q-119282a4a72622b5 (aberta)

usar

A função BswM_Dcm_CommunicationMode_CurrentState é chamada pelo módulo Diagnostic Communication Manager (DCM) para informar o Basic Software Mode Manager (BswM) sobre o estado atual do modo de comunicação [SWS_BswM_00048]. A declaração desta interface é fornecida pelo arquivo de cabeçalho BswM_Dcm.h [SWS_BswM_00048].

A sintaxe em C da função é void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode) [SWS_BswM_00048]. Na chamada pelo DCM, são passados dois parâmetros de entrada [SWS_BswM_00048]:

• Network (tipo NetworkHandleType): designa o canal de comunicação ao qual o modo de diagnóstico se refere [SWS_BswM_00048].
• RequestedMode (tipo Dcm_CommunicationModeType): transmite o modo de comunicação de diagnóstico solicitado ao BswM [SWS_BswM_00048].

A interface não possui valor de retorno (tipo de retorno void) e não utiliza parâmetros modificadores de entrada/saída (inout) nem parâmetros de saída (out) [SWS_BswM_00048].

Concorrência e propriedades

A chamada de função é executada de forma síncrona e é especificada como reentrante [SWS_BswM_00048]. O nome do serviço é definido como BswM_Dcm_CommunicationMode_CurrentState e possui o ID de serviço 0x06 em representação hexadecimal [SWS_BswM_00048].

Interação

Interpretação: o BswM deve utilizar o status transmitido do modo de comunicação como critério para a avaliação de regras de modo, a fim de disparar ações subsequentes no BswM [SWS_BswM_00048]. Pergunta Q-1031b1a7ae000c2a (aberta)

Utilização e semântica

A função BswM_Deinit serve para a desinicialização do BSW Mode Manager ([SWS_BswM_00119]). A execução ocorre de forma síncrona sem parâmetros de passagem e sem valor de retorno com o Service ID 0x04 ([SWS_BswM_00119]). A declaração está disponível por meio do arquivo de cabeçalho BswM.h ([SWS_BswM_00119]).

Simultaneidade e restrições

A interface está especificada como não reentrante (Non Reentrant) ([SWS_BswM_00119]). Uma chamada concorrente ou de interrupção a partir de múltiplos contextos de tarefas é, portanto, inadmissível. Interpretação: A desinicialização deve ocorrer tipicamente de forma sequencial durante a fase de desligamento da ECU por meio de um gerenciamento de estado de nível superior, como o ECU State Manager. Pergunta Q-0a5d218bfe9fed04 (aberta)

Interação e comportamento após a desinicialização

Após a chamada de BswM_Deinit, o módulo BswM não realiza mais nenhum processamento de modo ([SWS_BswM_00120]). Essa inibição continua válida mesmo que solicitações de modo externas ou internas sejam apresentadas ao módulo ou se a função principal cíclica do BswM continuar sendo executada ou chamada ([SWS_BswM_00120]).

A função de serviço síncrona BswM_EcuM_CurrentState é chamada pelo módulo EcuM para sinalizar o modo de operação atual da ECU ao BswM [SWS_BswM_91003]. A interface possui o ID de serviço 0x28 e é disponibilizada através do arquivo de cabeçalho BswM_EcuM.h [SWS_BswM_91003].

usar

Na chamada da função, o estado solicitado da ECU é informado de forma síncrona ao BswM [SWS_BswM_91003]. A passagem é realizada através de um único parâmetro de entrada:

• Current State (in): passa o modo de operação da ECU solicitado utilizando o tipo de dados EcuM_StateType [SWS_BswM_91003].

A função não define parâmetros de entrada/saída (inout) nem parâmetros de saída (out) e não possui valor de retorno (void) [SWS_BswM_91003].

Simultaneidade e restrições

Quanto ao comportamento de concorrência, BswM_EcuM_CurrentState é especificada como reentrante [SWS_BswM_91003]. As chamadas podem, portanto, ocorrer concorrentemente sem restrições, por exemplo, quando diferentes fluxos de execução do chamador estiverem ativos [SWS_BswM_91003].

Códigos de erro específicos, notificações para o módulo DET ou DEM, bem como mecanismos dedicados de tratamento de erros, não estão listados no escopo de especificação para este serviço [SWS_BswM_91003].

A função BswM_EcuM_CurrentWakeup serve como interface do BswM chamada pelo módulo EcuM para reportar o estado atual de uma ou mais fontes de despertar [SWS_BswM_00131]. A declaração está disponível através do arquivo de cabeçalho BswM_EcuM.h [SWS_BswM_00131].

Na chamada da função, são transmitidos os seguintes parâmetros de passagem [SWS_BswM_00131]:

• source (tipo EcuM_WakeupSourceType): designa a fonte de despertar ou as fontes de despertar cujo estado foi alterado [SWS_BswM_00131].
• state (tipo EcuM_WakeupStatusType): indica o novo estado da(s) fonte(s) de despertar afetada(s) [SWS_BswM_00131].

A função não possui valor de retorno (void) e não contém parâmetros de entrada/saída ou puramente de saída [SWS_BswM_00131]. O ID de serviço correspondente é 0x10 [SWS_BswM_00131].

Em relação ao comportamento de execução, a chamada da função é especificada como síncrona [SWS_BswM_00131]. Além disso, a função é classificada como reentrante, permitindo que ela seja chamada concorrentemente a partir de diferentes contextos, se necessário [SWS_BswM_00131].

Utilização e semântica

A função BswM_EcuM_RequestedState atua como interface de notificação chamada pelo gerenciador de estado da unidade de controle (EcuM) para informar o módulo BswM sobre o status atual do Run Request Protocol [SWS_BswM_91004]. A chamada ocorre de forma síncrona e é especificada como reentrante, de modo que a função pode ser executada em contextos concorrentes [SWS_BswM_91004]. A declaração é fornecida através do arquivo de cabeçalho BswM_EcuM.h com o ID de serviço 0x29 [SWS_BswM_91004].

Parâmetros e valor de retorno

A interface não possui valor de retorno (tipo de retorno void) e requer dois parâmetros puramente de entrada [SWS_BswM_91004]:

• State (tipo EcuM_StateType): indica o estado solicitado pelo EcuM [SWS_BswM_91004].
• CurrentState (tipo EcuM_RunStatusType): transmite o resultado ou o status atual do Run Request Protocol [SWS_BswM_91004].

Parâmetros de entrada/saída ou parâmetros de saída não estão previstos para esta função [SWS_BswM_91004].

Interação e integração

A função é chamada exclusivamente pelo EcuM. Interpretação: os estados transmitidos devem servir no BswM para a avaliação interna de regras e o controle de modos, visando disparar ações de nível superior do software básico [SWS_BswM_91004]. Pergunta Q-6cd81e44c9e2920a (aberta) Para este serviço, não constam na especificação códigos de erro específicos para DET ou DEM [SWS_BswM_91004].

usar

A função BswM_EthIf_PortGroupLinkStateChg é chamada, conforme [SWS_BswM_91001], pelo módulo EthIf para indicar ao BswM uma alteração no estado da conexão (Link State) de um grupo de portas de switch Ethernet. A interface possui o Service-ID 0x26 e é disponibilizada por meio do arquivo de cabeçalho BswM_EthIf.h [SWS_BswM_91001].

A chamada passa dois parâmetros de entrada:

• PortGroupIdx: designa o índice do grupo de portas afetado no contexto da interface Ethernet [SWS_BswM_91001].
• PortGroupState: indica o status do grupo de portas, o qual é derivado do link físico do transceptor Ethernet. Os estados válidos são ETHTRCV_LINK_STATE_DOWN para um link desconectado, bem como ETHTRCV_LINK_STATE_ACTIVE para um link ativo [SWS_BswM_91001].

A função não possui parâmetros de entrada/saída nem parâmetros de saída e não retorna nenhum valor (void) [SWS_BswM_91001].

Simultaneidade e restrições

A execução ocorre de forma síncrona e está especificada como reentrante [SWS_BswM_91001]. Valores de retorno específicos, códigos de erro ou mensagens de erro (DET/DEM) não estão definidos para esta interface [SWS_BswM_91001].

Interação

Interpretação: o BswM deve utilizar o status do link transmitido como variável de entrada para avaliar regras dependentes de estado e disparar ações subsequentes ou mudanças de modo dentro do BSW. Pergunta Q-14285579acb760d5 (aberta)

A função BswM_EthSM_CurrentState serve como interface de callback e notificação do BSW Mode Manager. De acordo com [SWS_BswM_00050], ela é chamada pelo Ethernet State Manager (EthSM) para transmitir o estado atual de um canal de comunicação para o BswM. A declaração da interface é disponibilizada por meio do cabeçalho BswM_EthSM.h e possui o Service ID 0x0d.

Para a utilização e a chamada, aplicam-se as seguintes determinações de acordo com [SWS_BswM_00050]:

• Semântica de chamada: A execução ocorre de forma síncrona. O chamador, portanto, aguarda até que a função conclua o processamento da notificação de status.
• Concorrência: O serviço está especificado como reentrante [SWS_BswM_00050]. As chamadas podem ocorrer, portanto, para diferentes instâncias de rede ou de forma concorrente a partir do contexto do módulo EthSM.
• Parâmetros de passagem: São passados a rede Ethernet afetada como Network do tipo NetworkHandleType, bem como o status reportado como CurrentState do tipo EthSM_NetworkModeStateType. Parâmetros de entrada e saída (inout/out) não estão previstos; o valor de retorno é void.

Na especificação do elemento [SWS_BswM_00050], não estão definidos valores de retorno específicos nem mensagens de erro para DET ou DEM. Interpretação: O módulo BswM deve armazenar internamente o estado de rede reportado e utilizá-lo como condição para a avaliação de regras configuradas, bem como para o início de trocas de modo. Pergunta Q-407156ff74cbab6f (aberta)

Utilização e contexto de chamada

A função BswM_FrSM_CurrentState serve como interface de callback ou notificação do BswM, sendo chamada pelo FlexRay State Manager (FrSM) para reportar o estado atual de um cluster FlexRay [SWS_BswM_00051]. A declaração da função é disponibilizada por meio do arquivo de cabeçalho BswM_FrSM.h [SWS_BswM_00051]. A chamada ocorre de forma síncrona e não retorna nenhum valor de retorno (void) [SWS_BswM_00051].

A interface define dois parâmetros de entrada [SWS_BswM_00051]:

• Network (tipo NetworkHandleType): indica o respectivo cluster FlexRay ao qual a notificação de estado se refere [SWS_BswM_00051].
• CurrentState (tipo FrSM_BswM_StateType): transmite o estado atual do cluster FlexRay em questão para o BswM [SWS_BswM_00051].

Não existem parâmetros de saída (out) ou de entrada/saída (inout) para esta função [SWS_BswM_00051].

Simultaneidade e tratamento de erros

A função está especificada com o Service ID 0x0c e marcada como reentrante [SWS_BswM_00051]. Códigos de erro específicos, comportamentos em caso de falha ou notificações para o gerenciamento de erros de desenvolvimento (DET) ou gerenciamento de eventos de diagnóstico (DEM) não são indicados na especificação para este serviço [SWS_BswM_00051].

A função síncrona BswM_Init serve para a inicialização do Basic Software Mode Manager (BswM) de acordo com a especificação [SWS_BswM_00002]. Ela é declarada por meio do arquivo de cabeçalho BswM.h e possui o ID de serviço 0x00 [SWS_BswM_00002].

Parâmetros e valores de retorno

Um ponteiro para os dados de configuração post-build do tipo BswM_ConfigType é passado para a função por meio do único parâmetro de entrada ConfigPtr [SWS_BswM_00002]. Não existem parâmetros de saída ou de entrada/saída, e nenhum valor de retorno é retornado [SWS_BswM_00002].

Concorrência e contexto de execução

A execução ocorre de forma síncrona. O comportamento do módulo em relação à reentrância é especificado como condicionalmente reentrante (Conditionally Reentrant) [SWS_BswM_00002]. Como interpretação, isso deve significar que chamadas simultâneas só são permitidas sob condições de sistema especiais, como, por exemplo, áreas de dados separadas. Pergunta Q-c0063b2a12eb4f41 (aberta) Além disso, a chamada normalmente deve ocorrer no âmbito da inicialização do sistema, antes que outras operações do BswM sejam executadas.

A função de serviço síncrona BswM_J1939DcmBroadcastStatus (Service ID 0x1b) transmite ao BSW Mode Manager o status de comunicação desejado das redes disponíveis [SWS_BswM_00165]. O status reportado é tipicamente ativado no sistema por meio da comutação de grupos de COM I-PDU (COM I-PDU group switches) [SWS_BswM_00165]. A interface é disponibilizada por meio do cabeçalho BswM_J1939Dcm.h [SWS_BswM_00165].

Os parâmetros e a semântica estão especificados da seguinte forma [SWS_BswM_00165]:

• Parâmetros de passagem: Por meio do parâmetro NetworkMask, é passada uma máscara de bits que compreende um bit por rede disponível. A respectiva posição do bit corresponde ao identificador do canal de comunicação ComMChannel.ComMChannelId, de modo que o ID de canal 0 é mapeado no bit 0.
• Significado dos bits: o valor 1 sinaliza que a rede está ativada (Network enabled), enquanto 0 indica uma rede desativada (Network disabled).
• Valor de retorno: a função não possui valor de retorno (void).

Simultaneidade e restrições: a chamada é projetada como reentrante e opera de forma síncrona [SWS_BswM_00165]. Como o parâmetro NetworkMask é definido como um valor de 16 bits, por razões de projeto apenas os primeiros 16 IDs de canais de comunicação podem ser endereçados por meio desta API [SWS_BswM_00165]. Códigos de erro específicos, bem como mensagens DET ou DEM, não estão especificados para esta função [SWS_BswM_00165].

usar

A função BswM_J1939Nm_StateChangeNotification serve para a notificação síncrona do BSW Mode Manager sobre o estado atual de um nó de rede J1939 após uma alteração de estado ocorrida [SWS_BswM_00194]. A declaração está disponível por meio do arquivo de cabeçalho BswM_J1939Nm.h e é conduzida sob o Service-ID 0x18 [SWS_BswM_00194].

A interface espera três parâmetros de entrada e não retorna valor de retorno (void) [SWS_BswM_00194]:

• Network (NetworkHandleType): identifica o canal J1939 afetado [SWS_BswM_00194].
• Node (uint8): identificação numérica do respectivo nó J1939 [SWS_BswM_00194].
• NmState (Nm_StateType): representa o estado atual ou recém-assumido do nó [SWS_BswM_00194].

Simultaneidade e contexto de chamada

O processamento ocorre de forma síncrona e está especificado como reentrante [SWS_BswM_00194]. Portanto, em sistemas com múltiplos nós ou canais, a notificação também pode ocorrer concorrentemente. Supõe-se que o chamador seja o módulo J1939Nm, o qual informa o BswM sobre o novo status após transições de estado internas. Pergunta Q-9c0e521db5e51713 (aberta)

Tratamento de erros

A especificação não define códigos de erro específicos nem notificações para DET ou DEM para este serviço [SWS_BswM_00194]. Além disso, não existem parâmetros de saída nem parâmetros de entrada/saída para indicação de erros [SWS_BswM_00194].

A função BswM_LinSM_CurrentSchedule serve como interface de notificação chamada pelo LIN State Manager (Lin SM) para indicar ao BswM a Schedule Table atualmente ativa para um determinado canal LIN ([SWS_BswM_00058]). O serviço está disponível por meio do cabeçalho BswM_LinSM.h e possui o Service ID 0x0a ([SWS_BswM_00058]).

Na chamada, são passados dois parâmetros de entrada ([SWS_BswM_00058]):

• Network (tipo NetworkHandleType): designa o canal LIN concreto no qual ocorreu a troca da Schedule Table ([SWS_BswM_00058]).
• Current Schedule (tipo LinIf_SchHandleType): passa o identificador da Schedule Table agora ativa neste canal LIN ([SWS_BswM_00058]).

A interface não possui parâmetros de entrada/saída nem de saída e não retorna nenhum valor de retorno (void) ([SWS_BswM_00058]). O comportamento de execução é definido como síncrono (Synchronous), e a função está especificada como reentrante (Reentrant) ([SWS_BswM_00058]).

Códigos de erro específicos, reações a falhas ou mensagens para DET ou DEM não são indicados na especificação para este serviço ([SWS_BswM_00058]). Interpretação: A chamada deve ocorrer tipicamente logo após uma troca de tabela realizada no Lin SM, a fim de informar a avaliação de estado no BswM de forma síncrona sobre a mudança. Pergunta Q-302196d84e739258 (aberta)

Utilização e contexto de chamada

A função síncrona BswM_LinSM_CurrentState é chamada pelo LIN State Manager (LinSM) para comunicar uma alteração de estado de um canal LIN ao BswM [SWS_BswM_00052]. Ela está definida no módulo BswM, possui o Service ID 0x09 e é declarada por meio do arquivo de cabeçalho BswM_LinSM.h para o LinSM [SWS_BswM_00052].

Parâmetros e valores de retorno

A interface não possui valor de retorno (void), nem parâmetros de entrada/saída ou de saída [SWS_BswM_00052]. Para a sinalização, são passados dois parâmetros de entrada:

• Network (tipo NetworkHandleType): indica o canal LIN ao qual a indicação de estado reportada se refere [SWS_BswM_00052].
• CurrentState (tipo LinSM_ModeType): contém o estado atualmente assumido do canal LIN especificado [SWS_BswM_00052].

Concorrência e integração de módulos

De acordo com a especificação, a função é implementada como reentrante [SWS_BswM_00052]. Isso permite a chamada paralela para diferentes redes LIN sem bloqueio mútuo. Interpretação: O estado do canal transmitido deve ser utilizado no BswM provavelmente como variável de entrada para avaliações de regras e listas de ações, a fim de controlar transições de modo baseadas nisso em toda a ECU. Pergunta Q-ca113e4b71e4ab75 (aberta)

Utilização e contexto de chamada

A função síncrona BswM_LinTp_RequestMode é chamada pelo Lin TP para solicitar uma alteração de modo para um determinado canal LIN [SWS_BswM_00156]. A declaração ocorre por meio do cabeçalho BswM_LinTp.h com o Service ID 0x0b [SWS_BswM_00156]. Como parâmetros de entrada, são passados:

• Network (tipo NetworkHandleType): designa o canal LIN afetado ao qual se refere a solicitação de modo [SWS_BswM_00156].
• LinTp_Mode (passado como LinTp_Mode Lin Tp RequestedMode): determina o modo TP solicitado, o qual se correlaciona diretamente com a tabela de schedule LIN a ser utilizada [SWS_BswM_00156].

A função não possui valor de retorno (void) [SWS_BswM_00156]. Códigos de erro específicos, valores de retorno para tratamento de erros ou mensagens DET não estão previstos na definição da função [SWS_BswM_00156].

Concorrência e gerenciamento de modos

A interface está especificada como reentrante [SWS_BswM_00156]. Isso permite uma chamada paralela a partir de diferentes contextos ou para canais LIN separados. Como o modo solicitado influencia a seleção da tabela de schedule, a função serve como interface específica de modo entre o Lin TP e o BSW Mode Manager [SWS_BswM_00156]. Interpretação: Com base na solicitação, o BswM deve realizar avaliações internas para disparar a troca da tabela de schedule LIN. Pergunta Q-544460b6b32b6ac2 (aberta)

Utilização e contexto de chamada

A função BswM_Nm_CarWakeUpIndication serve como interface de callback do Basic Software Mode Manager (BswM) e é chamada pelo Network Management (Nm) para indicar um evento de Car-Wakeup relacionado a um canal [SWS_BswM_00235].\n A chamada ocorre de forma síncrona e passa a identificação do canal Nm afetado por meio do parâmetro de entrada Network do tipo NetworkHandleType [SWS_BswM_00235].\n A interface não declara valor de retorno (void) e não disponibiliza parâmetros de saída [SWS_BswM_00235].\n O serviço está definido com o Service-ID 0x24 no arquivo de cabeçalho BswM_Nm.h [SWS_BswM_00235].

Simultaneidade e tratamento de erros

A interface está especificada como reentrante, sendo permitidas chamadas paralelas [SWS_BswM_00235].\n Códigos de erro específicos, notificações para o DET ou DEM, bem como mecanismos especiais de tratamento de erros, não são indicados na especificação do elemento [SWS_BswM_00235].

Interação

Como ponto de integração entre o Nm e o BswM, a função encaminha o sinal de despertar diretamente para o processamento do BswM [SWS_BswM_00235].\n Interpretação: a chamada provavelmente deve ser avaliada dentro do BswM como um indicador para verificações de regras ou mudanças de modo no contexto da inicialização da rede. Pergunta Q-e56d5cfb6345f1ba (aberta)

Utilização e contexto de chamada

A função BswM_Nm_StateChangeNotification serve como interface de notificação para transmitir o estado atual de um canal de gerenciamento de rede ao BswM após alterações de status ocorridas [SWS_BswM_91002]. Ela é declarada no arquivo de cabeçalho BswM_Nm.h e definida sob o Service-ID 0x27 [SWS_BswM_91002]. A execução ocorre de forma síncrona, e a função não possui valor de retorno (void) [SWS_BswM_91002].

A passagem dos dados de estado ocorre por meio de dois parâmetros puramente de entrada; parâmetros de entrada-saída ou de saída não existem [SWS_BswM_91002]:

• Network (tipo: NetworkHandleType): designa o canal Nm afetado para identificação da rede [SWS_BswM_91002].
• currentState (tipo: Nm_StateType): sinaliza o estado atual ou novo do canal Nm especificado [SWS_BswM_91002].

Simultaneidade e comportamento

A interface é classificada como reentrante [SWS_BswM_91002]. Com isso, a função pode ser chamada concorrentemente, o que é relevante sobretudo em transições de status simultâneas em diferentes canais de rede. Como a chamada está especificada como síncrona, a função só retorna ao chamador após a aceitação interna da alteração de status [SWS_BswM_91002]. A chamada deve ocorrer tipicamente pelo gerenciamento de rede assim que um canal tiver assumido um novo estado [SWS_BswM_91002]. Pergunta Q-8645d9511a825fed (aberta)

usar

A função BswM_NvM_CurrentBlockMode é chamada pelo NVRAM Manager (NvM) para indicar ao Basic Software Mode Manager (BswM) o modo de bloco atual de um bloco de NVRAM [SWS_BswM_00104]. A declaração da função está disponível por meio do arquivo de cabeçalho BswM_NvM.h e está associada ao Service ID 0x16 na especificação [SWS_BswM_00104].

Parâmetros e valores de retorno

A função não retorna nenhum valor de retorno (void) ao chamador e processa dois parâmetros de entrada [SWS_BswM_00104]:

• Block (tipo NvM_BlockIdType): passa o identificador de bloco do bloco de NVRAM ao qual a nova informação de modo se refere [SWS_BswM_00104].
• CurrentBlockMode (tipo NvM_RequestResultType): transmite o modo de bloco atual ou o resultado da solicitação do bloco NvM [SWS_BswM_00104].

Parâmetros de saída ou parâmetros combinados de entrada/saída não estão definidos para esta interface [SWS_BswM_00104].

Simultaneidade e restrições

A chamada da função BswM_NvM_CurrentBlockMode é executada de forma síncrona e especificada como reentrante [SWS_BswM_00104]. Dessa forma, a interface é projetada para o uso reentrante em contextos de execução concorrentes [SWS_BswM_00104].

Tratamento de erros

Para esta interface, não são indicados nas exigências da especificação códigos de erro específicos nem requisitos para mensagens de erro por meio do Default Error Tracer (DET) ou do módulo Diagnostic Event Manager (DEM) [SWS_BswM_00104].

Uso e assinatura

A função BswM_NvM_CurrentJobMode é chamada pelo NVRAM Manager (NvM) para informar o BSW Mode Manager (BswM) sobre o estado atual de uma solicitação multibloco [SWS_BswM_00152]. A interface está declarada no cabeçalho BswM_NvM.h e possui o Service ID 0x17 [SWS_BswM_00152]. Ela recebe dois parâmetros de entrada:

• MultiBlockRequest (tipo NvM_MultiBlockRequestType): indica a qual solicitação multibloco concreta este callback se refere [SWS_BswM_00152].
• CurrentJobMode (tipo NvM_RequestResultType): indica o status atual ou o resultado da solicitação multibloco em questão [SWS_BswM_00152].

A função não retorna nenhum valor (tipo de retorno void) e não possui parâmetros de entrada/saída ou de saída [SWS_BswM_00152].

Simultaneidade e tratamento de erros

A especificação define BswM_NvM_CurrentJobMode como síncrona e reentrante [SWS_BswM_00152]. A chamada ocorre diretamente a partir do contexto de execução do módulo NvM. Como interpretação, esta chamada deve ser disparada tipicamente no decorrer de operações em lote, como processos de leitura ou gravação, assim que houver uma alteração de status. Pergunta Q-25514d3dbf1d8c5c (aberta)

Para esta função, não estão registrados na especificação valores de retorno nem códigos de erro específicos para erros de desenvolvimento (DET) ou erros de produção; o comportamento em caso de falha não é indicado separadamente [SWS_BswM_00152].

A função BswM_RequestMode disponibiliza uma chamada de função genérica para solicitar modos no Basic Software Mode Manager (BswM) [SWS_BswM_00046]. Ela é declarada por meio do arquivo de cabeçalho BswM.h e possui o Service ID 0x02 [SWS_BswM_00046].

Uso e restrições

O uso é estritamente regulamentado: a função só pode ser chamada por outros módulos BSW que não disponham de uma interface própria e específica do módulo para solicitação de modo [SWS_BswM_00046]. Portanto, módulos BSW com interfaces dedicadas não devem usar este serviço genérico.

Parâmetros e semântica

A assinatura da função é void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode) [SWS_BswM_00046]. Dois parâmetros de entrada são passados:

• requesting_user: identifica o usuário solicitante ou o módulo de software solicitante [SWS_BswM_00046].
• requested_mode: passa o estado ou modo concretamente solicitado [SWS_BswM_00046].

Não existem parâmetros de entrada/saída nem de saída, e a função não possui valor de retorno (void) [SWS_BswM_00046].

simultaneidade

A chamada é processada de forma síncrona e está especificada como reentrante [SWS_BswM_00046]. Dessa forma, a função é adequada para chamadas concorrentes a partir de múltiplos contextos BSW.

Utilização e contexto de chamada

A função BswM_Sd_ClientServiceCurrentState é chamada pela Service Discovery (SD) para informar o BswM de forma síncrona sobre o estado atual de um serviço de cliente [SWS_BswM_00204]. Por meio desta interface é sinalizado se o respectivo serviço está operacional (available) ou indisponível (down) [SWS_BswM_00204]. A declaração da função C é disponibilizada por meio do cabeçalho BswM_Sd.h [SWS_BswM_00204].

Parâmetros e assinatura da interface

A interface possui o Service-ID 0x1f e espera dois parâmetros de entrada [SWS_BswM_00204]:

• SdClientServiceHandleId (tipo uint16): Handle-ID unívoco para identificação do serviço de cliente [SWS_BswM_00204].
• CurrentClientState (tipo Sd_ClientServiceCurrentStateType): estado atual de disponibilidade do serviço [SWS_BswM_00204].

A função não retorna valor de retorno (void) e não define parâmetros de entrada/saída ou parâmetros de saída [SWS_BswM_00204].

Concorrência e interação

A execução de BswM_Sd_ClientServiceCurrentState é síncrona e reentrante [SWS_BswM_00204]. Portanto, os chamadores não precisam forçar uma serialização sequencial, podendo reportar alterações de status concorrentemente. Na interação geral, a notificação de status provavelmente deve ser utilizada para avaliação interna de regras e iniciação de mudanças de modo configuradas dentro do BswM. Pergunta Q-0490a3902ca9e78d (aberta)

A função BswM_Sd_ConsumedEventGroupCurrentState serve como uma interface de callback chamada pela Service Discovery para indicar ao Basic Software Mode Manager (BswM) o estado atual de um grupo de eventos consumido [SWS_BswM_00207]. Ela informa o BswM se o respectivo grupo de eventos está disponível (available) ou inoperante (down) na rede [SWS_BswM_00207].

Uso e assinatura

A interface possui o Service-ID 0x21 e é disponibilizada por meio do arquivo de cabeçalho BswM_Sd.h [SWS_BswM_00207]. A chamada é processada de forma síncrona e não possui valor de retorno (void) [SWS_BswM_00207]. Na chamada da função, a Service Discovery passa dois parâmetros de entrada, enquanto não estão definidos parâmetros de entrada/saída nem parâmetros puramente de saída [SWS_BswM_00207]:

• Sd Consumed Event Group Handle Id (tipo de dados uint16): Handle-ID unívoco para identificação do respectivo grupo de eventos consumido [SWS_BswM_00207].
• Consumed Event Group State (tipo de dados Sd_Consumed Event Group Current State Type): status atual do grupo de eventos consumido para indicação da disponibilidade [SWS_BswM_00207].

Simultaneidade e tratamento de erros

De acordo com a especificação, a função é classificada como reentrante e, portanto, pode ser chamada concorrentemente se necessário [SWS_BswM_00207]. Para este serviço, não constam na especificação códigos de erro específicos, exceções ou feedbacks ao rastreamento de erros de desenvolvimento (DET) ou ao gerenciamento de eventos de diagnóstico (DEM) [SWS_BswM_00207].

Utilização e contexto de chamada

A função síncrona BswM_Sd_EventHandlerCurrentState serve como uma interface chamada pela Service Discovery para comunicar ao BSW Mode Manager (BswM) o status atual de um manipulador de eventos [SWS_BswM_00210]. Os estados típicos do manipulador de eventos incluem a informação sobre se ele foi solicitado ou liberado [SWS_BswM_00210]. A declaração da função é disponibilizada por meio do arquivo de cabeçalho BswM_Sd.h [SWS_BswM_00210].

Parâmetros e propriedades da assinatura

A função não retorna valor de retorno (void) e espera dois parâmetros de entrada em sua chamada [SWS_BswM_00210]:

• SdEventHandlerHandleId: identificador do tipo uint16, que endereça de forma unívoca o manipulador de eventos associado [SWS_BswM_00210].
• EventHandlerStatus: informação de status do tipo Sd_EventHandlerCurrentStateType, que reflete o estado atual do manipulador de eventos [SWS_BswM_00210].

Simultaneidade e tratamento de erros

A função é conduzida sob o Service-ID 0x20 e, de acordo com a especificação, é implementada de forma reentrante [SWS_BswM_00210]. Códigos de erro específicos, parâmetros de entrada/saída ou mensagens explícitas de erro via DET ou DEM não estão definidos para esta interface [SWS_BswM_00210].

A função BswM_WdgM_RequestPartitionReset é chamada pelo Watchdog Manager (WdgM) para solicitar ao Basic Software Mode Manager (BswM) o reset de uma partição específica [SWS_BswM_00157]. A declaração desta interface é disponibilizada por meio do cabeçalho BswM_WdgM.h e está associada ao Service ID 0x11 [SWS_BswM_00157].

Para a utilização e o contexto de chamada, aplicam-se as seguintes determinações da especificação:

• Parâmetros: Como parâmetro de entrada, é passado Application do tipo ApplicationType, que representa o identificador exclusivo da OS-Application em questão [SWS_BswM_00157]. Não existem parâmetros adicionais de entrada ou saída para esta chamada [SWS_BswM_00157].
• Valor de retorno: A função não possui valor de retorno (tipo de retorno void) [SWS_BswM_00157].
• Sincronicidade e concorrência: A execução da função ocorre de forma síncrona e está especificada como reentrante, tornando admissíveis chamadas paralelas [SWS_BswM_00157].
• Tratamento de erros: Códigos de erro específicos, reações a falhas, bem como mensagens para DET ou DEM não estão documentados na especificação deste elemento [SWS_BswM_00157].

Na interação dos módulos de software básico, a função forma a interface de notificação direta por meio da qual o WdgM informa o BswM de forma síncrona sobre a necessidade de reinicialização da partição para a OS-Application passada [SWS_BswM_00157].

A função BswM_MainFunction constitui a função principal periódica central do gerenciador de modos BSW (BswM) ([SWS_BswM_00053]). Ela possui o ID de serviço 0x03, não recebe parâmetros de passagem e não retorna nenhum valor (assinatura: void BswM_MainFunction(void)). Sua declaração é fornecida pelo arquivo de cabeçalho SchM_BswM.h ([SWS_BswM_00053]). Devido à disponibilização via SchM_BswM.h, a chamada na ECU deve ocorrer normalmente de forma cíclica através do Schedule Manager (SchM) no contexto de uma tarefa periódica do sistema operacional. Pergunta Q-fdb948e42c35d9fb (aberta)

Em relação à interação e à lógica de processamento, BswM_MainFunction é responsável pela avaliação de solicitações de modo diferidas: a função deve obrigatoriamente avaliar todas as regras que utilizam como entrada pelo menos uma solicitação de modo (Mode Request) com o parâmetro de configuração BswMRequestProcessing definido para o valor BSWM_DEFERRED ([SWS_BswM_00075]).

Para a vinculação prática e integração no sistema de software básico, resultam disso as seguintes condições de contorno:

• Contexto de chamada e escalonamento: a função não possui parâmetros nem valores de retorno ([SWS_BswM_00053]); ela é prevista para a inclusão recorrente no cronograma cíclico do escalonador do software básico.
• Processamento de regras: solicitações de modo que não são processadas imediatamente, mas configuradas para BSWM_DEFERRED, são desacopladas temporalmente e processadas em lote apenas no ciclo de execução desta função principal ([SWS_BswM_00075]).

usar

A função de callout definida pelo usuário é chamada pelo BSW Mode Manager assim que uma ação BswMUserCallout correspondente for executada [SWS_BswM_00270]. O nome concreto da função, bem como todos os parâmetros de passagem, são definidos por meio do parâmetro de configuração BswMUserCalloutFunction [SWS_BswM_00270]. A sintaxe é definida genericamente como void <BswMUserCalloutFunction>(implementation_specific), sendo eventuais valores de retorno totalmente ignorados pelo BswM [SWS_BswM_00270].

Simultaneidade e restrições

Tanto o comportamento de execução (síncrono ou assíncrono) quanto a reentrância da função de callout são especificados como dependentes da configuração [SWS_BswM_00270]. O contexto de chamada real depende presumivelmente do evento disparador do BswM ou da task na qual a ação do BswM é processada. Pergunta Q-2f3e2cdbb9de1794 (aberta) Os desenvolvedores devem, portanto, assegurar que a implementação atenda aos requisitos do contexto de execução selecionado quanto à segurança de threads (thread safety) e ao comportamento de bloqueio.

Tratamento de erros e configuração

A especificação não define mensagens de erro DET ou DEM específicas para este serviço (Service-ID 0x25) [SWS_BswM_00270]. Como o BswM ignora eventuais valores de retorno, a função não pode reportar erros ao BswM por meio de valores de retorno padronizados. A disponibilidade e a vinculação da função ocorrem por meio da configuração do módulo (referência ECUC_BswM_00954) [SWS_BswM_00270].

Utilização e definição de tipo

O tipo de dados BswM_ModeType serve no módulo BswM para a identificação unívoca dos modos que podem ser solicitados por usuários do BswM (BswM Users) [SWS_BswM_00214]. De acordo com a especificação, o tipo é derivado do tipo primitivo básico uint16 e abrange uma faixa de valores de 0 a 65535 [SWS_BswM_00214]. Ele é declarado e disponibilizado por meio do arquivo de cabeçalho BswM.h, o qual deve ser incluído pelos componentes solicitantes para utilização [SWS_BswM_00214].

Restrições e premissas

Unidades de software chamadoras passam valores de modo como um inteiro de 16 bits dentro dos limites de 0 a 65535 [SWS_BswM_00214]. Como a especificação não lista constantes simbólicas fixas, supõe-se que a atribuição concreta de valores inteiros individuais a modos específicos da aplicação provavelmente seja definida no âmbito da configuração do módulo BswM. Pergunta Q-94530792144d42ea (aberta) Para uma utilização livre de erros, deve-se assegurar que os solicitantes apliquem exclusivamente valores dentro da faixa de valores definida [SWS_BswM_00214].

Integração na pilha BSW

Interfaces que encaminham solicitações de modo de usuários para o BswM utilizam BswM_ModeType para a passagem tipada dos identificadores de modo [SWS_BswM_00214]. A disponibilização por meio de BswM.h assegura, com isso, uma tipagem uniforme através de diferentes limites de módulos da BSW [SWS_BswM_00214].

Utilização e definição de tipo

O tipo de dados BswM_UserType é disponibilizado por meio do arquivo de cabeçalho BswM.h e serve para a identificação unívoca de um usuário do BswM que direciona solicitações de modo ao Basic Software Mode Manager [SWS_BswM_00216]. O tipo é derivado do tipo inteiro básico uint16 e abrange uma faixa de valores de 0 a 65535 [SWS_BswM_00216].

Interação e integração

Na arquitetura de software, este tipo deve atuar primariamente como parâmetro de passagem em interfaces de solicitação de modo, para que o BswM possa atribuir a solicitação recebida à respectiva fonte. Pergunta Q-83bb1af3fb090e7e (aberta) Devido à largura de 16 bits, a definição de tipo oferece espaço para até 65536 identificadores de usuário diferentes no sistema [SWS_BswM_00216]. Os valores de instância concretos dos usuários são, provavelmente, gerados de forma específica para a configuração no âmbito da geração da BSW.

Restrições e tratamento de erros

Por se tratar de uma definição de tipo elementar, não estão previstos no escopo da especificação códigos de erro específicos, mensagens DET ou mecanismos de simultaneidade para este tipo. Módulos de software solicitantes devem assegurar que, nas chamadas, sejam passados exclusivamente valores dentro da faixa permitida de 0 a 65535 [SWS_BswM_00216].