LIN Interface (LinIf)

La fonction synchrone LinIf_Init sert à initialiser l’interface LIN conformément à [SWS_LinIf_00198]. L’interface possède le Service-ID 0x01, est disponible via le fichier d’en-tête LinIf.h et s’exécute de manière synchrone.

Contexte d'appel et paramètres

La fonction attend comme unique paramètre ConfigPtr (const LinIf_ConfigType*), qui sert de pointeur vers la configuration de l’interface LIN [SWS_LinIf_00198]. Elle ne possède pas de valeur de retour et ne dispose d’aucun paramètre d’entrée/sortie ou de sortie pure.

Déroulements de l’initialisation et interactions

Dans le cadre de l’initialisation, l’interface LIN procède à des réglages spécifiques pour les nœuds esclaves :

• Conformément à [SWS_LinIf_00767], le module initialise dans LinIf_Init l’adresse de nœud initiale (initial NAD) et l’adresse de nœud configurée (configured NAD) du nœud esclave à l’aide des paramètres de configuration LinIfInitialNAD et LinIfConfiguredNAD.
• Conformément à [SWS_LinIf_00768], le module initialise dans LinIf_Init les PID configurés du nœud esclave à partir des données de configuration via les paramètres de configuration LinIfFrameId.

Concurrence et restrictions

La fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_LinIf_00198]. Un appel concurrent ou chevauchant est donc non autorisé. Aucun code d’erreur spécifique ni message DET n’est indiqué dans le périmètre de spécification fourni pour ce service.

Utilisation et contexte d'appel

La fonction LinIf_Transmit déclarée dans LinIf.h (Service-ID 0x49) sert à la demande synchrone de transmission d'une PDU [SWS_LinIf_00201]. Comme paramètres d'entrée, elle attend TxPduId pour l'identification univoque de la PDU à transmettre ainsi que le pointeur PduInfoPtr vers une structure PduInfoType qui, outre la longueur des données et les données utiles proprement dites, peut également référencer des métadonnées [SWS_LinIf_00201]. Aucun paramètre d'entrée/sortie ou de sortie supplémentaire n'existe [SWS_LinIf_00201].

Valeurs de retour et exigences de comportement

Comme valeur de retour, le service fournit l'état Std_ReturnType [SWS_LinIf_00201] :

• E_OK : la demande de transmission a été acceptée avec succès par l'interface LIN [SWS_LinIf_00201].
• E_NOT_OK : la demande de transmission n'a pas pu être acceptée [SWS_LinIf_00201].

L'interaction avec les types de trames est précisée par [SWS_LinIf_00700] : lorsque l'interface LIN est initialisée, LinIf_Transmit renvoie également E_OK si la PDU appartient à une trame non sporadique sur un nœud LIN maître ou à une trame non déclenchée par événement sur un nœud LIN esclave.

concurrence

En ce qui concerne l'environnement d'exécution, LinIf_Transmit est réentrante pour différents PDU-ID, mais ne doit pas être appelée simultanément ou de manière concurrente pour le même TxPduId [SWS_LinIf_00201].

La fonction LinIf_ScheduleRequest sert exclusivement, sur les nœuds maîtres LIN, à demander l’exécution d’une table de schedule prédéfinie [SWS_LinIf_00202]. L’appel est traité de manière asynchrone et est conçu comme réentrant [SWS_LinIf_00202].

Paramètres et valeurs de retour

Le paramètre Channel permet de transmettre l’index du canal LIN concerné, tandis que Schedule définit l’identification de la nouvelle table de schedule à exécuter [SWS_LinIf_00202]. La fonction renvoie l’état sous la forme Std_ReturnType :

• E_OK : La demande de changement pour la table de schedule a été acceptée avec succès [SWS_LinIf_00202].
• E_NOT_OK : La commutation a été rejetée [SWS_LinIf_00202].

Conditions d’erreur et restrictions

Conformément à la spécification, une valeur de retour de E_NOT_OK survient dans les cas d’erreur suivants [SWS_LinIf_00202] :

• L’interface LIN n’est pas encore initialisée.
• Le canal référencé n’existe pas ou l’index transmis se situe en dehors de la plage de valeurs.
• La table de schedule référencée n’existe pas ou son identifiant est invalide.
• L’état actuel est Sleep.

Interaction

L’échec d’une demande de schedule a un impact sur les déroulements de transport de niveau supérieur : si, dans le cadre d’un appel de LinTp_Transmit via BswM_LinTp_RequestMode, un changement de schedule est initié via LinIf_ScheduleRequest, LinTp_Transmit doit impérativement renvoyer E_NOT_OK lorsque LinIf_ScheduleRequest répond par E_NOT_OK [SWS_LinIf_00878].

Utilisation

La fonction LinIf_GotoSleep (Service-ID 0x06, déclarée dans LinIf.h) initie le passage en mode Sleep sur le canal LIN spécifié [SWS_LinIf_00204]. L'appel s'effectue de manière asynchrone et reçoit comme paramètre d'entrée Channel de type NetworkHandleType l'identifiant du canal concerné [SWS_LinIf_00204].

