FlexRay Interface (FrIf)

La función FrIf_Init sirve para inicializar el módulo FlexRay Interface ([SWS_FrIf_05003]). La llamada se realiza de forma síncrona y está especificada como no reentrante (Non Reentrant) ([SWS_FrIf_05003]).

Parámetros y valores de retorno

• FrIf_ConfigPtr (parámetro de entrada): puntero base a la estructura de configuración de la interfaz FlexRay ([SWS_FrIf_05003]).
• Valor de retorno: void: la función no devuelve ningún valor de retorno ([SWS_FrIf_05003]).

Restricciones y condiciones de llamada

Dado que FrIf_Init no es reentrante, la función no debe volver a llamarse en ningún momento de forma paralela o con interrupción por el mismo u otro subproceso o tarea ([SWS_FrIf_05003]). La llamada debe realizarse en el contexto de inicialización del sistema, antes de hacer uso de servicios regulares de la interfaz FlexRay.

La función síncrona FrIf_ControllerInit sirve para inicializar un FlexRay Communication Controller (FlexRay CC) [SWS_FrIf_05004]. Está disponible a través del archivo de cabecera FrIf.h y se identifica mediante el ID de servicio 0x03 [SWS_FrIf_05004].

A través del parámetro de entrada FrIf_CtrlIdx de tipo de datos uint8 se transfiere el índice del controlador FlexRay que se va a direccionar [SWS_FrIf_05004]. No existen más parámetros de entrada o de salida para esta interfaz [SWS_FrIf_05004].

El valor de retorno es de tipo Std_ReturnType y devuelve el estado de la inicialización al llamador [SWS_FrIf_05004]:

• E_OK: la llamada al servicio de API del controlador FlexRay subyacente fue exitosa y devolvió E_OK [SWS_FrIf_05004].
• E_NOT_OK: el servicio de API del controlador FlexRay devolvió E_NOT_OK o se detectó un error en el modo de desarrollo [SWS_FrIf_05004].

En cuanto a la concurrencia, FrIf_ControllerInit es reentrante para diferentes índices de controlador (FrIf_CtrlIdx), pero no reentrante para valores idénticos de FrIf_CtrlIdx [SWS_FrIf_05004]. Por lo tanto, el sistema global debe evitar las llamadas concurrentes para el mismo controlador.

usar

La función FrIf_EnableAbsoluteTimerIRQ representa un servicio síncrono con el ID de servicio 0x1d, proporcionado mediante el archivo de encabezado FrIf.h [SWS_FrIf_05025]. Actúa como envoltorio alrededor de la interfaz Fr_EnableAbsoluteTimerIRQ() del controlador FlexRay para activar la interrupción de un temporizador absoluto [SWS_FrIf_05025].

La llamada requiere dos parámetros de entrada [SWS_FrIf_05025]:

• FrIf_CtrlIdx: Índice del controlador de comunicación FlexRay (FlexRay CC) al que se debe acceder [SWS_FrIf_05025].
• FrIf_AbsTimerIdx: Índice del temporizador absoluto que se va a activar en el controlador direccionado [SWS_FrIf_05025].

Valores de retorno y tratamiento de errores

La función devuelve un valor de estado del tipo Std_ReturnType [SWS_FrIf_05025]:

• E_OK: La llamada al servicio del controlador subyacente fue exitosa y devolvió E_OK [SWS_FrIf_05025].
• E_NOT_OK: La función del controlador devolvió E_NOT_OK o se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05025].

Concurrencia y reentrancia

Con respecto al contexto de llamada, FrIf_EnableAbsoluteTimerIRQ no es reentrante para el mismo controlador FlexRay, pero puede invocarse de forma reentrante para diferentes controladores FlexRay [SWS_FrIf_05025].

La función de interfaz síncrona FrIf_AckAbsoluteTimerIRQ encapsula como envoltorio la llamada a la API de la función de controlador Fr_AckAbsoluteTimerIRQ() del controlador FlexRay [SWS_FrIf_05029]. Posee el ID de servicio 0x21, se proporciona mediante el encabezado FrIf.h y sirve para confirmar una solicitud de interrupción para un temporizador absoluto de un FlexRay Communication Controller.

Al invocar la función deben pasarse dos parámetros de entrada [SWS_FrIf_05029]:

• FrIf_CtrlIdx: índice del FlexRay Communication Controller (CC) que se debe direccionar.
• FrIf_AbsTimerIdx: Índice del temporizador absoluto específico cuya interrupción debe confirmarse.

La función suministra un valor de retorno del tipo Std_ReturnType para la evaluación del resultado [SWS_FrIf_05029]:

• E_OK: La llamada a la API del controlador Fr_AckAbsoluteTimerIRQ() se realizó con éxito.
• E_NOT_OK: El controlador FlexRay notificó E_NOT_OK en la llamada, o se detectó un error en el modo de desarrollo (Development Mode).

En cuanto al comportamiento de concurrencia, la función opera de forma síncrona. Las llamadas para diferentes FlexRay CC son reentrantes, mientras que las llamadas simultáneas para el mismo FlexRay CC no son reentrantes y deben evitarse [SWS_FrIf_05029].

La función FrIf_StartCommunication actúa como encapsulación de la función del controlador FlexRay Fr_StartCommunication() e inicia el comienzo de la comunicación de un controlador de comunicación FlexRay direccionado [SWS_FrIf_05005].

Uso y contexto de llamada

La interfaz está declarada a través de la cabecera FrIf.h y posee el ID de servicio 0x04 [SWS_FrIf_05005]. La invocación se procesa de forma asíncrona [SWS_FrIf_05005]. Como único parámetro de entrada sirve FrIf_CtrlIdx (tipo uint8), el cual define el índice del controlador de comunicación FlexRay que se va a controlar; no existen parámetros de entrada/salida ni de salida pura [SWS_FrIf_05005].

Tratamiento de errores y valores de retorno

La función devuelve un código de estado de tipo Std_ReturnType [SWS_FrIf_05005]:

• E_OK: la invocación del servicio de API subyacente en el controlador FlexRay se realizó con éxito y devolvió E_OK [SWS_FrIf_05005].
• E_NOT_OK: el servicio de API del controlador notificó E_NOT_OK o se detectó un error durante la ejecución en modo de desarrollo (Development Mode) [SWS_FrIf_05005].

Concurrencia y restricciones

Con respecto a la reentrancia, FrIf_StartCommunication es reentrante para índices de controlador que difieran entre sí (FrIf_CtrlIdx), pero no reentrante para valores de controlador idénticos [SWS_FrIf_05005]. Por lo tanto, en caso de accesos simultáneos, los módulos llamadores deben asegurarse de que no se produzcan llamadas concurrentes para el mismo controlador.

La función FrIf_HaltCommunication (ID de servicio 0x05) representa en la FlexRay Interface (FrIf) un wrapper para la llamada a la función de la API del controlador Fr_HaltCommunication() y se declara a través de la cabecera FrIf.h [SWS_FrIf_05006]. El servicio se ejecuta con semántica asíncrona [SWS_FrIf_05006]. Como único parámetro se pasa el valor de entrada FrIf_CtrlIdx, que especifica el índice del FlexRay Communication Controller que se debe direccionar en cada caso; para este servicio no se definen parámetros de entrada/salida ni parámetros de salida puros [SWS_FrIf_05006].

El valor de retorno es de tipo Std_ReturnType y señaliza el resultado de la invocación [SWS_FrIf_05006]:

• E_OK: la invocación del servicio de API en el controlador FlexRay fue exitosa y devolvió E_OK [SWS_FrIf_05006].
• E_NOT_OK: la llamada a la API del controlador FlexRay devolvió E_NOT_OK o se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05006].

En relación con la concurrencia, FrIf_HaltCommunication es reentrante para diferentes valores del índice del controlador FrIf_CtrlIdx, pero no reentrante con valores idénticos para FrIf_CtrlIdx [SWS_FrIf_05006]. Por consiguiente, las llamadas simultáneas o que originen interrupciones para el mismo controlador no están permitidas y deben evitarse en el contexto del llamador.

Uso y contexto de llamada

La función de interfaz síncrona FrIf_AbortCommunication actúa como wrapper directo para la función de API Fr_AbortCommunication() del controlador FlexRay [SWS_FrIf_05007]. Está declarada en el archivo de cabecera FrIf.h y posee el ID de servicio 0x06 [SWS_FrIf_05007].

A través del parámetro de entrada FrIf_CtrlIdx se especifica el índice del FlexRay Communication Controller al que se desea acceder [SWS_FrIf_05007]. Para esta interfaz no se definen parámetros adicionales de entrada o salida [SWS_FrIf_05007].

Valores de retorno y tratamiento de errores

La función devuelve un valor de estado del tipo Std_ReturnType [SWS_FrIf_05007]:

• E_OK: la llamada al servicio de API del controlador FlexRay fue correcta y devolvió E_OK [SWS_FrIf_05007].
• E_NOT_OK: el servicio de API del controlador FlexRay devolvió E_NOT_OK o se detectó un error en el modo de desarrollo [SWS_FrIf_05007].

Concurrencia y restricciones

La ejecución de FrIf_AbortCommunication es síncrona [SWS_FrIf_05007]. La función es reentrante para diferentes valores de FrIf_CtrlIdx, pero no reentrante para índices de controlador idénticos [SWS_FrIf_05007].

Uso y llamada

La función síncrona FrIf_SetState solicita una transición de estado en la máquina de estados de la interfaz FlexRay [SWS_FrIf_05174]. Como parámetros se pasan el índice del clúster FrIf_ClstIdx y la transición deseada FrIf_StateTransition. La función devuelve E_OK si la llamada se ejecutó con éxito y se aceptó el cambio de estado; en caso de error se devuelve E_NOT_OK [SWS_FrIf_05174].

Tratamiento de errores y condiciones límite

La función se define como no reentrante (Non Reentrant) [SWS_FrIf_05174]. Si el control de desarrollo está activado (FrIfDevErrorDetect == ON) y el parámetro FrIf_StateTransition contiene un valor no válido, la función notifica el código de error FRIF_E_INV_FRIF_STATE a través de Det_ReportError al módulo DET [SWS_FrIf_05037].

Interacción en transiciones a offline

Si se invoca FrIf_SetState con el parámetro de transición FRIF_STATE_OFFLINE, la interfaz FlexRay comprueba el contador TxConfCounter para cada PDU [SWS_FrIf_05501]. Si este valor es mayor que 0 para una PDU, el módulo informa a la capa superior con la llamada <UL>_TxConfirmation(id, E_NOT_OK) sobre el fallo de la confirmación pendiente [SWS_FrIf_05501].

La función FrIf_SendWUP (ID de servicio 0x0a) del módulo FrIf está disponible a través del archivo de cabecera FrIf.h y sirve como wrapper de interfaz para la llamada a la función de API Fr_SendWUP() del controlador FlexRay subyacente [SWS_FrIf_05011].

Uso y parámetros

El servicio se ejecuta de forma asíncrona [SWS_FrIf_05011]. Como único parámetro de transferencia sirve el parámetro de entrada FrIf_CtrlIdx de tipo uint8, que especifica el índice del FlexRay Communication Controller (FlexRay CC) que se va a direccionar [SWS_FrIf_05011]. No se utilizan parámetros de entrada/salida (inout) ni de salida (out) [SWS_FrIf_05011].

Valores de retorno y tratamiento de errores

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

• E_OK: la llamada al servicio de API del controlador FlexRay se ejecutó con éxito y notificó E_OK [SWS_FrIf_05011].
• E_NOT_OK: la llamada al servicio de API del controlador FlexRay devolvió E_NOT_OK o se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05011].

Concurrencia y reentrancia

Con respecto al acceso simultáneo, FrIf_SendWUP es reentrante para llamadas con diferentes valores para FrIf_CtrlIdx, pero no reentrante para valores idénticos de FrIf_CtrlIdx [SWS_FrIf_05011].

