Ethernet Driver (Eth)

A função Eth_Init serve para a inicialização do driver Ethernet [SWS_Eth_00027]. Ela é declarada através do arquivo de cabeçalho Eth.h, possui o Service ID 0x01 e não possui valor de retorno (void) [SWS_Eth_00027]. Como parâmetro de entrada, ela espera CfgPtr, que aponta para uma estrutura de configuração específica da implementação do tipo Eth_ConfigType [SWS_Eth_00027]. A chamada ocorre de forma síncrona e é definida como não reentrante (Non Reentrant) [SWS_Eth_00027].

No fluxo operacional, Eth_Init constitui o pré-requisito fundamental para o trabalho com o módulo. Todas as demais funções pressupõem obrigatoriamente uma inicialização prévia do controlador por Eth_Init [SWS_Eth_00070], [SWS_Eth_00167], [SWS_Eth_00185]. Essa dependência é prescrita de forma vinculativa para diversos serviços de controlador do driver [SWS_Eth_00189], [SWS_Eth_00194], [SWS_Eth_00199], [SWS_Eth_00232].

Para o caso de um acesso não inicializado, está previsto um tratamento de erros específico: com a detecção de erros de desenvolvimento (Development Error Detection, DET) ativada, as funções do driver verificam se o serviço Eth_Init foi chamado corretamente com antecedência [SWS_Eth_00066]. Se essa verificação não for bem-sucedida, elas acionam o erro de desenvolvimento ETH_E_UNINIT [SWS_Eth_00164], [SWS_Eth_00182], [SWS_Eth_00187], [SWS_Eth_00196]. Se o DET estiver desativado, por outro lado, as funções afetadas recusam a execução e sinalizam o estado inadmissível retornando o status E_NOT_OK [SWS_Eth_00228], [SWS_Eth_00235], [SWS_Eth_00248], [SWS_Eth_00252].

A função Eth_SetControllerMode serve para ativar (ETH_MODE_ACTIVE) ou desativar (ETH_MODE_DOWN) o controlador Ethernet endereçado por meio do parâmetro CtrlIdx [SWS_Eth_00041]. No AUTOSAR Classic R20-11, este serviço é classificado como obsoleto (obsolete) [SWS_Eth_00041].

A execução do serviço é assíncrona e não reentrante (Non Reentrant) [SWS_Eth_00041]. Como valor de retorno, a função fornece E_OK em caso de inicialização bem-sucedida ou E_NOT_OK caso não tenha sido possível alterar o modo de operação [SWS_Eth_00041]. Interpretação: Como a chamada é especificada como assíncrona, mas nenhum callback é definido no payload, a assunção efetiva do estado deve ser concluída em baixo nível, em segundo plano no driver, após o retorno da função. Pergunta Q-d7ec04578e921eb9 (aberta)

Se o controlador ou a sua comunicação de transmissão e recepção for desativado por meio de Eth_SetControllerMode, aplicam-se limpezas de buffer obrigatórias:

• Todos os buffers de transmissão bloqueados (locked transmit buffers) devem ser liberados [SWS_Eth_00137] [SWS_Eth_00280].
• Todos os buffers de transmissão pendentes (pending transmit buffers) também devem ser liberados [SWS_Eth_00138] [SWS_Eth_00281].

Devido à propriedade Non Reentrant, a função não deve ser executada de forma concorrente para a mesma ou para outras instâncias de controlador [SWS_Eth_00041]. Mensagens de erro específicas do DET ou do DEM não são listadas; estados de erro são informados ao chamador por meio do valor de retorno E_NOT_OK [SWS_Eth_00041].

A função Eth_SetControllerMode (Service-ID 0x03, disponibilizada por meio de Eth.h) serve para ativar e desativar a comunicação de recepção e transmissão (Rx/Tx) de um controlador Ethernet específico [SWS_Eth_91009].

Uso e condições de chamada

A execução da função ocorre de forma assíncrona e é especificada como não reentrante (Non Reentrant) [SWS_Eth_91009]. Na chamada, são passados dois parâmetros:

• CtrlIdx: Índice do respectivo controlador no contexto do driver Ethernet [SWS_Eth_91009].
• CtrlMode: Modo de destino para o controlador, seja ETH_MODE_ACTIVE para ativar a comunicação Rx/Tx ou ETH_MODE_DOWN para desativá-la [SWS_Eth_91009].

Como valor de retorno, a função fornece o status Std_ReturnType: E_OK sinaliza uma execução bem-sucedida, enquanto E_NOT_OK indica que o modo do controlador não pôde ser alterado [SWS_Eth_91009].

Interação e gerenciamento de buffers

Se a comunicação Rx/Tx do controlador indexado for desativada por meio de Eth_SetControllerMode (modo ETH_MODE_DOWN), ações de limpeza devem ser obrigatoriamente realizadas para os buffers de transmissão:

• Todos os buffers de transmissão bloqueados (locked transmit buffers) devem ser liberados [SWS_Eth_00280].
• Todos os buffers de transmissão pendentes (pending transmit buffers) também devem ser liberados [SWS_Eth_00281].

As disposições atuais para a liberação de buffers bloqueados e pendentes, bem como a própria definição da função, possuem o status “draft” [SWS_Eth_91009], [SWS_Eth_00280], [SWS_Eth_00281]. Elas substituem os requisitos historicamente anteriores [SWS_Eth_00137] e [SWS_Eth_00138], que são classificados como obsoletos.

A interface síncrona Eth_UpdatePhysAddrFilter é disponibilizada através do arquivo de cabeçalho Eth.h e possui o Service ID 0x12 [SWS_Eth_00152]. A função serve para adicionar um endereço físico ao filtro de um controlador Ethernet indexado ou para removê-lo deste [SWS_Eth_00152].

Os parâmetros da função compreendem três valores de entrada [SWS_Eth_00152]:

• CtrlIdx: determina o índice do respectivo controlador Ethernet dentro do contexto do driver [SWS_Eth_00152].
• PhysAddrPtr: ponteiro para a área de memória com o endereço físico de destino (endereço MAC) na ordem de bytes da rede; este é o endereço de destino multicast do pacote Ethernet de camada 2 [SWS_Eth_00152].
• Action: especifica, por meio do tipo de enumeração Eth_FilterActionType, se o endereço indicado é adicionado ao filtro do controlador ou excluído dele [SWS_Eth_00152].

A função retorna um status do tipo Std_ReturnType: E_OK confirma a alteração bem-sucedida do filtro, enquanto E_NOT_OK relata que o filtro não pôde ser alterado [SWS_Eth_00152]. Se o controlador Ethernet não for capaz de realizar a filtragem por hardware de forma autônoma, a tarefa de filtragem deve ser implementada por software [SWS_Eth_00152].

Para a execução, aplica-se uma restrição estrita de reentrância: a função não é reentrante para o mesmo índice de controlador (CtrlIdx), mas pode ser chamada de forma concorrente e reentrante para índices de controlador distintos entre si [SWS_Eth_00152].

A função Eth_WriteMii serve para configurar um registrador de um transceptor Ethernet via interface MII ou para acionar uma função disponibilizada pelo transceptor [SWS_Eth_00058]. A declaração está disponível através do cabeçalho Eth.h [SWS_Eth_00058].

Utilização e parâmetros

A chamada é realizada com o Service ID 0x05 e processa quatro parâmetros de entrada [SWS_Eth_00058]:

• CtrlIdx: Índice do controlador Ethernet no contexto do driver Ethernet [SWS_Eth_00058].
• TrcvIdx: índice do transceptor na interface MII [SWS_Eth_00058].
• RegIdx: índice do registrador do transceptor a ser escrito na MII [SWS_Eth_00058].
• RegVal: o valor de 16 bits que deve ser escrito no registrador endereçado [SWS_Eth_00058].

A execução do serviço é especificada como assíncrona [SWS_Eth_00058]. Isso significa que o processo de escrita propriamente dito através da interface de hardware deve ser tipicamente processado em segundo plano, enquanto a função retorna imediatamente após a aceitação da solicitação. Pergunta Q-0f9a9e682985d796 (aberta)

Valores de retorno e restrições

Como valor de retorno, a função fornece o tipo Std_ReturnType [SWS_Eth_00058]:

