LIN Interface (LinIf)

La función síncrona LinIf_Init sirve para inicializar la interfaz LIN según [SWS_LinIf_00198]. La interfaz posee el Service-ID 0x01, está disponible a través del archivo de cabecera LinIf.h y se ejecuta de forma síncrona.

Contexto de llamada y parámetros

La función espera como único parámetro ConfigPtr (const LinIf_ConfigType*), el cual actúa como puntero a la configuración de la interfaz LIN [SWS_LinIf_00198]. No posee valor de retorno y no dispone de parámetros de entrada/salida ni exclusivamente de salida.

Flujos de inicialización e interacción

En el marco de la inicialización, la interfaz LIN realiza ajustes específicos para los nodos slave:

• Según [SWS_LinIf_00767], el módulo inicializa en LinIf_Init la dirección de nodo inicial (initial NAD) y la dirección de nodo configurada (configured NAD) del nodo slave a partir de los parámetros de configuración LinIfInitialNAD y LinIfConfiguredNAD.
• Según [SWS_LinIf_00768], el módulo inicializa en LinIf_Init los PID configurados del nodo slave a partir de los datos de configuración a través de los parámetros de configuración LinIfFrameId.

Concurrencia y restricciones

La función está especificada como no reentrante (Non Reentrant) [SWS_LinIf_00198]. Por tanto, no se permite una llamada concurrente o solapada. En el alcance de la especificación provisto no se indican códigos de error específicos ni mensajes DET para este servicio.

Uso y contexto de llamada

La función LinIf_Transmit declarada en LinIf.h (ID de servicio 0x49) sirve para solicitar de forma síncrona la transmisión de una PDU [SWS_LinIf_00201]. Como parámetros de entrada espera TxPduId para la identificación unívoca de la PDU a enviar, así como el puntero PduInfoPtr a una estructura PduInfoType que, además de la longitud de datos y los datos útiles propiamente dichos, también puede referenciar metadatos [SWS_LinIf_00201]. No existen parámetros adicionales de entrada/salida o de salida [SWS_LinIf_00201].

Valores de retorno y requisitos de comportamiento

Como valor de retorno, el servicio devuelve el estado Std_ReturnType [SWS_LinIf_00201]:

• E_OK: La interfaz LIN aceptó con éxito la solicitud de transmisión [SWS_LinIf_00201].
• E_NOT_OK: La solicitud de transmisión no se pudo aceptar [SWS_LinIf_00201].

La interacción con los tipos de trama se precisa mediante [SWS_LinIf_00700]: con la interfaz LIN inicializada, LinIf_Transmit devuelve E_OK incluso si la PDU pertenece a una trama no esporádica en un nodo maestro LIN o a una trama no controlada por eventos en un nodo esclavo LIN.

concurrencia

En relación con el entorno de ejecución, LinIf_Transmit es reentrante para diferentes ID de PDU, pero no debe llamarse de forma simultánea o concurrente para la misma TxPduId [SWS_LinIf_00201].

La función LinIf_ScheduleRequest sirve exclusivamente en nodos master LIN para solicitar la ejecución de una tabla de schedule predefinida [SWS_LinIf_00202]. La llamada se procesa de forma asíncrona y está diseñada como reentrante [SWS_LinIf_00202].

Parámetros y valores de retorno

A través del parámetro Channel se transfiere el índice del canal LIN afectado, mientras que Schedule determina la identificación de la nueva tabla de schedule a ejecutar [SWS_LinIf_00202]. La función devuelve el estado como Std_ReturnType:

• E_OK: la orden de cambio para la tabla de schedule se aceptó correctamente [SWS_LinIf_00202].
• E_NOT_OK: la conmutación fue rechazada [SWS_LinIf_00202].

Condiciones de error y restricciones

Según la especificación, un valor de retorno de E_NOT_OK se produce en los siguientes casos de error [SWS_LinIf_00202]:

• La interfaz LIN aún no está inicializada.
• El canal referenciado no existe o el índice transferido se encuentra fuera del rango de valores.
• La tabla de schedule referenciada no existe o su identificador no es válido.
• El estado actual es Sleep.

Interacción

El fallo de una solicitud de schedule repercute en los flujos de transporte de nivel superior: si en el marco de una llamada a LinTp_Transmit a través de BswM_LinTp_RequestMode se inicia un cambio de schedule mediante LinIf_ScheduleRequest, LinTp_Transmit debe devolver obligatoriamente E_NOT_OK cuando LinIf_ScheduleRequest responda con E_NOT_OK [SWS_LinIf_00878].

usar