Valeurs de retour et gestion des erreurs

Comme valeur de retour, le service fournit le type Std_ReturnType avec les significations suivantes [SWS_LinIf_00204] :

• E_OK : la demande de passage en mode Sleep a été acceptée avec succès, la transition d'état vers le mode Sleep est déjà en cours ou le contrôleur se trouve déjà à l'état Sleep [SWS_LinIf_00204].
• E_NOT_OK : la demande n'a pas été acceptée. Les causes possibles en sont une interface LIN pas encore initialisée ou un identificateur de canal inexistant ou situé en dehors de la plage de valeurs valides [SWS_LinIf_00204].

Concurrence et interaction du système

L'interface est définie comme non réentrante (Non Reentrant) [SWS_LinIf_00204]. Si LinIf_GotoSleep est appelée, l'interface LIN doit immédiatement appeler la fonction Lin_GotoSleepInternal et ne doit pas attendre jusqu'au prochain cycle de la fonction principale [SWS_LinIf_00757].

La fonction réentrante LinIf_Wakeup déclenche le processus de réveil asynchrone pour le canal LIN identifié par le paramètre Channel [SWS_LinIf_00205]. Elle est disponible via l'en-tête LinIf.h [SWS_LinIf_00205].

La valeur de retour Std_ReturnType renseigne sur l'acceptation de la demande [SWS_LinIf_00205] :

• E_OK signale que la demande de réveil a été acceptée ou que le contrôleur ne se trouve déjà plus à l'état de veille [SWS_LinIf_00205].
• E_NOT_OK est renvoyé si l'interface LIN n'est pas initialisée, si l'ID de canal transmis se trouve en dehors de la plage valide ou si les appels de pilote sous-jacents Lin_Wakeup ou Lin_WakeupInternal échouent avec E_NOT_OK [SWS_LinIf_00205].

L'interaction avec l'utilisateur s'effectue via la fonction de rappel <User>_WakeupConfirmation :

• En cas d'erreur, l'interface LIN appelle impérativement <User>_WakeupConfirmation(FALSE) avant de retourner E_NOT_OK [SWS_LinIf_00762].
• En cas d'acceptation réussie (E_OK), l'interface LIN confirme le réveil de manière asynchrone : le module n'émet l'appel <User>_WakeupConfirmation(TRUE) qu'au moment où la fonction LinIf_HeaderIndication est ensuite appelée pour la première fois [SWS_LinIf_00761].

La fonction synchrone et réentrante LinIf_SetTrcvMode (Service-ID 0x08) sert à commuter le transceiver LIN indiqué dans le mode de fonctionnement demandé [SWS_LinIf_00544]. L'interface est disponible via le fichier d'en-tête LinIf.h [SWS_LinIf_00544].

Paramètres et valeurs de retour

L'appel requiert deux paramètres d'entrée [SWS_LinIf_00544] :

• Channel (NetworkHandleType) : identifie le canal LIN à commander [SWS_LinIf_00544].
• TransceiverMode (LinTrcv_TrcvModeType) : détermine la transition d'état demandée pour le transceiver [SWS_LinIf_00544].

La valeur de retour de type Std_ReturnType signale le résultat de l'opération de commutation [SWS_LinIf_00544] :

• E_OK : est retourné lorsque l'état du transceiver est passé avec succès dans le mode demandé [SWS_LinIf_00544].
• E_NOT_OK : signale que le changement d'état a échoué ou qu'au moins un paramètre se trouve en dehors de la plage admissible. L'état précédent du transceiver reste inchangé [SWS_LinIf_00544].

Exécution et comportement en cas d'erreur

La fonction est exécutée de manière synchrone et est spécifiée comme réentrante [SWS_LinIf_00544]. Les messages d'erreur DET ou DEM spécifiques ne sont pas listés séparément dans l'élément de spécification ; un échec du changement de mode ou des valeurs de paramètres inadmissibles conduisent directement à la valeur de retour E_NOT_OK [SWS_LinIf_00544].

La fonction synchrone et réentrante LinIf_SetTrcvWakeupMode sert à activer, désactiver ou réinitialiser les notifications pour les événements de réveil sur le canal LIN indiqué [SWS_LinIf_00550]. La déclaration est mise à disposition via l’en-tête LinIf.h et possède le Service-ID 0x0b [SWS_LinIf_00550].

L’interface attend deux paramètres d’entrée [SWS_LinIf_00550] :

• Channel : identifiant unique du réseau ou du canal LIN à adresser, du type NetworkHandleType [SWS_LinIf_00550].
• LinTrcvWakeupMode : mode de réveil demandé pour l’émetteur-récepteur, du type LinTrcv_TrcvWakeupModeType [SWS_LinIf_00550].

En tant que valeur de retour, la fonction fournit l'état Std_ReturnType [SWS_LinIf_00550] :

