FlexRay Driver (Fr)

La función síncrona Fr_Init sirve para inicializar el controlador FlexRay (Fr) conforme a [SWS_Fr_00032]. Está declarada a través del archivo de cabecera Fr.h y posee el Service-ID 0x1c [SWS_Fr_00032]. Como único parámetro de entrada, la interfaz espera Fr_ConfigPtr de tipo const Fr_ConfigType* [SWS_Fr_00032]. Este puntero apunta a una estructura de configuración dependiente del controlador que proporciona toda la información necesaria para el posterior funcionamiento operativo del controlador FlexRay [SWS_Fr_00032]. La función no posee parámetros de entrada/salida ni parámetros de salida y no devuelve ningún valor (void) [SWS_Fr_00032].

En cuanto a la concurrencia y las restricciones, Fr_Init está especificada como no reentrante (Non Reentrant) [SWS_Fr_00032]. Por lo tanto, las llamadas no deben realizarse bajo ningún concepto de forma paralela o anidada. Dado que la estructura de configuración transferida contiene todos los datos fundamentales para el funcionamiento posterior, la inicialización se realizaría típicamente de forma secuencial en la fase de inicio de todo el sistema, antes de que se invoquen otros servicios del módulo [SWS_Fr_00032]. Pregunta Q-a208c696fbb083d4 (abierta)

En la definición del servicio no está previsto un tratamiento de errores mediante códigos de error específicos o respuestas de estado [SWS_Fr_00032]. Requisitos adicionales, por ejemplo relativos a notificaciones al DET o DEM, no están documentados en el presente conjunto de datos.

La función síncrona Fr_ControllerInit sirve para inicializar un FlexRay Communication Controller (FlexRay CC) en el contexto del controlador FlexRay [SWS_Fr_00017]. Está declarada en el archivo de cabecera Fr.h y posee el Service ID 0x00 [SWS_Fr_00017]. A través del parámetro de entrada Fr_CtrlIdx de tipo uint8 se pasa el índice del controlador que se va a inicializar [SWS_Fr_00017].

Como valor de retorno, la función proporciona el estado Std_ReturnType [SWS_Fr_00017]:

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

En el alcance de la interfaz especificada no se indican códigos de error detallados ni notificaciones a DET o DEM [SWS_Fr_00017].

En lo que respecta a la concurrencia, la función está clasificada como no reentrante para la misma unidad de hardware (Non Reentrant for the same device) [SWS_Fr_00017]. Por tanto, una llamada para el mismo índice de controlador Fr_CtrlIdx no debe realizarse simultáneamente; por el contrario, presumiblemente sean admisibles llamadas paralelas para diferentes controladores [SWS_Fr_00017]. Pregunta Q-5bbbba38e8530b43 (abierta) Dado que no se definen parámetros de entrada y salida (inout/out), la inicialización se realiza puramente basada en estados en el controlador [SWS_Fr_00017].

La función Fr_StartCommunication sirve para iniciar la comunicación FlexRay en un controlador indicado [SWS_Fr_00010]. La interfaz está disponible a través del archivo de cabecera Fr.h [SWS_Fr_00010].

usar

La llamada se realiza de forma asíncrona pasando el parámetro Fr_CtrlIdx (ID de servicio 0x03), el cual indica el índice del controlador de comunicación FlexRay en el contexto del controlador de dispositivo [SWS_Fr_00010]. Como valor de retorno, la función devuelve un estado de tipo Std_ReturnType [SWS_Fr_00010]:

• E_OK: la llamada a la API finalizó con éxito [SWS_Fr_00010]. Interpretación: debido a la semántica asíncrona, es de esperar que esto signifique la aceptación exitosa de la orden de inicio, mientras que el establecimiento real de la conexión se realiza a continuación. Pregunta Q-fabca57ea7d32a05 (abierta)
• E_NOT_OK: la llamada a la API se canceló debido a errores [SWS_Fr_00010].

Concurrencia y restricciones

Para el mismo controlador FlexRay, Fr_StartCommunication está especificada como no reentrante [SWS_Fr_00010]. En cambio, para diferentes instancias de controlador, la llamada es reentrante. Los datos de especificación presentes no contienen errores específicos de desarrollo (DET), notificaciones de error (DEM) ni dependencias adicionales.

usar

La función Fr_AllowColdstart sirve para invocar el comando Controller Host Interface ALLOW_COLDSTART en el FlexRay Communication Controller [SWS_Fr_00114]. La declaración se proporciona a través del archivo de cabecera Fr.h; el servicio posee el Service ID 0x23 [SWS_Fr_00114]. Mediante el parámetro de entrada Fr_CtrlIdx se indica el índice del controlador de FlexRay al que se debe acceder dentro del controlador de FlexRay [SWS_Fr_00114]. La llamada se ejecuta de forma asíncrona [SWS_Fr_00114].

Tratamiento de errores y valores de retorno

La función devuelve un estado del tipo Std_ReturnType [SWS_Fr_00114]:

• E_OK: la llamada a la API finalizó correctamente [SWS_Fr_00114].
• E_NOT_OK: la llamada a la API se canceló debido a errores [SWS_Fr_00114].

En la especificación de la función no se detallan por separado causas de error específicas ni notificaciones a DEM o DET para este servicio [SWS_Fr_00114].