La función LinIf_GotoSleep (ID de servicio 0x06, declarada en LinIf.h) inicia la transición al modo Sleep en el canal LIN especificado [SWS_LinIf_00204]. La llamada se realiza de forma asíncrona y toma como parámetro de entrada Channel de tipo NetworkHandleType el identificador del canal en cuestión [SWS_LinIf_00204].

Valores de retorno y tratamiento de errores

Como valor de retorno, el servicio devuelve el tipo Std_ReturnType con los siguientes significados [SWS_LinIf_00204]:

• E_OK: La solicitud de cambio al modo Sleep se aceptó con éxito, la transición de estado al modo Sleep ya está en curso o el controlador ya se encuentra en el estado Sleep [SWS_LinIf_00204].
• E_NOT_OK: La solicitud no fue aceptada. Las posibles causas son una interfaz LIN aún no inicializada o un identificador de canal inexistente o situado fuera del rango de valores válido [SWS_LinIf_00204].

Concurrencia e interacción del sistema

La interfaz está definida como no reentrante (Non Reentrant) [SWS_LinIf_00204]. Si se llama a LinIf_GotoSleep, la interfaz LIN debe llamar inmediatamente a la función Lin_GotoSleepInternal y no debe esperar hasta el siguiente ciclo de la función principal [SWS_LinIf_00757].

La función reentrante LinIf_Wakeup inicia el proceso de reactivación asíncrono para el canal LIN identificado por el parámetro Channel [SWS_LinIf_00205]. Está disponible a través del encabezado LinIf.h [SWS_LinIf_00205].

El valor de retorno Std_ReturnType proporciona información sobre la aceptación de la solicitud [SWS_LinIf_00205]:

• E_OK señala que la solicitud de reactivación fue aceptada o que el controlador ya no se encuentra en el estado de reposo [SWS_LinIf_00205].
• E_NOT_OK se devuelve si la LIN Interface no está inicializada, el ID de canal transferido está fuera del rango válido o las llamadas a controladores subyacentes Lin_Wakeup o Lin_WakeupInternal fallan con E_NOT_OK [SWS_LinIf_00205].

La interacción con el usuario se realiza a través de la función de notificación <User>_WakeupConfirmation:

• En caso de error, la LIN Interface llama obligatoriamente a <User>_WakeupConfirmation(FALSE) antes de devolver E_NOT_OK [SWS_LinIf_00762].
• En caso de aceptación correcta (E_OK), la LIN Interface confirma la reactivación de forma asíncrona: solo cuando a continuación se llame por primera vez a la función LinIf_HeaderIndication, el módulo emite la llamada <User>_WakeupConfirmation(TRUE) [SWS_LinIf_00761].

La función síncrona y reentrante LinIf_SetTrcvMode (ID de servicio 0x08) sirve para conmutar el transceptor LIN especificado al modo de funcionamiento solicitado [SWS_LinIf_00544]. La interfaz está disponible a través del archivo de cabecera LinIf.h [SWS_LinIf_00544].

Parámetros y valores de retorno

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

• Channel (NetworkHandleType): Identifica el canal LIN que se va a controlar [SWS_LinIf_00544].
• TransceiverMode (LinTrcv_TrcvModeType): Determina la transición de estado solicitada del transceptor [SWS_LinIf_00544].

El valor de retorno de tipo Std_ReturnType señala el resultado del proceso de conmutación [SWS_LinIf_00544]:

• E_OK: Se devuelve cuando el estado del transceptor ha cambiado con éxito al modo solicitado [SWS_LinIf_00544].
• E_NOT_OK: Señala que el cambio de estado ha fallado o que al menos un parámetro está fuera del rango permitido. El estado anterior del transceptor permanece sin cambios [SWS_LinIf_00544].

Ejecución y comportamiento ante errores

La función se ejecuta de forma síncrona y está especificada como reentrante [SWS_LinIf_00544]. Los mensajes de error específicos de DET o DEM no se indican por separado en el elemento de especificación; un fallo en el cambio de modo o valores de parámetro no permitidos conducen directamente al valor de retorno E_NOT_OK [SWS_LinIf_00544].

La función síncrona y reentrante LinIf_SetTrcvWakeupMode sirve para habilitar, deshabilitar o restablecer notificaciones de eventos de wakeup en el canal LIN especificado [SWS_LinIf_00550]. La declaración se proporciona mediante el encabezado LinIf.h y posee el Service ID 0x0b [SWS_LinIf_00550].

La interfaz espera dos parámetros de entrada [SWS_LinIf_00550]:

• Channel: identificador unívoco de la red o canal LIN que se va a direccionar, de tipo NetworkHandleType [SWS_LinIf_00550].
• LinTrcvWakeupMode: modo de wakeup solicitado del transceptor, de tipo LinTrcv_TrcvWakeupModeType [SWS_LinIf_00550].

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