• E_OK: a solicitação de escrita foi aceita com sucesso [SWS_Eth_00058].
• E_NOT_OK: o serviço foi rejeitado [SWS_Eth_00058].

Em relação à concorrência, Eth_WriteMii é especificada como não reentrante (Non Reentrant) [SWS_Eth_00058]. Portanto, as chamadas não devem ser executadas concorrentemente sem a sincronização correspondente por parte de quem chama.

Utilização e parâmetros

A função Eth_ReadMii (Service-ID 0x06) serve para ler um registrador de transceiver por meio da interface MII e é disponibilizada pelo arquivo de cabeçalho Eth.h [SWS_Eth_00064]. Na chamada, CtrlIdx identifica o respectivo controlador Ethernet no contexto do driver, TrcvIdx o transceiver acessado na MII e RegIdx o registrador concreto do transceiver [SWS_Eth_00064]. O valor do registrador obtido é gravado na área de memória para a qual o ponteiro RegValPtr aponta [SWS_Eth_00064].

Execução e concorrência

A execução ocorre de forma assíncrona (Asynchronous) [SWS_Eth_00064]. Um valor de retorno de E_OK apenas confirma que o serviço ou a solicitação de leitura foi aceita com sucesso (Service accepted), enquanto E_NOT_OK sinaliza uma rejeição da solicitação (Service denied) [SWS_Eth_00064]. Devido ao caráter assíncrono, a área de memória passada para RegValPtr provavelmente deve permanecer válida até a conclusão definitiva do processo de leitura. Pergunta Q-04a94624b96bf51f (aberta) Como a função também é classificada como não reentrante (Non Reentrant) [SWS_Eth_00064], os chamadores não devem realizar acessos simultâneos por meio de diferentes tarefas ou contextos de interrupção sem sincronização externa.

Tratamento de erros

Se o driver não puder aceitar a solicitação de leitura, a chamada é confirmada diretamente com E_NOT_OK [SWS_Eth_00064]. Códigos de erro específicos, verificações de tempo de execução do DET ou eventos de diagnóstico do DEM não são indicados para esta função nos dados de especificação relacionados ao elemento.

A função síncrona Eth_EnableEgressTimeStamp ativa o registro de carimbos de data/hora de transmissão (Egress Time Stamping) para um objeto de mensagem dedicado do driver Ethernet [SWS_Eth_00186]. A chamada ocorre através do cabeçalho Eth.h com o Service ID 0x17 e não fornece valor de retorno [SWS_Eth_00186].

Na chamada, devem ser passados os seguintes parâmetros de entrada [SWS_Eth_00186]:

• CtrlIdx: índice do controlador Ethernet endereçado [SWS_Eth_00186].
• BufIdx: índice do buffer de mensagens para o qual a aplicação de nível superior espera a geração de um carimbo de data/hora de egress [SWS_Eth_00186].

Em relação à concorrência, a função é especificada como não reentrante (Non Reentrant) [SWS_Eth_00186]. Uma chamada paralela para o mesmo buffer ou para buffers adicionais deve, portanto, ser sincronizada ou evitada por quem chama.

O comportamento do hardware varia conforme a implementação do controlador: alguns hardwares salvam a marcação para o carimbo de data/hora de transmissão de forma permanente, enquanto outros controladores exigem obrigatoriamente a ativação antes de cada transmissão [SWS_Eth_00186]. Interpretação: para um acionamento independente de hardware, deve ser recomendável, portanto, chamar a função antes de cada processo de envio do buffer desejado. Pergunta Q-c2b8d2db03e9d13b (aberta) Não existe uma interface de desativação, pois o tipo de mensagem é sempre transmitido com carimbo de data/hora de acordo com o design de rede [SWS_Eth_00186].

usar

A função síncrona Eth_ProvideTxBuffer concede acesso a um buffer de transmissão Ethernet da FIFO atribuído à prioridade fornecida [SWS_Eth_00077]. Ela é disponibilizada através do cabeçalho Eth.h e é especificada como reentrante [SWS_Eth_00077]. Através dos parâmetros de entrada, são passados o índice do controlador CtrlIdx bem como a prioridade do quadro Priority para seleção da FIFO [SWS_Eth_00077]. O parâmetro in-out LenBytePtr passa o tamanho de buffer desejado e retorna, após a chamada, o tamanho em bytes efetivamente concedido [SWS_Eth_00077]. Os parâmetros de saída BufIdxPtr (índice de recurso para solicitações posteriores) e BufPtr (ponteiro para o buffer) disponibilizam as referências para a área de memória [SWS_Eth_00077].

