Ethernet Interface (EthIf)

Utilisation et sémantique

La fonction EthIf_Init initialise le module d'interface Ethernet ([SWS_EthIf_00024]). Elle est exécutée de façon synchrone, n'est pas réentrante (Non Reentrant) et est disponible via le fichier d'en-tête EthIf.h avec l'ID de service 0x01. La fonction n'attend comme unique paramètre de transmission que le pointeur CfgPtr, qui renvoie vers une structure de configuration spécifique à l'implémentation de type EthIf_ConfigType. Il n'existe aucun paramètre Inout ou Out, et la fonction n'a pas de valeur de retour ([SWS_EthIf_00024]).

Concurrence et contexte d'appel

Comme EthIf_Init n'est pas réentrante, aucun appel concurrent ou imbriqué ne doit avoir lieu [SWS_EthIf_00024]. Comme le contexte d'appel spécifique n'est pas décrit plus en détail dans la charge utile, l'appel devrait typiquement avoir lieu une seule fois au cours de la séquence d'initialisation du calculateur avant l'utilisation d'autres services Ethernet. Question Q-07e92f9f3c15ea5b (ouverte)

Conditions d'ordonnancement et interaction

L'appel de EthIf_Init constitue la condition préalable indispensable à l'utilisation de toutes les autres fonctions du module. Dans la mesure où la détection des erreurs de développement (Development Error Detection) est activée, de nombreux services de l'interface Ethernet vérifient avant leur exécution si EthIf_Init a été appelée préalablement :

• Si l'initialisation n'a pas été effectuée, les fonctions dépendantes signalent l'erreur de développement ETHIF_E_UNINIT (par exemple [SWS_EthIf_00155], [SWS_EthIf_00161], [SWS_EthIf_00167], [SWS_EthIf_00173], [SWS_EthIf_00193], [SWS_EthIf_00199], [SWS_EthIf_00217], [SWS_EthIf_00222], [SWS_EthIf_00299], [SWS_EthIf_00302] et [SWS_EthIf_00304]).
• En l'absence d'initialisation, plusieurs interfaces interrompent l'exécution et renvoient en outre la valeur d'erreur E_NOT_OK (notamment [SWS_EthIf_00246], [SWS_EthIf_00273] ainsi que [SWS_EthIf_00277]).

Utilisation

La fonction EthIf_SetControllerMode active ou désactive le contrôleur Ethernet spécifié via CtrlIdx dans le contexte de l'interface Ethernet [SWS_EthIf_00034]. Les états suivants sont demandés via le paramètre CtrlMode [SWS_EthIf_00034] :

• ETH_MODE_DOWN : désactive le contrôleur.
• ETH_MODE_ACTIVE : active le contrôleur.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST : active le contrôleur et demande un réveil sur le réseau.

La fonction opère de manière asynchrone [SWS_EthIf_00034]. Elle retourne E_OK en cas d'exécution réussie ou E_NOT_OK si le mode du contrôleur n'a pas pu être modifié [SWS_EthIf_00034].

Interaction et retransmission

Si EthIf_SetControllerMode est appelée avec ETH_MODE_ACTIVE pour un contrôleur qui référence un EthIfSwitchPortGroup de type « control », EthIf transmet l'appel à tous les ports du groupe, pour autant que ce mode soit demandé pour la première fois pour le port et que son statut soit ETH_MODE_DOWN. Ce faisant, EthSwt_SetSwitchPortMode avec ETH_MODE_ACTIVE et EthSwt_PortLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE sont exécutées successivement [SWS_EthIf_00264].

Lors de la demande de ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, EthIf transmet les appels comme suit, indépendamment du mode actuel :

• En cas de référence à un EthIfTransceiver : appel de EthTrcv_SetTransceiverMode avec ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, puis de EthTrcv_TransceiverLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE, si le statut actuel est ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00479].
• En cas de référence à un EthIfSwitch ou à un EthIfSwitchPortGroup de type « control » : appel de EthSwt_SetSwitchPortMode avec ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, puis de EthSwt_PortLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE, si l'état actuel est ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00480], [SWS_EthIf_00481].

restrictions

La fonction n'est pas réentrante (Non Reentrant) et est disponible via EthIf.h [SWS_EthIf_00034].

La fonction synchrone et non réentrante EthIf_SetTransceiverWakeupMode (Service-ID 0x2e) sert à définir le mode de réveil d'un transceiver adressé via TrcvIdx dans l'interface Ethernet ou à réinitialiser sa cause de réveil [SWS_EthIf_00233]. La fonction est déclarée dans le fichier d'en-tête EthIf.h et est marquée comme obsolète (obsolete) dans la version AUTOSAR CP R20-11 [SWS_EthIf_00233].

Le pilotage s'effectue via le paramètre d'entrée TrcvWakeupMode [SWS_EthIf_00233] :

• ETHTRCV_WUM_ENABLE : active le réveil du transceiver [SWS_EthIf_00233]. Si le pilote associé EthIfTransceiverIdx se trouve actuellement à l'état ETHTRCV_WUM_DISABLE, l'appel est transmis à EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE : désactive le réveil du transceiver [SWS_EthIf_00233]. Dans la mesure où l'état actuel du pilote est ETHTRCV_WUM_ENABLE, la fonction transmet l'appel à EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR : efface la cause de réveil du transceiver indexé [SWS_EthIf_00233].

Comme valeur de retour, l'appel fournit E_OK en cas d'exécution réussie ou E_NOT_OK si le mode de réveil n'a pas pu être modifié ou la cause de réveil n'a pas pu être effacée [SWS_EthIf_00233]. L'interface étant définie comme non réentrante, les appels concurrents sont interdits [SWS_EthIf_00233].

La fonction EthIf_CheckWakeup invite le matériel Ethernet concerné à vérifier un réveil signalé [SWS_EthIf_00244]. Cela est par exemple utilisé pour du matériel Ethernet conforme à la spécification OPEN Alliance TC10 [SWS_EthIf_00244]. L'appel est effectué de manière asynchrone et réentrante par le code d'intégration, au choix dans le contexte d'une interruption ou au niveau de la tâche [SWS_EthIf_00244].

Le paramètre d'entrée utilisé est WakeupSource de type EcuM_WakeupSourceType, qui désigne l'équipement source déclencheur (émetteur-récepteur Ethernet ou commutateur Ethernet) [SWS_EthIf_00244]. La valeur de retour est E_OK si la demande de vérification a été acceptée par le matériel, sinon E_NOT_OK en cas de rejet de la demande [SWS_EthIf_00244]. Le module transmet l'appel en interne aux pilotes sous-jacents :

• Pour tous les émetteurs-récepteurs Ethernet concernés (référencés via EthIfTransceiver ou EthIfSwitchPortGroups), EthTrcv_CheckWakeup du pilote d'émetteur-récepteur respectif est appelée [SWS_EthIf_00245].
• Pour tous les commutateurs Ethernet concernés (référencés via EthIfSwitch), EthSwt_SwitchCheckWakeup du pilote de commutateur correspondant est appelée [SWS_EthIf_00500].

La disponibilité de EthIf_CheckWakeup peut être activée et désactivée au moment de la précompilation via le paramètre de configuration EthIfWakeUpSupport [SWS_EthIf_00248]. L'API est fournie via l'en-tête EthIf.h [SWS_EthIf_00244].

La fonction synchrone EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) sert à mettre à jour le filtre d'adresses pour le contrôleur Ethernet spécifié via CtrlIdx. Via le paramètre Action (de type Eth_FilterActionType), une adresse physique est ajoutée au filtre ou en est supprimée.

Pour la configuration, PhysAddrPtr attend un pointeur vers l'adresse MAC physique dans l'ordre des octets du réseau, qui représente l'adresse de destination multicast du paquet Ethernet de couche 2 [SWS_EthIf_00139]. Bien que la description textuelle de la fonction mentionne une adresse source, il devrait s'agir d'une inadvertance rédactionnelle, car la spécification des paramètres définit obligatoirement l'adresse de destination multicast. Question Q-312e20e5eadda94a (ouverte)

En ce qui concerne le déroulement et les restrictions, les directives suivantes s'appliquent [SWS_EthIf_00139] :

• Valeurs de retour : La fonction renvoie E_OK si la configuration du filtre a été modifiée avec succès, ou E_NOT_OK si la modification a échoué. Aucun code d'erreur DET ou DEM spécifique n'est défini dans les sources.
• Prise en charge matérielle : Si le contrôleur Ethernet sous-jacent n'est pas en mesure d'effectuer le filtrage au niveau matériel, le logiciel doit prendre en charge cette tâche de filtrage.
• Concurrence : L'appel n'est pas réentrant pour le même index de contrôleur (CtrlIdx), mais peut être exécuté de manière concurrente pour des contrôleurs différents.

Utilisation et contexte d'appel

La fonction EthIf_StoreConfiguration sert à demander l'enregistrement persistant des tables MAC/port apprises d'un commutateur Ethernet [SWS_EthIf_00214]. Un Complex Device Driver (CDD) est par exemple cité comme appelant typique [SWS_EthIf_00214]. L'interface est accessible via le fichier d'en-tête EthIf.h et possède le Service-ID 0x2c [SWS_EthIf_00214].

L'index du commutateur cible dans le contexte du pilote de commutateur Ethernet est transmis via le paramètre d'entrée SwitchIdx [SWS_EthIf_00214]. Comme valeur de retour, la fonction renvoie le statut Std_ReturnType : la valeur E_OK indique que la demande d'enregistrement a été acceptée, tandis que E_NOT_OK signale la non-acceptation [SWS_EthIf_00214]. Étant donné que la spécification caractérise l'exécution comme synchrone/asynchrone, la prise en charge de la demande devrait s'effectuer de manière synchrone, tandis que la persistance effective est probablement traitée de manière asynchrone dans les modules en aval. Question Q-4f10e936c7d30258 (ouverte)

Restrictions et traitement des erreurs

Concernant la concurrence, EthIf_StoreConfiguration est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_00214]. Les appels parallèles doivent donc être évités ou synchronisés du côté de l'appelant. Aucun message d'erreur DET ou DEM spécifique n'est défini pour cette interface ; une erreur lors de l'acceptation de la commande est signalée exclusivement via la valeur de retour E_NOT_OK [SWS_EthIf_00214].

Utilisation et contexte d'appel

La fonction EthIf_ResetConfiguration sert à demander la réinitialisation persistante des tables MAC et de ports apprises dynamiquement d'un commutateur Ethernet [SWS_EthIf_00219]. Les entrées configurées statiquement restent inchangées dans la configuration [SWS_EthIf_00219]. Un Complex Device Driver (CDD) peut par exemple faire office d'appelant pour cette interface [SWS_EthIf_00219].