Concurrencia y restricciones

La interfaz no es reentrante para la misma instancia de controlador (Non Reentrant for the same device) [SWS_Fr_00114]. Por lo tanto, las llamadas con el mismo parámetro Fr_CtrlIdx no deben realizarse en paralelo ni interrumpiéndose entre sí [SWS_Fr_00114]. Interpretación: debido a la semántica de ejecución asíncrona, el valor de retorno E_OK probablemente solo confirma la aceptación del comando CHI por parte del controlador, mientras que el cambio de estado interno del controlador se produce de forma diferida en el tiempo [SWS_Fr_00114]. Pregunta Q-e5c407f32c449510 (abierta)

Uso y funcionamiento

La función Fr_AllSlots sirve para emitir el comando CHI (Controller Host Interface) ALL_SLOTS al controlador de comunicación FlexRay direccionado [SWS_Fr_00516]. Se proporciona a través de la cabecera Fr.h y posee el Service-ID 0x24 [SWS_Fr_00516].

Como parámetro de entrada, la función espera Fr_CtrlIdx, que indica el índice del controlador FlexRay afectado en el contexto del controlador FlexRay [SWS_Fr_00516]. La ejecución se realiza de forma asíncrona [SWS_Fr_00516]. El valor de retorno E_OK señala que la llamada a la API concluyó con éxito, mientras que E_NOT_OK indica una interrupción debida a errores [SWS_Fr_00516]. Debido a la semántica asíncrona, E_OK probablemente solo confirme la recepción correcta o el inicio del comando CHI y no la reacción completa del hardware del controlador (interpretación). Pregunta Q-c526e3b174a4b44a (abierta)

Tratamiento de errores y concurrencia

Si la ejecución falla, la llamada se interrumpe con el valor de retorno E_NOT_OK [SWS_Fr_00516]. En la especificación de este elemento no se indican causas concretas de error ni notificaciones de DET/DEM.

En lo referente a la reentrancia, Fr_AllSlots está especificada como no reentrante para el mismo controlador (Non Reentrant for the same device) [SWS_Fr_00516]. Por lo tanto, las capas superiores deben evitar llamadas concurrentes para la misma instancia de controlador. Por el contrario, llamadas paralelas para diferentes instancias de controlador deberían ser admisibles (interpretación). Pregunta (abierta)

La función Fr_HaltCommunication sirve para iniciar la detención de la comunicación en un controlador de comunicación FlexRay ejecutando la orden CC-CHI 'DEFERRED_HALT' [SWS_Fr_00014].

Uso y parámetros

La llamada se realiza de forma asíncrona y se proporciona a través de la cabecera Fr.h (Service ID 0x04) [SWS_Fr_00014]:

• Fr_CtrlIdx (parámetro de entrada): determina el índice del controlador de comunicación FlexRay que se va a controlar dentro del controlador FlexRay [SWS_Fr_00014].
• Valor de retorno (Std_ReturnType): devuelve E_OK si la llamada a la función se completó con éxito, o E_NOT_OK si la llamada se canceló a consecuencia de errores [SWS_Fr_00014].

Concurrencia y restricciones

En cuanto al contexto de llamada y la concurrencia, Fr_HaltCommunication no es reentrante respecto al mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00014]. Por consiguiente, no se debe realizar ninguna llamada concurrente o superpuesta para el mismo índice de controlador. Por el contrario, las llamadas para diferentes instancias de controlador están permitidas.

Manejo de errores

Si se produce un error durante la llamada, la función cancela la ejecución y lo señaliza a través del valor de retorno E_NOT_OK [SWS_Fr_00014]. En el alcance de la especificación no se indican mensajes de error detallados para esta función.

La función síncrona Fr_AbortCommunication interrumpe la comunicación en curso ejecutando el comando de interfaz host del controlador (comando CHI) FREEZE en el controlador de comunicación FlexRay (CC) especificado [SWS_Fr_00011].

Invocación y parámetros

La llamada se realiza a través de la cabecera Fr.h especificando el índice del controlador Fr_CtrlIdx, el cual identifica de forma unívoca el FlexRay CC de destino en el contexto del controlador FlexRay [SWS_Fr_00011]. Aparte de esto, no existen parámetros de entrada ni de salida.

Valores de retorno y tratamiento de errores

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

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

Concurrencia y restricciones

En cuanto al comportamiento de concurrencia, Fr_AbortCommunication está especificada como no reentrante para el mismo controlador de comunicación (Non Reentrant for the same device) [SWS_Fr_00011]. El llamador debe evitar llamadas paralelas para la misma instancia del controlador.

Uso y semántica

La función Fr_SendWUP sirve para iniciar un proceso de reactivación (wakeup) en el bus FlexRay mediante el envío del comando CHI WAKEUP al controlador de comunicación [SWS_Fr_00009]. Mediante el parámetro Fr_CtrlIdx se pasa el índice del controlador de destino en el contexto del controlador de dispositivo [SWS_Fr_00009]. La llamada se realiza de forma asíncrona; la interfaz desencadena el comando, mientras que la transmisión del patrón de reactivación se realiza a continuación a nivel de hardware [SWS_Fr_00009]. La declaración está disponible a través de Fr.h y el servicio posee el ID de servicio 0x06 [SWS_Fr_00009].

