LIN Transceiver Driver (LinTrcv)

Le LIN Transceiver Driver commande le transceiver LIN physique d'un canal et découple LinIf du matériel. D'après LinTrcv_Init, le mode initial est SLEEP. LinTrcv_SetOpMode commute entre NORMAL, STANDBY et SLEEP et renvoie E_NOT_OK en cas d'échec du changement [SWS_LinTrcv_00002]. Les réveils externes sont détectés via l'ICU et signalés lorsque LinIf appelle LinTrcv_CheckWakeup. Dans R20-11, E_OK signifie alors « réveil détecté » [SWS_LinTrcv_00012]. Les temps d'attente pour les changements d'état doivent être mis en œuvre avec Tm_BusyWait1us16bit.

plus ›

Le LIN Transceiver Driver commande le transceiver LIN physique d'un canal et découple l'interface LIN du matériel. LinIf appelle directement ses services : LinIf_SetTrcvMode appelle par exemple LinTrcv_SetOpMode et renvoie son résultat sans modification [SWS_LinTrcv_00002] LinIf-SWS p. 90. Les états logiciels et matériels sont séparés. L'implémentation détermine quels états matériels sont couverts par un mode logiciel LinTrcv-SWS p. 16.

Le pilote connaît les modes LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY et LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. Après la mise sous tension, il est inactif. LinTrcv_Init l'active avec un ensemble de configuration [SWS_LinTrcv_00001], le mode initial étant SLEEP LinTrcv-SWS p. 1. STANDBY est facultatif et peut être un état purement interne LinTrcv-SWS Fig. 7.1 p. 15.

Diagramme d'états : cycle de vie depuis Power-On jusqu'aux changements de mode avec LinTrcv_SetOpMode, en passant par LinTrcv_Init. Les transitions optionnelles sont reconstituées (interprétation). Sources : LinTrcv-SWS Fig. 7.1 p. 15 [SWS_LinTrcv_00168]

Le pilote ne détecte pas les réveils externes via sa propre ISR, mais via l'ICU LinTrcv-SWS p. 17. LinIf les interroge à l'aide de LinTrcv_CheckWakeup. Dans R20-11, E_OK signifie alors « réveil détecté » [SWS_LinTrcv_00012]. Les versions ultérieures le définissent différemment. Un réveil détecté est signalé via LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv_SetWakeupMode autorise la notification, la verrouille ou supprime les événements mémorisés [SWS_LinTrcv_00169].

Diagramme de séquence : réveil externe depuis la détection par l'ICU via LinTrcv_CheckWakeup et LinIf_WakeupConfirmation jusqu'à l'interrogation du motif. Sources : [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] LinTrcv-SWS p. 17

Les conditions aux limites suivantes s'appliquent au fonctionnement :

• Les temps d'attente lors des changements d'état doivent être mis en œuvre avec Tm_BusyWait1us16bit [SWS_LinTrcv_00171].
• Sur les systèmes multicœurs, LinTrcvChannel et LinChannel d'un canal doivent référencer la même partition [SWS_LinTrcv_00177].
• En cas de communication perturbée avec le transceiver, les interrogations renvoient E_NOT_OK LinTrcv-SWS p. 26.

Les codes d'erreur DET ne sont étayés que dans des versions ultérieures. R21-11 ayant assaini les codes d'erreur, leurs noms peuvent différer dans R20-11 LinTrcv-SWS p. 1.

plus ›

Rôle entre l'interface LIN et le composant transceiver

Le LIN Transceiver Driver (LinTrcv) encapsule le pilotage du transceiver LIN physique. Son interface se compose de sept services :

• Initialisation avec LinTrcv_Init [SWS_LinTrcv_00001]
• Changement de mode avec LinTrcv_SetOpMode [SWS_LinTrcv_00002]
• Interrogation du mode avec LinTrcv_GetOpMode [SWS_LinTrcv_00005]
• Interrogation du motif de réveil avec LinTrcv_GetBusWuReason [SWS_LinTrcv_00007]
• Commande de la notification de réveil avec LinTrcv_SetWakeupMode [SWS_LinTrcv_00009]
• Vérification du réveil avec LinTrcv_CheckWakeup [SWS_LinTrcv_00012]
• Interrogation de version avec LinTrcv_GetVersionInfo [SWS_LinTrcv_00008]