L'index du commutateur concerné dans le contexte du pilote de commutateur Ethernet est spécifié via le paramètre de transmission SwitchIdx [SWS_EthIf_00219]. En ce qui concerne la sémantique d'exécution, l'opération est désignée comme synchrone/asynchrone [SWS_EthIf_00219] ; cela devrait signifier que la prise en compte de la demande fait l'objet d'un accusé de réception synchrone, tandis que la réinitialisation des tables matérielles s'effectue de manière asynchrone. Question Q-9e7f89ec9e809fd0 (ouverte)

Valeurs de retour et gestion des erreurs

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

• E_OK : la demande de réinitialisation persistante de la table MAC/port a été acceptée avec succès [SWS_EthIf_00219].
• E_NOT_OK : la demande a été rejetée [SWS_EthIf_00219].

Aucun message d'erreur DET ou DEM spécifique n'est documenté pour cette fonction dans le périmètre de la présente spécification.

Concurrence et restrictions

L'interface est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_00219]. Les appelants doivent donc s'assurer qu'aucun appel simultané ou interruptif n'ait lieu. La fonction est intégrée via le fichier d'en-tête EthIf.h [SWS_EthIf_00219].

La fonction synchrone EthIf_EnableEgressTimeStamp sert à activer l'acquisition d'horodatages d'émission (Egress Time Stamping) pour un objet de message dédié ou un tampon d'émission [SWS_EthIf_00160]. L'interface est fournie via le fichier d'en-tête EthIf.h [SWS_EthIf_00160].

Paramètres et appel

Lors de l'appel, la fonction attend la transmission de deux paramètres d'entrée [SWS_EthIf_00160] :

• CtrlIdx : index du contrôleur Ethernet adressé [SWS_EthIf_00160].
• BufIdx : index du tampon de message sur lequel l'application attend l'acquisition de l'horodatage d'émission [SWS_EthIf_00160].

La fonction ne possède pas de valeur de retour (void) ni de paramètre d'entrée ou de sortie [SWS_EthIf_00160].

Comportement matériel et concurrence

Le comportement du matériel diffère selon le contrôleur : certains types de matériels enregistrent le marquage pour l'horodatage d'émission de manière permanente après une configuration unique, tandis que d'autres contrôleurs le requièrent obligatoirement avant chaque transmission individuelle [SWS_EthIf_00160]. Interprétation : sur les contrôleurs sans enregistrement permanent, la fonction devrait par conséquent devoir être appelée à nouveau par l'application avant chaque opération d'émission. Question Q-e87b424598f8a684 (ouverte) Il n'existe pas de possibilité de désactivation selon la spécification, car le type de message correspondant est horodaté en permanence d'après la conception réseau [SWS_EthIf_00160].

En ce qui concerne la concurrence, la fonction est définie comme non réentrante (Non Reentrant) [SWS_EthIf_00160].

La fonction asynchrone EthIf_SwitchPortGroupRequestMode demande un mode de fonctionnement pour un groupe de ports de commutateur ([SWS_EthIf_91102]). L'appel est spécifié comme non réentrant et transmet l'index du groupe de ports (PortGroupIdx) ainsi que le mode cible souhaité (PortMode). Les modes disponibles sont ETH_MODE_DOWN pour la désactivation, ETH_MODE_ACTIVE pour l'activation ainsi que ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST pour l'activation avec réveil réseau ([SWS_EthIf_91102]). En cas d'initiation réussie, la fonction renvoie E_OK, sinon E_NOT_OK ([SWS_EthIf_91102]).

En principe, EthIf transmet la demande au commutateur sous-jacent en appelant EthSwt_SetSwitchPortMode pour tous les ports référencés ([SWS_EthIf_91102]). Des règles de comportement spécifiques s'appliquent alors aux différents modes :

• Désactivation (ETH_MODE_DOWN) : si les ports se trouvent actuellement dans l'état ETH_MODE_ACTIVE et que ETH_MODE_DOWN a été demandé pour tous les groupes référençant les ports, EthIf démarre un temporisateur avec le temps de retard EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Activation (ETH_MODE_ACTIVE ou ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST) : un temporisateur de retard à l'arrêt en cours d'exécution pour les ports du groupe de ports respectif est immédiatement interrompu ([SWS_EthIf_00483]).
• Demande de réveil (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST) : l'appel est obligatoirement transmis dans un ordre fixe pour tous les ports du groupe, indépendamment du mode actuel du port : d'abord, EthSwt_SetSwitchPortMode est appelée avec ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, suivi de EthSwt_PortLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE, pour autant que l'état de lien actuel soit ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00482]).

Aucun message d'erreur DET ou DEM spécifique n'est mentionné pour ce service ; l'échec d'un changement de mode est directement indiqué par la valeur de retour E_NOT_OK ([SWS_EthIf_91102]).

La fonction EthIf_StartAllPorts sert à demander le passage de tous les ports de commutateur Ethernet configurés et concernés dans l'état ETH_MODE_ACTIVE ([SWS_EthIf_91103]). L'appel s'effectue sans paramètre, possède une sémantique asynchrone et est spécifié comme réentrant ([SWS_EthIf_91103]). Comme valeur de retour, E_OK signale l'acceptation de la demande, tandis que E_NOT_OK indique un rejet ([SWS_EthIf_91103]).

Après l'appel de EthIf_StartAllPorts, EthIf transmet les commandes de contrôle à tous les ports concernés des commutateurs Ethernet (EthSwtPorts) selon un ordre strictement défini ([SWS_EthIf_00275]) :

• Tout d'abord, EthSwt_SetSwitchPortMode est appelée avec ETH_MODE_ACTIVE, pour autant que le mode actuel soit ETH_MODE_DOWN ([SWS_EthIf_00275]).
• Ensuite, l'appel de EthSwt_PortLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE a lieu si l'état de lien actuel est ETHTRCV_LINK_STATE_DOWN, et un temporisateur avec la durée EthIfPortStartupActiveTime est démarré pour tous ces ports ([SWS_EthIf_00275]).

Si un port ainsi activé n'est pas régulièrement demandé avec ETH_MODE_ACTIVE dans le laps de temps EthIfPortStartupActiveTime, EthIf désactive automatiquement ce port à nouveau ([SWS_EthIf_00276]). La désactivation s'effectue obligatoirement dans l'ordre inverse :

• D'abord, EthSwt_PortLinkStateRequest est appelée avec ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00276]).
• Ensuite, EthSwt_SetSwitchPortMode est appelée avec ETH_MODE_DOWN ([SWS_EthIf_00276]).

La fonction EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) active la saisie d'horodatages d'égress pour un objet de message spécifique au niveau du switch. L'objet de transmission associé est adressé via l'index de contrôleur CtrlIdx ainsi que l'index de tampon BufIdx.

Appel et paramètres

L'appel est synchrone ([SWS_EthIf_91007]). Comme paramètres d'entrée, la fonction attend l'index de contrôleur CtrlIdx au sein du contexte EthIf ainsi que BufIdx pour le tampon de messages au niveau duquel l'application attend l'horodatage. Les informations de gestion associées sont fournies via le paramètre de sortie MgmtInfo de type EthSwt_MgmtInfoType* ([SWS_EthIf_91007]).

Valeurs de retour et comportement

La fonction signale le résultat via une valeur de retour de type Std_ReturnType ([SWS_EthIf_91007]) :

• E_OK : l'horodatage d'égress a été activé avec succès ([SWS_EthIf_91007]).
• E_NOT_OK : l'activation de l'horodatage a échoué ([SWS_EthIf_91007]).

Restrictions et concurrence

L'interface est spécifiée comme non réentrante (Non Reentrant) ([SWS_EthIf_91007]). Les appelants doivent donc s'assurer que les appels parallèles sont empêchés. La déclaration est mise à disposition via l'en-tête EthIf.h ([SWS_EthIf_91007]).

La fonction d'interface synchrone EthIf_VerifyConfig sert à vérifier la configuration du commutateur et transmet directement l'appel à EthSwt_VerifyConfig [SWS_EthIf_91012]. La vérification effective est effectuée par le pilote de commutateur Ethernet en fonction de l'architecture matérielle respective, des capacités matérielles et de la précision de test visée [SWS_EthIf_91012].

Utilisation et paramètres

La fonction est disponible via l'en-tête EthIf.h avec le Service-ID 0x40 et attend deux paramètres [SWS_EthIf_91012] :

• SwitchIdx (in) : index du commutateur dans le contexte du pilote de commutateur Ethernet.
• Result (out) : pointeur vers une valeur booléenne qui recueille le résultat de la vérification. TRUE indique une configuration vérifiée avec succès, tandis que FALSE signale des corruptions détectées.

Comme valeur de retour, Std_ReturnType signale le statut de l'exécution : E_OK signale que la vérification s'est terminée avec succès, tandis que E_NOT_OK indique un échec du contrôle de la configuration [SWS_EthIf_91012].

Concurrence et traitement des erreurs

La fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91012]. Les appelants doivent donc s'assurer qu'aucun appel concurrent n'a lieu. Étant donné que la charge utile (payload) ne mentionne aucun code d'erreur spécifique pour DET ou DEM, les vérifications détaillées des paramètres (telles que la validation d'index ou de pointeurs) devraient probablement être traitées du côté pilote ou de manière spécifique à l'implémentation. Question Q-03b5f343e97bec7f (ouverte)

La fonction synchrone EthIf_SetForwardingMode est fournie via l'en-tête EthIf.h et sert à commander le transfert de trames (frame forwarding) sur un commutateur Ethernet [SWS_EthIf_91013]. Elle vérifie la configuration actuelle du commutateur et procède à une reconfiguration du commutateur en cas de non-validité détectée [SWS_EthIf_91013].

Paramètres et valeurs de retour

Lors de l'appel (Service-ID 0x41), les paramètres d'entrée suivants sont transmis [SWS_EthIf_91013] :

• SwitchIdx : index du commutateur concerné dans le contexte du pilote de commutateur Ethernet [SWS_EthIf_91013].
• mode : commutateur booléen pour l'activation (TRUE) ou la désactivation (FALSE) du transfert de trames [SWS_EthIf_91013].

Comme valeur de retour, la fonction fournit Std_ReturnType [SWS_EthIf_91013] :

• E_OK : signalait selon la spécification l'arrêt réussi du transfert ; Interprétation : cela devrait confirmer plus généralement la prise en compte réussie du mode de transfert demandé [SWS_EthIf_91013]. Question Q-f245de852fe854c0 (ouverte)
• E_NOT_OK : la commutation ou l'arrêt du transfert de trames a échoué [SWS_EthIf_91013].

Concurrence et restrictions

La fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91013]. Les appelants doivent donc veiller à ce que les appels pour un même contexte de commutateur ou des contextes parallèles soient sérialisés et qu'aucun appel concurrent ne se produise. Aucun code d'erreur spécifique pour DET ou DEM n'est défini pour ce service dans la norme.

La fonction EthIf_ClearTrcvSignalQuality sert à effacer de manière synchrone les valeurs de qualité de signal enregistrées d'une connexion Ethernet pour un transceiver donné [SWS_EthIf_91059]. L'appelant transmet pour cela, avec le paramètre TrcvIdx, l'indice du transceiver dans le contexte de l'Ethernet Interface, après quoi les valeurs de mesure correspondantes sont effacées [SWS_EthIf_00400].