Tratamiento de errores y valores de retorno

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

• E_OK: la llamada a la API se ejecutó con éxito y se envió el comando CHI [SWS_Fr_00009].
• E_NOT_OK: la llamada a la API se canceló debido a errores producidos [SWS_Fr_00009].

Concurrencia y restricciones

La función está especificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00009]. Interpretación: es de esperar que esto signifique que los módulos superiores deben sincronizar las llamadas simultáneas para la misma instancia de controlador, mientras que las llamadas para diferentes instancias de controlador pueden ejecutarse concurrentemente. Pregunta Q-0e3b4e70a0755877 (abierta) No se definen parámetros de entrada/salida ni parámetros de salida puros [SWS_Fr_00009].

La función Fr_TransmitTxLPdu sirve para la transmisión de datos útiles a través de la red FlexRay [SWS_Fr_00092]. Procesa la orden de transmisión con semántica asíncrona y asigna la LSdu que se va a transmitir al frame de FlexRay identificado por Fr_LPduIdx [SWS_Fr_00092].

Uso y parámetros

La llamada se realiza a través del archivo de cabecera Fr.h (ID de servicio 0x0b) indicando el índice de controlador Fr_CtrlIdx para el FlexRay Communication Controller, así como el índice de frame unívoco Fr_LPduIdx [SWS_Fr_00092]. Mediante el puntero Fr_LSduPtr se pasa la LSdu de transmisión proporcionada en el búfer, cuya longitud de datos en bytes se especifica mediante Fr_LSduLength [SWS_Fr_00092]. A través del parámetro de salida Fr_SlotAssignmentPtr, el llamador puede consultar el ciclo de transmisión real, el ID de slot y el canal FlexRay; si no se necesita esta información, se puede pasar un NULL_PTR para ello [SWS_Fr_00092].

Valores de retorno y tratamiento de errores

La función confirma la llamada con el tipo de retorno Std_ReturnType: el valor de retorno E_OK confirma la finalización correcta de la llamada a la API, mientras que E_NOT_OK señala una interrupción debida a errores [SWS_Fr_00092]. Los datos de especificación no contienen mensajes específicos de DET o DEM.

concurrencia

En cuanto a la concurrencia, Fr_TransmitTxLPdu está especificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00092]. Por lo tanto, no están permitidas las llamadas de transmisión paralelas para el mismo controlador FlexRay.

Uso y semántica

La función síncrona Fr_CancelTxLPdu cancela la transmisión ya pendiente de una L-PDU que se encuentra en un recurso emisor físico del controlador (p. ej., un búfer de transmisión) [SWS_Fr_00610]. La función está declarada en la cabecera Fr.h y posee el Service ID 0x2d [SWS_Fr_00610].

Para identificar la transmisión que se va a cancelar, la interfaz espera dos parámetros [SWS_Fr_00610]:

• Fr_CtrlIdx: índice del Communication Controller de FlexRay en el contexto del controlador de FlexRay [SWS_Fr_00610].
• Fr_LPduIdx: Índice unívoco para la identificación de la trama FlexRay respectiva [SWS_Fr_00610].

Valores de retorno y tratamiento de errores

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

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

No se han documentado códigos de error específicos, ni entradas de DET o DEM para esta función; en caso de producirse un error, la función lo señaliza exclusivamente a través del valor de retorno E_NOT_OK [SWS_Fr_00610].

Concurrencia y restricciones

En lo relativo al comportamiento frente a la concurrencia, Fr_CancelTxLPdu está especificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00610]. Es de suponer que esto signifique que las llamadas paralelas para la misma instancia de controlador deban sincronizarse a nivel de la entidad que realiza la llamada. Pregunta Q-ec480944eec04076 (abierta) No existen más parámetros de entrada o de salida [SWS_Fr_00610].

La función síncrona Fr_ReceiveRxLPdu sirve para la recepción de datos útiles desde la red FlexRay y está disponible a través de la cabecera Fr.h [SWS_Fr_00093].

Parámetros y uso

A través de los parámetros de entrada Fr_CtrlIdx y Fr_LPduIdx se direccionan de forma unívoca el respectivo controlador de comunicación del controlador de FlexRay, así como el frame de FlexRay que se va a recibir [SWS_Fr_00093]. Los datos útiles y de estado se transfieren al llamador a través de varios punteros:

• Fr_LSduPtr: Puntero al búfer en el que debe almacenarse la L-SDU recibida.
• Fr_LPduStatusPtr: Puntero a la ubicación de memoria para el estado de recepción de la L-PDU.
• Fr_LSduLengthPtr: Ubicación de memoria para la longitud de la L-SDU recibida en bytes, correspondiente al número de bytes copiados en Fr_LSduPtr.
• Fr_SlotAssignmentPtr: Ubicación de memoria para el ciclo, el ID de slot y el canal del frame. Si se pasa un NULL_PTR para esto, indica que el llamador no necesita esta información de asignación.

Concurrencia y tratamiento de errores

La interfaz se ejecuta de forma síncrona, pero no es reentrante para el mismo dispositivo [SWS_Fr_00093]. Un proceso de recepción correcto se confirma con E_OK, mientras que si se producen errores, la llamada se interrumpe y se devuelve E_NOT_OK [SWS_Fr_00093]. En los datos de especificación de la función no se indican códigos de error específicos de DET o DEM.

