Ethernet Interface (EthIf)

Uso y semántica

La función EthIf_Init inicializa el módulo de interfaz Ethernet ([SWS_EthIf_00024]). Se ejecuta de forma síncrona, no es reentrante (Non Reentrant) y está disponible a través del archivo de cabecera EthIf.h con el Service ID 0x01. Como único parámetro de transferencia, la función espera el puntero CfgPtr, que apunta a una estructura de configuración específica de la implementación de tipo EthIf_ConfigType. No existen parámetros inout ni out, y la función no posee valor de retorno ([SWS_EthIf_00024]).

Concurrencia y contexto de llamada

Dado que EthIf_Init no es reentrante, no debe realizarse ninguna llamada concurrente ni anidada [SWS_EthIf_00024]. Dado que el contexto de llamada específico no se describe en detalle en el payload, es probable que la llamada tenga lugar típicamente una sola vez durante la secuencia de inicialización de la ECU antes de recurrir a otros servicios Ethernet. Pregunta Q-07e92f9f3c15ea5b (abierta)

Condiciones de secuencia e interacción

La llamada a EthIf_Init constituye el requisito indispensable para la utilización de todas las demás funciones del módulo. Siempre que la detección de errores de desarrollo (Development Error Detection) esté activada, numerosos servicios de la interfaz Ethernet comprueban antes de su ejecución si se ha llamado previamente a EthIf_Init:

• Si no se ha llevado a cabo la inicialización, las funciones dependientes notifican el error de desarrollo ETHIF_E_UNINIT (por ejemplo, [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] y [SWS_EthIf_00304]).
• Varias interfaces cancelan la ejecución en caso de omitirse la inicialización y devuelven adicionalmente el valor de error E_NOT_OK (como por ejemplo [SWS_EthIf_00246], [SWS_EthIf_00273] y [SWS_EthIf_00277]).

usar

La función EthIf_SetControllerMode activa o desactiva el controlador Ethernet indicado mediante CtrlIdx en el contexto de la interfaz Ethernet [SWS_EthIf_00034]. A través del parámetro CtrlMode se solicitan los siguientes estados [SWS_EthIf_00034]:

• ETH_MODE_DOWN: desactiva el controlador.
• ETH_MODE_ACTIVE: Activa el controlador.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: Activa el controlador y solicita un despertar (Wake-up) en la red.

La función opera de forma asíncrona [SWS_EthIf_00034]. Devuelve E_OK en caso de ejecución correcta o E_NOT_OK si no se pudo cambiar el modo del controlador [SWS_EthIf_00034].

Interacción y reenvío

Si se llama a EthIf_SetControllerMode con ETH_MODE_ACTIVE para un controlador que referencia a un EthIfSwitchPortGroup de tipo «control», EthIf reenvía la llamada a todos los puertos del grupo, siempre que este modo se solicite por primera vez para el puerto y su estado sea ETH_MODE_DOWN. En este proceso se ejecutan sucesivamente EthSwt_SetSwitchPortMode con ETH_MODE_ACTIVE y EthSwt_PortLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE [SWS_EthIf_00264].

Al solicitarse ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, EthIf reenvía las llamadas independientemente del modo actual de la siguiente manera:

• En caso de referencia a un EthIfTransceiver: llamada de EthTrcv_SetTransceiverMode con ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST y a continuación EthTrcv_TransceiverLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE si el estado actual es ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00479].
• En caso de referencia a un EthIfSwitch o a un EthIfSwitchPortGroup de tipo «control»: llamada de EthSwt_SetSwitchPortMode con ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST y a continuación EthSwt_PortLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE si el estado actual es ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00480], [SWS_EthIf_00481].

restricciones

La función no es reentrante (Non Reentrant) y está disponible a través de EthIf.h [SWS_EthIf_00034].

La función síncrona y no reentrante EthIf_SetTransceiverWakeupMode (ID de servicio 0x2e) sirve para establecer el modo de wake-up de un transceptor direccionado mediante TrcvIdx en el Ethernet Interface o para restablecer su causa de wake-up [SWS_EthIf_00233]. La función está declarada en el archivo de cabecera EthIf.h y clasificada como obsoleta (obsolete) en el release AUTOSAR CP R20-11 [SWS_EthIf_00233].

El control se realiza mediante el parámetro de transferencia TrcvWakeupMode [SWS_EthIf_00233]:

• ETHTRCV_WUM_ENABLE: activa el despertar del transceptor [SWS_EthIf_00233]. Si el controlador asignado EthIfTransceiverIdx se encuentra actualmente en el estado ETHTRCV_WUM_DISABLE, la llamada se reenvía a EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE: desactiva el despertar del transceptor [SWS_EthIf_00233]. Siempre que el estado actual del controlador sea ETHTRCV_WUM_ENABLE, la función reenvía la llamada a EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR: borra la causa de wake-up del transceptor indexado [SWS_EthIf_00233].

Como valor de retorno, la llamada devuelve E_OK en caso de ejecución correcta o E_NOT_OK si no se pudo cambiar el modo de wake-up o no se pudo borrar la causa de wake-up [SWS_EthIf_00233]. Dado que la interfaz está definida como no reentrante, las llamadas concurrentes no están permitidas [SWS_EthIf_00233].

La función EthIf_CheckWakeup solicita al hardware Ethernet afectado que compruebe un wake-up señalizado [SWS_EthIf_00244]. Esto se utiliza, por ejemplo, para hardware Ethernet conforme con la especificación OPEN Alliance TC10 [SWS_EthIf_00244]. La llamada la realiza el código de integración de forma asíncrona y reentrante, opcionalmente en el contexto de una interrupción o a nivel de tarea [SWS_EthIf_00244].

Como parámetro de entrada sirve WakeupSource de tipo EcuM_WakeupSourceType, el cual designa el dispositivo de origen desencadenante (transceptor Ethernet o switch Ethernet) [SWS_EthIf_00244]. El valor de retorno es E_OK si se aceptó la solicitud de comprobación al hardware; en caso contrario, es E_NOT_OK ante el rechazo de la solicitud [SWS_EthIf_00244]. El módulo reenvía internamente la llamada a los controladores subyacentes:

• Para todos los transceptores Ethernet afectados (referenciados mediante EthIfTransceiver o EthIfSwitchPortGroups), se llama a EthTrcv_CheckWakeup del controlador de transceptor respectivo [SWS_EthIf_00245].
• Para todos los switches Ethernet afectados (referenciados mediante EthIfSwitch), se llama a EthSwt_SwitchCheckWakeup del controlador de switch correspondiente [SWS_EthIf_00500].

La disponibilidad de EthIf_CheckWakeup se puede activar y desactivar en tiempo de precompilación mediante el parámetro de configuración EthIfWakeUpSupport [SWS_EthIf_00248]. La API se proporciona a través de la cabecera EthIf.h [SWS_EthIf_00244].

La función síncrona EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) sirve para actualizar el filtro de direcciones para el controlador de Ethernet especificado a través de CtrlIdx. Mediante el parámetro Action (del tipo Eth_FilterActionType) se añade o se elimina una dirección física del filtro.

Para la configuración, PhysAddrPtr espera un puntero a la dirección MAC física en orden de bytes de red, la cual representa la dirección de destino multicast del paquete de Ethernet de capa 2 [SWS_EthIf_00139]. Aunque la descripción textual de la función habla de una dirección de origen, es probable que se trate de un descuido editorial, ya que la especificación de parámetros establece de manera vinculante la dirección de destino multicast. Pregunta Q-312e20e5eadda94a (abierta)

En cuanto al flujo y a las restricciones, rigen las siguientes especificaciones [SWS_EthIf_00139]:

• Valores de retorno: La función devuelve E_OK si la configuración del filtro se modificó correctamente, o E_NOT_OK si la modificación falló. No hay definidos códigos de error DET o DEM específicos en las fuentes.
• Soporte de hardware: Si el controlador de Ethernet subyacente no es capaz de realizar el filtrado por hardware, el software debe asumir esta tarea de filtrado.
• Concurrencia: La llamada no es reentrante para el mismo índice de controlador (CtrlIdx), pero se permite ejecutarla de forma concurrente para diferentes controladores.

Uso y contexto de llamada

La función EthIf_StoreConfiguration sirve para solicitar el guardado persistente de las tablas de MAC/puerto aprendidas de un switch de Ethernet [SWS_EthIf_00214]. Como invocador típico se menciona, por ejemplo, un Complex Device Driver (CDD) [SWS_EthIf_00214]. La interfaz es accesible a través del archivo de encabezado EthIf.h y posee el Service ID 0x2c [SWS_EthIf_00214].

A través del parámetro de entrada SwitchIdx se pasa el índice del switch de destino en el contexto del controlador del switch de Ethernet [SWS_EthIf_00214]. Como valor de retorno, la función proporciona el estado Std_ReturnType: el valor E_OK indica que la solicitud de guardado fue aceptada, mientras que E_NOT_OK señaliza la no aceptación [SWS_EthIf_00214]. Dado que la especificación califica la ejecución como síncrona/asíncrona, es probable que la recepción de la solicitud se realice de forma síncrona, mientras que la persistencia propiamente dicha presumiblemente se procesa de forma asíncrona en módulos posteriores. Pregunta Q-4f10e936c7d30258 (abierta)

Restricciones y tratamiento de errores

En cuanto a la concurrencia, EthIf_StoreConfiguration está especificada como no reentrante (Non Reentrant) [SWS_EthIf_00214]. Por tanto, las llamadas paralelas deben evitarse o sincronizarse en el lado del invocador. No hay definidos mensajes de error DET o DEM específicos para esta interfaz; un error en la aceptación de la solicitud se notifica exclusivamente a través del valor de retorno E_NOT_OK [SWS_EthIf_00214].

Uso y contexto de llamada

La función EthIf_ResetConfiguration sirve para solicitar el restablecimiento persistente de las tablas de MAC y de puerto aprendidas dinámicamente de un switch de Ethernet [SWS_EthIf_00219]. Las entradas configuradas estáticamente permanecen inalteradas en la configuración [SWS_EthIf_00219]. Como invocador de esta interfaz puede actuar, por ejemplo, un Complex Device Driver (CDD) [SWS_EthIf_00219].

A través del parámetro de transferencia SwitchIdx se especifica el índice del switch afectado en el contexto del controlador del switch de Ethernet [SWS_EthIf_00219]. En cuanto a la semántica de ejecución, la operación se indica como síncrona/asíncrona [SWS_EthIf_00219]; esto probablemente signifique que la recepción de la solicitud se confirma de forma síncrona, mientras que el restablecimiento de las tablas de hardware se ejecuta de forma asíncrona. Pregunta Q-9e7f89ec9e809fd0 (abierta)

