LIN Transceiver Driver (LinTrcv)

El LIN Transceiver Driver controla el transceptor LIN físico de un canal y desacopla LinIf del hardware. Según LinTrcv_Init, el modo inicial es SLEEP. LinTrcv_SetOpMode cambia entre NORMAL, STANDBY y SLEEP y, en caso de cambio fallido, devuelve E_NOT_OK [SWS_LinTrcv_00002]. Los wakeups externos se detectan a través de la ICU y se notifican cuando LinIf invoca LinTrcv_CheckWakeup. En R20-11, E_OK significa en este contexto «wakeup detectado» [SWS_LinTrcv_00012]. Los tiempos de espera para cambios de estado deben implementarse con Tm_BusyWait1us16bit.

más ›

El LIN Transceiver Driver controla el transceptor LIN físico de un canal y desacopla la interfaz LIN del hardware. LinIf invoca sus servicios directamente: LinIf_SetTrcvMode, por ejemplo, invoca LinTrcv_SetOpMode y devuelve su resultado sin modificaciones [SWS_LinTrcv_00002] LinIf-SWS p. 90. Los estados de software y de hardware están separados. Qué estados de hardware cubre un modo de software lo decide la implementación LinTrcv-SWS p. 16.

El controlador reconoce los modos LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY y LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. Tras el encendido se encuentra inactivo. LinTrcv_Init lo activa con un conjunto de configuración [SWS_LinTrcv_00001]; el modo inicial es SLEEP LinTrcv-SWS p. 1. STANDBY es opcional y puede ser un estado puramente interno LinTrcv-SWS Fig. 7.1 p. 15.

Diagrama de estados: ciclo de vida desde Power-On pasando por LinTrcv_Init hasta los cambios de modo con LinTrcv_SetOpMode. Las transiciones opcionales están reconstruidas (interpretación). Fuentes: LinTrcv-SWS Fig. 7.1 p. 15 [SWS_LinTrcv_00168]

El controlador no detecta los wakeups externos mediante una ISR propia, sino a través de la ICU LinTrcv-SWS p. 17. LinIf los consulta con LinTrcv_CheckWakeup. En R20-11, E_OK significa en este contexto «wakeup detectado» [SWS_LinTrcv_00012]. Versiones posteriores lo definen de forma diferente. Un wakeup detectado se notifica a través de LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv_SetWakeupMode habilita la notificación, la bloquea o borra los eventos almacenados [SWS_LinTrcv_00169].

Diagrama de secuencia: wakeup externo desde la detección por ICU a través de LinTrcv_CheckWakeup y LinIf_WakeupConfirmation hasta la consulta del motivo. Fuentes: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] LinTrcv-SWS p. 17

Para el funcionamiento rigen estas condiciones de contorno:

• Los tiempos de espera en cambios de estado deben implementarse con Tm_BusyWait1us16bit [SWS_LinTrcv_00171].
• En sistemas multinúcleo, LinTrcvChannel y LinChannel de un canal deben referenciar a la misma partición [SWS_LinTrcv_00177].
• En caso de comunicación perturbada hacia el transceptor, las consultas devuelven E_NOT_OK LinTrcv-SWS p. 26.

Los códigos de error de DET solo están documentados a partir de versiones posteriores. Dado que R21-11 depuró los códigos de error, sus nombres pueden diferir en R20-11 LinTrcv-SWS p. 1.

más ›

Rol entre la interfaz LIN y el circuito transceptor

El LIN Transceiver Driver (LinTrcv) encapsula el control del transceptor LIN físico. Su interfaz consta de siete servicios:

• Inicialización con LinTrcv_Init [SWS_LinTrcv_00001]
• Cambio de modo con LinTrcv_SetOpMode [SWS_LinTrcv_00002]
• Consulta del modo con LinTrcv_GetOpMode [SWS_LinTrcv_00005]
• Consulta del motivo de wakeup con LinTrcv_GetBusWuReason [SWS_LinTrcv_00007]
• Control de la notificación de wakeup con LinTrcv_SetWakeupMode [SWS_LinTrcv_00009]
• Comprobación de wakeup con LinTrcv_CheckWakeup [SWS_LinTrcv_00012]
• Consulta de versión con LinTrcv_GetVersionInfo [SWS_LinTrcv_00008]