• E_OK: la llamada al servicio API del controlador del transceptor LIN fue correcta y devolvió E_OK [SWS_LinIf_00550].
• E_NOT_OK: el servicio API del controlador del transceptor LIN falló (retorno E_NOT_OK) o al menos uno de los parámetros transferidos para el canal o el modo no es válido [SWS_LinIf_00550].

En cuanto a la interacción, la función delega la solicitud al controlador del transceptor LIN; presumiblemente, el LinIf constituye aquí una interfaz mediadora entre las capas superiores y el hardware del transceptor [SWS_LinIf_00550]. Pregunta Q-07b525a14a2c5fcd (abierta) Puesto que el servicio está especificado como reentrante, se puede ejecutar en paralelo para diferentes canales o para el mismo [SWS_LinIf_00550].

Uso y contexto de llamada

La función LinTp_Init sirve para inicializar la capa de transporte del protocolo LIN ([SWS_LinIf_00350]). Según la especificación [SWS_LinIf_00350], la llamada a la función opera de forma síncrona.

La firma de la función es void LinTp_Init (const LinTp_ConfigType* ConfigPtr). A través del parámetro de entrada se transfiere la configuración:

• ConfigPtr (in): puntero a los datos de configuración de la capa de transporte LIN de tipo LinTp_ConfigType ([SWS_LinIf_00350]).

La función no devuelve ningún valor de retorno (void) y no define parámetros de salida ni de entrada/salida ([SWS_LinIf_00350]). Posee el Service-ID hexadecimal 0x40 y se proporciona a través del archivo de cabecera LinIf.h ([SWS_LinIf_00350]).

Manejo de errores

El requisito [SWS_LinIf_00350] no define para esta función códigos de error específicos, mensajes DET o eventos DEM. No se produce ningún retorno de un estado de error al llamador ([SWS_LinIf_00350]).

Concurrencia y restricciones

La función LinTp_Init está clasificada explícitamente como no reentrante (Non Reentrant) ([SWS_LinIf_00350]). Por consiguiente, no debe llamarse de forma concurrente desde múltiples subprocesos, tareas o rutinas de interrupción. Interpretación: es probable que la llamada se realice típicamente de forma centralizada en el marco de la secuencia de inicialización del software base, antes de que puedan procesarse las solicitudes de comunicación subsiguientes. Pregunta Q-6e391bdf8abb1a09 (abierta)

Interacción

Para LinTp_Init no se enumeran en el presente extracto vínculos directos con otros requisitos de especificación o funciones vecinas ([SWS_LinIf_00350]). El módulo LinIf pone a disposición la declaración ([SWS_LinIf_00350]).

La función síncrona LinTp_Transmit sirve para solicitar una transmisión de PDU a través del protocolo de transporte LIN ([SWS_LinIf_00351]). Como parámetros de transferencia espera el identificador de PDU TxPduId, así como el puntero PduInfoPtr, que proporciona la longitud de los datos y punteros a los datos de la PDU y a los metadatos ([SWS_LinIf_00351]). El valor de retorno es E_OK en caso de aceptación correcta de la solicitud de envío y E_NOT_OK en caso de rechazo ([SWS_LinIf_00351]).

El comportamiento en tiempo de ejecución y la interacción con la LIN Interface están sujetos a las siguientes especificaciones:

• Solicitud de planificación: si el cambio de planificación iniciado en el marco de la llamada a través de BswM_LinTp_RequestMode falla en LinIf_ScheduleRequest y devuelve E_NOT_OK, LinTp_Transmit también debe responder directamente con E_NOT_OK ([SWS_LinIf_00878]).
• Confirmación: solo si LinTp_Transmit fue correcto (valor de retorno E_OK), la LIN Interface llama a la función PduR_LinTpTxConfirmation con resultado positivo o negativo tras un cambio de tabla de planificación correcto o fallido ([SWS_LinIf_00702]). Si la orden de envío es rechazada, esta llamada se omite por completo ([SWS_LinIf_00702]).
• Interrupción de procesos en curso: si durante la espera de una respuesta física o durante la recepción de una respuesta se desencadena una nueva solicitud física mediante LinTp_Transmit, la LIN Interface cancela el tratamiento de TP en curso, incluida la recepción y la supervisión de temporización de N_Cr y P2, y acepta la nueva solicitud ([SWS_LinIf_00708]).

En cuanto a la concurrencia, LinTp_Transmit es reentrante para diferentes TxPduId, pero no debe ejecutarse de forma concurrente para la misma TxPduId ([SWS_LinIf_00351]).

La función LinTp_Shutdown sirve para el apagado controlado del protocolo de transporte LIN ([SWS_LinIf_00355]). Mediante su llamada se finaliza el funcionamiento del componente LIN-TP ([SWS_LinIf_00355]). La declaración de la función está disponible a través del archivo de cabecera LinIf.h ([SWS_LinIf_00355]).