La interfaz síncrona Fr_CheckTxLPduStatus (ID de servicio 0x0d) sirve, según [SWS_Fr_00094], para comprobar el estado de transmisión actual de una L-SDU o de un frame de FlexRay en el controlador de FlexRay. Se proporciona a través de la cabecera Fr.h.

Como parámetros de entrada, la función requiere el índice del controlador de comunicación FlexRay (Fr_CtrlIdx), así como el índice Fr_LPduIdx, que identifica de forma unívoca en el controlador el frame de FlexRay que se va a comprobar [SWS_Fr_00094]. El estado de transmisión determinado de la LPdu se escribe de nuevo en la dirección de memoria transferida a través del parámetro de salida Fr_TxLPduStatusPtr [SWS_Fr_00094].

Además, el parámetro de salida Fr_SlotAssignmentPtr permite determinar la asignación de slot: hace referencia a una posición de memoria en la que se almacenan el ciclo real, el ID de slot y el canal del frame direccionado [SWS_Fr_00094]. Si el llamador no necesita esta información de asignación, pasar un NULL_PTR indica que estos datos no tienen que proporcionarse [SWS_Fr_00094].

La interfaz debe ejecutarse de forma síncrona y está especificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00094]. En caso de finalización correcta, la llamada proporciona el valor de retorno E_OK; en caso de producirse errores, la función se interrumpe y devuelve E_NOT_OK [SWS_Fr_00094].

Uso y semántica

La función síncrona Fr_PrepareLPdu sirve, conforme a [SWS_Fr_00107], para preparar una L-PDU (Prepares a LPdu) y se proporciona a través de la cabecera Fr.h. Como parámetro de entrada, el servicio espera el índice de controlador Fr_CtrlIdx para direccionar el FlexRay Communication Controller (CC) en el contexto del controlador, así como Fr_LPduIdx para la identificación unívoca de la trama FlexRay correspondiente [SWS_Fr_00107]. Interpretación: Es de suponer que la llamada inicialice o active estructuras de búfer específicas del hardware para el posterior proceso de envío o recepción de la trama. Pregunta Q-c4375099d73dbea2 (abierta)

Concurrencia y restricciones

En lo que respecta al comportamiento de concurrencia, Fr_PrepareLPdu está especificada como no reentrante para el mismo dispositivo de hardware (Non Reentrant for the same device) [SWS_Fr_00107]. Por lo tanto, el llamador debe evitar obligatoriamente una llamada paralela o que cause interrupción para el mismo índice de controlador Fr_CtrlIdx.

Valores de retorno y tratamiento de errores

La función posee el Service-ID 0x1f y notifica su estado a través del tipo de retorno Std_ReturnType [SWS_Fr_00107]:

• E_OK: la llamada a la API finalizó correctamente [SWS_Fr_00107].
• E_NOT_OK: la llamada a la API se canceló prematuramente debido a errores ocurridos [SWS_Fr_00107]. En el presente extracto de la especificación no se definen códigos de error específicos de DET o DEM.

Uso y parámetros

La función síncrona Fr_ReconfigLPdu permite la reconfiguración dinámica de una LPDU de FlexRay en tiempo de ejecución [SWS_Fr_00524]. Proporcionada a través de la cabecera Fr.h, la llamada direcciona mediante Fr_CtrlIdx el respectivo controlador FlexRay y mediante Fr_LPduIdx el identificador unívoco del frame AUTOSAR_SWS_FlexRayDriver p. 65.

En la reconfiguración se pasan los siguientes parámetros de destino [SWS_Fr_00524]:

• Fr_FrameId y Fr_ChnlIdx: Definición del nuevo ID de frame, así como del canal de comunicación.
• Fr_CycleRepetition y Fr_CycleOffset: Configuración del filtrado de ciclo para la LPDU.
• Fr_PayloadLength y Fr_HeaderCRC: Longitud de datos útiles en bytes, así como el CRC de cabecera correspondiente del frame.

Concurrencia y valores de retorno

El servicio no es reentrante para el mismo controlador (Non Reentrant for the same device) [SWS_Fr_00524]. En cambio, en caso de llamadas para diferentes instancias de controlador FlexRay, es probable que se dé reentrancia (interpretación). Pregunta Q-85908ef4796c80c7 (abierta) Si la reconfiguración se realiza correctamente, la llamada devuelve E_OK; si la reconfiguración falla debido a errores, se devuelve E_NOT_OK AUTOSAR_SWS_FlexRayDriver p. 65.

usar

La función síncrona del controlador Fr_DisableLPdu sirve para desactivar el recurso de hardware de una LPdu FlexRay para el envío o la recepción ([SWS_Fr_00539]). La interfaz se proporciona a través del archivo de cabecera Fr.h y está asignada al Service-ID 0x26 ([SWS_Fr_00539]).

Para la llamada a la función se deben transferir dos parámetros obligatorios ([SWS_Fr_00539]):

• Fr_CtrlIdx: el índice del controlador de comunicación FlexRay dentro del contexto del controlador.
• Fr_LPduIdx: el índice unívoco para identificar la correspondiente trama FlexRay o LPdu.