Comme valeur de retour, l'interface fournit le type Std_ReturnType : si la réinitialisation de la qualité du signal a réussi, E_OK est signalé, sinon l'opération échoue avec E_NOT_OK [SWS_EthIf_91059]. Interprétation : la valeur d'erreur E_NOT_OK est probablement imputable à des paramètres d'indice invalides ou à des erreurs lors du relais vers des pilotes sous-jacents, étant donné que la charge utile ne mentionne aucun code d'erreur ou entrée DET spécifique. Question Q-40d8f0c1fc7ba11e (ouverte)

En ce qui concerne la concurrence, le service est implémenté comme réentrant pour différents indices de transceiver, mais explicitement non réentrant pour le même TrcvIdx [SWS_EthIf_91059]. Plusieurs appels pour le transceiver identique ne doivent donc pas avoir lieu simultanément depuis des contextes concurrents et doivent être sécurisés en conséquence.

Dans l'interaction entre modules, l'appel efface de manière ciblée les valeurs de qualité de signal enregistrées du type EthIf_SignalQualityResultType pour le EthIfTransceiver adressé via TrcvIdx [SWS_EthIf_00400]. La déclaration de l'interface synchrone avec l'ID de service 0x19 est mise à disposition via l'en-tête EthIf.h [SWS_EthIf_91059].

Utilisation