Tous les services sont synchrones. Les états logiciels du pilote sont dissociés des états matériels du composant. Le composant peut admettre plus de transitions que le pilote. L'implémentation décide quels états matériels sont couverts par un état logiciel. Elle doit toutefois fournir l'intégralité des fonctionnalités décrites LinTrcv-SWS p. 16.

Vers le haut, l'interface LIN (LinIf) est l'utilisateur documenté dans le payload. Les services de LinIf appellent chacun un service de LinTrcv :

• LinIf_SetTrcvMode appelle LinTrcv_SetOpMode et restitue sa valeur de retour sans modification LinIf-SWS p. 90.
• LinIf_GetTrcvMode appelle LinTrcv_GetOpMode LinIf-SWS p. 91.
• LinIf_GetTrcvWakeupReason appelle LinTrcv_GetBusWuReason LinIf-SWS p. 92.
• LinIf_SetTrcvWakeupMode appelle LinTrcv_SetWakeupMode LinIf-SWS p. 93.

Les types LinTrcv_TrcvModeType et LinTrcv_TrcvWakeupModeType sont disponibles via Lin_GeneralTypes.h [SWS_LinTrcv_00168] [SWS_LinTrcv_00169]. LinIf les utilise directement dans ses signatures. L'ancien type propre LinIf_TrcvModeType a été remplacé dans la version 3.1.5 par LinTrcv_TrcvModeType LinIf-SWS p. 4.

Vers le bas, le pilote utilise les services suivants :

• les services de lecture et d'écriture de Dio, Det_ReportError et EcuM_SetWakeupEvent [SWS_LinTrcv_91003]
• des types issus de Dio, Spi, Icu et EcuM [SWS_LinTrcv_91001]
• Icu_EnableNotification et Icu_DisableNotification pour la notification de réveil LinTrcv-SWS p. 17
• le service de temps Tm_BusyWait1us16bit pour les temps d'attente lors des changements d'état [SWS_LinTrcv_00171]

Le pilote signale les réveils détectés à LinIf via LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinIf positionne ensuite l'indicateur de réveil du canal concerné LinIf-SWS p. 98.

Diagramme de contexte : LinTrcv se situe entre LinIf et les services de bas niveau Dio/Spi, Icu et Tm, et renvoie les réveils à LinIf. Sources : [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] [SWS_LinTrcv_00171] LinTrcv-SWS p. 17 LinTrcv-SWS Fig. 10.3 p. 45

Cycle de vie des modes de fonctionnement, de Power-On à Sleep

Le pilote connaît trois modes de fonctionnement logiciels : LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY et LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. La figure 7.1 de la spécification les intègre dans un cycle de vie LinTrcv-SWS Fig. 7.1 p. 15 :

• Après la mise sous tension, le pilote est dans l'état NOT_ACTIVE.
• LinTrcv_Init le fait passer dans l'état ACTIVE. Les trois modes se trouvent au sein de ACTIVE.
• Une coupure d'alimentation met fin au cycle de vie.

LinTrcv_Init reçoit un pointeur vers l'ensemble de configuration sélectionné [SWS_LinTrcv_00001]. La structure LinTrcv_ConfigType est spécifique à l'implémentation [SWS_LinTrcv_00172]. Depuis la version 4.3.1, le mode initial après l'initialisation est limité à LINTRCV_TRCV_MODE_SLEEP LinTrcv-SWS p. 1.

À l'état ACTIVE, LinTrcv_SetOpMode fait passer l'état interne du canal adressé au mode transmis [SWS_LinTrcv_00002] LinTrcv-SWS p. 25. Le mode LINTRCV_TRCV_MODE_STANDBY est optionnel. Il peut s'agir d'un état purement interne que le matériel utilise pour les transitions. Un matériel concret n'a éventuellement pas besoin de toutes les interfaces LinTrcv-SWS Fig. 7.1 p. 15. La spécification mentionne en outre des conditions dans lesquelles LinTrcv_SetOpMode fait passer le canal à STANDBY. Ces conditions sont tronquées dans le présent extrait et ne sont pas détaillées ici LinTrcv-SWS p. 25.