Para el uso y la ejecución se aplican las siguientes características de especificación ([SWS_LinIf_00355]):

• Parámetros y valor de retorno: la función no posee parámetros de entrada, de entrada/salida o de salida (void) y no devuelve ningún valor de retorno (void) ([SWS_LinIf_00355]).
• Identificación del servicio: el servicio está definido bajo el Service-ID 0x43 ([SWS_LinIf_00355]).
• Sincronía: la llamada se procesa de forma síncrona ([SWS_LinIf_00355]).
• Reentrancia: la función no es reentrante (Non Reentrant) ([SWS_LinIf_00355]). No se permiten llamadas concurrentes o anidadas desde diferentes contextos.

En las fuentes no se describen códigos de error específicos, notificaciones al Development Error Tracer (DET) ni tratamientos especiales ante errores para esta función ([SWS_LinIf_00355]). Asimismo, faltan datos sobre requisitos relacionados o el llamador exacto; presumiblemente, la llamada se realiza en el marco de la desinicialización secuencial de la pila de comunicación por parte de una gestión de estados de la BSW de nivel superior. Pregunta Q-e25a3c9531527c4f (abierta)

Uso y semántica

La función síncrona LinTp_ChangeParameter sirve para ajustar en tiempo de ejecución un parámetro específico del protocolo de transporte para una PDU determinada [SWS_LinIf_00501]. Como parámetros se transfieren el identificador de la PDU (id), el identificador del parámetro del protocolo de transporte a modificar (parameter, por ejemplo el tamaño de bloque), así como el nuevo valor de destino (value) [SWS_LinIf_00501]. La declaración se proporciona a través de la cabecera LinIf.h [SWS_LinIf_00501].

Valores de retorno y comportamiento en caso de error

La función señala el resultado de la solicitud de forma inmediata a través de su valor de retorno de tipo Std_ReturnType [SWS_LinIf_00501]:

• E_OK: el parámetro solicitado se modificó correctamente al nuevo valor [SWS_LinIf_00501].
• E_NOT_OK: la modificación fue rechazada por el protocolo de transporte LIN [SWS_LinIf_00501]. Es probable que esto ocurra típicamente si el parámetro no es válido o si una transmisión en curso impide la modificación. Pregunta Q-84aaf28c12dee2e9 (abierta)

Concurrencia y restricciones

Según la especificación, LinTp_ChangeParameter está clasificada como no reentrante (Non Reentrant) [SWS_LinIf_00501]. Por lo tanto, no se permite una llamada concurrente o anidada para el mismo contexto o contextos paralelos, y el llamador debe evitarla. La ejecución síncrona bloquea al llamador hasta que se toma la decisión sobre la adopción del valor del parámetro [SWS_LinIf_00501].

Uso y contexto de llamada

La función síncrona LinIf_CheckWakeup se invoca en cuanto el módulo EcuM ha sido notificado sobre un evento de wake-up en un canal LIN determinado [SWS_LinIf_00378]. La llamada se realiza con el parámetro de entrada WakeupSource de tipo EcuM_WakeupSourceType [SWS_LinIf_00378]. Este parámetro especifica el dispositivo de origen que inició el evento de wake-up, pudiendo tratarse de un controlador LIN o de un transceptor LIN [SWS_LinIf_00378].

Tratamiento de errores y valores de retorno

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

• E_OK: no se ha producido ningún error durante la ejecución de la interfaz [SWS_LinIf_00378].
• E_NOT_OK: se ha producido un error durante la ejecución de la interfaz o se ha transferido un valor no válido para WakeupSource [SWS_LinIf_00378].

Concurrencia e integración

La interfaz está especificada como reentrante, posee el Service-ID 0x60 y se proporciona a través del archivo de cabecera LinIf.h [SWS_LinIf_00378]. Conecta el procesamiento de reactivación de EcuM directamente con los canales de la interfaz LIN [SWS_LinIf_00378].

La función síncrona y reentrante LinIf_EnableBusMirroring habilita o deshabilita el bus mirroring para un canal LIN individual [SWS_LinIf_00876]. Está disponible a través del encabezado LinIf.h y se puede omitir si el bus mirroring no está habilitado mediante el parámetro de configuración LinIfBusMirroringSupport [SWS_LinIf_00875]. Normalmente, la entidad que realiza la llamada suele ser el módulo Mirror. Pregunta Q-1703af5207cb7ade (abierta)

