FlexRay Driver (Fr)

A função síncrona Fr_Init serve para a inicialização do driver FlexRay (Fr) de acordo com [SWS_Fr_00032]. Ela é declarada por meio do arquivo de cabeçalho Fr.h e possui o Service ID 0x1c [SWS_Fr_00032]. Como único parâmetro de entrada, a interface espera Fr_ConfigPtr do tipo const Fr_ConfigType* [SWS_Fr_00032]. Este ponteiro referencia uma estrutura de configuração dependente do driver, a qual fornece todas as informações necessárias para a subsequente operação do driver FlexRay [SWS_Fr_00032]. A função não possui parâmetros de entrada/saída nem de saída e não retorna nenhum valor (void) [SWS_Fr_00032].

Em relação à concorrência e restrições, Fr_Init é especificada como não reentrante (Non Reentrant) [SWS_Fr_00032]. Chamadas não devem, portanto, ocorrer de forma alguma em paralelo ou aninhadas. Como a estrutura de configuração passada contém todos os dados fundamentais para a operação subsequente, a inicialização provavelmente deve ocorrer de forma sequencial na fase de inicialização do sistema global, antes que outros serviços de módulos sejam chamados [SWS_Fr_00032]. Pergunta Q-a208c696fbb083d4 (aberta)

Um tratamento de erros por meio de códigos de erro específicos ou retornos de status não está previsto na definição do serviço [SWS_Fr_00032]. Requisitos adicionais, por exemplo sobre notificações ao DET ou DEM, não estão documentados no presente conjunto de dados.

A função síncrona Fr_ControllerInit serve para inicializar um FlexRay Communication Controller (FlexRay CC) no contexto do driver FlexRay [SWS_Fr_00017]. Ela é declarada no arquivo de cabeçalho Fr.h e possui o ID de serviço 0x00 [SWS_Fr_00017]. O índice do controlador a ser inicializado é transmitido através do parâmetro de entrada Fr_CtrlIdx do tipo uint8 [SWS_Fr_00017].

Como valor de retorno, a função fornece o status Std_ReturnType [SWS_Fr_00017]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00017].
• E_NOT_OK: A chamada foi cancelada prematuramente devido a erros ocorridos [SWS_Fr_00017].

Códigos de erro detalhados, bem como notificações ao DET ou DEM, não estão listados no escopo da interface especificada [SWS_Fr_00017].

Em relação à concorrência, a função é classificada como não reentrante para a mesma unidade de hardware (Non Reentrant for the same device) [SWS_Fr_00017]. Portanto, uma chamada para o mesmo índice de controlador Fr_CtrlIdx não pode ocorrer simultaneamente; por outro lado, chamadas paralelas para diferentes controladores devem ser permitidas [SWS_Fr_00017]. Pergunta Q-5bbbba38e8530b43 (aberta) Como não estão definidos parâmetros de entrada e saída (inout/out), a inicialização ocorre de forma puramente baseada em estado no driver [SWS_Fr_00017].

A função Fr_StartCommunication serve para iniciar a comunicação FlexRay em um controlador especificado [SWS_Fr_00010]. A interface está disponível através do arquivo de cabeçalho Fr.h [SWS_Fr_00010].

usar

A chamada ocorre de forma assíncrona mediante a passagem do parâmetro Fr_CtrlIdx (service ID 0x03), que indica o índice do controlador de comunicação FlexRay no contexto do driver [SWS_Fr_00010]. Como valor de retorno, a função retorna um status do tipo Std_ReturnType [SWS_Fr_00010]:

• E_OK: a chamada de API foi concluída com sucesso [SWS_Fr_00010]. Interpretação: devido à semântica assíncrona, isso deve significar a aceitação bem-sucedida do comando de inicialização, enquanto o estabelecimento real da conexão ocorre subsequentemente. Pergunta Q-fabca57ea7d32a05 (aberta)
• E_NOT_OK: a chamada de API foi abortada em decorrência de erros [SWS_Fr_00010].

Simultaneidade e restrições

Para o mesmo controlador FlexRay, Fr_StartCommunication é especificada como não reentrante [SWS_Fr_00010]. Para instâncias diferentes de controlador, por outro lado, a chamada é reentrante. Erros específicos de desenvolvimento (DET), mensagens de erro (DEM) ou dependências adicionais não constam nos presentes dados de especificação.

usar

A função Fr_AllowColdstart serve para chamar o comando de Controller-Host-Interface ALLOW_COLDSTART no FlexRay Communication Controller [SWS_Fr_00114]. A declaração é fornecida através do ficheiro de cabeçalho Fr.h; o serviço tem o Service-ID 0x23 [SWS_Fr_00114]. Através do parâmetro de passagem Fr_CtrlIdx é especificado o índice do controlador FlexRay a ser acedido dentro do controlador de dispositivo FlexRay [SWS_Fr_00114]. A chamada é executada de forma assíncrona [SWS_Fr_00114].

Tratamento de erros e valores de retorno

A função retorna um estado do tipo Std_ReturnType [SWS_Fr_00114]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00114].
• E_NOT_OK: a chamada de API foi abortada em decorrência de erros [SWS_Fr_00114].

Causas de erro específicas ou notificações para DEM ou DET não estão listadas separadamente para este serviço na especificação de funções [SWS_Fr_00114].

Simultaneidade e restrições