• E_OK : L’appel du service API du pilote de l’émetteur-récepteur LIN a réussi et a renvoyé E_OK [SWS_LinIf_00550].
• E_NOT_OK : Le service API du pilote de l’émetteur-récepteur LIN a échoué (retour E_NOT_OK) ou au moins l’un des paramètres transmis pour le canal ou le mode est invalide [SWS_LinIf_00550].

En matière d’interaction, la fonction délègue la demande au pilote de l’émetteur-récepteur LIN ; le LinIf constitue vraisemblablement ici une interface intermédiaire entre les couches supérieures et le matériel de l’émetteur-récepteur [SWS_LinIf_00550]. Question Q-07b525a14a2c5fcd (ouverte) Le service étant spécifié comme réentrant, il peut être exécuté en parallèle pour des canaux différents ou le même canal [SWS_LinIf_00550].

Utilisation et contexte d'appel

La fonction LinTp_Init sert à initialiser la couche de transport du protocole LIN ([SWS_LinIf_00350]). Conformément à la spécification [SWS_LinIf_00350], l’appel de fonction opère de manière synchrone.

La signature de la fonction est void LinTp_Init (const LinTp_ConfigType* ConfigPtr). La configuration est transmise via le paramètre d’entrée :

• ConfigPtr (in) : pointeur vers les données de configuration de la couche de transport LIN du type LinTp_ConfigType ([SWS_LinIf_00350]).

La fonction ne renvoie aucune valeur de retour (void) et ne définit aucun paramètre de sortie ou d’entrée/sortie ([SWS_LinIf_00350]). Elle possède le Service-ID hexadécimal 0x40 et est mise à disposition via le fichier d’en-tête LinIf.h ([SWS_LinIf_00350]).

Gestion des erreurs

L’exigence [SWS_LinIf_00350] ne définit pour cette fonction aucun code d’erreur spécifique, message DET ou événement DEM. Aucun état d’erreur n’est renvoyé à l’appelant ([SWS_LinIf_00350]).

Concurrence et restrictions

La fonction LinTp_Init est explicitement classée comme non réentrante (Non Reentrant) ([SWS_LinIf_00350]). Par conséquent, elle ne doit pas être appelée de manière concurrente depuis plusieurs threads, tâches ou routines d’interruption. Interprétation : l’appel devrait typiquement avoir lieu de manière centralisée dans le cadre de la séquence d’initialisation du logiciel de base, avant que les demandes de communication suivantes ne puissent être traitées. Question Q-6e391bdf8abb1a09 (ouverte)

Interaction

Pour LinTp_Init, aucun lien direct avec d’autres exigences de spécification ou fonctions voisines n’est mentionné dans le présent extrait ([SWS_LinIf_00350]). Le module LinIf met à disposition la déclaration ([SWS_LinIf_00350]).

La fonction synchrone LinTp_Transmit sert à demander une transmission de PDU via le protocole de transport LIN ([SWS_LinIf_00351]). Comme paramètres d'entrée, elle attend l'identifiant de PDU TxPduId ainsi que le pointeur PduInfoPtr, qui fournit la longueur des données ainsi que des pointeurs vers les données de la PDU et les métadonnées ([SWS_LinIf_00351]). La valeur de retour est E_OK en cas d'acceptation réussie de la demande d'émission et E_NOT_OK en cas de rejet ([SWS_LinIf_00351]).

Le comportement à l'exécution et l'interaction avec l'interface LIN sont soumis aux prescriptions suivantes :

• Demande d'ordonnancement : si le changement d'ordonnancement initié au niveau de LinIf_ScheduleRequest dans le cadre de l'appel via BswM_LinTp_RequestMode échoue et retourne E_NOT_OK, LinTp_Transmit doit également répondre directement par E_NOT_OK ([SWS_LinIf_00878]).
• Confirmation : uniquement si LinTp_Transmit a réussi (valeur de retour E_OK), l'interface LIN appelle la fonction PduR_LinTpTxConfirmation avec un résultat positif ou négatif après un changement de table d'ordonnancement réussi ou échoué ([SWS_LinIf_00702]). En cas de demande d'émission rejetée, cet appel n'a pas lieu du tout ([SWS_LinIf_00702]).
• Interruption des opérations en cours : si, pendant l'attente d'une réponse physique ou pendant la réception d'une réponse, une nouvelle requête physique est déclenchée via LinTp_Transmit, l'interface LIN interrompt le traitement TP en cours, y compris la réception ainsi que la surveillance du timeout N_Cr et P2, et accepte la nouvelle requête ([SWS_LinIf_00708]).

Concernant la concurrence, LinTp_Transmit est réentrante pour différents TxPduId, mais ne doit pas être exécutée de manière concurrente pour le même TxPduId ([SWS_LinIf_00351]).