Uso y funcionamiento

La función FrIf_AllowColdstart sirve como wrapper para la API del controlador FlexRay Fr_AllowColdstart() conforme a [SWS_FrIf_05017]. Direcciona a través del parámetro de entrada FrIf_CtrlIdx el FlexRay Communication Controller (CC) al que se desea acceder [SWS_FrIf_05017]. La ejecución de la función está especificada como asíncrona [SWS_FrIf_05017].

Valores de retorno y tratamiento de errores

El valor de retorno de tipo Std_ReturnType refleja el resultado de la ejecución [SWS_FrIf_05017]:

• E_OK: El servicio API subyacente del controlador FlexRay se invocó con éxito y notificó E_OK [SWS_FrIf_05017].
• E_NOT_OK: La llamada al controlador falló (valor de retorno E_NOT_OK) o se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05017].

Interpretación: La detección de errores en el Development Mode probablemente se realice a través del módulo Default Error Tracer (DET), aunque en el extracto de la especificación no se documentan ID de error ni comprobaciones específicas. Pregunta Q-5dffd71d66731cc9 (abierta)

Concurrencia y restricciones

En cuanto a la reentrancia, FrIf_AllowColdstart no es reentrante para valores idénticos de FrIf_CtrlIdx, pero puede invocarse en paralelo para diferentes índices de controlador [SWS_FrIf_05017]. Por lo tanto, los llamadores deben asegurarse de sincronizar las llamadas concurrentes para el mismo controlador. La interfaz se proporciona mediante el encabezado FrIf.h [SWS_FrIf_05017].

La función síncrona FrIf_Transmit solicita la transmisión de una PDU a través de la FlexRay Interface [SWS_FrIf_05033]. Recibe el ID de la PDU que se va a transmitir (TxPduId), así como un puntero a la estructura PduInfoPtr, la cual proporciona la longitud de la PDU, el puntero de datos y los metadatos [SWS_FrIf_05033].

En lo referente a concurrencia y reentrancia, FrIf_Transmit es reentrante para diferentes ID de PDU, pero no reentrante para el mismo ID de PDU [SWS_FrIf_05033]. La invocación devuelve E_OK en cuanto se acepta la solicitud de transmisión; de lo contrario, E_NOT_OK [SWS_FrIf_05033].

Se lleva a cabo una comprobación de error específica en las PDU inmediatas (Immediate PDUs), siempre que las longitudes dinámicas de L-SDU estén desactivadas estableciendo el parámetro de configuración FrIfAllowDynamicLSduLength en FALSE [SWS_FrIf_05757]:

• La longitud transferida en PduInfoPtr se comprueba frente a la longitud de PDU configurada estáticamente [SWS_FrIf_05757].
• Si el valor de longitud no coincide, FrIf_Transmit cancela la transmisión de la Immediate PDU y devuelve E_NOT_OK [SWS_FrIf_05757].
• Siempre que la detección de desarrollo (FrIfDevErrorDetect == ON) esté activa, la función notifica el error de desarrollo FRIF_E_INV_PDULENGTH a través de Det_ReportError al módulo DET [SWS_FrIf_05757].

La interfaz síncrona FrIf_SetTransceiverMode con el ID de servicio 0x13 actúa en la interfaz FlexRay como un wrapper para la función de controlador FrTrcv_SetTransceiverMode() del controlador de transceptor FlexRay y está disponible a través del archivo de cabecera FrIf.h [SWS_FrIf_05034]. Permite a las capas superiores configurar el modo de funcionamiento de un transceptor para un controlador FlexRay y un canal determinados [SWS_FrIf_05034].

Durante la llamada se deben pasar tres parámetros: el índice de controlador FrIf_CtrlIdx para direccionar el FlexRay Communication Controller, el índice de canal FrIf_ChnlIdx para determinar el canal FlexRay dentro del ámbito del controlador, así como el modo de transceptor deseado FrIf_TrcvMode de tipo FrTrcv_TrcvModeType [SWS_FrIf_05034]. No existen parámetros de entrada/salida ni de salida [SWS_FrIf_05034]. Para el parámetro FrIf_ChnlIdx rige el requisito vinculante de que el valor de enumeración FR_CHANNEL_AB no se debe utilizar bajo ningún concepto [SWS_FrIf_05034].

La función está especificada como reentrante y reenvía el cambio de modo de forma síncrona al controlador del transceptor [SWS_FrIf_05034]. Como resultado, devuelve el estado Std_ReturnType: notifica E_OK si la llamada al servicio de API en el controlador del transceptor devolvió con éxito E_OK; si esta llamada al controlador falla y devuelve E_NOT_OK, también se devuelve E_NOT_OK [SWS_FrIf_05034].

La función síncrona FrIf_ClearTransceiverWakeup (ID de servicio 0x18) actúa como envoltorio dentro de la interfaz FlexRay y encapsula la llamada a la función de API FrTrcv_ClearTransceiverWakeup() del controlador del transceptor FlexRay [SWS_FrIf_05039]. La interfaz está disponible a través del archivo de encabezado FrIf.h [SWS_FrIf_05039].

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

• FrIf_CtrlIdx: Índice del FlexRay Communication Controller al que se debe direccionar [SWS_FrIf_05039].
• FrIf_ChnlIdx: Índice del canal FlexRay al que se debe acceder dentro del ámbito del controlador FrIf_CtrlIdx [SWS_FrIf_05039].

No se definen otros parámetros (inout u out) para la función [SWS_FrIf_05039].

En lo relativo a la concurrencia y las restricciones, la función está clasificada como reentrante [SWS_FrIf_05039]. Como restricción funcional fundamental, la especificación estipula que el valor de enumeración FR_CHANNEL_AB no debe utilizarse para el parámetro FrIf_ChnlIdx [SWS_FrIf_05039].

El resultado de la operación se devuelve de forma síncrona como Std_ReturnType y refleja directamente el resultado del servicio del controlador [SWS_FrIf_05039]:

• E_OK: El servicio API del controlador del transceptor FlexRay se ejecutó con éxito y devolvió E_OK [SWS_FrIf_05039].
• E_NOT_OK: La llamada al servicio del controlador falló y notificó E_NOT_OK [SWS_FrIf_05039].

La función FrIf_CancelAbsoluteTimer sirve para la cancelación síncrona de un temporizador absoluto configurado en un controlador de comunicación (CC) FlexRay [SWS_FrIf_05023]. Actúa como wrapper en torno a la correspondiente función de controlador Fr_CancelAbsoluteTimer() del controlador FlexRay y está disponible a través de la cabecera FrIf.h [SWS_FrIf_05023].

Parámetros y valores de retorno

Al invocarla se transfieren dos parámetros de entrada [SWS_FrIf_05023]:

• FrIf_CtrlIdx: índice del controlador FlexRay que se va a direccionar.
• FrIf_AbsTimerIdx: índice del temporizador absoluto que se va a cancelar.

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

• E_OK: la llamada subyacente a la API del controlador FlexRay finalizó con éxito con E_OK [SWS_FrIf_05023].
• E_NOT_OK: la llamada a la API del controlador falló (devolución E_NOT_OK) o se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05023].

Concurrencia y restricciones

La ejecución se realiza de forma síncrona con el Service-ID 0x1b [SWS_FrIf_05023]. En cuanto a la reentrancia, el servicio es reentrante para diferentes FlexRay CC, pero no debe invocarse concurrentemente para el mismo FlexRay CC [SWS_FrIf_05023].

La función FrIf_DisableAbsoluteTimerIRQ forma parte del módulo de interfaz FlexRay y se proporciona mediante el archivo de cabecera FrIf.h [SWS_FrIf_05031]. Sirve como wrapper síncrono para la función Fr_DisableAbsoluteTimerIRQ() de la API del controlador FlexRay y reenvía al nivel de controlador la solicitud para desactivar la generación de interrupciones del temporizador absoluto direccionado [SWS_FrIf_05031].

Contexto de llamada y parámetros

La llamada se realiza de forma síncrona utilizando el Service-ID 0x23 [SWS_FrIf_05031]. La interfaz no dispone de parámetros de entrada/salida ni exclusivamente de salida, pero exige dos parámetros de entrada obligatorios [SWS_FrIf_05031]:

• FrIf_CtrlIdx: índice del controlador de comunicación (CC) FlexRay que se desea abordar [SWS_FrIf_05031].
• FrIf_AbsTimerIdx: índice del temporizador absoluto que se va a configurar [SWS_FrIf_05031].

Valores de retorno y tratamiento de errores

La función devuelve el estado a la entidad llamante mediante el tipo de retorno Std_ReturnType [SWS_FrIf_05031]:

• E_OK: señala que la llamada al servicio de API del controlador FlexRay fue exitosa y devolvió E_OK [SWS_FrIf_05031].
• E_NOT_OK: indica que el servicio de API del controlador FlexRay devolvió E_NOT_OK o que se detectó un error en el modo de desarrollo (Development Mode) [SWS_FrIf_05031].

Concurrencia y reentrancia

Conforme a los requisitos de reentrancia, FrIf_DisableAbsoluteTimerIRQ es no reentrante para el mismo controlador de comunicación FlexRay, pero reentrante para diferentes FlexRay CC [SWS_FrIf_05031]. Por tanto, las llamadas para la misma instancia de controlador no deben realizarse concurrentemente desde diferentes contextos sin sincronización.

La interfaz síncrona FrIf_AllSlots sirve dentro de la interfaz FlexRay como wrapper para la llamada a la función de controlador subyacente Fr_AllSlots del controlador FlexRay [SWS_FrIf_05020]. La función se proporciona a través del archivo de cabecera FrIf.h y posee el Service-ID 0x33 [SWS_FrIf_05020]. Como único parámetro de transferencia se espera FrIf_CtrlIdx, el cual define el índice lógico del controlador de comunicación FlexRay que se desea abordar [SWS_FrIf_05020]. Para este servicio no están previstos parámetros de entrada/salida ni de salida (inout/out) [SWS_FrIf_05020].

Como valor de retorno, la función proporciona el estado Std_ReturnType con los siguientes significados [SWS_FrIf_05020]:

• E_OK: la llamada a la API del controlador Fr_AllSlots fue exitosa y devolvió E_OK [SWS_FrIf_05020].
• E_NOT_OK: la llamada al controlador FlexRay falló o bien devolvió E_NOT_OK, o se detectó un error durante la ejecución en modo de desarrollo [SWS_FrIf_05020].

Respecto al comportamiento en tiempo de ejecución y a la concurrencia, FrIf_AllSlots está especificada como no reentrante (non reentrant) [SWS_FrIf_05020]. Por tanto, la entidad llamante debe garantizar que queden excluidas llamadas simultáneas o superpuestas para el controlador afectado. Interpretación: Es de suponer que la llamada debe tener lugar desde un contexto de tarea protegido, ya que la interfaz no proporciona una gestión propia de reentrancia en caso de accesos paralelos. Pregunta Q-e4ce542c60b470c8 (abierta)

usar

La función síncrona FrIf_CancelTransmit solicita la cancelación de una transmisión de PDU en curso en un módulo de comunicación subyacente [SWS_FrIf_05070]. Como parámetro de entrada se pasa TxPduId, que identifica la PDU que se va a cancelar. La ejecución se realiza de forma síncrona y devuelve un valor de retorno de tipo Std_ReturnType [SWS_FrIf_05070]:

• E_OK: La cancelación de la transmisión fue ejecutada con éxito por el módulo de destino.
• E_NOT_OK: La cancelación fue rechazada por el módulo de destino.

Concurrencia y restricciones

En cuanto a la concurrencia, FrIf_CancelTransmit es reentrante para diferentes ID de PDU, pero no es reentrante para la misma TxPduId [SWS_FrIf_05070]. Por lo tanto, en caso de llamadas desde contextos paralelos para la misma ID de PDU, probablemente sea necesaria una sincronización externa por parte del llamador a fin de evitar condiciones de carrera (race conditions). Pregunta Q-38e799ac1564f60f (abierta)