Valores de retorno y tratamiento de errores

Como valor de retorno, la función proporciona un estado de tipo Std_ReturnType [SWS_EthIf_00219]:

• E_OK: La solicitud de restablecimiento persistente de la tabla de MAC/puerto fue aceptada con éxito [SWS_EthIf_00219].
• E_NOT_OK: La solicitud fue rechazada [SWS_EthIf_00219].

En el alcance de la especificación presente no hay documentados mensajes de error DET o DEM específicos para esta función.

Concurrencia y restricciones

La interfaz está especificada como no reentrante (Non Reentrant) [SWS_EthIf_00219]. Por lo tanto, los invocadores deben asegurarse de que no se produzcan llamadas simultáneas ni interrumpidas. La función está incluida a través del archivo de encabezado EthIf.h [SWS_EthIf_00219].

La función síncrona EthIf_EnableEgressTimeStamp sirve para activar el registro de marcas de tiempo de transmisión (Egress Time Stamping) para un objeto de mensaje dedicado o un búfer de transmisión [SWS_EthIf_00160]. La interfaz se proporciona a través del archivo de cabecera EthIf.h [SWS_EthIf_00160].

Parámetros y llamada

Al invocarse, la función espera la transferencia de dos parámetros de entrada [SWS_EthIf_00160]:

• CtrlIdx: Índice del controlador Ethernet direccionado [SWS_EthIf_00160].
• BufIdx: índice del búfer de mensajes en el que la aplicación espera el registro de la marca de tiempo de transmisión [SWS_EthIf_00160].

La función no posee valor de retorno (void) ni parámetros de entrada o de salida [SWS_EthIf_00160].

Comportamiento del hardware y concurrencia

El comportamiento del hardware difiere según el controlador: algunos tipos de hardware guardan de forma permanente la marca para la marca de tiempo de transmisión tras una configuración única, mientras que otros controladores la requieren obligatoriamente antes de cada transmisión individual [SWS_EthIf_00160]. Interpretación: en controladores sin almacenamiento permanente, es de suponer que la aplicación tenga que invocar nuevamente la función antes de cada proceso de envío. De acuerdo con la especificación, no existe la posibilidad de desactivación, ya que el tipo de mensaje correspondiente recibe marcas de tiempo de forma permanente según el diseño de la red [SWS_EthIf_00160]. Pregunta Q-e87b424598f8a684 (abierta)

En cuanto a la concurrencia, la función está definida como no reentrante (Non Reentrant) [SWS_EthIf_00160].

La función asíncrona EthIf_SwitchPortGroupRequestMode solicita un modo de funcionamiento para un grupo de puertos de switch ([SWS_EthIf_91102]). La llamada está especificada como no reentrante y transfiere el índice del grupo de puertos (PortGroupIdx), así como el modo de destino deseado (PortMode). Como modos están disponibles ETH_MODE_DOWN para la desactivación, ETH_MODE_ACTIVE para la activación y ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST para la activación con wake-up de red ([SWS_EthIf_91102]). En caso de iniciación correcta, la función devuelve E_OK; en caso contrario, E_NOT_OK ([SWS_EthIf_91102]).

En principio, EthIf reenvía la solicitud al switch subyacente llamando a EthSwt_SetSwitchPortMode para todos los puertos referenciados ([SWS_EthIf_91102]). Para los diferentes modos se aplican reglas de comportamiento específicas:

• Desactivación (ETH_MODE_DOWN): si los puertos se encuentran actualmente en el estado ETH_MODE_ACTIVE y se ha solicitado ETH_MODE_DOWN para todos los grupos que referencian los puertos, EthIf inicia un temporizador con el tiempo de retardo EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Activación (ETH_MODE_ACTIVE o ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): un temporizador de retardo de apagado en ejecución para los puertos del respectivo grupo de puertos se cancela inmediatamente ([SWS_EthIf_00483]).
• Solicitud de wake-up (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): la llamada se reenvía obligatoriamente en un orden fijo para todos los puertos del grupo, independientemente del modo actual del puerto: primero se llama a EthSwt_SetSwitchPortMode con ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, seguido de EthSwt_PortLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE, siempre que el estado de enlace actual sea ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00482]).

No se recogen mensajes de error específicos de DET o DEM para este servicio; el fallo de un cambio de modo se indica directamente a través del valor de retorno E_NOT_OK ([SWS_EthIf_91102]).

La función EthIf_StartAllPorts sirve para solicitar el paso de todos los puertos de switch Ethernet configurados y afectados al estado ETH_MODE_ACTIVE ([SWS_EthIf_91103]). La llamada se realiza sin parámetros, posee una semántica asíncrona y está especificada como reentrante ([SWS_EthIf_91103]). Como valor de retorno, E_OK señaliza la aceptación de la solicitud, mientras que E_NOT_OK indica un rechazo ([SWS_EthIf_91103]).

Tras la llamada de EthIf_StartAllPorts, EthIf reenvía los comandos de control a todos los puertos afectados de los switches Ethernet (EthSwtPorts) en un orden fijamente definido ([SWS_EthIf_00275]):

• En primer lugar, se llama a EthSwt_SetSwitchPortMode con ETH_MODE_ACTIVE, siempre que el modo actual sea ETH_MODE_DOWN ([SWS_EthIf_00275]).
• A continuación, se produce la llamada de EthSwt_PortLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE en caso de que el estado de enlace actual sea ETHTRCV_LINK_STATE_DOWN, y para todos estos puertos se inicia un temporizador con el intervalo de tiempo EthIfPortStartupActiveTime ([SWS_EthIf_00275]).

Si un puerto activado de esta manera no se solicita regularmente con ETH_MODE_ACTIVE dentro del intervalo de tiempo EthIfPortStartupActiveTime, EthIf vuelve a desactivar automáticamente dicho puerto ([SWS_EthIf_00276]). La desactivación se lleva a cabo de forma vinculante en orden inverso:

• Primero se llama a EthSwt_PortLinkStateRequest con ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00276]).
• Posteriormente se llama a EthSwt_SetSwitchPortMode con ETH_MODE_DOWN ([SWS_EthIf_00276]).

La función EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) activa el registro de marcas de tiempo de salida (egress) para un objeto de mensaje específico a nivel de switch. El objeto de transmisión correspondiente se direcciona a través del índice de controlador CtrlIdx así como del índice de búfer BufIdx.

Invocación y parámetros

La llamada se realiza de forma síncrona ([SWS_EthIf_91007]). Como parámetros de entrada, la función espera el índice de controlador CtrlIdx dentro del contexto de EthIf, así como BufIdx para el búfer de mensajes en el que la aplicación espera el sellado de tiempo. A través del parámetro de salida MgmtInfo de tipo EthSwt_MgmtInfoType* se proporcionan informaciones de gestión asociadas ([SWS_EthIf_91007]).

Valores de retorno y comportamiento

La función señaliza el resultado a través de un valor de retorno de tipo Std_ReturnType ([SWS_EthIf_91007]):

• E_OK: el sellado de tiempo de salida (egress time stamping) se activó correctamente ([SWS_EthIf_91007]).
• E_NOT_OK: la activación del sellado de tiempo ha fallado ([SWS_EthIf_91007]).

Restricciones y concurrencia

La interfaz está especificada como no reentrante (Non Reentrant) ([SWS_EthIf_91007]). Por tanto, los llamadores deben garantizar que se eviten las llamadas paralelas. La declaración se proporciona a través de la cabecera EthIf.h ([SWS_EthIf_91007]).

La función de interfaz síncrona EthIf_VerifyConfig sirve para comprobar la configuración del switch y reenvía la llamada directamente a EthSwt_VerifyConfig [SWS_EthIf_91012]. La verificación real es realizada por el controlador del switch de Ethernet en función de la arquitectura de hardware respectiva, las capacidades del hardware y la precisión de comprobación prevista [SWS_EthIf_91012].

Uso y parámetros

La función está disponible a través del encabezado EthIf.h con el Service ID 0x40 y espera dos parámetros [SWS_EthIf_91012]:

• SwitchIdx (in): índice del switch en el contexto del controlador de switch de Ethernet.
• Result (out): Puntero a un valor booleano que recibe el resultado de la verificación. TRUE identifica una configuración verificada correctamente, mientras que FALSE indica daños detectados.

Como valor de retorno, Std_ReturnType notifica el estado de la ejecución: E_OK señaliza que la verificación finalizó con éxito, mientras que E_NOT_OK indica un fallo en la comprobación de la configuración [SWS_EthIf_91012].

Concurrencia y tratamiento de errores

La función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91012]. Por tanto, los invocadores deben asegurarse de que no tengan lugar llamadas concurrentes. Dado que el payload no incluye códigos de error específicos para DET o DEM, es probable que las comprobaciones detalladas de parámetros (como la validación de índices o punteros) se traten presumiblemente en el lado del controlador o de manera específica de la implementación. Pregunta Q-03b5f343e97bec7f (abierta)

La función síncrona EthIf_SetForwardingMode se proporciona a través del encabezado EthIf.h y sirve para el control del reenvío de tramas en un switch de Ethernet [SWS_EthIf_91013]. Verifica la configuración actual del switch y, si se detecta invalidez, realiza una reconfiguración del switch [SWS_EthIf_91013].

Parámetros y valores de retorno

En la llamada (Service ID 0x41) se transfieren los siguientes parámetros de entrada [SWS_EthIf_91013]:

• SwitchIdx: Índice del switch en cuestión en el contexto del controlador del switch de Ethernet [SWS_EthIf_91013].
• mode: Conmutador booleano para activar (TRUE) o desactivar (FALSE) el reenvío de tramas [SWS_EthIf_91013].

Como valor de retorno, la función proporciona Std_ReturnType [SWS_EthIf_91013]:

• E_OK: Según la especificación, señalizaba la detención correcta del reenvío; interpretación: Es probable que esto confirme, de forma más general, la asunción correcta del modo de reenvío solicitado [SWS_EthIf_91013]. Pregunta Q-f245de852fe854c0 (abierta)
• E_NOT_OK: La conmutación o la detención del reenvío de tramas ha fallado [SWS_EthIf_91013].

Concurrencia y restricciones

La función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91013]. Por lo tanto, los invocadores deben asegurarse de que las llamadas para el mismo contexto de switch o para contextos de switch paralelos se realicen de forma serializada y no tengan lugar llamadas concurrentes. No hay definidos códigos de error específicos para DET o DEM para este servicio en el estándar.

La función EthIf_ClearTrcvSignalQuality sirve para el borrado síncrono de los valores de calidad de señal almacenados de un enlace de Ethernet para un transceptor determinado [SWS_EthIf_91059]. Para ello, el invocador transfiere con el parámetro TrcvIdx el índice del transceptor en el contexto del Ethernet Interface, tras lo cual se borran los valores de medición correspondientes [SWS_EthIf_00400].