La fonction LinTp_Shutdown sert à l’arrêt contrôlé du protocole de transport LIN ([SWS_LinIf_00355]). Son appel met fin au fonctionnement du composant LIN-TP ([SWS_LinIf_00355]). La déclaration de fonction est disponible via le fichier d’en-tête LinIf.h ([SWS_LinIf_00355]).

Les caractéristiques de spécification suivantes s’appliquent à l’utilisation et à l’exécution ([SWS_LinIf_00355]) :

• Paramètres et valeur de retour : la fonction ne possède aucun paramètre d’entrée, d’entrée/sortie ou de sortie (void) et ne renvoie aucune valeur de retour (void) ([SWS_LinIf_00355]).
• Identification du service : le service est défini sous le Service-ID 0x43 ([SWS_LinIf_00355]).
• Synchronicité : l’appel est traité de manière synchrone ([SWS_LinIf_00355]).
• Réentrance : la fonction n’est pas réentrante (Non Reentrant) ([SWS_LinIf_00355]). Les appels concurrents ou imbriqués provenant de différents contextes ne sont pas autorisés.

Aucun code d’erreur spécifique, retour d’information au Development Error Tracer (DET) ou traitement particulier en cas d’erreur n’est décrit pour cette fonction dans les sources ([SWS_LinIf_00355]). De même, les indications relatives aux exigences associées ou à l’appelant exact font défaut ; l’appel a vraisemblablement lieu dans le cadre de la désinitialisation séquentielle de la pile de communication par une gestion des états du BSW de niveau supérieur. Question Q-e25a3c9531527c4f (ouverte)

Utilisation et sémantique

La fonction synchrone LinTp_ChangeParameter sert à ajuster à l’exécution un paramètre spécifique du protocole de transport pour un PDU donné [SWS_LinIf_00501]. Sont transmis comme paramètres l’identifiant du PDU (id), le descripteur du paramètre du protocole de transport à modifier (parameter, par exemple la taille de bloc) ainsi que la nouvelle valeur cible (value) [SWS_LinIf_00501]. La déclaration est mise à disposition via l’en-tête LinIf.h [SWS_LinIf_00501].

Valeurs de retour et comportement en cas d'erreur

La fonction signale immédiatement le résultat de la requête via sa valeur de retour du type Std_ReturnType [SWS_LinIf_00501] :

• E_OK : Le paramètre demandé a été basculé avec succès sur la nouvelle valeur [SWS_LinIf_00501].
• E_NOT_OK : La modification a été rejetée par le protocole de transport LIN [SWS_LinIf_00501]. Cela devrait typiquement se produire lorsque le paramètre est invalide ou qu’une transmission en cours empêche la modification. Question Q-84aaf28c12dee2e9 (ouverte)

Concurrence et restrictions

Conformément à la spécification, LinTp_ChangeParameter est classée comme non réentrante (Non Reentrant) [SWS_LinIf_00501]. Un appel concurrent ou imbriqué pour le même contexte ou des contextes parallèles est donc non autorisé et doit être empêché par l’appelant. Le déroulement synchrone bloque l’appelant jusqu’à la décision concernant la prise en compte de la valeur du paramètre [SWS_LinIf_00501].

Utilisation et contexte d'appel

La fonction synchrone LinIf_CheckWakeup est appelée dès que le module EcuM a été notifié d’un événement de réveil sur un canal LIN donné [SWS_LinIf_00378]. L’appel a lieu avec le paramètre d’entrée WakeupSource du type EcuM_WakeupSourceType [SWS_LinIf_00378]. Ce paramètre spécifie l’appareil source qui a initié l’événement de réveil, lequel pouvant être un contrôleur LIN ou un émetteur-récepteur LIN [SWS_LinIf_00378].

Gestion des erreurs et valeurs de retour

Comme valeur de retour, la fonction fournit un statut de type Std_ReturnType [SWS_LinIf_00378] :

• E_OK : Aucune erreur n’est survenue pendant l’exécution de l’interface [SWS_LinIf_00378].
• E_NOT_OK : Une erreur est survenue lors de l’exécution de l’interface ou une valeur invalide a été transmise pour WakeupSource [SWS_LinIf_00378].

Concurrence et intégration

L’interface est spécifiée comme réentrante, possède le Service-ID 0x60 et est mise à disposition via le fichier d’en-tête LinIf.h [SWS_LinIf_00378]. Elle relie directement le traitement de réveil de EcuM aux canaux de l’interface LIN [SWS_LinIf_00378].

La fonction synchrone et réentrante LinIf_EnableBusMirroring active ou désactive le Bus Mirroring pour un canal LIN individuel [SWS_LinIf_00876]. Elle est disponible via l’en-tête LinIf.h et peut être omise lorsque le Bus Mirroring n’est pas activé via le paramètre de configuration LinIfBusMirroringSupport [SWS_LinIf_00875]. Le module Mirror devrait typiquement faire office d’appelant. Question Q-1703af5207cb7ade (ouverte)