Tratamiento de errores e integración

En la interfaz no se definen códigos de error específicos de DET o DEM; el fallo de una cancelación se señala directamente mediante el valor de retorno E_NOT_OK [SWS_FrIf_05070]. El servicio posee el ID de servicio 0x4a y se proporciona mediante el archivo de encabezado FrIf.h [SWS_FrIf_05070].

La función FrIf_DisableLPdu sirve como wrapper para la función de controlador Fr_DisableLPdu del controlador FlexRay y desactiva el recurso de hardware subyacente de una L-PDU para la transmisión o la recepción [SWS_FrIf_05710].

Invocación y parámetros

La llamada a FrIf_DisableLPdu se realiza de forma síncrona a través de la interfaz FrIf.h con el ID de servicio 0x28 [SWS_FrIf_05710]. La función espera dos parámetros de entrada:

• FrIf_CtrlIdx: índice del FlexRay Communication Controller en el contexto de la interfaz FlexRay [SWS_FrIf_05710].
• FrIf_LPduIdx: índice unívoco para la identificación de la trama FlexRay afectada [SWS_FrIf_05710].

Valores de retorno y tratamiento de errores

La función devuelve como resultado un estado de tipo Std_ReturnType [SWS_FrIf_05710]:

• E_OK: la llamada a la API se completó con éxito [SWS_FrIf_05710].
• E_NOT_OK: la llamada a la API se canceló debido a errores [SWS_FrIf_05710].

Concurrencia y restricciones

En cuanto al comportamiento de concurrencia, FrIf_DisableLPdu está especificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_FrIf_05710]. Por lo tanto, las llamadas paralelas para el mismo controlador o el mismo dispositivo deben evitarse o sincronizarse en el lado del llamador.

La función FrIf_EnableTransceiverBranch encapsula, como wrapper síncrono y reentrante, la llamada a la API FrTrcv_EnableTransceiverBranch del controlador del transceptor FlexRay subyacente [SWS_FrIf_05085]. A través de esta interfaz se activa de manera selectiva una rama determinada de un transceptor, por ejemplo en el contexto de una estrella activa [SWS_FrIf_05085]. La declaración de la función y los tipos correspondientes se proporcionan mediante el archivo de encabezado FrIf.h [SWS_FrIf_05085].

Parámetros y condiciones de llamada

En la llamada deben transferirse tres parámetros de entrada [SWS_FrIf_05085]:

• FrIf_CtrlIdx: direcciona el índice del FlexRay Communication Controller respectivo [SWS_FrIf_05085].
• FrIf_ChnlIdx: especifica el canal FlexRay dentro del ámbito de validez del controlador FrIf_CtrlIdx [SWS_FrIf_05085]. En este caso se aplica la restricción obligatoria de que no se debe utilizar el valor de enumeración FR_CHANNEL_AB [SWS_FrIf_05085].
• FrIf_BranchIdx: determina, a través de un índice basado en cero, la rama concreta del transceptor sobre la cual se aplica la activación [SWS_FrIf_05085].

Valores de retorno

La función devuelve un valor de estado de tipo Std_ReturnType, el cual refleja directamente el resultado de la llamada redirigida al controlador [SWS_FrIf_05085]:

• E_OK: la llamada al servicio del controlador FrTrcv_EnableTransceiverBranch fue correcta y devolvió E_OK [SWS_FrIf_05085].
• E_NOT_OK: la llamada al servicio del controlador notificó E_NOT_OK [SWS_FrIf_05085].

La función síncrona y reentrante FrIf_DisableTransceiverBranch encapsula, como función envoltorio, el servicio FrTrcv_DisableTransceiverBranch del controlador del transceptor FlexRay [SWS_FrIf_05028]. Se proporciona a través del archivo de encabezado FrIf.h, posee el ID de servicio 0x37 y sirve para desactivar de forma selectiva una rama específica de un transceptor en estrella activo [SWS_FrIf_05028].

En la llamada deben pasarse tres parámetros de entrada:

• FrIf_CtrlIdx: Índice del controlador FlexRay al que se debe direccionar [SWS_FrIf_05028].
• FrIf_ChnlIdx: Canal FlexRay dentro del ámbito del controlador. En este caso rige el requisito vinculante de que no debe utilizarse el valor de enumeración FR_CHANNEL_AB [SWS_FrIf_05028].
• FrIf_BranchIdx: Índice basado en cero que identifica la rama respectiva del transceptor sobre la cual debe aplicarse la operación [SWS_FrIf_05028].

Como valor de retorno, la interfaz devuelve un estado de tipo Std_ReturnType. Devuelve E_OK si la llamada al controlador del transceptor fue exitosa, y E_NOT_OK si el servicio del controlador notificó E_NOT_OK [SWS_FrIf_05028]. En el alcance de la especificación no se documentan notificaciones de error específicas de DET o DEM; un fallo probablemente resulte directamente del comportamiento del controlador subyacente. Pregunta Q-52d5e5fedd147532 (abierta)

La función síncrona FrIf_ReconfigLPdu sirve para reconfigurar una L-PDU en la interfaz FlexRay (FrIf) y reenvía la llamada directamente a la interfaz de controlador Fr_ReconfigLPdu del controlador FlexRay [SWS_FrIf_05048]. La interfaz se pone a disposición mediante el encabezado FrIf.h [SWS_FrIf_05048].

Parámetros y restricciones de configuración