La fonction synchrone EthIf_ClearSwitchPortSignalQuality sert à réinitialiser les valeurs de qualité de signal enregistrées pour la connexion d'un port de commutateur Ethernet donné [SWS_EthIf_91060]. L'adressage du port cible s'effectue via les deux paramètres d'entrée SwitchIdx (indice du commutateur Ethernet) et SwitchPortIdx (indice du port dans le contexte de l'interface) [SWS_EthIf_91060]. La fonction est disponible via le fichier d'en-tête EthIf.h [SWS_EthIf_91060].

Interaction et structures de données

Conformément à [SWS_EthIf_00404], l'appel efface les valeurs de qualité de signal conservées en interne du port de commutateur adressé, qui correspondent au type EthIf_SignalQualityResultType. Cela permet aux modules de niveau supérieur de rejeter de manière ciblée les valeurs de mesure historiques et d'initier une nouvelle évaluation de la qualité de la liaison.

Gestion des erreurs

Le succès de l'opération est indiqué par la valeur de retour de type Std_ReturnType : en cas d'effacement réussi, la fonction fournit E_OK, sinon E_NOT_OK [SWS_EthIf_91060]. Les codes d'erreur DET ou DEM spécifiques ne sont pas définis dans la charge utile. Interprétation : la valeur de retour E_NOT_OK devrait survenir en particulier lorsque des indices non valides sont transmis ou que le pilote de commutateur sous-jacent ne peut pas exécuter la réinitialisation. Question Q-fc42f5b3e5414f6a (ouverte)

Concurrence et restrictions

En ce qui concerne la réentrance, EthIf_ClearSwitchPortSignalQuality est réentrante pour différents indices de commutateur et de port de commutateur [SWS_EthIf_91060]. Cependant, pour le même port de commutateur (SwitchPortIdx), la fonction est spécifiée comme non réentrante [SWS_EthIf_91060]. Les appelants doivent donc s'assurer que les appels simultanés pour le même port sont évités ou protégés par des mécanismes de synchronisation appropriés.

La fonction d'interface synchrone EthIf_SetPhyTestMode sert à activer un mode de test prédéfini sur un émetteur-récepteur Ethernet [SWS_EthIf_91016]. Le service est déclaré dans le fichier d'en-tête EthIf.h et est identifiable par le Service-ID hexadécimal 0x17 [SWS_EthIf_91016].

Pour l'appel, la fonction attend la transmission de deux paramètres d'entrée [SWS_EthIf_91016] :

• TrcvIdx : détermine l'index numérique de l'émetteur-récepteur cible dans le contexte d'Ethernet Interface [SWS_EthIf_91016].
• Mode : définit le mode de test concret à activer de type EthTrcv_PhyTestModeType [SWS_EthIf_91016].

Il n'existe aucun paramètre d'entrée/sortie [SWS_EthIf_91016]. En tant que valeur de retour, le service fournit un statut de type Std_ReturnType [SWS_EthIf_91016]. La valeur de retour E_OK confirme que la demande d'activation du mode de test a été acceptée avec succès [SWS_EthIf_91016]. La valeur E_NOT_OK indique en revanche que la demande a été rejetée et que le mode de test n'a pas pu être activé [SWS_EthIf_91016].

En matière de concurrence, EthIf_SetPhyTestMode est spécifiée comme réentrante pour des index d'émetteurs-récepteurs différents (TrcvIdx) [SWS_EthIf_91016]. Pour le même index d'émetteur-récepteur, l'exécution est explicitement non réentrante [SWS_EthIf_91016]. Les appelants doivent donc veiller à éviter les appels concurrents pour la même instance d'émetteur-récepteur et à les coordonner de manière séquentielle à la place.

Utilisation

La fonction synchrone EthIf_SetPhyLoopbackMode sert à activer un mode de bouclage spécifié sur un émetteur-récepteur Ethernet [SWS_EthIf_91018]. La déclaration est disponible via le fichier d'en-tête EthIf.h [SWS_EthIf_91018].

Lors de l'appel, la fonction attend deux paramètres d'entrée :

• TrcvIdx : index de l'émetteur-récepteur dans le contexte d'Ethernet Interface [SWS_EthIf_91018].
• Mode : le mode de bouclage à activer de type EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

Comme valeur de retour, la fonction fournit un état de type Std_ReturnType : E_OK signale que la requête a été acceptée, tandis que E_NOT_OK indique que la requête n'a pas pu être acceptée [SWS_EthIf_91018]. Interprétation : la fonction devrait relayer l'appel de manière synchrone au pilote de transceiver Ethernet responsable de TrcvIdx. Question Q-c4736bbfd250cca0 (ouverte)

Gestion des erreurs

Les codes d'erreur spécifiques tels que les messages DET ou les événements DEM ne sont pas définis dans l'extrait de spécification. Si l'acceptation de la requête échoue, cela est directement communiqué à l'appelant via la valeur de retour E_NOT_OK [SWS_EthIf_91018]. Les appelants doivent vérifier cette valeur de retour avant de poursuivre les séquences de test ou de diagnostic ultérieures.

Concurrence et restrictions

La fonction est réentrante pour différents indices de transceiver (TrcvIdx), mais explicitement non réentrante pour le même indice de transceiver [SWS_EthIf_91018]. Les appelants doivent donc s'assurer que les appels simultanés pour la même instance de transceiver sont évités ou sécurisés par des mécanismes de synchronisation appropriés [SWS_EthIf_91018].

La fonction d'interface synchrone EthIf_SetPhyTxMode sert à activer un mode de transmission spécifié pour un transceiver Ethernet [SWS_EthIf_91005]. La déclaration de la fonction s'effectue dans le fichier d'en-tête EthIf.h sous la Service-ID 0x13 [SWS_EthIf_91005].

Pour son appel, la fonction attend deux paramètres d'entrée [SWS_EthIf_91005] :

• TrcvIdx : index numérique du transceiver concerné dans le contexte de l'interface Ethernet.
• Mode : mode d'émission concret à activer de type EthTrcv_PhyTxModeType.

L'exécution est synchrone. Comme valeur de retour, la fonction fournit un état de type Std_ReturnType [SWS_EthIf_91005]. La valeur E_OK confirme l'acceptation réussie de la requête, tandis que E_NOT_OK signale que la requête n'a pas pu être acceptée [SWS_EthIf_91005]. Aucun code d'erreur spécifique ni aucune notification destinée au Development Error Management (DET) ou au Diagnostic Event Management (DEM) ne sont indiqués dans les données de spécification.

Concernant le comportement face à la concurrence, EthIf_SetPhyTxMode est réentrante pour des index de transceiver différents (TrcvIdx) [SWS_EthIf_91005]. Toutefois, si des appels sont émis pour le même index de transceiver, la fonction est définie comme non réentrante et nécessite un appel synchronisé ou séquentiel [SWS_EthIf_91005].

Comme restriction formelle, il convient de noter que cet élément d'interface est marqué avec l'état draft dans la spécification AUTOSAR CP R20-11 [SWS_EthIf_91005].

La fonction synchrone et réentrante EthIf_ProvideTxBuffer (ID de service 0x09) accorde l'accès à un tampon d'émission du contrôleur Ethernet indiqué via CtrlIdx et est disponible via l'en-tête EthIf.h [SWS_EthIf_00067].

Pour demander un tampon, l'appelant transmet l'index du contrôleur (CtrlIdx), le type de trame Ethernet (FrameType) ainsi que la priorité (Priority) pour le champ PCP de 3 bits du tag VLAN [SWS_EthIf_00067]. Via le paramètre d'entrée et de sortie LenBytePtr, l'appelant spécifie la taille de tampon souhaitée en octets et reçoit en retour la longueur réellement fournie [SWS_EthIf_00067]. En cas d'allocation réussie, la fonction met à disposition un pointeur vers le tampon via BufPtr et l'index de la ressource de tampon pour les requêtes ultérieures via BufIdxPtr [SWS_EthIf_00067].

Le résultat de la demande de tampon est signalé via le type de retour BufReq_ReturnType [SWS_EthIf_00067] :

• BUFREQ_OK : le tampon a été mis à disposition avec succès [SWS_EthIf_00067].
• BUFREQ_E_BUSY : toutes les ressources de tampon sont actuellement occupées [SWS_EthIf_00067].
• BUFREQ_E_OVFL : la longueur de tampon demandée dépasse la taille disponible [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK : une erreur de développement a été détectée [SWS_EthIf_00067].

La fonction synchrone EthIf_Transmit déclenche la transmission d'un tampon d'émission préalablement mis à disposition et rempli via l'interface Ethernet [SWS_EthIf_00075].

Utilisation et paramètres

L'appel s'effectue via l'interface déclarée dans EthIf.h avec les paramètres de transmission suivants [SWS_EthIf_00075] :

• CtrlIdx : index du contrôleur Ethernet dans le contexte du module EthIf.
• BufIdx : index de la ressource de tampon à transmettre.
• FrameType : type de trame Ethernet.
• TxConfirmation : commande l'activation de la confirmation d'émission.
• LenByte : longueur des données en octets.
• PhysAddrPtr : adresse physique de destination (adresse MAC) dans l'ordre des octets du réseau.

Valeurs de retour et concurrence

Comme valeur de retour, la fonction renvoie E_OK en cas de déclenchement réussi de la transmission ou E_NOT_OK si la transmission a échoué [SWS_EthIf_00075]. La fonction est réentrante pour les appels avec des index de tampon et de contrôleur différents (BufIdx et CtrlIdx) [SWS_EthIf_00075].

La fonction EthIf_SwitchPortGetLinkState sert, conformément à [SWS_EthIf_91109], à interroger l'état de liaison actuel d'un port de commutateur donné. Sont transmis l'indice du commutateur SwitchIdx dans le contexte du pilote de commutateur Ethernet ainsi que l'indice du port SwitchPortIdx sur le commutateur adressé. Le résultat de l'interrogation est mis à disposition via le pointeur LinkStatePtr, qui prend soit ETHTRCV_LINK_STATE_DOWN (port déconnecté), soit ETHTRCV_LINK_STATE_ACTIVE (port connecté). La spécification indique un comportement d'exécution synchrone ou asynchrone ; cela dépend probablement du pilote de commutateur sous-jacent ou du raccordement matériel. Question Q-dde6f9e8f1b8ba52 (ouverte)

Comme valeur de retour, la fonction fournit Std_ReturnType ([SWS_EthIf_91109]). En cas d'interrogation réussie, E_OK est renvoyé. Si la détermination de l'état de liaison échoue ou si la fonction est appelée alors que le commutateur se trouve à l'état ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT, le renvoi de E_NOT_OK a lieu.

En ce qui concerne la concurrence, la fonction est spécifiée comme non réentrante (Non Reentrant) ([SWS_EthIf_91109]), raison pour laquelle les appels simultanés dans le même contexte doivent être exclus. La déclaration est disponible via l'en-tête EthIf.h avec l'ID de service 0x4b.

Utilisation

La fonction synchrone EthIf_TransceiverGetLinkState sert à interroger l'état de liaison (Link State) actuel d'un transceiver Ethernet adressé via TrcvIdx conformément à [SWS_EthIf_91110]. La déclaration de l'interface est mise à disposition via l'en-tête EthIf.h [SWS_EthIf_91110].

Lors de l'appel, les paramètres suivants sont transmis [SWS_EthIf_91110] :

• TrcvIdx (entrée) : indice du transceiver dans le contexte de l'Ethernet Transceiver Driver.
• LinkStatePtr (sortie) : pointeur vers l'emplacement mémoire pour l'état déterminé de type EthTrcv_LinkStateType. Les valeurs de résultat possibles sont ETHTRCV_LINK_STATE_ACTIVE pour un transceiver connecté ainsi que ETHTRCV_LINK_STATE_DOWN pour un transceiver déconnecté.

Comme valeur de retour, la fonction fournit le code d'état de type Std_ReturnType : E_OK signale une exécution réussie, tandis que E_NOT_OK indique que le transceiver n'a pas pu être initialisé [SWS_EthIf_91110].

Gestion des erreurs et conditions limites

Si l'interrogation échoue, le service avec l'ID de service 0x4c fournit la valeur de retour E_NOT_OK [SWS_EthIf_91110]. Les messages d'erreur DET ou DEM spécifiques ne sont pas répertoriés dans la spécification de la fonction.

concurrence

La fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91110]. Interprétation : en raison de l'absence de réentrance, un appel simultané depuis plusieurs threads ou contextes de tâches ne devrait pas être autorisé et requiert, si nécessaire, une synchronisation côté appelant. Question Q-0459aa9b4c187439 (ouverte)

La fonction EthIf_SwitchPortGetBaudRate sert à interroger la vitesse de transmission actuelle d'un port de commutateur Ethernet donné conformément à [SWS_EthIf_91111]. Lors de l'appel, l'indice du commutateur (SwitchIdx) ainsi que l'indice du port sur le commutateur adressé (SwitchPortIdx) sont transmis. Le résultat de l'interrogation est mis à disposition via le pointeur BaudRatePtr de type EthTrcv_BaudRateType*, qui peut représenter des vitesses telles que ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT ou ETHTRCV_BAUD_RATE_2500MBIT [SWS_EthIf_91111].

En ce qui concerne le comportement en cas d'erreur, la fonction renvoie E_OK en cas de détermination réussie du débit en bauds. Une valeur de retour de E_NOT_OK signale que le débit en bauds pour le port de commutateur spécifié n'a pas pu être lu ou que le pilote de commutateur se trouve à l'état ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT [SWS_EthIf_91111].

La spécification indique que la fonction est non réentrante (Non Reentrant) ainsi que synchrone/asynchrone [SWS_EthIf_91111]. Le comportement synchrone ou asynchrone dépend probablement du raccordement et de l'implémentation du pilote de commutateur Ethernet sous-jacent. Question Q-1f4d760ff944df9d (ouverte) En raison de l'absence de réentrance, les appelants doivent s'assurer que les appels parallèles de l'interface sont évités.

La fonction synchrone EthIf_TransceiverGetBaudRate avec l'ID de service 0x4e sert à lire le taux de transmission actuel d'un transceiver Ethernet indexé [SWS_EthIf_91112]. Elle fait partie intégrante du module EthIf et est mise à disposition via le fichier d'en-tête EthIf.h [SWS_EthIf_91112].

Le paramètre d'entrée TrcvIdx de type uint8 identifie le transceiver dans le contexte du pilote de transceiver Ethernet [SWS_EthIf_91112]. Aucun paramètre Inout n'existe [SWS_EthIf_91112]. Le résultat de l'interrogation est renvoyé via le paramètre de sortie BaudRatePtr [SWS_EthIf_91112]. Les valeurs valides du type Eth_Trcv_BaudRateType sont ETHTRCV_BAUD_RATE_10MBIT (10 MBit/s), ETHTRCV_BAUD_RATE_100MBIT (100 MBit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 MBit/s) ainsi que ETHTRCV_BAUD_RATE_2500MBIT (2500 MBit/s) [SWS_EthIf_91112].

La fonction renvoie un état de type Std_ReturnType : en cas d'appel réussi, E_OK est transmis [SWS_EthIf_91112]. Si le transceiver n'a pas pu être initialisé, le service échoue et signale E_NOT_OK [SWS_EthIf_91112].

En ce qui concerne le contexte d'appel et la concurrence, EthIf_TransceiverGetBaudRate est définie comme une interface synchrone et non réentrante (Non Reentrant) [SWS_EthIf_91112]. Les couches appelantes doivent s'assurer que les appels concurrents pour ce service sont évités ou sérialisés au niveau de l'appelant [SWS_EthIf_91112].

La fonction EthIf_SwitchPortGetDuplexMode sert à interroger le mode duplex actuel d'un port indexé sur un commutateur Ethernet [SWS_EthIf_91113]. Elle relaie l'appel à la fonction EthSwt_GetDuplexMode du pilote de commutateur Ethernet associé via SwitchIdx [SWS_EthIf_00428].

Paramètres et interface

• SwitchIdx : indice du commutateur Ethernet dans le contexte du pilote [SWS_EthIf_91113].
• SwitchPortIdx : indice du port concerné sur le commutateur adressé [SWS_EthIf_91113].
• DuplexModePtr : pointeur de sortie de type EthTrcv_DuplexModeType* pour le mode déterminé, soit ETHTRCV_DUPLEX_MODE_HALF (semi-duplex), soit ETHTRCV_DUPLEXMODE_FULL (duplex intégral) [SWS_EthIf_91113].

Exécution et traitement des erreurs

La valeur de retour E_OK signale une interrogation réussie [SWS_EthIf_91113]. Si le mode duplex du port ne peut pas être déterminé ou si le pilote se trouve dans les états ETHSWT_STATE_UNINIT ou ETHSWT_STATE_INIT, la fonction renvoie E_NOT_OK [SWS_EthIf_91113].

L'interface est non réentrante (Non Reentrant) et déclarée dans la spécification comme synchrone/asynchrone [SWS_EthIf_91113]. Interprétation : le fonctionnement réel synchrone ou asynchrone devrait dépendre des caractéristiques du pilote de commutateur raccordé. Question Q-339413722431978f (ouverte)

La fonction synchrone EthIf_TransceiverGetDuplexMode détermine le mode duplex actuel d'un transceiver Ethernet indexé conformément à [SWS_EthIf_91114].

Utilisation et paramètres

L'appel s'effectue de manière synchrone et est spécifié comme non réentrant (Non Reentrant) [SWS_EthIf_91114] :

• TrcvIdx : transmet comme paramètre d'entrée l'indice du transceiver dans le contexte du pilote de transceiver Ethernet [SWS_EthIf_91114].
• DuplexModePtr : sert de pointeur de sortie vers le type EthTrcv_DuplexModeType pour recevoir le résultat. Les valeurs possibles sont ETHTRCV_DUPLEX_MODE_HALF (semi-duplex) ou ETHTRCV_DUPLEX_MODE_FULL (duplex intégral) [SWS_EthIf_91114].

Valeurs de retour et gestion des erreurs

Comme valeur de retour, la fonction fournit un Std_ReturnType [SWS_EthIf_91114] :

• E_OK : le mode duplex a été interrogé avec succès et mis à disposition via DuplexModePtr [SWS_EthIf_91114].
• E_NOT_OK : la détermination a échoué, selon la spécification par exemple si le transceiver n'a pas pu être initialisé [SWS_EthIf_91114].

Restrictions et concurrence

Comme l'interface est non réentrante, des appels parallèles pour la même instance ou différentes instances de transceiver ne doivent pas avoir lieu sans synchronisation externe. La déclaration est disponible via l'en-tête EthIf.h [SWS_EthIf_91114].

La fonction synchrone EthIf_SwitchPortGetCounterValues sert à lire les valeurs de compteurs (Drop Counter) d'un port de switch Ethernet donné conformément à [SWS_EthIf_91115]. Mise à disposition via l'en-tête EthIf.h, la fonction reçoit l'index de switch SwitchIdx ainsi que l'index de port SwitchPortIdx et réécrit les valeurs de compteurs via le pointeur CounterPtr ([SWS_EthIf_91115]).

Fonctionnement et transmission

Conformément à [SWS_EthIf_00432], EthIf_SwitchPortGetCounterValues transmet directement la requête à la fonction EthSwt_GetCounterValues du pilote de switch Ethernet respectif. Les valeurs de compteurs renvoyées s'inspirent des normes IETF RFC 1757, RFC 1643 et RFC 2233, la signification sémantique exacte étant attribuée à la structure Eth_CounterType ([SWS_EthIf_91115]).

Valeurs de retour et gestion des erreurs

Comme valeur de retour, la fonction renvoie Std_ReturnType ([SWS_EthIf_91115]) :

• E_OK : la lecture des valeurs de compteurs a réussi ([SWS_EthIf_91115]).
• E_NOT_OK : une erreur est survenue lors de la lecture des valeurs de compteurs ([SWS_EthIf_91115]).

Concurrence et restrictions

La fonction est spécifiée comme non réentrante (Non Reentrant) ([SWS_EthIf_91115]). Les appels concurrents doivent donc être synchronisés au niveau de l'appelant. Interprétation : l'appelant devrait en outre être responsable de la mise à disposition d'une zone mémoire valide et suffisamment dimensionnée pour CounterPtr, la spécification ne mentionnant aucune allocation interne de tampon. Question Q-140661eaa9693cce (ouverte)

Utilisation et sémantique

La fonction EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) sert à interroger les compteurs de statistiques de réception pour un port d'un switch Ethernet. Elle est disponible via l'en-tête EthIf.h et est répertoriée sous l'ID de service 0x52 ([SWS_EthIf_91116]).

