FlexRay Transceiver Driver (FrTrcv)

Le pilote de transceiver FlexRay pilote les composants transceiver d'un calculateur via Dio ou Spi et propose en ACTIVE les modes NORMAL, RECEIVEONLY, STANDBY et SLEEP [SWS_FrTrcv_00481]. Il définit et lit les modes, détecte les événements de réveil par scrutation cyclique ou par notification, les signale à l'EcuM et fournit la cause du réveil. Dans le cas d'étoiles actives, il interroge les erreurs de bus par branche et déconnecte ou reconnecte les branches. Si un changement de mode échoue, il renvoie E_NOT_OK et laisse l'état précédent inchangé [SWS_FrTrcv_00323].

plus ›

Le pilote de transceiver FlexRay pilote les composants transceiver d'un calculateur. Il adresse chaque composant via l'index basé sur zéro FrTrcv_TrcvIdx [SWS_FrTrcv_00323]. Vers le bas, il accède au matériel selon la configuration via Dio ou Spi SWS FrTrcv Fig. 10.4 p. 77. De plus, il utilise Icu, EcuM, Dem et Det [SWS_FrTrcv_00334]. Vers le haut, FrIf devrait avant tout utiliser les services pour le compte du FlexRay State Manager (interprétation) SWS FrSM p. 20. Question (ouverte)

Diagramme de contexte : FrTrcv entre FrIf/FrSM, les pilotes matériels et les services EcuM, DEM et DET. Sources : [SWS_FrTrcv_00334], SWS FrSM p. 20

Après la mise sous tension, le pilote est à l'état NOT_ACTIVE et passe à ACTIVE avec FrTrcv_Init SWS FrTrcv Fig. 7.1 p. 23. Là s'appliquent les modes NORMAL, RECEIVEONLY, STANDBY et SLEEP [SWS_FrTrcv_00481]. FrTrcv_SetTransceiverMode commute entre eux. Si le changement échoue, le service renvoie E_NOT_OK et conserve l'ancien état. Le pilote réalise les temps d'attente à l'aide de Tm_BusyWait1us16bit [SWS_FrTrcv_00485]. En STANDBY, les canaux de réveil ICU sont activés, en NORMAL ils sont désactivés [SWS_FrTrcv_00491] [SWS_FrTrcv_00492].

Diagramme d'états : les quatre modes ACTIVE ne sont accessibles qu'après FrTrcv_Init. Les transitions sont partiellement reconstituées (interprétation). Sources : SWS FrTrcv Fig. 7.1 p. 23, [SWS_FrTrcv_00481]

Le pilote détecte les événements de réveil par deux voies : par FrTrcv_MainFunction cyclique [SWS_FrTrcv_00330] ou par notification. Selon FrTrcv_CheckWakeupByTransceiver, il signale l'événement à l'EcuM SWS FrTrcv p. 46. La cause, par exemple FRTRCV_WU_BY_BUS, est fournie par FrTrcv_GetTransceiverWUReason dans la mesure où le matériel peut la distinguer [SWS_FrTrcv_00074]. FrTrcv_ClearTransceiverWakeup efface tous les événements en attente [SWS_FrTrcv_00329].

Dans le cas d'étoiles actives, des services optionnels interrogent les erreurs de bus par branche et déconnectent ou reconnectent les branches [SWS_FrTrcv_00419] [SWS_FrTrcv_00442] [SWS_FrTrcv_00443]. Pour le traitement des erreurs :

• Les erreurs de développement telles que FRTRCV_E_UNINIT sont transmises à DET [SWS_FrTrcv_00085].
• Les erreurs d'exécution telles que FRTRCV_E_FR_NO_CONTROL_TRCV passent par Det_ReportRuntimeError [SWS_FrTrcv_91001].
• Le pilote signale les erreurs de bus de classes A et B à DEM ou à une fonction de remplacement configurée [SWS_FrTrcv_00475].

plus ›

Rôle : abstraction matérielle pour les composants transceiver FlexRay

Le pilote de transceiver FlexRay pilote un ou plusieurs composants transceiver FlexRay d'un calculateur. Tous les services liés aux canaux sélectionnent le composant via l'index basé sur zéro FrTrcv_TrcvIdx, qui s'applique dans le contexte du pilote [SWS_FrTrcv_00323]. Le pilote propose trois groupes de services :