Como valor de retorno, la interfaz suministra el tipo Std_ReturnType: Si el restablecimiento de la calidad de la señal fue correcto, se notifica E_OK; de lo contrario, el proceso falla con E_NOT_OK [SWS_EthIf_91059]. Interpretación: Es probable que el valor de error E_NOT_OK se deba presumiblemente a parámetros de índice no válidos o a fallos en el reenvío a controladores subyacentes, ya que el payload no menciona códigos de error ni entradas DET específicos. Pregunta Q-40d8f0c1fc7ba11e (abierta)

En cuanto a la concurrencia, el servicio está implementado de forma reentrante para diferentes índices de transceptor, pero es explícitamente no reentrante para el mismo TrcvIdx [SWS_EthIf_91059]. Por lo tanto, no deben producirse múltiples llamadas para el transceptor idéntico de manera simultánea desde contextos concurrentes y deben protegerse en consecuencia.

En la interacción de módulos, la llamada borra de forma selectiva los valores de calidad de señal almacenados del tipo EthIf_SignalQualityResultType para el EthIfTransceiver direccionado a través de TrcvIdx [SWS_EthIf_00400]. La declaración de la interfaz síncrona con el Service ID 0x19 se proporciona a través del encabezado EthIf.h [SWS_EthIf_91059].

usar

La función síncrona EthIf_ClearSwitchPortSignalQuality sirve para restablecer los valores de calidad de señal almacenados para el enlace de un puerto de switch de Ethernet determinado [SWS_EthIf_91060]. El direccionamiento del puerto de destino se realiza a través de los dos parámetros de entrada SwitchIdx (índice del switch de Ethernet) y SwitchPortIdx (índice del puerto dentro del contexto de interfaz) [SWS_EthIf_91060]. La función está disponible a través del archivo de encabezado EthIf.h [SWS_EthIf_91060].

Interacción y estructuras de datos

Según [SWS_EthIf_00404], la llamada borra los valores de calidad de señal mantenidos internamente del puerto de switch direccionado, los cuales corresponden al tipo EthIf_SignalQualityResultType. Esto permite a los módulos de nivel superior descartar de forma selectiva mediciones históricas e iniciar una nueva evaluación de la calidad del enlace.

Manejo de errores

El éxito de la operación se indica mediante el valor de retorno de tipo Std_ReturnType: en caso de eliminación correcta, la función devuelve E_OK; en caso contrario, E_NOT_OK [SWS_EthIf_91060]. No se definen códigos de error DET o DEM específicos en el payload. Interpretación: es probable que el valor de retorno E_NOT_OK se produzca en particular cuando se pasan índices no válidos o cuando el controlador de switch subyacente no puede ejecutar el restablecimiento. Pregunta Q-fc42f5b3e5414f6a (abierta)

Concurrencia y restricciones

En cuanto a la reentrancia, EthIf_ClearSwitchPortSignalQuality es reentrante para diferentes índices de switch y de puerto de switch [SWS_EthIf_91060]. Sin embargo, para el mismo puerto de switch (SwitchPortIdx), la función está especificada como no reentrante [SWS_EthIf_91060]. Por lo tanto, los llamadores deben asegurarse de evitar llamadas simultáneas para el mismo puerto o protegerlas mediante mecanismos de sincronización adecuados.

La función de interfaz síncrona EthIf_SetPhyTestMode sirve para activar un modo de prueba predeterminado en un transceptor de Ethernet [SWS_EthIf_91016]. El servicio está declarado en el archivo de encabezado EthIf.h y es identificable a través del Service ID hexadecimal 0x17 [SWS_EthIf_91016].

Para la llamada, la función espera la transferencia de dos parámetros de entrada [SWS_EthIf_91016]:

• TrcvIdx: Determina el índice numérico del transceptor de destino en el contexto del Ethernet Interface [SWS_EthIf_91016].
• Mode: Define el modo de prueba concreto a activar del tipo EthTrcv_PhyTestModeType [SWS_EthIf_91016].

No existen parámetros de entrada y salida [SWS_EthIf_91016]. Como valor de retorno, el servicio suministra un estado del tipo Std_ReturnType [SWS_EthIf_91016]. El valor de retorno E_OK confirma que la solicitud de activación del modo de prueba fue aceptada con éxito [SWS_EthIf_91016]. Por el contrario, el valor E_NOT_OK indica que la solicitud fue rechazada y que el modo de prueba no se pudo activar [SWS_EthIf_91016].

En cuanto a la concurrencia, EthIf_SetPhyTestMode está especificada como reentrante para diferentes índices de transceptor (TrcvIdx) [SWS_EthIf_91016]. Para el mismo índice de transceptor, la ejecución es explícitamente no reentrante [SWS_EthIf_91016]. Por lo tanto, los invocadores deben asegurarse de evitar llamadas concurrentes para la misma instancia de transceptor y, en su lugar, coordinarlas de forma secuencial.

usar

La función síncrona EthIf_SetPhyLoopbackMode sirve para la activación de un modo de bucle de retorno especificado en un transceptor de Ethernet [SWS_EthIf_91018]. La declaración está disponible a través del archivo de encabezado EthIf.h [SWS_EthIf_91018].

En la llamada, la función espera dos parámetros de entrada:

• TrcvIdx: Índice del transceptor en el contexto del Ethernet Interface [SWS_EthIf_91018].
• Mode: El modo de bucle de retorno a activar del tipo EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

Como valor de retorno, la función proporciona un estado del tipo Std_ReturnType: E_OK señaliza que la solicitud fue aceptada, mientras que E_NOT_OK indica que la solicitud no pudo ser aceptada [SWS_EthIf_91018]. Interpretación: Es probable que la función reenvíe la llamada de forma síncrona al controlador del transceptor de Ethernet responsable de TrcvIdx. Pregunta Q-c4736bbfd250cca0 (abierta)

Manejo de errores

No hay definidos códigos de error específicos, como mensajes DET o eventos DEM, en el extracto de la especificación. Si la aceptación de la solicitud falla, esto se comunica inmediatamente al invocador a través del valor de retorno E_NOT_OK [SWS_EthIf_91018]. Los invocadores deben comprobar este valor de retorno antes de continuar con las secuencias de prueba o diagnóstico posteriores.

Concurrencia y restricciones

La función es reentrante para diferentes índices de transceptor (TrcvIdx), pero explícitamente no reentrante para el mismo índice de transceptor [SWS_EthIf_91018]. Por lo tanto, los invocadores deben asegurarse de evitar llamadas simultáneas para la misma instancia de transceptor o de asegurarlas mediante mecanismos de sincronización adecuados [SWS_EthIf_91018].

La función de interfaz síncrona EthIf_SetPhyTxMode sirve para activar un modo de transmisión especificado para un transceptor Ethernet [SWS_EthIf_91005]. La declaración de la función se realiza en el archivo de cabecera EthIf.h bajo el ID de servicio 0x13 [SWS_EthIf_91005].

Para la llamada, la función espera dos parámetros de entrada [SWS_EthIf_91005]:

• TrcvIdx: índice numérico del transceptor en cuestión en el contexto de la interfaz Ethernet.
• Mode: el modo de transmisión concreto que se va a activar, de tipo EthTrcv_PhyTxModeType.

La ejecución se realiza de forma síncrona. Como valor de retorno, la función proporciona un estado de tipo Std_ReturnType [SWS_EthIf_91005]. El valor E_OK confirma la aceptación correcta de la solicitud, mientras que E_NOT_OK señaliza que la solicitud no pudo ser aceptada [SWS_EthIf_91005]. En los datos de especificación no se indican códigos de error específicos ni notificaciones a la gestión de errores de desarrollo (DET) o a la gestión de eventos de diagnóstico (DEM).

En cuanto al comportamiento de concurrencia, EthIf_SetPhyTxMode es reentrante para diferentes índices de transceptor (TrcvIdx) [SWS_EthIf_91005]. Sin embargo, si se realizan llamadas para el mismo índice de transceptor, la función está definida como no reentrante y requiere una llamada sincronizada o secuencial [SWS_EthIf_91005].

Como restricción formal, debe tenerse en cuenta que este elemento de interfaz está marcado con el estado draft en la especificación AUTOSAR CP R20-11 [SWS_EthIf_91005].

La función síncrona y reentrante EthIf_ProvideTxBuffer (ID de servicio 0x09) concede acceso a un búfer de transmisión del controlador Ethernet indicado mediante CtrlIdx y está disponible a través del encabezado EthIf.h [SWS_EthIf_00067].

Para la solicitud de búfer, el invocador transfiere el índice del controlador (CtrlIdx), el tipo de trama Ethernet (FrameType), así como la prioridad (Priority) para el campo PCP de 3 bits de la etiqueta VLAN [SWS_EthIf_00067]. Mediante el parámetro de entrada y salida LenBytePtr, el invocador especifica el tamaño de búfer deseado en bytes y recibe de vuelta la longitud proporcionada realmente [SWS_EthIf_00067]. En caso de asignación correcta, la función proporciona a través de BufPtr un puntero al búfer y mediante BufIdxPtr el índice del recurso de búfer para solicitudes posteriores [SWS_EthIf_00067].

El resultado de la solicitud de búfer se notifica mediante el tipo de retorno BufReq_ReturnType [SWS_EthIf_00067]:

• BUFREQ_OK: el búfer se proporcionó correctamente [SWS_EthIf_00067].
• BUFREQ_E_BUSY: Todos los recursos de búfer están actualmente ocupados [SWS_EthIf_00067].
• BUFREQ_E_OVFL: la longitud de búfer solicitada supera el tamaño disponible [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK: Se detectó un error de desarrollo [SWS_EthIf_00067].

La función síncrona EthIf_Transmit desencadena la transmisión de un búfer de envío previamente provisto y completado a través de la interfaz Ethernet [SWS_EthIf_00075].

Uso y parámetros

La llamada se efectúa a través de la interfaz declarada en EthIf.h con los siguientes parámetros de transferencia [SWS_EthIf_00075]:

• CtrlIdx: índice del controlador Ethernet en el contexto del módulo EthIf.
• BufIdx: índice del recurso de búfer que se va a transmitir.
• FrameType: tipo de trama Ethernet.
• TxConfirmation: controla la activación de la confirmación de envío.
• LenByte: longitud de datos en bytes.
• PhysAddrPtr: dirección física de destino (dirección MAC) en orden de bytes de red (network byte order).

Valores de retorno y concurrencia

Como valor de retorno, la función suministra E_OK en caso de inicio correcto de la transmisión o E_NOT_OK si la transmisión ha fallado [SWS_EthIf_00075]. La función es reentrante para llamadas con diferentes índices de búfer y de controlador (BufIdx y CtrlIdx) [SWS_EthIf_00075].

La función EthIf_SwitchPortGetLinkState sirve, según [SWS_EthIf_91109], para consultar el estado de enlace actual de un determinado puerto de switch. Se transfieren el índice de switch SwitchIdx en el contexto del controlador de switch Ethernet, así como el índice de puerto SwitchPortIdx en el switch direccionado. El resultado de la consulta se proporciona a través del puntero LinkStatePtr, que adopta o bien ETHTRCV_LINK_STATE_DOWN (puerto desconectado) o bien ETHTRCV_LINK_STATE_ACTIVE (puerto conectado). La especificación clasifica el comportamiento de ejecución como síncrono o asíncrono; es de suponer que esto depende del controlador de switch subyacente o de la conexión de hardware. Pregunta Q-dde6f9e8f1b8ba52 (abierta)

Como valor de retorno, la función proporciona Std_ReturnType ([SWS_EthIf_91109]). En caso de consulta correcta, se devuelve E_OK. Si la determinación del estado de enlace falla o si se llama a la función mientras el switch se encuentra en el estado ETHSWT_STATE_UNINIT o ETHSWT_STATE_INIT, se devuelve E_NOT_OK.

En cuanto a la concurrencia, la función está especificada como no reentrante (Non Reentrant) ([SWS_EthIf_91109]), por lo que deben excluirse las llamadas simultáneas en el mismo contexto. La declaración está disponible a través del encabezado EthIf.h con el ID de servicio 0x4b.

usar

La función síncrona EthIf_TransceiverGetLinkState sirve para consultar el estado de enlace actual (Link State) de un transceptor Ethernet direccionado a través de TrcvIdx conforme a [SWS_EthIf_91110]. La declaración de la interfaz se pone a disposición a través del encabezado EthIf.h [SWS_EthIf_91110].

En la llamada se transfieren los siguientes parámetros [SWS_EthIf_91110]:

• TrcvIdx (entrada): índice del transceptor en el contexto del Ethernet Transceiver Driver.
• LinkStatePtr (salida): puntero a la ubicación de memoria para el estado determinado de tipo EthTrcv_LinkStateType. Los posibles valores de resultado son ETHTRCV_LINK_STATE_ACTIVE para un transceptor conectado y ETHTRCV_LINK_STATE_DOWN para un transceptor desconectado.

Como valor de retorno, la función proporciona el código de estado de tipo Std_ReturnType: E_OK señala una ejecución correcta, mientras que E_NOT_OK indica que el transceptor no se pudo inicializar [SWS_EthIf_91110].

Tratamiento de errores y condiciones límite

Si la consulta falla, el servicio con el ID de servicio 0x4c proporciona el valor de retorno E_NOT_OK [SWS_EthIf_91110]. No se indican mensajes de error DET o DEM específicos en la especificación de la función.

concurrencia

La función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91110]. Interpretación: debido a la falta de reentrancia, es de suponer que no está permitida una llamada simultánea desde varios hilos o contextos de tarea y requiere sincronización por parte del llamador en caso necesario. Pregunta Q-0459aa9b4c187439 (abierta)

La función EthIf_SwitchPortGetBaudRate sirve para consultar la velocidad de transmisión actual de un determinado puerto de switch Ethernet conforme a [SWS_EthIf_91111]. En la llamada se pasan el índice del switch (SwitchIdx), así como el índice del puerto en el switch direccionado (SwitchPortIdx). El resultado de la consulta se proporciona a través del puntero BaudRatePtr de tipo EthTrcv_BaudRateType*, que puede representar velocidades como ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT o ETHTRCV_BAUD_RATE_2500MBIT [SWS_EthIf_91111].

En cuanto al comportamiento frente a errores, la función devuelve E_OK en caso de determinación correcta de la velocidad en baudios. Un valor de retorno de E_NOT_OK señala que la velocidad en baudios para el puerto de switch especificado no se pudo leer o que el controlador de switch se encuentra en el estado ETHSWT_STATE_UNINIT o ETHSWT_STATE_INIT [SWS_EthIf_91111].

La especificación califica la función como no reentrante (Non Reentrant), así como síncrona/asíncrona [SWS_EthIf_91111]. Presumiblemente, el comportamiento síncrono o asíncrono depende de la conexión y de la implementación del controlador de switch Ethernet subyacente. Pregunta Q-1f4d760ff944df9d (abierta) Debido a la falta de reentrancia, los llamadores deben asegurarse de evitar llamadas paralelas a la interfaz.

La función síncrona EthIf_TransceiverGetBaudRate con el ID de servicio 0x4e sirve para leer la velocidad de transmisión actual de un transceptor Ethernet indexado [SWS_EthIf_91112]. Forma parte del módulo EthIf y se pone a disposición mediante el archivo de encabezado EthIf.h [SWS_EthIf_91112].

El parámetro de entrada TrcvIdx de tipo uint8 identifica el transceptor en el contexto del controlador de transceptor Ethernet [SWS_EthIf_91112]. No existen parámetros de entrada/salida [SWS_EthIf_91112]. El resultado de la consulta se devuelve mediante el parámetro de salida BaudRatePtr [SWS_EthIf_91112]. Los valores válidos del tipo Eth_Trcv_BaudRateType son ETHTRCV_BAUD_RATE_10MBIT (10 Mbit/s), ETHTRCV_BAUD_RATE_100MBIT (100 Mbit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 Mbit/s), así como ETHTRCV_BAUD_RATE_2500MBIT (2500 Mbit/s) [SWS_EthIf_91112].

La función devuelve un estado de tipo Std_ReturnType: en caso de llamada correcta, se transfiere E_OK [SWS_EthIf_91112]. Si el transceptor no se pudo inicializar, el servicio falla y notifica E_NOT_OK [SWS_EthIf_91112].

En cuanto al contexto de llamada y a la concurrencia, EthIf_TransceiverGetBaudRate se define como interfaz síncrona y no reentrante (Non Reentrant) [SWS_EthIf_91112]. Las capas llamadoras deben asegurarse de que se eviten las llamadas concurrentes para este servicio o de que se serialicen en el nivel del llamador [SWS_EthIf_91112].

La función EthIf_SwitchPortGetDuplexMode sirve para consultar el modo dúplex actual de un puerto indexado en un switch Ethernet [SWS_EthIf_91113]. Reenvía la llamada a la función EthSwt_GetDuplexMode del controlador de switch Ethernet asignado mediante SwitchIdx [SWS_EthIf_00428].

Parámetros e interfaz

• SwitchIdx: índice del switch Ethernet en el contexto del controlador [SWS_EthIf_91113].
• SwitchPortIdx: índice del puerto en cuestión en el switch direccionado [SWS_EthIf_91113].
• DuplexModePtr: puntero de salida de tipo EthTrcv_DuplexModeType* para el modo determinado, o bien ETHTRCV_DUPLEX_MODE_HALF (semidúplex) o bien ETHTRCV_DUPLEXMODE_FULL (dúplex completo) [SWS_EthIf_91113].

Ejecución y tratamiento de errores

El valor de retorno E_OK señala una consulta correcta [SWS_EthIf_91113]. Si no se puede determinar el modo dúplex del puerto o si el controlador se encuentra en los estados ETHSWT_STATE_UNINIT o ETHSWT_STATE_INIT, la función devuelve E_NOT_OK [SWS_EthIf_91113].

La interfaz es no reentrante (Non Reentrant) y está declarada en la especificación como síncrona/asíncrona [SWS_EthIf_91113]. Interpretación: es probable que el funcionamiento real síncrono o asíncrono dependa de las propiedades del controlador de switch conectado. Pregunta Q-339413722431978f (abierta)

La función síncrona EthIf_TransceiverGetDuplexMode determina el modo dúplex actual de un transceptor Ethernet indexado conforme a [SWS_EthIf_91114].

Uso y parámetros

La llamada se realiza de forma síncrona y está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91114]:

• TrcvIdx: pasa como parámetro de entrada el índice del transceptor en el contexto del controlador de transceptor Ethernet [SWS_EthIf_91114].
• DuplexModePtr: sirve como puntero de salida al tipo EthTrcv_DuplexModeType para albergar el resultado. Los valores posibles son ETHTRCV_DUPLEX_MODE_HALF (semidúplex) o ETHTRCV_DUPLEX_MODE_FULL (dúplex completo) [SWS_EthIf_91114].

Valores de retorno y tratamiento de errores

Como valor de retorno, la función proporciona un Std_ReturnType [SWS_EthIf_91114]:

• E_OK: el modo dúplex se consultó correctamente y se proporcionó a través de DuplexModePtr [SWS_EthIf_91114].
• E_NOT_OK: la determinación falló, según la especificación, por ejemplo, si el transceptor no se pudo inicializar [SWS_EthIf_91114].

Restricciones y concurrencia

Dado que la interfaz no es reentrante, no deben realizarse llamadas paralelas para la misma instancia de transceptor o para diferentes instancias sin sincronización externa. La declaración está disponible a través del encabezado EthIf.h [SWS_EthIf_91114].

La función síncrona EthIf_SwitchPortGetCounterValues sirve para la lectura de valores de contador (Drop Counter) de un puerto de switch Ethernet determinado conforme a [SWS_EthIf_91115]. Proporcionada a través de la cabecera EthIf.h, la función recibe el índice de switch SwitchIdx así como el índice de puerto SwitchPortIdx y escribe de vuelta los valores de contador a través del puntero CounterPtr ([SWS_EthIf_91115]).

Modo de funcionamiento y reenvío

Conforme a [SWS_EthIf_00432], EthIf_SwitchPortGetCounterValues reenvía la solicitud directamente a la función EthSwt_GetCounterValues del controlador de switch Ethernet correspondiente. Los valores de contador devueltos se basan en los estándares IETF RFC 1757, RFC 1643 y RFC 2233, estando el significado semántico exacto asignado a la estructura Eth_CounterType ([SWS_EthIf_91115]).

Valores de retorno y tratamiento de errores

Como valor de retorno, la función proporciona Std_ReturnType ([SWS_EthIf_91115]):

• E_OK: la lectura de los valores de contador fue correcta ([SWS_EthIf_91115]).
• E_NOT_OK: se ha producido un error al leer los valores de contador ([SWS_EthIf_91115]).

Concurrencia y restricciones

La función está especificada como no reentrante (Non Reentrant) ([SWS_EthIf_91115]). Por tanto, las llamadas concurrentes deben sincronizarse al nivel del llamador. Interpretación: el llamador probablemente también sea responsable de proporcionar un área de memoria válida y dimensionada suficientemente para CounterPtr, ya que la especificación no menciona ninguna asignación interna de búfer. Pregunta Q-140661eaa9693cce (abierta)