LinTrcv_GetOpMode fournit dans le paramètre de sortie OpMode l'état logiciel actuel du pilote [SWS_LinTrcv_00005] LinTrcv-SWS p. 26. Il ne s'agit pas obligatoirement de l'état du composant. Un appelant peut ainsi vérifier, avant un changement de mode, dans quel mode se trouve le canal. Via LinIf, cette interrogation est disponible sous la forme LinIf_GetTrcvMode LinIf-SWS p. 91.

Diagramme d'états : après la mise sous tension, le pilote est inactif. LinTrcv_Init mène à la zone active avec le mode initial SLEEP, LinTrcv_SetOpMode commute entre les modes. Les transitions optionnelles sont reconstituées à partir des légendes de la figure 7.1 (interprétation). Les changements conditionnels vers STANDBY ne sont pas représentés. Sources : LinTrcv-SWS Fig. 7.1 p. 15 [SWS_LinTrcv_00168] [SWS_LinTrcv_00001] LinTrcv-SWS p. 1

Changement de mode et interrogations via l'interface LIN

Chaque service adresse un canal via le paramètre LinNetwork de type uint8 [SWS_LinTrcv_00002] [SWS_LinTrcv_00005]. Dans LinIf, le paramètre correspondant s'appelle Channel et possède le type NetworkHandleType LinIf-SWS p. 90.

LinTrcv_SetOpMode est synchrone et non réentrant, l'identifiant de service (Service-ID) est 0x01. Les valeurs de retour signifient [SWS_LinTrcv_00002] :

• E_OK : l'état du transceiver est passé au mode demandé.
• E_NOT_OK : le changement n'a pas été accepté, a échoué ou le paramètre se situe en dehors de la plage admissible.

LinIf doit autoriser l'appel pour tous les transceivers et tous les modes, même si le matériel ne prend pas en charge un mode LinIf-SWS p. 90. Le mappage sur le matériel reste ainsi la tâche de LinTrcv.

Le pilote réalise les temps d'attente lors des changements d'état à l'aide de Tm_BusyWait1us16bit [SWS_LinTrcv_00171]. Comme LinTrcv_SetOpMode fonctionne de manière synchrone [SWS_LinTrcv_00002], cette attente active devrait intervenir au sein de l'appel et prolonger sa durée d'exécution (interprétation). Question Q-54fe21bbe7c737d9 (ouverte) Lors du passage en mode veille, le pilote active en outre les canaux ICU pour la détection de réveil LinTrcv-SWS p. 17.

Les services d'interrogation sont réentrants. LinTrcv_GetBusWuReason fournit la cause de réveil détectée dans le type LinTrcv_TrcvWakeupReasonType [SWS_LinTrcv_00007]. Parmi ses valeurs figurent LINTRCV_WU_ERROR, LINTRCV_WU_NOT_SUPPORTED, LINTRCV_WU_BY_BUS et LINTRCV_WU_BY_PIN [SWS_LinTrcv_00170]. La précision avec laquelle les causes de réveil peuvent être distinguées dépend fortement du matériel du transceiver LinTrcv-SWS p. 28. LinTrcv_GetVersionInfo renvoie les informations de version sous forme de Std_VersionInfoType [SWS_LinTrcv_00008] LinTrcv-SWS p. 29.

Diagramme de séquence : un changement de mode se déroule de LinIf vers LinTrcv. LinTrcv attend via Tm, active la notification ICU lors du passage à STANDBY et renvoie son résultat inchangé via LinIf. Le pilotage via Dio/Spi et l'emplacement du temps d'attente dans l'appel relèvent de l'interprétation. Sources : [SWS_LinTrcv_00002] [SWS_LinTrcv_00171] LinIf-SWS p. 90 LinTrcv-SWS p. 17

Détecter, notifier et contrôler le réveil

Le pilote distingue deux types de réveil LinTrcv-SWS p. 17 :