Le canal LIN concerné est transmis via le paramètre Channel, tandis que MirroringActive contrôle le mode [SWS_LinIf_00876] : lors de la transmission de TRUE, le mirroring est activé, et lors de FALSE, il est désactivé [SWS_LinIf_00876]. Comme valeur de retour, la fonction fournit E_OK si le mode de mirroring a été modifié avec succès, ou E_NOT_OK si un canal invalide a été indiqué ou si le mirroring est désactivé globalement [SWS_LinIf_00876]. Aucun message d’erreur DET ou DEM spécifique n’est indiqué dans la définition de la fonction [SWS_LinIf_00876].

Si le Bus Mirroring est activé globalement via LinIfBusMirroringSupported ainsi que pour le canal respectif, l’interface LIN transmet les événements pertinents à Mirror_ReportLinFrame :

• Trames reçues lors de LinIf_RxIndication avec l’état LIN_RX_OK et un pointeur vers les données utiles [SWS_LinIf_00838] ainsi que lors de la lecture de l’état du pilote LIN pour les slots Rx [SWS_LinIf_00873].
• Trames émises lors de LinIf_TxConfirmation avec l’état LIN_TX_OK et un pointeur vers les données transmises [SWS_LinIf_00839] ainsi que lors de la lecture de l’état du pilote LIN pour les slots Tx [SWS_LinIf_00874].
• Notifications d’erreurs lors de LinIf_LinErrorIndication pour tous les codes d’erreur hormis LIN_ERR_HEADER avec un état d’erreur et un pointeur NULL comme contenu de données [SWS_LinIf_00869].

La fonction LinIf_WakeupConfirmation sert à signaler la détection réussie d’un événement de réveil à l’interface LIN [SWS_LinIf_00715].

Appel et paramètres

L’appel est effectué par le pilote LIN (LIN Driver) ou le pilote de l’émetteur-récepteur LIN (LIN Transceiver Driver) après qu’une détection réussie du réveil a eu lieu pendant Check Wakeup ou après une mise sous tension via le bus (power on by bus) [SWS_LinIf_00715]. Le paramètre transmis est WakeupSource du type EcuM_WakeupSourceType, qui indique l’appareil source ayant initié l’événement de réveil (contrôleur LIN ou émetteur-récepteur LIN) [SWS_LinIf_00715].

Propriétés d’exécution et interface

• Sémantique : l’appel est traité de manière synchrone [SWS_LinIf_00715].
• Réentrance : la fonction est spécifiée comme réentrante [SWS_LinIf_00715].
• Valeur de retour : il n’y a pas de valeur de retour (void) [SWS_LinIf_00715].
• En-tête : la déclaration est mise à disposition via LinIf.h (Service-ID : 0x61) [SWS_LinIf_00715].

La fonction de rappel LinIf_HeaderIndication est appelée de manière synchrone par le pilote LIN pour signaler la réception d'un en-tête LIN sur un canal esclave [SWS_LinIf_91004]. Elle n'est disponible que si le calculateur dispose d'au moins un canal esclave LIN configuré [SWS_LinIf_91004]. La fonction est réentrante pour différents canaux, mais ne doit pas être appelée de manière concurrente pour le même canal [SWS_LinIf_91004].

Par le biais du paramètre inout PduPtr, le pilote transmet l'identificateur (PID) reçu ainsi que le pointeur vers le tampon de données SDU [SWS_LinIf_91004]. Le LinIf évalue le PID et contrôle la réaction du nœud esclave :

• Trame de réception : si le PID appartient à une trame de réception configurée, le LinIf définit avant le retour le type de checksum PduPtr->Cs, la longueur des données PduPtr->Dl et affecte la valeur LIN_FRAMERESPONSE_RX à PduPtr->Drc [SWS_LinIf_00733].
• Trames d'émission : S'il s'agit d'une trame d'émission, le LinIf demande les données utiles via <User_TriggerTransmit> [SWS_LinIf_00738]. En cas de mise à disposition réussie (valeur de retour E_OK ou données SRF fournies par le gestionnaire de configuration de nœud / protocole de transport), la somme de contrôle et la longueur sont configurées et PduPtr->Drc est défini sur LIN_FRAMERESPONSE_TX [SWS_LinIf_00739]. Si l'interrogation échoue avec E_NOT_OK, PduPtr->Drc est défini sur LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00740].
• Trames non pertinentes : Si la trame n'est pas pertinente pour l'esclave, le LinIf définit également PduPtr->Drc sur LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00748].

De plus, chaque appel recharge le temporisateur d'inactivité du bus en cours [SWS_LinIf_00754]. Si l'appel a lieu pour la première fois après un LinIf_Wakeup réussi, <User>_WakeupConfirmation(TRUE) est déclenché [SWS_LinIf_00761]. Lors de la réception d'un en-tête SRF, le LinIf démarre en outre le temporisateur N_As pour les trames consécutives (CF) [SWS_LinIf_00800]. En tant que valeur de retour, E_OK signale l'acceptation de la requête, tandis que E_NOT_OK indique des erreurs de développement ou de production [SWS_LinIf_91004].