Tratamento de erros e valores de retorno

A função sinaliza o resultado por meio de valores de retorno do tipo BufReq_ReturnType [SWS_Eth_00077]:

• BUFREQ_OK: o buffer de transmissão foi disponibilizado com sucesso [SWS_Eth_00077].
• BUFREQ_E_BUSY: todos os recursos de buffer estão ocupados no momento [SWS_Eth_00077].
• BUFREQ_E_OVFL: o buffer solicitado é grande demais [SWS_Eth_00077].
• BUFREQ_E_NOT_OK: um erro de desenvolvimento foi detectado [SWS_Eth_00077].

Interação

Se EthCtrlConfigSwBufferHandling estiver configurado como TRUE, uma tupla composta pelo índice de buffer do pool de buffers de software passado para BufIdxPtr e pela prioridade indicada Priority é armazenada internamente [SWS_Eth_00267].

Se Eth_Transmit() for chamada em seguida, o índice de buffer fornecido é atribuído à FIFO de software cuja configuração EthCtrlConfigEgressFifoPriorityAssignment corresponda à prioridade previamente passada em Eth_ProvideTxBuffer() [SWS_Eth_00268].

Utilização e contexto de chamada

A interface síncrona Eth_Transmit aciona o processo de envio para um buffer de transmissão Ethernet previamente disponibilizado e preenchido [SWS_Eth_00087]. Ela recebe os seguintes parâmetros:

• CtrlIdx: índice do controlador Ethernet no contexto do driver [SWS_Eth_00087].
• BufIdx: índice do recurso de buffer a ser transmitido [SWS_Eth_00087].
• FrameType: tipo específico de quadro Ethernet [SWS_Eth_00087].
• TxConfirmation: chave para ativação da confirmação de transmissão [SWS_Eth_00087].
• LenByte: comprimento dos dados da carga útil em bytes [SWS_Eth_00087].
• PhysAddrPtr: ponteiro para o endereço físico de destino (endereço MAC) na ordem de bytes da rede [SWS_Eth_00087].

O valor de retorno do tipo Std_ReturnType sinaliza com E_OK o início bem-sucedido da transmissão e com E_NOT_OK uma falha [SWS_Eth_00087].

Interação e processamento de buffer

No âmbito do fluxo de transmissão, Eth_Transmit atribui o ponteiro de buffer BufIdx à FIFO de software cujo elemento de configuração EthCtrlConfigEgressFifoPriorityAssignment coincide com a prioridade previamente definida em Eth_ProvideTxBuffer() [SWS_Eth_00268]. Com a chamada, as mensagens correspondentes são transferidas das FIFOs de software para a FIFO de hardware [SWS_Eth_00269].

simultaneidade

A função é reentrante para chamadas com índices de buffer diferentes (BufIdx), bem como diferentes índices de controlador (CtrlIdx) [SWS_Eth_00087].

A função síncrona Eth_Receive serve para a recepção de um quadro Ethernet a partir de um buffer FIFO específico de um controlador Ethernet [SWS_Eth_00095]. Ela não possui valor de retorno, mas retorna o resultado da consulta a quem chamou através do ponteiro RxStatusPtr do tipo Eth_RxStatusType [SWS_Eth_00095]. Esse parâmetro de saída indica se um quadro foi recebido com sucesso e se ainda há outros quadros prontos para serem buscados para o respectivo buffer FIFO [SWS_Eth_00095].

Parâmetros e contexto de chamada

Como parâmetros de entrada, a função requer o índice do controlador CtrlIdx dentro do driver Ethernet, bem como o índice FifoIdx da FIFO a ser lida [SWS_Eth_00095]. A função é declarada no arquivo de cabeçalho Eth.h [SWS_Eth_00095]. A chamada deve ocorrer tipicamente de forma periódica no âmbito de um mecanismo de polling por camadas superiores de driver ou interface. Pergunta Q-f5ec0693a5887bcf (aberta)