A interface é não reentrante para a mesma instância de controlador (Non Reentrant for the same device) [SWS_Fr_00114]. Chamadas com o mesmo parâmetro Fr_CtrlIdx não devem, portanto, ocorrer em paralelo ou de forma interruptiva [SWS_Fr_00114]. Interpretação: Devido à semântica de execução assíncrona, o valor de retorno E_OK presumivelmente apenas confirma a aceitação do comando CHI pelo controlador de dispositivo, enquanto a alteração de estado interna do controlador ocorre desfasada no tempo [SWS_Fr_00114]. Pergunta Q-e5c407f32c449510 (aberta)

Utilização e funcionamento

A função Fr_AllSlots serve para o envio do comando CHI (Controller Host Interface) ALL_SLOTS ao FlexRay Communication Controller endereçado [SWS_Fr_00516]. Ela é disponibilizada por meio do cabeçalho Fr.h e possui o Service ID 0x24 [SWS_Fr_00516].

Como parâmetro de entrada, a função espera Fr_CtrlIdx, que indica o índice do controlador FlexRay afetado no contexto do driver FlexRay [SWS_Fr_00516]. A execução ocorre de forma assíncrona [SWS_Fr_00516]. O valor de retorno E_OK sinaliza que a chamada de API foi concluída com sucesso, enquanto E_NOT_OK indica um cancelamento devido a erros [SWS_Fr_00516]. Devido à semântica assíncrona, E_OK provavelmente confirma apenas o recebimento ou disparo bem-sucedido do comando CHI, e não a reação de hardware concluída do controlador (interpretação). Pergunta Q-c526e3b174a4b44a (aberta)

Tratamento de erros e simultaneidade

Se a execução falhar, a chamada é interrompida com o valor de retorno E_NOT_OK [SWS_Fr_00516]. Causas de erro concretas ou mensagens de DET/DEM não são mencionadas na especificação deste elemento.

Em relação à reentrância, Fr_AllSlots é especificada como não reentrante para o mesmo controlador (Non Reentrant for the same device) [SWS_Fr_00516]. Chamadas concorrentes para a mesma instância de controlador devem, portanto, ser evitadas por camadas superiores. Chamadas paralelas para instâncias de controladores diferentes, por outro lado, provavelmente são permitidas (interpretação). Pergunta (aberta)

A função Fr_HaltCommunication serve para iniciar a interrupção da comunicação em um controlador de comunicação FlexRay, executando o comando de CHI do CC 'DEFERRED_HALT' [SWS_Fr_00014].

Utilização e parâmetros

A chamada ocorre de forma assíncrona e é disponibilizada através do cabeçalho Fr.h (ID de serviço 0x04) [SWS_Fr_00014]:

• Fr_CtrlIdx (parâmetro de entrada): determina o índice do controlador de comunicação FlexRay a ser comandado dentro do driver FlexRay [SWS_Fr_00014].
• Valor de retorno (Std_ReturnType): retorna E_OK se a chamada da função tiver sido concluída com sucesso, ou E_NOT_OK se a chamada tiver sido cancelada em decorrência de erros [SWS_Fr_00014].

Simultaneidade e restrições

Em relação ao contexto de chamada e à concorrência, Fr_HaltCommunication não é reentrante em relação ao mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00014]. Consequentemente, nenhuma chamada concorrente ou sobreposta pode ocorrer para o mesmo índice de controlador. Por outro lado, chamadas para diferentes instâncias de controlador são permitidas.

Tratamento de erros

Se ocorrer um erro durante a chamada, a função cancela a execução e sinaliza isso através do valor de retorno E_NOT_OK [SWS_Fr_00014]. Mensagens de erro detalhadas não estão listadas no escopo da especificação para esta função.

A função síncrona Fr_AbortCommunication interrompe a comunicação em andamento, executando o comando da interface host-controlador (comando de CHI) FREEZE no controlador de comunicação (CC) FlexRay especificado [SWS_Fr_00011].

Chamada e parâmetros

A chamada ocorre através do cabeçalho Fr.h, informando o índice do controlador Fr_CtrlIdx, que identifica univocamente o CC FlexRay de destino no contexto do driver FlexRay [SWS_Fr_00011]. Além disso, não existem parâmetros de entrada e saída.

Valores de retorno e tratamento de erros

A função retorna um status do tipo Std_ReturnType [SWS_Fr_00011]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00011].
• E_NOT_OK: a chamada de API foi abortada devido a erros [SWS_Fr_00011].

Simultaneidade e restrições

Em relação ao comportamento de concorrência, Fr_AbortCommunication é especificada como não reentrante para o mesmo controlador de comunicação (Non Reentrant for the same device) [SWS_Fr_00011]. Chamadas paralelas para a mesma instância de controlador devem ser evitadas pelo chamador.

Utilização e semântica

A função Fr_SendWUP serve para desencadear um processo de wakeup no barramento FlexRay através do envio do comando CHI WAKEUP para o controlador de comunicação [SWS_Fr_00009]. Através do parâmetro Fr_CtrlIdx, é passado o índice do controlador de destino no contexto do driver [SWS_Fr_00009]. A chamada ocorre de forma assíncrona; a interface dispara o comando, enquanto a transmissão do padrão de wakeup é realizada subsequentemente pelo hardware [SWS_Fr_00009]. A declaração está disponível através de Fr.h e o serviço possui o service ID 0x06 [SWS_Fr_00009].