• FrIf_CtrlIdx: direcciona el índice del controlador de comunicación FlexRay dentro del controlador FlexRay [SWS_FrIf_05048].
• FrIf_LPduIdx: determina el índice unívoco para la identificación de la trama FlexRay que se va a configurar [SWS_FrIf_05048].
• FrIf_FrameId, FrIf_CycleRepetition, FrIf_CycleOffset: definen el nuevo ID de trama FlexRay, así como la repetición y el desplazamiento del mecanismo de filtrado de ciclos de la L-PDU [SWS_FrIf_05048].
• FrIf_ChnlIdx: determina el canal FlexRay de tipo Fr_ChannelType [SWS_FrIf_05048]. En este caso se prescribe estrictamente que no se debe utilizar el valor de enumeración FR_CHANNEL_AB [SWS_FrIf_05048].
• FrIf_PayloadLength y FrIf_HeaderCRC: establecen la longitud de datos útiles en bytes, así como el CRC de encabezado correspondiente, a los que se debe ajustar la L-PDU [SWS_FrIf_05048].

Valores de retorno y contexto de ejecución

El valor de retorno de tipo Std_ReturnType indica el resultado de la reconfiguración: E_OK señaliza la ejecución correcta de la llamada a la API, mientras que E_NOT_OK indica una cancelación por error [SWS_FrIf_05048].

La función es síncrona y está especificada como no reentrante (Non Reentrant) [SWS_FrIf_05048]. Por consiguiente, no se debe llamar de forma concurrente.

La función FrIf_ReadCCConfig representa un servicio síncrono de la interfaz FlexRay con el Service-ID 0x3b y está declarada mediante el encabezado FrIf.h [SWS_FrIf_05313]. Su cometido principal consiste en actuar como wrapper llamando a la función de controlador Fr_ReadCCConfig() del controlador FlexRay subyacente para leer parámetros de configuración de un controlador [SWS_FrIf_05313].

La interfaz espera tres parámetros al invocarse [SWS_FrIf_05313]:

• FrIf_CtrlIdx (entrada): el índice numérico del controlador de comunicación FlexRay (CC) al que se debe acceder.
• FrIf_ConfigParamIdx (entrada): el índice del parámetro de configuración específico cuyo valor se va a consultar.
• FrIf_ConfigParamValuePtr (salida): un puntero a la ubicación de memoria en la que se depositará el valor de configuración de 32 bits leído.

El valor de retorno de tipo Std_ReturnType señaliza el resultado de la consulta [SWS_FrIf_05313]:

• E_OK: la llamada a la API del controlador Fr_ReadCCConfig() se ejecutó correctamente y devolvió E_OK.
• E_NOT_OK: el controlador FlexRay notificó E_NOT_OK o se detectó un error durante la ejecución en modo de desarrollo (Development Mode).

En lo que respecta a la concurrencia y al entorno de ejecución, FrIf_ReadCCConfig es no reentrante para el mismo controlador FlexRay, pero reentrante para controladores diferentes [SWS_FrIf_05313]. En caso de accesos al mismo controlador, el llamador debe garantizar, por tanto, una sincronización adecuada. Se asume que un error detectado en modo de desarrollo probablemente se reenvíe al Default Error Tracer (DET). Pregunta Q-bfe56460515de4de (abierta)

Uso y semántica

La función síncrona FrIf_EnableBusMirroring conmuta el mirroring del bus para todos los controladores FlexRay conectados al clúster FlexRay transmitido [SWS_FrIf_05726]. Mediante el parámetro FrIf_ClstIdx se direcciona el clúster respectivo. El parámetro booleano FrIf_MirroringActive determina el modo: al pasar TRUE, se invoca la interfaz Mirror_ReportFlexRayFrame para cada trama recibida o enviada en los controladores; con FALSE, se desactiva el reenvío de las tramas al módulo de Mirror [SWS_FrIf_05726].

Valores de retorno y tratamiento de errores

La llamada a la función devuelve un estado del tipo Std_ReturnType [SWS_FrIf_05726]:

• E_OK: El modo de duplicación para el clúster especificado se actualizó correctamente [SWS_FrIf_05726].
• E_NOT_OK: La conmutación fue rechazada si la función de duplicación está desactivada globalmente (parámetro de configuración FrIfBusMirroringSupport) o si se presenta un índice no válido [SWS_FrIf_05726]. Interpretación: la indicación de especificación FrIf_CtrlIdx en E_NOT_OK probablemente se refiera, a pesar de la denominación discrepante, a la verificación del índice de clúster FrIf_ClstIdx o de los controladores asignados. Pregunta Q-9daba2ff2b1a3ff1 (abierta)

Concurrencia e integración

La función está declarada como reentrante y posee el Service-ID 0x4b; se proporciona a través del archivo de cabecera FrIf.h [SWS_FrIf_05726]. Los llamantes deben tener en cuenta que la ejecución se realiza de forma síncrona. No se listan canales de error adicionales mediante DET o DEM para este servicio.

Uso y contexto de llamada

La función FrIf_CheckWakeupByTransceiver (Service-ID 0x39) actúa en la interfaz FlexRay como un wrapper síncrono para la función FrTrcv_CheckWakeupByTransceiver() del controlador del transceptor FlexRay [SWS_FrIf_05041]. Se proporciona mediante el encabezado FrIf.h y no tiene valor de retorno [SWS_FrIf_05041].

Para direccionar la instancia de hardware respectiva, la interfaz requiere dos parámetros obligatorios [SWS_FrIf_05041]:

• FrIf_CtrlIdx (parámetro de entrada, uint8): índice del FlexRay Communication Controller que se va a direccionar [SWS_FrIf_05041].
• FrIf_ChnlIdx (parámetro de entrada, Fr_ChannelType): índice del canal FlexRay al que se debe acceder dentro del ámbito de validez del controlador especificado FrIf_CtrlIdx [SWS_FrIf_05041].

Concurrencia y restricciones

La especificación clasifica la interfaz como reentrante, de modo que las llamadas síncronas se pueden emitir de forma concurrente [SWS_FrIf_05041].

Para el parámetro de canal FrIf_ChnlIdx existe una restricción de uso estricta: el valor de enumeración FR_CHANNEL_AB no se debe transferir [SWS_FrIf_05041]. Interpretación: esto probablemente signifique que el controlador de transceptor subyacente no admite una comprobación combinada de reactivación (wakeup) de ambos canales en una sola llamada y que, en su lugar, los sistemas con dos canales FlexRay deben comprobarse secuencialmente o por separado para cada canal. Pregunta Q-a30cf39f0d3ca295 (abierta)