Uso y semántica

La función EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) sirve para consultar contadores de estadísticas de recepción para un puerto de un switch Ethernet. Está disponible a través del encabezado EthIf.h y figura bajo el ID de servicio 0x52 ([SWS_EthIf_91116]).

La llamada requiere los siguientes parámetros ([SWS_EthIf_91116]):

• SwitchIdx: Índice del switch Ethernet en el contexto del controlador de switch Ethernet.
• SwitchPortIdx: índice del puerto en el switch direccionado.
• RxStatsPtr: puntero a una estructura de tipo Eth_RxStatsType en la que se escriben los valores de los contadores. La mayor parte de estos valores se deriva de IETF RFC 2819 (Remote Network Monitoring Management Information Base).

Valores de retorno y tratamiento de errores

La función proporciona como resultado un Std_ReturnType ([SWS_EthIf_91116]):

• E_OK: los datos estadísticos se leyeron correctamente.
• E_NOT_OK: los valores de los contadores no se pudieron determinar ([SWS_EthIf_91116]). No se especifican mensajes de error DET o DEM específicos para esta llamada.

Concurrencia y restricciones

La función está clasificada como no reentrante (Non Reentrant) ([SWS_EthIf_91116]). Dado que la sincronicidad se indica como «Synchronous /Asynchronous», es de suponer que el comportamiento de bloqueo real dependa de la implementación del controlador de switch Ethernet subyacente ([SWS_EthIf_91116]). Pregunta Q-d1e839075bf42e7f (abierta) Los llamadores deben evitar accesos paralelos a la misma interfaz.

La función EthIf_SwitchPortGetTxStats sirve para leer estadísticas de transmisión conforme a IETF RFC1213 para un determinado puerto de un switch Ethernet [SWS_EthIf_91117]. Está disponible a través del archivo de encabezado EthIf.h con el ID de servicio 0x53 [SWS_EthIf_91117].

Uso y parámetros

En la llamada se pasan el índice de switch (SwitchIdx) y el índice de puerto en el switch direccionado (SwitchPortIdx) como parámetros de entrada [SWS_EthIf_91117]. Los valores de los contadores determinados se proporcionan a través del puntero TxStatsPtr de tipo Eth_TxStatsType* [SWS_EthIf_91117]. Si un contador no está disponible o no es compatible, el valor máximo posible del contador señala un valor no válido [SWS_EthIf_91117].

Valores de retorno y tratamiento de errores

La función devuelve un estado de tipo Std_ReturnType [SWS_EthIf_91117]:

• E_OK: las estadísticas de transmisión se determinaron correctamente [SWS_EthIf_91117].
• E_NOT_OK: las estadísticas de transmisión no se pudieron obtener [SWS_EthIf_91117].

En las fuentes no se indican códigos de error específicos ni mensajes a DET o DEM, por lo que los casos de error deben capturarse principalmente a través del valor de retorno E_NOT_OK [SWS_EthIf_91117].

Concurrencia y restricciones

Según la especificación, EthIf_SwitchPortGetTxStats se define como asíncrona (Asynchronous) y no reentrante (Non Reentrant) [SWS_EthIf_91117]. Debido a la falta de reentrancia, las llamadas simultáneas no deben tener lugar sin sincronización de nivel superior [SWS_EthIf_91117]. Dado que el servicio está declarado como asíncrono, es de suponer que el búfer pasado TxStatsPtr deba mantenerse válido hasta la finalización completa de la operación (interpretación: estabilidad del búfer en caso de consulta asíncrona) [SWS_EthIf_91117]. Pregunta Q-8a14618d6990206b (abierta)

La función síncrona EthIf_SwitchPortGetTxErrorCounterValues (ID de servicio 0x54), proporcionada a través de EthIf.h, lee una lista de contadores de errores de transmisión para un puerto de un switch Ethernet [SWS_EthIf_91118]. Los contadores corresponden a las definiciones de IETF RFC1213 así como RFC1643 y se proporcionan a través del tipo Eth_TxErrorCounterValuesType en el parámetro de salida TxStatsPtr [SWS_EthIf_91118].

Durante la llamada, SwitchIdx direcciona el switch en el contexto del controlador y SwitchPortIdx el puerto concreto en el switch [SWS_EthIf_91118]. La función devuelve E_OK en caso de determinación correcta de los valores y E_NOTOK si no se pudieron obtener las estadísticas de transmisión [SWS_EthIf_91118]. Un valor de contador que adopte el valor máximo posible identifica de forma explícita un contador no válido o no disponible [SWS_EthIf_91118].

Como restricción para la ejecución se establece que la función no es reentrante (Non Reentrant) [SWS_EthIf_91118]. En la arquitectura conjunta, EthIf_SwitchPortGetTxErrorCounterValues reenvía la llamada directamente a la función EthSwt_GetTxErrorCounterValues del controlador de switch Ethernet correspondiente [SWS_EthIf_00438].

La función EthIf_SwitchPortGetMacLearningMode consulta el modo actual de aprendizaje de MAC para un determinado puerto de switch ([SWS_EthIf_91119]). Entre los modos que se pueden determinar se encuentran el aprendizaje por hardware habilitado, el aprendizaje por hardware deshabilitado y el aprendizaje por software habilitado ([SWS_EthIf_91119]). La disponibilidad de esta función depende del hardware, ya que el hardware de switch respectivo debe admitir los diferentes modos de aprendizaje ([SWS_EthIf_91119]).

Contexto de llamada y parámetros

La interfaz se proporciona mediante el encabezado EthIf.h y cuenta con el ID de servicio 0x55 ([SWS_EthIf_91119]). En la llamada deben pasarse los siguientes parámetros:

• SwitchIdx (in): índice del switch en el contexto del controlador de switch Ethernet ([SWS_EthIf_91119]).
• SwitchPortIdx (in): índice del puerto en el switch direccionado ([SWS_EthIf_91119]).
• MacLearningModePtr (out): puntero a la ubicación de memoria de tipo EthSwt_MacLearningType en la que se guarda el modo determinado ([SWS_EthIf_91119]).

Sincronización, concurrencia y valores de retorno

La ejecución está especificada como síncrona/asíncrona y es no reentrante (Non Reentrant) ([SWS_EthIf_91119]). Como valor de retorno sirve Std_ReturnType con los siguientes estados:

• E_OK: consulta realizada correctamente ([SWS_EthIf_91119]).
• E_NOT_OK: error en la ejecución ([SWS_EthIf_91119]). Aunque la descripción de la especificación para E_NOT_OK menciona textualmente «configuration could be persistently reset», interpretación: es probable que se trate de un error editorial de copia en la especificación y que en el contexto regular señale simplemente el fallo de la consulta. Pregunta Q-7565d2fbd70e355d (abierta)

La interfaz síncrona EthIf_WritePortMirrorConfiguration sirve para almacenar una configuración de duplicación de puertos en un shadow buffer dentro del controlador de switch Ethernet [SWS_EthIf_91122].

En la llamada se pasan los siguientes parámetros de entrada [SWS_EthIf_91122]:

• MirroredSwitchIdx: índice del switch correspondiente en el contexto del controlador de switch Ethernet en el que se encuentra el puerto de switch que se va a duplicar [SWS_EthIf_91122].
• PortMirrorConfigurationPtr: puntero a los datos de configuración de la estructura EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

El valor de retorno de tipo Std_ReturnType señala el estado de la ejecución [SWS_EthIf_91122]:

• E_OK: la configuración de duplicación de puertos se escribió correctamente para el puerto indexado [SWS_EthIf_91122].
• E_NOT_OK: la configuración no se pudo escribir, por ejemplo, porque el switch indexado no está disponible [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: el hardware de switch o el controlador de switch Ethernet no admiten la duplicación de puertos [SWS_EthIf_91122].

La función está especificada como no reentrante (Non Reentrant) y está disponible a través del encabezado EthIf.h [SWS_EthIf_91122]. Interpretación: es probable que los llamadores deban coordinar los accesos concurrentes mediante mecanismos de nivel superior, ya que no se especifica ninguna protección de sincronización interna. Pregunta Q-c731aedd871251a4 (abierta)

Uso y semántica

La función EthIf_ReadPortMirrorConfiguration sirve para consultar la configuración de duplicación de puertos de un determinado switch Ethernet [SWS_EthIf_91123]. Está declarada en el archivo de encabezado EthIf.h y posee el ID de servicio 0x59. El comportamiento de ejecución está especificado como asíncrono (Asynchronous), devolviendo la llamada inmediata un valor de estado de tipo Std_ReturnType [SWS_EthIf_91123].

Parámetros y valores de retorno

• MirroredSwitchIdx (in): índice del switch Ethernet en el contexto del controlador de switch Ethernet en el que se encuentran los puertos de switch que se van a duplicar [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out): puntero al área de memoria en la que se debe guardar la configuración leída [SWS_EthIf_91123].
• Valor de retorno: E_OK señala la lectura correcta de la configuración. En caso de error se devuelve E_NOT_OK, por ejemplo, si el switch Ethernet indexado no está disponible [SWS_EthIf_91123].

Interacción y concurrencia

Para su ejecución, EthIf_ReadPortMirrorConfiguration reenvía la llamada directamente a la función EthSwt_ReadPortMirrorConfiguration del controlador de switch Ethernet correspondiente [SWS_EthIf_00448]. La función está definida como no reentrante (Non Reentrant) [SWS_EthIf_91123]; por lo tanto, el llamador debe evitar llamadas paralelas para la misma interfaz.

La función síncrona EthIf_DeletePortMirrorConfiguration sirve para eliminar una configuración de duplicación de puertos almacenada para un determinado switch ([SWS_EthIf_91124]). El llamador pasa mediante el parámetro Mirrored Switch Idx el índice del switch en el contexto del Ethernet Switch Driver ([SWS_EthIf_91124]). La interfaz posee el ID de servicio 0x5a y se proporciona a través del archivo de encabezado EthIf.h ([SWS_EthIf_91124]).

El valor de retorno de tipo Std_ReturnType informa sobre el resultado de la eliminación ([SWS_EthIf_91124]):

• E_OK: la configuración de duplicación de puertos se eliminó correctamente ([SWS_EthIf_91124]). Si no se encontró ninguna configuración almacenada para el índice de switch especificado, la función devuelve por definición también E_OK ([SWS_EthIf_91124]).
• E_NOT_OK: la eliminación de la configuración ha fallado ([SWS_EthIf_91124]). Este es el caso, por ejemplo, si la duplicación de puertos todavía está activada en el momento de la llamada ([SWS_EthIf_91124]).

En cuanto a la concurrencia, la función es reentrante para diferentes índices de switch (Mirrored Switch Idx), pero no reentrante para múltiples llamadas para el mismo índice ([SWS_EthIf_91124]). Dado que una duplicación activa se menciona explícitamente como causa de error para E_NOT_OK, es de suponer que la duplicación de puertos deba desactivarse antes de eliminar la configuración ([SWS_EthIf_91124]). Pregunta Q-b9e5665de687dbba (abierta)

La función síncrona EthIf_SetPortMirrorState sirve para establecer el estado requerido de la configuración de duplicación de puertos para un switch Ethernet especificado ([SWS_EthIf_91126]). Está disponible a través del archivo de encabezado EthIf.h ([SWS_EthIf_91126]).

La función espera tres parámetros al ser llamada ([SWS_EthIf_91126]):

• MirroredSwitchIdx: Índice del switch Ethernet en el contexto del Ethernet Switch Driver en el que se encuentra la configuración de réplica de puertos que se va a activar o desactivar.
• PortIdx: Índice del puerto en el switch Ethernet direccionado.
• PortMirrorState: el estado de duplicación de puertos que se va a solicitar, o bien PORT_MIRRORING_ENABLED o bien PORT_MIRRORING_DISABLED.

El valor de retorno de tipo Std_ReturnType señala el resultado de la solicitud ([SWS_EthIf_91126]):

• E_OK: el estado solicitado para el puerto de switch especificado se estableció correctamente.
• E_NOT_OK: el establecimiento ha fallado, por ejemplo, si el switch direccionado no está disponible o no existe una configuración de duplicación de puertos.

La ejecución se realiza de forma síncrona y está especificada como no reentrante (Non Reentrant) ([SWS_EthIf_91126]). En el conjunto de capas, la Ethernet Interface asume el reenvío: según [SWS_EthIf_00454], EthIf_SetPortMirrorState reenvía la llamada directamente a la función EthSwt_SetPortMirrorState del Ethernet Switch Driver correspondiente.

La función EthIf_SetPortTestMode sirve para activar un modo de prueba predeterminado en un puerto indexado de un switch Ethernet [SWS_EthIf_91127]. El servicio síncrono está disponible a través del encabezado EthIf.h con el ID de servicio 0x5d [SWS_EthIf_91127].

Parámetros y valores de retorno

Para configurar el modo de prueba, la interfaz espera tres parámetros de entrada, mientras que no existen parámetros de entrada/salida ni de salida pura [SWS_EthIf_91127]:

• SwitchIdx (uint8): índice del switch en el contexto del controlador de Ethernet switch correspondiente [SWS_EthIf_91127].
• PortIdx (uint8): índice del puerto en el Ethernet switch direccionado [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType): modo de prueba que se va a activar en el puerto del switch [SWS_EthIf_91127].

El valor de retorno de tipo Std_ReturnType señala el éxito de la operación [SWS_EthIf_91127]:

• E_OK: el modo de prueba de puerto para el puerto indexado del Ethernet switch se configuró correctamente [SWS_EthIf_91127].
• E_NOT_OK: la configuración del modo de prueba de puerto no tuvo éxito, por ejemplo si el puerto direccionado del Ethernet switch no está disponible [SWS_EthIf_91127].

Concurrencia e interacción

La función está especificada como no reentrante (Non Reentrant) y opera de forma síncrona [SWS_EthIf_91127]. Durante la llamada, EthIf_SetPortTestMode reenvía la solicitud directamente a la función subyacente EthSwt_SetPortTestMode del controlador de Ethernet switch correspondiente [SWS_EthIf_00456].

usar

La función EthIf_SetPortLoopbackMode sirve para activar un modo predeterminado de bucle invertido de prueba para un puerto indexado de un Ethernet switch [SWS_EthIf_91128]. La declaración se proporciona a través del archivo de cabecera EthIf.h [SWS_EthIf_91128]. Al realizar la llamada se transmiten los siguientes parámetros de entrada:

• SwitchIdx: Índice del switch Ethernet dentro del contexto del controlador de switch Ethernet [SWS_EthIf_91128].
• PortIdx: índice del puerto afectado en el switch previamente direccionado [SWS_EthIf_91128].
• Mode: modo de bucle invertido que se va a activar de tipo EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Interacción y reenvío

La función no realiza la configuración por sí misma a nivel de hardware. En su lugar, EthIf_SetPortLoopbackMode reenvía la llamada directamente a la función EthSwt_SetPortLoopbackMode del controlador de Ethernet switch asociado [SWS_EthIf_00458].

Tratamiento de errores y valores de retorno

El valor de retorno es de tipo Std_ReturnType [SWS_EthIf_91128]:

• E_OK: el modo de bucle invertido se activó correctamente para el puerto indexado del Ethernet switch [SWS_EthIf_91128].
• E_NOT_OK: la activación falló, por ejemplo si el puerto indexado del Ethernet switch no está disponible [SWS_EthIf_91128].

En la especificación no se indican códigos de error específicos para DET o DEM para este servicio.

Concurrencia y restricciones

La ejecución tiene lugar de forma completamente síncrona y la función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91128]. La entidad emisora de la llamada debe impedir llamadas paralelas. Interpretación: Dado que se trata de la conmutación de modos de prueba, la llamada debería realizarse típicamente en el marco de secuencias de inicialización, prueba o diagnóstico a nivel de tarea. Pregunta Q-cb4575c4a1d9c48b (abierta)

La función síncrona EthIf_SetPortTxMode activa un modo de transmisión predeterminado para un puerto indexado de Ethernet switch [SWS_EthIf_91129]. Está disponible a través del archivo de cabecera EthIf.h y posee el Service-ID 0x5f [SWS_EthIf_91129].

usar

La llamada direcciona el puerto de destino mediante dos índices y transfiere el modo deseado [SWS_EthIf_91129]:

• SwitchIdx: índice del switch dentro del contexto del controlador de Ethernet switch.
• PortIdx: índice del puerto en el switch direccionado.
• Mode: Modo de transmisión que se va a activar de tipo EthTrcv_PhyTxModeType.

Como valor de retorno, la función proporciona Std_ReturnType [SWS_EthIf_91129]:

• E_OK: el modo de transmisión para el puerto de switch indexado se activó correctamente.
• E_NOT_OK: la activación falló, por ejemplo si el puerto de switch indexado no está disponible.

Concurrencia y restricciones

La interfaz está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91129]. Por lo tanto, las instancias llamantes deben garantizar que no se produzcan llamadas concurrentes. En la definición de la función no se indican mensajes de error específicos de DET o DEM; el comportamiento frente a errores se limita, según la especificación, a la devolución de E_NOT_OK [SWS_EthIf_91129].

usar

La interfaz asíncrona EthIf_RunPortCableDiagnostic inicia un diagnóstico de cables para un puerto seleccionado de un Ethernet switch [SWS_EthIf_91131]. Al invocarla, se transfieren los parámetros SwitchIdx (índice del switch en el contexto del controlador de Ethernet switch) y PortIdx (índice del puerto direccionado en el switch). La función devuelve E_OK tan pronto como se acepta el disparador para el diagnóstico de cables; si el inicio es rechazado, se devuelve E_NOT_OK [SWS_EthIf_91131].

Interacción y condiciones previas

Durante la ejecución de EthIf_RunPortCableDiagnostic, EthIf tiene la obligación de asegurar que el EthIfController correspondiente se encuentre en el estado operativo ETH_MODE_ACTIVE [SWS_EthIf_00464]. Bajo esta condición, la Ethernet Interface reenvía la llamada a la función EthSwt_RunPortCableDiagnostic del controlador de switch asignado [SWS_EthIf_00464].

Concurrencia y restricciones

La función es reentrante para valores divergentes entre sí de SwitchIdx y PortIdx [SWS_EthIf_91131]. En cambio, para pares idénticos de índice de switch y de puerto, la llamada está especificada como no reentrante, por lo que deben evitarse ejecuciones paralelas en el mismo puerto.

usar

La función EthIf_RunCableDiagnostic inicia el diagnóstico de cables para un transceptor de Ethernet especificado [SWS_EthIf_91132]. Se proporciona mediante la cabecera EthIf.h y se gestiona con el Service-ID 0x62 [SWS_EthIf_91132]. Como parámetro de entrada sirve TrcvIdx, el cual mapea el índice del transceptor de destino en el contexto del controlador de transceptor de Ethernet [SWS_EthIf_91132].

La ejecución se realiza de forma asíncrona [SWS_EthIf_91132]. El valor de retorno de tipo Std_ReturnType señala la aceptación del disparador:

• E_OK: el disparador para el diagnóstico de cables se aceptó correctamente [SWS_EthIf_91132].
• E_NOT_OK: el disparador no fue aceptado [SWS_EthIf_91132].

Manejo de errores

Si se rechaza el diagnóstico de cables, la función devuelve inmediatamente E_NOT_OK [SWS_EthIf_91132]. En la presente especificación no se definen errores específicos de desarrollo o de producción (DET/DEM) para esta función.

Concurrencia y restricciones

Respecto a la concurrencia, EthIf_RunCableDiagnostic es reentrante para llamadas con índices diferentes (TrcvIdx), pero no reentrante para el mismo índice de transceptor [SWS_EthIf_91132]. La entidad llamante debe impedir solicitudes de diagnóstico simultáneas en el mismo transceptor. Interpretación: Dado que la función opera de forma puramente asíncrona y no devuelve datos de resultado, la puesta a disposición del resultado de diagnóstico probablemente se realice a través de un mecanismo independiente. Pregunta Q-c65c009cd2e00dea (abierta)

La función de interfaz EthIf_SwitchGetCfgDataRaw sirve para la lectura de longitud variable de datos de configuración o de memoria de un Ethernet switch indexado [SWS_EthIf_91133]. En el marco del modelo de capas, el módulo no procesa la llamada de forma autónoma, sino que la reenvía directamente a la función EthSwt_GetCfgDataRaw del controlador de Ethernet switch competente [SWS_EthIf_00468]. La función está declarada en la cabecera EthIf.h y posee el Service-ID 0x63 [SWS_EthIf_91133].

Invocación y parámetros

La llamada se realiza de forma asíncrona y únicamente inicia la operación de lectura [SWS_EthIf_91133]. En cuanto a parámetros, la función espera:

• SwitchIdx: índice del Ethernet switch en el contexto del controlador de Ethernet switch [SWS_EthIf_91133],
• Offset: desplazamiento inicial (offset) en la memoria del Ethernet switch a partir del cual comienza el proceso de lectura [SWS_EthIf_91133],
• Length: número de bytes de datos que se van a leer y copiar [SWS_EthIf_91133],
• BufferPtr: puntero a la ubicación de memoria de destino a la que deben copiarse los datos [SWS_EthIf_91133].

