Ethernet Interface (EthIf)

Utilização e semântica

A função EthIf_Init inicializa o módulo de interface Ethernet ([SWS_EthIf_00024]). Ela é executada sincronicamente, não é reentrante (Non Reentrant) e está disponível por meio do arquivo de cabeçalho EthIf.h com o service ID 0x01. Como único parâmetro de passagem, a função espera o ponteiro CfgPtr, que referencia uma estrutura de configuração específica da implementação do tipo EthIf_ConfigType. Não existem parâmetros inout nem out, e a função não possui valor de retorno ([SWS_EthIf_00024]).

Simultaneidade e contexto de chamada

Como EthIf_Init não é reentrante, nenhuma chamada concorrente ou aninhada pode ocorrer [SWS_EthIf_00024]. Como o contexto de chamada específico não é detalhado no payload, é provável que a chamada ocorra tipicamente uma única vez durante a sequência de inicialização da ECU, antes da utilização de outros serviços Ethernet. Pergunta Q-07e92f9f3c15ea5b (aberta)

Condições de sequenciamento e interação

A chamada de EthIf_Init constitui o pré-requisito mandatório para o uso de todas as outras funções do módulo. Se a detecção de erros de desenvolvimento (Development Error Detection) estiver ativada, vários serviços da interface Ethernet verificam, antes de sua execução, se EthIf_Init foi chamado anteriormente:

• Se a inicialização não tiver sido realizada, as funções dependentes reportam o erro de desenvolvimento ETHIF_E_UNINIT (por exemplo, [SWS_EthIf_00155], [SWS_EthIf_00161], [SWS_EthIf_00167], [SWS_EthIf_00173], [SWS_EthIf_00193], [SWS_EthIf_00199], [SWS_EthIf_00217], [SWS_EthIf_00222], [SWS_EthIf_00299], [SWS_EthIf_00302] e [SWS_EthIf_00304]).
• Várias interfaces abortam a execução caso a inicialização não tenha ocorrido e retornam adicionalmente o valor de erro E_NOT_OK (como [SWS_EthIf_00246], [SWS_EthIf_00273] bem como [SWS_EthIf_00277]).

usar

A função EthIf_SetControllerMode ativa ou desativa o controlador Ethernet especificado por meio de CtrlIdx no contexto da interface Ethernet [SWS_EthIf_00034]. Por meio do parâmetro CtrlMode, são solicitados os seguintes estados [SWS_EthIf_00034]:

• ETH_MODE_DOWN: Desativa o controlador.
• ETH_MODE_ACTIVE: ativa o controlador.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: ativa o controlador e solicita um wake-up na rede.

A função opera de forma assíncrona [SWS_EthIf_00034]. Ela retorna E_OK em caso de execução bem-sucedida ou E_NOT_OK se o modo do controlador não puder ser alterado [SWS_EthIf_00034].

Interação e encaminhamento

Se EthIf_SetControllerMode for chamada com ETH_MODE_ACTIVE para um controlador que referencia uma EthIfSwitchPortGroup do tipo «control», EthIf encaminha a chamada para todas as portas do grupo, desde que este modo seja solicitado pela primeira vez para a porta e seu status seja ETH_MODE_DOWN. Nesse processo, são executados consecutivamente EthSwt_SetSwitchPortMode com ETH_MODE_ACTIVE e EthSwt_PortLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE [SWS_EthIf_00264].

Na solicitação de ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, EthIf encaminha as chamadas independentemente do modo atual da seguinte forma:

• Em caso de referência a um EthIfTransceiver: chamada de EthTrcv_SetTransceiverMode com ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST e, em seguida, EthTrcv_TransceiverLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE, caso o status atual seja ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00479].
• Em caso de referência a um EthIfSwitch ou a uma EthIfSwitchPortGroup do tipo «control»: chamada de EthSwt_SetSwitchPortMode com ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST e, em seguida, EthSwt_PortLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE, caso o estado atual seja ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00480], [SWS_EthIf_00481].

Restrições

A função não é reentrante (Non Reentrant) e está disponível por meio de EthIf.h [SWS_EthIf_00034].

A função síncrona e não reentrante EthIf_SetTransceiverWakeupMode (Service-ID 0x2e) serve para definir o modo de wake-up de um transceiver endereçado via TrcvIdx no Ethernet Interface ou para redefinir a sua razão de wake-up [SWS_EthIf_00233]. A função está declarada no arquivo de cabeçalho EthIf.h e marcada como obsoleta (obsolete) no release AUTOSAR CP R20-11 [SWS_EthIf_00233].

O controle ocorre por meio do parâmetro de passagem TrcvWakeupMode [SWS_EthIf_00233]:

• ETHTRCV_WUM_ENABLE: Ativa o despertar do transceiver [SWS_EthIf_00233]. Se o driver atribuído EthIfTransceiverIdx estiver atualmente no estado ETHTRCV_WUM_DISABLE, a chamada é encaminhada para EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE: Desativa o despertar do transceiver [SWS_EthIf_00233]. Se o estado atual do driver for ETHTRCV_WUM_ENABLE, a função encaminha a chamada para EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR: Limpa a razão de wake-up do transceiver indexado [SWS_EthIf_00233].

Como valor de retorno, a chamada fornece E_OK em caso de execução bem-sucedida ou E_NOT_OK se o modo de wake-up não pôde ser alterado ou se a razão de wake-up não pôde ser limpa [SWS_EthIf_00233]. Como a interface é definida como não reentrante, chamadas concorrentes são inadmissíveis [SWS_EthIf_00233].

A função EthIf_CheckWakeup solicita ao hardware Ethernet afetado que verifique um wake-up sinalizado [SWS_EthIf_00244]. Isto é utilizado, por exemplo, para hardware Ethernet compatível com a especificação OPEN Alliance TC10 [SWS_EthIf_00244]. A chamada é realizada de forma assíncrona e reentrante pelo código de integração, opcionalmente no contexto de uma interrupção ou ao nível de tarefa [SWS_EthIf_00244].

Como parâmetro de entrada serve WakeupSource do tipo EcuM_WakeupSourceType, que designa o dispositivo de origem disparador (transceptor Ethernet ou switch Ethernet) [SWS_EthIf_00244]. O valor de retorno é E_OK se a solicitação de verificação ao hardware foi aceita; caso contrário, E_NOT_OK em caso de rejeição da solicitação [SWS_EthIf_00244]. O módulo encaminha a chamada internamente aos drivers subordinados:

• Para todos os transceptores Ethernet afetados (referenciados através de EthIfTransceiver ou EthIfSwitchPortGroups), EthTrcv_CheckWakeup do respectivo driver de transceptor é chamado [SWS_EthIf_00245].
• Para todos os switches Ethernet afetados (referenciados através de EthIfSwitch), EthSwt_SwitchCheckWakeup do respectivo driver de switch é chamado [SWS_EthIf_00500].

A disponibilidade de EthIf_CheckWakeup pode ser ativada e desativada em tempo de pré-compilação através do parâmetro de configuração EthIfWakeUpSupport [SWS_EthIf_00248]. A API é disponibilizada através do header EthIf.h [SWS_EthIf_00244].

A função síncrona EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) serve para atualizar o filtro de endereço para o controlador Ethernet especificado por meio de CtrlIdx. Através do parâmetro Action (do tipo Eth_FilterActionType), um endereço físico é adicionado ao filtro ou dele removido.

Para a configuração, PhysAddrPtr espera um ponteiro para o endereço MAC físico na ordem de bytes da rede, o qual representa o endereço de destino multicast do pacote Ethernet de Camada 2 [SWS_EthIf_00139]. Embora a descrição textual da função mencione um endereço de origem, provavelmente trata-se de um descuido editorial, visto que a especificação de parâmetros define de forma vinculativa o endereço de destino multicast. Pergunta Q-312e20e5eadda94a (aberta)

Em relação ao fluxo e às restrições, aplicam-se as seguintes determinações [SWS_EthIf_00139]:

• Valores de retorno: A função fornece E_OK se a configuração do filtro foi alterada com sucesso, ou E_NOT_OK caso a alteração tenha falhado. Códigos de erro DET ou DEM específicos não estão definidos nas fontes.
• Suporte de hardware: Caso o controlador Ethernet subjacente não seja capaz, por hardware, de realizar a filtragem, o software deve assumir essa tarefa de filtragem.
• Simultaneidade: A chamada não é reentrante para o mesmo índice de controlador (CtrlIdx), mas pode ser executada concorrentemente para controladores diferentes.

Utilização e contexto de chamada

A função EthIf_StoreConfiguration serve para solicitar o armazenamento persistente das tabelas de MAC/portas aprendidas de um switch Ethernet [SWS_EthIf_00214]. Como chamador típico, cita-se, por exemplo, um Complex Device Driver (CDD) [SWS_EthIf_00214]. A interface é acessível através do arquivo de cabeçalho EthIf.h e possui o Service-ID 0x2c [SWS_EthIf_00214].

Por meio do parâmetro de entrada SwitchIdx, é passado o índice do switch de destino no contexto do driver de switch Ethernet [SWS_EthIf_00214]. Como valor de retorno, a função fornece o status Std_ReturnType: O valor E_OK indica que a solicitação de armazenamento foi aceita, enquanto E_NOT_OK sinaliza a não aceitação [SWS_EthIf_00214]. Como a especificação caracteriza a execução como síncrona/assíncrona, o recebimento da solicitação deve ocorrer de forma síncrona, enquanto a persistência propriamente dita é presumivelmente processada de forma assíncrona em módulos downstream. Pergunta Q-4f10e936c7d30258 (aberta)

Restrições e tratamento de erros

Em termos de simultaneidade, EthIf_StoreConfiguration é especificada como não reentrante (Non Reentrant) [SWS_EthIf_00214]. Chamadas paralelas devem, portanto, ser evitadas ou sincronizadas pelo chamador. Mensagens de erro específicas de DET ou DEM não estão definidas para esta interface; um erro na aceitação da solicitação é reportado exclusivamente pelo valor de retorno E_NOT_OK [SWS_EthIf_00214].

Utilização e contexto de chamada

A função EthIf_ResetConfiguration serve para solicitar a redefinição persistente das tabelas de MAC e de portas aprendidas dinamicamente de um switch Ethernet [SWS_EthIf_00219]. Entradas configuradas estaticamente permanecem inalteradas na configuração [SWS_EthIf_00219]. Como chamador dessa interface pode atuar, por exemplo, um Complex Device Driver (CDD) [SWS_EthIf_00219].