Simultaneidade e restrições

Em relação à concorrência, Eth_Receive é implementada como reentrante para FIFOs diferentes, mas não reentrante para a mesma FIFO [SWS_Eth_00095]. Chamadas simultâneas que consultem a mesma FIFO do mesmo controlador são inadmissíveis e devem ser excluídas pelo software chamador.

Interação com a interface Ethernet

No modo polling, o driver Ethernet é obrigado, em um processo de recepção bem-sucedido, a chamar a função EthIf_RxIndication diretamente a partir da rotina Eth_Receive para notificar o quadro recebido à camada superior para processamento posterior [SWS_Eth_00244].

Utilização e contexto de chamada

A função Eth_TxConfirmation, disponível por meio do cabeçalho Eth.h, serve para disparar intencionalmente a confirmação de transmissão para quadros Ethernet enviados [SWS_Eth_00100]. Ela possui o Service-ID 0x0C e é executada de forma síncrona [SWS_Eth_00100]. Como único parâmetro de passagem, a função espera CtrlIdx, que determina o índice lógico do controlador a ser acessado dentro da instância do driver Ethernet [SWS_Eth_00100]. Não existe valor de retorno (void) e nenhum parâmetro de saída é passado [SWS_Eth_00100].

Interação no fluxo de transmissão

Na interação entre as camadas, Eth_TxConfirmation assume o repasse do status de envio para a interface Ethernet de nível superior. Desde que a notificação correspondente tenha sido ativada, o driver Ethernet é obrigado a chamar EthIf_TxConfirmation com o valor de resultado E_OK para sinalizar uma transmissão bem-sucedida [SWS_Eth_00243]. No modo de polling, essa chamada ocorre explicitamente de dentro do contexto da rotina Eth_TxConfirmation, enquanto no modo controlado por interrupções ela é disparada, alternativamente, direto da rotina de interrupção [SWS_Eth_00243].

Concorrência e condições de execução

Para a execução, aplica-se a restrição de que Eth_TxConfirmation é definida como não reentrante (Non Reentrant) [SWS_Eth_00100]. Chamadas simultâneas para o mesmo controlador devem, portanto, ser evitadas pelo chamador. A chamada normalmente deve ocorrer ciclicamente na operação de polling por meio de um controle de fluxo de nível superior. Pergunta Q-c19295838459b689 (aberta) Códigos de erro específicos, bem como requisitos para mensagens DET ou DEM, não são indicados na especificação da função, razão pela qual um tratamento de erros em separado é dispensado.

Utilização e contexto de chamada

A função Eth_MainFunction possui a assinatura void Eth_MainFunction(void) e é disponibilizada por meio do arquivo de cabeçalho SchM_Eth.h [SWS_Eth_00171]. Disso pode-se interpretar: A chamada provavelmente deve ocorrer ciclicamente pelo Schedule Manager (SchM) em um contexto baseado em tarefas, uma vez que não há parâmetros de passagem nem valores de retorno definidos. Pergunta Q-690a2dc372d49c6a (aberta)

Escopo de funções e polling

A tarefa principal da função consiste no polling de alterações de estado, bem como na verificação de erros de controlador e quadros Ethernet perdidos [SWS_Eth_00171]. Se a função constatar que o modo do controlador Ethernet foi alterado, ela chama a função EthIf_CtrlModeIndication para informar a camada superior sobre a mudança de estado [SWS_Eth_00171].

Ordem de processamento no caminho de transmissão

No contexto de Eth_MainFunction(), uma ordem fixa é predefinida para o processamento de FIFOs de software [SWS_Eth_00270]:

• Primeiro, todos os FIFOs de SW são iterados e suas contas de créditos (Credits Account) são atualizadas [SWS_Eth_00270].
• Em seguida, todos os FIFOs de SW são iterados novamente e verificados quanto a mensagens prontas para envio [SWS_Eth_00270].
• Para cada FIFO de SW iterado, a transmissão é então realizada [SWS_Eth_00270].