Todos los servicios son síncronos. Los estados de software del controlador están separados de los estados de hardware del circuito integrado. El componente puede admitir más transiciones que el controlador. Qué estados de hardware cubre un estado de software lo decide la implementación. No obstante, debe proporcionar completamente la funcionalidad descrita LinTrcv-SWS p. 16.

Hacia arriba, la interfaz LIN (LinIf) es el usuario documentado en el payload. Los servicios de LinIf invocan respectivamente un servicio de LinTrcv:

• LinIf_SetTrcvMode invoca LinTrcv_SetOpMode y devuelve su valor de retorno sin modificaciones LinIf-SWS p. 90.
• LinIf_GetTrcvMode invoca LinTrcv_GetOpMode LinIf-SWS p. 91.
• LinIf_GetTrcvWakeupReason invoca LinTrcv_GetBusWuReason LinIf-SWS p. 92.
• LinIf_SetTrcvWakeupMode invoca LinTrcv_SetWakeupMode LinIf-SWS p. 93.

Los tipos LinTrcv_TrcvModeType y LinTrcv_TrcvWakeupModeType están disponibles a través de Lin_GeneralTypes.h [SWS_LinTrcv_00168] [SWS_LinTrcv_00169]. LinIf los utiliza directamente en sus firmas. El antiguo tipo propio LinIf_TrcvModeType fue sustituido en la versión 3.1.5 por LinTrcv_TrcvModeType LinIf-SWS p. 4.

Hacia abajo, el controlador utiliza los siguientes servicios:

• los servicios de lectura y escritura de Dio, Det_ReportError y EcuM_SetWakeupEvent [SWS_LinTrcv_91003]
• tipos de Dio, Spi, Icu y EcuM [SWS_LinTrcv_91001]
• Icu_EnableNotification y Icu_DisableNotification para la notificación de wakeup LinTrcv-SWS p. 17
• el servicio de tiempo Tm_BusyWait1us16bit para tiempos de espera en cambios de estado [SWS_LinTrcv_00171]

El controlador notifica los wakeups detectados a LinIf a través de LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinIf establece a continuación el flag de wakeup del canal afectado LinIf-SWS p. 98.

Diagrama de contexto: LinTrcv se ubica entre LinIf y los servicios de bajo nivel de hardware Dio/Spi, Icu y Tm, y devuelve notificaciones de wakeups a LinIf. Fuentes: [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] [SWS_LinTrcv_00171] LinTrcv-SWS p. 17 LinTrcv-SWS Fig. 10.3 p. 45

Ciclo de vida de los modos de funcionamiento de Power-On a Sleep

El controlador reconoce tres modos de funcionamiento de software: LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY y LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. La figura 7.1 de la especificación los clasifica dentro de un ciclo de vida LinTrcv-SWS Fig. 7.1 p. 15:

• Tras el encendido, el controlador se encuentra en el estado NOT_ACTIVE.
• LinTrcv_Init lo transfiere al estado ACTIVE. Los tres modos se encuentran dentro de ACTIVE.
• Una pérdida de tensión finaliza el ciclo de vida.

LinTrcv_Init recibe un puntero al conjunto de configuración seleccionado [SWS_LinTrcv_00001]. La estructura LinTrcv_ConfigType es específica de la implementación [SWS_LinTrcv_00172]. Desde la versión 4.3.1, el modo inicial tras la inicialización está limitado a LINTRCV_TRCV_MODE_SLEEP LinTrcv-SWS p. 1.

En el estado ACTIVE, LinTrcv_SetOpMode conmuta el estado interno del canal direccionado al modo transmitido [SWS_LinTrcv_00002] LinTrcv-SWS p. 25. El modo LINTRCV_TRCV_MODE_STANDBY es opcional. Puede ser un estado puramente interno que el hardware utiliza para las transiciones. Es posible que un hardware concreto no necesite todas las interfaces LinTrcv-SWS Fig. 7.1 p. 15. La especificación menciona además condiciones bajo las cuales LinTrcv_SetOpMode conmuta el canal a STANDBY. Estas condiciones están cortadas en el presente extracto y no se detallan aquí LinTrcv-SWS p. 25.