Por meio do parâmetro de transferência SwitchIdx, especifica-se o índice do switch afetado no contexto do driver de switch Ethernet [SWS_EthIf_00219]. Em relação à semântica de execução, a operação é indicada como síncrona/assíncrona [SWS_EthIf_00219]; isso provavelmente significa que o recebimento da solicitação é confirmado de forma síncrona, enquanto a redefinição das tabelas de hardware ocorre de forma assíncrona. Pergunta Q-9e7f89ec9e809fd0 (aberta)

Valores de retorno e tratamento de erros

Como valor de retorno a função fornece um status do tipo Std_ReturnType [SWS_EthIf_00219]:

• E_OK: A solicitação para a redefinição persistente da tabela de MAC/portas foi aceita com sucesso [SWS_EthIf_00219].
• E_NOT_OK: A solicitação foi rejeitada [SWS_EthIf_00219].

Mensagens de erro específicas de DET ou DEM não estão documentadas no escopo de especificação presente para esta função.

Simultaneidade e restrições

A interface é especificada como não reentrante (Non Reentrant) [SWS_EthIf_00219]. Os chamadores devem, portanto, assegurar que não ocorram chamadas simultâneas ou interruptivas. A função está incluída através do arquivo de cabeçalho EthIf.h [SWS_EthIf_00219].

A função síncrona EthIf_EnableEgressTimeStamp serve para a ativação da captura de carimbos de data/hora de saída (Egress Time Stamping) para um objeto de mensagem dedicado ou buffer de transmissão [SWS_EthIf_00160]. A interface é fornecida através do arquivo de cabeçalho EthIf.h [SWS_EthIf_00160].

Parâmetros e chamada

Ao ser chamada, a função espera a passagem de dois parâmetros de entrada [SWS_EthIf_00160]:

• CtrlIdx: índice do controlador Ethernet endereçado [SWS_EthIf_00160].
• BufIdx: Índice do buffer de mensagens no qual a aplicação espera a captura do carimbo de data/hora de transmissão [SWS_EthIf_00160].

A função não possui valor de retorno (void), nem parâmetros de entrada ou saída [SWS_EthIf_00160].

Comportamento de hardware e concorrência

O comportamento do hardware difere dependendo do controlador: alguns tipos de hardware armazenam a marcação para o carimbo de data/hora de transmissão permanentemente após uma configuração única, enquanto outros controladores a exigem obrigatoriamente antes de cada transmissão individual [SWS_EthIf_00160]. Interpretação: Em controladores sem armazenamento permanente, a função provavelmente terá que ser chamada novamente pela aplicação antes de cada processo de envio. Pergunta Q-e87b424598f8a684 (aberta) Não existe a possibilidade de desativação segundo a especificação, uma vez que o tipo de mensagem correspondente recebe carimbos de data/hora permanentemente de acordo com o projeto de rede [SWS_EthIf_00160].

Em relação à concorrência, a função é definida como não reentrante (Non Reentrant) [SWS_EthIf_00160].

A função assíncrona EthIf_SwitchPortGroupRequestMode solicita um modo de operação para um grupo de portas de switch ([SWS_EthIf_91102]). A chamada é especificada como não reentrante e passa o índice do grupo de portas (PortGroupIdx), bem como o modo de destino desejado (PortMode). Como modos, estão disponíveis ETH_MODE_DOWN para desativação, ETH_MODE_ACTIVE para ativação e ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST para ativação com wake-up de rede ([SWS_EthIf_91102]). Em caso de inicialização bem-sucedida, a função retorna E_OK; caso contrário, E_NOT_OK ([SWS_EthIf_91102]).

Por princípio, EthIf encaminha a solicitação para o switch subjacente, chamando EthSwt_SetSwitchPortMode para todas as portas referenciadas ([SWS_EthIf_91102]). Aplicam-se regras de comportamento específicas para os diferentes modos:

• Desativação (ETH_MODE_DOWN): Se as portas estiverem atualmente no estado ETH_MODE_ACTIVE e ETH_MODE_DOWN tiver sido solicitado para todos os grupos que referenciam as portas, EthIf inicia um temporizador com o tempo de atraso EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Ativação (ETH_MODE_ACTIVE ou ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): Um temporizador de atraso de desligamento em execução para as portas do respectivo grupo de portas é cancelado imediatamente ([SWS_EthIf_00483]).
• Solicitação de wake-up (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): A chamada é obrigatoriamente encaminhada em uma sequência fixa para todas as portas do grupo, independentemente do modo atual da porta: primeiro EthSwt_SetSwitchPortMode é chamado com ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, seguido por EthSwt_PortLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE, desde que o estado atual do link seja ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00482]).

Mensagens de erro específicas de DET ou DEM não estão listadas para este serviço; a falha de uma alteração de modo é indicada diretamente através do valor de retorno E_NOT_OK ([SWS_EthIf_91102]).

A função EthIf_StartAllPorts serve para a solicitação de colocar todas as portas de switch Ethernet configuradas e afetadas no estado ETH_MODE_ACTIVE ([SWS_EthIf_91103]). A chamada é realizada sem parâmetros, possui semântica assíncrona e é especificada como reentrante ([SWS_EthIf_91103]). Como valor de retorno, E_OK sinaliza a aceitação da solicitação, enquanto E_NOT_OK indica uma rejeição ([SWS_EthIf_91103]).

Após a chamada de EthIf_StartAllPorts, EthIf encaminha os comandos de controle para todas as portas afetadas dos switches Ethernet (EthSwtPorts) em uma sequência estritamente definida ([SWS_EthIf_00275]):

• Primeiro, EthSwt_SetSwitchPortMode é chamado com ETH_MODE_ACTIVE, desde que o modo atual seja ETH_MODE_DOWN ([SWS_EthIf_00275]).
• Depois ocorre a chamada de EthSwt_PortLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE, caso o estado atual do link seja ETHTRCV_LINK_STATE_DOWN, e um temporizador com o intervalo de tempo EthIfPortStartupActiveTime é iniciado para todas essas portas ([SWS_EthIf_00275]).

Se uma porta ativada dessa forma não for solicitada regularmente com ETH_MODE_ACTIVE dentro do intervalo de tempo EthIfPortStartupActiveTime, EthIf desativa essa porta novamente de forma automática ([SWS_EthIf_00276]). A desativação ocorre obrigatoriamente em ordem inversa:

• Primeiro, EthSwt_PortLinkStateRequest é chamado com ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00276]).
• Em seguida, EthSwt_SetSwitchPortMode é chamado com ETH_MODE_DOWN ([SWS_EthIf_00276]).

A função EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) ativa a captura de registros de data e hora de saída (egress timestamps) para um objeto de mensagem específico no nível do switch. O objeto de transmissão correspondente é endereçado por meio do índice do controlador CtrlIdx e do índice do buffer BufIdx.

Chamada e parâmetros

A chamada ocorre de forma síncrona ([SWS_EthIf_91007]). Como parâmetros de entrada, a função espera o índice do controlador CtrlIdx dentro do contexto de EthIf, bem como BufIdx para o buffer de mensagens no qual a aplicação espera a marcação de data e hora. Por meio do parâmetro de saída MgmtInfo do tipo EthSwt_MgmtInfoType*, são disponibilizadas informações de gerenciamento associadas ([SWS_EthIf_91007]).

Valores de retorno e comportamento

A função sinaliza o resultado por meio de um valor de retorno do tipo Std_ReturnType ([SWS_EthIf_91007]):

• E_OK: O egress time stamping foi ativado com sucesso ([SWS_EthIf_91007]).
• E_NOT_OK: A ativação da marcação de data e hora falhou ([SWS_EthIf_91007]).

Restrições e concorrência

A interface é especificada como não reentrante (Non Reentrant) ([SWS_EthIf_91007]). Os chamadores devem, portanto, assegurar que chamadas paralelas sejam impedidas. A declaração é disponibilizada por meio do cabeçalho EthIf.h ([SWS_EthIf_91007]).

A função de interface síncrona EthIf_VerifyConfig serve para a verificação da configuração do switch e encaminha a chamada diretamente para EthSwt_VerifyConfig [SWS_EthIf_91012]. A verificação propriamente dita é realizada pelo driver de switch Ethernet em função da respectiva arquitetura de hardware, das capacidades de hardware e da precisão de teste pretendida [SWS_EthIf_91012].

Utilização e parâmetros

A função está disponível através do cabeçalho EthIf.h com o Service-ID 0x40 e espera dois parâmetros [SWS_EthIf_91012]:

• SwitchIdx (in): índice do switch no contexto do driver de switch Ethernet.
• Result (out): Ponteiro para um valor booleano que recebe o resultado da verificação. TRUE indica uma configuração verificada com sucesso, enquanto FALSE aponta para corrupções detectadas.

Como valor de retorno, Std_ReturnType reporta o status da execução: E_OK sinaliza que a verificação foi concluída com sucesso, enquanto E_NOT_OK indica uma falha na verificação de configuração [SWS_EthIf_91012].

Simultaneidade e tratamento de erros

A função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91012]. Os chamadores devem, portanto, assegurar que não ocorram chamadas concorrentes. Como o payload não lista códigos de erro específicos para DET ou DEM, verificações detalhadas de parâmetros (como a validação de índices ou ponteiros) presumivelmente devem ser tratadas do lado do driver ou de forma específica da implementação. Pergunta Q-03b5f343e97bec7f (aberta)

A função síncrona EthIf_SetForwardingMode é disponibilizada através do cabeçalho EthIf.h e serve para o controle do encaminhamento de frames em um switch Ethernet [SWS_EthIf_91013]. Ela verifica a configuração atual do switch e, em caso de invalidade detectada, realiza uma reconfiguração do switch [SWS_EthIf_91013].

Parâmetros e valores de retorno

Na chamada (Service-ID 0x41), são passados os seguintes parâmetros de entrada [SWS_EthIf_91013]:

• SwitchIdx: Índice do respectivo switch no contexto do driver de switch Ethernet [SWS_EthIf_91013].
• mode: Chave booleana para ativação (TRUE) ou desativação (FALSE) do encaminhamento de frames [SWS_EthIf_91013].

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

• E_OK: Sinalizava, de acordo com a especificação, a parada bem-sucedida do encaminhamento; Interpretação: Isso provavelmente deve confirmar, de forma mais geral, a aplicação bem-sucedida do modo de encaminhamento solicitado [SWS_EthIf_91013]. Pergunta Q-f245de852fe854c0 (aberta)
• E_NOT_OK: A comutação ou a parada do encaminhamento de frames falhou [SWS_EthIf_91013].

Simultaneidade e restrições