L'appel requiert les paramètres suivants ([SWS_EthIf_91116]) :

• SwitchIdx : index du commutateur Ethernet dans le contexte du pilote de commutateur Ethernet.
• SwitchPortIdx : index du port sur le commutateur adressé.
• RxStatsPtr : pointeur vers une structure de type Eth_RxStatsType dans laquelle les valeurs de compteur sont écrites. La majeure partie de ces valeurs est dérivée de l'IETF RFC 2819 (Remote Network Monitoring Management Information Base).

Valeurs de retour et gestion des erreurs

La fonction fournit comme résultat un Std_ReturnType ([SWS_EthIf_91116]) :

• E_OK : les données statistiques ont été lues avec succès.
• E_NOT_OK : les valeurs de compteur n'ont pas pu être déterminées ([SWS_EthIf_91116]). Aucun message d'erreur DEM ou DET spécifique n'est spécifié pour cet appel.

Concurrence et restrictions

La fonction est classée comme non réentrante (Non Reentrant) ([SWS_EthIf_91116]). La synchronicité étant indiquée comme « Synchronous /Asynchronous », le comportement de blocage effectif devrait dépendre de l'implémentation du pilote de switch Ethernet sous-jacent ([SWS_EthIf_91116]). Question Q-d1e839075bf42e7f (ouverte) Les appelants doivent éviter les accès parallèles à la même interface.

La fonction EthIf_SwitchPortGetTxStats sert à lire les statistiques de transmission conformément à l'IETF RFC1213 pour un port déterminé d'un switch Ethernet [SWS_EthIf_91117]. Elle est disponible via le fichier d'en-tête EthIf.h avec l'ID de service 0x53 [SWS_EthIf_91117].

Utilisation et paramètres

Lors de l'appel, l'index du switch (SwitchIdx) et l'index du port sur le switch adressé (SwitchPortIdx) sont transmis en tant que paramètres d'entrée [SWS_EthIf_91117]. Les états de compteur déterminés sont mis à disposition via le pointeur TxStatsPtr de type Eth_TxStatsType* [SWS_EthIf_91117]. Si un compteur n'est pas disponible ou n'est pas pris en charge, la valeur maximale possible du compteur signale une valeur non valide [SWS_EthIf_91117].

Valeurs de retour et gestion des erreurs

La fonction renvoie un statut de type Std_ReturnType [SWS_EthIf_91117] :

• E_OK : les statistiques de transmission ont été déterminées avec succès [SWS_EthIf_91117].
• E_NOT_OK : les statistiques de transmission n'ont pas pu être obtenues [SWS_EthIf_91117].

Les codes d'erreur spécifiques ou messages destinés à DET ou DEM ne sont pas indiqués dans les sources, de sorte que les cas d'erreur doivent principalement être interceptés via la valeur de retour E_NOT_OK [SWS_EthIf_91117].

Concurrence et restrictions