LinTrcv_GetOpMode proporciona en el parámetro de salida OpMode el estado de software actual del controlador [SWS_LinTrcv_00005] LinTrcv-SWS p. 26. Este no es necesariamente el estado del componente. Un llamador puede utilizarlo antes de un cambio de modo para comprobar en qué modo se encuentra el canal. A través de LinIf, esta consulta está disponible como LinIf_GetTrcvMode LinIf-SWS p. 91.

Diagrama de estados: tras el encendido (Power-On), el controlador está inactivo. LinTrcv_Init conduce a la zona activa con el modo inicial SLEEP; LinTrcv_SetOpMode cambia entre los modos. Las transiciones opcionales se han reconstruido a partir de los textos de la Fig. 7.1 (interpretación). Los cambios condicionados a STANDBY no se representan. Fuentes: LinTrcv-SWS Fig. 7.1 p. 15 [SWS_LinTrcv_00168] [SWS_LinTrcv_00001] LinTrcv-SWS p. 1

Cambios de modo y consultas a través de la interfaz LIN

Cada servicio direcciona un canal mediante el parámetro LinNetwork de tipo uint8 [SWS_LinTrcv_00002] [SWS_LinTrcv_00005]. En LinIf, el parámetro correspondiente se denomina Channel y tiene el tipo NetworkHandleType LinIf-SWS p. 90.

LinTrcv_SetOpMode es síncrono y no reentrante; el ID de servicio es 0x01. Los valores de retorno significan [SWS_LinTrcv_00002]:

• E_OK: el estado del transceptor ha cambiado al modo solicitado.
• E_NOT_OK: el cambio no se aceptó, ha fallado o el parámetro se encuentra fuera del rango admisible.

LinIf debe permitir la llamada para todos los transceptores y todos los modos, incluso si el hardware no admite un modo LinIf-SWS p. 90. El mapeo al hardware sigue siendo, por tanto, tarea de LinTrcv.

El controlador implementa los tiempos de espera en los cambios de estado con Tm_BusyWait1us16bit [SWS_LinTrcv_00171]. Dado que LinTrcv_SetOpMode opera de forma síncrona [SWS_LinTrcv_00002], es probable que este tiempo de espera activo se produzca dentro de la llamada y prolongue su tiempo de ejecución (interpretación). Pregunta Q-54fe21bbe7c737d9 (abierta) Al cambiar al modo de espera (standby), el controlador activa además los canales ICU para la detección de wakeup LinTrcv-SWS p. 17.

Los servicios de consulta son reentrantes. LinTrcv_GetBusWuReason proporciona el motivo de wakeup detectado en el tipo LinTrcv_TrcvWakeupReasonType [SWS_LinTrcv_00007]. Entre sus valores se encuentran LINTRCV_WU_ERROR, LINTRCV_WU_NOT_SUPPORTED, LINTRCV_WU_BY_BUS y LINTRCV_WU_BY_PIN [SWS_LinTrcv_00170]. La precisión con la que se pueden diferenciar los motivos de wakeup depende en gran medida del hardware del transceptor LinTrcv-SWS p. 28. LinTrcv_GetVersionInfo devuelve la información de versión como Std_VersionInfoType [SWS_LinTrcv_00008] LinTrcv-SWS p. 29.

Diagrama de secuencias: un cambio de modo transcurre de LinIf a LinTrcv. LinTrcv espera mediante Tm, activa la notificación ICU al cambiar a STANDBY y devuelve su resultado a través de LinIf sin modificaciones. El control a través de Dio/Spi y la ubicación del tiempo de espera dentro de la llamada son una interpretación. Fuentes: [SWS_LinTrcv_00002] [SWS_LinTrcv_00171] LinIf-SWS p. 90 LinTrcv-SWS p. 17

Detectar, notificar y controlar el wakeup

El controlador distingue dos tipos de wakeup LinTrcv-SWS p. 17:

• Wakeup interno: lo desencadena una capa superior, por ejemplo mediante LinTrcv_Init o LinTrcv_SetOpMode.
• Wakeup externo: el controlador lo detecta en el canal LIN. LinIf debe llamar a LinTrcv_CheckWakeup para que el wakeup se notifique hacia arriba.

El controlador no prevé una ISR propia para el wakeup. La detección se realiza mediante la ICU con Icu_EnableNotification y Icu_DisableNotification. El tipo de wakeup se selecciona a través del parámetro de configuración LinTrcvWakeUpSupport. Con LinTrcvWakeupByBusUsed se puede habilitar y deshabilitar el soporte de wakeup por canal LinTrcv-SWS p. 17.

LinTrcv_CheckWakeup evalúa el wakeup en la red direccionada, como un nivel de bus dominante o un flanco negativo en el pin de wakeup LinTrcv-SWS p. 30. En R20-11, los valores de retorno significan [SWS_LinTrcv_00012]:

• E_OK: se ha detectado un wakeup.
• E_NOT_OK: no se ha detectado ningún wakeup.

El pasaje del documento de versiones posteriores define los valores de forma diferente, como «llamada aceptada/no aceptada». Este cambio se introdujo con R22-11 y no es aplicable a R20-11 LinTrcv-SWS p. 1 LinTrcv-SWS p. 30. Tras una detección correcta, el controlador notifica la fuente de wakeup a través de LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv no ofrece notificaciones de callback propias LinTrcv-SWS p. 32. Por esta razón, se debe llamar activamente a LinTrcv_CheckWakeup.

LinTrcv_SetWakeupMode es síncrono y no reentrante. Controla la notificación de wakeup por red a través de LinTrcv_TrcvWakeupModeType [SWS_LinTrcv_00009] [SWS_LinTrcv_00169]:

• LINTRCV_WUMODE_ENABLE habilita la notificación.
• LINTRCV_WUMODE_DISABLE la deshabilita.
• LINTRCV_WUMODE_CLEAR borra un evento de wakeup almacenado.

Si al habilitar ya existe un evento almacenado, el controlador ejecuta la notificación durante la llamada o inmediatamente después LinTrcv-SWS p. 31. LinIf ofrece este control como LinIf_SetTrcvWakeupMode LinIf-SWS p. 93.

Diagrama de secuencias: se detecta un wakeup externo a través de la ICU. LinIf lo comprueba con LinTrcv_CheckWakeup, LinTrcv lo confirma mediante LinIf_WakeupConfirmation y el motivo se puede consultar a continuación (valores de retorno según R20-11). Fuentes: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] [SWS_LinTrcv_00007] LinTrcv-SWS p. 17 LinIf-SWS p. 98

Diagrama de actividades: LinTrcv_SetWakeupMode se ramifica según el modo solicitado. Solo en caso de ENABLE con un evento almacenado se produce inmediatamente una notificación. Fuentes: [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] LinTrcv-SWS p. 31

Acceso al hardware, configuración de canales y particionamiento

El contenedor de selección LinTrcvAccess determina cómo accede el controlador al componente LinTrcv-SWS Fig. 10.3 p. 45. Debe seleccionarse exactamente una de las dos variantes:

• LinTrcvDioAccess: los pines del transceptor se asignan a canales DIO.
• LinTrcvSpiSequence: se accede a un componente compatible con SPI mediante una secuencia SPI.

El diagrama procede de R23-11 y versiones posteriores. No obstante, los servicios de lectura y escritura de DIO, así como los tipos de SPI, ya figuran en R20-11 como interfaces utilizadas o tipos importados [SWS_LinTrcv_91003] [SWS_LinTrcv_91001].

Para sistemas multinúcleo se aplican en R20-11 las siguientes reglas:

• El controlador debe rechazar configuraciones con asignaciones de partición no admitidas [SWS_LinTrcv_00174].
• Las particiones referenciadas mediante LinTrcvChannelEcucPartitionRef deben ser un subconjunto de las referenciadas mediante LinTrcvEcucPartitionRef. Si el módulo referencia particiones, cada canal debe referenciar exactamente una de ellas [SWS_LinTrcv_00176].
• LinTrcvChannel y LinChannel del mismo canal de comunicación deben referenciar la misma partición [SWS_LinTrcv_00177].