Tratamento de erros e valores de retorno

A função retorna um valor de status do tipo Std_ReturnType [SWS_Fr_00009]:

• E_OK: a chamada de API foi executada com sucesso e o comando CHI foi enviado [SWS_Fr_00009].
• E_NOT_OK: a chamada de API foi abortada devido a erros ocorridos [SWS_Fr_00009].

Simultaneidade e restrições

A função é especificada como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00009]. Interpretação: isso deve significar que módulos de nível superior devem sincronizar chamadas simultâneas para a mesma instância de controlador, enquanto chamadas para diferentes instâncias de controlador podem ser executadas de forma concorrente. Pergunta Q-0e3b4e70a0755877 (aberta) Não são definidos parâmetros de entrada/saída nem parâmetros exclusivos de saída [SWS_Fr_00009].

A função Fr_TransmitTxLPdu serve para a transmissão de dados úteis através da rede FlexRay [SWS_Fr_00092]. Ela processa a solicitação de envio com semântica assíncrona e associa a LSdu a ser transmitida ao quadro FlexRay identificado por Fr_LPduIdx [SWS_Fr_00092].

Utilização e parâmetros

A chamada ocorre através do arquivo de cabeçalho Fr.h (ID de serviço 0x0b), especificando o índice do controlador Fr_CtrlIdx para o FlexRay Communication Controller bem como o índice de quadro unívoco Fr_LPduIdx [SWS_Fr_00092]. Através do ponteiro Fr_LSduPtr, é transmitida a LSdu de envio disponibilizada no buffer, cujo comprimento de dados em bytes é especificado através de Fr_LSduLength [SWS_Fr_00092]. Através do parâmetro de saída Fr_SlotAssignmentPtr, o chamador pode consultar o ciclo de envio real, o ID do slot e o canal FlexRay; se essa informação não for necessária, pode ser passado um NULL_PTR para isso [SWS_Fr_00092].

Valores de retorno e tratamento de erros

A função confirma a chamada com o tipo de retorno Std_ReturnType: o valor de retorno E_OK confirma a conclusão bem-sucedida da chamada da API, enquanto E_NOT_OK sinaliza um cancelamento devido a erros [SWS_Fr_00092]. Mensagens específicas de DET ou DEM não constam nos dados de especificação.

simultaneidade

Em relação à concorrência, Fr_TransmitTxLPdu é especificada como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00092]. Chamadas de envio paralelas para o mesmo controlador FlexRay são, portanto, inadmissíveis.

Utilização e semântica

A função síncrona Fr_CancelTxLPdu cancela a transmissão já pendente de uma L-PDU que se encontra em um recurso físico de transmissão do controlador (por exemplo, um buffer de transmissão) [SWS_Fr_00610]. A função está declarada no cabeçalho Fr.h e possui o ID de serviço 0x2d [SWS_Fr_00610].

Para a identificação da transmissão a ser cancelada, a interface espera dois parâmetros [SWS_Fr_00610]:

• Fr_CtrlIdx: índice do FlexRay Communication Controller no contexto do driver FlexRay [SWS_Fr_00610].
• Fr_LPduIdx: Índice unívoco para a identificação do respectivo frame FlexRay [SWS_Fr_00610].

Valores de retorno e tratamento de erros

A chamada de função retorna um valor de estado do tipo Std_ReturnType [SWS_Fr_00610]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00610].
• E_NOT_OK: A chamada foi cancelada devido a erros [SWS_Fr_00610].

Códigos de erro específicos, entradas de DET ou DEM não estão documentados para esta função; na ocorrência de um erro, a função o sinaliza exclusivamente através do valor de retorno E_NOT_OK [SWS_Fr_00610].

Simultaneidade e restrições

Em relação ao comportamento de concorrência, Fr_CancelTxLPdu é especificada como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00610]. Presumivelmente, isso significa que chamadas paralelas para a mesma instância de controlador devem ser sincronizadas no nível do chamador. Pergunta Q-ec480944eec04076 (aberta) Não há outros parâmetros de entrada ou saída [SWS_Fr_00610].

A função síncrona Fr_ReceiveRxLPdu serve para a receção de dados úteis a partir da rede FlexRay e está disponível através do cabeçalho Fr.h [SWS_Fr_00093].

Parâmetros e uso

Através dos parâmetros de entrada Fr_CtrlIdx e Fr_LPduIdx, são endereçados univocamente o respectivo controlador de comunicação do driver FlexRay e o quadro FlexRay a ser recebido [SWS_Fr_00093]. Os dados úteis e de estado são passados ao chamador através de múltiplos ponteiros:

• Fr_LSduPtr: Ponteiro para o buffer no qual a L-SDU recebida deve ser armazenada.
• Fr_LPduStatusPtr: Ponteiro para o local de memória para o status de receção da L-PDU.
• Fr_LSduLengthPtr: Local de memória para o comprimento da L-SDU recebida em bytes, correspondente ao número de bytes copiados em Fr_LSduPtr.
• Fr_SlotAssignmentPtr: Local de memória para ciclo, ID do slot e canal do quadro. Passar um NULL_PTR para isso sinaliza que o chamador não necessita dessas informações de alocação.

Simultaneidade e tratamento de erros