La fonction de rappel LinIf_RxIndication est appelée de manière synchrone par le pilote LIN pour notifier à l'interface LIN la réception réussie d'une réponse, y compris les données reçues [SWS_LinIf_91005]. La fonction est disponible exclusivement sur les calculateurs disposant d'au moins un canal esclave LIN configuré [SWS_LinIf_91005].

En ce qui concerne le paramétrage et la concurrence, les conditions suivantes s'appliquent :

• Paramètres : Sont transmis l'identification de canal Channel ainsi que le pointeur Lin_SduPtr vers un tampon miroir (shadow buffer) ou le tampon de réception mappé en mémoire du matériel LIN [SWS_LinIf_91005]. Ce pointeur n'est valide que si une réponse a effectivement été reçue [SWS_LinIf_91005].
• Valeur de retour : La fonction ne possède pas de valeur de retour (void) [SWS_LinIf_91005].
• Réentrance : L'interface est réentrante pour différents canaux LIN, mais n'est pas réentrante pour le même canal [SWS_LinIf_91005].

En interaction avec le comportement du module, l'appel déclenche plusieurs actions de coordination :

• Transmission des données utiles reçues et de la longueur des données utiles à la couche supérieure via <User_RxIndication> [SWS_LinIf_00734].
• Contrôle de commandes d'endormissement : s'il s'agit d'une Master Request Frame (MRF) avec le NAD 0, l'interface LIN reconnaît une commande Go-to-Sleep et initie la transition vers le mode veille [SWS_LinIf_00750].
• Gestion des temporisateurs : à chaque appel, le temporisateur d'inactivité du bus est rechargé [SWS_LinIf_00754]. De plus, lors de trames MRF (FF, CF), l'appel pilote le temporisateur N_Cr (démarrage/redémarrage pour FF et CF avant la dernière trame, arrêt à la dernière CF) [SWS_LinIf_00805].
• Mise en miroir du bus : si le mirroring est activé globalement et pour le canal, l'interface LIN retransmet la trame avec le statut LIN_RX_OK via Mirror_ReportLinFrame() [SWS_LinIf_00838].

La fonction de rappel synchrone LinIf_TxConfirmation (ID de service 0x7a, déclarée dans LinIf.h) est appelée par le pilote LIN afin de confirmer la transmission réussie d'une réponse (Response) sur le canal spécifié [SWS_LinIf_91006]. La fonction n'a pas de valeur de retour et est exclusivement prévue pour les calculateurs comportant au moins un canal esclave LIN configuré [SWS_LinIf_91006].

À l'arrivée de la confirmation, l'interface LIN exécute plusieurs traitements consécutifs :

• Notification de la couche supérieure : Le module transmet l'événement d'émission à la couche supérieure via la fonction de rappel <User_TxConfirmation> avec la valeur de retour E_OK [SWS_LinIf_00741].
• Statut d'erreur : Si la trame envoyée avec succès contient le signal d'erreur response_error, l'interface LIN réinitialise ce signal [SWS_LinIf_00747].
• Surveillance du repos du bus : Chaque appel de LinIf_TxConfirmation recharge le temporisateur d'inactivité du bus en cours du canal [SWS_LinIf_00754].
• Protocole de transport (LinTp) : Si le pilote confirme la réponse à un en-tête SRF (Slave Response Frame), l'interface arrête le temporisateur de surveillance N_As [SWS_LinIf_00800].
• Mise en miroir du bus : Si la mise en miroir est configurée globalement via LinIfBusMirroringSupported et activée via LinIf_EnableBusMirroring(), l'interface signale la trame avec le statut LIN_TX_OK et un pointeur vers les données d'émission à Mirror_ReportLinFrame() [SWS_LinIf_00839].

Concernant la concurrence, LinIf_TxConfirmation est conçue pour être réentrante pour différents canaux LIN, mais ne doit pas être appelée de manière réentrante pour le même canal [SWS_LinIf_91006].

Utilisation et contexte d'appel

La fonction synchrone LinIf_LinErrorIndication est appelée par le pilote LIN pour signaler les erreurs survenues pendant le traitement de l'en-tête ou de la réponse [SWS_LinIf_91007]. Elle est exclusivement prévue pour les nœuds esclaves LIN et requiert que le calculateur dispose d'au moins un canal esclave LIN configuré [SWS_LinIf_91007]. Les paramètres transmis sont l'identification de canal Channel ainsi que le statut d'erreur survenu ErrorStatus de type Lin_SlaveErrorType [SWS_LinIf_91007].

Gestion des erreurs et concurrence

La fonction est réentrante pour différents canaux, mais ne doit pas être appelée de manière concurrente pour le même canal [SWS_LinIf_91007]. Lors de l'appel, l'interface LIN considère la réponse ou la trame transmise comme perdue et signale l'erreur d'exécution LINIF_E_RESPONSE au Default Error Tracer (DET), à moins que le statut d'erreur signalé ne soit LIN_ERR_HEADER [SWS_LinIf_00735], [SWS_LinIf_00743].