• Définition et interrogation des modes de fonctionnement [SWS_FrTrcv_00324],
• Traitement des événements de réveil [SWS_FrTrcv_00325] [SWS_FrTrcv_00331],
• dans le cas d'étoiles actives, la gestion des branches individuelles [SWS_FrTrcv_00419].

FrTrcv_GetVersionInfo fournit expressément la version du module logiciel et non celle du matériel du transceiver SWS FrTrcv p. 43.

Vers le bas, le pilote accède au composant via Dio ou Spi. Pour les notifications de réveil, il utilise Icu, les signalements vont à EcuM, Dem et Det [SWS_FrTrcv_00334] [SWS_FrTrcv_00321]. Le type d'accès est défini par le conteneur de choix FrTrcvAccess : il n'autorise qu'exactement l'une des deux alternatives, à savoir l'accès Dio ou la séquence SPI SWS FrTrcv Fig. 10.4 p. 77.

Vers le haut, c'est surtout la FlexRay Interface qui devrait utiliser les services. Le FlexRay State Manager détermine la cause du réveil par transceiver d'un cluster via FrIf_GetTransceiverWUReason SWS FrSM p. 20. Interprétation : FrIf transmet ces requêtes à FrTrcv. Question Q-29229b532631a6b5 (ouverte) Cela concorde avec le fait que les types communs dans Fr_GeneralTypes.h sont protégés par FR_GENERAL_TYPES afin que plusieurs pilotes de transceiver et FrIf puissent les partager SWS FrTrcv p. 34.

Diagramme de contexte : FrTrcv se situe entre FrIf/FrSM et les pilotes Dio, Spi et Icu et émet des signalements vers EcuM, DEM et DET. Sources : [SWS_FrTrcv_00334], [SWS_FrTrcv_00485], [SWS_FrTrcv_00330], SWS FrSM p. 20

Modes de fonctionnement entre NOT_ACTIVE et ACTIVE

La figure 7.1 de la spécification décrit les modes sous la forme d'un automate à états imbriqué. À l'intérieur de POWER_ON, le pilote se trouve en NOT_ACTIVE après la mise sous tension et passe à ACTIVE avec FrTrcv_Init() SWS FrTrcv Fig. 7.1 p. 23. C'est uniquement en ACTIVE que s'appliquent les quatre valeurs de FrTrcv_TrcvModeType : FRTRCV_TRCVMODE_NORMAL, FRTRCV_TRCVMODE_RECEIVEONLY, FRTRCV_TRCVMODE_STANDBY et FRTRCV_TRCVMODE_SLEEP [SWS_FrTrcv_00481]. La couche appelante commute entre ces modes à l'aide de FrTrcv_SetTransceiverMode [SWS_FrTrcv_00323].

Un changement de mode s'exécute de façon synchrone et n'est pas réentrant. Les transitions vers des états optionnels peuvent échouer. Dans ce cas, le service renvoie E_NOT_OK et l'état précédent est conservé SWS FrTrcv p. 39. Si le composant requiert des temps d'attente pour un changement d'état, le pilote les réalise à l'aide du service de temporisation Tm_BusyWait1us16bit [SWS_FrTrcv_00485]. FrTrcv_GetTransceiverMode lit l'état réel. Ce service est réentrant et peut donc également être appelé en parallèle [SWS_FrTrcv_00324].

Diagramme d'états : les quatre modes ACTIVE ne sont accessibles via FrTrcv_SetTransceiverMode qu'après FrTrcv_Init. Le choix des transitions est partiellement reconstitué (interprétation). Sources : SWS FrTrcv Fig. 7.1 p. 23, [SWS_FrTrcv_00481]

Démarrage et établissement de la communication sur le bus