La distribución multinúcleo se incorporó con R19-11 y se especificó con mayor detalle en R24-11 LinTrcv-SWS p. 1.

Comportamiento en caso de error

Los errores de tiempo de ejecución se reflejan en el valor de retorno:

• En caso de comunicación inexistente o perturbada con el transceptor, LinTrcv_GetOpMode LinTrcv-SWS p. 26 y LinTrcv_GetBusWuReason devuelven LinTrcv-SWS p. 28 E_NOT_OK.
• LinTrcv_SetOpMode devuelve E_NOT_OK si un cambio no fue aceptado o falló [SWS_LinTrcv_00002].
• LinTrcv_SetWakeupMode devuelve E_NOT_OK si no se pudo establecer el modo de wakeup LinTrcv-SWS p. 31.
• Si un motivo de wakeup no se puede determinar debido a un error, se encuentra disponible para ello el valor LINTRCV_WU_ERROR [SWS_LinTrcv_00170].

El controlador notifica los errores de desarrollo mediante Det_ReportError [SWS_LinTrcv_91003]. En R20-11, provocan en LinTrcv_GetOpMode y LinTrcv_GetBusWuReason el retorno de E_NOT_OK [SWS_LinTrcv_00005] [SWS_LinTrcv_00007]. Los pasajes del documento de versiones posteriores indican comprobaciones concretas LinTrcv-SWS p. 26 LinTrcv-SWS p. 30 LinTrcv-SWS p. 29:

• Llamada antes de la inicialización: LINTRCV_E_UNINIT
• Número de red no válido: LINTRCV_E_INVALID_LIN_NETWORK
• Puntero nulo en LinTrcv_GetVersionInfo: LINTRCV_E_PARAM_POINTER

Es probable que estas comprobaciones también apliquen en cuanto a contenido para R20-11 (interpretación). Pregunta Q-58e3d310b525b810 (abierta) No obstante, R20-11 reestructuró la clasificación de errores y R21-11 los códigos de error. Por tanto, los identificadores pueden diferir en R20-11 LinTrcv-SWS p. 1.

LinIf intercepta ya una parte de los errores de manejo. Con un Channel no válido, LinIf_SetTrcvMode y LinIf_GetTrcvMode notifican el error LINIF_E_NONEXISTENT_CHANNEL LinIf-SWS p. 90. Además, LinIf_GetTrcvMode devuelve E_NOT_OK en caso de canal no válido o puntero nulo LinIf-SWS p. 91. Si LinIf_WakeupConfirmation recibe una fuente de wakeup no válida, desencadena LINIF_E_PARAM_WAKEUPSOURCE si la detección de errores está activada LinIf-SWS p. 98.

Más evidencia detallada

• [SWS_LinTrcv_00002] con LinTrcv-SWS p. 25: cambio de modo, valores de retorno y cambio a STANDBY.
• [SWS_LinTrcv_00012] con LinTrcv-SWS p. 30: comprobación de wakeup. Los valores de retorno en R20-11 difieren de las versiones posteriores.
• [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] con LinTrcv-SWS p. 31: habilitar, deshabilitar y borrar la notificación de wakeup.
• [SWS_LinTrcv_00168] con LinTrcv-SWS Fig. 7.1 p. 15: modos de operación y ciclo de vida.
• [SWS_LinTrcv_00170] con LinTrcv-SWS p. 28: motivos de wakeup y su dependencia del hardware.
• [SWS_LinTrcv_00171]: tiempos de espera a través de Tm_BusyWait1us16bit.
• [SWS_LinTrcv_00174] [SWS_LinTrcv_00176] [SWS_LinTrcv_00177]: particionamiento en unidades de control multinúcleo.
• [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003]: tipos importados, confirmación de wakeup a LinIf y otras interfaces utilizadas.
• LinTrcv-SWS p. 17: wakeups internos y externos, uso de la ICU y configuración de wakeup.