A interface é executada sincronamente, mas não é reentrante para o mesmo dispositivo [SWS_Fr_00093]. Uma operação de receção bem-sucedida é confirmada com E_OK, enquanto em caso de erros a chamada é cancelada e E_NOT_OK é retornado [SWS_Fr_00093]. Códigos de erro específicos de DET ou DEM não estão indicados nos dados de especificação da função.

A interface síncrona Fr_CheckTxLPduStatus (ID de serviço 0x0d) serve, de acordo com [SWS_Fr_00094], para a verificação do status atual de transmissão de uma L-SDU ou de um quadro FlexRay no driver FlexRay. Ela é disponibilizada através do cabeçalho Fr.h.

Como parâmetros de entrada, a função requer o índice do controlador de comunicação FlexRay (Fr_CtrlIdx) bem como o índice Fr_LPduIdx, que identifica univocamente o quadro FlexRay a ser verificado no driver [SWS_Fr_00094]. O status de envio apurado da LPdu é gravado de volta através do parâmetro de saída Fr_TxLPduStatusPtr no endereço de memória passado [SWS_Fr_00094].

Adicionalmente, o parâmetro de saída Fr_SlotAssignmentPtr possibilita a determinação da alocação de slots: ele referencia um local de memória no qual são armazenados o ciclo real, o ID do slot e o canal do quadro endereçado [SWS_Fr_00094]. Se o chamador não necessitar dessas informações de alocação, a passagem de um NULL_PTR sinaliza que esses dados não precisam ser disponibilizados [SWS_Fr_00094].

A interface deve ser executada de forma síncrona e é especificada como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00094]. Em caso de conclusão bem-sucedida, a chamada fornece o valor de retorno E_OK; no caso de erros ocorridos, a função é abortada e retorna E_NOT_OK [SWS_Fr_00094].

Utilização e semântica

A função síncrona Fr_PrepareLPdu serve, de acordo com [SWS_Fr_00107], para a preparação de uma L-PDU (Prepares a LPdu) e é disponibilizada por meio do cabeçalho Fr.h. Como parâmetro de entrada, o serviço espera o índice de controlador Fr_CtrlIdx para endereçamento do FlexRay Communication Controller (CC) no contexto do driver, bem como Fr_LPduIdx para a identificação unívoca do respectivo frame FlexRay [SWS_Fr_00107]. Interpretação: a chamada provavelmente deve inicializar ou armar estruturas de buffer específicas do hardware para a subsequente operação de envio ou recepção do frame. Pergunta Q-c4375099d73dbea2 (aberta)

Simultaneidade e restrições

Em relação ao comportamento de concorrência, Fr_PrepareLPdu é especificada como não reentrante para a mesma unidade de hardware (Non Reentrant for the same device) [SWS_Fr_00107]. Uma chamada paralela ou de interrupção para o mesmo índice de controlador Fr_CtrlIdx deve ser obrigatoriamente evitada pelo chamador.

Valores de retorno e tratamento de erros

A função possui o Service ID 0x1f e reporta seu status por meio do tipo de retorno Std_ReturnType [SWS_Fr_00107]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00107].
• E_NOT_OK: a chamada de API foi cancelada prematuramente devido a erros ocorridos [SWS_Fr_00107]. Códigos de erro específicos de DET ou DEM não são definidos no presente trecho de especificação.

Utilização e parâmetros

A função síncrona Fr_ReconfigLPdu permite a reconfiguração dinâmica de uma LPDU FlexRay em tempo de execução [SWS_Fr_00524]. Disponibilizada através do cabeçalho Fr.h, a chamada endereça através de Fr_CtrlIdx o respectivo controlador FlexRay e, através de Fr_LPduIdx, o identificador unívoco do frame AUTOSAR_SWS_FlexRayDriver p. 65.

Os seguintes parâmetros de destino são passados durante a reconfiguração [SWS_Fr_00524]:

• Fr_FrameId e Fr_ChnlIdx: definição do novo ID de frame bem como do canal de comunicação.
• Fr_CycleRepetition e Fr_CycleOffset: configuração da filtragem de ciclo para a LPDU.
• Fr_PayloadLength e Fr_HeaderCRC: comprimento dos dados úteis em bytes, bem como o CRC de cabeçalho correspondente do frame.

Concorrência e valores de retorno

O serviço não é reentrante para o mesmo controlador (Non Reentrant for the same device) [SWS_Fr_00524]. Por outro lado, em chamadas para instâncias distintas de controladores FlexRay, presume-se que a reentrância esteja garantida (interpretação). Pergunta Q-85908ef4796c80c7 (aberta) Em caso de reconfiguração bem-sucedida, a chamada retorna E_OK; se a reconfiguração falhar devido a erros, é retornado E_NOT_OK AUTOSAR_SWS_FlexRayDriver p. 65.

usar

A função síncrona do driver Fr_DisableLPdu serve para desativar o recurso de hardware de uma LPdu do FlexRay para a transmissão ou recepção ([SWS_Fr_00539]). A interface é disponibilizada por meio do arquivo de cabeçalho Fr.h e está associada ao Service ID 0x26 ([SWS_Fr_00539]).

Para a chamada da função, devem ser passados dois parâmetros obrigatórios ([SWS_Fr_00539]):