Como valor de retorno, la función proporciona E_OK si el proceso de lectura se inició con éxito [SWS_EthIf_91133]. Si el proceso no puede iniciarse —por ejemplo, si el switch direccionado no está disponible—, se notifica E_NOT_OK [SWS_EthIf_91133].

concurrencia

La función está definida como no reentrante (Non Reentrant) [SWS_EthIf_91133]. Por lo tanto, los llamantes deben garantizar que las llamadas se efectúen secuencialmente. Interpretación: Debido a su carácter asíncrono, el contenido del búfer no debería estar completado de forma definitiva al retornar de E_OK, sino que el controlador lo suministrará de forma diferida en el tiempo. Pregunta Q-0abda93fb8830dd4 (abierta)

La función EthIf_SwitchGetCfgDataInfo determina el tamaño total de los datos de configuración, así como la dirección de inicio de los registros de configuración para un Ethernet switch indexado [SWS_EthIf_91134]. La interfaz está declarada en la cabecera EthIf.h y se gestiona con el Service-ID 0x64 [SWS_EthIf_91134].

La función adopta los siguientes parámetros [SWS_EthIf_91134]:

• SwitchIdx (in): índice del Ethernet switch en el contexto del controlador de Ethernet switch.
• DataSizePtr (out): puntero a la posición de memoria a la cual debe copiarse el tamaño total de los datos de configuración.
• DataAdressPtr (out): puntero a la posición de memoria a la cual debe copiarse la dirección de inicio de los registros de configuración.

Como valor de retorno, la función entrega E_OK si los datos se obtuvieron con éxito, o E_NOT_OK en caso de que el proceso falle, por ejemplo porque el switch indexado no esté disponible [SWS_EthIf_91134]. En el presente alcance de la especificación no se definen códigos de error específicos para DET o DEM para este servicio.

Para el contexto de llamada, la función está especificada como reentrante, así como formalmente asíncrona [SWS_EthIf_91134]. Puesto que no se especifican mecanismos de callback, la provisión de los datos debería estar disponible de forma inmediata al retornar de E_OK (interpretación: la clasificación asíncrona apunta probablemente a accesos internos del controlador). Pregunta Q-bf49882a16548ea4 (abierta)

Uso y llamada

La función EthIf_SwitchPortGetMaxFIFOBufferFillLevel determina la memoria de búfer FIFO máxima asignada (en bytes) desde el último acceso de lectura para un puerto de salida (egress) determinado de un Ethernet switch [SWS_EthIf_91135]. La llamada puede realizarse, por ejemplo, mediante un controlador de dispositivo complejo (Complex Device Driver, CDD) [SWS_EthIf_91135]. Para el direccionamiento se transfieren el índice de switch (SwitchPortIdx), el índice de puerto (PortIdx) y el índice de FIFO (SwitchPortEgressFifoIdx). El nivel de llenado determinado se escribe en el área de memoria a la que apunta SwitchPortEgressFifoBufferLevelPtr [SWS_EthIf_91135].

Concurrencia y ejecución

La función posee una semántica de ejecución asíncrona [SWS_EthIf_91135]. Es reentrante para índices de switch y de puerto distintos, pero no debe invocarse concurrentemente para la misma combinación de SwitchPortIdx y PortIdx [SWS_EthIf_91135]. Debido a la semántica asíncrona unida a la transferencia por puntero, el área de memoria referenciada para el resultado debería tener que permanecer válida hasta la finalización de la operación. Pregunta Q-c941ffec278a86cd (abierta)

Tratamiento de errores e interacción con el controlador

Si la consulta es exitosa, la función devuelve E_OK; en caso contrario, E_NOT_OK [SWS_EthIf_91135]. Si el hardware del switch no admite la determinación basada en puerto del nivel máximo de llenado del búfer FIFO, el valor en la dirección de destino SwitchPortEgressFifoBufferLevelPtr se establece en 0xFFFFFFFF [SWS_EthIf_91135]. El módulo reenvía la llamada a la función de controlador EthSwt_GetMaxFIFOBufferFillLevel del controlador de Ethernet switch asignado para su posterior ejecución [SWS_EthIf_00472].

Uso y semántica

La función EthIf_TransceiverGetMacMethod (Service ID 0x66) sirve para consultar de forma síncrona el método de acceso al medio configurado de un transceptor de Ethernet [SWS_EthIf_91021]. Está disponible a través del archivo de encabezado EthIf.h y utiliza los siguientes parámetros de interfaz:

• TrcvIdx (in): Índice del transceptor dentro del contexto del controlador del transceptor de Ethernet [SWS_EthIf_91021].
• MacModePtr (out): Puntero a la ubicación de almacenamiento para el método de acceso determinado del tipo EthTrcv_MacMethodType [SWS_EthIf_91021]. Los valores de resultado válidos son ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access con Collision Detection) y ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

Valores de retorno y tratamiento de errores

Como valor de retorno, la interfaz entrega un estado del tipo Std_ReturnType [SWS_EthIf_91021]:

• E_OK: El método de acceso al medio se leyó con éxito y se proporcionó a través de MacModePtr.
• E_NOT_OK: La solicitud al transceptor no fue aceptada [SWS_EthIf_91021]. No se enumeran códigos de error DET o DEM específicos en la especificación para este servicio.

Concurrencia y condiciones de contorno

La ejecución se realiza de forma síncrona, pero la función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_91021]. Por lo tanto, el invocador debe excluir una llamada simultánea o con interrupción dentro del mismo contexto de controlador. Además, cabe señalar que en la versión R20-11 el servicio se indica con el estado atp.Status=draft [SWS_EthIf_91021].

Uso y semántica

La función síncrona EthIf_RxIndication procesa una trama Ethernet que se recibió a través de un controlador Ethernet físico indexado [SWS_EthIf_00085]. El servicio no posee valor de retorno y gestiona el reenvío de los datos recibidos dentro de la Ethernet Interface [SWS_EthIf_00085]. Interpretación: la llamada probablemente deba realizarla de forma típica el controlador Ethernet subyacente (Eth) tan pronto como los nuevos datos de recepción estén completamente disponibles. Pregunta Q-c3d25d0b89e6cd7f (abierta)

parámetro

Para el procesamiento posterior, la función acepta los siguientes parámetros [SWS_EthIf_00085]:

• CtrlIdx: índice del controlador Ethernet físico en el contexto de la Ethernet Interface [SWS_EthIf_00085].
• FrameType: tipo de trama de la trama Ethernet recibida [SWS_EthIf_00085].
• IsBroadcast: indicación de si se trata de una trama de difusión (broadcast) [SWS_EthIf_00085].
• PhysAddrPtr: puntero a la dirección física de origen (dirección MAC en orden de bytes de red) de la trama recibida [SWS_EthIf_00085].
• DataPtr: puntero a los datos útiles (payload) de la trama recibida [SWS_EthIf_00085].
• LenByte: longitud de los datos útiles en la trama recibida en bytes [SWS_EthIf_00085].

Concurrencia y restricciones

La interfaz está declarada como no reentrante (Non Reentrant) y disponible bajo el ID de servicio 0x10 a través del archivo de cabecera EthIf.h [SWS_EthIf_00085]. Las entidades emisoras de la llamada deben asegurarse de que no se produzcan llamadas concurrentes. En el alcance de la especificación no se indican códigos de error específicos, valores de retorno ni mensajes DET/DEM para esta función.

Uso y contexto de llamada

La función síncrona EthIf_TxConfirmation (ID de servicio 0x11) confirma la transmisión de una trama Ethernet por parte del controlador Ethernet físico referenciado mediante CtrlIdx [SWS_EthIf_00091]. La función no posee valor de retorno y está disponible a través del archivo de cabecera EthIf.h [SWS_EthIf_00091].

Los parámetros de entrada se definen de la siguiente manera [SWS_EthIf_00091]:

• CtrlIdx (uint8): índice del controlador Ethernet físico en el contexto de la Ethernet Interface.
• BufIdx (Eth_BufIdxType): índice del búfer transmitido.
• Result (Std_ReturnType): resultado de la transmisión; E_OK señaliza un proceso de envío correcto, E_NOT_OK un error de transmisión.

Interacción con capas superiores

De acuerdo con [SWS_EthIf_00255], EthIf_TxConfirmation reenvía el resultado de transmisión Result recibido a la capa superior configurada a través de su callback <UL>_TxConfirmation.

Concurrencia y restricciones

La función está especificada como no reentrante (Non Reentrant) [SWS_EthIf_00091]. Por tanto, deben evitarse las llamadas paralelas. En el extracto de la especificación no se contemplan mensajes de error específicos de DET o DEM; los errores se transmiten exclusivamente mediante el parámetro Result con el valor E_NOT_OK [SWS_EthIf_00091].

La función de notificación EthIf_CtrlModeIndication se llama de acuerdo con [SWS_EthIf_00231] tan pronto como el modo de funcionamiento de un controlador Ethernet se ha leído correctamente. El disparo se produce de forma asíncrona a consecuencia de una llamada previa de Eth_SetControllerMode, pudiendo tener lugar la llamada directamente dentro de las funciones de disparo respectivas. La función en sí posee una semántica de ejecución síncrona y no devuelve ningún valor de retorno ([SWS_EthIf_00231]).

A través de los parámetros se transmiten el índice del controlador Ethernet físico en el contexto de la Ethernet Interface (CtrlIdx), así como el modo de controlador notificado (CtrlMode) ([SWS_EthIf_00231]). Respecto a la concurrencia, [SWS_EthIf_00231] especifica que la función no es reentrante para el mismo índice de controlador, pero que puede ejecutarse de forma reentrante para índices diferentes.

En relación con la interacción con otros módulos, los requisitos relacionados hacen referencia a acciones posteriores que, no obstante, se clasifican como obsoletas en la presente versión:

• De acuerdo con [SWS_EthIf_00267] (OBSOLETE), en el contexto de esta función estaba previsto llamar a EthSwt_SetSwitchPortMode para todos los puertos de un grupo de puertos de switch, siempre que exista la correspondiente referencia de control, y resolver conflictos con grupos activos en caso de ETH_MODE_DOWN.
• De acuerdo con [SWS_EthIf_00413] (OBSOLETE), en el contexto de esta función estaba previsto, en caso de existir referencia de transceptor, llamar a EthTrcv_TransceiverLinkStateRequest con ETHTRCV_LINK_STATE_ACTIVE o ETHTRCV_LINK_STATE_DOWN, según si previamente se había solicitado ETH_MODE_ACTIVE o ETH_MODE_DOWN.