• Réveil interne : une couche supérieure le déclenche, par exemple via LinTrcv_Init ou LinTrcv_SetOpMode.
• Réveil externe : le pilote le détecte sur le canal LIN. LinIf doit appeler LinTrcv_CheckWakeup pour que le réveil soit notifié vers le haut.

Le pilote ne prévoit pas d'ISR propre pour le réveil. La détection s'effectue via l'ICU avec Icu_EnableNotification et Icu_DisableNotification. Le type de réveil est sélectionné via le paramètre de configuration LinTrcvWakeUpSupport. Avec LinTrcvWakeupByBusUsed, la prise en charge du réveil peut être activée et désactivée par canal LinTrcv-SWS p. 17.

LinTrcv_CheckWakeup évalue le réveil sur le réseau adressé, par exemple un niveau de bus dominant ou un front descendant sur la broche de réveil LinTrcv-SWS p. 30. Dans la version R20-11, les valeurs de retour signifient [SWS_LinTrcv_00012] :

• E_OK : un réveil a été détecté.
• E_NOT_OK : aucun réveil n'a été détecté.

Le passage documentaire issu de versions ultérieures définit les valeurs différemment, comme « appel accepté/non accepté ». Cette modification est apparue avec R22-11 et ne s'applique pas à R20-11 LinTrcv-SWS p. 1 LinTrcv-SWS p. 30. Après une détection réussie, le pilote notifie la source de réveil via LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv ne propose pas de notifications par rappel propres LinTrcv-SWS p. 32. C'est pourquoi LinTrcv_CheckWakeup doit être appelé activement.

LinTrcv_SetWakeupMode est synchrone et non réentrant. Il contrôle la notification de réveil par réseau via LinTrcv_TrcvWakeupModeType [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] :

• LINTRCV_WUMODE_ENABLE active la notification.
• LINTRCV_WUMODE_DISABLE la désactive.
• LINTRCV_WUMODE_CLEAR efface un événement de réveil mémorisé.

Si un événement mémorisé est déjà présent lors de l'activation, le pilote exécute la notification dès l'appel ou immédiatement après LinTrcv-SWS p. 31. LinIf propose ce contrôle sous la forme LinIf_SetTrcvWakeupMode LinIf-SWS p. 93.

Diagramme de séquence : un réveil externe est détecté via l'ICU. LinIf le vérifie avec LinTrcv_CheckWakeup, LinTrcv le confirme par LinIf_WakeupConfirmation, et la cause peut ensuite être interrogée (valeurs de retour selon R20-11). Sources : [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] [SWS_LinTrcv_00007] LinTrcv-SWS p. 17 LinIf-SWS p. 98

Diagramme d'activité : LinTrcv_SetWakeupMode effectue un branchement selon le mode demandé. Une notification ne suit immédiatement qu'en cas de ENABLE avec événement mémorisé. Sources : [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] LinTrcv-SWS p. 31

Accès matériel, configuration des canaux et partitionnement

Le conteneur de sélection LinTrcvAccess définit la manière dont le pilote accède au composant LinTrcv-SWS Fig. 10.3 p. 45. Exactement une des deux variantes doit être choisie :

• LinTrcvDioAccess : les broches du transceiver sont mappées sur des canaux DIO.
• LinTrcvSpiSequence : un composant compatible SPI est adressé via une séquence SPI.

Le schéma provient de R23-11 et de versions ultérieures. Les services de lecture et d'écriture DIO ainsi que les types SPI sont toutefois déjà répertoriés dans R20-11 comme interfaces utilisées ou types importés [SWS_LinTrcv_91003] [SWS_LinTrcv_91001].

Pour les systèmes multicœurs, les règles suivantes s'appliquent dans R20-11 :

• Le pilote doit rejeter les configurations comportant des assignations de partition non prises en charge [SWS_LinTrcv_00174].
• Les partitions référencées via LinTrcvChannelEcucPartitionRef doivent constituer un sous-ensemble de celles référencées via LinTrcvEcucPartitionRef. Si le module référence des partitions, chaque canal doit en référencer exactement une [SWS_LinTrcv_00176].
• LinTrcvChannel et LinChannel d'un même canal de communication doivent référencer la même partition [SWS_LinTrcv_00177].