FrTrcv_Init reçoit un pointeur vers le jeu de configuration sélectionné et initialise le pilote [SWS_FrTrcv_00322]. Cette fonction distincte initialise les variables et les ressources matérielles. Les pilotes qui gèrent des sources de réveil sont réinitialisés dans le bloc de redémarrage et réarment ce faisant le mécanisme de déclenchement de la notification de réveil SWS FrTrcv p. 37. Le pilote prend en charge la séquence d'initialisation de la pile AUTOSAR. Interprétation : au sein de cette séquence, c'est vraisemblablement l'ECU State Manager qui appelle la fonction. Question Q-93ce1e5987a96873 (ouverte)

Le passage à NORMAL a des répercussions sur les chemins de réveil. Si FrTrcvIcuChannelRef est configuré, le pilote désactive les canaux ICU avec Icu_DisableNotification [SWS_FrTrcv_00492]. Sans cette référence, il n'accède pas du tout aux canaux ICU [SWS_FrTrcv_00490].

Diagramme de séquence : l'initialisation est suivie du passage à NORMAL avec attente active (busy-wait) et désactivation optionnelle d'ICU. Un échec laisse l'état inchangé. Sources : [SWS_FrTrcv_00322], [SWS_FrTrcv_00323], [SWS_FrTrcv_00485], [SWS_FrTrcv_00492]

Détection de réveil en STANDBY et SLEEP, cause du réveil

Lors du passage à STANDBY, le pilote réactive les canaux ICU [SWS_FrTrcv_00491]. De plus, à chaque passage à STANDBY, FrTrcv_SetTransceiverMode efface l'historique des erreurs dans le transceiver, pour autant que le matériel le prenne en charge SWS FrTrcv p. 39.

En outre, le pilote peut effectuer une scrutation cyclique. Pour cela, il met FrTrcv_MainFunction à disposition via SchM_FrTrcv.h [SWS_FrTrcv_00330]. D'après le passage de document issu de R23-11, la fonction recherche des événements de réveil sur tous les bus en STANDBY et SLEEP et mémorise en interne les événements trouvés. La période est fixée par la configuration. La fonction peut s'exécuter de manière synchrone ou asynchrone par rapport à l'ordonnancement du bus FlexRay SWS FrTrcv p. 49.

Diagramme de séquence : lors de la transition vers STANDBY, l'historique des erreurs est effacé et la notification ICU est activée. Ensuite, la Main Function recherche cycliquement des événements de réveil. Sources : [SWS_FrTrcv_00491], [SWS_FrTrcv_00330], SWS FrTrcv p. 49

Si le composant détecte un réveil par le bus, le côté SPI ou DIO sous-jacent notifie le pilote. Cela peut se produire dans le contexte d'interruption SWS FrTrcv p. 46. Si FrTrcv_CheckWakeupByTransceiver est ensuite appelée [SWS_FrTrcv_00331], le pilote signale l'événement à l'ECU State Manager. À cette fin, EcuM_SetWakeupEvent figure dans la liste des interfaces utilisées [SWS_FrTrcv_00334]. Interprétation : l'appel de vérification est vraisemblablement déclenché par EcuM dans sa séquence de réveil. Question Q-d5873691a495bef0 (ouverte)

La cause du réveil est fournie par FrTrcv_GetTransceiverWUReason [SWS_FrTrcv_00325] en tant que valeur de FrTrcv_TrcvWUReasonType. Les valeurs possibles sont FRTRCV_WU_BY_BUS, FRTRCV_WU_BY_PIN, FRTRCV_WU_INTERNALLY ou FRTRCV_WU_NOT_SUPPORTED [SWS_FrTrcv_00074]. La précision avec laquelle les causes sont distinguées dépend fortement du matériel SWS FrTrcv p. 42. Le passage de document de versions ultérieures mentionne en outre FRTRCV_WU_RESET et FRTRCV_WU_POWER_ON SWS FrTrcv p. 34. Le texte d'exigence R20-11 dans le payload est raccourci à cet endroit.

Le FrSM vérifie la cause du réveil pour chaque transceiver pour FRTRCV_WU_BY_BUS. Il distingue ainsi s'il n'y a aucun réveil du bus, un réveil partiel ou un réveil complet SWS FrSM p. 20. FrTrcv_ClearTransceiverWakeup efface ensuite tous les événements de réveil en attente [SWS_FrTrcv_00329]. L'appel est également autorisé lorsque la notification de réveil est désactivée SWS FrTrcv p. 44.