A função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91013]. Os chamadores devem, portanto, assegurar que as chamadas para o mesmo contexto de switch ou para contextos paralelos ocorram de forma serializada e que não ocorram chamadas concorrentes. Códigos de erro específicos para DET ou DEM não estão definidos no padrão para este serviço.

A função EthIf_ClearTrcvSignalQuality serve para a limpeza síncrona dos valores armazenados de qualidade de sinal de uma conexão Ethernet para um transceptor específico [SWS_EthIf_91059]. Para isso, o chamador passa com o parâmetro TrcvIdx o índice do transceptor no contexto do Ethernet Interface, após o que os respectivos valores medidos são limpos [SWS_EthIf_00400].

Como valor de retorno, a interface fornece o tipo Std_ReturnType: se a redefinição da qualidade do sinal foi bem-sucedida, é retornado E_OK; caso contrário, a operação falha com E_NOT_OK [SWS_EthIf_91059]. Interpretação: o valor de erro E_NOT_OK deve provavelmente ser atribuído a parâmetros de índice inválidos ou a falhas no encaminhamento para drivers subjacentes, uma vez que o payload não menciona códigos de erro específicos ou entradas de DET. Pergunta Q-40d8f0c1fc7ba11e (aberta)

Em relação à concorrência, o serviço é implementado como reentrante para índices de transceptor diferentes, mas explicitamente não reentrante para o mesmo índice TrcvIdx [SWS_EthIf_91059]. Múltiplas chamadas para o transceptor idêntico não devem, portanto, ocorrer simultaneamente a partir de contextos concorrentes e devem ser devidamente protegidas.

Na interação de módulos, a chamada limpa especificamente os valores de qualidade de sinal armazenados do tipo EthIf_SignalQualityResultType para o EthIfTransceiver endereçado via TrcvIdx [SWS_EthIf_00400]. A declaração da interface síncrona com o Service ID 0x19 é disponibilizada por meio do cabeçalho EthIf.h [SWS_EthIf_91059].

usar

A função síncrona EthIf_ClearSwitchPortSignalQuality serve para redefinir os valores armazenados de qualidade de sinal para a conexão de uma determinada porta de switch Ethernet [SWS_EthIf_91060]. O endereçamento da porta de destino ocorre por meio dos dois parâmetros de entrada SwitchIdx (índice do switch Ethernet) e SwitchPortIdx (índice da porta dentro do contexto da interface) [SWS_EthIf_91060]. A função está disponível por meio do arquivo de cabeçalho EthIf.h [SWS_EthIf_91060].

Interação e estruturas de dados

De acordo com [SWS_EthIf_00404], a chamada limpa os valores de qualidade de sinal mantidos internamente da porta de switch endereçada, os quais correspondem ao tipo EthIf_SignalQualityResultType. Isso permite que módulos superiores descartem propositalmente valores de medição históricos e iniciem uma reavaliação da qualidade da conexão.

Tratamento de erros

O sucesso da operação é indicado por meio do valor de retorno do tipo Std_ReturnType: em caso de limpeza bem-sucedida, a função retorna E_OK; caso contrário, E_NOT_OK [SWS_EthIf_91060]. Códigos de erro específicos de DET ou DEM não estão definidos no payload. Interpretação: o valor de retorno E_NOT_OK deve ocorrer principalmente quando índices inválidos são passados ou quando o driver de switch subjacente não consegue executar a redefinição. Pergunta Q-fc42f5b3e5414f6a (aberta)

Simultaneidade e restrições

Em relação à reentrância, EthIf_ClearSwitchPortSignalQuality é reentrante para diferentes índices de switch e de porta de switch [SWS_EthIf_91060]. Para a mesma porta de switch (SwitchPortIdx), a função é, no entanto, especificada como não reentrante [SWS_EthIf_91060]. Os chamadores devem, portanto, assegurar que chamadas simultâneas para a mesma porta sejam evitadas ou protegidas por mecanismos de sincronização adequados.

A função de interface síncrona EthIf_SetPhyTestMode serve para a ativação de um modo de teste pré-definido em um transceptor Ethernet [SWS_EthIf_91016]. O serviço está declarado no arquivo de cabeçalho EthIf.h e é identificável por meio do Service-ID hexadecimal 0x17 [SWS_EthIf_91016].

Para a chamada, a função espera a passagem de dois parâmetros de entrada [SWS_EthIf_91016]:

• TrcvIdx: Determina o índice numérico do transceptor de destino no contexto do Ethernet Interface [SWS_EthIf_91016].
• Mode: Define o modo de teste concreto a ser ativado do tipo EthTrcv_PhyTestModeType [SWS_EthIf_91016].

Não existem parâmetros de entrada e saída [SWS_EthIf_91016]. Como valor de retorno, o serviço fornece um status do tipo Std_ReturnType [SWS_EthIf_91016]. O valor de retorno E_OK confirma que a solicitação para ativação do modo de teste foi aceita com sucesso [SWS_EthIf_91016]. O valor E_NOT_OK, por outro lado, indica que a solicitação foi rejeitada e o modo de teste não pôde ser ativado [SWS_EthIf_91016].

Em relação à simultaneidade, EthIf_SetPhyTestMode é especificada como reentrante para diferentes índices de transceptores (TrcvIdx) [SWS_EthIf_91016]. Para o mesmo índice de transceptor, a execução é explicitamente não reentrante [SWS_EthIf_91016]. Os chamadores devem, portanto, assegurar que chamadas concorrentes para a mesma instância de transceptor sejam evitadas e, em vez disso, coordenadas sequencialmente.

usar

A função síncrona EthIf_SetPhyLoopbackMode serve para a ativação de um modo de loopback especificado em um transceptor Ethernet [SWS_EthIf_91018]. A declaração está disponível através do arquivo de cabeçalho EthIf.h [SWS_EthIf_91018].

Na chamada, a função espera dois parâmetros de entrada:

• TrcvIdx: Índice do transceptor no contexto do Ethernet Interface [SWS_EthIf_91018].
• Mode: O modo de loopback a ser ativado do tipo EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

Como valor de retorno, a função fornece um status do tipo Std_ReturnType: E_OK sinaliza que a solicitação foi aceita, enquanto E_NOT_OK indica que a solicitação não pôde ser aceita [SWS_EthIf_91018]. Interpretação: A função provavelmente deve encaminhar a chamada de forma síncrona ao driver de transceptor Ethernet responsável por TrcvIdx. Pergunta Q-c4736bbfd250cca0 (aberta)

Tratamento de erros

Códigos de erro específicos, como mensagens DET ou eventos DEM, não estão definidos no extrato de especificação. Se a aceitação da solicitação falhar, isso é comunicado imediatamente ao chamador por meio do valor de retorno E_NOT_OK [SWS_EthIf_91018]. Os chamadores devem verificar esse valor de retorno antes de prosseguir com os fluxos subsequentes de teste ou diagnóstico.

Simultaneidade e restrições

A função é reentrante para diferentes índices de transceptores (TrcvIdx), contudo, explicitamente não reentrante para o mesmo índice de transceptor [SWS_EthIf_91018]. Os chamadores devem, portanto, assegurar que chamadas simultâneas para a mesma instância de transceptor sejam evitadas ou protegidas por mecanismos adequados de sincronização [SWS_EthIf_91018].

A função de interface síncrona EthIf_SetPhyTxMode serve para ativar um modo de transmissão especificado para um transceiver Ethernet [SWS_EthIf_91005]. A declaração da função ocorre no arquivo de cabeçalho EthIf.h sob o Service-ID 0x13 [SWS_EthIf_91005].

Para a chamada, a função espera dois parâmetros de entrada [SWS_EthIf_91005]:

• TrcvIdx: Índice numérico do transceiver em questão no contexto da interface Ethernet.
• Mode: O modo de transmissão concreto a ser ativado, do tipo EthTrcv_PhyTxModeType.

A execução ocorre de forma síncrona. Como valor de retorno, a função fornece um status do tipo Std_ReturnType [SWS_EthIf_91005]. O valor E_OK confirma a aceitação bem-sucedida da solicitação, enquanto E_NOT_OK sinaliza que a solicitação não pôde ser aceita [SWS_EthIf_91005]. Códigos de erro específicos ou notificações para o gerenciamento de erros de desenvolvimento (DET) ou gerenciamento de eventos de diagnóstico (DEM) não são indicados nos dados de especificação.

Em relação ao comportamento de concorrência, EthIf_SetPhyTxMode é reentrante para diferentes índices de transceiver (TrcvIdx) [SWS_EthIf_91005]. No entanto, se forem realizadas chamadas para o mesmo índice de transceiver, a função é definida como não reentrante e exige uma chamada sincronizada ou sequencial [SWS_EthIf_91005].

Como restrição formal, deve-se observar que este elemento de interface está marcado com o status draft na especificação AUTOSAR CP R20-11 [SWS_EthIf_91005].

A função síncrona e reentrante EthIf_ProvideTxBuffer (Service ID 0x09) concede acesso a um buffer de transmissão do controlador Ethernet indicado através de CtrlIdx e está disponível através do cabeçalho EthIf.h [SWS_EthIf_00067].

Para a solicitação de buffer, o chamador passa o índice do controlador (CtrlIdx), o tipo de frame Ethernet (FrameType), bem como a prioridade (Priority) para o campo PCP de 3 bits da tag VLAN [SWS_EthIf_00067]. Por meio do parâmetro de entrada e saída LenBytePtr, o chamador especifica o tamanho de buffer desejado em bytes e recebe de volta o comprimento efetivamente disponibilizado [SWS_EthIf_00067]. Em caso de alocação bem-sucedida, a função disponibiliza através de BufPtr um ponteiro para o buffer e através de BufIdxPtr o índice do recurso de buffer para requisições subsequentes [SWS_EthIf_00067].

O resultado da solicitação de buffer é reportado através do tipo de retorno BufReq_ReturnType [SWS_EthIf_00067]:

• BUFREQ_OK: O buffer foi disponibilizado com sucesso [SWS_EthIf_00067].
• BUFREQ_E_BUSY: todos os recursos de buffer estão ocupados no momento [SWS_EthIf_00067].
• BUFREQ_E_OVFL: O comprimento de buffer solicitado excede o tamanho disponível [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK: um erro de desenvolvimento foi detectado [SWS_EthIf_00067].

A função síncrona EthIf_Transmit dispara a transmissão de um buffer de envio previamente disponibilizado e preenchido por meio da interface Ethernet [SWS_EthIf_00075].

Utilização e parâmetros

A chamada ocorre por meio da interface declarada em EthIf.h com os seguintes parâmetros de passagem [SWS_EthIf_00075]:

• CtrlIdx: índice do controlador Ethernet no contexto do módulo EthIf.
• BufIdx: índice do recurso de buffer a ser transmitido.
• FrameType: Tipo de frame Ethernet.
• TxConfirmation: controla a ativação da confirmação de transmissão.
• LenByte: comprimento dos dados em bytes.
• PhysAddrPtr: endereço físico de destino (endereço MAC) na ordem de bytes da rede.

Valores de retorno e concorrência

Como valor de retorno, a função fornece E_OK em caso de acionamento bem-sucedido da transmissão ou E_NOT_OK caso a transmissão tenha falhado [SWS_EthIf_00075]. A função é reentrante para chamadas com índices de buffer e de controlador diferentes (BufIdx e CtrlIdx) [SWS_EthIf_00075].

A função EthIf_SwitchPortGetLinkState serve, de acordo com [SWS_EthIf_91109], para consultar o estado de conexão atual de uma determinada porta de switch. São passados o índice do switch SwitchIdx no contexto do driver de switch Ethernet e o índice da porta SwitchPortIdx no switch endereçado. O resultado da consulta é disponibilizado por meio do ponteiro LinkStatePtr, que assume ETHTRCV_LINK_STATE_DOWN (porta desconectada) ou ETHTRCV_LINK_STATE_ACTIVE (porta conectada). A especificação indica o comportamento de execução como síncrono ou assíncrono; isso deve provavelmente depender do driver de switch subjacente ou da conexão de hardware. Pergunta Q-dde6f9e8f1b8ba52 (aberta)

Como valor de retorno, a função fornece Std_ReturnType ([SWS_EthIf_91109]). Em caso de consulta bem-sucedida, é retornado E_OK. Se a determinação do estado de conexão falhar ou se a função for chamada enquanto o switch estiver no estado ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT, ocorre o retorno de E_NOT_OK.

Em relação à concorrência, a função é especificada como não reentrante (Non Reentrant) ([SWS_EthIf_91109]), razão pela qual chamadas simultâneas no mesmo contexto devem ser excluídas. A declaração está disponível por meio do cabeçalho EthIf.h com o Service ID 0x4b.

usar

A função síncrona EthIf_TransceiverGetLinkState serve para consultar o estado de conexão atual (Link State) de um transceptor Ethernet endereçado via TrcvIdx, de acordo com [SWS_EthIf_91110]. A declaração da interface é disponibilizada por meio do cabeçalho EthIf.h [SWS_EthIf_91110].

Na chamada, são passados os seguintes parâmetros [SWS_EthIf_91110]:

• TrcvIdx (entrada): Índice do transceptor no contexto do Ethernet Transceiver Driver.
• LinkStatePtr (saída): Ponteiro para o local de armazenamento para o estado determinado do tipo EthTrcv_LinkStateType. Valores de resultado possíveis são ETHTRCV_LINK_STATE_ACTIVE para um transceptor conectado e ETHTRCV_LINK_STATE_DOWN para um desconectado.

Como valor de retorno, a função fornece o código de status do tipo Std_ReturnType: E_OK sinaliza uma execução bem-sucedida, enquanto E_NOT_OK indica que o transceptor não pôde ser inicializado [SWS_EthIf_91110].

Tratamento de erros e condições de contorno

Se a consulta falhar, o serviço com o Service ID 0x4c fornece o valor de retorno E_NOT_OK [SWS_EthIf_91110]. Mensagens de erro específicas de DET ou DEM não estão listadas na especificação da função.

simultaneidade

A função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91110]. Interpretação: devido à ausência de reentrância, uma chamada simultânea a partir de múltiplas threads ou contextos de tarefa não deve ser permitida e requer, se necessário, sincronização por parte do chamador. Pergunta Q-0459aa9b4c187439 (aberta)

A função EthIf_SwitchPortGetBaudRate serve para consultar a velocidade de transmissão atual de uma determinada porta de switch Ethernet de acordo com [SWS_EthIf_91111]. Na chamada, são passados o índice do switch (SwitchIdx) e o índice da porta no switch endereçado (SwitchPortIdx). O resultado da consulta é disponibilizado por meio do ponteiro BaudRatePtr do tipo EthTrcv_BaudRateType*, que pode representar velocidades como ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT ou ETHTRCV_BAUD_RATE_2500MBIT [SWS_EthIf_91111].

Em relação ao comportamento de erro, a função retorna E_OK em caso de determinação bem-sucedida da taxa de transmissão. Um valor de retorno de E_NOT_OK sinaliza que a taxa de transmissão para a porta de switch indicada não pôde ser lida ou que o driver do switch se encontra no estado ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT [SWS_EthIf_91111].

A especificação indica a função como não reentrante (Non Reentrant) e como síncrona/assíncrona [SWS_EthIf_91111]. Provavelmente, o comportamento síncrono ou assíncrono depende da conexão e implementação do driver de switch Ethernet subjacente. Pergunta Q-1f4d760ff944df9d (aberta) Devido à falta de reentrância, os chamadores devem garantir que chamadas paralelas da interface sejam evitadas.

A função síncrona EthIf_TransceiverGetBaudRate com o Service ID 0x4e serve para ler a taxa de transmissão atual de um transceptor Ethernet indexado [SWS_EthIf_91112]. Ela é parte integrante do módulo EthIf e é disponibilizada por meio do arquivo de cabeçalho EthIf.h [SWS_EthIf_91112].

O parâmetro de entrada TrcvIdx do tipo uint8 identifica o transceptor no contexto do driver do transceptor Ethernet [SWS_EthIf_91112]. Não existem parâmetros inout [SWS_EthIf_91112]. O resultado da consulta é retornado por meio do parâmetro de saída BaudRatePtr [SWS_EthIf_91112]. Valores válidos do tipo Eth_Trcv_BaudRateType são ETHTRCV_BAUD_RATE_10MBIT (10 Mbit/s), ETHTRCV_BAUD_RATE_100MBIT (100 Mbit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 Mbit/s) e ETHTRCV_BAUD_RATE_2500MBIT (2500 Mbit/s) [SWS_EthIf_91112].

A função retorna um status do tipo Std_ReturnType: em caso de chamada bem-sucedida, é passado E_OK [SWS_EthIf_91112]. Se o transceptor não pôde ser inicializado, o serviço falha e reporta E_NOT_OK [SWS_EthIf_91112].

Em relação ao contexto de chamada e à concorrência, EthIf_TransceiverGetBaudRate é definida como uma interface síncrona e não reentrante (Non Reentrant) [SWS_EthIf_91112]. As camadas chamadoras devem garantir que chamadas concorrentes para este serviço sejam evitadas ou serializadas no nível do chamador [SWS_EthIf_91112].

A função EthIf_SwitchPortGetDuplexMode serve para consultar o modo duplex atual de uma porta indexada em um switch Ethernet [SWS_EthIf_91113]. Ela encaminha a chamada para a função EthSwt_GetDuplexMode do driver de switch Ethernet associado via SwitchIdx [SWS_EthIf_00428].

Parâmetros e interface

• SwitchIdx: Índice do switch Ethernet no contexto do driver [SWS_EthIf_91113].
• SwitchPortIdx: Índice da porta em questão no switch endereçado [SWS_EthIf_91113].
• DuplexModePtr: Ponteiro de saída do tipo EthTrcv_DuplexModeType* para o modo determinado, seja ETHTRCV_DUPLEX_MODE_HALF (half-duplex) ou ETHTRCV_DUPLEXMODE_FULL (full-duplex) [SWS_EthIf_91113].

Execução e tratamento de erros

O valor de retorno E_OK sinaliza uma consulta bem-sucedida [SWS_EthIf_91113]. Se o modo duplex da porta não puder ser determinado ou se o driver estiver nos estados ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT, a função retorna E_NOT_OK [SWS_EthIf_91113].

A interface é não reentrante (Non Reentrant) e declarada na especificação como síncrona/assíncrona [SWS_EthIf_91113]. Interpretação: o funcionamento real síncrono ou assíncrono deve depender das propriedades do driver de switch conectado. Pergunta Q-339413722431978f (aberta)

A função síncrona EthIf_TransceiverGetDuplexMode determina o modo duplex atual de um transceptor Ethernet indexado de acordo com [SWS_EthIf_91114].

Utilização e parâmetros

A chamada ocorre sincronamente e é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91114]:

• TrcvIdx: Passa como parâmetro de entrada o índice do transceptor no contexto do driver de transceptor Ethernet [SWS_EthIf_91114].
• DuplexModePtr: Serve como ponteiro de saída para o tipo EthTrcv_DuplexModeType para receber o resultado. Valores possíveis são ETHTRCV_DUPLEX_MODE_HALF (half-duplex) ou ETHTRCV_DUPLEX_MODE_FULL (full-duplex) [SWS_EthIf_91114].

Valores de retorno e tratamento de erros

Como valor de retorno, a função fornece um Std_ReturnType [SWS_EthIf_91114]:

• E_OK: O modo duplex foi consultado com sucesso e disponibilizado via DuplexModePtr [SWS_EthIf_91114].
• E_NOT_OK: A determinação falhou, de acordo com a especificação, por exemplo, se o transceptor não pôde ser inicializado [SWS_EthIf_91114].

Restrições e concorrência

Como a interface é não reentrante, chamadas paralelas para a mesma ou para diferentes instâncias de transceptor não devem ocorrer sem sincronização externa. A declaração está disponível por meio do cabeçalho EthIf.h [SWS_EthIf_91114].

A função síncrona EthIf_SwitchPortGetCounterValues serve para ler os valores dos contadores (drop counter) de uma determinada porta de switch Ethernet de acordo com [SWS_EthIf_91115]. Disponibilizada por meio do cabeçalho EthIf.h, a função recebe o índice do switch SwitchIdx, bem como o índice da porta SwitchPortIdx, e grava os valores dos contadores de volta por meio do ponteiro CounterPtr ([SWS_EthIf_91115]).

Modo de operação e encaminhamento

De acordo com [SWS_EthIf_00432], EthIf_SwitchPortGetCounterValues encaminha a solicitação diretamente para a função EthSwt_GetCounterValues do respectivo driver de switch Ethernet. Os valores de contador retornados orientam-se pelos padrões IETF RFC 1757, RFC 1643 e RFC 2233, estando o significado semântico exato atribuído à estrutura Eth_CounterType ([SWS_EthIf_91115]).

Valores de retorno e tratamento de erros

Como valor de retorno a função fornece Std_ReturnType ([SWS_EthIf_91115]):

• E_OK: A leitura dos valores dos contadores foi bem-sucedida ([SWS_EthIf_91115]).
• E_NOT_OK: Ocorreu um erro durante a leitura dos valores dos contadores ([SWS_EthIf_91115]).