• Fr_CtrlIdx: o índice do FlexRay Communication Controller dentro do contexto do driver.
• Fr_LPduIdx: o índice unívoco para identificação do respectivo frame FlexRay ou da LPdu.

Como valor de retorno, a função fornece o status Std_ReturnType ([SWS_Fr_00539]). O valor E_OK sinaliza uma chamada finalizada com sucesso, enquanto E_NOT_OK é retornado caso a chamada tenha sido cancelada devido a erros.

Tratamento de erros

Na presente especificação, não são definidos códigos de erro específicos nem mensagens para DET ou DEM para este serviço; o comportamento de falha manifesta-se diretamente no valor de retorno E_NOT_OK ([SWS_Fr_00539]).

Simultaneidade e restrições

Em relação à reentrância, Fr_DisableLPdu é classificada como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) ([SWS_Fr_00539]). Os chamadores devem, portanto, assegurar que chamadas simultâneas para o mesmo controlador sejam sincronizadas.

A função síncrona Fr_CancelAbsoluteTimer serve para a parada ordenada de um temporizador absoluto ativo em um FlexRay Communication Controller ([SWS_Fr_00095]). Ela é disponibilizada através do arquivo de cabeçalho Fr.h e possui o ID de serviço 0x13 ([SWS_Fr_00095]).

Parâmetros e valor de retorno

• Fr_CtrlIdx: Passa o índice do FlexRay Communication Controller em questão no contexto do driver FlexRay ([SWS_Fr_00095]).
• Fr_AbsTimerIdx: Determina o índice do temporizador absoluto a ser parado no contexto do controlador FlexRay selecionado ([SWS_Fr_00095]).
• Valor de retorno: Fornece, através do tipo Std_ReturnType, o status E_OK em caso de execução bem-sucedida ou E_NOT_OK se a chamada tiver sido cancelada devido a erros ([SWS_Fr_00095]).

Simultaneidade e restrições

Em relação à concorrência, a interface é definida como não reentrante para o mesmo dispositivo ("Non Reentrant for the same device") ([SWS_Fr_00095]). As camadas chamadoras devem garantir que não ocorram acessos concorrentes ou interruptivos para o mesmo controlador. Interpretação: para controladores diferentes, por outro lado, a execução deve ser admissível de forma reentrante. Pergunta Q-01203b0b28193021 (aberta)

A função síncrona Fr_EnableAbsoluteTimerIRQ serve para a ativação da linha de interrupção de um temporizador absoluto dentro de um FlexRay Communication Controller [SWS_Fr_00034]. O serviço é disponibilizado através do arquivo de cabeçalho Fr.h e possui o service ID 0x15 [SWS_Fr_00034].

Na chamada, a interface espera dois parâmetros de entrada [SWS_Fr_00034]:

• Fr_CtrlIdx: índice do FlexRay Communication Controller no contexto do driver FlexRay [SWS_Fr_00034].
• Fr_AbsTimerIdx: índice do temporizador absoluto no contexto do controlador FlexRay endereçado [SWS_Fr_00034].

O valor de retorno do tipo Std_ReturnType sinaliza o resultado da execução [SWS_Fr_00034]:

• E_OK: A chamada de API foi concluída com sucesso [SWS_Fr_00034].
• E_NOT_OK: a chamada da função foi abortada devido a erros [SWS_Fr_00034].

Em termos de concorrência, a função é especificada como não reentrante para o mesmo dispositivo («Non Reentrant for the same device») [SWS_Fr_00034]. Isto exige que chamadas simultâneas para a mesma instância de controlador devam ser obrigatoriamente evitadas; presume-se, contudo, que uma chamada paralela para diferentes instâncias de controlador seja admissível. Pergunta Q-d7e594a84357e129 (aberta) Códigos de falha específicos para falhas de desenvolvimento ou de produção (DET/DEM) não são listados na descrição da função; quaisquer falhas ocorridas levam diretamente ao retorno de E_NOT_OK [SWS_Fr_00034].

A função síncrona Fr_AckAbsoluteTimerIRQ pertence ao módulo do driver FlexRay (Fr) na plataforma AUTOSAR Classic e serve para redefinir a condição de interrupção de um temporizador absoluto [SWS_Fr_00036]. A declaração da interface é disponibilizada através do arquivo de cabeçalho Fr.h e está associada ao ID de serviço hexadecimal 0x17 [SWS_Fr_00036].

Para o endereçamento unívoco do temporizador, a função espera dois parâmetros de entrada do tipo uint8, ao passo que não existem parâmetros de entrada/saída ou puramente de saída [SWS_Fr_00036]:

• Fr_CtrlIdx: Transmite o índice do FlexRay Communication Controller (CC) dentro do contexto do driver FlexRay [SWS_Fr_00036].
• Fr_AbsTimerIdx: Designa o índice do temporizador absoluto dentro do contexto do respectivo FlexRay Communication Controller [SWS_Fr_00036].

O resultado da execução da função é reportado através do valor de status do tipo Std_ReturnType. Se a chamada foi concluída com sucesso, a função retorna E_OK [SWS_Fr_00036]. Se ocorrerem erros durante a execução, a chamada de função é abortada prematuramente e retorna, em vez disso, E_NOT_OK [SWS_Fr_00036].