Conformément à la spécification, EthIf_SwitchPortGetTxStats est définie comme asynchrone (Asynchronous) et non réentrante (Non Reentrant) [SWS_EthIf_91117]. En raison de l'absence de réentrance, les appels simultanés ne doivent pas avoir lieu sans synchronisation de niveau supérieur [SWS_EthIf_91117]. Le service étant déclaré comme asynchrone, le tampon transmis TxStatsPtr devrait devoir être maintenu valide jusqu'à l'achèvement complet de l'opération (interprétation : stabilité du tampon lors d'une interrogation asynchrone) [SWS_EthIf_91117]. Question Q-8a14618d6990206b (ouverte)

La fonction synchrone EthIf_SwitchPortGetTxErrorCounterValues mise à disposition via EthIf.h (Service-ID 0x54) lit une liste de compteurs d'erreurs de transmission pour un port d'un switch Ethernet [SWS_EthIf_91118]. Les compteurs correspondent aux définitions de l'IETF RFC1213 ainsi que de la RFC1643 et sont fournis via le type Eth_TxErrorCounterValuesType dans le paramètre de sortie TxStatsPtr [SWS_EthIf_91118].

Lors de l'appel, SwitchIdx adresse le switch dans le contexte du pilote et SwitchPortIdx le port concret sur le switch [SWS_EthIf_91118]. La fonction fournit E_OK en cas de détermination réussie des valeurs et E_NOTOK si les statistiques de transmission n'ont pas pu être obtenues [SWS_EthIf_91118]. Une valeur de compteur qui prend la valeur maximale possible caractérise alors explicitement un compteur non valide ou indisponible [SWS_EthIf_91118].

Comme restriction pour l'exécution, il est établi que la fonction est non réentrante (Non Reentrant) [SWS_EthIf_91118]. Au sein de l'ensemble architectural, EthIf_SwitchPortGetTxErrorCounterValues transmet directement l'appel à la fonction EthSwt_GetTxErrorCounterValues du pilote de switch Ethernet correspondant [SWS_EthIf_00438].

La fonction EthIf_SwitchPortGetMacLearningMode interroge le mode d'apprentissage MAC actuel pour un port de switch déterminé ([SWS_EthIf_91119]). Les modes pouvant être déterminés comprennent l'apprentissage matériel activé, l'apprentissage matériel désactivé ainsi que l'apprentissage logiciel activé ([SWS_EthIf_91119]). La disponibilité de cette fonction dépend du matériel, car le matériel du switch concerné doit prendre en charge les différents modes d'apprentissage ([SWS_EthIf_91119]).

Contexte d'appel et paramètres

L'interface est fournie via l'en-tête EthIf.h et possède l'ID de service 0x55 ([SWS_EthIf_91119]). Lors de l'appel, les paramètres suivants doivent être transmis :

• SwitchIdx (in) : index du switch dans le contexte du pilote de switch Ethernet ([SWS_EthIf_91119]).
• SwitchPortIdx (in) : index du port sur le switch adressé ([SWS_EthIf_91119]).
• MacLearningModePtr (out) : pointeur vers l'emplacement mémoire de type EthSwt_MacLearningType où le mode déterminé est stocké ([SWS_EthIf_91119]).

Synchronisation, concurrence et valeurs de retour

L'exécution est spécifiée comme synchrone/asynchrone et n'est pas réentrante (Non Reentrant) ([SWS_EthIf_91119]). La valeur de retour est Std_ReturnType avec les états suivants :

• E_OK : interrogation effectuée avec succès ([SWS_EthIf_91119]).
• E_NOT_OK : erreur lors de l'exécution ([SWS_EthIf_91119]). Bien que la description de la spécification relative à E_NOT_OK mentionne textuellement « configuration could be persistently reset », interprétation : il devrait s'agir d'une erreur rédactionnelle de copie dans la spécification et, dans un contexte régulier, cela signale simplement l'échec de l'interrogation. Question Q-7565d2fbd70e355d (ouverte)

L'interface synchrone EthIf_WritePortMirrorConfiguration sert à enregistrer une configuration de port mirroring dans un shadow buffer au sein du pilote de switch Ethernet [SWS_EthIf_91122].

Lors de l'appel, les paramètres d'entrée suivants sont transmis [SWS_EthIf_91122] :

• MirroredSwitchIdx : index du switch concerné dans le contexte du pilote de switch Ethernet, sur lequel se trouve le port de switch à dupliquer [SWS_EthIf_91122].
• PortMirrorConfigurationPtr : pointeur vers les données de configuration de la structure EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

La valeur de retour de type Std_ReturnType signale l'état de l'exécution [SWS_EthIf_91122] :

• E_OK : la configuration de port mirroring a été écrite avec succès pour le port indexé [SWS_EthIf_91122].
• E_NOT_OK : la configuration n'a pas pu être écrite, par exemple parce que le switch indexé n'est pas disponible [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED : le port mirroring n'est pas pris en charge par le matériel du switch ou par le pilote de switch Ethernet [SWS_EthIf_91122].

La fonction est spécifiée comme non réentrante (Non Reentrant) et est disponible via l'en-tête EthIf.h [SWS_EthIf_91122]. Interprétation : les appelants devraient devoir coordonner les accès concurrents par des mécanismes de niveau supérieur, car aucune protection de synchronisation interne n'est spécifiée. Question Q-c731aedd871251a4 (ouverte)

Utilisation et sémantique

La fonction EthIf_ReadPortMirrorConfiguration sert à interroger la configuration de port mirroring d'un switch Ethernet déterminé [SWS_EthIf_91123]. Elle est déclarée dans le fichier d'en-tête EthIf.h et possède l'ID de service 0x59. Le comportement d'exécution est spécifié comme asynchrone (Asynchronous), l'appel immédiat renvoyant une valeur d'état de type Std_ReturnType [SWS_EthIf_91123].

Paramètres et valeurs de retour

• MirroredSwitchIdx (in) : index du switch Ethernet dans le contexte du pilote de switch Ethernet, sur lequel se trouvent les ports de switch à dupliquer [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out) : pointeur vers la zone mémoire dans laquelle la configuration lue doit être stockée [SWS_EthIf_91123].
• Valeur de retour : E_OK signale la réussite de la lecture de la configuration. En cas d'erreur, E_NOT_OK est renvoyé, par exemple si le switch Ethernet indexé n'est pas disponible [SWS_EthIf_91123].

Interaction et concurrence

Pour l'exécution, EthIf_ReadPortMirrorConfiguration transmet directement l'appel à la fonction EthSwt_ReadPortMirrorConfiguration du pilote de switch Ethernet correspondant [SWS_EthIf_00448]. La fonction est définie comme non réentrante (Non Reentrant) [SWS_EthIf_91123] ; les appels parallèles pour la même interface doivent donc être évités par l'appelant.

La fonction synchrone EthIf_DeletePortMirrorConfiguration sert à supprimer une configuration de port mirror enregistrée pour un switch déterminé ([SWS_EthIf_91124]). L'appelant transmet via le paramètre Mirrored Switch Idx l'index du switch dans le contexte de l'Ethernet Switch Driver ([SWS_EthIf_91124]). L'interface possède l'ID de service 0x5a et est fournie via le fichier d'en-tête EthIf.h ([SWS_EthIf_91124]).

La valeur de retour de type Std_ReturnType informe du résultat de la suppression ([SWS_EthIf_91124]) :

• E_OK : la configuration de port mirror a été supprimée avec succès ([SWS_EthIf_91124]). Si aucune configuration enregistrée n'a été trouvée pour l'index de switch spécifié, la fonction renvoie également E_OK par définition ([SWS_EthIf_91124]).
• E_NOT_OK : la suppression de la configuration a échoué ([SWS_EthIf_91124]). C'est par exemple le cas si la duplication de port est encore activée au moment de l'appel ([SWS_EthIf_91124]).

En matière de concurrence, la fonction est réentrante pour différents index de switch (Mirrored Switch Idx), mais non réentrante lors d'appels multiples pour le même index ([SWS_EthIf_91124]). Un mirroring actif étant explicitement mentionné comme cause d'erreur pour E_NOT_OK, le port mirroring devrait devoir être désactivé avant la suppression de la configuration ([SWS_EthIf_91124]). Question Q-b9e5665de687dbba (ouverte)

La fonction synchrone EthIf_SetPortMirrorState sert à définir l'état requis de la configuration de port mirroring pour un switch Ethernet spécifié ([SWS_EthIf_91126]). Elle est disponible via le fichier d'en-tête EthIf.h ([SWS_EthIf_91126]).

La fonction attend trois paramètres lors de l'appel ([SWS_EthIf_91126]) :

• MirroredSwitchIdx : index du commutateur Ethernet dans le contexte de l'Ethernet Switch Driver, sur lequel se trouve la configuration de miroir de port à activer ou à désactiver.
• PortIdx : index du port sur le commutateur Ethernet adressé.
• PortMirrorState : l'état à demander pour la duplication de port, soit PORT_MIRRORING_ENABLED, soit PORT_MIRRORING_DISABLED.

La valeur de retour de type Std_ReturnType signale le résultat de la requête ([SWS_EthIf_91126]) :

• E_OK : l'état demandé pour le port de switch spécifié a été défini avec succès.
• E_NOT_OK : la définition a échoué, par exemple si le switch adressé n'est pas disponible ou si aucune configuration de port mirroring n'est présente.

L'exécution s'effectue de manière synchrone et est spécifiée comme non réentrante (Non Reentrant) ([SWS_EthIf_91126]). Dans l'ensemble des couches, l'Ethernet Interface prend en charge le relais : conformément à [SWS_EthIf_00454], EthIf_SetPortMirrorState transmet directement l'appel à la fonction EthSwt_SetPortMirrorState de l'Ethernet Switch Driver compétent.

La fonction EthIf_SetPortTestMode sert à activer un mode de test prédéfini sur un port indexé d'un switch Ethernet [SWS_EthIf_91127]. Le service synchrone est disponible via l'en-tête EthIf.h avec l'ID de service 0x5d [SWS_EthIf_91127].

Paramètres et valeurs de retour

Pour la configuration du mode de test, l'interface attend trois paramètres d'entrée, tandis qu'aucun paramètre d'entrée/sortie ou de sortie pure n'existe [SWS_EthIf_91127] :

• SwitchIdx (uint8) : index du switch dans le contexte du pilote de switch Ethernet respectif [SWS_EthIf_91127].
• PortIdx (uint8) : index du port sur le switch Ethernet adressé [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType) : mode de test à activer sur le port de switch [SWS_EthIf_91127].

La valeur de retour de type Std_ReturnType signale le succès de l'opération [SWS_EthIf_91127] :

• E_OK : le mode de test de port a été défini avec succès pour le port de switch Ethernet indexé [SWS_EthIf_91127].
• E_NOT_OK : la définition du mode de test de port n'a pas réussi, par exemple si le port de switch Ethernet adressé n'est pas disponible [SWS_EthIf_91127].

Concurrence et interaction

La fonction est spécifiée comme non réentrante (Non Reentrant) et fonctionne de manière synchrone [SWS_EthIf_91127]. Lors de l'appel, EthIf_SetPortTestMode transmet la requête directement à la fonction sous-jacente EthSwt_SetPortTestMode du pilote de switch Ethernet correspondant [SWS_EthIf_00456].

Utilisation

La fonction EthIf_SetPortLoopbackMode sert à activer un mode de boucle de test prédéfini pour un port indexé d'un switch Ethernet [SWS_EthIf_91128]. La déclaration est fournie via le fichier d'en-tête EthIf.h [SWS_EthIf_91128]. Lors de l'appel, les paramètres d'entrée suivants sont transmis :

• SwitchIdx : index du commutateur Ethernet au sein du contexte du pilote de commutateur Ethernet [SWS_EthIf_91128].
• PortIdx : index du port concerné sur le switch précédemment adressé [SWS_EthIf_91128].
• Mode : mode de boucle à activer de type EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Interaction et retransmission

La fonction n'exécute pas elle-même la configuration au niveau matériel. À la place, EthIf_SetPortLoopbackMode transmet l'appel directement à la fonction EthSwt_SetPortLoopbackMode du pilote de switch Ethernet associé [SWS_EthIf_00458].

Gestion des erreurs et valeurs de retour

La valeur de retour est de type Std_ReturnType [SWS_EthIf_91128] :

• E_OK : le mode de boucle a été activé avec succès pour le port indexé du switch Ethernet [SWS_EthIf_91128].
• E_NOT_OK : l'activation a échoué, par exemple si le port de switch Ethernet indexé n'est pas disponible [SWS_EthIf_91128].

Aucun code d'erreur spécifique pour DET ou DEM n'est répertorié dans la spécification pour ce service.

Concurrence et restrictions

L'exécution s'effectue de manière entièrement synchrone, et la fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91128]. Les appels parallèles doivent être évités par l'appelant. Interprétation : s'agissant de la commutation de modes de test, l'appel devrait typiquement avoir lieu dans le cadre de séquences d'initialisation, de test ou de diagnostic au niveau tâche. Question Q-cb4575c4a1d9c48b (ouverte)

La fonction synchrone EthIf_SetPortTxMode active un mode de transmission prédéfini pour un port de switch Ethernet indexé [SWS_EthIf_91129]. Elle est disponible via le fichier d'en-tête EthIf.h et possède l'ID de service 0x5f [SWS_EthIf_91129].

Utilisation

L'appel adresse le port cible via deux index et transmet le mode souhaité [SWS_EthIf_91129] :

• SwitchIdx : index du switch au sein du contexte du pilote de switch Ethernet.
• PortIdx : index du port sur le commutateur adressé.
• Mode : mode de transmission à activer, de type EthTrcv_PhyTxModeType.

Comme valeur de retour, la fonction fournit Std_ReturnType [SWS_EthIf_91129] :

• E_OK : Le mode de transmission pour le port de switch indexé a été activé avec succès.
• E_NOT_OK : L'activation a échoué, par exemple si le port de switch indexé n'est pas disponible.

Concurrence et restrictions

L'interface est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91129]. Les instances appelantes doivent donc s'assurer qu'aucun appel concurrent n'a lieu. Aucun message d'erreur DET ou DEM spécifique n'est répertorié dans la définition de la fonction ; selon la spécification, le comportement en cas d'erreur se limite au renvoi de E_NOT_OK [SWS_EthIf_91129].

Utilisation

L'interface asynchrone EthIf_RunPortCableDiagnostic déclenche un diagnostic de câble pour un port sélectionné d'un switch Ethernet [SWS_EthIf_91131]. Lors de l'appel, les paramètres SwitchIdx (index du switch dans le contexte du pilote de switch Ethernet) et PortIdx (index du port adressé sur le switch) sont transmis. La fonction renvoie E_OK dès que le déclencheur pour le diagnostic de câble a été accepté ; si le déclenchement est rejeté, E_NOT_OK est renvoyé [SWS_EthIf_91131].

Interaction et préconditions

Lors de l'exécution de EthIf_RunPortCableDiagnostic, EthIf est tenu de s'assurer que le EthIfController correspondant se trouve dans l'état de fonctionnement ETH_MODE_ACTIVE [SWS_EthIf_00464]. Sous cette condition, l'Ethernet Interface transmet l'appel à la fonction EthSwt_RunPortCableDiagnostic du pilote de switch associé [SWS_EthIf_00464].

Concurrence et restrictions

La fonction est réentrante pour des valeurs divergentes de SwitchIdx et PortIdx [SWS_EthIf_91131]. En revanche, pour des paires identiques d'index de switch et de port, l'appel est spécifié comme non réentrant, raison pour laquelle les exécutions parallèles sur le même port doivent être évitées.

Utilisation

La fonction EthIf_RunCableDiagnostic déclenche le diagnostic de câble pour un émetteur-récepteur Ethernet spécifié [SWS_EthIf_91132]. Elle est mise à disposition via l'en-tête EthIf.h et répertoriée sous l'ID de service 0x62 [SWS_EthIf_91132]. TrcvIdx, qui représente l'index de l'émetteur-récepteur cible dans le contexte du pilote d'émetteur-récepteur Ethernet, sert de paramètre de transmission [SWS_EthIf_91132].

L'exécution s'effectue de manière asynchrone [SWS_EthIf_91132]. La valeur de retour du type Std_ReturnType signale l'acceptation du déclencheur :

• E_OK : Le déclencheur pour le diagnostic de câble a été accepté avec succès [SWS_EthIf_91132].
• E_NOT_OK : Le déclencheur n'a pas été accepté [SWS_EthIf_91132].

Gestion des erreurs

Si le diagnostic de câble est rejeté, la fonction renvoie immédiatement E_NOT_OK [SWS_EthIf_91132]. Aucune erreur spécifique de développement ou de production (DET/DEM) n'est définie pour cette fonction dans la présente spécification.

Concurrence et restrictions

En ce qui concerne la concurrence, EthIf_RunCableDiagnostic est réentrante pour les appels avec des index différents (TrcvIdx), mais non réentrante pour le même index d'émetteur-récepteur [SWS_EthIf_91132]. Les requêtes de diagnostic simultanées sur le même émetteur-récepteur doivent être empêchées par l'appelant. Interprétation : comme la fonction fonctionne de manière purement asynchrone et ne renvoie aucune donnée de résultat, la mise à disposition du résultat de diagnostic devrait probablement s'effectuer via un mécanisme distinct. Question Q-c65c009cd2e00dea (ouverte)

La fonction d'interface EthIf_SwitchGetCfgDataRaw sert à la lecture de longueur variable de données de configuration ou de mémoire d'un switch Ethernet indexé [SWS_EthIf_91133]. Dans le cadre du modèle en couches, le module ne traite pas l'appel de manière autonome, mais le transmet directement à la fonction EthSwt_GetCfgDataRaw du pilote de switch Ethernet compétent [SWS_EthIf_00468]. La fonction est déclarée dans l'en-tête EthIf.h et possède l'ID de service 0x63 [SWS_EthIf_91133].

Appel et paramètres

L'appel s'effectue de manière asynchrone et initie uniquement l'opération de lecture [SWS_EthIf_91133]. Comme paramètres, la fonction attend :

• SwitchIdx : index du switch Ethernet dans le contexte du pilote de switch Ethernet [SWS_EthIf_91133],
• Offset : décalage initial (start offset) dans la mémoire du switch Ethernet à partir duquel commence l'opération de lecture [SWS_EthIf_91133],
• Length : nombre d'octets de données à lire et à copier [SWS_EthIf_91133],
• BufferPtr : pointeur vers l'emplacement mémoire de destination vers lequel les données doivent être copiées [SWS_EthIf_91133].

Comme valeur de retour, la fonction renvoie E_OK lorsque l'opération de lecture a été déclenchée avec succès [SWS_EthIf_91133]. Si l'opération ne peut pas être déclenchée – par exemple si le switch adressé n'est pas disponible –, E_NOT_OK est signalé [SWS_EthIf_91133].

concurrence

La fonction est définie comme non réentrante (Non Reentrant) [SWS_EthIf_91133]. Les appelants doivent donc s'assurer que les appels s'effectuent de manière séquentielle. Interprétation : en raison de la nature asynchrone, le contenu du tampon ne devrait pas encore être définitivement rempli lors du retour de E_OK, mais mis à disposition ultérieurement par le pilote. Question Q-0abda93fb8830dd4 (ouverte)

La fonction EthIf_SwitchGetCfgDataInfo détermine la taille totale des données de configuration ainsi que l'adresse de départ des registres de configuration pour un switch Ethernet indexé [SWS_EthIf_91134]. L'interface est déclarée dans l'en-tête EthIf.h et est répertoriée sous l'ID de service 0x64 [SWS_EthIf_91134].

La fonction prend en charge les paramètres suivants [SWS_EthIf_91134] :

• SwitchIdx (in) : index du switch Ethernet dans le contexte du pilote de switch Ethernet.
• DataSizePtr (out) : pointeur vers l'emplacement mémoire vers lequel la taille totale des données de configuration doit être copiée.
• DataAdressPtr (out) : pointeur vers l'emplacement mémoire vers lequel l'adresse de départ des registres de configuration doit être copiée.

Comme valeur de retour, la fonction renvoie E_OK si les données ont été obtenues avec succès, ou E_NOT_OK si l'opération échoue, par exemple parce que le switch indexé n'est pas disponible [SWS_EthIf_91134]. Aucun code d'erreur spécifique pour DET ou DEM n'est défini pour ce service dans le cadre de la présente spécification.

Pour le contexte d'appel, la fonction est spécifiée comme réentrante et formellement comme asynchrone [SWS_EthIf_91134]. Étant donné qu'aucun mécanisme de rappel n'est spécifié, la mise à disposition des données devrait être immédiatement effective lors du renvoi de E_OK (interprétation : la classification asynchrone indique probablement des accès internes au pilote). Question Q-bf49882a16548ea4 (ouverte)

Utilisation et appel

La fonction EthIf_SwitchPortGetMaxFIFOBufferFillLevel détermine la mémoire tampon FIFO allouée maximale (en octets) depuis le dernier accès en lecture pour un port de sortie donné d'un switch Ethernet [SWS_EthIf_91135]. L'appel peut par exemple être effectué par un Complex Device Driver (CDD) [SWS_EthIf_91135]. Pour l'adressage, l'index du switch (SwitchPortIdx), l'index du port (PortIdx) et l'index du FIFO (SwitchPortEgressFifoIdx) sont transmis. Le niveau de remplissage déterminé est écrit dans la zone mémoire vers laquelle SwitchPortEgressFifoBufferLevelPtr pointe [SWS_EthIf_91135].

Concurrence et exécution

La fonction possède une sémantique d'exécution asynchrone [SWS_EthIf_91135]. Elle est réentrante pour différents index de switch et de port, mais ne doit pas être appelée de manière concurrente pour une même combinaison de SwitchPortIdx et PortIdx [SWS_EthIf_91135]. En raison de la sémantique asynchrone associée à la transmission d'un pointeur, la zone mémoire référencée pour le résultat devrait probablement devoir rester valide jusqu'à l'achèvement de l'opération. Question Q-c941ffec278a86cd (ouverte)

Gestion des erreurs et interaction avec le pilote

En cas de récupération réussie, la fonction renvoie E_OK, sinon E_NOT_OK [SWS_EthIf_91135]. Si le matériel du switch ne prend pas en charge la détermination par port du niveau de remplissage maximal du tampon FIFO, la valeur à l'adresse cible SwitchPortEgressFifoBufferLevelPtr est définie sur 0xFFFFFFFF [SWS_EthIf_91135]. Le module transmet l'appel pour poursuite de l'exécution à la fonction de pilote EthSwt_GetMaxFIFOBufferFillLevel du pilote de switch Ethernet associé [SWS_EthIf_00472].

Utilisation et sémantique

La fonction EthIf_TransceiverGetMacMethod (ID de service 0x66) sert à interroger de manière synchrone la méthode d'accès au support configurée d'un transceiver Ethernet [SWS_EthIf_91021]. Elle est disponible via le fichier d'en-tête EthIf.h et utilise les paramètres d'interface suivants :

• TrcvIdx (in) : indice du transceiver dans le contexte du pilote de transceiver Ethernet [SWS_EthIf_91021].
• MacModePtr (out) : pointeur vers l'emplacement mémoire pour la méthode d'accès déterminée de type EthTrcv_MacMethodType [SWS_EthIf_91021]. Les valeurs de résultat valides sont ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access avec Collision Detection) et ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