O tipo de enumeração genérico Eth_ModeType serve, nas camadas da pilha de comunicação Ethernet (como EthIf, Eth, EthSwt e EthTrcv), para ativar ou desativar o canal de comunicação Ethernet, bem como para colocar o respectivo hardware (como controlador Ethernet, porta de switch Ethernet ou transceptor Ethernet) em um estado de repouso com economia de energia ou modo ativo [SWS_Eth_00158].

O tipo está disponível por meio do arquivo de cabeçalho Eth_GeneralTypes.h e define as seguintes faixas de valores [SWS_Eth_00158]:

• ETH_MODE_DOWN (0x00): desativa o canal de comunicação Ethernet e coloca o hardware correspondente em um modo de repouso com economia de energia (Low-Power Sleep Mode) [SWS_Eth_00158].
• ETH_MODE_ACTIVE (0x01): ativa o canal de comunicação Ethernet e coloca o hardware no modo de operação (Power-On Mode) [SWS_Eth_00158].

Em relação ao ciclo de vida e ao uso, deve-se observar que Eth_ModeType está marcado com o status obsolete no release R20-11 [SWS_Eth_00158]. Em novos desenvolvimentos, o uso deste tipo deve, portanto, ser evitado, uma vez que tipos de interface obsoletos são tipicamente substituídos por estruturas de controle mais modernas em padrões futuros.

O tipo enumerado Eth_ModeType é declarado via Eth_GeneralTypes.h e serve como tipo de modo intercamadas na pilha de comunicação Ethernet do AUTOSAR ([SWS_Eth_91008]). Ele é utilizado em módulos como EthIf, Eth, EthSwt e EthTrcv para ativar ou desativar canais de comunicação de forma direcionada e alternar o componente de hardware correspondente (controlador Ethernet, portas de switch ou transceptores) entre um modo de suspensão de economia de energia e o modo de operação ativo ([SWS_Eth_91008]).

O tipo compreende três estados para controle de modo ([SWS_Eth_91008]):

• ETH_MODE_DOWN (0x00): desativa a comunicação Rx e Tx e coloca o hardware correspondente em um modo de suspensão de baixo consumo de energia (Low-Power Sleep). Caso o hardware ofereça suporte a isso, um processo de suspensão também é iniciado (por exemplo, a solicitação de Sleep na linha de dados de acordo com OPEN Alliance TC10).
• ETH_MODE_ACTIVE (0x01): ativa a comunicação Rx e Tx e comuta o hardware correspondente para o modo de operação regular (Power-on).
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST (0x02): ativa a comunicação Rx e Tx, coloca o hardware no modo de operação e dispara adicionalmente uma solicitação de despertar na rede, caso o hardware disponha de recursos de despertar (como Wake-up na linha de dados conforme OPEN Alliance TC10).

Na interação da pilha, Eth_ModeType oferece suporte em particular ao repasse de solicitações de despertar a partir da camada de serviços (ComM) através das camadas intermediárias até os drivers de comunicação (EthTrcv), controlando de forma orientada à demanda o hardware com funcionalidade de Wake-up e Sleep na linha de dados ([SWS_Eth_91008]).

O tipo enumerado Eth_StateType é disponibilizado por meio do cabeçalho Eth_GeneralTypes.h e serve, de acordo com [SWS_Eth_00159], para o monitoramento de estado do driver Ethernet. Sua finalidade consiste em apoiar a detecção de erros de desenvolvimento (Development Error Detection), sendo que o estado atual deve estar disponível para fins de depuração (debugging), segundo a especificação ([SWS_Eth_00159]).

Para o gerenciamento de estados, Eth_StateType define dois valores discretos de enumeração ([SWS_Eth_00159]):

• ETH_STATE_UNINIT (valor 0x00): Indica que o driver Ethernet ainda não está configurado ([SWS_Eth_00159]).
• ETH_STATE_INIT (valor 0x01): Indica que o driver Ethernet está configurado com sucesso ([SWS_Eth_00159]).

Em relação ao tratamento de erros e à interação, este tipo de estado forma a base para a detecção interna de erros. Deve-se presumir que as APIs do driver consultem esse estado e rejeitem chamadas enquanto o driver estiver no estado não inicializado ETH_STATE_UNINIT ([SWS_Eth_00159]). Pergunta Q-35a17e3267274d70 (aberta) Somente quando o driver tiver transitado para o estado ETH_STATE_INIT é que ele é considerado configurado e operacional ([SWS_Eth_00159]). Como a definição de tipo está em Eth_GeneralTypes.h, ela se encontra disponível de forma abrangente para os drivers ([SWS_Eth_00159]).