Simultaneidade e restrições

A função é especificada como não reentrante (Non Reentrant) ([SWS_EthIf_91115]). Chamadas concorrentes devem, portanto, ser sincronizadas no nível do chamador. Interpretação: O chamador também deve ser responsável por disponibilizar uma área de memória válida e com dimensionamento suficiente para CounterPtr, uma vez que a especificação não menciona nenhuma alocação interna de buffer. Pergunta Q-140661eaa9693cce (aberta)

Utilização e semântica

A função EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) serve para consultar contadores de estatísticas de recepção para uma porta de um switch Ethernet. Ela está disponível por meio do cabeçalho EthIf.h e é gerenciada sob o Service ID 0x52 ([SWS_EthIf_91116]).

A chamada requer os seguintes parâmetros ([SWS_EthIf_91116]):

• SwitchIdx: Índice do Ethernet Switch no contexto do driver do Ethernet Switch.
• SwitchPortIdx: índice da porta no switch endereçado.
• RxStatsPtr: Ponteiro para uma estrutura do tipo Eth_RxStatsType, na qual os valores de contagem são gravados. A maior parte desses valores é derivada da IETF RFC 2819 (Remote Network Monitoring Management Information Base).

Valores de retorno e tratamento de erros

A função retorna como resultado um Std_ReturnType ([SWS_EthIf_91116]):

• E_OK: Os dados estatísticos foram lidos com sucesso.
• E_NOT_OK: Os valores dos contadores não puderam ser determinados ([SWS_EthIf_91116]). Mensagens de erro específicas de DET ou DEM não estão especificadas para esta chamada.

Simultaneidade e restrições

A função é classificada como não reentrante (Non Reentrant) ([SWS_EthIf_91116]). Como a sincronicidade é indicada como “Synchronous /Asynchronous”, o comportamento de bloqueio real deve depender da implementação do driver de switch Ethernet subjacente ([SWS_EthIf_91116]). Pergunta Q-d1e839075bf42e7f (aberta) Os chamadores devem evitar acessos paralelos à mesma interface.

A função EthIf_SwitchPortGetTxStats serve para a leitura de estatísticas de transmissão de acordo com a IETF RFC1213 para uma determinada porta de um switch Ethernet [SWS_EthIf_91117]. Ela está disponível por meio do arquivo de cabeçalho EthIf.h com o Service ID 0x53 [SWS_EthIf_91117].

Utilização e parâmetros

Na chamada, o índice do switch (SwitchIdx) e o índice da porta no switch endereçado (SwitchPortIdx) são passados como parâmetros de entrada [SWS_EthIf_91117]. As contagens determinadas são disponibilizadas por meio do ponteiro TxStatsPtr do tipo Eth_TxStatsType* [SWS_EthIf_91117]. Caso um contador não esteja disponível ou não seja suportado, o valor máximo possível do contador sinaliza um valor inválido [SWS_EthIf_91117].

Valores de retorno e tratamento de erros

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

• E_OK: As estatísticas de transmissão foram determinadas com sucesso [SWS_EthIf_91117].
• E_NOT_OK: As estatísticas de transmissão não puderam ser obtidas [SWS_EthIf_91117].

Códigos de erro específicos ou mensagens para DET ou DEM não são indicados nas fontes, de modo que casos de erro devem ser interceptados primariamente através do valor de retorno E_NOT_OK [SWS_EthIf_91117].

Simultaneidade e restrições

De acordo com a especificação, EthIf_SwitchPortGetTxStats é definido como assíncrono (Asynchronous) e não reentrante (Non Reentrant) [SWS_EthIf_91117]. Devido à falta de reentrância, chamadas simultâneas não devem ocorrer sem sincronização de nível superior [SWS_EthIf_91117]. Como o serviço é declarado como assíncrono, é provável que o buffer transmitido TxStatsPtr deva ser mantido válido até a conclusão completa da operação (interpretação: estabilidade de buffer em consulta assíncrona) [SWS_EthIf_91117]. Pergunta Q-8a14618d6990206b (aberta)

A função síncrona EthIf_SwitchPortGetTxErrorCounterValues (Service-ID 0x54), disponibilizada por meio de EthIf.h, lê uma lista de contadores de erros de transmissão para uma porta de um switch Ethernet [SWS_EthIf_91118]. Os contadores correspondem às definições das normas IETF RFC1213 e RFC1643 e são disponibilizados por meio do tipo Eth_TxErrorCounterValuesType no parâmetro de saída TxStatsPtr [SWS_EthIf_91118].

Durante a chamada, SwitchIdx endereça o switch no contexto do driver e SwitchPortIdx a porta concreta no switch [SWS_EthIf_91118]. A função fornece E_OK em caso de determinação bem-sucedida dos valores e E_NOTOK caso não tenha sido possível obter as estatísticas de transmissão [SWS_EthIf_91118]. Um valor de contador que assume o valor máximo possível caracteriza explicitamente um contador inválido ou não disponível [SWS_EthIf_91118].

Como restrição para a execução, está estabelecido que a função não é reentrante (Non Reentrant) [SWS_EthIf_91118]. Na estrutura da arquitetura, EthIf_SwitchPortGetTxErrorCounterValues encaminha a chamada diretamente para a função EthSwt_GetTxErrorCounterValues do driver de switch Ethernet correspondente [SWS_EthIf_00438].

A função EthIf_SwitchPortGetMacLearningMode consulta o modo de aprendizado MAC atual para uma determinada porta de switch ([SWS_EthIf_91119]). Entre os modos que podem ser determinados estão aprendizado por hardware ativado, aprendizado por hardware desativado e aprendizado por software ativado ([SWS_EthIf_91119]). A disponibilidade desta função depende do hardware, pois o respectivo hardware de switch precisa suportar os diferentes modos de aprendizado ([SWS_EthIf_91119]).

Contexto de chamada e parâmetros

A interface é disponibilizada através do header EthIf.h e possui o ID de serviço 0x55 ([SWS_EthIf_91119]). Na chamada, devem ser passados os seguintes parâmetros:

• SwitchIdx (in): índice do switch no contexto do driver de switch Ethernet ([SWS_EthIf_91119]).
• SwitchPortIdx (in): índice da porta no switch endereçado ([SWS_EthIf_91119]).
• MacLearningModePtr (out): ponteiro para o local de armazenamento do tipo EthSwt_MacLearningType, no qual o modo determinado é armazenado ([SWS_EthIf_91119]).

Sincronização, concorrência e valores de retorno

A execução é especificada como síncrona/assíncrona e não é reentrante (Non Reentrant) ([SWS_EthIf_91119]). Como valor de retorno, é utilizado Std_ReturnType com os seguintes status:

• E_OK: consulta realizada com sucesso ([SWS_EthIf_91119]).
• E_NOT_OK: erro durante a execução ([SWS_EthIf_91119]). A descrição da especificação referente a E_NOT_OK cita literalmente «configuration could be persistently reset», interpretação: é provável que isto seja um erro editorial de cópia na especificação e que, no contexto regular, sinalize simplesmente a falha da consulta. Pergunta Q-7565d2fbd70e355d (aberta)

A interface síncrona EthIf_WritePortMirrorConfiguration serve para armazenar uma configuração de port mirroring em um shadow buffer dentro do driver de switch Ethernet [SWS_EthIf_91122].

Na chamada, são passados os seguintes parâmetros de entrada [SWS_EthIf_91122]:

• MirroredSwitchIdx: índice do switch em questão no contexto do driver de switch Ethernet, no qual se encontra a porta de switch a ser espelhada [SWS_EthIf_91122].
• PortMirrorConfigurationPtr: ponteiro para os dados de configuração da estrutura EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

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