Como valor de retorno, la función proporciona el estado Std_ReturnType ([SWS_Fr_00539]). El valor E_OK señala una llamada finalizada con éxito, mientras que se devuelve E_NOT_OK en caso de que la llamada se haya interrumpido por motivos de error.

Manejo de errores

En la presente especificación no se definen códigos de error específicos ni avisos a DET o DEM para este servicio; el comportamiento anómalo se manifiesta directamente en el valor de retorno E_NOT_OK ([SWS_Fr_00539]).

Concurrencia y restricciones

En lo que respecta a la reentrancia, Fr_DisableLPdu está clasificada como no reentrante para el mismo dispositivo (Non Reentrant for the same device) ([SWS_Fr_00539]). Por lo tanto, los llamadores deben asegurarse de que se sincronicen las llamadas simultáneas para el mismo controlador.

La función síncrona Fr_CancelAbsoluteTimer sirve para la parada ordenada de un temporizador absoluto activo en un FlexRay Communication Controller ([SWS_Fr_00095]). Se proporciona a través del archivo de cabecera Fr.h y tiene el ID de servicio 0x13 ([SWS_Fr_00095]).

Parámetros y valor de retorno

• Fr_CtrlIdx: Pasa el índice del FlexRay Communication Controller correspondiente en el contexto del controlador de FlexRay ([SWS_Fr_00095]).
• Fr_AbsTimerIdx: Determina el índice del temporizador absoluto que se va a detener en el contexto del controlador FlexRay seleccionado ([SWS_Fr_00095]).
• Valor de retorno: Proporciona mediante el tipo Std_ReturnType el estado E_OK en caso de ejecución correcta o E_NOT_OK si la llamada se interrumpió debido a errores ([SWS_Fr_00095]).

Concurrencia y restricciones

En cuanto a la concurrencia, la interfaz está definida como no reentrante para el mismo dispositivo («Non Reentrant for the same device») ([SWS_Fr_00095]). Las capas llamadoras deben asegurarse de que no se produzcan accesos concurrentes o que provoquen interrupciones para el mismo controlador. Interpretación: En el caso de controladores diferentes, en cambio, la ejecución probablemente debería ser admisible de forma reentrante. Pregunta Q-01203b0b28193021 (abierta)

La función síncrona Fr_EnableAbsoluteTimerIRQ sirve para activar la línea de interrupción de un temporizador absoluto dentro de un FlexRay Communication Controller [SWS_Fr_00034]. El servicio se proporciona a través del archivo de cabecera Fr.h y posee el ID de servicio 0x15 [SWS_Fr_00034].

Durante la llamada, la interfaz espera dos parámetros de entrada [SWS_Fr_00034]:

• Fr_CtrlIdx: índice del Communication Controller de FlexRay en el contexto del controlador de FlexRay [SWS_Fr_00034].
• Fr_AbsTimerIdx: índice del temporizador absoluto en el contexto del controlador de FlexRay direccionado [SWS_Fr_00034].

El valor de retorno del tipo Std_ReturnType indica el resultado de la ejecución [SWS_Fr_00034]:

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

En cuanto a la concurrencia, la función está especificada como no reentrante para el mismo dispositivo («Non Reentrant for the same device») [SWS_Fr_00034]. Esto requiere evitar de manera obligatoria las llamadas simultáneas para la misma instancia de controlador; sin embargo, es de suponer que una llamada paralela para diferentes instancias de controlador sea admisible. Pregunta Q-d7e594a84357e129 (abierta) En la descripción de la función no se detallan códigos de error específicos para errores de desarrollo o de producción (DET/DEM); los errores que se produzcan conllevan directamente la devolución de E_NOT_OK [SWS_Fr_00034].

La función síncrona Fr_AckAbsoluteTimerIRQ pertenece al módulo del controlador FlexRay (Fr) en la plataforma AUTOSAR Classic y sirve para restablecer la condición de interrupción de un temporizador absoluto [SWS_Fr_00036]. La declaración de la interfaz se proporciona a través del archivo de cabecera Fr.h y está asignada al Service ID hexadecimal 0x17 [SWS_Fr_00036].

Para direccionar el temporizador de forma unívoca, la función espera dos parámetros de entrada del tipo uint8, mientras que no dispone de parámetros de entrada/salida ni de salida pura [SWS_Fr_00036]:

• Fr_CtrlIdx: Pasa el índice del FlexRay Communication Controller (CC) dentro del contexto del controlador de FlexRay [SWS_Fr_00036].
• Fr_AbsTimerIdx: Designa el índice del temporizador absoluto dentro del contexto del respectivo FlexRay Communication Controller [SWS_Fr_00036].

El resultado de la ejecución de la función se notifica mediante el valor de estado del tipo Std_ReturnType. Si la llamada ha finalizado con éxito, la función devuelve E_OK [SWS_Fr_00036]. Si se producen errores durante la ejecución, la llamada a la función se interrumpe prematuramente y devuelve en su lugar E_NOT_OK [SWS_Fr_00036].

En cuanto al comportamiento de concurrencia, el servicio está clasificado como no reentrante para el mismo dispositivo (Non Reentrant for the same device) [SWS_Fr_00036]. Por tanto, las llamadas para la misma instancia de controlador deben realizarse de forma síncrona y no deben ejecutarse de manera concurrente o superpuesta [SWS_Fr_00036].