Uso y semántica

La función EthIf_TrcvModeIndication sirve como interfaz de notificación de la interfaz Ethernet que se invoca en cuanto se ha leído un cambio de modo del transceptor [SWS_EthIf_00232]. Está disponible a través del archivo de cabecera EthIf.h y posee el ID de servicio 0x0f [SWS_EthIf_00232].

La ejecución de la función en sí está especificada como síncrona, mientras que la invocación se produce de forma asíncrona una vez determinado el cambio de modo [SWS_EthIf_00232]. En caso de que la función sea activada por una invocación previa de EthTrcv_SetTransceiverMode, se permite invocarla directamente dentro de dicha función desencadenante [SWS_EthIf_00232].

Parámetros y valores de retorno

• TrcvIdx: índice del transceptor Ethernet en el contexto de la interfaz Ethernet (parámetro de entrada) [SWS_EthIf_00232].
• TrcvMode: modo de funcionamiento señalizado del transceptor Ethernet del tipo Eth_ModeType (parámetro de entrada) [SWS_EthIf_00232].
• Valor de retorno: ninguno (void) [SWS_EthIf_00232].

Concurrencia y reentrancia

La función está especificada como no reentrante para el mismo índice, pero reentrante para índices diferentes [SWS_EthIf_00232]. La tabla de especificación indica en este caso Ctrl Idx, lo que en el contexto de esta interfaz de transceptor probablemente deba interpretarse como una referencia al índice de transceptor o de controlador [SWS_EthIf_00232]. Pregunta Q-c0123f1ef0e4ec71 (abierta)

La función EthIf_SwitchPortModeIndication sirve al Ethernet Interface (EthIf) como interfaz de notificación asíncrona sobre un cambio de modo de un puerto de switch de Ethernet notificado por el Ethernet Switch Driver [SWS_EthIf_91055].

Uso e interacción

El EthIf determina las notificaciones esperadas basándose en la configuración del puerto de switch correspondiente: Si el puerto de switch hace referencia a un transceptor (EthTrcv), el EthIf espera en su lugar una notificación a través de EthIf_TrcvModeIndication(); de lo contrario, se espera la notificación del Ethernet Switch Driver a través de EthIf_SwitchPortModeIndication() [SWS_EthIf_91055].

• SwitchIdx: Índice del switch de Ethernet en el contexto del Ethernet Switch Driver [SWS_EthIf_91055].
• SwitchPortIdx: Índice del puerto en el switch de Ethernet direccionado [SWS_EthIf_91055].
• PortMode: El nuevo modo notificado del puerto de switch del tipo Eth_ModeType [SWS_EthIf_91055].

Propiedades de ejecución y restricciones

La función no posee valor de retorno (void) y tiene el Service ID 0x46 [SWS_EthIf_91055]. Está especificada como asíncrona (Asynchronous) y no reentrante (Non Reentrant) [SWS_EthIf_91055]. Por lo tanto, los invocadores deben asegurarse de evitar llamadas concurrentes para este servicio. No hay definidos mensajes de error DET o DEM específicos para esta función en el payload.

Uso y contexto de llamada

La función EthIf_SleepIndication sirve como interfaz de notificación del Ethernet Interface. Es llamada por el controlador de transceptor Ethernet correspondiente (EthTrcv) tan pronto como este haya registrado una indicación de sueño en la red [SWS_EthIf_91006]. Como único parámetro de entrada se transfiere TrcvIdx, el cual identifica unívocamente el índice del transceptor Ethernet que señaliza en el contexto del módulo EthIf [SWS_EthIf_91006]. La función no posee valores de entrada/salida ni de retorno y ejecuta la notificación de forma síncrona [SWS_EthIf_91006].

Interacción con el hardware

Un caso de uso esencial es el empleo con hardware Ethernet diseñado de conformidad con la especificación OPEN Alliance TC10 [SWS_EthIf_91006]. En este escenario, el transceptor (PHY) detecta a nivel de hardware una Sleep.Indication, la cual fue desencadenada por una solicitud de sueño (Sleep.Request) del link partner directamente conectado [SWS_EthIf_91006].

Concurrencia y restricciones

La interfaz está definida como síncrona y reentrante, y se proporciona a través del archivo de cabecera EthIf.h (ID de servicio 0x68) [SWS_EthIf_91006]. En la integración del sistema, debe tenerse en cuenta que el elemento está marcado como borrador con la etiqueta atp.Status=draft [SWS_EthIf_91006]. En el alcance de la especificación no se definen rutinas concretas de tratamiento de errores ni códigos de error DET; probablemente una comprobación formal de errores no se realice hasta futuras versiones de la especificación. Pregunta Q-680af6c43439167f (abierta)

Uso y contexto de llamada

La función EthIf_MainFunctionRx asume en la interfaz Ethernet (EthIf) la tarea central de comprobar, en funcionamiento por sondeo, la llegada de nuevas tramas de datos y activar las correspondientes indicaciones de recepción (Reception Indications) hacia las capas superiores [SWS_EthIf_00097]. Está definida con la signatura void EthIf_MainFunctionRx (void), por lo que no recibe parámetros de llamada y no devuelve ningún valor [SWS_EthIf_00097]. Como ID de servicio se establece el valor hexadecimal 0x20 [SWS_EthIf_00097].

La función se pone a disposición a través del archivo de cabecera SchM_EthIf.h [SWS_EthIf_00097]. Esto sugiere la interpretación de que su invocación se realiza periódicamente mediante el Schedule Manager (SchM) o el sistema operativo dentro del contexto de una tarea cíclica del software básico.

Concurrencia y tratamiento de errores

Dado que la comprobación y el reenvío de tramas recibidas se especifican en modo de sondeo [SWS_EthIf_00097], un funcionamiento de recepción fluido requiere una temporización adecuada de la invocación. Una ejecución demorada probablemente provocaría retrasos en el reenvío de mensajes entrantes a las capas de software superiores. Pregunta Q-554ef0cf302c3aa3 (abierta) En la especificación no se indican para esta función códigos de error específicos, errores de desarrollo (DET) ni mensajes de error dirigidos al DEM.

La función principal EthIf_MainFunctionTx sirve para la tramitación cíclica de operaciones de transmisión y consultas de estado dentro del módulo de interfaz Ethernet [SWS_EthIf_00113]. Posee el ID de servicio hexadecimal 0x21 y se ejecuta, de acuerdo con su signatura void EthIf_MainFunctionTx (void), sin parámetros de entrada y sin valor de retorno, de modo que todo el procesamiento se basa en estados [SWS_EthIf_00113].

Durante el funcionamiento normal, el servicio asume dos tareas centrales en la comunicación Ethernet:

• Confirmaciones de transmisión: en modo de sondeo, la función emite confirmaciones de transmisiones finalizadas con éxito (Transmission Confirmations) a las capas superiores [SWS_EthIf_00113].
• Estados del transceptor: monitoriza y comprueba el sistema ante posibles cambios de estado producidos en los transceptores Ethernet conectados [SWS_EthIf_00113].

Con respecto a la integración del sistema, la interfaz está disponible a través del archivo de cabecera SchM_EthIf.h [SWS_EthIf_00113]. Interpretación: del hecho de proporcionarse a través de SchM_EthIf.h se deduciría que la invocación se produce periódicamente mediante el planificador de BSW (SchM) en el contexto de una tarea cíclica. Pregunta Q-b9dde07f9cc74a95 (abierta) Esto garantiza que las confirmaciones de transmisión pendientes en modo de sondeo y los cambios de estado del transceptor se procesen de forma regular y sin dependencia de interrupciones.

En el alcance de la especificación actual no se definen para este servicio códigos de error específicos, rutinas independientes de tratamiento de errores a través de DET o DEM, ni requisitos de reentrada, por lo que no se indican.

Uso y semántica

La función EthIf_MainFunctionState sirve para la consulta cíclica (polling) de información de estado y diagnóstico del hardware de comunicación Ethernet conectado, como transceptores Ethernet y puertos de switch Ethernet [SWS_EthIf_91104]. Entre estos se cuentan, por ejemplo, el estado de la conexión (Link State) y la calidad de la señal [SWS_EthIf_91104]. La función no posee parámetros de entrada ni de salida y no devuelve ningún valor (void EthIf_MainFunctionState(void), ID de servicio 0x05) [SWS_EthIf_91104]. El comportamiento de ejecución está especificado como asíncrono [SWS_EthIf_91104].

Concurrencia y condiciones de invocación

La función está definida como no reentrante (Non Reentrant) [SWS_EthIf_91104]. Por tanto, no debe ejecutarse en ningún momento en paralelo ni interrumpiéndose a sí misma. Dado que la interfaz se proporciona a través del archivo de cabecera EthIf_SchM.h [SWS_EthIf_91104], la llamada periódica suele realizarse típicamente en el contexto de tarea del planificador de BSW (SchM). Pregunta Q-10d02355b276be90 (abierta)

Interacción y configuración

Conforme a [SWS_EthIf_00407], EthIf_MainFunctionState debe consultar la información de hardware estrictamente con la periodicidad configurada EthIfMainFunctionStatePeriod. Esto garantiza una actualización periódica de los parámetros físicos de interfaz en el Ethernet Interface.

La estructura de datos EthIf_SignalQualityResultType ([SWS_EthIf_91057]) sirve para la adquisición y el diagnóstico de la calidad de la conexión a nivel de Ethernet y se proporciona a través del archivo de cabecera EthIf.h.

La estructura agrupa tres magnitudes de medida del tipo básico uint32:

• ActualSignalQuality: representa la calidad de señal presente actualmente en la conexión Ethernet.
• HighestSignalQuality: registra la calidad de señal más alta medida de la conexión desde el último restablecimiento.
• LowestSignalQuality: documenta la calidad de señal más baja medida de la conexión desde el último restablecimiento.

En interacción con el módulo EthIf, los valores extremos reflejan la evolución de la estabilidad de la conexión. El restablecimiento de los valores históricos almacenados internamente se controla a través de interfaces dedicadas:

• Para un transceptor especificado mediante TrcvIdx, la función EthIf_ClearTrcvSignalQuality restablece los valores de calidad de señal almacenados ([SWS_EthIf_00400]).
• Para un puerto de switch identificado mediante SwitchIdx y SwitchPortIdx, EthIf_ClearSwitchPortSignalQuality borra los valores de calidad de señal almacenados ([SWS_EthIf_00404]).

Interpretación: dado que el payload no menciona ninguna función de lectura específica, es de suponer que la estructura sirva probablemente como parámetro de salida de las correspondientes consultas de estado para transceptores y puertos de switch a fin de comparar la calidad de señal actual con los valores extremos. Pregunta Q-8e5f2914bade574c (abierta)