A través del parámetro Channel se transfiere el canal LIN afectado, mientras que MirroringActive controla el modo [SWS_LinIf_00876]: si se transfiere TRUE, se habilita el mirroring; con FALSE, se deshabilita [SWS_LinIf_00876]. Como valor de retorno, la función devuelve E_OK si el modo de mirroring se ha modificado correctamente, o E_NOT_OK si se ha indicado un canal no válido o si el mirroring está deshabilitado globalmente [SWS_LinIf_00876]. En la definición de la función no se contemplan mensajes de error específicos de DET o DEM [SWS_LinIf_00876].

Si el bus mirroring está habilitado globalmente a través de LinIfBusMirroringSupported así como para el canal correspondiente, la LIN Interface reenvía los eventos relevantes a Mirror_ReportLinFrame:

• Tramas recibidas en LinIf_RxIndication con estado LIN_RX_OK y puntero a los datos útiles [SWS_LinIf_00838], así como durante la lectura del estado del controlador LIN para slots Rx [SWS_LinIf_00873].
• Tramas enviadas en LinIf_TxConfirmation con estado LIN_TX_OK y puntero a los datos transmitidos [SWS_LinIf_00839], así como durante la lectura del estado del controlador LIN para slots Tx [SWS_LinIf_00874].
• Notificaciones de error en LinIf_LinErrorIndication para todos los códigos de error excepto LIN_ERR_HEADER, con estado de error y puntero NULL como contenido de datos [SWS_LinIf_00869].

La función LinIf_WakeupConfirmation sirve para notificar a la LIN Interface la detección correcta de un evento de wakeup [SWS_LinIf_00715].

Invocación y parámetros

La llamada la realiza el controlador LIN (LIN Driver) o el controlador del transceptor LIN (LIN Transceiver Driver), después de que haya tenido lugar una detección correcta de wakeup durante Check Wakeup o tras un encendido a través del bus (power on by bus) [SWS_LinIf_00715]. Como parámetro de transferencia se pasa WakeupSource de tipo EcuM_WakeupSourceType, que indica el dispositivo fuente que ha iniciado el evento de wakeup (controlador LIN o transceptor LIN) [SWS_LinIf_00715].

Propiedades de ejecución e interfaz

• Semántica: la llamada se gestiona de forma síncrona [SWS_LinIf_00715].
• Reentrancia: la función está especificada como reentrante [SWS_LinIf_00715].
• Valor de retorno: no tiene valor de retorno (void) [SWS_LinIf_00715].
• Encabezado: la declaración se proporciona a través de LinIf.h (Service ID: 0x61) [SWS_LinIf_00715].

El controlador LIN llama de forma síncrona a la función de callback LinIf_HeaderIndication para notificar la recepción de una cabecera LIN en un canal esclavo [SWS_LinIf_91004]. Solo está disponible si la unidad de control dispone de al menos un canal esclavo LIN configurado [SWS_LinIf_91004]. La función es reentrante para diferentes canales, pero no debe llamarse de forma concurrente para el mismo canal [SWS_LinIf_91004].

Mediante el parámetro de entrada/salida PduPtr, el controlador transfiere el identificador recibido (PID), así como el puntero al búfer de datos de la SDU [SWS_LinIf_91004]. LinIf evalúa el PID y controla la reacción del nodo esclavo:

• Trama de recepción: si el PID pertenece a una trama de recepción configurada, LinIf establece el tipo de suma de comprobación PduPtr->Cs, la longitud de datos PduPtr->Dl y asigna a PduPtr->Drc el valor LIN_FRAMERESPONSE_RX antes de retornar [SWS_LinIf_00733].
• Trama de transmisión: si se trata de una trama de transmisión, LinIf solicita los datos útiles a través de <User_TriggerTransmit> [SWS_LinIf_00738]. En caso de provisión correcta (valor de retorno E_OK o datos SRF mediante Node Configuration Handler / protocolo de transporte), se configuran la suma de comprobación y la longitud, y PduPtr->Drc se establece en LIN_FRAMERESPONSE_TX [SWS_LinIf_00739]. Si la consulta falla con E_NOT_OK, PduPtr->Drc se establece en LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00740].
• Tramas irrelevantes: si la trama no es relevante para el esclavo, LinIf también establece PduPtr->Drc en LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00748].

Además, cada llamada recarga el temporizador de bus inactivo en ejecución [SWS_LinIf_00754]. Si la llamada se produce por primera vez tras un LinIf_Wakeup correcto, se desencadena <User>_WakeupConfirmation(TRUE) [SWS_LinIf_00761]. Al recibir una cabecera SRF, LinIf inicia además el temporizador N_As para Consecutive Frames (CF) [SWS_LinIf_00800]. Como valor de retorno, E_OK señala la aceptación de la solicitud, mientras que E_NOT_OK indica errores de desarrollo o de producción [SWS_LinIf_91004].