La función de callback <User_RxIndication> sirve para señalar la recepción de una PDU procedente de la capa de interfaz de comunicación subyacente [SWS_FrIf_05045]. Interpretación: El identificador probablemente represente un callback configurable de una capa superior al que se le notifica a la llegada de datos FlexRay. Pregunta Q-a9037bc7502dd9ea (abierta)

Uso y parámetros

La ejecución se realiza de forma síncrona sin valor de retorno (void) [SWS_FrIf_05045]. En la llamada se pasan dos parámetros de entrada [SWS_FrIf_05045]:

• RxPduId (PduIdType): Identificador único de la PDU recibida [SWS_FrIf_05045].
• PduInfoPtr (const PduInfoType*): Puntero a una estructura con la longitud de la PDU recibida (SduLength), un puntero al búfer con los datos útiles (SduDataPtr), así como los metadatos correspondientes [SWS_FrIf_05045].

Concurrencia y configuración

En cuanto a la reentrancia, la función es reentrante para diferentes ID de PDU, pero no debe invocarse de forma reentrante para la misma ID de PDU [SWS_FrIf_05045]. La interfaz está disponible de forma configurable en el módulo (“Available via configurable”) [SWS_FrIf_05045]. En las fuentes no se definen códigos de error específicos, valores de retorno ni notificaciones a DET y DEM para esta interfaz [SWS_FrIf_05045].

La función de callback configurable <User_TxConfirmation> es invocada por el módulo de interfaz de comunicación subyacente para confirmar la finalización de un proceso de envío para una PDU [SWS_FrIf_05046]. Notifica de forma síncrona a la capa superior si la transmisión de la PDU correspondiente se ha realizado correctamente o ha fallado [SWS_FrIf_05046].

La interfaz no posee valor de retorno (void) y espera dos parámetros de entrada [SWS_FrIf_05046]:

• TxPduId (tipo PduIdType): Designa el ID único de la PDU transmitida [SWS_FrIf_05046].
• result (tipo Std_ReturnType): Indica el resultado de la transmisión, donde E_OK confirma la transmisión exitosa y E_NOT_OK notifica el fallo de la transmisión de la PDU [SWS_FrIf_05046].

La función opera de forma síncrona [SWS_FrIf_05046]. Respecto a la concurrencia, es reentrante para diferentes ID de PDU, pero no reentrante para la misma TxPduId [SWS_FrIf_05046]. Por tanto, deben excluirse las llamadas de confirmación paralelas para ID de PDU idénticos.

Para esta llamada no se especifican códigos de error concretos además de E_NOT_OK ni notificaciones específicas a DET o DEM [SWS_FrIf_05046]. Interpretación: Dado que la interfaz se indica como configurable, el identificador <User_TxConfirmation> probablemente sirva como marcador de posición para el nombre de función configurado realmente en la capa superior [SWS_FrIf_05046]. Pregunta Q-f2a08258df49b3ec (abierta)

usar

La función de callback síncrona <User_TriggerTransmit> se invoca para solicitar datos de SDU de una capa superior para su transmisión [SWS_FrIf_05047]. Como parámetros se pasan el identificador TxPduId de la SDU a enviar, así como el puntero PduInfoPtr de tipo PduInfoType* [SWS_FrIf_05047]. El llamador proporciona un búfer de destino mediante PduInfoPtr->SduDataPtr e indica en PduInfoPtr->SduLength el tamaño de búfer disponible [SWS_FrIf_05047].

El módulo invocado de la capa superior comprueba si los datos disponibles caben en el tamaño de búfer especificado [SWS_FrIf_05047]:

• Si los datos caben, el módulo los copia en PduInfoPtr->SduDataPtr, actualiza PduInfoPtr->SduLength con el número de bytes realmente copiados y devuelve E_OK [SWS_FrIf_05047].
• Si los datos no caben, el módulo devuelve E_NOT_OK sin modificar PduInfoPtr [SWS_FrIf_05047].

Tratamiento de errores y concurrencia

En caso de error (valor de retorno E_NOT_OK), no se han copiado datos de SDU. En este caso, no se debe seguir utilizando PduInfoPtr, ya que puede contener un puntero NULL o apuntar a datos no válidos [SWS_FrIf_05047].

La interfaz es reentrante para diferentes ID de PDU, pero no reentrante para el mismo ID de PDU [SWS_FrIf_05047]. La disponibilidad de la función es configurable [SWS_FrIf_05047].

La función <Free_Op_A> está diseñada como una operación de comunicación definida por el usuario en la interfaz FlexRay para admitir características específicas del hardware o de rendimiento adicionales del Communication Controller a fin de incrementar el rendimiento global [SWS_FrIf_05316]. La declaración de esta interfaz se proporciona a través del encabezado FrIf_Externals.h [SWS_FrIf_05316].

Para la llamada se prescriben dos parámetros funcionales de entrada [SWS_FrIf_05316]:

• FrIf_CtrlIdx (tipo uint8): Identifica como índice el FlexRay Communication Controller concreto al que se debe acceder [SWS_FrIf_05316].
• FrIf_LPduIdx (tipo uint16): Sirve como índice unívoco para identificar la trama FlexRay respectiva [SWS_FrIf_05316].

La operación se ejecuta de forma síncrona y no tiene valor de retorno (void); tampoco están previstos parámetros de entrada y salida [SWS_FrIf_05316]. En cuanto a la concurrencia y al contexto de llamada, la función es reentrante para diferentes valores de FrIf_LPduIdx, pero explícitamente no reentrante si se utiliza el mismo índice FrIf_LPduIdx [SWS_FrIf_05316].

En la especificación no se indican códigos de error específicos ni mecanismos de supervisión de errores a través del módulo Default Error Tracer (DET) o Diagnostic Event Manager (DEM) [SWS_FrIf_05316]. Por lo tanto, los componentes llamantes deben asegurarse antes de la ejecución de que no se produzcan accesos concurrentes al mismo índice de trama [SWS_FrIf_05316].