Utilização e gama de valores

O tipo de enumeração Eth_RxStatusType é definido em conformidade com [SWS_Eth_00162] no arquivo de cabeçalho Eth_GeneralTypes.h. Ele serve como parâmetro de saída (out parameter) na função Eth_Receive(), através do qual o driver Ethernet informa se um quadro Ethernet foi recebido e se subsequentemente há mais quadros no buffer ou se dados foram perdidos [SWS_Eth_00162].

A especificação define para este tipo três valores de enumeração discretos [SWS_Eth_00162]:

• ETH_RECEIVED (0x00): um quadro Ethernet foi recebido; não há mais outros quadros disponíveis no controlador.
• ETH_NOT_RECEIVED (0x01): nenhum quadro Ethernet foi recebido; não há outros quadros presentes.
• ETH_RECEIVED_MORE_DATA_AVAILABLE (0x02): um quadro Ethernet foi recebido e há quadros adicionais prontos para serem buscados.

Interação no processamento de quadros

Ao chamar Eth_Receive(), a camada chamadora passa um ponteiro para uma variável do tipo Eth_RxStatusType. A avaliação desse parâmetro de saída controla o fluxo posterior do ciclo de recepção: o valor de retorno ETH_RECEIVED_MORE_DATA_AVAILABLE deve servir a quem chamou como critério para chamar Eth_Receive() novamente de imediato, a fim de processar rapidamente os quadros restantes do buffer de recepção [SWS_Eth_00162]. Pergunta Q-4ed309522aa004f8 (aberta) Os estados ETH_RECEIVED e ETH_NOT_RECEIVED sinalizam, por outro lado, que o buffer está esgotado e que não há mais dados pendentes para processamento. A disponibilização via Eth_GeneralTypes.h assegura, com isso, um uso uniforme de tipos entre os módulos [SWS_Eth_00162].

Uso e finalidade

O tipo de dados Eth_TxErrorCounterValuesType está especificado, de acordo com [SWS_Eth_91004], como uma estrutura para contadores estatísticos para fins de diagnóstico no driver Ethernet. A definição está disponível por meio do arquivo de cabeçalho Eth_GeneralTypes.h. A estrutura agrupa múltiplos contadores de 32 bits (uint32) que mapeiam estados de transmissão específicos e impedimentos de envio no nível da interface.

Componentes da estrutura e semântica

Os contadores individuais orientam-se, de acordo com [SWS_Eth_91004], por definições padronizadas de MIB de rede:

• Tx Dropped No Error Pkts: quantidade de pacotes de saída descartados apesar de estarem livres de erros, por exemplo, para liberar memória de buffer (RFC1213 ifOutDiscards).
• Tx Dropped Error Pkts: quantidade de pacotes que não puderam ser transmitidos devido a erros ocorridos (RFC1213 ifOutErrors).
• Tx Deferred Trans: quantidade de frames cuja primeira tentativa de transmissão foi atrasada porque o meio de transmissão estava ocupado (RFC1643 dot3StatsDeferredTransmissions).
• Tx Single Collision e Tx Multiple Collision: frames transmitidos com sucesso cujo envio foi atrasado por exatamente uma ou por múltiplas colisões (RFC1643).
• Tx Late Collision: colisões detectadas após mais de 512 tempos de bit do início da transmissão do pacote (RFC1643 dot3StatsLateCollisions).
• Tx Excessive Collison: quantidade de transmissões que falharam definitivamente em decorrência de colisões excessivas (RFC1643 dot3StatsExcessiveCollisions).

Contexto de chamada e restrições

Interpretação: Como o excerto da especificação não lista nenhuma função de API associada, este tipo de diagnóstico provavelmente deverá ser passado como parâmetro de saída por ponteiro para as respectivas funções de driver para consulta de contadores. Pergunta Q-2bfbe59d1fb81938 (aberta) Requisitos específicos para tratamento de erros, notificações DET ou concorrência não estão definidos nas fontes para esta estrutura de dados pura.