Diagramme de séquence : déroulement depuis la notification matérielle jusqu'à l'interrogation et l'effacement de la cause du réveil, en passant par le signalement à EcuM. Le payload ne mentionne pas l'appelant de la fonction de vérification (interprétation). Sources : [SWS_FrTrcv_00331], [SWS_FrTrcv_00325], [SWS_FrTrcv_00329], SWS FrTrcv p. 46

Étoiles actives : surveiller, déconnecter et réactiver les branches

Pour les transceivers qui desservent plusieurs branches en tant qu'étoile active, il existe trois services supplémentaires. Ils ne sont disponibles que si des branches sont configurées SWS FrTrcv p. 52. Tous les trois adressent en outre la branche via l'index basé sur zéro FrTrcv_BranchIdx et ne sont pas réentrants [SWS_FrTrcv_00419] [SWS_FrTrcv_00442] [SWS_FrTrcv_00443].

FrTrcv_GetTransceiverError écrit l'état d'erreur d'une branche sous forme de uint32 dans FrTrcv_BusErrorState. Peuvent être interrogées toutes les erreurs prescrites par l'EPL FlexRay que le matériel prend en charge SWS FrTrcv p. 48. Les branches défectueuses sont déconnectées à l'aide de FrTrcv_DisableTransceiverBranch SWS FrTrcv p. 50. FrTrcv_EnableTransceiverBranch les réactive de manière synchrone avec l'ordonnancement du bus FlexRay SWS FrTrcv p. 51. Si un index se situe en dehors de la plage valide, les deux services de commutation renvoient E_NOT_OK, et l'état de la branche reste inchangé [SWS_FrTrcv_00442] [SWS_FrTrcv_00443].

Diagramme d'activité : interrogation des erreurs par branche, déconnexion des branches défectueuses et réactivation synchrone avec l'ordonnancement du bus. Le fait que la couche appelante prenne la décision constitue une interprétation. Sources : [SWS_FrTrcv_00419], SWS FrTrcv p. 50, SWS FrTrcv p. 51

Configuration, type d'accès et partitionnement

FrTrcv_ConfigType est une structure spécifique à l'implémentation [SWS_FrTrcv_00487]. Le module contient un ou plusieurs conteneurs FrTrcvChannel, un par canal de transceiver, ainsi que FrTrcvGeneral SWS FrTrcv p. 59. Ce passage de document issu de R23-11/R25-11 ne mentionne en outre que VARIANT-PRE-COMPILE sans prise en charge post-build. Pour R20-11, le payload ne contient aucune exigence à ce sujet.

Par émetteur-récepteur, FrTrcvAccess sélectionne soit FrTrcvDioAccess, soit FrTrcvSpiSequence SWS FrTrcv Fig. 10.4 p. 77. Les fonctions optionnelles peuvent être activées et désactivées au moment de la compilation SWS FrTrcv p. 52. FrTrcvIcuChannelRef lie la notification de réveil ICU à [SWS_FrTrcv_00490]. Avec FrTrcvDemReportErrorStatusConfiguration, une fonction personnalisée avec la même signature peut être utilisée à la place de Dem_SetEventStatus [SWS_FrTrcv_00475].

Dans les systèmes partitionnés, le module fonctionne comme une instance indépendante par partition. Un appel d'API n'affecte que la partition dans laquelle il est effectué [SWS_FrTrcv_00494]. Le module doit rejeter les affectations de partition que l'implémentation ne prend pas en charge [SWS_FrTrcv_00497].

Comportement en cas d'erreur

Les erreurs de développement sont définies [SWS_FrTrcv_00085] :

• FRTRCV_E_FR_INVALID_TRCVIDX (0x01),
• FRTRCV_E_FR_INVALID_BRANCHIDX (0x02),
• FRTRCV_E_UNINIT (0x10),
• FRTRCV_E_PARAM_POINTER (0x15).

Ils ne sont signalés que lorsque la détection des erreurs de développement est activée. Des exemples sont FRTRCV_E_UNINIT pour les services de dérivation SWS FrTrcv p. 50 et le pointeur NULL pour FrTrcv_GetVersionInfo SWS FrTrcv p. 43.