La función definida por el usuario <Free_Op_B> sirve para llevar a cabo operaciones de comunicación específicas del usuario en la interfaz FlexRay [SWS_FrIf_05317]. Su propósito consiste en admitir características de rendimiento adicionales o específicas del hardware del controlador de comunicación FlexRay, con el fin de incrementar el rendimiento de la comunicación [SWS_FrIf_05317]. La declaración de la función se proporciona a través del archivo de cabecera FrIf_Externals.h [SWS_FrIf_05317].

Invocación y parámetros

La operación se invoca de forma síncrona y no proporciona ningún valor de retorno (void) [SWS_FrIf_05317]. Procesa dos parámetros de entrada, mientras que no existen parámetros de entrada/salida ni de salida [SWS_FrIf_05317]:

• FrIf_CtrlIdx: índice del controlador de comunicación FlexRay al que se debe acceder (tipo uint8) [SWS_FrIf_05317].
• FrIf_LPduIdx: índice unívoco para identificar la trama FlexRay correspondiente (tipo uint16) [SWS_FrIf_05317].

Concurrencia y restricciones

En lo que respecta a la reentrancia, la función está especificada como reentrante para diferentes índices de LPdu (FrIf_LPduIdx), pero explícitamente como no reentrante para el mismo índice de LPdu [SWS_FrIf_05317]. Por lo tanto, los llamadores deben asegurarse de que no se produzcan llamadas simultáneas para la misma PDU.

Interpretación: Dado que la operación está marcada como definida por el usuario y se encuentra en FrIf_Externals.h, es de suponer que la implementación real deba proporcionarse de forma específica para el usuario o ampliando el controlador. Pregunta Q-6668832db63b9906 (abierta)

usar

La función de notificación <UL_ Tx Conflict Notification> se invoca en cuanto se detecta un conflicto de transmisión (Tx Conflict) en la interfaz FlexRay [SWS_FrIf_91001]. La declaración de esta interfaz se pone a disposición a través del archivo de cabecera Fr If_ Externals.h [SWS_FrIf_91001].

La función no tiene valor de retorno y recibe dos parámetros de entrada [SWS_FrIf_91001]:

• Fr If_ Ctrl Idx: Identificador del FlexRay Communication Controller direccionado [SWS_FrIf_91001].
• Fr If_ LPdu Idx: Identificador de la trama FlexRay transmitida afectada [SWS_FrIf_91001].

Concurrencia y restricciones

La llamada se realiza con semántica síncrona [SWS_FrIf_91001]. En lo relativo a la concurrencia, la ejecución es reentrante para diferentes índices de Fr If_ LPdu Idx, pero explícitamente no reentrante para el mismo índice LPdu [SWS_FrIf_91001]. Por lo tanto, durante la implementación debe asegurarse de evitar llamadas simultáneas para el mismo índice de trama.

Tratamiento de errores e interacción

La especificación no define para esta interfaz de callback ningún mensaje DET o DEM por separado ni códigos de error específicos [SWS_FrIf_91001]. Interpretación: es probable que la capa superior proporcione la llamada para poder registrar o tratar los conflictos que hayan surgido de forma directa en el tramo de transmisión FlexRay. Pregunta Q-fc63c251dbc03307 (abierta)

Uso y rango de valores

El tipo de enumeración FrIf_StateType se define en el archivo de cabecera FrIf.h y sirve en la interfaz FlexRay para representar el estado operativo actual de un FlexRay Communication Controller (FlexRay CC) [SWS_FrIf_05755]. Las variables de este tipo registran si un controlador está listo para el servicio de comunicación y si existe sincronización con el clúster FlexRay [SWS_FrIf_05755].

El rango de valores comprende dos estados definidos [SWS_FrIf_05755]:

• FRIF_STATE_OFFLINE: El FlexRay CC no está listo para la comunicación y el clúster FlexRay no está sincronizado [SWS_FrIf_05755].
• FRIF_STATE_ONLINE: El FlexRay CC está listo para la comunicación y el clúster FlexRay está sincronizado [SWS_FrIf_05755].

Integración y condiciones de contorno

Los estados reflejan fases fundamentales de la comunicación: mientras esté presente FRIF_STATE_OFFLINE, no puede tener lugar una comunicación regular del clúster a través del controlador, mientras que FRIF_STATE_ONLINE caracteriza el funcionamiento sincronizado de transmisión y recepción [SWS_FrIf_05755]. Dado que el extracto de la especificación no menciona otras firmas de API ni mensajes de error, es de suponer que el tipo se utilice primordialmente en consultas de estado o transiciones de estado de la interfaz FlexRay. Pregunta Q-071cd300dcaa0a3b (abierta)

El tipo de enumeración FrIf_StateTransitionType se proporciona a través del archivo de encabezado FrIf.h y sirve, según [SWS_FrIf_05303], para la representación o solicitud de transiciones de estado para un FlexRay Communication Controller (FlexRay CC).

Uso y rango de valores

Las variables de este tipo toman valores para solicitar cambios de estado específicos de un FlexRay CC [SWS_FrIf_05303]. El rango de valores comprende los siguientes literales:

• FRIF_GOTO_OFFLINE: Literal para solicitar una transición al estado FRIF_STATE_OFFLINE [SWS_FrIf_05303].
• FRIF_GOTO_ONLINE: Literal para solicitar una transición al estado FRIF_STATE_ONLINE [SWS_FrIf_05303].

Contexto e interacción

Aunque la descripción formal del tipo habla de la representación del estado de un FlexRay CC, los literales definidos sugieren la interpretación de que este tipo de enumeración sirve primordialmente como parámetro de control para ordenar cambios de estado (offline u online) [SWS_FrIf_05303]. Dado que el payload no enumera otras interfaces, requisitos de reentrancia ni códigos de error para este tipo, se aplican las reglas generales de inclusión mediante el archivo de encabezado FrIf.h.