Valeurs de retour et gestion des erreurs

En tant que valeur de retour, l'interface renvoie un état de type Std_ReturnType [SWS_EthIf_91021] :

• E_OK : la méthode d'accès au support a été lue avec succès et mise à disposition via MacModePtr.
• E_NOT_OK : la requête adressée au transceiver n'a pas été acceptée [SWS_EthIf_91021]. Les codes d'erreur DET ou DEM spécifiques ne sont pas répertoriés dans la spécification pour ce service.

Concurrence et contraintes

L'exécution s'effectue de manière synchrone, mais la fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_91021]. Un appel simultané ou interruptif au sein du même contexte de pilote doit donc être exclu par l'appelant. Il convient en outre de noter que le service est désigné dans la version R20-11 avec le statut atp.Status=draft [SWS_EthIf_91021].

Utilisation et sémantique

La fonction synchrone EthIf_RxIndication traite une trame Ethernet reçue via un contrôleur Ethernet physique indexé [SWS_EthIf_00085]. Le service ne possède aucune valeur de retour et prend en charge le routage des données reçues au sein de l'interface Ethernet [SWS_EthIf_00085]. Interprétation : l'appel devrait typiquement être effectué par le pilote Ethernet sous-jacent (Eth) dès que de nouvelles données de réception sont entièrement disponibles. Question Q-c3d25d0b89e6cd7f (ouverte)

paramètre

Pour le traitement ultérieur, la fonction prend en charge les paramètres suivants [SWS_EthIf_00085] :

• CtrlIdx : index du contrôleur Ethernet physique dans le contexte de l'interface Ethernet [SWS_EthIf_00085].
• FrameType : type de trame de la trame Ethernet reçue [SWS_EthIf_00085].
• IsBroadcast : indication spécifiant s'il s'agit d'une trame de broadcast [SWS_EthIf_00085].
• PhysAddrPtr : pointeur vers l'adresse physique source (adresse MAC dans l'ordre des octets du réseau) de la trame reçue [SWS_EthIf_00085].
• DataPtr : pointeur vers les données utiles (charge utile) de la trame reçue [SWS_EthIf_00085].
• LenByte : longueur des données utiles dans la trame reçue, en octets [SWS_EthIf_00085].

Concurrence et restrictions

L'interface est déclarée comme non réentrante (Non Reentrant) et est disponible sous l'ID de service 0x10 via le fichier d'en-tête EthIf.h [SWS_EthIf_00085]. Les appelants doivent s'assurer qu'aucun appel concurrent n'a lieu. Aucun code d'erreur, valeur de retour ou notification DET/DEM spécifique n'est mentionné dans le périmètre de la spécification pour cette fonction.

Utilisation et contexte d'appel

La fonction synchrone EthIf_TxConfirmation (ID de service 0x11) confirme la transmission d'une trame Ethernet par le contrôleur Ethernet physique référencé via CtrlIdx [SWS_EthIf_00091]. La fonction n'a pas de valeur de retour et est disponible via le fichier d'en-tête EthIf.h [SWS_EthIf_00091].

Les paramètres d'entrée sont définis comme suit [SWS_EthIf_00091] :

• CtrlIdx (uint8) : index du contrôleur Ethernet physique dans le contexte de l'interface Ethernet.
• BufIdx (Eth_BufIdxType) : index du tampon transmis.
• Result (Std_ReturnType) : résultat de la transmission ; E_OK signale une opération d'émission réussie, E_NOT_OK une erreur de transmission.

Interaction avec les couches supérieures

Conformément à [SWS_EthIf_00255], EthIf_TxConfirmation transmet le résultat de transmission reçu Result à la couche supérieure configurée via son callback <UL>_TxConfirmation.

Concurrence et restrictions

La fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_EthIf_00091]. Les appels parallèles doivent donc être évités. Aucun message d'erreur DET ou DEM spécifique n'est prévu dans l'extrait de spécification ; les erreurs sont transmises exclusivement via le paramètre Result avec la valeur E_NOT_OK [SWS_EthIf_00091].

La fonction de notification EthIf_CtrlModeIndication est appelée conformément à [SWS_EthIf_00231] dès que le mode de fonctionnement d'un contrôleur Ethernet a été lu avec succès. Le déclenchement s'effectue de manière asynchrone à la suite d'un appel antérieur de Eth_SetControllerMode, l'appel pouvant intervenir directement au sein des fonctions de déclenchement respectives. La fonction elle-même possède une sémantique d'exécution synchrone et ne renvoie aucune valeur de retour ([SWS_EthIf_00231]).

L'index du contrôleur Ethernet physique dans le contexte de l'interface Ethernet (CtrlIdx) ainsi que le mode de contrôleur notifié (CtrlMode) sont transmis via les paramètres ([SWS_EthIf_00231]). Concernant la concurrence, [SWS_EthIf_00231] spécifie que la fonction n'est pas réentrante pour le même index de contrôleur, mais qu'elle peut être exécutée de manière réentrante pour des index différents.

Concernant l'interaction avec d'autres modules, des exigences associées renvoient à des actions en aval, lesquelles sont toutefois classées comme obsolètes dans la présente version :

• Conformément à [SWS_EthIf_00267] (OBSOLETE), il était prévu dans le contexte de cette fonction d'appeler EthSwt_SetSwitchPortMode pour tous les ports d'un groupe de ports de commutateur si une référence de contrôle correspondante existe, et de résoudre les conflits avec des groupes actifs lors de ETH_MODE_DOWN.
• Conformément à [SWS_EthIf_00413] (OBSOLETE), il était prévu dans le contexte de cette fonction, en cas de référence d'émetteur-récepteur existante, d'appeler EthTrcv_TransceiverLinkStateRequest avec ETHTRCV_LINK_STATE_ACTIVE ou ETHTRCV_LINK_STATE_DOWN, selon que ETH_MODE_ACTIVE ou ETH_MODE_DOWN avait été préalablement demandé.

Utilisation et sémantique