Comme erreurs de runtime, le pilote signale les appels dans le mauvais mode avec FRTRCV_E_FR_TRCV_NOT_STANDBY à FRTRCV_E_FR_TRCV_NOT_RECEIVEONLY (0x11 à 0x14). Il signale une communication absente ou défectueuse avec le composant à l'aide de FRTRCV_E_FR_NO_CONTROL_TRCV (0x16) [SWS_FrTrcv_91001]. Ces notifications transitent par Det_ReportRuntimeError [SWS_FrTrcv_00493]. FrTrcv_GetTransceiverMode déclenche l'erreur FRTRCV_E_FR_NO_CONTROL_TRCV, par exemple lors d'une erreur d'accès à l'émetteur-récepteur SWS FrTrcv p. 41.

Avec E_NOT_OK, les paramètres de sortie restent inchangés, par exemple avec FrTrcv_GetTransceiverMode et FrTrcv_GetTransceiverError SWS FrTrcv p. 48. Un échec de changement de mode maintient l'état précédent [SWS_FrTrcv_00323].

Diagramme d'activité : les vérifications de paramètres et d'initialisation conduisent à des erreurs de développement, les erreurs d'accès à une erreur de runtime. L'ordre des vérifications est une interprétation. Les vérifications DET n'existent que si la détection d'erreurs est activée. Sources : [SWS_FrTrcv_00085], [SWS_FrTrcv_91001], [SWS_FrTrcv_00493]

Pour le diagnostic de production, le pilote distingue deux classes d'émetteurs-récepteurs :

• Pour les émetteurs-récepteurs de classe A pilotés par GPIO, une broche ERRN active (low) signifie « Fail », une broche inactive (high) « Pass » [SWS_FrTrcv_00489].
• Pour les émetteurs-récepteurs de classe B pilotés par SPI, chaque bit 1…9 activé déclenche une erreur de bus [SWS_FrTrcv_00488].

L'évaluation a lieu lors d'un HALT inattendu ou à l'état NORMAL_ACTIVE du contrôleur. En cas de court-circuit sur le bus, un « Pass » du pilote ne suffit pas à lui seul comme preuve SWS FrTrcv p. 26. Dem_SetEventStatus n'est disponible qu'avec STANDARD_REPORTING [SWS_FrTrcv_00334].

Diagramme d'activité : évaluation Pass/Fail par classe d'émetteur-récepteur et acheminement du signalement vers le DEM ou vers la fonction de remplacement configurée. Sources : [SWS_FrTrcv_00488], [SWS_FrTrcv_00489], [SWS_FrTrcv_00475]

Preuves détaillées supplémentaires

Référence	Classification
[SWS_FrTrcv_00481], SWS FrTrcv Abb. 7.1 S. 23	Modes de fonctionnement et automate d'états
[SWS_FrTrcv_00323], SWS FrTrcv S. 39	Changement de mode, échec, effacement de l'historique des erreurs dans STANDBY
[SWS_FrTrcv_00322], SWS FrTrcv S. 37	Initialisation et règle de redémarrage pour les sources de réveil
[SWS_FrTrcv_00330], [SWS_FrTrcv_00485]	Scrutation cyclique et temps d'attente
[SWS_FrTrcv_00331], [SWS_FrTrcv_00325], [SWS_FrTrcv_00074], [SWS_FrTrcv_00329]	Chemin de réveil de la détection à l'effacement
[SWS_FrTrcv_00490], [SWS_FrTrcv_00491], [SWS_FrTrcv_00492]	Notification ICU selon le mode
[SWS_FrTrcv_00419], [SWS_FrTrcv_00442], [SWS_FrTrcv_00443]	Gestion des branches pour les étoiles actives
[SWS_FrTrcv_00085], [SWS_FrTrcv_91001], [SWS_FrTrcv_00493]	Erreurs de développement et de runtime
[SWS_FrTrcv_00488], [SWS_FrTrcv_00489], [SWS_FrTrcv_00475]	Événements DEM et voie de notification
[SWS_FrTrcv_00487], [SWS_FrTrcv_00494], [SWS_FrTrcv_00497]	Type de configuration et partitionnement