• E_OK: a configuração de port mirroring foi escrita com sucesso para a porta indexada [SWS_EthIf_91122].
• E_NOT_OK: não foi possível escrever a configuração, por exemplo, porque o switch indexado não está disponível [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: o port mirroring não é suportado pelo hardware do switch ou pelo driver de switch Ethernet [SWS_EthIf_91122].

A função é especificada como não reentrante (Non Reentrant) e está disponível através do header EthIf.h [SWS_EthIf_91122]. Interpretação: os chamadores provavelmente precisam coordenar acessos concorrentes por meio de mecanismos de nível superior, uma vez que nenhuma proteção interna de sincronização está especificada. Pergunta Q-c731aedd871251a4 (aberta)

Utilização e semântica

A função EthIf_ReadPortMirrorConfiguration serve para consultar a configuração de port mirroring de um determinado switch Ethernet [SWS_EthIf_91123]. Ela é declarada no arquivo de cabeçalho EthIf.h e possui o ID de serviço 0x59. O comportamento de execução é especificado como assíncrono (Asynchronous), sendo que a chamada imediata retorna um valor de status do tipo Std_ReturnType [SWS_EthIf_91123].

Parâmetros e valores de retorno

• MirroredSwitchIdx (in): índice do switch Ethernet no contexto do driver de switch Ethernet, no qual se encontram as portas de switch a serem espelhadas [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out): ponteiro para a área de memória na qual a configuração lida deve ser armazenada [SWS_EthIf_91123].
• Valor de retorno: E_OK sinaliza a leitura bem-sucedida da configuração. Em caso de erro, é retornado E_NOT_OK, por exemplo, se o switch Ethernet indexado não estiver disponível [SWS_EthIf_91123].

Interação e concorrência

Para a execução, EthIf_ReadPortMirrorConfiguration encaminha a chamada diretamente para a função EthSwt_ReadPortMirrorConfiguration do driver de switch Ethernet correspondente [SWS_EthIf_00448]. A função é definida como não reentrante (Non Reentrant) [SWS_EthIf_91123]; chamadas paralelas para a mesma interface devem, portanto, ser evitadas pelo chamador.

A função síncrona EthIf_DeletePortMirrorConfiguration serve para excluir uma configuração de port mirror armazenada para um determinado switch ([SWS_EthIf_91124]). O chamador passa através do parâmetro Mirrored Switch Idx o índice do switch no contexto do Ethernet Switch Driver ([SWS_EthIf_91124]). A interface possui o ID de serviço 0x5a e é disponibilizada através do arquivo de cabeçalho EthIf.h ([SWS_EthIf_91124]).

O valor de retorno do tipo Std_ReturnType informa sobre o resultado da exclusão ([SWS_EthIf_91124]):

• E_OK: a configuração de port mirror foi excluída com sucesso ([SWS_EthIf_91124]). Se nenhuma configuração armazenada tiver sido encontrada para o índice de switch indicado, a função retorna por definição igualmente E_OK ([SWS_EthIf_91124]).
• E_NOT_OK: a exclusão da configuração falhou ([SWS_EthIf_91124]). Este é o caso, por exemplo, se o espelhamento de porta ainda estiver ativado no momento da chamada ([SWS_EthIf_91124]).

Em relação à concorrência, a função é reentrante para índices de switch diferentes (Mirrored Switch Idx), contudo não reentrante em chamadas múltiplas para o mesmo índice ([SWS_EthIf_91124]). Como um mirroring ativo é citado explicitamente como causa de erro para E_NOT_OK, é provável que o port mirroring deva ser desativado antes da exclusão da configuração ([SWS_EthIf_91124]). Pergunta Q-b9e5665de687dbba (aberta)

A função síncrona EthIf_SetPortMirrorState serve para definir o estado solicitado da configuração de port mirroring para um switch Ethernet especificado ([SWS_EthIf_91126]). Ela está disponível através do arquivo de cabeçalho EthIf.h ([SWS_EthIf_91126]).

A função aguarda três parâmetros na chamada ([SWS_EthIf_91126]):

• MirroredSwitchIdx: Índice do Ethernet Switch no contexto do Ethernet Switch Driver, no qual se encontra a configuração de port mirroring a ser ativada ou desativada.
• PortIdx: Índice da porta no Ethernet Switch endereçado.
• PortMirrorState: o estado do espelhamento de porta a ser solicitado, ou PORT_MIRRORING_ENABLED ou PORT_MIRRORING_DISABLED.

O valor de retorno do tipo Std_ReturnType sinaliza o resultado da solicitação ([SWS_EthIf_91126]):

• E_OK: o estado solicitado para a porta de switch indicada foi definido com sucesso.
• E_NOT_OK: a definição falhou, por exemplo, se o switch endereçado não estiver disponível ou se não houver configuração de port mirroring.

A execução ocorre de forma síncrona e é especificada como não reentrante (Non Reentrant) ([SWS_EthIf_91126]). Na estrutura de camadas, a Ethernet Interface assume o encaminhamento: conforme [SWS_EthIf_00454], EthIf_SetPortMirrorState encaminha a chamada diretamente para a função EthSwt_SetPortMirrorState do Ethernet Switch Driver responsável.

A função EthIf_SetPortTestMode serve para a ativação de um modo de teste predefinido em uma porta indexada de um switch Ethernet [SWS_EthIf_91127]. O serviço síncrono está disponível através do header EthIf.h com o ID de serviço 0x5d [SWS_EthIf_91127].

Parâmetros e valores de retorno

Para a configuração do modo de teste, a interface espera três parâmetros de entrada, enquanto não existem parâmetros de entrada/saída ou puramente de saída [SWS_EthIf_91127]:

• SwitchIdx (uint8): índice do switch no contexto do respectivo driver de switch Ethernet [SWS_EthIf_91127].
• PortIdx (uint8): índice da porta no switch Ethernet endereçado [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType): o modo de teste a ser ativado na porta do switch [SWS_EthIf_91127].

O valor de retorno do tipo Std_ReturnType sinaliza o sucesso da operação [SWS_EthIf_91127]:

• E_OK: o modo de teste de porta para a porta de switch Ethernet indexada foi definido com sucesso [SWS_EthIf_91127].
• E_NOT_OK: a definição do modo de teste de porta não foi bem-sucedida, por exemplo, se a porta de switch Ethernet endereçada não estiver disponível [SWS_EthIf_91127].

Concorrência e interação

A função é especificada como não reentrante (Non Reentrant) e opera de forma síncrona [SWS_EthIf_91127]. Na chamada, EthIf_SetPortTestMode encaminha a solicitação diretamente para a função subjacente EthSwt_SetPortTestMode do driver de switch Ethernet correspondente [SWS_EthIf_00456].

usar

A função EthIf_SetPortLoopbackMode serve para ativar um modo de loopback de teste predefinido para uma porta indexada de um switch Ethernet [SWS_EthIf_91128]. A declaração é disponibilizada através do arquivo de cabeçalho EthIf.h [SWS_EthIf_91128]. Na chamada, são passados os seguintes parâmetros de entrada:

• SwitchIdx: Índice do Ethernet Switch dentro do contexto do driver do Ethernet Switch [SWS_EthIf_91128].
• PortIdx: índice da porta em questão no switch previamente endereçado [SWS_EthIf_91128].
• Mode: modo de loopback a ser ativado do tipo EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Interação e encaminhamento

A função não realiza a configuração de forma autônoma a nível de hardware. Em vez disso, EthIf_SetPortLoopbackMode encaminha a chamada diretamente para a função EthSwt_SetPortLoopbackMode do driver de switch Ethernet correspondente [SWS_EthIf_00458].

Tratamento de erros e valores de retorno

O valor de retorno é do tipo Std_ReturnType [SWS_EthIf_91128]:

• E_OK: o modo de loopback foi ativado com sucesso para a porta indexada do switch Ethernet [SWS_EthIf_91128].
• E_NOT_OK: a ativação falhou, por exemplo, se a porta de switch Ethernet indexada não estiver disponível [SWS_EthIf_91128].

Códigos de erro específicos para DET ou DEM não são listados na especificação para este serviço.

Simultaneidade e restrições

A execução ocorre de forma totalmente síncrona, e a função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91128]. Chamadas paralelas devem ser impedidas pelo chamador. Interpretação: como se trata da comutação de modos de teste, a chamada provavelmente ocorre tipicamente no âmbito de sequências de inicialização, de teste ou de diagnóstico no nível de tarefa. Pergunta Q-cb4575c4a1d9c48b (aberta)

A função síncrona EthIf_SetPortTxMode ativa um modo de transmissão predefinido para uma porta de switch Ethernet indexada [SWS_EthIf_91129]. Ela está disponível através do arquivo de cabeçalho EthIf.h e possui o ID de serviço 0x5f [SWS_EthIf_91129].

usar

A chamada endereça a porta de destino através de dois índices e transmite o modo desejado [SWS_EthIf_91129]:

• SwitchIdx: índice do switch dentro do contexto do driver de switch Ethernet.
• PortIdx: índice da porta no switch endereçado.
• Mode: Modo de transmissão a ser ativado, do tipo EthTrcv_PhyTxModeType.

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

• E_OK: o modo de transmissão para a porta de switch indexada foi ativado com sucesso.
• E_NOT_OK: a ativação falhou, por exemplo, se a porta de switch indexada não estiver disponível.

Simultaneidade e restrições

A interface é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91129]. As instâncias chamadoras devem, portanto, assegurar que não ocorram chamadas concorrentes. Mensagens de erro específicas de DET ou DEM não estão listadas na definição da função; o comportamento de erro limita-se, segundo a especificação, ao retorno de E_NOT_OK [SWS_EthIf_91129].

usar

A interface assíncrona EthIf_RunPortCableDiagnostic dispara um diagnóstico de cabo para uma porta selecionada de um switch Ethernet [SWS_EthIf_91131]. Na chamada, são passados os parâmetros SwitchIdx (índice do switch no contexto do driver de switch Ethernet) e PortIdx (índice da porta endereçada no switch). A função retorna E_OK assim que o trigger para o diagnóstico de cabo foi aceito; se o disparo for rejeitado, ocorre o retorno de E_NOT_OK [SWS_EthIf_91131].

Interação e pré-condições

Durante a execução de EthIf_RunPortCableDiagnostic, EthIf tem a obrigação de assegurar que o correspondente EthIfController se encontre no estado de operação ETH_MODE_ACTIVE [SWS_EthIf_00464]. Sob esta condição, a Ethernet Interface encaminha a chamada para a função EthSwt_RunPortCableDiagnostic do driver de switch atribuído [SWS_EthIf_00464].

Simultaneidade e restrições

A função é reentrante para valores divergentes entre si de SwitchIdx e PortIdx [SWS_EthIf_91131]. Para pares idênticos de índice de switch e de porta, por outro lado, a chamada é especificada como não reentrante, razão pela qual execuções paralelas na mesma porta devem ser evitadas.

usar

A função EthIf_RunCableDiagnostic dispara o diagnóstico de cabo para um transceptor Ethernet especificado [SWS_EthIf_91132]. Ela é disponibilizada através do header EthIf.h e gerenciada sob o ID de serviço 0x62 [SWS_EthIf_91132]. Como parâmetro de passagem serve TrcvIdx, que mapeia o índice do transceptor de destino no contexto do driver de transceptor Ethernet [SWS_EthIf_91132].

A execução ocorre de forma assíncrona [SWS_EthIf_91132]. O valor de retorno do tipo Std_ReturnType sinaliza a aceitação do trigger:

• E_OK: o trigger para o diagnóstico de cabo foi aceito com sucesso [SWS_EthIf_91132].
• E_NOT_OK: o trigger não foi aceito [SWS_EthIf_91132].

Tratamento de erros

Se o diagnóstico de cabo for rejeitado, a função retorna imediatamente E_NOT_OK [SWS_EthIf_91132]. Erros específicos de desenvolvimento ou de produção (DET/DEM) não estão definidos para esta função na presente especificação.

Simultaneidade e restrições

Em relação à concorrência, EthIf_RunCableDiagnostic é reentrante para chamadas com índices diferentes (TrcvIdx), mas não é reentrante para o mesmo índice de transceptor [SWS_EthIf_91132]. Requisições de diagnóstico simultâneas no mesmo transceptor devem ser impedidas pelo chamador. Interpretação: Como a função opera de forma puramente assíncrona e não retorna dados de resultado, a disponibilização do resultado do diagnóstico provavelmente ocorre por meio de um mecanismo separado. Pergunta Q-c65c009cd2e00dea (aberta)

A função de interface EthIf_SwitchGetCfgDataRaw serve para a leitura de dados de configuração ou de memória de um switch Ethernet indexado em comprimento variável [SWS_EthIf_91133]. No âmbito do modelo de camadas, o módulo não processa a chamada de forma autônoma, mas a encaminha diretamente para a função EthSwt_GetCfgDataRaw do driver de switch Ethernet responsável [SWS_EthIf_00468]. A função está declarada no cabeçalho EthIf.h e possui o Service ID 0x63 [SWS_EthIf_91133].

Chamada e parâmetros

A chamada ocorre de forma assíncrona e apenas inicia a operação de leitura [SWS_EthIf_91133]. Como parâmetros, a função espera:

• SwitchIdx: índice do switch Ethernet no contexto do driver de switch Ethernet [SWS_EthIf_91133],
• Offset: deslocamento inicial na memória do switch Ethernet a partir do qual a operação de leitura começa [SWS_EthIf_91133],
• Length: quantidade de bytes de dados a serem lidos e copiados [SWS_EthIf_91133],
• BufferPtr: ponteiro para o local de memória de destino para o qual os dados devem ser copiados [SWS_EthIf_91133].

Como valor de retorno, a função fornece E_OK se a operação de leitura foi disparada com sucesso [SWS_EthIf_91133]. Se a operação não puder ser disparada – por exemplo, se o switch endereçado não estiver disponível –, E_NOT_OK é reportado [SWS_EthIf_91133].

simultaneidade

A função é definida como não reentrante (Non Reentrant) [SWS_EthIf_91133]. Os chamadores devem, portanto, assegurar que as chamadas ocorram sequencialmente. Interpretação: Devido ao caráter assíncrono, o conteúdo do buffer provavelmente ainda não estará preenchido de forma definitiva no retorno de E_OK, sendo disponibilizado pelo driver apenas com retardo de tempo. Pergunta Q-0abda93fb8830dd4 (aberta)

A função EthIf_SwitchGetCfgDataInfo determina o tamanho total dos dados de configuração, bem como o endereço inicial dos registradores de configuração para um switch Ethernet indexado [SWS_EthIf_91134]. A interface está declarada no cabeçalho EthIf.h e é gerenciada sob o Service ID 0x64 [SWS_EthIf_91134].

A função aceita os seguintes parâmetros [SWS_EthIf_91134]:

• SwitchIdx (in): índice do switch Ethernet no contexto do driver de switch Ethernet.
• DataSizePtr (out): ponteiro para a posição de memória para a qual o tamanho total dos dados de configuração deve ser copiado.
• DataAdressPtr (out): ponteiro para a posição de memória para a qual o endereço inicial dos registradores de configuração deve ser copiado.

Como valor de retorno, a função fornece E_OK se os dados foram obtidos com sucesso, ou E_NOT_OK caso a operação falhe, por exemplo, porque o switch indexado não está disponível [SWS_EthIf_91134]. Códigos de erro específicos para DET ou DEM não estão definidos para este serviço no presente escopo da especificação.

Para o contexto de chamada, a função é especificada como reentrante, bem como formalmente como assíncrona [SWS_EthIf_91134]. Como não há mecanismos de callback especificados, a disponibilização dos dados provavelmente estará diretamente presente no retorno de E_OK (Interpretação: a classificação assíncrona indica provavelmente acessos internos do driver). Pergunta Q-bf49882a16548ea4 (aberta)

Uso e chamada

A função EthIf_SwitchPortGetMaxFIFOBufferFillLevel determina a memória de buffer FIFO máxima alocada (em bytes) desde o último acesso de leitura para uma determinada porta de egress de um switch Ethernet [SWS_EthIf_91135]. A chamada pode ocorrer, por exemplo, por meio de um Complex Device Driver (CDD) [SWS_EthIf_91135]. Para o endereçamento, são transmitidos o índice do switch (SwitchPortIdx), o índice da porta (PortIdx) e o índice da FIFO (SwitchPortEgressFifoIdx). O nível de preenchimento determinado é gravado na área de memória para a qual SwitchPortEgressFifoBufferLevelPtr aponta [SWS_EthIf_91135].

Simultaneidade e execução

A função possui uma semântica de execução assíncrona [SWS_EthIf_91135]. Ela é reentrante para índices diferentes de switch e de porta, mas não deve ser chamada concorrentemente para a mesma combinação de SwitchPortIdx e PortIdx [SWS_EthIf_91135]. Devido à semântica assíncrona com passagem simultânea de ponteiro, a área de memória referenciada para o resultado provavelmente deverá permanecer válida até a conclusão da operação. Pergunta Q-c941ffec278a86cd (aberta)

Tratamento de erros e interação com o driver

Em caso de consulta bem-sucedida, a função retorna E_OK; caso contrário, retorna E_NOT_OK [SWS_EthIf_91135]. Caso o hardware do switch não suporte a determinação baseada em porta do nível máximo de preenchimento do buffer FIFO, o valor no endereço de destino SwitchPortEgressFifoBufferLevelPtr é definido como 0xFFFFFFFF [SWS_EthIf_91135]. O módulo encaminha a chamada para execução adicional para a função de driver EthSwt_GetMaxFIFOBufferFillLevel do driver de switch Ethernet associado [SWS_EthIf_00472].

Utilização e semântica

A função EthIf_TransceiverGetMacMethod (Service-ID 0x66) serve para consultar de forma síncrona o método de acesso ao meio configurado de um transceptor Ethernet [SWS_EthIf_91021]. Ela está disponível através do arquivo de cabeçalho EthIf.h e utiliza os seguintes parâmetros de interface:

• TrcvIdx (in): Índice do transceptor dentro do contexto do driver de transceptor Ethernet [SWS_EthIf_91021].
• MacModePtr (out): Ponteiro para o local de armazenamento do método de acesso determinado do tipo EthTrcv_MacMethodType [SWS_EthIf_91021]. Valores de resultado válidos são ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access com detecção de colisão) e ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

Valores de retorno e tratamento de erros

Como valor de retorno, a interface fornece um status do tipo Std_ReturnType [SWS_EthIf_91021]:

• E_OK: O método de acesso ao meio foi lido com sucesso e disponibilizado através de MacModePtr.
• E_NOT_OK: A solicitação ao transceptor não foi aceita [SWS_EthIf_91021]. Códigos de erro específicos de DET ou DEM não estão listados na especificação para este serviço.

Simultaneidade e condições marginais

A execução é síncrona, mas a função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_91021]. Uma chamada simultânea ou de interrupção dentro do mesmo contexto de driver deve, portanto, ser evitada pelo chamador. Deve-se notar também que o serviço é indicado com o status atp.Status=draft no release R20-11 [SWS_EthIf_91021].

Utilização e semântica

A função síncrona EthIf_RxIndication processa um quadro Ethernet recebido por meio de um controlador Ethernet físico indexado [SWS_EthIf_00085]. O serviço não possui valor de retorno e realiza o encaminhamento dos dados recebidos dentro da interface Ethernet [SWS_EthIf_00085]. Interpretação: o chamamento deve ocorrer tipicamente pelo driver Ethernet subjacente (Eth), assim que novos dados de recepção estiverem completamente disponíveis. Pergunta Q-c3d25d0b89e6cd7f (aberta)

Parâmetros

Para o processamento posterior, a função recebe os seguintes parâmetros [SWS_EthIf_00085]:

• CtrlIdx: índice do controlador Ethernet físico no contexto da interface Ethernet [SWS_EthIf_00085].
• FrameType: tipo de quadro do quadro Ethernet recebido [SWS_EthIf_00085].
• IsBroadcast: Indicação se trata-se de um frame de broadcast [SWS_EthIf_00085].
• PhysAddrPtr: ponteiro para o endereço físico de origem (endereço MAC na ordem de bytes da rede) do quadro recebido [SWS_EthIf_00085].
• DataPtr: Ponteiro para os dados úteis (payload) do frame recebido [SWS_EthIf_00085].
• LenByte: comprimento dos dados úteis no quadro recebido em bytes [SWS_EthIf_00085].

Simultaneidade e restrições

A interface é declarada como não reentrante (Non Reentrant) e está disponível sob o service ID 0x10 por meio do arquivo de cabeçalho EthIf.h [SWS_EthIf_00085]. Os chamadores devem garantir que não ocorram chamadas concorrentes. Códigos de erro específicos, valores de retorno ou mensagens de DET/DEM não estão indicados no escopo da especificação para esta função.

Utilização e contexto de chamada

A função síncrona EthIf_TxConfirmation (service ID 0x11) confirma a transmissão de um quadro Ethernet pelo controlador Ethernet físico referenciado por meio de CtrlIdx [SWS_EthIf_00091]. A função não possui valor de retorno e está disponível por meio do arquivo de cabeçalho EthIf.h [SWS_EthIf_00091].

Os parâmetros de entrada são definidos como segue [SWS_EthIf_00091]:

• CtrlIdx (uint8): índice do controlador Ethernet físico no contexto da interface Ethernet.
• BufIdx (Eth_BufIdxType): índice do buffer transmitido.
• Result (Std_ReturnType): resultado da transmissão; E_OK sinaliza um processo de envio bem-sucedido, E_NOT_OK um erro de transmissão.

Interação com camadas superiores

De acordo com [SWS_EthIf_00255], EthIf_TxConfirmation encaminha o resultado de transmissão recebido Result para a camada superior configurada por meio de seu callback <UL>_TxConfirmation.

Simultaneidade e restrições

A função é especificada como não reentrante (Non Reentrant) [SWS_EthIf_00091]. Chamadas paralelas devem, portanto, ser evitadas. Mensagens de erro específicas de DET ou DEM não estão previstas no extrato da especificação; erros são transmitidos exclusivamente por meio do parâmetro Result com o valor E_NOT_OK [SWS_EthIf_00091].

A função de notificação EthIf_CtrlModeIndication é chamada de acordo com [SWS_EthIf_00231] assim que o modo de operação de um controlador Ethernet tiver sido lido com sucesso. O disparo ocorre de forma assíncrona em decorrência de uma chamada anterior de Eth_SetControllerMode, podendo a chamada ocorrer diretamente dentro das respectivas funções de trigger. A própria função possui uma semântica de execução síncrona e não fornece nenhum valor de retorno ([SWS_EthIf_00231]).

Através dos parâmetros, são passados o índice do controlador Ethernet físico no contexto da interface Ethernet (CtrlIdx), bem como o modo de controlador sinalizado (CtrlMode) ([SWS_EthIf_00231]). No que diz respeito à concorrência, [SWS_EthIf_00231] especifica que a função não é reentrante para o mesmo índice de controlador, mas pode ser executada de forma reentrante para índices diferentes.

Em relação à interação com outros módulos, requisitos relacionados apontam para ações subsequentes que, no entanto, são classificadas como obsoletas na presente release:

• De acordo com [SWS_EthIf_00267] (OBSOLETE), no contexto desta função estava previsto chamar EthSwt_SetSwitchPortMode para todas as portas de um grupo de portas de switch, desde que exista uma referência de controle correspondente, e resolver conflitos com grupos ativos em ETH_MODE_DOWN.
• De acordo com [SWS_EthIf_00413] (OBSOLETE), no contexto desta função estava previsto, havendo uma referência de transceptor, chamar EthTrcv_TransceiverLinkStateRequest com ETHTRCV_LINK_STATE_ACTIVE ou ETHTRCV_LINK_STATE_DOWN, dependendo se ETH_MODE_ACTIVE ou ETH_MODE_DOWN havia sido solicitado anteriormente.