La distribution multicœur a été ajoutée avec R19-11 et précisée dans R24-11 LinTrcv-SWS p. 1.

Comportement en cas d'erreur

Les erreurs d'exécution se manifestent dans la valeur de retour :

• En cas de communication absente ou perturbée avec le transceiver, LinTrcv_GetOpMode LinTrcv-SWS p. 26 et LinTrcv_GetBusWuReason renvoient LinTrcv-SWS p. 28 E_NOT_OK.
• LinTrcv_SetOpMode renvoie E_NOT_OK lorsqu'un changement n'a pas été accepté ou a échoué [SWS_LinTrcv_00002].
• LinTrcv_SetWakeupMode renvoie E_NOT_OK lorsque le mode de réveil n'a pas pu être défini LinTrcv-SWS p. 31.
• Si une cause de réveil ne peut pas être déterminée en raison d'une erreur, la valeur LINTRCV_WU_ERROR est disponible à cet effet [SWS_LinTrcv_00170].

Le pilote signale les erreurs de développement via Det_ReportError [SWS_LinTrcv_91003]. Dans R20-11, elles entraînent E_NOT_OK pour LinTrcv_GetOpMode et LinTrcv_GetBusWuReason [SWS_LinTrcv_00005] [SWS_LinTrcv_00007]. Les passages documentaires issus de versions ultérieures mentionnent des contrôles concrets LinTrcv-SWS p. 26 LinTrcv-SWS p. 30 LinTrcv-SWS p. 29 :

• Appel avant l'initialisation : LINTRCV_E_UNINIT
• Numéro de réseau non valide : LINTRCV_E_INVALID_LIN_NETWORK
• Pointeur nul pour LinTrcv_GetVersionInfo : LINTRCV_E_PARAM_POINTER

Sur le fond, ces vérifications devraient s'appliquer également à R20-11 (interprétation). Question Q-58e3d310b525b810 (ouverte) R20-11 a toutefois assaini la classification des erreurs et R21-11 les codes d'erreur. Les identifiants peuvent donc différer dans R20-11 LinTrcv-SWS p. 1.

LinIf intercepte déjà une partie des erreurs d'utilisation. En cas de Channel non valide, LinIf_SetTrcvMode et LinIf_GetTrcvMode signalent l'erreur LINIF_E_NONEXISTENT_CHANNEL LinIf-SWS p. 90. LinIf_GetTrcvMode renvoie en outre E_NOT_OK en cas de canal non valide ou de pointeur nul LinIf-SWS p. 91. Si LinIf_WakeupConfirmation reçoit une source de réveil non valide, il déclenche LINIF_E_PARAM_WAKEUPSOURCE lorsque la détection d'erreurs est activée LinIf-SWS p. 98.

Preuves détaillées supplémentaires

• [SWS_LinTrcv_00002] avec LinTrcv-SWS p. 25 : changement de mode, valeurs de retour et passage à STANDBY.
• [SWS_LinTrcv_00012] avec LinTrcv-SWS p. 30 : vérification du réveil. Les valeurs de retour dans R20-11 diffèrent de celles des versions ultérieures.
• [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] avec LinTrcv-SWS p. 31 : activer, désactiver et effacer la notification de réveil.
• [SWS_LinTrcv_00168] avec LinTrcv-SWS Fig. 7.1 p. 15 : modes de fonctionnement et cycle de vie.
• [SWS_LinTrcv_00170] avec LinTrcv-SWS p. 28 : causes de réveil et leur dépendance vis-à-vis du matériel.
• [SWS_LinTrcv_00171] : temps d'attente via Tm_BusyWait1us16bit.
• [SWS_LinTrcv_00174] [SWS_LinTrcv_00176] [SWS_LinTrcv_00177] : partitionnement sur calculateurs multicœurs.
• [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] : types importés, confirmation de réveil transmise à LinIf et autres interfaces utilisées.
• LinTrcv-SWS p. 17 : réveils internes et externes, utilisation de l'ICU et configuration du réveil.