La función síncrona Fr_DisableAbsoluteTimerIRQ sirve en el controlador FlexRay para desactivar de manera selectiva la línea de interrupción de un temporizador absoluto [SWS_Fr_00035]. Como parámetros de entrada, la interfaz espera el índice de controlador Fr_CtrlIdx para direccionar el respectivo controlador de comunicación (CC) FlexRay en el contexto del controlador, así como Fr_AbsTimerIdx para identificar el temporizador absoluto dentro de este controlador [SWS_Fr_00035]. La declaración de la función se proporciona a través del archivo de cabecera Fr.h [SWS_Fr_00035].

El resultado de la ejecución se transmite de forma síncrona al llamador mediante el tipo de retorno Std_ReturnType [SWS_Fr_00035]. Si el servicio pudo finalizar de forma correcta y exitosa, devuelve E_OK [SWS_Fr_00035]. Por el contrario, si se producen errores durante el procesamiento, la función cancela el proceso y lo señaliza mediante el valor de retorno E_NOT_OK [SWS_Fr_00035]. En el elemento de especificación no se señalan errores concretos de desarrollo o tiempo de ejecución (DET/DEM), por lo que los estados de error deben detectarse y gestionarse principalmente a partir del valor de retorno [SWS_Fr_00035].

En cuanto a la concurrencia, Fr_DisableAbsoluteTimerIRQ está definida como no reentrante para el mismo dispositivo (same device) [SWS_Fr_00035]. Por lo tanto, no deben realizarse varias llamadas de forma concurrente para el mismo índice de controlador y deben sincronizarse por parte del llamador, mientras que el acceso paralelo a diferentes controladores está permitido [SWS_Fr_00035].

La función síncrona Fr_ReadCCConfig lee un parámetro de configuración de protocolo FlexRay específico de un controlador directamente a partir de la configuración del módulo del controlador FlexRay [SWS_Fr_00651]. La interfaz se declara a través de la cabecera Fr.h y posee el Service ID 0x2e [SWS_Fr_00651].

Parámetros y valores de retorno

• Fr_CtrlIdx: Determina el índice del Communication Controller FlexRay afectado en el contexto del controlador [SWS_Fr_00651].
• Fr_ConfigParamIdx: Identifica el parámetro que se va a leer mediante macros definidas con el formato FR_CIDX_<config_parameter_name> [SWS_Fr_00651].
• Fr_ConfigParamValuePtr: Puntero a la dirección de memoria de tipo uint32 en la que se escribe el valor leído [SWS_Fr_00651].
• Valor de retorno: devuelve E_OK en caso de ejecución correcta o E_NOT_OK en caso de error [SWS_Fr_00651].

Concurrencia y comportamiento ante errores

La función está concebida como no reentrante para el mismo controlador («Non Reentrant for the same device») [SWS_Fr_00651]. Por tanto, es de suponer que las llamadas simultáneas para diferentes instancias de controlador sean admisibles. Pregunta Q-b5e4172654514747 (abierta) En la definición de la interfaz no se especifican errores DET o DEM concretos; los estados de error conllevan la interrupción con devolución de E_NOT_OK [SWS_Fr_00651]. Es de suponer que la entidad que realiza la llamada deba asegurarse de que Fr_ConfigParamValuePtr apunte a un área de memoria válida.

El tipo de enumeración Fr_SlotModeType forma parte de la definición de interfaz del controlador de FlexRay en AUTOSAR Classic y se proporciona a través de la cabecera Fr_GeneralTypes.h [SWS_Fr_00506]. La definición de tipo hace referencia formalmente al tipo T_SlotMode de la especificación del protocolo FlexRay, donde se describe en el capítulo sobre el Protocol Operation Control (estado POC) [SWS_Fr_00506].

La enumeración especifica el estado del procesamiento de slots del controlador mediante tres valores definidos de forma fija [SWS_Fr_00506]:

• FR_SLOTMODE_KEYSLOT (valor 0x00): Representa el literal KEYSLOT de la definición formal de tipo T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL_PENDING (valor 0x01): Representa el literal ALL_PENDING de la definición formal de tipo T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL (valor 0x02): Representa el literal ALL de la definición formal de tipo T_SlotMode [SWS_Fr_00506].

Al utilizarse con controladores conformes con el estándar anterior FlexRay 2.1 Rev A, debe tenerse en cuenta una denominación divergente: en lugar del literal KEYSLOT, aquí aparece el literal SINGLESLOT [SWS_Fr_00506]. Interpretación: A nivel de controlador y de software, el tipo probablemente sirve para determinar si el controlador FlexRay tiene actualmente habilitados para la transmisión únicamente slots clave (Key Slots) o todos los slots, o bien si está pendiente un cambio correspondiente. Pregunta Q-f926c41c8a5d3380 (abierta)

usar

El tipo de enumeración Fr_ErrorModeType representa los modos de error del Protocol Operation Control (POC) de FlexRay y se proporciona a través del archivo de cabecera Fr_GeneralTypes.h [SWS_Fr_00507]. La enumeración define los estados del mecanismo de monitorización de errores del controlador de comunicación y hace referencia a la definición formal de tipo T_ErrorMode en el estado POC de FlexRay [SWS_Fr_00507].