Interaction et surveillance du bus

Quel que soit le code d'erreur transmis, l'interface LIN recharge le temporisateur d'inactivité du bus en cours à chaque appel de LinIf_LinErrorIndication [SWS_LinIf_00754]. Si une erreur survient lors d'une réponse SRF après la réception d'un en-tête SRF, l'interface LIN interrompt la transmission et le signale à la couche supérieure via PduR_LinTpTxConfirmation avec le résultat E_NOT_OK [SWS_LinIf_00796].

Si le bus mirroring est actif globalement via LinIfBusMirroringSupported et activé pour le canal, l'interface LIN transmet les erreurs différentes de LIN_ERR_HEADER via Mirror_ReportLinFrame() avec un pointeur NULL pour le contenu des données [SWS_LinIf_00869]. À cette occasion, les codes d'erreur du pilote sont préalablement convertis en valeurs d'état correspondantes de type Lin_StatusType [SWS_LinIf_00870].

L’interface configurable <User_TriggerTransmit> sert à la récupération synchrone de données de SDU auprès d’un module supérieur pour une transmission en attente [SWS_LinIf_00528].

Le paramètre TxPduId permet d’identifier la SDU demandée, tandis que PduInfoPtr est transmis sous la forme d’un pointeur vers une structure contenant le tampon de destination (SduDataPtr) et la taille de tampon disponible (SduLength) [SWS_LinIf_00528]. Le module supérieur appelé vérifie au sein de cette API si les données en attente tiennent dans la taille de tampon signalée [SWS_LinIf_00528]. Si l’espace disponible est suffisant, le module copie ses données vers SduDataPtr, met à jour SduLength avec le nombre d’octets effectivement copiés et signale le succès avec la valeur de retour E_OK [SWS_LinIf_00528].

En revanche, si la taille du tampon n’est pas suffisante, aucune donnée de SDU n’est copiée et le module renvoie E_NOT_OK sans modifier PduInfoPtr [SWS_LinIf_00528]. En présence d’une valeur de retour de E_NOT_OK, l’appelant ne doit en aucun cas utiliser PduInfoPtr, car celui-ci peut pointer vers des données invalides ou être un pointeur NULL [SWS_LinIf_00528].

En ce qui concerne la concurrence, la fonction est réentrante pour des PDU-ID différents, mais non réentrante pour le même PDU-ID [SWS_LinIf_00528].

La fonction de rappel configurable <User_TxConfirmation> est appelée par le module d’interface de communication sous-jacent afin de confirmer à une couche supérieure la transmission d’un PDU ou l’échec de la transmission [SWS_LinIf_00529]. L’appel a lieu de manière synchrone et ne renvoie aucune valeur de retour [SWS_LinIf_00529].

Paramètres et sémantique

• TxPduId (In) : désigne l’identifiant du PDU transmis, du type PduIdType [SWS_LinIf_00529].
• result (In) : signale l’état de succès de la transmission sous la forme Std_ReturnType avec les valeurs E_OK en cas de transmission réussie du PDU ou E_NOT_OK en cas de transmission ayant échoué [SWS_LinIf_00529].

Concurrence et traitement des erreurs

En matière de réentrance, la fonction est conçue pour être réentrante pour des PDU-ID différents, mais ne doit pas être appelée de manière réentrante pour le même PDU-ID [SWS_LinIf_00529]. Le module ne spécifie aucun code d’erreur distinct ni message DET ou DEM pour cette interface ; l’échec d’une transmission est au contraire indiqué via la valeur du paramètre E_NOT_OK [SWS_LinIf_00529]. L’identifiant de fonction effectif devrait être déterminé de manière spécifique à l’intégration selon la couche utilisateur configurée, le service étant indiqué comme configurable [SWS_LinIf_00529]. Question Q-35de931161f26cb8 (ouverte)

La fonction de rappel <User_RxIndication> sert à signaler la réception d’un PDU d’un module d’interface de communication sous-jacent vers la couche supérieure [SWS_LinIf_00530]. L’appel a lieu avec une sémantique synchrone et ne possède aucune valeur de retour [SWS_LinIf_00530].

Paramètres et spécification de l'interface

La fonction transmet deux paramètres d’entrée à la couche supérieure [SWS_LinIf_00530] :

• RxPduId : identifiant du PDU reçu du type PduIdType [SWS_LinIf_00530].
• PduInfoPtr : pointeur vers une structure du type PduInfoType qui fournit la longueur des données utiles (SduLength), un pointeur vers le tampon contenant les données utiles (SduDataPtr) ainsi que les métadonnées associées au PDU [SWS_LinIf_00530].

Ni paramètre d’entrée/sortie ni paramètre de sortie pure ne sont prévus pour cette interface [SWS_LinIf_00530].