Em relação ao comportamento de concorrência, o serviço é classificado como não reentrante para o mesmo dispositivo (Non Reentrant for the same device) [SWS_Fr_00036]. Chamadas para a mesma instância de controlador devem, portanto, ocorrer de forma síncrona e não podem ser executadas concorrentemente de forma sobreposta [SWS_Fr_00036].

A função síncrona Fr_DisableAbsoluteTimerIRQ serve, no driver FlexRay, para desativar de forma direcionada a linha de interrupção de um temporizador absoluto [SWS_Fr_00035]. Como parâmetros de entrada, a interface espera o índice do controlador Fr_CtrlIdx para endereçar o respectivo controlador de comunicação (CC) FlexRay no contexto do driver, bem como Fr_AbsTimerIdx para identificar o temporizador absoluto dentro desse controlador [SWS_Fr_00035]. A declaração da função é disponibilizada através do arquivo de cabeçalho Fr.h [SWS_Fr_00035].

O resultado da execução é transmitido sincronamente ao chamador através do tipo de retorno Std_ReturnType [SWS_Fr_00035]. Se o serviço pôde ser terminado de forma adequada e bem-sucedida, ele retorna E_OK [SWS_Fr_00035]. Se, por outro lado, ocorrerem erros durante o processamento, a função cancela o processo e sinaliza isso pelo valor de retorno E_NOT_OK [SWS_Fr_00035]. Erros concretos de desenvolvimento ou de tempo de execução (DET/DEM) não estão indicados no elemento de especificação, de modo que os estados de erro devem ser primariamente reconhecidos e tratados com base no valor de retorno [SWS_Fr_00035].

Em relação à concorrência, Fr_DisableAbsoluteTimerIRQ é definida como não reentrante para o mesmo dispositivo (same device) [SWS_Fr_00035]. Portanto, múltiplas chamadas para o mesmo índice de controlador não devem ocorrer de forma concorrente e devem ser sincronizadas pelo chamador, ao passo que o acesso paralelo a diferentes controladores é permitido [SWS_Fr_00035].

A função síncrona Fr_ReadCCConfig lê um parâmetro específico de configuração do protocolo FlexRay de um controlador diretamente da configuração de módulo do driver FlexRay [SWS_Fr_00651]. A interface é declarada através do cabeçalho Fr.h e possui o ID de serviço 0x2e [SWS_Fr_00651].

Parâmetros e valores de retorno

• Fr_CtrlIdx: Determina o índice do FlexRay Communication Controller afetado no contexto do driver [SWS_Fr_00651].
• Fr_ConfigParamIdx: Identifica o parâmetro a ser lido por meio de macros definidas no formato FR_CIDX_<config_parameter_name> [SWS_Fr_00651].
• Fr_ConfigParamValuePtr: Ponteiro para o endereço de memória do tipo uint32, no qual o valor lido é gravado [SWS_Fr_00651].
• Valor de retorno: Retorna E_OK em caso de execução bem-sucedida ou E_NOT_OK em caso de erro [SWS_Fr_00651].

Concorrência e comportamento em caso de erro

A função foi projetada para não ser reentrante para o mesmo controlador («Non Reentrant for the same device») [SWS_Fr_00651]. Chamadas simultâneas para diferentes instâncias de controladores são, portanto, provavelmente permitidas. Pergunta Q-b5e4172654514747 (aberta) Erros específicos de DET ou DEM não são mencionados na definição da interface; estados de erro levam ao cancelamento com o retorno de E_NOT_OK [SWS_Fr_00651]. Presumivelmente, o chamador deve garantir que Fr_ConfigParamValuePtr aponte para uma área de memória válida.

O tipo de enumeração Fr_SlotModeType faz parte da definição de interface do driver FlexRay no AUTOSAR Classic e é disponibilizado através do cabeçalho Fr_GeneralTypes.h [SWS_Fr_00506]. A definição do tipo referencia formalmente o tipo T_SlotMode da especificação do protocolo FlexRay, onde este é descrito no capítulo sobre o Protocol Operation Control (status do POC) [SWS_Fr_00506].

A enumeração especifica o estado do processamento de slots do controlador por meio de três valores fixamente definidos [SWS_Fr_00506]:

• FR_SLOTMODE_KEYSLOT (valor 0x00): Mapeia o literal KEYSLOT da definição formal do tipo T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL_PENDING (valor 0x01): Mapeia o literal ALL_PENDING da definição formal do tipo T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL (valor 0x02): Mapeia o literal ALL da definição formal do tipo T_SlotMode [SWS_Fr_00506].

No uso com controladores que estão em conformidade com o padrão mais antigo FlexRay 2.1 Rev A, deve ser considerada uma nomenclatura divergente: em vez do literal KEYSLOT, surge aqui o literal SINGLESLOT [SWS_Fr_00506]. Interpretação: no nível do driver e do software, o tipo deve servir para determinar se o controlador FlexRay liberou atualmente apenas slots-chave (Key Slots) ou todos os slots para transmissão, ou se uma mudança correspondente está pendente. Pergunta Q-f926c41c8a5d3380 (aberta)

usar

O tipo de enumeração Fr_ErrorModeType mapeia os modos de erro do FlexRay Protocol Operation Control (POC) e é disponibilizado através do arquivo de cabeçalho Fr_GeneralTypes.h [SWS_Fr_00507]. A enumeração define os estados do mecanismo de monitoramento de erros do controlador de comunicação e referencia a definição formal do tipo T_ErrorMode no status do POC do FlexRay [SWS_Fr_00507].