Utilização e semântica

A função EthIf_TrcvModeIndication serve como interface de notificação da interface Ethernet, sendo chamada assim que uma mudança de modo do transceptor for lida [SWS_EthIf_00232]. Ela está disponível através do arquivo de cabeçalho EthIf.h e possui o Service ID 0x0f [SWS_EthIf_00232].

A execução da própria função está especificada como síncrona, enquanto a chamada ocorre de forma assíncrona quando a mudança de modo foi determinada [SWS_EthIf_00232]. Caso a função seja disparada por uma chamada anterior de EthTrcv_SetTransceiverMode, ela pode ser chamada diretamente dentro dessa função disparadora [SWS_EthIf_00232].

Parâmetros e valores de retorno

• TrcvIdx: Índice do transceptor Ethernet no contexto da interface Ethernet (parâmetro de entrada) [SWS_EthIf_00232].
• TrcvMode: Modo de operação sinalizado do transceptor Ethernet do tipo Eth_ModeType (parâmetro de entrada) [SWS_EthIf_00232].
• Valor de retorno: Nenhum (void) [SWS_EthIf_00232].

Concorrência e reentrância

A função é especificada como não reentrante para o mesmo índice, mas como reentrante para índices diferentes [SWS_EthIf_00232]. A tabela de especificação indica aqui Ctrl Idx, o que, no contexto desta interface de transceiver, deve ser interpretado provavelmente como uma referência ao índice do transceiver ou do controlador [SWS_EthIf_00232]. Pergunta Q-c0123f1ef0e4ec71 (aberta)

A função EthIf_SwitchPortModeIndication serve ao Ethernet Interface (EthIf) como uma interface de notificação assíncrona sobre uma mudança de modo de uma porta de switch Ethernet reportada pelo Ethernet Switch Driver [SWS_EthIf_91055].

Utilização e interação

O EthIf determina as notificações esperadas com base na configuração da respectiva porta de switch: se a porta de switch referenciar um transceptor (EthTrcv), o EthIf espera, em vez disso, uma notificação via EthIf_TrcvModeIndication(); caso contrário, a notificação do Ethernet Switch Driver é esperada via EthIf_SwitchPortModeIndication() [SWS_EthIf_91055].

• SwitchIdx: Índice do switch Ethernet no contexto do Ethernet Switch Driver [SWS_EthIf_91055].
• SwitchPortIdx: Índice da porta no switch Ethernet endereçado [SWS_EthIf_91055].
• PortMode: O novo modo reportado da porta de switch do tipo Eth_ModeType [SWS_EthIf_91055].

Propriedades de execução e restrições

A função não possui valor de retorno (void) e possui o Service ID 0x46 [SWS_EthIf_91055]. Ela é especificada como assíncrona (Asynchronous) e não reentrante (Non Reentrant) [SWS_EthIf_91055]. Os chamadores devem, portanto, garantir que chamadas concorrentes para este serviço sejam evitadas. Mensagens de erro específicas de DET ou DEM não estão definidas no payload para esta função.

Utilização e contexto de chamada

A função EthIf_SleepIndication serve como interface de notificação do Ethernet Interface. Ela é chamada pelo respectivo driver de transceiver Ethernet (EthTrcv) assim que este registrar uma indicação de sono na rede [SWS_EthIf_91006]. Como único parâmetro de entrada, é passado TrcvIdx, que identifica univocamente o índice do transceiver Ethernet sinalizador no contexto do módulo EthIf [SWS_EthIf_91006]. A função não possui parâmetros de entrada/saída nem valores de retorno e executa a notificação de forma síncrona [SWS_EthIf_91006].

Interação de hardware

Um caso de aplicação essencial é o uso com hardware Ethernet projetado em conformidade com a especificação OPEN Alliance TC10 [SWS_EthIf_91006]. Nesse cenário, o transceiver (PHY) detecta no nível de hardware uma Sleep.Indication, a qual foi acionada por uma solicitação de sono (Sleep.Request) do parceiro de enlace diretamente conectado [SWS_EthIf_91006].

Simultaneidade e restrições

A interface é definida como síncrona e reentrante, sendo disponibilizada por meio do arquivo de cabeçalho EthIf.h (Service-ID 0x68) [SWS_EthIf_91006]. Na integração do sistema, deve-se levar em consideração que o elemento está marcado como rascunho com a tag atp.Status=draft [SWS_EthIf_91006]. Rotinas concretas de tratamento de erros ou códigos de erro DET não estão definidos no escopo da especificação; presumivelmente, uma verificação formal de erros ocorrerá apenas em versões futuras da especificação. Pergunta Q-680af6c43439167f (aberta)

Utilização e contexto de chamada

A função EthIf_MainFunctionRx assume na interface Ethernet (EthIf) a tarefa central de verificar, em operação por polling, a chegada de novos quadros de dados e acionar as respectivas indicações de recepção (Reception Indications) para as camadas superiores [SWS_EthIf_00097]. Ela está definida com a assinatura void EthIf_MainFunctionRx (void), não recebendo portanto parâmetros de chamada e não fornecendo valor de retorno [SWS_EthIf_00097]. Como Service ID está estabelecido o valor hexadecimal 0x20 [SWS_EthIf_00097].

A função é disponibilizada através do arquivo de cabeçalho SchM_EthIf.h [SWS_EthIf_00097]. Isto sugere a interpretação de que a sua chamada ocorre periodicamente pelo Schedule Manager (SchM) ou pelo sistema operacional dentro de um contexto de task cíclica da Basic Software.

Simultaneidade e tratamento de erros

Como a verificação e o encaminhamento de quadros recebidos estão especificados em modo de polling [SWS_EthIf_00097], uma operação de recepção sem falhas exige um sincronismo temporal adequado da chamada. Uma execução atrasada deve provavelmente levar a atrasos no encaminhamento de mensagens recebidas para as camadas superiores de software. Pergunta Q-554ef0cf302c3aa3 (aberta) Códigos de erro específicos, erros de desenvolvimento (DET) ou mensagens de erro para o DEM não são listados na especificação para esta função.

A função principal EthIf_MainFunctionTx serve para o processamento cíclico de operações de transmissão e consultas de estado dentro do módulo de interface Ethernet [SWS_EthIf_00113]. Ela possui o Service ID hexadecimal 0x21 e, de acordo com a sua assinatura void EthIf_MainFunctionTx (void), é executada sem parâmetros de transferência e sem valor de retorno, de modo que todo o processamento ocorre baseado em estados [SWS_EthIf_00113].

Em operação contínua, o serviço assume duas tarefas centrais na comunicação Ethernet:

• Confirmações de transmissão: No modo de polling, a função emite confirmações de transmissões concluídas com sucesso (Transmission Confirmations) para camadas superiores [SWS_EthIf_00113].
• Estados do transceptor: Ela monitora e verifica o sistema quanto a alterações de estado ocorridas nos transceptores Ethernet conectados [SWS_EthIf_00113].

Em relação à integração do sistema, a interface está disponível através do arquivo de cabeçalho SchM_EthIf.h [SWS_EthIf_00113]. Interpretação: Da disponibilização através de SchM_EthIf.h deve decorrer que a chamada é realizada periodicamente pelo escalonador da BSW (SchM) no contexto de uma tarefa cíclica. Pergunta Q-b9dde07f9cc74a95 (aberta) Isso garante que confirmações de transmissão pendentes no modo de polling e mudanças de estado do transceptor sejam processadas regularmente e sem dependência de interrupções.

Códigos de erro específicos, rotinas dedicadas de tratamento de erros via DET ou DEM, bem como requisitos de reentrância não estão definidos no presente escopo da especificação para este serviço e, portanto, não são informados.

Utilização e semântica

A função EthIf_MainFunctionState serve para a consulta cíclica (polling) de informações de estado e diagnóstico do hardware de comunicação Ethernet conectado, como transceivers Ethernet e portas de switch Ethernet [SWS_EthIf_91104]. Isso inclui, por exemplo, o estado da conexão (Link State) e a qualidade do sinal [SWS_EthIf_91104]. A função não possui parâmetros de entrada nem de saída e não retorna nenhum valor (void EthIf_MainFunctionState(void), Service-ID 0x05) [SWS_EthIf_91104]. O comportamento de execução é especificado como assíncrono [SWS_EthIf_91104].

Simultaneidade e condições de chamada

A função é definida como não reentrante (Non Reentrant) [SWS_EthIf_91104]. Portanto, ela não deve, em momento algum, ser executada em paralelo ou interrompendo a si mesma. Como a interface é disponibilizada por meio do arquivo de cabeçalho EthIf_SchM.h [SWS_EthIf_91104], a chamada periódica normalmente deve ocorrer no contexto de tarefa do escalonador da BSW (SchM). Pergunta Q-10d02355b276be90 (aberta)

Interação e configuração

De acordo com [SWS_EthIf_00407], EthIf_MainFunctionState deve consultar as informações de hardware estritamente com a periodicidade configurada EthIfMainFunctionStatePeriod. Isso assegura uma atualização regular dos parâmetros de interface física no Ethernet Interface.

A estrutura de dados EthIf_SignalQualityResultType ([SWS_EthIf_91057]) serve para aquisição e diagnóstico da qualidade de conexão ao nível de Ethernet e é disponibilizada através do arquivo de cabeçalho EthIf.h.

A estrutura agrupa três grandezas de medição do tipo básico uint32:

• ActualSignalQuality: representa a qualidade de sinal atualmente presente da conexão Ethernet.
• HighestSignalQuality: registra a qualidade de sinal mais alta medida da conexão desde a última reinicialização.
• LowestSignalQuality: documenta a qualidade de sinal mais baixa medida da conexão desde a última reinicialização.

Na interação com o módulo EthIf, os valores extremos refletem o histórico da estabilidade da conexão. A reinicialização dos valores históricos armazenados internamente é controlada através de interfaces dedicadas:

• Para um transceptor especificado via TrcvIdx, a função EthIf_ClearTrcvSignalQuality reinicializa os valores de qualidade de sinal armazenados ([SWS_EthIf_00400]).
• Para uma porta de switch identificada via SwitchIdx e SwitchPortIdx, EthIf_ClearSwitchPortSignalQuality apaga os valores de qualidade de sinal armazenados ([SWS_EthIf_00404]).

Interpretação: Como o payload não cita uma função de leitura específica, a estrutura presumivelmente deve servir como parâmetro de saída de consultas de status correspondentes para transceptores e portas de switch, a fim de comparar a qualidade de sinal atual com os valores extremos. Pergunta Q-8e5f2914bade574c (aberta)