El controlador LIN llama de forma síncrona a la función de callback LinIf_RxIndication para comunicar a la interfaz LIN la recepción correcta de una respuesta, incluidos los datos recibidos [SWS_LinIf_91005]. La función está disponible exclusivamente en unidades de control con al menos un canal esclavo LIN configurado [SWS_LinIf_91005].

En cuanto a la parametrización y la concurrencia, se aplican las siguientes condiciones:

• Parámetros: se transfieren la identificación del canal Channel, así como el puntero Lin_SduPtr a un shadow buffer o al búfer de recepción mapeado en memoria del hardware LIN [SWS_LinIf_91005]. Este puntero solo es válido si la respuesta realmente se ha recibido [SWS_LinIf_91005].
• Valor de retorno: La función no tiene valor de retorno (void) [SWS_LinIf_91005].
• Reentrancia: la interfaz es reentrante para diferentes canales LIN, pero no es reentrante para el mismo canal [SWS_LinIf_91005].

En interacción con el comportamiento del módulo, la llamada inicia varias acciones coordinadoras:

• Reenvío de los datos útiles recibidos y de la longitud de los datos útiles a la capa superior a través de <User_RxIndication> [SWS_LinIf_00734].
• Comprobación de comandos Sleep: si se trata de un Master Request Frame (MRF) con NAD 0, la interfaz LIN reconoce un comando Go-to-Sleep e inicia la transición al modo Sleep [SWS_LinIf_00750].
• Control de temporizadores: en cada llamada se recarga el temporizador de bus inactivo [SWS_LinIf_00754]. Además, en tramas MRF (FF, CF), la llamada controla el temporizador N_Cr (inicio/reinicio en FF y CF antes de la última trama, parada en el último CF) [SWS_LinIf_00805].
• Bus Mirroring: si el reflejo está activado globalmente y para el canal, la interfaz LIN notifica la trama con el estado LIN_RX_OK a través de Mirror_ReportLinFrame() [SWS_LinIf_00838].

El controlador LIN llama a la función de callback síncrona LinIf_TxConfirmation (ID de servicio 0x7a, declarada en LinIf.h) para confirmar la transmisión correcta de una respuesta en el canal especificado [SWS_LinIf_91006]. La función no tiene valor de retorno y está prevista exclusivamente para unidades de control con al menos un canal esclavo LIN configurado [SWS_LinIf_91006].

Al llegar la confirmación, la interfaz LIN ejecuta varios procesamientos posteriores:

• Notificación a la capa superior: el módulo reenvía el evento de transmisión a la capa superior a través de la función de callback <User_TxConfirmation> con el valor de retorno E_OK [SWS_LinIf_00741].
• Estado de error: si la trama enviada con éxito contiene la señal de error response_error, la interfaz LIN restablece esta señal [SWS_LinIf_00747].
• Supervisión del reposo del bus: cada llamada a LinIf_TxConfirmation recarga el temporizador de bus idle en ejecución del canal [SWS_LinIf_00754].
• Protocolo de transporte (LinTp): si el controlador confirma la respuesta a una cabecera SRF (Slave Response Frame), la interfaz detiene el temporizador de supervisión N_As [SWS_LinIf_00800].
• Bus Mirroring: si el reflejo está configurado globalmente mediante LinIfBusMirroringSupported y habilitado mediante LinIf_EnableBusMirroring(), la interfaz notifica la trama con el estado LIN_TX_OK y un puntero a los datos de transmisión a Mirror_ReportLinFrame() [SWS_LinIf_00839].

En cuanto a la concurrencia, LinIf_TxConfirmation está diseñada para ser reentrante para diferentes canales LIN, pero no debe llamarse de forma reentrante para el mismo canal [SWS_LinIf_91006].

Uso y contexto de llamada

La función síncrona LinIf_LinErrorIndication es llamada por el controlador LIN para notificar los errores ocurridos durante el procesamiento de la cabecera o la respuesta [SWS_LinIf_91007]. Está prevista exclusivamente para nodos LIN slave y requiere que la unidad de control disponga de al menos un canal LIN slave configurado [SWS_LinIf_91007]. Se pasan como parámetros la identificación del canal Channel y el estado de error ocurrido ErrorStatus de tipo Lin_SlaveErrorType [SWS_LinIf_91007].

Tratamiento de errores y concurrencia

La función es reentrante para diferentes canales, pero no debe llamarse de forma concurrente para el mismo canal [SWS_LinIf_91007]. Al llamarse, la interfaz LIN considera la respuesta o la trama transmitida como perdida y notifica el error de tiempo de ejecución LINIF_E_RESPONSE al Default Error Tracer (DET), a menos que el estado de error notificado sea LIN_ERR_HEADER [SWS_LinIf_00735], [SWS_LinIf_00743].