El rango de valores abarca tres estados conforme a [SWS_Fr_00507]:

• FR_ERRORMODE_ACTIVE (0x00): Representa el literal ACTIVE de la definición formal de tipo T_ErrorMode e identifica el estado sin errores o funcionamiento normal del controlador de comunicación.
• FR_ERRORMODE_PASSIVE (0x01): Corresponde al literal PASSIVE de la definición formal de tipo T_ErrorMode, en el cual se han registrado errores en el bus y la comunicación puede estar limitada.
• FR_ERRORMODE_COMM_HALT (0x02): Representa el literal COMM_HALT de la definición formal de tipo T_ErrorMode cuando la comunicación del bus se ha detenido debido a estados de error graves.

Integración y condiciones de contorno

Interpretación: Es probable que el tipo sirva principalmente como valor de retorno o parámetro de estado en funciones de consulta del controlador de FlexRay, para transmitir el estado del controlador a capas de software de nivel superior. Pregunta Q-e4d6ae534d1dfa2c (abierta) Dado que [SWS_Fr_00507] especifica exclusivamente la estructura de datos, a nivel de tipo no existen tratamientos de errores independientes mediante DET o DEM, ni requisitos directos de reentrancia o concurrencia.

El tipo de enumeración Fr_WakeupStatusType se proporciona a través del archivo de cabecera Fr_GeneralTypes.h y reproduce el estado de wakeup del controlador de FlexRay conforme a la definición formal T_WakeupStatus del estado POC [SWS_Fr_00508].

Uso y rango de valores

El tipo representa los diferentes estados y eventos durante un proceso de reactivación de FlexRay y comprende siete valores de enumeración específicos [SWS_Fr_00508]:

• FR_WAKEUP_UNDEFINED (0x00): Corresponde al literal UNDEFINED de la definición formal de tipo [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_HEADER (0x01): Identifica la recepción de una cabecera de wakeup (literal RECEIVED_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_WUP (0x02): Representa el patrón de wakeup recibido (literal RECEIVED_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_HEADER (0x03): Indica una colisión en una cabecera recibida (literal COLLISION_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_WUP (0x04): Señala una colisión durante un patrón de wakeup (literal COLLISION_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_UNKNOWN (0x05): Describe una colisión por causa desconocida (literal COLLISION_UNKNOWN) [SWS_Fr_00508].
• FR_WAKEUP_TRANSMITTED (0x06): Confirma el envío correcto de la señal de wakeup (literal TRANSMITTED) [SWS_Fr_00508].

Interacción y restricciones

Interpretación: El tipo probablemente sirva de forma primordial como parámetro de estado de funciones del controlador para permitir a los módulos de nivel superior un diagnóstico preciso del canal y del estado de reactivación. Pregunta Q-48907418bc3729a1 (abierta) Dado que la especificación no define códigos de error específicos ni restricciones de concurrencia para el tipo en sí, su uso está sujeto a las convenciones de llamada de las funciones de la API que realizan la consulta respectiva [SWS_Fr_00508].

El tipo de enumeración Fr_StartupStateType se proporciona de conformidad con [SWS_Fr_00509] a través del archivo de cabecera Fr_GeneralTypes.h y asigna los estados de arranque del controlador de protocolo FlexRay (estado POC) a valores estandarizados. La definición hace referencia a la definición de tipo formal T_StartupState del capítulo 2.2.1.3 de la especificación.

El rango de valores abarca once estados discretos que representan la secuencia del arranque del protocolo:

• FR_STARTUP_UNDEFINED (0x00): representa un estado de arranque indefinido.
• FR_STARTUP_COLDSTART_LISTEN (0x01) a FR_STARTUP_COLDSTART_GAP (0x09): representan las fases del arranque en frío, incluidas la fase de escucha, la comprobación de consistencia, la resolución de colisiones y la incorporación (Coldstart Join).
• FR_STARTUP_INTEGRATION_LISTEN (0x06), FR_STARTUP_INITIALIZE_SCHEDULE (0x07) y FR_STARTUP_INTEGRATION_CONSISTENCY_CHECK (0x08): representan pasos de integración e inicialización en la planificación temporal.
• FR_STARTUP_EXTERNAL_STARTUP (0x0A): representa el arranque controlado externamente.

Los módulos de software integradores utilizan este tipo (interpretación: principalmente para consultar el estado o supervisar el arranque del controlador). Pregunta Q-7d07faa6c48d4e58 (abierta) Dado que Fr_StartupStateType es una definición de tipo pura, no se desencadenan directamente códigos ni mensajes de error; no obstante, los evaluadores deben tener en cuenta que los valores fuera del rango de 0x00 a 0x0A no están especificados.

El tipo de datos Fr_POCStatusType está especificado como una estructura de datos y se proporciona a través del archivo de cabecera Fr_GeneralTypes.h [SWS_Fr_00510]. La definición formal remite a la descripción del tipo T_POCStatus en el capítulo 2.2.1.3 (POC status) de la especificación del protocolo FlexRay [SWS_Fr_00510].

Uso y organización estructural

La estructura agrega el estado operativo y de protocolo actual del FlexRay Protocol Operation Control (POC) [SWS_Fr_00510]. Se compone de los siguientes elementos:

• State (tipo Fr_POCStateType) y StartupState (tipo Fr_StartupStateType) para indicar el estado actual de POC, así como el estado de arranque [SWS_Fr_00510].
• ErrorMode (tipo Fr_ErrorModeType) y Freeze (tipo boolean) para identificar el modo de error y una parada del controlador [SWS_Fr_00510].
• SlotMode (tipo Fr_SlotModeType) y WakeupStatus (tipo Fr_WakeupStatusType) para el modo de funcionamiento de los slots y el estado de reactivación [SWS_Fr_00510].
• CHIHaltRequest, CHIReadyRequest así como ColdstartNoise (cada uno boolean) para señalar solicitudes de la interfaz de host o ruido de línea durante el arranque en frío [SWS_Fr_00510].

Concurrencia e integración

Interpretación: dado que Fr_POCStatusType es una estructura de datos pura sin lógica funcional propia, se supone que actúa principalmente como parámetro de salida en consultas de estado del hardware de FlexRay. Pregunta Q-960f2475ff1068fc (abierta) Si varios tasks o capas de software acceden a instancias de esta estructura, los llamadores deben ocuparse de forma autónoma de una sincronización adecuada para garantizar una lectura consistente de los subestados interrelacionados [SWS_Fr_00510].

El tipo de enumeración Fr_TxLPduStatusType sirve en la plataforma AUTOSAR Classic para determinar si una LPdu (Link Layer Protocol Data Unit) de FlexRay se ha transmitido con éxito o no [SWS_Fr_00511]. La definición de tipo se proporciona a través del archivo de cabecera Fr_GeneralTypes.h para módulos de software [SWS_Fr_00511].

El rango de valores de la enumeración abarca tres estados unívocos para procesos de transmisión [SWS_Fr_00511]:

• FR_TRANSMITTED (0x00): La LPdu se transmitió con éxito a través del bus [SWS_Fr_00511].
• FR_TRANSMITTED_CONFLICT (0x01): Se produjo un conflicto durante la transmisión [SWS_Fr_00511].
• FR_NOT_TRANSMITTED (0x02): La LPdu no se transmitió [SWS_Fr_00511].

En cuanto a la interacción y al contexto de llamada, este valor de estado probablemente sea utilizado de forma típica por capas de nivel superior para consultar el estado del búfer de transmisión en el controlador de FlexRay (interpretación). Pregunta Q-347a88512db1f006 (abierta) Para este tipo de datos no se contemplan en las especificaciones códigos de error específicos, rutinas de tratamiento de errores ni mensajes de DET o DEM, ya que se trata de una mera declaración de tipo [SWS_Fr_00511].

El tipo de enumeración Fr_RxLPduStatusType forma parte del módulo de AUTOSAR Classic Fr y se proporciona a través del archivo de cabecera Fr_GeneralTypes.h [SWS_Fr_00512]. Sirve para determinar si se ha recibido una L-PDU (FlexRay Link Layer PDU) o no [SWS_Fr_00512].

El tipo define tres valores de estado discretos para evaluar el estado de recepción [SWS_Fr_00512]:

• FR_RECEIVED (0x00): La L-PDU se recibió con éxito [SWS_Fr_00512].
• FR_NOT_RECEIVED (0x01): La L-PDU no se recibió [SWS_Fr_00512].
• FR_RECEIVED_MORE_DATA_AVAILABLE (0x02): La L-PDU se recibió y hay disponibles más instancias de esta L-PDU, tal como ocurre al utilizar FIFOs de recepción [SWS_Fr_00512].

En el funcionamiento de recepción a través de estructuras de búfer, el tipo no solo distingue la presencia de datos recibidos, sino que en el funcionamiento con FIFO identifica adicionalmente la existencia de instancias adicionales [SWS_Fr_00512]. Es de suponer que esto señale al llamador que, tras la lectura de la instancia actual, pueden recuperarse de inmediato más datos del FIFO [SWS_Fr_00512]. Pregunta Q-0ab7cac72ff7f549 (abierta)

La estructura Fr_SlotAssignmentType sirve para almacenar información de asignación de una trama FlexRay a un ciclo de comunicación y a un Slot-ID [SWS_Fr_91002]. Está definida en la cabecera Fr_GeneralTypes.h y agrupa todos los parámetros de direccionamiento que se requieren para la transmisión o recepción de una trama en el canal FlexRay [SWS_Fr_91002].

La estructura comprende los siguientes elementos [SWS_Fr_91002]:

• Cycle (tipo uint8): identifica el ciclo en el que se transmite o recibe la trama FlexRay [SWS_Fr_91002].
• SlotId (tipo uint16): designa el Slot-ID unívoco de la trama dentro del esquema de comunicación FlexRay [SWS_Fr_91002].
• channelId (tipo Fr_ChannelType): indica el canal FlexRay a través del cual se realiza la transmisión o la recepción [SWS_Fr_91002].

Dado que Fr_SlotAssignmentType representa una mera estructura de datos, no posee una semántica de ejecución propia como sincronismo o reentrancia y no desencadena por sí misma mensajes de error de DET o DEM [SWS_Fr_91002]. La consistencia de los valores contenidos para ciclo, slot y canal debería ser responsabilidad de las funciones de controlador usuarias (interpretación). Pregunta Q-77f88375e544e298 (abierta)