Concurrence et configuration

En ce qui concerne la réentrance, la fonction est conçue pour être réentrante pour des PDU-ID différents, mais explicitement spécifiée comme non réentrante pour des PDU-ID identiques [SWS_LinIf_00530]. Les appelants doivent donc s’assurer qu’aucun appel chevauchant n’ait lieu pour le même RxPduId. La fonction est déclarée comme interface configurable [SWS_LinIf_00530] ; le nom de fonction concret de la couche supérieure devrait donc être fixé via la configuration du module. Question Q-94175e8cd86775b6 (ouverte)

L'interface <User_ResponseErrorSignalChanged> sert de fonction de notification dans le module LinIf afin de signaler un changement de valeur du signal Response-Error avec la nouvelle valeur de signal [SWS_LinIf_00856]. L'appel s'effectue de manière synchrone et possède l'identifiant de service 0x74 [SWS_LinIf_00856]. Aucun paramètre d'entrée/sortie ni valeur de retour n'est prévu ; la signature est définie avec le type de retour void [SWS_LinIf_00856].

Comme paramètres transmis, la fonction attend deux valeurs exclusivement d'entrée [SWS_LinIf_00856] :

• Channel (type NetworkHandleType) : identification unique du canal LIN concerné [SWS_LinIf_00856].
• RespErrSigValue (type boolean) : valeur actuelle du signal Response-Error. Le paramètre vaut true si le signal est défini à 1, sinon false [SWS_LinIf_00856].

Concernant la concurrence et le contexte d'appel, il est stipulé que la fonction est réentrante pour différents canaux, mais ne doit pas être appelée de manière non réentrante pour un même canal [SWS_LinIf_00856]. Une condition cadre fonctionnelle réside dans le fait que ce service de notification est exclusivement applicable aux nœuds esclaves LIN [SWS_LinIf_00856]. La déclaration est mise à disposition via le fichier d'en-tête LinIf_Externals.h [SWS_LinIf_00856].

La fonction de rappel <User_SaveConfigurationRequest> (Service-ID 0x75) notifie une couche supérieure de la réception d’une requête « Save Configuration » et est déclarée dans LinIf_Externals.h [SWS_LinIf_00857]. Cette interface s’applique exclusivement aux nœuds esclaves LIN [SWS_LinIf_00857].

L’appel a lieu de manière synchrone et est spécifié comme réentrant [SWS_LinIf_00857] :

• Paramètres : le canal LIN concerné est transmis via le paramètre d’entrée Channel du type NetworkHandleType [SWS_LinIf_00857]. Aucun paramètre d’entrée ou de sortie supplémentaire n’existe [SWS_LinIf_00857].
• Valeur de retour : la fonction renvoie une valeur du type boolean [SWS_LinIf_00857]. La valeur de retour TRUE signale qu’une réponse positive doit être envoyée sur le bus LIN, tandis que FALSE empêche la transmission de toute réponse [SWS_LinIf_00857].

Concernant le traitement des erreurs, la spécification ne définit ni codes d’erreur spécifiques ni messages DET ou DEM [SWS_LinIf_00857]. Le comportement en cas d’erreur ou de refus est directement contrôlé par la valeur de retour booléenne, l’envoi d’une réponse étant empêché par FALSE [SWS_LinIf_00857]. L’appel étant classé comme réentrant, la fonction devrait être conçue pour un appel concurrent sur différents canaux [SWS_LinIf_00857]. Question Q-84432030c1aff644 (ouverte)

Le type énuméré LinTp_Mode est défini dans le fichier d'en-tête LinIf.h et détermine quel mode de table d'ordonnancement peut être demandé par le protocole de transport LIN (LIN TP) pendant une session de diagnostic [SWS_LinIf_00629].

La plage de valeurs comprend trois littéraux d'énumération pour la commande du changement d'ordonnancement sur le bus LIN [SWS_LinIf_00629] :

• LINTP_APPLICATIVE_SCHEDULE : sélectionne la table d'ordonnancement applicative pour le trafic régulier de messages [SWS_LinIf_00629].
• LINTP_DIAG_REQUEST : sélectionne la table d'ordonnancement de requête maître pour la transmission de requêtes de diagnostic [SWS_LinIf_00629].
• LINTP_DIAG_RESPONSE : sélectionne la table d'ordonnancement de réponse esclave pour la réception de réponses de diagnostic [SWS_LinIf_00629].

Concernant l'interaction, le type sert à la commutation entre les transmissions de diagnostic et la communication d'application régulière au sein de l'interface LIN [SWS_LinIf_00629]. Des contextes d'appel spécifiques, des propriétés de réentrance ou des traitements d'erreur (tels que des messages DET ou DEM) ne sont pas indiqués dans les sources pour ce type de données pur ; le type est probablement transmis comme paramètre de fonction lors d'appels de commande par le protocole de transport LIN à l'interface LIN. Question Q-1bf7553401882471 (ouverte)