La fonction EthIf_TrcvModeIndication sert d'interface de notification de l'interface Ethernet, appelée dès qu'un changement de mode de l'émetteur-récepteur a été lu [SWS_EthIf_00232]. Elle est disponible via le fichier d'en-tête EthIf.h et possède l'ID de service 0x0f [SWS_EthIf_00232].

L'exécution de la fonction elle-même est spécifiée comme synchrone, tandis que l'appel a lieu de manière asynchrone lorsque le changement de mode a été déterminé [SWS_EthIf_00232]. Si la fonction est déclenchée par un appel préalable de EthTrcv_SetTransceiverMode, elle peut être appelée directement au sein de cette fonction déclencheuse [SWS_EthIf_00232].

Paramètres et valeurs de retour

• TrcvIdx : index de l'émetteur-récepteur Ethernet dans le contexte de l'interface Ethernet (paramètre d'entrée) [SWS_EthIf_00232].
• TrcvMode : mode de fonctionnement signalé de l'émetteur-récepteur Ethernet de type Eth_ModeType (paramètre d'entrée) [SWS_EthIf_00232].
• Valeur de retour : aucune (void) [SWS_EthIf_00232].

Concurrence et réentrance

La fonction est spécifiée comme non réentrante pour le même index, mais réentrante pour des index différents [SWS_EthIf_00232]. Le tableau de spécification mentionne ici Ctrl Idx, ce qui, dans le contexte de cette interface de transceiver, doit probablement être interprété comme une référence à l'index de transceiver ou de contrôleur [SWS_EthIf_00232]. Question Q-c0123f1ef0e4ec71 (ouverte)

La fonction EthIf_SwitchPortModeIndication sert à l'Ethernet Interface (EthIf) d'interface de notification asynchrone concernant un changement de mode d'un port de commutateur Ethernet signalé par l'Ethernet Switch Driver [SWS_EthIf_91055].

Utilisation et interaction

L'EthIf détermine les notifications attendues en fonction de la configuration du port de commutateur respectif : si le port de commutateur référence un transceiver (EthTrcv), l'EthIf attend à la place une notification via EthIf_TrcvModeIndication() ; sinon, la notification de l'Ethernet Switch Driver est attendue via EthIf_SwitchPortModeIndication() [SWS_EthIf_91055].

• SwitchIdx : indice du commutateur Ethernet dans le contexte de l'Ethernet Switch Driver [SWS_EthIf_91055].
• SwitchPortIdx : indice du port sur le commutateur Ethernet adressé [SWS_EthIf_91055].
• PortMode : le nouveau mode signalé du port de commutateur de type Eth_ModeType [SWS_EthIf_91055].

Propriétés d'exécution et restrictions

La fonction ne possède pas de valeur de retour (void) et a pour ID de service 0x46 [SWS_EthIf_91055]. Elle est spécifiée comme asynchrone (Asynchronous) et non réentrante (Non Reentrant) [SWS_EthIf_91055]. Les appelants doivent donc s'assurer que les appels concurrents pour ce service sont évités. Les messages d'erreur DET ou DEM spécifiques ne sont pas définis pour cette fonction dans la charge utile.

Utilisation et contexte d'appel

La fonction EthIf_SleepIndication sert d'interface de notification pour l'Ethernet Interface. Elle est appelée par le pilote de transceiver Ethernet respectif (EthTrcv) dès que celui-ci a enregistré une indication de sommeil sur le réseau [SWS_EthIf_91006]. Le seul paramètre d'entrée transmis est TrcvIdx, qui identifie de manière univoque l'index du transceiver Ethernet signalant dans le contexte du module EthIf [SWS_EthIf_91006]. La fonction ne possède ni paramètres d'entrée/sortie ni valeurs de retour, et exécute la notification de manière synchrone [SWS_EthIf_91006].

Interaction matérielle

Un cas d'utilisation essentiel est l'emploi avec du matériel Ethernet conçu en conformité avec la spécification OPEN Alliance TC10 [SWS_EthIf_91006]. Dans ce scénario, le transceiver (PHY) détecte au niveau matériel une Sleep.Indication déclenchée par une demande de sommeil (Sleep.Request) du partenaire de liaison directement connecté [SWS_EthIf_91006].

Concurrence et restrictions

L'interface est définie comme synchrone et réentrante, et est mise à disposition via le fichier d'en-tête EthIf.h (Service-ID 0x68) [SWS_EthIf_91006]. Lors de l'intégration du système, il convient de prendre en compte que l'élément est marqué comme ébauche avec le tag atp.Status=draft [SWS_EthIf_91006]. Aucune routine concrète de traitement des erreurs ni aucun code d'erreur DET ne sont définis dans le périmètre de la spécification ; une vérification formelle des erreurs n'interviendra probablement que dans de futures versions de la spécification. Question Q-680af6c43439167f (ouverte)

Utilisation et contexte d'appel

Dans l'interface Ethernet (EthIf), la fonction EthIf_MainFunctionRx assume la tâche centrale de vérifier, en fonctionnement par polling, la présence de nouvelles trames de données reçues et de déclencher les indications de réception correspondantes (Reception Indications) vers les couches supérieures [SWS_EthIf_00097]. Elle est définie avec la signature void EthIf_MainFunctionRx (void), ne prend donc aucun paramètre d'appel et ne fournit aucune valeur de retour [SWS_EthIf_00097]. La valeur hexadécimale 0x20 est définie comme ID de service [SWS_EthIf_00097].

La fonction est mise à disposition via le fichier d'en-tête SchM_EthIf.h [SWS_EthIf_00097]. Cela suggère l'interprétation selon laquelle son appel s'effectue périodiquement par le Schedule Manager (SchM) ou le système d'exploitation dans le contexte d'une tâche cyclique du logiciel de base.

Concurrence et traitement des erreurs

La vérification et la transmission des trames reçues étant spécifiées en mode polling [SWS_EthIf_00097], un fonctionnement fluide de la réception requiert un cadencement temporel adéquat de l'appel. Une exécution retardée devrait entraîner des retards lors de la transmission des messages entrants aux couches logicielles supérieures. Question Q-554ef0cf302c3aa3 (ouverte) Aucun code d'erreur spécifique, erreur de développement (DET) ou message d'erreur vers le DEM n'est répertorié dans la spécification pour cette fonction.

La fonction principale EthIf_MainFunctionTx sert au traitement cyclique des opérations d'émission et des interrogations d'état au sein du module d'interface Ethernet [SWS_EthIf_00113]. Elle possède l'ID de service hexadécimal 0x21 et est exécutée conformément à sa signature void EthIf_MainFunctionTx (void) sans paramètre de transmission et sans valeur de retour, de sorte que l'ensemble du traitement s'effectue sur la base de l'état [SWS_EthIf_00113].

En cours de fonctionnement, le service assure deux tâches centrales dans la communication Ethernet :

• Confirmations d'émission : en mode polling, la fonction délivre des confirmations pour les transmissions terminées avec succès (Transmission Confirmations) aux couches supérieures [SWS_EthIf_00113].
• États de l'émetteur-récepteur : elle surveille et vérifie le système quant aux changements d'état survenus sur les émetteurs-récepteurs Ethernet connectés [SWS_EthIf_00113].

En ce qui concerne l'intégration système, l'interface est disponible via le fichier d'en-tête SchM_EthIf.h [SWS_EthIf_00113]. Interprétation : de la mise à disposition via SchM_EthIf.h, il devrait découler que l'appel s'effectue périodiquement par le planificateur BSW (SchM) dans le contexte d'une tâche cyclique. Question Q-b9dde07f9cc74a95 (ouverte) Cela garantit que les confirmations d'émission en attente en mode polling et les changements d'état de l'émetteur-récepteur sont traités régulièrement et sans dépendance aux interruptions.

Les codes d'erreur spécifiques, les routines de traitement des erreurs particulières via DET ou DEM ainsi que les exigences de réentrance ne sont pas définis dans le présent périmètre de spécification pour ce service et ne sont donc pas indiqués.

Utilisation et sémantique

La fonction EthIf_MainFunctionState sert à l'interrogation cyclique (polling) d'informations d'état et de diagnostic du matériel de communication Ethernet raccordé, tel que les transceivers Ethernet et les ports de switch Ethernet [SWS_EthIf_91104]. Celles-ci comprennent par exemple l'état de la liaison (Link State) ainsi que la qualité du signal [SWS_EthIf_91104]. La fonction ne possède ni paramètres d'entrée ni paramètres de sortie et ne renvoie aucune valeur (void EthIf_MainFunctionState(void), Service-ID 0x05) [SWS_EthIf_91104]. Le comportement d'exécution est spécifié comme asynchrone [SWS_EthIf_91104].

Concurrence et conditions d'appel

La fonction est définie comme non réentrante (Non Reentrant) [SWS_EthIf_91104]. Elle ne doit donc à aucun moment être exécutée en parallèle ou de manière auto-interruptive. L'interface étant mise à disposition via le fichier d'en-tête EthIf_SchM.h [SWS_EthIf_91104], l'appel périodique devrait typiquement avoir lieu dans le contexte de tâche de l'ordonnanceur BSW (SchM). Question Q-10d02355b276be90 (ouverte)

Interaction et configuration

Conformément à [SWS_EthIf_00407], EthIf_MainFunctionState doit interroger les informations matérielles strictement selon la périodicité configurée EthIfMainFunctionStatePeriod. Cela garantit une actualisation régulière des paramètres d'interface physique dans l'Ethernet Interface.

La structure de données EthIf_SignalQualityResultType ([SWS_EthIf_91057]) sert à l'acquisition et au diagnostic de la qualité de liaison au niveau Ethernet et est mise à disposition via le fichier d'en-tête EthIf.h.

La structure regroupe trois grandeurs de mesure du type de base uint32 :

• ActualSignalQuality : représente la qualité de signal actuellement présente sur la liaison Ethernet.
• HighestSignalQuality : consigne la qualité de signal la plus élevée mesurée sur la liaison depuis la dernière réinitialisation.
• LowestSignalQuality : documente la qualité de signal la plus basse mesurée sur la liaison depuis la dernière réinitialisation.

En interaction avec le module EthIf, les valeurs extrêmes reflètent l'évolution de la stabilité de la liaison. La remise à zéro des valeurs d'historique enregistrées en interne est commandée via des interfaces dédiées :

• Pour un émetteur-récepteur spécifié via TrcvIdx, la fonction EthIf_ClearTrcvSignalQuality réinitialise les valeurs de qualité de signal enregistrées ([SWS_EthIf_00400]).
• Pour un port de commutateur identifié via SwitchIdx et SwitchPortIdx, EthIf_ClearSwitchPortSignalQuality efface les valeurs de qualité de signal enregistrées ([SWS_EthIf_00404]).

Interprétation : comme la charge utile ne mentionne aucune fonction de lecture spécifique, la structure devrait vraisemblablement servir de paramètre de sortie aux requêtes d'état correspondantes pour les émetteurs-récepteurs et les ports de commutateur, afin de comparer la qualité de signal actuelle avec les valeurs extrêmes. Question Q-8e5f2914bade574c (ouverte)