Interacción y supervisión del bus

Independientemente del código de error pasado, la interfaz LIN recarga el temporizador de bus idle en ejecución en cada llamada a LinIf_LinErrorIndication [SWS_LinIf_00754]. Si se produce un error en una respuesta SRF tras la recepción de una cabecera SRF, la interfaz LIN cancela la transmisión y lo notifica a la capa superior mediante PduR_LinTpTxConfirmation con el resultado E_NOT_OK [SWS_LinIf_00796].

Si el bus mirroring está activo globalmente mediante LinIfBusMirroringSupported y activado para el canal, la interfaz LIN reenvía los errores distintos de LIN_ERR_HEADER a través de Mirror_ReportLinFrame() con un puntero NULL para el contenido de los datos [SWS_LinIf_00869]. Para ello, los códigos de error del controlador se traducen previamente a los correspondientes valores de estado del tipo Lin_StatusType [SWS_LinIf_00870].

La interfaz configurable <User_TriggerTransmit> sirve para la obtención síncrona de datos de SDU procedentes de un módulo superior para una transmisión pendiente [SWS_LinIf_00528].

A través del parámetro TxPduId se identifica la SDU solicitada, mientras que PduInfoPtr se transfiere como puntero a una estructura con el búfer de destino (SduDataPtr) y el tamaño de búfer disponible (SduLength) [SWS_LinIf_00528]. El módulo superior llamado comprueba dentro de esta API si los datos disponibles caben en el tamaño de búfer notificado [SWS_LinIf_00528]. Si hay suficiente espacio, el módulo copia sus datos en SduDataPtr, actualiza SduLength con la cantidad de bytes efectivamente copiados y señala el éxito con el valor de retorno E_OK [SWS_LinIf_00528].

Por el contrario, si el tamaño del búfer no es suficiente, no se copia ningún dato de SDU y el módulo devuelve E_NOT_OK sin modificar PduInfoPtr [SWS_LinIf_00528]. En caso de un valor de retorno de E_NOT_OK, el llamador no debe utilizar PduInfoPtr bajo ningún concepto, ya que este puede apuntar a datos no válidos o ser un puntero NULL [SWS_LinIf_00528].

En cuanto a la concurrencia, la función es reentrante para diferentes ID de PDU, pero no reentrante para el mismo ID de PDU [SWS_LinIf_00528].

La función de callback configurable <User_TxConfirmation> es llamada por el módulo de interfaz de comunicación subyacente para confirmar a una capa superior la transmisión de una PDU o el fallo de la transmisión [SWS_LinIf_00529]. La llamada se realiza de forma síncrona y no devuelve ningún valor de retorno [SWS_LinIf_00529].

Parámetros y semántica

• TxPduId (In): designa el identificador de la PDU transmitida de tipo PduIdType [SWS_LinIf_00529].
• result (In): notifica el estado de éxito de la transmisión como Std_ReturnType con los valores E_OK en caso de transmisión correcta de la PDU o E_NOT_OK en caso de transmisión fallida [SWS_LinIf_00529].

Concurrencia y tratamiento de errores

En cuanto a la reentrancia, la función está diseñada como reentrante para diferentes ID de PDU, pero no debe llamarse de forma reentrante para el mismo ID de PDU [SWS_LinIf_00529]. El módulo no especifica para esta interfaz códigos de error independientes ni mensajes DET o DEM; en su lugar, el fallo de una transmisión se indica mediante el valor de parámetro E_NOT_OK [SWS_LinIf_00529]. El identificador real de la función probablemente se defina de manera específica para la integración según la capa de usuario configurada, ya que el servicio se indica como configurable [SWS_LinIf_00529]. Pregunta Q-35de931161f26cb8 (abierta)

La función de callback <User_RxIndication> sirve para señalar una PDU recibida desde un módulo de interfaz de comunicación subyacente a la capa superior [SWS_LinIf_00530]. La llamada se efectúa con semántica síncrona y no posee ningún valor de retorno [SWS_LinIf_00530].

Parámetros y especificación de interfaz

La función transfiere dos parámetros de entrada a la capa superior [SWS_LinIf_00530]:

• RxPduId: identificador de la PDU recibida de tipo PduIdType [SWS_LinIf_00530].
• PduInfoPtr: puntero a una estructura de tipo PduInfoType que proporciona la longitud de los datos útiles (SduLength), un puntero al búfer con los datos útiles (SduDataPtr) así como metadatos asociados a la PDU [SWS_LinIf_00530].

Para esta interfaz no se contemplan ni parámetros de entrada/salida ni parámetros exclusivamente de salida [SWS_LinIf_00530].

Concurrencia y configuración