O intervalo de valores compreende três estados, de acordo com [SWS_Fr_00507]:

• FR_ERRORMODE_ACTIVE (0x00): Representa o literal ACTIVE da definição formal do tipo T_ErrorMode e identifica o estado livre de erros ou operação normal do controlador de comunicação.
• FR_ERRORMODE_PASSIVE (0x01): Corresponde ao literal PASSIVE da definição formal do tipo T_ErrorMode, no qual foram registrados erros no barramento e a comunicação pode estar restrita.
• FR_ERRORMODE_COMM_HALT (0x02): Mapeia o literal COMM_HALT da definição formal do tipo T_ErrorMode quando a comunicação do barramento foi interrompida devido a estados de erro graves.

Integração e condições de contorno

Interpretação: O tipo deve servir principalmente como valor de retorno ou parâmetro de status em funções de consulta do driver FlexRay, a fim de transmitir o estado do controlador a camadas de software de nível superior. Pergunta Q-e4d6ae534d1dfa2c (aberta) Como [SWS_Fr_00507] especifica exclusivamente a estrutura de dados, não existem tratamentos de erro próprios via DET ou DEM no nível do tipo, nem requisitos diretos de reentrância ou concorrência.

O tipo de enumeração Fr_WakeupStatusType é disponibilizado através do arquivo de cabeçalho Fr_GeneralTypes.h e mapeia o status de despertar do driver FlexRay de acordo com a definição formal T_WakeupStatus do status do POC [SWS_Fr_00508].

Utilização e gama de valores

O tipo representa os vários estados e eventos durante um processo de despertar do FlexRay e compreende sete valores de enumeração específicos [SWS_Fr_00508]:

• FR_WAKEUP_UNDEFINED (0x00): Corresponde ao literal UNDEFINED da definição formal do tipo [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_HEADER (0x01): Identifica a receção de um cabeçalho de despertar (literal RECEIVED_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_WUP (0x02): Representa o padrão de despertar recebido (literal RECEIVED_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_HEADER (0x03): Indica uma colisão em um cabeçalho recebido (literal COLLISION_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_WUP (0x04): Sinaliza uma colisão durante um padrão de despertar (literal COLLISION_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_UNKNOWN (0x05): Descreve uma colisão com causa desconhecida (literal COLLISION_UNKNOWN) [SWS_Fr_00508].
• FR_WAKEUP_TRANSMITTED (0x06): Confirma o envio bem-sucedido do sinal de despertar (literal TRANSMITTED) [SWS_Fr_00508].

Interação e restrições

Interpretação: O tipo deve servir primariamente como parâmetro de status de funções do driver para permitir aos módulos de nível superior um diagnóstico preciso do estado do canal e de despertar. Pergunta Q-48907418bc3729a1 (aberta) Como a especificação não define códigos de erro específicos ou restrições de concorrência para o próprio tipo, o uso está sujeito às convenções de chamada das respectivas funções de API que realizam a consulta [SWS_Fr_00508].

O tipo de enumeração Fr_StartupStateType é fornecido em conformidade com [SWS_Fr_00509] através do ficheiro de cabeçalho Fr_GeneralTypes.h e mapeia os estados de inicialização do controlador de protocolo FlexRay (estado POC) em valores padronizados. A definição refere-se à definição de tipo formal T_StartupState da secção 2.2.1.3 da especificação.

O intervalo de valores compreende onze estados discretos que mapeiam a sequência da inicialização do protocolo:

• FR_STARTUP_UNDEFINED (0x00): Representa um estado de inicialização indefinido.
• FR_STARTUP_COLDSTART_LISTEN (0x01) a FR_STARTUP_COLDSTART_GAP (0x09): Representam as fases do arranque a frio, incluindo a fase de escuta, verificação de consistência, resolução de colisões e adesão (Coldstart Join).
• FR_STARTUP_INTEGRATION_LISTEN (0x06), FR_STARTUP_INITIALIZE_SCHEDULE (0x07) e FR_STARTUP_INTEGRATION_CONSISTENCY_CHECK (0x08): Representam etapas de integração e de inicialização no plano de temporização.
• FR_STARTUP_EXTERNAL_STARTUP (0x0A): Representa a inicialização controlada externamente.

Os módulos de software integradores utilizam este tipo (interpretação: primariamente para consulta de estado ou monitorização da inicialização do controlador). Pergunta Q-7d07faa6c48d4e58 (aberta) Uma vez que Fr_StartupStateType é uma definição de tipo pura, não são disparados diretamente códigos de falha ou mensagens de falha; no entanto, as entidades avaliadoras devem ter em conta que valores fora do intervalo de 0x00 a 0x0A não estão especificados.

O tipo de dados Fr_POCStatusType é especificado como uma estrutura de dados e é disponibilizado através do ficheiro de cabeçalho Fr_GeneralTypes.h [SWS_Fr_00510]. A definição formal remete para a descrição do tipo T_POCStatus na secção 2.2.1.3 (POC status) da especificação do protocolo FlexRay [SWS_Fr_00510].

Uso e construção da estrutura

A estrutura agrega o estado atual de operação e de protocolo do FlexRay Protocol Operation Control (POC) [SWS_Fr_00510]. É composta pelos seguintes elementos:

• State (tipo Fr_POCStateType) e StartupState (tipo Fr_StartupStateType) para indicar o estado POC atual, bem como o estado de inicialização [SWS_Fr_00510].
• ErrorMode (tipo Fr_ErrorModeType) e Freeze (tipo boolean) para assinalar o modo de erro e uma paragem do controlador [SWS_Fr_00510].
• SlotMode (tipo Fr_SlotModeType) e WakeupStatus (tipo Fr_WakeupStatusType) para o modo de operação de slot e o estado de despertar [SWS_Fr_00510].
• CHIHaltRequest, CHIReadyRequest bem como ColdstartNoise (respetivamente boolean) para sinalizar pedidos de interface do anfitrião ou ruído na linha durante o arranque a frio [SWS_Fr_00510].

Simultaneidade e integração

Interpretação: Como Fr_POCStatusType é uma estrutura de dados pura sem lógica funcional própria, deverá atuar primariamente como parâmetro de saída em consultas de estado do hardware FlexRay. Pergunta Q-960f2475ff1068fc (aberta) Caso múltiplas tarefas ou camadas de software acedam a instâncias desta estrutura, os chamadores devem assegurar de forma autónoma uma sincronização adequada, de modo a garantir uma leitura consistente dos subestados correlacionados [SWS_Fr_00510].

O tipo de enumeração Fr_TxLPduStatusType serve, na plataforma AUTOSAR Classic, para determinar se uma LPdu FlexRay (Link Layer Protocol Data Unit) foi transmitida com sucesso ou não [SWS_Fr_00511]. A definição do tipo é disponibilizada para módulos de software através do arquivo de cabeçalho Fr_GeneralTypes.h [SWS_Fr_00511].

O intervalo de valores da enumeração compreende três estados de status inequívocos para processos de transmissão [SWS_Fr_00511]:

• FR_TRANSMITTED (0x00): A LPdu foi transmitida com sucesso pelo barramento [SWS_Fr_00511].
• FR_TRANSMITTED_CONFLICT (0x01): Durante a transmissão, ocorreu um conflito [SWS_Fr_00511].
• FR_NOT_TRANSMITTED (0x02): A LPdu não foi transmitida [SWS_Fr_00511].

Em relação à interação e ao contexto de chamada, é provável que este valor de estado seja tipicamente utilizado por camadas superiores para consultar o estado do buffer de transmissão no driver FlexRay (interpretação). Pergunta Q-347a88512db1f006 (aberta) Códigos de erro específicos, rotinas de tratamento de erros bem como notificações DET ou DEM não estão previstos para este tipo de dados nas especificações, uma vez que se trata de uma mera declaração de tipo [SWS_Fr_00511].

O tipo de enumeração Fr_RxLPduStatusType faz parte do módulo AUTOSAR Classic Fr e é disponibilizado através do arquivo de cabeçalho Fr_GeneralTypes.h [SWS_Fr_00512]. Ele serve para determinar se uma L-PDU (PDU da camada de enlace FlexRay) foi recebida ou não [SWS_Fr_00512].

O tipo define três valores de estado discretos para a avaliação do estado de recepção [SWS_Fr_00512]:

• FR_RECEIVED (0x00): A L-PDU foi recebida com sucesso [SWS_Fr_00512].
• FR_NOT_RECEIVED (0x01): A L-PDU não foi recebida [SWS_Fr_00512].
• FR_RECEIVED_MORE_DATA_AVAILABLE (0x02): A L-PDU foi recebida e estão disponíveis outras instâncias desta L-PDU, como ocorre no uso de FIFOs de recepção [SWS_Fr_00512].

Na operação de recepção através de estruturas de buffer, o tipo não apenas distingue a presença de dados recebidos, mas também indica, na operação com FIFO, a existência de outras instâncias [SWS_Fr_00512]. É provável que isso sinalize ao chamador que, após a leitura da instância atual, outros dados podem ser recuperados imediatamente da FIFO [SWS_Fr_00512]. Pergunta Q-0ab7cac72ff7f549 (aberta)

A estrutura Fr_SlotAssignmentType serve para o armazenamento de informações de associação de um frame FlexRay a um ciclo de comunicação e a um ID de slot [SWS_Fr_91002]. Ela está definida no cabeçalho Fr_GeneralTypes.h e reúne todos os parâmetros de endereçamento necessários para a transmissão ou recepção de um frame no canal FlexRay [SWS_Fr_91002].

A estrutura compreende os seguintes elementos [SWS_Fr_91002]:

• Cycle (tipo uint8): Identifica o ciclo no qual o frame FlexRay é transmitido ou recebido [SWS_Fr_91002].
• SlotId (tipo uint16): Designa o ID de slot unívoco do frame dentro do esquema de comunicação FlexRay [SWS_Fr_91002].
• channelId (tipo Fr_ChannelType): Indica o canal FlexRay através do qual ocorre a transmissão ou a recepção [SWS_Fr_91002].

Como Fr_SlotAssignmentType representa uma estrutura de dados pura, ela não possui semântica de execução própria, como sincronicidade ou reentrância, e não dispara por si mesma mensagens de erro DET ou DEM [SWS_Fr_91002]. É provável que a consistência dos valores contidos para ciclo, slot e canal seja de responsabilidade das funções do driver que a utilizam (interpretação). Pergunta Q-77f88375e544e298 (aberta)