En lo que respecta a la reentrancia, la función está diseñada como reentrante para diferentes ID de PDU, mientras que para ID de PDU idénticos está especificada explícitamente como no reentrante [SWS_LinIf_00530]. Por tanto, los llamadores deben asegurarse de que no se produzcan llamadas solapadas para el mismo RxPduId. La función está declarada como interfaz configurable [SWS_LinIf_00530]; por consiguiente, el nombre concreto de la función de la capa superior probablemente se defina a través de la configuración del módulo. Pregunta Q-94175e8cd86775b6 (abierta)

La interfaz <User_ResponseErrorSignalChanged> sirve en el módulo LinIf como función de notificación para indicar un cambio de valor de la señal Response-Error con el nuevo valor de la señal [SWS_LinIf_00856]. La llamada se realiza de forma síncrona y posee el Service-ID 0x74 [SWS_LinIf_00856]. No se contemplan parámetros de entrada/salida ni un valor de retorno; la signatura está definida con el tipo de retorno void [SWS_LinIf_00856].

Como parámetros de transferencia, la función espera dos valores puramente de entrada [SWS_LinIf_00856]:

• Channel (tipo NetworkHandleType): Identificación unívoca del canal LIN afectado [SWS_LinIf_00856].
• RespErrSigValue (tipo boolean): Valor actual de la señal Response-Error. El parámetro es true si la señal está ajustada a 1; de lo contrario, false [SWS_LinIf_00856].

En cuanto a la concurrencia y al contexto de llamada, se especifica que la función es reentrante para canales diferentes, pero no debe llamarse de forma reentrante para el mismo canal [SWS_LinIf_00856]. Una condición de contorno funcional consiste en que este servicio de notificación solo es aplicable a nodos LIN slave [SWS_LinIf_00856]. La declaración se proporciona a través del archivo de cabecera LinIf_Externals.h [SWS_LinIf_00856].

La función de callback <User_SaveConfigurationRequest> (Service ID 0x75) notifica a una capa superior la recepción de una solicitud «Save Configuration» y está declarada en LinIf_Externals.h [SWS_LinIf_00857]. Esta interfaz es aplicable exclusivamente a nodos LIN slave [SWS_LinIf_00857].

La llamada se realiza de forma síncrona y está especificada como reentrante [SWS_LinIf_00857]:

• Parámetros: mediante el parámetro de entrada Channel de tipo NetworkHandleType se transfiere el canal LIN afectado [SWS_LinIf_00857]. No existen parámetros adicionales de entrada o salida [SWS_LinIf_00857].
• Valor de retorno: la función devuelve un valor de tipo boolean [SWS_LinIf_00857]. El valor de retorno TRUE indica que se debe enviar una respuesta positiva al bus LIN, mientras que FALSE impide la transmisión de cualquier respuesta [SWS_LinIf_00857].

En lo que respecta al tratamiento de errores, la especificación no define ni códigos de error específicos ni mensajes DET o DEM [SWS_LinIf_00857]. El comportamiento en caso de error o rechazo se controla directamente mediante el valor de retorno booleano, impidiéndose el envío de una respuesta mediante FALSE [SWS_LinIf_00857]. Puesto que la llamada está clasificada como reentrante, es probable que la función esté diseñada para la invocación concurrente en distintos canales [SWS_LinIf_00857]. Pregunta Q-84432030c1aff644 (abierta)

El tipo de enumeración LinTp_Mode está definido en el archivo de cabecera LinIf.h y determina qué modo de tabla de planificación puede solicitarse durante una sesión de diagnóstico mediante el protocolo de transporte LIN (LIN TP) [SWS_LinIf_00629].

El rango de valores comprende tres literales de enumeración para el control del cambio de planificación en el bus LIN [SWS_LinIf_00629]:

• LINTP_APPLICATIVE_SCHEDULE: Selecciona la tabla de planificación de aplicación para el tráfico regular de mensajes [SWS_LinIf_00629].
• LINTP_DIAG_REQUEST: Selecciona la tabla de planificación Master Request para la transmisión de solicitudes de diagnóstico [SWS_LinIf_00629].
• LINTP_DIAG_RESPONSE: Selecciona la tabla de planificación Slave Response para la recepción de respuestas de diagnóstico [SWS_LinIf_00629].

En cuanto a la interacción, el tipo sirve para la conmutación entre transmisiones de diagnóstico y comunicación de aplicación regular dentro de la interfaz LIN [SWS_LinIf_00629]. En las fuentes no se especifican contextos de llamada concretos, propiedades de reentrancia ni tratamientos de errores (como mensajes DET o DEM) para este tipo de datos puro; presumiblemente, el tipo se transfiere como parámetro de función a la interfaz LIN durante llamadas de control mediante el protocolo de transporte LIN. Pregunta Q-1bf7553401882471 (abierta)