Ethernet Interface (EthIf)

Verwendung und Semantik

Die Funktion EthIf_Init initialisiert das Ethernet-Interface-Modul ([SWS_EthIf_00024]). Sie wird synchron ausgeführt, ist nicht reentrant (Non Reentrant) und über die Header-Datei EthIf.h mit der Service-ID 0x01 verfügbar. Als einzigen Übergabeparameter erwartet die Funktion den Zeiger CfgPtr, der auf eine implementationsspezifische Konfigurationsstruktur vom Typ EthIf_ConfigType verweist. Es existieren weder Inout- noch Out-Parameter, und die Funktion besitzt keinen Rückgabewert ([SWS_EthIf_00024]).

Nebenläufigkeit und Aufrufkontext

Da EthIf_Init nicht reentrant ist, darf kein nebenläufiger oder verschachtelter Aufruf erfolgen [SWS_EthIf_00024]. Da der spezifische Aufrufkontext im Payload nicht näher beschrieben ist, dürfte der Aufruf typischerweise einmalig während der Initialisierungssequenz des Steuergeräts vor der Inanspruchnahme anderer Ethernet-Dienste stattfinden. Frage Q-07e92f9f3c15ea5b (offen)

Reihenfolgebedingungen und Zusammenspiel

Der Aufruf von EthIf_Init bildet die zwingende Voraussetzung für die Nutzung aller weiteren Funktionen des Moduls. Sofern die Entwicklungserkennung (Development Error Detection) aktiviert ist, prüfen zahlreiche Dienste des Ethernet-Interface vor ihrer Ausführung, ob EthIf_Init zuvor aufgerufen wurde:

• Wurde die Initialisierung nicht durchgeführt, melden die abhängigen Funktionen den Entwicklungsfehler ETHIF_E_UNINIT (beispielsweise [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] und [SWS_EthIf_00304]).
• Mehrere Schnittstellen brechen bei unterbliebener Initialisierung die Ausführung ab und liefern zusätzlich den Fehlerwert E_NOT_OK zurück (etwa [SWS_EthIf_00246], [SWS_EthIf_00273] sowie [SWS_EthIf_00277]).

Verwendung

Die Funktion EthIf_SetControllerMode aktiviert oder deaktiviert den über CtrlIdx angegebenen Ethernet-Controller im Kontext der Ethernet-Schnittstelle [SWS_EthIf_00034]. Über den Parameter CtrlMode werden folgende Zustände angefordert [SWS_EthIf_00034]:

• ETH_MODE_DOWN: Deaktiviert den Controller.
• ETH_MODE_ACTIVE: Aktiviert den Controller.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: Aktiviert den Controller und fordert ein Wake-up auf dem Netzwerk an.

Die Funktion arbeitet asynchron [SWS_EthIf_00034]. Sie liefert E_OK bei erfolgreicher Ausführung zurück oder E_NOT_OK, wenn der Controllermodus nicht geändert werden konnte [SWS_EthIf_00034].

Zusammenspiel und Weiterleitung

Wird EthIf_SetControllerMode mit ETH_MODE_ACTIVE für einen Controller aufgerufen, der eine EthIfSwitchPortGroup vom Typ „control“ referenziert, leitet EthIf den Aufruf an alle Ports der Gruppe weiter, sofern dieser Modus erstmals für den Port angefordert wird und dessen Status ETH_MODE_DOWN ist. Dabei werden nacheinander EthSwt_SetSwitchPortMode mit ETH_MODE_ACTIVE und EthSwt_PortLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE ausgeführt [SWS_EthIf_00264].

Bei Anforderung von ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST leitet EthIf die Aufrufe unabhängig vom aktuellen Modus wie folgt weiter:

• Bei Referenz auf einen EthIfTransceiver: Aufruf von EthTrcv_SetTransceiverMode mit ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST und anschließend EthTrcv_TransceiverLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE, falls der aktuelle Status ETHTRCV_LINK_STATE_DOWN ist [SWS_EthIf_00479].
• Bei Referenz auf einen EthIfSwitch bzw. eine EthIfSwitchPortGroup vom Typ „control“: Aufruf von EthSwt_SetSwitchPortMode mit ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST und anschließend EthSwt_PortLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE, falls der aktuelle Zustand ETHTRCV_LINK_STATE_DOWN ist [SWS_EthIf_00480], [SWS_EthIf_00481].

Einschränkungen

Die Funktion ist nicht reentrant (Non Reentrant) und über EthIf.h verfügbar [SWS_EthIf_00034].

Die synchrone und nicht reentrante Funktion EthIf_SetTransceiverWakeupMode (Service-ID 0x2e) dient dazu, den Wake-up-Modus eines über TrcvIdx adressierten Transceivers im Ethernet Interface zu setzen oder dessen Wake-up-Grund zurückzusetzen [SWS_EthIf_00233]. Die Funktion ist in der Header-Datei EthIf.h deklariert und im Release AUTOSAR CP R20-11 als veraltet (obsolete) gekennzeichnet [SWS_EthIf_00233].

Die Steuerung erfolgt über den Übergabeparameter TrcvWakeupMode [SWS_EthIf_00233]:

• ETHTRCV_WUM_ENABLE: Aktiviert das Aufwecken des Transceivers [SWS_EthIf_00233]. Befindet sich der zugeordnete Treiber EthIfTransceiverIdx aktuell im Zustand ETHTRCV_WUM_DISABLE, wird der Aufruf an EthTrcv_SetTransceiverWakeupMode weitergeleitet [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE: Deaktiviert das Aufwecken des Transceivers [SWS_EthIf_00233]. Sofern der aktuelle Zustand des Treibers ETHTRCV_WUM_ENABLE ist, leitet die Funktion den Aufruf an EthTrcv_SetTransceiverWakeupMode weiter [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR: Löscht den Wake-up-Grund des indexierten Transceivers [SWS_EthIf_00233].

Als Rückgabewert liefert der Aufruf E_OK bei erfolgreicher Ausführung oder E_NOT_OK, wenn der Wake-up-Modus nicht geändert bzw. der Wake-up-Grund nicht gelöscht werden konnte [SWS_EthIf_00233]. Da die Schnittstelle als nicht reentrant definiert ist, sind nebenläufige Aufrufe unzulässig [SWS_EthIf_00233].

Die Funktion EthIf_CheckWakeup fordert die betroffene Ethernet-Hardware dazu auf, ein signalisiertes Wake-up zu prüfen [SWS_EthIf_00244]. Dies wird beispielsweise für Ethernet-Hardware genutzt, die konform zur Spezifikation OPEN Alliance TC10 ist [SWS_EthIf_00244]. Der Aufruf erfolgt asynchron und reentrant durch den Integrationscode, wahlweise im Kontext eines Interrupts oder auf Task-Ebene [SWS_EthIf_00244].

Als Eingangsparameter dient WakeupSource vom Typ EcuM_WakeupSourceType, welcher das auslösende Quellgerät bezeichnet (Ethernet-Transceiver oder Ethernet-Switch) [SWS_EthIf_00244]. Der Rückgabewert ist E_OK, wenn die Prüfanforderung an die Hardware akzeptiert wurde, andernfalls E_NOT_OK bei Abweisung der Anforderung [SWS_EthIf_00244]. Das Modul leitet den Aufruf intern an die unterlagerten Treiber weiter:

• Für alle betroffenen Ethernet-Transceiver (referenziert über EthIfTransceiver oder EthIfSwitchPortGroups) wird EthTrcv_CheckWakeup des jeweiligen Transceiver-Treibers aufgerufen [SWS_EthIf_00245].
• Für alle betroffenen Ethernet-Switches (referenziert über EthIfSwitch) wird EthSwt_SwitchCheckWakeup des entsprechenden Switch-Treibers aufgerufen [SWS_EthIf_00500].

Die Verfügbarkeit von EthIf_CheckWakeup ist zur Vorkompilierzeit über den Konfigurationsparameter EthIfWakeUpSupport aktivierbar und deaktivierbar [SWS_EthIf_00248]. Bereitgestellt wird die API über den Header EthIf.h [SWS_EthIf_00244].

Die synchrone Funktion EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) dient dem Aktualisieren des Adressfilters für den über CtrlIdx angegebenen Ethernet-Controller. Über den Parameter Action (vom Typ Eth_FilterActionType) wird eine physische Adresse zum Filter hinzugefügt oder daraus entfernt.

Für die Konfiguration erwartet PhysAddrPtr einen Zeiger auf die physische MAC-Adresse in Netzwerk-Byte-Reihenfolge, welche die Multicast-Zieladresse des Layer-2-Ethernet-Pakets darstellt [SWS_EthIf_00139]. Obwohl die textuelle Funktionsbeschreibung von einer Quelladresse spricht, dürfte es sich dabei um ein redaktionelles Versehen handeln, da die Parameterspezifikation verbindlich die Multicast-Zieladresse festlegt. Frage Q-312e20e5eadda94a (offen)

Hinsichtlich des Ablaufs und der Einschränkungen gelten folgende Vorgaben [SWS_EthIf_00139]:

• Rückgabewerte: Die Funktion liefert E_OK, wenn die Filterkonfiguration erfolgreich geändert wurde, oder E_NOT_OK, falls die Änderung fehlschlug. Spezifische DET- oder DEM-Fehlercodes sind in den Quellen nicht definiert.
• Hardware-Unterstützung: Falls der zugrundeliegende Ethernet-Controller hardwareseitig nicht in der Lage ist, die Filterung durchzuführen, muss die Software diese Filteraufgabe übernehmen.
• Nebenläufigkeit: Der Aufruf ist für denselben Controller-Index (CtrlIdx) nicht reentrant, darf jedoch für unterschiedliche Controller nebenläufig ausgeführt werden.

Verwendung und Aufrufkontext

Die Funktion EthIf_StoreConfiguration dient dazu, das persistente Speichern der gelernten MAC-/Port-Tabellen eines Ethernet-Switches anzufordern [SWS_EthIf_00214]. Als typischer Aufrufer wird beispielsweise ein Complex Device Driver (CDD) genannt [SWS_EthIf_00214]. Die Schnittstelle ist über die Header-Datei EthIf.h zugänglich und besitzt die Service-ID 0x2c [SWS_EthIf_00214].

Über den Eingangsparameter SwitchIdx wird der Index des Ziel-Switches im Kontext des Ethernet-Switch-Treibers übergeben [SWS_EthIf_00214]. Als Rückgabewert liefert die Funktion den Status Std_ReturnType: Der Wert E_OK zeigt an, dass die Speicheranforderung akzeptiert wurde, während E_NOT_OK die Nicht-Akzeptanz signalisiert [SWS_EthIf_00214]. Da die Spezifikation die Ausführung als synchron/asynchron kennzeichnet, dürfte die Entgegennahme der Anforderung synchron erfolgen, während die eigentliche Persistierung vermutlich asynchron in nachgelagerten Modulen abgewickelt wird. Frage Q-4f10e936c7d30258 (offen)

Einschränkungen und Fehlerbehandlung

Hinsichtlich der Nebenläufigkeit ist EthIf_StoreConfiguration als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_00214]. Parallele Aufrufe müssen daher aufruferseitig vermieden oder synchronisiert werden. Spezifische DET- oder DEM-Fehlermeldungen sind für diese Schnittstelle nicht definiert; ein Fehler bei der Auftragsannahme wird ausschließlich über den Rückgabewert E_NOT_OK gemeldet [SWS_EthIf_00214].

Verwendung und Aufrufkontext

Die Funktion EthIf_ResetConfiguration dient dazu, das persistente Zurücksetzen der dynamisch gelernten MAC- und Port-Tabellen eines Ethernet-Switches anzufordern [SWS_EthIf_00219]. Statisch konfigurierte Einträge verbleiben unverändert in der Konfiguration [SWS_EthIf_00219]. Als Aufrufer dieser Schnittstelle kann beispielsweise ein Complex Device Driver (CDD) fungieren [SWS_EthIf_00219].

Über den Übergabeparameter SwitchIdx wird der Index des betroffenen Switches im Kontext des Ethernet-Switch-Treibers angegeben [SWS_EthIf_00219]. Hinsichtlich der Ausführungssemantik ist die Operation als synchron/asynchron ausgewiesen [SWS_EthIf_00219]; dies dürfte bedeuten, dass die Entgegennahme der Anforderung synchron quittiert wird, während das Zurücksetzen der Hardwaretabellen asynchron abläuft. Frage Q-9e7f89ec9e809fd0 (offen)

Rückgabewerte und Fehlerbehandlung

Als Rückgabewert liefert die Funktion einen Status vom Typ Std_ReturnType [SWS_EthIf_00219]:

• E_OK: Die Anforderung zum persistenten Zurücksetzen der MAC-/Port-Tabelle wurde erfolgreich akzeptiert [SWS_EthIf_00219].
• E_NOT_OK: Die Anforderung wurde abgewiesen [SWS_EthIf_00219].

Spezifische DET- oder DEM-Fehlermeldungen sind im vorliegenden Spezifikationsumfang für diese Funktion nicht dokumentiert.

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_00219]. Aufrufer müssen daher sicherstellen, dass keine gleichzeitigen oder unterbrechenden Aufrufe erfolgen. Die Funktion ist über die Header-Datei EthIf.h eingebunden [SWS_EthIf_00219].

Die synchrone Funktion EthIf_EnableEgressTimeStamp dient der Aktivierung der Erfassung von Sendezeitstempeln (Egress Time Stamping) für ein dediziertes Nachrichtenobjekt bzw. einen Sendepuffer [SWS_EthIf_00160]. Die Schnittstelle wird über die Header-Datei EthIf.h bereitgestellt [SWS_EthIf_00160].

Parameter und Aufruf

Beim Aufruf erwartet die Funktion die Übergabe von zwei Eingangsparametern [SWS_EthIf_00160]:

• CtrlIdx: Index des adressierten Ethernet-Controllers [SWS_EthIf_00160].
• BufIdx: Index des Nachrichtenpuffers, an dem die Applikation die Erfassung des Sendezeitstempels erwartet [SWS_EthIf_00160].

Die Funktion besitzt keinen Rückgabewert (void) sowie keine Ein- oder Ausgangsparameter [SWS_EthIf_00160].

Hardware-Verhalten und Nebenläufigkeit

Das Verhalten der Hardware unterscheidet sich je nach Controller: Einige Hardware-Typen speichern die Markierung für den Sendezeitstempel dauerhaft nach einmaliger Konfiguration, während andere Controller diese zwingend vor jeder einzelnen Übertragung benötigen [SWS_EthIf_00160]. Interpretation: Auf Controllern ohne dauerhafte Speicherung dürfte die Funktion folglich vor jedem Sendevorgang durch die Anwendung erneut aufgerufen werden müssen. Frage Q-e87b424598f8a684 (offen) Eine Deaktivierungsmöglichkeit existiert spezifikationsgemäß nicht, da der entsprechende Nachrichtentyp nach dem Netzwerkentwurf dauerhaft zeitgestempelt wird [SWS_EthIf_00160].

Hinsichtlich der Nebenläufigkeit ist die Funktion als nicht reentrant (Non Reentrant) definiert [SWS_EthIf_00160].

Die asynchrone Funktion EthIf_SwitchPortGroupRequestMode fordert einen Betriebsmodus für eine Switch-Port-Gruppe an ([SWS_EthIf_91102]). Der Aufruf ist als nicht reentrant spezifiziert und übergibt den Index der Port-Gruppe (PortGroupIdx) sowie den gewünschten Zielmodus (PortMode). Als Modi stehen ETH_MODE_DOWN zur Deaktivierung, ETH_MODE_ACTIVE zur Aktivierung sowie ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST zur Aktivierung mit Netzwerkwakeup zur Verfügung ([SWS_EthIf_91102]). Bei erfolgreicher Initiierung liefert die Funktion E_OK zurück, andernfalls E_NOT_OK ([SWS_EthIf_91102]).

Grundsätzlich leitet EthIf die Anforderung an den darunterliegenden Switch weiter, indem für alle referenzierten Ports EthSwt_SetSwitchPortMode aufgerufen wird ([SWS_EthIf_91102]). Dabei gelten für die verschiedenen Modi spezifische Verhaltensregeln:

• Deaktivierung (ETH_MODE_DOWN): Befinden sich die Ports aktuell im Zustand ETH_MODE_ACTIVE und wurde für sämtliche die Ports referenzierenden Gruppen ETH_MODE_DOWN angefordert, startet EthIf einen Timer mit der Verzögerungszeit EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Aktivierung (ETH_MODE_ACTIVE oder ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): Ein laufender Abschaltverzögerungstimer für die Ports der jeweiligen Port-Gruppe wird unmittelbar abgebrochen ([SWS_EthIf_00483]).
• Wake-up-Anforderung (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): Der Aufruf wird unabhängig vom aktuellen Port-Modus für alle Ports der Gruppe zwingend in fester Reihenfolge weitergeleitet: Zuerst wird EthSwt_SetSwitchPortMode mit ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST aufgerufen, gefolgt von EthSwt_PortLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE, sofern der aktuelle Link-Zustand ETHTRCV_LINK_STATE_DOWN ist ([SWS_EthIf_00482]).

Spezifische DET- oder DEM-Fehlermeldungen sind für diesen Service nicht aufgeführt; das Scheitern einer Modusänderung wird direkt über den Rückgabewert E_NOT_OK angezeigt ([SWS_EthIf_91102]).

Die Funktion EthIf_StartAllPorts dient der Anforderung, alle konfigurierten und betroffenen Ethernet-Switch-Ports in den Zustand ETH_MODE_ACTIVE zu versetzen ([SWS_EthIf_91103]). Der Aufruf erfolgt parameterlos, besitzt eine asynchrone Semantik und ist als reentrant spezifiziert ([SWS_EthIf_91103]). Als Rückgabewert signalisiert E_OK die Annahme der Anforderung, während E_NOT_OK eine Ablehnung anzeigt ([SWS_EthIf_91103]).

Nach dem Aufruf von EthIf_StartAllPorts leitet EthIf die Steuerungsbefehle an alle betroffenen Ports der Ethernet-Switches (EthSwtPorts) in einer fest definierten Reihenfolge weiter ([SWS_EthIf_00275]):

• Zunächst wird EthSwt_SetSwitchPortMode mit ETH_MODE_ACTIVE aufgerufen, sofern der aktuelle Modus ETH_MODE_DOWN ist ([SWS_EthIf_00275]).
• Danach erfolgt der Aufruf von EthSwt_PortLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE, falls der aktuelle Link-Zustand ETHTRCV_LINK_STATE_DOWN ist, und für alle diese Ports wird ein Timer mit der Zeitspanne EthIfPortStartupActiveTime gestartet ([SWS_EthIf_00275]).

Wird ein auf diese Weise aktivierter Port nicht innerhalb der Zeitspanne EthIfPortStartupActiveTime regulär mit ETH_MODE_ACTIVE angefordert, deaktiviert EthIf diesen Port automatisch wieder ([SWS_EthIf_00276]). Die Deaktivierung erfolgt verbindlich in umgekehrter Reihenfolge:

• Zuerst wird EthSwt_PortLinkStateRequest mit ETHTRCV_LINK_STATE_DOWN aufgerufen ([SWS_EthIf_00276]).
• Anschließend wird EthSwt_SetSwitchPortMode mit ETH_MODE_DOWN aufgerufen ([SWS_EthIf_00276]).

Die Funktion EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) aktiviert die Erfassung von Egress-Zeitstempeln für ein spezifisches Nachrichtenobjekt auf Switch-Ebene. Das zugehörige Übertragungsobjekt wird über den Controller-Index CtrlIdx sowie den Puffer-Index BufIdx adressiert.

Aufruf und Parameter

Der Aufruf erfolgt synchron ([SWS_EthIf_91007]). Als Eingabeparameter erwartet die Funktion den Controller-Index CtrlIdx innerhalb des EthIf-Kontexts sowie BufIdx für den Nachrichtenpuffer, an dem die Applikation die Zeitstempelung erwartet. Über den Ausgabeparameter MgmtInfo vom Typ EthSwt_MgmtInfoType* werden zugehörige Management-Informationen bereitgestellt ([SWS_EthIf_91007]).

Rückgabewerte und Verhalten

Die Funktion signalisiert das Ergebnis über einen Rückgabewert vom Typ Std_ReturnType ([SWS_EthIf_91007]):

• E_OK: Das Egress-Time-Stamping wurde erfolgreich aktiviert ([SWS_EthIf_91007]).
• E_NOT_OK: Die Aktivierung der Zeitstempelung ist fehlgeschlagen ([SWS_EthIf_91007]).

Einschränkungen und Nebenläufigkeit

Die Schnittstelle ist als nicht reentrant (Non Reentrant) spezifiziert ([SWS_EthIf_91007]). Aufrufer müssen daher sicherstellen, dass parallele Aufrufe unterbunden werden. Die Deklaration wird über den Header EthIf.h bereitgestellt ([SWS_EthIf_91007]).

Die synchrone Schnittstellenfunktion EthIf_VerifyConfig dient der Überprüfung der Switch-Konfiguration und leitet den Aufruf direkt an EthSwt_VerifyConfig weiter [SWS_EthIf_91012]. Die eigentliche Verifikation wird vom Ethernet-Switch-Treiber in Abhängigkeit von der jeweiligen Hardware-Architektur, den Hardware-Fähigkeiten und der beabsichtigten Prüfgenauigkeit durchgeführt [SWS_EthIf_91012].

Verwendung und Parameter

Die Funktion ist über den Header EthIf.h mit der Service-ID 0x40 verfügbar und erwartet zwei Parameter [SWS_EthIf_91012]:

• SwitchIdx (in): Index des Switches im Kontext des Ethernet-Switch-Treibers.
• Result (out): Zeiger auf einen booleschen Wert, der das Verifikationsergebnis aufnimmt. TRUE kennzeichnet eine erfolgreich geprüfte Konfiguration, während FALSE auf erkannte Beschädigungen hinweist.

Als Rückgabewert meldet Std_ReturnType den Status der Ausführung: E_OK signalisiert, dass die Verifikation erfolgreich abgeschlossen wurde, während E_NOT_OK ein Fehlschlagen der Konfigurationsprüfung anzeigt [SWS_EthIf_91012].

Nebenläufigkeit und Fehlerbehandlung

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91012]. Aufrufer müssen daher sicherstellen, dass keine konkurrierenden Aufrufe stattfinden. Da der Payload keine spezifischen Fehlercodes für DET oder DEM aufführt, dürften detaillierte Parameterprüfungen (wie die Validierung von Indizes oder Zeigern) vermutlich treiberseitig oder implementationsspezifisch behandelt werden. Frage Q-03b5f343e97bec7f (offen)

Die synchrone Funktion EthIf_SetForwardingMode wird über den Header EthIf.h bereitgestellt und dient der Steuerung des Frame-Forwardings an einem Ethernet-Switch [SWS_EthIf_91013]. Sie verifiziert die aktuelle Switch-Konfiguration und führt bei erkannter Ungültigkeit eine Rekonfiguration des Switches durch [SWS_EthIf_91013].

Parameter und Rückgabewerte

Beim Aufruf (Service-ID 0x41) werden folgende Eingangsparameter übergeben [SWS_EthIf_91013]:

• SwitchIdx: Index des betreffenden Switches im Kontext des Ethernet-Switch-Treibers [SWS_EthIf_91013].
• mode: Boolescher Schalter zur Aktivierung (TRUE) oder Deaktivierung (FALSE) der Frame-Weiterleitung [SWS_EthIf_91013].

Als Rückgabewert liefert die Funktion Std_ReturnType [SWS_EthIf_91013]:

• E_OK: Signalisierte laut Spezifikation das erfolgreiche Stoppen der Weiterleitung; Interpretation: Dies dürfte allgemeiner die erfolgreiche Übernahme des angeforderten Weiterleitungsmodus bestätigen [SWS_EthIf_91013]. Frage Q-f245de852fe854c0 (offen)
• E_NOT_OK: Die Umschaltung bzw. das Stoppen der Frame-Weiterleitung ist fehlgeschlagen [SWS_EthIf_91013].

Nebenläufigkeit und Einschränkungen

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91013]. Aufrufer müssen daher sicherstellen, dass Aufrufe für denselben oder parallele Switch-Kontexte serialisiert erfolgen und keine konkurrierenden Aufrufe stattfinden. Spezifische Fehlercodes für DET oder DEM sind für diesen Dienst im Standard nicht definiert.

Die Funktion EthIf_ClearTrcvSignalQuality dient dem synchronen Löschen der gespeicherten Signalqualitätswerte einer Ethernet-Verbindung für einen bestimmten Transceiver [SWS_EthIf_91059]. Der Aufrufer übergibt dazu mit dem Parameter TrcvIdx den Index des Transceivers im Kontext des Ethernet Interface, woraufhin die entsprechenden Messwerte gelöscht werden [SWS_EthIf_00400].

Als Rückgabewert liefert die Schnittstelle den Typ Std_ReturnType: War das Zurücksetzen der Signalqualität erfolgreich, wird E_OK gemeldet, andernfalls schlägt der Vorgang mit E_NOT_OK fehl [SWS_EthIf_91059]. Interpretation: Der Fehlerwert E_NOT_OK dürfte vermutlich auf ungültige Indexparameter oder Fehler bei der Weiterleitung an unterlagerte Treiber zurückzuführen sein, da der Payload keine spezifischen Fehlercodes oder DET-Einträge nennt. Frage Q-40d8f0c1fc7ba11e (offen)

Hinsichtlich der Nebenläufigkeit ist der Dienst reentrant für unterschiedliche Transceiver-Indizes implementiert, jedoch explizit nicht reentrant für denselben TrcvIdx [SWS_EthIf_91059]. Mehrere Aufrufe für den identischen Transceiver dürfen daher nicht gleichzeitig aus nebenläufigen Kontexten erfolgen und müssen entsprechend abgesichert werden.

Im Modulzusammenspiel löscht der Aufruf gezielt die hinterlegten Signalqualitätswerte des Typs EthIf_SignalQualityResultType für den über TrcvIdx adressierten EthIfTransceiver [SWS_EthIf_00400]. Die Deklaration der synchronen Schnittstelle mit der Service-ID 0x19 wird über den Header EthIf.h bereitgestellt [SWS_EthIf_91059].

Verwendung

Die synchrone Funktion EthIf_ClearSwitchPortSignalQuality dient dem Zurücksetzen der gespeicherten Signalqualitätswerte für die Verbindung eines bestimmten Ethernet-Switch-Ports [SWS_EthIf_91060]. Die Adressierung des Zielports erfolgt über die beiden Eingangsparameter SwitchIdx (Index des Ethernet-Switches) und SwitchPortIdx (Index des Ports innerhalb des Interface-Kontexts) [SWS_EthIf_91060]. Die Funktion ist über die Header-Datei EthIf.h verfügbar [SWS_EthIf_91060].

Zusammenspiel und Datenstrukturen

Gemäß [SWS_EthIf_00404] löscht der Aufruf die intern vorgehaltenen Signalqualitätswerte des adressierten Switch-Ports, welche dem Typ EthIf_SignalQualityResultType entsprechen. Dies ermöglicht es übergeordneten Modulen, historische Messwerte gezielt zu verwerfen und eine Neubewertung der Verbindungsqualität zu initiieren.

Fehlerbehandlung

Der Erfolg der Operation wird über den Rückgabewert vom Typ Std_ReturnType angezeigt: Bei erfolgreichem Löschen liefert die Funktion E_OK, andernfalls E_NOT_OK [SWS_EthIf_91060]. Spezifische DET- oder DEM-Fehlercodes sind im Payload nicht definiert. Interpretation: Der Rückgabewert E_NOT_OK dürfte insbesondere dann auftreten, wenn ungültige Indizes übergeben werden oder der zugrundeliegende Switch-Treiber das Zurücksetzen nicht ausführen kann. Frage Q-fc42f5b3e5414f6a (offen)

Nebenläufigkeit und Einschränkungen

Hinsichtlich der Reentranz ist EthIf_ClearSwitchPortSignalQuality reentrant für unterschiedliche Switch- und Switch-Port-Indizes [SWS_EthIf_91060]. Für denselben Switch-Port (SwitchPortIdx) ist die Funktion jedoch als nicht reentrant spezifiziert [SWS_EthIf_91060]. Aufrufer müssen daher sicherstellen, dass zeitgleiche Aufrufe für denselben Port vermieden oder durch geeignete Synchronisationsmechanismen geschützt werden.

Die synchrone Schnittstellenfunktion EthIf_SetPhyTestMode dient der Aktivierung eines vorgegebenen Testmodus an einem Ethernet-Transceiver [SWS_EthIf_91016]. Der Dienst ist in der Header-Datei EthIf.h deklariert und über die hexadezimale Service-ID 0x17 identifizierbar [SWS_EthIf_91016].

Für den Aufruf erwartet die Funktion die Übergabe von zwei Eingangsparametern [SWS_EthIf_91016]:

• TrcvIdx: Bestimmt den numerischen Index des Ziel-Transceivers im Kontext des Ethernet Interface [SWS_EthIf_91016].
• Mode: Definiert den konkreten, zu aktivierenden Testmodus vom Typ EthTrcv_PhyTestModeType [SWS_EthIf_91016].

Ein- und Ausgabeparameter existieren nicht [SWS_EthIf_91016]. Als Rückgabewert liefert der Dienst einen Status vom Typ Std_ReturnType [SWS_EthIf_91016]. Der Rückgabewert E_OK bestätigt, dass die Anforderung zur Testmodus-Aktivierung erfolgreich akzeptiert wurde [SWS_EthIf_91016]. Der Wert E_NOT_OK zeigt hingegen an, dass die Anforderung abgewiesen wurde und der Testmodus nicht aktiviert werden konnte [SWS_EthIf_91016].

Hinsichtlich der Nebenläufigkeit ist EthIf_SetPhyTestMode reentrant für unterschiedliche Transceiver-Indizes (TrcvIdx) spezifiziert [SWS_EthIf_91016]. Für denselben Transceiver-Index ist die Ausführung explizit nicht reentrant [SWS_EthIf_91016]. Aufrufer müssen daher sicherstellen, dass konkurrierende Aufrufe für dieselbe Transceiver-Instanz vermieden und stattdessen sequenziell koordiniert werden.

Verwendung

Die synchrone Funktion EthIf_SetPhyLoopbackMode dient der Aktivierung eines spezifizierten Loopback-Modus an einem Ethernet-Transceiver [SWS_EthIf_91018]. Die Deklaration ist über die Header-Datei EthIf.h verfügbar [SWS_EthIf_91018].

Beim Aufruf erwartet die Funktion zwei Eingangsparameter:

• TrcvIdx: Index des Transceivers im Kontext des Ethernet Interface [SWS_EthIf_91018].
• Mode: Der zu aktivierende Loopback-Modus vom Typ EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

Als Rückgabewert liefert die Funktion einen Status vom Typ Std_ReturnType: E_OK signalisiert, dass die Anforderung akzeptiert wurde, während E_NOT_OK anzeigt, dass die Anforderung nicht akzeptiert werden konnte [SWS_EthIf_91018]. Interpretation: Die Funktion dürfte den Aufruf synchron an den für TrcvIdx zuständigen Ethernet-Transceiver-Treiber weiterleiten. Frage Q-c4736bbfd250cca0 (offen)

Fehlerbehandlung

Spezifische Fehlercodes wie DET-Meldungen oder DEM-Ereignisse sind im Spezifikationsauszug nicht definiert. Schlägt die Annahme der Anforderung fehl, wird dies dem Aufrufer unmittelbar über den Rückgabewert E_NOT_OK mitgeteilt [SWS_EthIf_91018]. Aufrufer müssen diesen Rückgabewert prüfen, bevor nachfolgende Test- oder Diagnoseabläufe fortgeführt werden.

Nebenläufigkeit und Einschränkungen

Die Funktion ist reentrant für unterschiedliche Transceiver-Indizes (TrcvIdx), jedoch explizit nicht reentrant für denselben Transceiver-Index [SWS_EthIf_91018]. Aufrufer müssen daher sicherstellen, dass zeitgleiche Aufrufe für dieselbe Transceiver-Instanz vermieden oder durch geeignete Synchronisationsmechanismen abgesichert werden [SWS_EthIf_91018].

Die synchrone Schnittstellenfunktion EthIf_SetPhyTxMode dient der Aktivierung eines spezifizierten Übertragungsmodus für einen Ethernet-Transceiver [SWS_EthIf_91005]. Die Deklaration der Funktion erfolgt in der Header-Datei EthIf.h unter der Service-ID 0x13 [SWS_EthIf_91005].

Für den Aufruf erwartet die Funktion zwei Eingangsparameter [SWS_EthIf_91005]:

• TrcvIdx: Numerischer Index des betreffenden Transceivers im Kontext der Ethernet-Schnittstelle.
• Mode: Der konkret zu aktivierende Sendemodus vom Typ EthTrcv_PhyTxModeType.

Die Ausführung erfolgt synchron. Als Rückgabewert liefert die Funktion einen Status vom Typ Std_ReturnType [SWS_EthIf_91005]. Der Wert E_OK bestätigt die erfolgreiche Annahme der Anforderung, während E_NOT_OK signalisiert, dass die Anforderung nicht akzeptiert werden konnte [SWS_EthIf_91005]. Spezifische Fehlercodes oder Benachrichtigungen an das Entwicklungsfehler- (DET) oder Diagnose-Event-Management (DEM) sind in den Spezifikationsdaten nicht ausgewiesen.

Hinsichtlich des Nebenläufigkeitsverhaltens ist EthIf_SetPhyTxMode reentrant für unterschiedliche Transceiver-Indizes (TrcvIdx) [SWS_EthIf_91005]. Werden jedoch Aufrufe für denselben Transceiver-Index abgesetzt, ist die Funktion als nicht reentrant definiert und erfordert einen synchronisierten bzw. sequenziellen Aufruf [SWS_EthIf_91005].

Als formale Einschränkung ist zu beachten, dass dieses Schnittstellenelement in der Spezifikation AUTOSAR CP R20-11 mit dem Status draft markiert ist [SWS_EthIf_91005].

Die synchrone und reentrante Funktion EthIf_ProvideTxBuffer (Service-ID 0x09) gewährt Zugriff auf einen Sendepuffer des über CtrlIdx angegebenen Ethernet-Controllers und ist über den Header EthIf.h verfügbar [SWS_EthIf_00067].

Zur Pufferanforderung übergibt der Aufrufer den Controller-Index (CtrlIdx), den Ethernet-Frame-Typ (FrameType) sowie die Priorität (Priority) für das 3-Bit-PCP-Feld des VLAN-Tags [SWS_EthIf_00067]. Über den Ein- und Ausgabeparameter LenBytePtr spezifiziert der Aufrufer die gewünschte Puffergröße in Bytes und erhält die tatsächlich bereitgestellte Länge zurück [SWS_EthIf_00067]. Bei erfolgreicher Zuweisung stellt die Funktion über BufPtr einen Zeiger auf den Puffer und über BufIdxPtr den Index der Pufferressource für nachfolgende Anfragen bereit [SWS_EthIf_00067].

Das Ergebnis der Pufferanforderung wird über den Rückgabetyp BufReq_ReturnType gemeldet [SWS_EthIf_00067]:

• BUFREQ_OK: Der Puffer wurde erfolgreich bereitgestellt [SWS_EthIf_00067].
• BUFREQ_E_BUSY: Alle Pufferressourcen sind derzeit belegt [SWS_EthIf_00067].
• BUFREQ_E_OVFL: Die angeforderte Pufferlänge übersteigt die verfügbare Größe [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK: Ein Entwicklungsfehler wurde erkannt [SWS_EthIf_00067].

Die synchrone Funktion EthIf_Transmit löst die Übertragung eines zuvor bereitgestellten und befüllten Sendepuffers über die Ethernet-Schnittstelle aus [SWS_EthIf_00075].

Verwendung und Parameter

Der Aufruf erfolgt über die in EthIf.h deklarierte Schnittstelle mit folgenden Übergabeparametern [SWS_EthIf_00075]:

• CtrlIdx: Index des Ethernet-Controllers im Kontext des Moduls EthIf.
• BufIdx: Index der zu übertragenden Pufferressource.
• FrameType: Ethernet-Frame-Typ.
• TxConfirmation: Steuert die Aktivierung der Sendebestätigung.
• LenByte: Datenlänge in Byte.
• PhysAddrPtr: Physische Zieladresse (MAC-Adresse) in Netzwerk-Byte-Reihenfolge.

Rückgabewerte und Nebenläufigkeit

Als Rückgabewert liefert die Funktion E_OK bei erfolgreicher Auslösung der Übertragung oder E_NOT_OK, falls die Übertragung fehlgeschlagen ist [SWS_EthIf_00075]. Die Funktion ist reentrant für Aufrufe mit unterschiedlichen Puffer- und Controller-Indizes (BufIdx und CtrlIdx) [SWS_EthIf_00075].

Die Funktion EthIf_SwitchPortGetLinkState dient gemäß [SWS_EthIf_91109] dazu, den aktuellen Verbindungsstatus eines bestimmten Switch-Ports abzufragen. Übergeben werden der Switch-Index SwitchIdx im Kontext des Ethernet-Switch-Treibers sowie der Port-Index SwitchPortIdx am adressierten Switch. Das Abfrageergebnis wird über den Zeiger LinkStatePtr bereitgestellt, der entweder ETHTRCV_LINK_STATE_DOWN (Port getrennt) oder ETHTRCV_LINK_STATE_ACTIVE (Port verbunden) annimmt. Die Spezifikation weist das Ausführungsverhalten als synchron oder asynchron aus; dies dürfte vermutlich vom zugrunde liegenden Switch-Treiber beziehungsweise der Hardware-Anbindung abhängen. Frage Q-dde6f9e8f1b8ba52 (offen)

Als Rückgabewert liefert die Funktion Std_ReturnType ([SWS_EthIf_91109]). Bei erfolgreicher Abfrage wird E_OK zurückgegeben. Schlägt die Ermittlung des Verbindungsstatus fehl oder wird die Funktion aufgerufen, während sich der Switch im Zustand ETHSWT_STATE_UNINIT oder ETHSWT_STATE_INIT befindet, erfolgt die Rückgabe von E_NOT_OK.

Hinsichtlich der Nebenläufigkeit ist die Funktion als nicht reentrant (Non Reentrant) spezifiziert ([SWS_EthIf_91109]), weshalb gleichzeitige Aufrufe im selben Kontext ausgeschlossen werden müssen. Die Deklaration ist über den Header EthIf.h mit der Service-ID 0x4b verfügbar.

Verwendung

Die synchrone Funktion EthIf_TransceiverGetLinkState dient dem Abfragen des aktuellen Verbindungsstatus (Link State) eines über TrcvIdx adressierten Ethernet-Transceivers gemäß [SWS_EthIf_91110]. Die Deklaration der Schnittstelle wird über den Header EthIf.h zur Verfügung gestellt [SWS_EthIf_91110].

Beim Aufruf werden folgende Parameter übergeben [SWS_EthIf_91110]:

• TrcvIdx (Eingabe): Index des Transceivers im Kontext des Ethernet Transceiver Drivers.
• LinkStatePtr (Ausgabe): Zeiger auf den Speicherort für den ermittelten Zustand vom Typ EthTrcv_LinkStateType. Mögliche Ergebniswerte sind ETHTRCV_LINK_STATE_ACTIVE für einen verbundenen sowie ETHTRCV_LINK_STATE_DOWN für einen getrennten Transceiver.

Als Rückgabewert liefert die Funktion den Statuscode vom Typ Std_ReturnType: E_OK signalisiert eine erfolgreiche Durchführung, während E_NOT_OK anzeigt, dass der Transceiver nicht initialisiert werden konnte [SWS_EthIf_91110].

Fehlerbehandlung und Randbedingungen

Schlägt die Abfrage fehl, liefert der Dienst mit der Service-ID 0x4c den Rückgabewert E_NOT_OK [SWS_EthIf_91110]. Spezifische DET- oder DEM-Fehlermeldungen sind in der Funktionsspezifikation nicht aufgeführt.

Nebenläufigkeit

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91110]. Interpretation: Aufgrund der fehlenden Reentranz dürfte ein gleichzeitiger Aufruf aus mehreren Threads oder Taskkontexten unzulässig sein und erfordert bei Bedarf eine aufruferseitige Synchronisation. Frage Q-0459aa9b4c187439 (offen)

Die Funktion EthIf_SwitchPortGetBaudRate dient dem Abfragen der aktuellen Übertragungsgeschwindigkeit eines bestimmten Ethernet-Switch-Ports gemäß [SWS_EthIf_91111]. Beim Aufruf werden der Index des Switches (SwitchIdx) sowie der Index des Ports am adressierten Switch (SwitchPortIdx) übergeben. Das Abfrageergebnis wird über den Zeiger BaudRatePtr vom Typ EthTrcv_BaudRateType* bereitgestellt, der Geschwindigkeiten wie ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT oder ETHTRCV_BAUD_RATE_2500MBIT abbilden kann [SWS_EthIf_91111].

Hinsichtlich des Fehlerverhaltens liefert die Funktion E_OK bei erfolgreicher Ermittlung der Baudrate zurück. Ein Rückgabewert von E_NOT_OK signalisiert, dass die Baudrate für den angegebenen Switch-Port nicht ausgelesen werden konnte oder dass sich der Switch-Treiber im Zustand ETHSWT_STATE_UNINIT bzw. ETHSWT_STATE_INIT befindet [SWS_EthIf_91111].

Die Spezifikation weist die Funktion als nicht reentrant (Non Reentrant) sowie als synchron/asynchron aus [SWS_EthIf_91111]. Vermutlich hängt das synchrone oder asynchrone Verhalten von der Anbindung und Implementierung des zugrunde liegenden Ethernet-Switch-Treibers ab. Frage Q-1f4d760ff944df9d (offen) Aufgrund der fehlenden Reentranz müssen Aufrufer sicherstellen, dass parallele Aufrufe der Schnittstelle vermieden werden.

Die synchrone Funktion EthIf_TransceiverGetBaudRate mit der Service-ID 0x4e dient dem Auslesen der aktuellen Übertragungsrate eines indizierten Ethernet-Transceivers [SWS_EthIf_91112]. Sie ist Bestandteil des Moduls EthIf und wird über die Header-Datei EthIf.h zur Verfügung gestellt [SWS_EthIf_91112].

Der Eingangsparameter TrcvIdx vom Typ uint8 identifiziert den Transceiver im Kontext des Ethernet-Transceiver-Treibers [SWS_EthIf_91112]. Inout-Parameter existieren nicht [SWS_EthIf_91112]. Das Ergebnis der Abfrage wird über den Ausgabeparameter BaudRatePtr zurückgegeben [SWS_EthIf_91112]. Gültige Werte des Typs Eth_Trcv_BaudRateType sind ETHTRCV_BAUD_RATE_10MBIT (10 MBit/s), ETHTRCV_BAUD_RATE_100MBIT (100 MBit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 MBit/s) sowie ETHTRCV_BAUD_RATE_2500MBIT (2500 MBit/s) [SWS_EthIf_91112].

Die Funktion liefert einen Status vom Typ Std_ReturnType zurück: Bei erfolgreichem Aufruf wird E_OK übergeben [SWS_EthIf_91112]. Konnte der Transceiver nicht initialisiert werden, schlägt der Dienst fehl und meldet E_NOT_OK [SWS_EthIf_91112].

Hinsichtlich des Aufrufkontexts und der Nebenläufigkeit ist EthIf_TransceiverGetBaudRate als synchrone und nicht reentrante (Non Reentrant) Schnittstelle definiert [SWS_EthIf_91112]. Aufrufende Schichten müssen sicherstellen, dass konkurrierende Aufrufe für diesen Dienst vermieden oder auf Aufruferebene serialisiert werden [SWS_EthIf_91112].

Die Funktion EthIf_SwitchPortGetDuplexMode dient dem Abfragen des aktuellen Duplex-Modus eines indizierten Ports an einem Ethernet-Switch [SWS_EthIf_91113]. Sie leitet den Aufruf an die Funktion EthSwt_GetDuplexMode des über SwitchIdx zugeordneten Ethernet-Switch-Treibers weiter [SWS_EthIf_00428].

Parameter und Schnittstelle

• SwitchIdx: Index des Ethernet-Switches im Kontext des Treibers [SWS_EthIf_91113].
• SwitchPortIdx: Index des betreffenden Ports am adressierten Switch [SWS_EthIf_91113].
• DuplexModePtr: Ausgabepointer vom Typ EthTrcv_DuplexModeType* für den ermittelten Modus, entweder ETHTRCV_DUPLEX_MODE_HALF (Halbduplex) oder ETHTRCV_DUPLEXMODE_FULL (Vollduplex) [SWS_EthIf_91113].

Ausführung und Fehlerbehandlung

Der Rückgabewert E_OK signalisiert eine erfolgreiche Abfrage [SWS_EthIf_91113]. Kann der Duplex-Modus des Ports nicht ermittelt werden oder befindet sich der Treiber in den Zuständen ETHSWT_STATE_UNINIT bzw. ETHSWT_STATE_INIT, gibt die Funktion E_NOT_OK zurück [SWS_EthIf_91113].

Die Schnittstelle ist nicht reentrant (Non Reentrant) und in der Spezifikation als synchron/asynchron deklariert [SWS_EthIf_91113]. Interpretation: Die tatsächliche synchrone oder asynchrone Arbeitsweise dürfte von den Eigenschaften des angebundenen Switch-Treibers abhängen. Frage Q-339413722431978f (offen)

Die synchrone Funktion EthIf_TransceiverGetDuplexMode ermittelt den aktuellen Duplex-Modus eines indizierten Ethernet-Transceivers gemäß [SWS_EthIf_91114].

Verwendung und Parameter

Der Aufruf erfolgt synchron und ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91114]:

• TrcvIdx: Übergibt als Eingabeparameter den Index des Transceivers im Kontext des Ethernet-Transceiver-Treibers [SWS_EthIf_91114].
• DuplexModePtr: Dient als Ausgabepointer auf den Typ EthTrcv_DuplexModeType zur Aufnahme des Ergebnisses. Mögliche Werte sind ETHTRCV_DUPLEX_MODE_HALF (Halbduplex) oder ETHTRCV_DUPLEX_MODE_FULL (Vollduplex) [SWS_EthIf_91114].

Rückgabewerte und Fehlerbehandlung

Als Rückgabewert liefert die Funktion einen Std_ReturnType [SWS_EthIf_91114]:

• E_OK: Der Duplex-Modus wurde erfolgreich abgefragt und über DuplexModePtr bereitgestellt [SWS_EthIf_91114].
• E_NOT_OK: Die Ermittlung schlug fehl, laut Spezifikation beispielsweise wenn der Transceiver nicht initialisiert werden konnte [SWS_EthIf_91114].

Einschränkungen und Nebenläufigkeit

Da die Schnittstelle nicht reentrant ist, dürfen parallele Aufrufe für denselben oder verschiedene Transceiver-Instanzen ohne externe Synchronisation nicht erfolgen. Die Deklaration ist über den Header EthIf.h verfügbar [SWS_EthIf_91114].

Die synchrone Funktion EthIf_SwitchPortGetCounterValues dient dem Auslesen von Zählerwerten (Drop Counter) eines bestimmten Ethernet-Switch-Ports gemäß [SWS_EthIf_91115]. Über den Header EthIf.h bereitgestellt, nimmt die Funktion den Switch-Index SwitchIdx sowie den Port-Index SwitchPortIdx entgegen und schreibt die Zählerwerte über den Zeiger CounterPtr zurück ([SWS_EthIf_91115]).

Funktionsweise und Weiterleitung

Gemäß [SWS_EthIf_00432] leitet EthIf_SwitchPortGetCounterValues die Anfrage unmittelbar an die Funktion EthSwt_GetCounterValues des jeweiligen Ethernet-Switch-Treibers weiter. Die zurückgegebenen Zählerwerte orientieren sich an den Standards IETF RFC 1757, RFC 1643 und RFC 2233, wobei die genaue semantische Bedeutung der Struktur Eth_CounterType zugeordnet ist ([SWS_EthIf_91115]).

Rückgabewerte und Fehlerbehandlung

Als Rückgabewert liefert die Funktion Std_ReturnType ([SWS_EthIf_91115]):

• E_OK: Das Auslesen der Zählerwerte war erfolgreich ([SWS_EthIf_91115]).
• E_NOT_OK: Beim Lesen der Zählerwerte ist ein Fehler aufgetreten ([SWS_EthIf_91115]).

Nebenläufigkeit und Einschränkungen

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert ([SWS_EthIf_91115]). Nebenläufige Aufrufe müssen daher auf Aufruferebene synchronisiert werden. Interpretation: Der Aufrufer dürfte zudem für die Bereitstellung eines gültigen und ausreichend dimensionierten Speicherbereichs für CounterPtr verantwortlich sein, da die Spezifikation keine interne Pufferallokation erwähnt. Frage Q-140661eaa9693cce (offen)

Verwendung und Semantik

Die Funktion EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) dient dem Abfragen von Empfangsstatistik-Zählern für einen Port eines Ethernet-Switches. Sie ist über den Header EthIf.h verfügbar und wird unter der Service-ID 0x52 geführt ([SWS_EthIf_91116]).

Der Aufruf erfordert folgende Parameter ([SWS_EthIf_91116]):

• SwitchIdx: Index des Ethernet-Switches im Kontext des Ethernet-Switch-Treibers.
• SwitchPortIdx: Index des Ports am adressierten Switch.
• RxStatsPtr: Zeiger auf eine Struktur vom Typ Eth_RxStatsType, in die die Zählerwerte geschrieben werden. Der Großteil dieser Werte ist aus IETF RFC 2819 (Remote Network Monitoring Management Information Base) abgeleitet.

Rückgabewerte und Fehlerbehandlung

Die Funktion liefert als Ergebnis einen Std_ReturnType ([SWS_EthIf_91116]):

• E_OK: Die Statistikdaten wurden erfolgreich ausgelesen.
• E_NOT_OK: Die Zählerwerte konnten nicht ermittelt werden ([SWS_EthIf_91116]). Spezifische DET- oder DEM-Fehlermeldungen sind für diesen Aufruf nicht spezifiziert.

Nebenläufigkeit und Einschränkungen

Die Funktion ist als nicht reentrant (Non Reentrant) klassifiziert ([SWS_EthIf_91116]). Da die Synchronizität mit „Synchronous /Asynchronous“ angegeben ist, dürfte das tatsächliche Blockierverhalten von der Implementierung des zugrunde liegenden Ethernet-Switch-Treibers abhängen ([SWS_EthIf_91116]). Frage Q-d1e839075bf42e7f (offen) Aufrufer müssen parallele Zugriffe auf dieselbe Schnittstelle vermeiden.

Die Funktion EthIf_SwitchPortGetTxStats dient dem Auslesen von Übertragungsstatistiken gemäß IETF RFC1213 für einen bestimmten Port eines Ethernet-Switches [SWS_EthIf_91117]. Sie ist über die Header-Datei EthIf.h mit der Service-ID 0x53 verfügbar [SWS_EthIf_91117].

Verwendung und Parameter

Beim Aufruf werden der Switch-Index (SwitchIdx) und der Port-Index am adressierten Switch (SwitchPortIdx) als Eingangsparameter übergeben [SWS_EthIf_91117]. Die ermittelten Zählerstände werden über den Zeiger TxStatsPtr vom Typ Eth_TxStatsType* bereitgestellt [SWS_EthIf_91117]. Sofern ein Zähler nicht verfügbar ist oder nicht unterstützt wird, signalisiert der maximal mögliche Wert des Zählers einen ungültigen Wert [SWS_EthIf_91117].

Rückgabewerte und Fehlerbehandlung

Die Funktion liefert einen Status vom Typ Std_ReturnType zurück [SWS_EthIf_91117]:

• E_OK: Die Übertragungsstatistiken wurden erfolgreich ermittelt [SWS_EthIf_91117].
• E_NOT_OK: Die Übertragungsstatistiken konnten nicht beschafft werden [SWS_EthIf_91117].

Spezifische Fehlercodes oder Meldungen an DET oder DEM sind in den Quellen nicht angegeben, sodass Fehlerfälle primär über den Rückgabewert E_NOT_OK abgefangen werden müssen [SWS_EthIf_91117].

Nebenläufigkeit und Einschränkungen

Gemäß Spezifikation ist EthIf_SwitchPortGetTxStats als asynchron (Asynchronous) und nicht reentrant (Non Reentrant) definiert [SWS_EthIf_91117]. Aufgrund der fehlenden Reentranz dürfen gleichzeitige Aufrufe nicht ohne übergeordnete Synchronisation erfolgen [SWS_EthIf_91117]. Da der Dienst als asynchron deklariert ist, dürfte der übergebene Puffer TxStatsPtr bis zum vollständigen Abschluss der Operation gültig gehalten werden müssen (Interpretation: Pufferstabilität bei asynchroner Abfrage) [SWS_EthIf_91117]. Frage Q-8a14618d6990206b (offen)

Die über EthIf.h bereitgestellte synchrone Funktion EthIf_SwitchPortGetTxErrorCounterValues (Service-ID 0x54) liest eine Liste von Übertragungsfehlerzählern für einen Port eines Ethernet-Switches aus [SWS_EthIf_91118]. Die Zähler entsprechen den Definitionen aus IETF RFC1213 sowie RFC1643 und werden über den Typ Eth_TxErrorCounterValuesType im Ausgabeparameter TxStatsPtr bereitgestellt [SWS_EthIf_91118].

Beim Aufruf adressiert SwitchIdx den Switch im Kontext des Treibers und SwitchPortIdx den konkreten Port am Schalter [SWS_EthIf_91118]. Die Funktion liefert E_OK bei erfolgreicher Ermittlung der Werte und E_NOTOK, falls die Übertragungsstatistiken nicht beschafft werden konnten [SWS_EthIf_91118]. Ein Zählerwert, der den maximal möglichen Wert annimmt, kennzeichnet dabei explizit einen ungültigen beziehungsweise nicht verfügbaren Zähler [SWS_EthIf_91118].

Als Einschränkung für die Ausführung ist festgelegt, dass die Funktion nicht reentrant (Non Reentrant) ist [SWS_EthIf_91118]. Im Architekturverbund leitet EthIf_SwitchPortGetTxErrorCounterValues den Aufruf direkt an die Funktion EthSwt_GetTxErrorCounterValues des entsprechenden Ethernet-Switch-Treibers weiter [SWS_EthIf_00438].

Die Funktion EthIf_SwitchPortGetMacLearningMode fragt den aktuellen MAC-Lernmodus für einen bestimmten Switch-Port ab ([SWS_EthIf_91119]). Zu den ermittelbaren Modi gehören Hardware-Lernen aktiviert, Hardware-Lernen deaktiviert sowie Software-Lernen aktiviert ([SWS_EthIf_91119]). Die Verfügbarkeit dieser Funktion ist hardwareabhängig, da die jeweilige Switch-Hardware die unterschiedlichen Lernmodi unterstützen muss ([SWS_EthIf_91119]).

Aufrufkontext und Parameter

Die Schnittstelle wird über den Header EthIf.h bereitgestellt und besitzt die Service-ID 0x55 ([SWS_EthIf_91119]). Beim Aufruf sind folgende Parameter zu übergeben:

• SwitchIdx (in): Index des Switches im Kontext des Ethernet-Switch-Treibers ([SWS_EthIf_91119]).
• SwitchPortIdx (in): Index des Ports am adressierten Switch ([SWS_EthIf_91119]).
• MacLearningModePtr (out): Zeiger auf den Speicherort vom Typ EthSwt_MacLearningType, an dem der ermittelte Modus abgelegt wird ([SWS_EthIf_91119]).

Synchronisation, Nebenläufigkeit und Rückgabewerte

Die Ausführung ist als synchron/asynchron spezifiziert und ist nicht reentrant (Non Reentrant) ([SWS_EthIf_91119]). Als Rückgabewert dient Std_ReturnType mit folgenden Status:

• E_OK: Abfrage erfolgreich durchgeführt ([SWS_EthIf_91119]).
• E_NOT_OK: Fehler bei der Ausführung ([SWS_EthIf_91119]). Die Spezifikationsbeschreibung zu E_NOT_OK nennt zwar wörtlich „configuration could be persistently reset“, Interpretation: dies dürfte ein redaktioneller Kopierfehler in der Spezifikation sein und im regulären Kontext schlicht das Scheitern der Abfrage signalisieren. Frage Q-7565d2fbd70e355d (offen)

Die synchrone Schnittstelle EthIf_WritePortMirrorConfiguration dient dem Speichern einer Port-Mirroring-Konfiguration in einem Shadow-Buffer innerhalb des Ethernet-Switch-Treibers [SWS_EthIf_91122].

Beim Aufruf werden folgende Eingangsparameter übergeben [SWS_EthIf_91122]:

• MirroredSwitchIdx: Index des betreffenden Switches im Kontext des Ethernet-Switch-Treibers, an dem sich der zu spiegelnde Switch-Port befindet [SWS_EthIf_91122].
• PortMirrorConfigurationPtr: Zeiger auf die Konfigurationsdaten der Struktur EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

Der Rückgabewert vom Typ Std_ReturnType signalisiert den Status der Ausführung [SWS_EthIf_91122]:

• E_OK: Die Port-Mirroring-Konfiguration wurde erfolgreich für den indizierten Port geschrieben [SWS_EthIf_91122].
• E_NOT_OK: Die Konfiguration konnte nicht geschrieben werden, etwa weil der indizierte Switch nicht verfügbar ist [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: Das Port-Mirroring wird durch die Switch-Hardware oder den Ethernet-Switch-Treiber nicht unterstützt [SWS_EthIf_91122].

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert und steht über den Header EthIf.h zur Verfügung [SWS_EthIf_91122]. Interpretation: Aufrufer dürften nebenläufige Zugriffe durch übergeordnete Mechanismen koordinieren müssen, da kein interner Synchronisationsschutz spezifiziert ist. Frage Q-c731aedd871251a4 (offen)

Verwendung und Semantik

Die Funktion EthIf_ReadPortMirrorConfiguration dient dazu, die Port-Mirroring-Konfiguration eines bestimmten Ethernet-Switches abzufragen [SWS_EthIf_91123]. Sie ist in der Header-Datei EthIf.h deklariert und besitzt die Service-ID 0x59. Das Ausführungsverhalten ist als asynchron (Asynchronous) spezifiziert, wobei der unmittelbare Aufruf einen Statuswert vom Typ Std_ReturnType zurückgibt [SWS_EthIf_91123].

Parameter und Rückgabewerte

• MirroredSwitchIdx (in): Index des Ethernet-Switches im Kontext des Ethernet-Switch-Treibers, auf dem sich die zu spiegelnden Switch-Ports befinden [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out): Zeiger auf den Speicherbereich, in dem die ausgelesene Konfiguration abgelegt werden soll [SWS_EthIf_91123].
• Rückgabewert: E_OK signalisiert das erfolgreiche Auslesen der Konfiguration. Im Fehlerfall wird E_NOT_OK zurückgegeben, beispielsweise wenn der indizierte Ethernet-Switch nicht verfügbar ist [SWS_EthIf_91123].

Zusammenspiel und Nebenläufigkeit

Zur Ausführung leitet EthIf_ReadPortMirrorConfiguration den Aufruf direkt an die Funktion EthSwt_ReadPortMirrorConfiguration des korrespondierenden Ethernet-Switch-Treibers weiter [SWS_EthIf_00448]. Die Funktion ist als nicht reentrant (Non Reentrant) definiert [SWS_EthIf_91123]; parallele Aufrufe für dieselbe Schnittstelle müssen daher vom Aufrufer vermieden werden.

Die synchrone Funktion EthIf_DeletePortMirrorConfiguration dient dem Löschen einer gespeicherten Port-Mirror-Konfiguration für einen bestimmten Switch ([SWS_EthIf_91124]). Der Aufrufer übergibt über den Parameter Mirrored Switch Idx den Index des Switches im Kontext des Ethernet Switch Drivers ([SWS_EthIf_91124]). Die Schnittstelle besitzt die Service-ID 0x5a und wird über die Header-Datei EthIf.h bereitgestellt ([SWS_EthIf_91124]).

Der Rückgabewert vom Typ Std_ReturnType informiert über das Ergebnis der Löschung ([SWS_EthIf_91124]):

• E_OK: Die Port-Mirror-Konfiguration wurde erfolgreich gelöscht ([SWS_EthIf_91124]). Wurde für den angegebenen Switch-Index keine gespeicherte Konfiguration gefunden, liefert die Funktion definitionsgemäß ebenfalls E_OK zurück ([SWS_EthIf_91124]).
• E_NOT_OK: Das Löschen der Konfiguration ist fehlgeschlagen ([SWS_EthIf_91124]). Dies ist beispielsweise der Fall, wenn die Port-Spiegelung zum Zeitpunkt des Aufrufs noch aktiviert ist ([SWS_EthIf_91124]).

Bezüglich der Nebenläufigkeit ist die Funktion reentrant für unterschiedliche Switch-Indizes (Mirrored Switch Idx), jedoch nicht reentrant bei mehrfachen Aufrufen für denselben Index ([SWS_EthIf_91124]). Da ein aktives Mirroring explizit als Fehlerursache für E_NOT_OK genannt wird, dürfte das Port-Mirroring vor dem Löschen der Konfiguration deaktiviert werden müssen ([SWS_EthIf_91124]). Frage Q-b9e5665de687dbba (offen)

Die synchrone Funktion EthIf_SetPortMirrorState dient dazu, den geforderten Zustand der Port-Mirroring-Konfiguration für einen angegebenen Ethernet-Switch zu setzen ([SWS_EthIf_91126]). Sie ist über die Header-Datei EthIf.h verfügbar ([SWS_EthIf_91126]).

Die Funktion erwartet beim Aufruf drei Parameter ([SWS_EthIf_91126]):

• MirroredSwitchIdx: Index des Ethernet-Switches im Kontext des Ethernet Switch Drivers, an dem sich die zu aktivierende bzw. zu deaktivierende Port-Mirroring-Konfiguration befindet.
• PortIdx: Index des Ports am adressierten Ethernet-Switch.
• PortMirrorState: Der anzufordernde Zustand der Portspiegelung, entweder PORT_MIRRORING_ENABLED oder PORT_MIRRORING_DISABLED.

Der Rückgabewert vom Typ Std_ReturnType signalisiert das Ergebnis der Anforderung ([SWS_EthIf_91126]):

• E_OK: Der angeforderte Zustand für den angegebenen Switch-Port wurde erfolgreich gesetzt.
• E_NOT_OK: Das Setzen ist fehlgeschlagen, beispielsweise wenn der adressierte Switch nicht verfügbar ist oder keine Port-Mirroring-Konfiguration vorliegt.

Die Ausführung erfolgt synchron und ist als nicht reentrant (Non Reentrant) spezifiziert ([SWS_EthIf_91126]). Im Schichtenverbund übernimmt das Ethernet Interface die Weiterleitung: Gemäß [SWS_EthIf_00454] leitet EthIf_SetPortMirrorState den Aufruf direkt an die Funktion EthSwt_SetPortMirrorState des zuständigen Ethernet Switch Drivers weiter.

Die Funktion EthIf_SetPortTestMode dient der Aktivierung eines vorgegebenen Testmodus an einem indizierten Port eines Ethernet-Switches [SWS_EthIf_91127]. Der synchrone Dienst ist über den Header EthIf.h mit der Service-ID 0x5d verfügbar [SWS_EthIf_91127].

Parameter und Rückgabewerte

Zur Konfiguration des Testmodus erwartet die Schnittstelle drei Eingabeparameter, während keine Ein-/Ausgabe- oder reinen Ausgabeparameter existieren [SWS_EthIf_91127]:

• SwitchIdx (uint8): Index des Switches im Kontext des jeweiligen Ethernet-Switch-Treibers [SWS_EthIf_91127].
• PortIdx (uint8): Index des Ports an dem adressierten Ethernet-Switch [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType): Der an dem Switch-Port zu aktivierende Testmodus [SWS_EthIf_91127].

Der Rückgabewert vom Typ Std_ReturnType signalisiert den Erfolg der Operation [SWS_EthIf_91127]:

• E_OK: Der Port-Testmodus für den indizierten Ethernet-Switch-Port wurde erfolgreich gesetzt [SWS_EthIf_91127].
• E_NOT_OK: Das Setzen des Port-Testmodus war nicht erfolgreich, beispielsweise wenn der adressierte Ethernet-Switch-Port nicht verfügbar ist [SWS_EthIf_91127].

Nebenläufigkeit und Zusammenspiel

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert und arbeitet synchron [SWS_EthIf_91127]. Beim Aufruf leitet EthIf_SetPortTestMode die Anforderung direkt an die unterlagerte Funktion EthSwt_SetPortTestMode des korrespondierenden Ethernet-Switch-Treibers weiter [SWS_EthIf_00456].

Verwendung

Die Funktion EthIf_SetPortLoopbackMode dient dazu, einen vorgegebenen Test-Loopback-Modus für einen indizierten Port eines Ethernet-Switches zu aktivieren [SWS_EthIf_91128]. Die Deklaration wird über die Header-Datei EthIf.h bereitgestellt [SWS_EthIf_91128]. Beim Aufruf werden folgende Eingangsparameter übergeben:

• SwitchIdx: Index des Ethernet-Switches innerhalb des Kontexts des Ethernet-Switch-Treibers [SWS_EthIf_91128].
• PortIdx: Index des betroffenen Ports am zuvor adressierten Switch [SWS_EthIf_91128].
• Mode: Zu aktivierender Loopback-Modus vom Typ EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Zusammenspiel und Weiterleitung

Die Funktion führt die Konfiguration nicht selbstständig auf Hardwareebene durch. Stattdessen leitet EthIf_SetPortLoopbackMode den Aufruf direkt an die Funktion EthSwt_SetPortLoopbackMode des zugehörigen Ethernet-Switch-Treibers weiter [SWS_EthIf_00458].

Fehlerbehandlung und Rückgabewerte

Der Rückgabewert ist vom Typ Std_ReturnType [SWS_EthIf_91128]:

• E_OK: Der Loopback-Modus wurde für den indizierten Port des Ethernet-Switches erfolgreich aktiviert [SWS_EthIf_91128].
• E_NOT_OK: Die Aktivierung schlug fehl, beispielsweise wenn der indizierte Ethernet-Switch-Port nicht verfügbar ist [SWS_EthIf_91128].

Spezifische Fehlercodes für DET oder DEM werden in der Spezifikation für diesen Dienst nicht aufgeführt.

Nebenläufigkeit und Einschränkungen

Die Ausführung erfolgt vollständig synchron, und die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91128]. Parallele Aufrufe müssen durch den Aufrufer unterbunden werden. Interpretation: Da es sich um das Schalten von Testmodi handelt, dürfte der Aufruf typischerweise im Rahmen von Initialisierungs-, Test- oder Diagnosesequenzen auf Task-Ebene erfolgen. Frage Q-cb4575c4a1d9c48b (offen)

Die synchrone Funktion EthIf_SetPortTxMode aktiviert einen vorgegebenen Übertragungsmodus für einen indizierten Ethernet-Switch-Port [SWS_EthIf_91129]. Sie ist über die Header-Datei EthIf.h verfügbar und besitzt die Service-ID 0x5f [SWS_EthIf_91129].

Verwendung

Der Aufruf adressiert den Zielport über zwei Indizes und übergibt den gewünschten Modus [SWS_EthIf_91129]:

• SwitchIdx: Index des Switches innerhalb des Kontexts des Ethernet-Switch-Treibers.
• PortIdx: Index des Ports am adressierten Switch.
• Mode: Zu aktivierender Übertragungsmodus vom Typ EthTrcv_PhyTxModeType.

Als Rückgabewert liefert die Funktion Std_ReturnType [SWS_EthIf_91129]:

• E_OK: Der Übertragungsmodus für den indizierten Switch-Port wurde erfolgreich aktiviert.
• E_NOT_OK: Die Aktivierung schlug fehl, beispielsweise wenn der indizierte Switch-Port nicht verfügbar ist.

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91129]. Aufrufende Instanzen müssen daher sicherstellen, dass keine konkurrierenden Aufrufe stattfinden. Spezifische DET- oder DEM-Fehlermeldungen sind in der Funktionsdefinition nicht aufgeführt; das Fehlerverhalten beschränkt sich laut Spezifikation auf die Rückgabe von E_NOT_OK [SWS_EthIf_91129].

Verwendung

Die asynchrone Schnittstelle EthIf_RunPortCableDiagnostic stößt eine Kabeldiagnose für einen ausgewählten Port eines Ethernet-Switches an [SWS_EthIf_91131]. Beim Aufruf werden die Parameter SwitchIdx (Index des Switches im Kontext des Ethernet-Switch-Treibers) und PortIdx (Index des adressierten Ports am Switch) übergeben. Die Funktion liefert E_OK zurück, sobald der Trigger für die Kabeldiagnose angenommen wurde; wird der Anstoß abgewiesen, erfolgt die Rückgabe von E_NOT_OK [SWS_EthIf_91131].

Zusammenspiel und Vorbedingungen

Bei Ausführung von EthIf_RunPortCableDiagnostic ist EthIf verpflichtet sicherzustellen, dass sich der korrespondierende EthIfController im Betriebszustand ETH_MODE_ACTIVE befindet [SWS_EthIf_00464]. Unter dieser Bedingung leitet das Ethernet Interface den Aufruf an die Funktion EthSwt_RunPortCableDiagnostic des zugeordneten Switch-Treibers weiter [SWS_EthIf_00464].

Nebenläufigkeit und Einschränkungen

Die Funktion ist reentrant für voneinander abweichende Werte von SwitchIdx und PortIdx [SWS_EthIf_91131]. Für identische Paare aus Switch- und Port-Index ist der Aufruf hingegen als nicht reentrant spezifiziert, weshalb parallele Ausführungen auf demselben Port vermieden werden müssen.

Verwendung

Die Funktion EthIf_RunCableDiagnostic stößt die Kabeldiagnose für einen spezifizierten Ethernet-Transceiver an [SWS_EthIf_91132]. Sie wird über den Header EthIf.h bereitgestellt und unter der Service-ID 0x62 geführt [SWS_EthIf_91132]. Als Übergabeparameter dient TrcvIdx, welcher den Index des Ziel-Transceivers im Kontext des Ethernet-Transceiver-Treibers abbildet [SWS_EthIf_91132].

Die Ausführung erfolgt asynchron [SWS_EthIf_91132]. Der Rückgabewert vom Typ Std_ReturnType signalisiert die Annahme des Triggers:

• E_OK: Der Trigger zur Kabeldiagnose wurde erfolgreich akzeptiert [SWS_EthIf_91132].
• E_NOT_OK: Der Trigger wurde nicht akzeptiert [SWS_EthIf_91132].

Fehlerbehandlung

Wird die Kabeldiagnose abgewiesen, liefert die Funktion unmittelbar E_NOT_OK zurück [SWS_EthIf_91132]. Spezifische Entwicklungs- oder Produktionsfehler (DET/DEM) sind für diese Funktion in der vorliegenden Spezifikation nicht definiert.

Nebenläufigkeit und Einschränkungen

Hinsichtlich der Nebenläufigkeit ist EthIf_RunCableDiagnostic reentrant für Aufrufe mit unterschiedlichen Indizes (TrcvIdx), jedoch nicht reentrant für denselben Transceiver-Index [SWS_EthIf_91132]. Zeitgleiche Diagnoseanforderungen auf demselben Transceiver müssen vom Aufrufer unterbunden werden. Interpretation: Da die Funktion rein asynchron arbeitet und keine Ergebnisdaten zurückliefert, dürfte die Bereitstellung des Diagnoseergebnisses vermutlich über einen separaten Mechanismus erfolgen. Frage Q-c65c009cd2e00dea (offen)

Die Schnittstellenfunktion EthIf_SwitchGetCfgDataRaw dient dem Auslesen von Konfigurations- oder Speicherdaten eines indizierten Ethernet-Switches in variabler Länge [SWS_EthIf_91133]. Im Rahmen des Schichtenmodells verarbeitet das Modul den Aufruf nicht eigenständig, sondern leitet ihn direkt an die Funktion EthSwt_GetCfgDataRaw des zuständigen Ethernet-Switch-Treibers weiter [SWS_EthIf_00468]. Die Funktion ist im Header EthIf.h deklariert und besitzt die Service-ID 0x63 [SWS_EthIf_91133].

Aufruf und Parameter

Der Aufruf erfolgt asynchron und initiiert lediglich die Leseoperation [SWS_EthIf_91133]. An Parametern erwartet die Funktion:

• SwitchIdx: Index des Ethernet-Switches im Kontext des Ethernet-Switch-Treibers [SWS_EthIf_91133],
• Offset: Start-Offset im Speicher des Ethernet-Switches, ab dem der Lesevorgang beginnt [SWS_EthIf_91133],
• Length: Anzahl der zu lesenden und kopierenden Datenbytes [SWS_EthIf_91133],
• BufferPtr: Zeiger auf den Zielspeicherort, an welchen die Daten kopiert werden sollen [SWS_EthIf_91133].

Als Rückgabewert liefert die Funktion E_OK, wenn der Lesevorgang erfolgreich angestoßen wurde [SWS_EthIf_91133]. Kann der Vorgang nicht angestoßen werden – beispielsweise wenn der adressierte Switch nicht verfügbar ist –, wird E_NOT_OK gemeldet [SWS_EthIf_91133].

Nebenläufigkeit

Die Funktion ist als nicht reentrant (Non Reentrant) definiert [SWS_EthIf_91133]. Aufrufer müssen daher sicherstellen, dass Aufrufe sequenziell erfolgen. Interpretation: Wegen des asynchronen Charakters dürfte der Pufferinhalt bei der Rückkehr von E_OK noch nicht final gefüllt sein, sondern erst zeitverzögert durch den Treiber bereitgestellt werden. Frage Q-0abda93fb8830dd4 (offen)

Die Funktion EthIf_SwitchGetCfgDataInfo ermittelt die Gesamtgröße der Konfigurationsdaten sowie die Startadresse der Konfigurationsregister für einen indizierten Ethernet-Switch [SWS_EthIf_91134]. Die Schnittstelle ist im Header EthIf.h deklariert und wird unter der Service-ID 0x64 geführt [SWS_EthIf_91134].

Die Funktion übernimmt folgende Parameter [SWS_EthIf_91134]:

• SwitchIdx (in): Index des Ethernet-Switches im Kontext des Ethernet-Switch-Treibers.
• DataSizePtr (out): Zeiger auf die Speicherstelle, an welche die Gesamtgröße der Konfigurationsdaten kopiert werden soll.
• DataAdressPtr (out): Zeiger auf die Speicherstelle, an welche die Startadresse der Konfigurationsregister kopiert werden soll.

Als Rückgabewert liefert die Funktion E_OK, wenn die Daten erfolgreich bezogen wurden, oder E_NOT_OK, falls der Vorgang fehlschlägt, beispielsweise weil der indizierte Switch nicht verfügbar ist [SWS_EthIf_91134]. Spezifische Fehlercodes für DET oder DEM sind für diesen Service im vorliegenden Spezifikationsumfang nicht definiert.

Für den Aufrufkontext ist die Funktion als reentrant sowie formal als asynchron spezifiziert [SWS_EthIf_91134]. Da keine Callback-Mechanismen spezifiziert sind, dürfte die Bereitstellung der Daten bei Rückgabe von E_OK unmittelbar vorliegen (Interpretation: die asynchrone Klassifikation deutet vermutlich auf interne Treiberzugriffe hin). Frage Q-bf49882a16548ea4 (offen)

Verwendung und Aufruf

Die Funktion EthIf_SwitchPortGetMaxFIFOBufferFillLevel ermittelt den maximal allokierten FIFO-Pufferspeicher (in Bytes) seit dem letzten Lesezugriff für einen bestimmten Egress-Port eines Ethernet-Switches [SWS_EthIf_91135]. Der Aufruf kann beispielsweise durch einen Complex Device Driver (CDD) erfolgen [SWS_EthIf_91135]. Zur Adressierung werden der Switch-Index (SwitchPortIdx), der Port-Index (PortIdx) und der FIFO-Index (SwitchPortEgressFifoIdx) übergeben. Der ermittelte Füllstand wird in den Speicherbereich geschrieben, auf den SwitchPortEgressFifoBufferLevelPtr verweist [SWS_EthIf_91135].

Nebenläufigkeit und Ausführung

Die Funktion besitzt eine asynchrone Ausführungssemantik [SWS_EthIf_91135]. Sie ist reentrant für unterschiedliche Switch- und Port-Indizes, darf jedoch für dieselbe Kombination aus SwitchPortIdx und PortIdx nicht nebenläufig aufgerufen werden [SWS_EthIf_91135]. Wegen der asynchronen Semantik bei gleichzeitiger Zeigerübergabe dürfte der referenzierte Speicherbereich für das Ergebnis bis zum Abschluss der Operation gültig bleiben müssen. Frage Q-c941ffec278a86cd (offen)

Fehlerbehandlung und Treiber-Interaktion

Bei erfolgreichem Abruf liefert die Funktion E_OK zurück, andernfalls E_NOT_OK [SWS_EthIf_91135]. Falls die Switch-Hardware die portbasierte Ermittlung des maximalen FIFO-Pufferfüllstands nicht unterstützt, wird der Wert an der Zieladresse SwitchPortEgressFifoBufferLevelPtr auf 0xFFFFFFFF gesetzt [SWS_EthIf_91135]. Das Modul leitet den Aufruf zur weiteren Ausführung an die Treiberfunktion EthSwt_GetMaxFIFOBufferFillLevel des zugeordneten Ethernet-Switch-Treibers weiter [SWS_EthIf_00472].

Verwendung und Semantik

Die Funktion EthIf_TransceiverGetMacMethod (Service-ID 0x66) dient dem synchronen Abfragen des konfigurierten Medienzugriffsverfahrens eines Ethernet-Transceivers [SWS_EthIf_91021]. Sie ist über die Header-Datei EthIf.h verfügbar und verwendet folgende Schnittstellenparameter:

• TrcvIdx (in): Index des Transceivers innerhalb des Kontexts des Ethernet-Transceiver-Treibers [SWS_EthIf_91021].
• MacModePtr (out): Zeiger auf den Speicherort für das ermittelte Zugriffsverfahren vom Typ EthTrcv_MacMethodType [SWS_EthIf_91021]. Gültige Ergebniswerte sind ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access mit Collision Detection) und ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

Rückgabewerte und Fehlerbehandlung

Als Rückgabewert liefert die Schnittstelle einen Status vom Typ Std_ReturnType [SWS_EthIf_91021]:

• E_OK: Das Medienzugriffsverfahren wurde erfolgreich ausgelesen und über MacModePtr bereitgestellt.
• E_NOT_OK: Die Anfrage an den Transceiver wurde nicht akzeptiert [SWS_EthIf_91021]. Spezifische DET- oder DEM-Fehlercodes sind in der Spezifikation für diesen Service nicht aufgeführt.

Nebenläufigkeit und Randbedingungen

Die Ausführung erfolgt synchron, die Funktion ist jedoch als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91021]. Ein gleichzeitiger oder unterbrechender Aufruf innerhalb desselben Treiberkontexts ist daher durch den Aufrufer auszuschließen. Zu beachten ist ferner, dass der Service im Release R20-11 mit dem Status atp.Status=draft ausgewiesen ist [SWS_EthIf_91021].

Verwendung und Semantik

Die synchrone Funktion EthIf_RxIndication verarbeitet einen Ethernet-Frame, der über einen indizierten physischen Ethernet-Controller empfangen wurde [SWS_EthIf_00085]. Der Dienst besitzt keinen Rückgabewert und wickelt die Weiterleitung der empfangenen Daten innerhalb des Ethernet-Interface ab [SWS_EthIf_00085]. Interpretation: Der Aufruf dürfte typischerweise durch den unterlagerten Ethernet-Treiber (Eth) erfolgen, sobald neue Empfangsdaten vollständig vorliegen. Frage Q-c3d25d0b89e6cd7f (offen)

Parameter

Für die Weiterverarbeitung nimmt die Funktion folgende Parameter entgegen [SWS_EthIf_00085]:

• CtrlIdx: Index des physischen Ethernet-Controllers im Kontext des Ethernet-Interface [SWS_EthIf_00085].
• FrameType: Frame-Typ des empfangenen Ethernet-Frames [SWS_EthIf_00085].
• IsBroadcast: Kennzeichnung, ob es sich um einen Broadcast-Frame handelt [SWS_EthIf_00085].
• PhysAddrPtr: Zeiger auf die physische Quelladresse (MAC-Adresse in Netzwerk-Byte-Reihenfolge) des empfangenen Frames [SWS_EthIf_00085].
• DataPtr: Zeiger auf die Nutzdaten (Payload) des empfangenen Frames [SWS_EthIf_00085].
• LenByte: Länge der Nutzdaten im empfangenen Frame in Bytes [SWS_EthIf_00085].

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als nicht reentrant (Non Reentrant) deklariert und unter der Service-ID 0x10 über die Header-Datei EthIf.h verfügbar [SWS_EthIf_00085]. Aufrufer müssen sicherstellen, dass keine konkurrierenden Aufrufe stattfinden. Spezifische Fehlercodes, Rückgabewerte oder DET-/DEM-Meldungen sind im Spezifikationsumfang für diese Funktion nicht ausgewiesen.

Verwendung und Aufrufkontext

Die synchrone Funktion EthIf_TxConfirmation (Service-ID 0x11) bestätigt die Übertragung eines Ethernet-Frames durch den über CtrlIdx referenzierten physischen Ethernet-Controller [SWS_EthIf_00091]. Die Funktion besitzt keinen Rückgabewert und ist über die Header-Datei EthIf.h verfügbar [SWS_EthIf_00091].

Die Eingangsparameter sind wie folgt definiert [SWS_EthIf_00091]:

• CtrlIdx (uint8): Index des physischen Ethernet-Controllers im Kontext des Ethernet-Interface.
• BufIdx (Eth_BufIdxType): Index des übertragenen Puffers.
• Result (Std_ReturnType): Ergebnis der Übertragung; E_OK signalisiert einen erfolgreichen Sendevorgang, E_NOT_OK einen Übertragungsfehler.

Zusammenspiel mit übergeordneten Schichten

Gemäß [SWS_EthIf_00255] leitet EthIf_TxConfirmation das empfangene Übertragungsergebnis Result an die konfigurierte obere Schicht über deren Callback <UL>_TxConfirmation weiter.

Nebenläufigkeit und Einschränkungen

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_00091]. Parallele Aufrufe müssen daher vermieden werden. Spezifische DET- oder DEM-Fehlermeldungen sind im Spezifikationsauszug nicht vorgesehen; Fehler werden ausschließlich über den Parameter Result mit dem Wert E_NOT_OK übermittelt [SWS_EthIf_00091].

Die Benachrichtigungsfunktion EthIf_CtrlModeIndication wird gemäß [SWS_EthIf_00231] aufgerufen, sobald der Betriebsmodus eines Ethernet-Controllers erfolgreich ausgelesen worden ist. Die Auslösung erfolgt asynchron infolge eines vorangegangenen Aufrufs von Eth_SetControllerMode, wobei der Aufruf direkt innerhalb der jeweiligen Trigger-Funktionen stattfinden kann. Die Funktion selbst besitzt eine synchrone Ausführungssemantik und liefert keinen Rückgabewert ([SWS_EthIf_00231]).

Über die Parameter werden der Index des physischen Ethernet-Controllers im Kontext des Ethernet-Interface (CtrlIdx) sowie der gemeldete Controller-Modus (CtrlMode) übergeben ([SWS_EthIf_00231]). Hinsichtlich der Nebenläufigkeit spezifiziert [SWS_EthIf_00231], dass die Funktion für denselben Controller-Index nicht reentrant ist, für unterschiedliche Indizes jedoch reentrant ausgeführt werden darf.

Bezüglich des Zusammenspiels mit weiteren Modulen verweisen verwandte Anforderungen auf nachgelagerte Aktionen, die im vorliegenden Release jedoch als obsolet eingestuft sind:

• Gemäß [SWS_EthIf_00267] (OBSOLETE) war im Kontext dieser Funktion vorgesehen, EthSwt_SetSwitchPortMode für alle Ports einer Switch-Port-Gruppe aufzurufen, sofern eine entsprechende Steuerungsreferenz besteht, und bei ETH_MODE_DOWN Konflikte mit aktiven Gruppen aufzulösen.
• Gemäß [SWS_EthIf_00413] (OBSOLETE) war im Kontext dieser Funktion vorgesehen, bei vorhandener Transceiver-Referenz EthTrcv_TransceiverLinkStateRequest mit ETHTRCV_LINK_STATE_ACTIVE bzw. ETHTRCV_LINK_STATE_DOWN aufzurufen, abhängig davon, ob zuvor ETH_MODE_ACTIVE oder ETH_MODE_DOWN angefordert worden war.

Verwendung und Semantik

Die Funktion EthIf_TrcvModeIndication dient als Benachrichtigungsschnittstelle des Ethernet-Interfaces, die aufgerufen wird, sobald ein Moduswechsel des Transceivers ausgelesen wurde [SWS_EthIf_00232]. Sie ist über die Header-Datei EthIf.h verfügbar und besitzt die Service-ID 0x0f [SWS_EthIf_00232].

Die Ausführung der Funktion selbst ist synchron spezifiziert, während der Aufruf asynchron erfolgt, wenn der Moduswechsel ermittelt wurde [SWS_EthIf_00232]. Falls die Funktion durch einen vorangegangenen Aufruf von EthTrcv_SetTransceiverMode ausgelöst wird, darf sie unmittelbar innerhalb dieser auslösenden Funktion aufgerufen werden [SWS_EthIf_00232].

Parameter und Rückgabewerte

• TrcvIdx: Index des Ethernet-Transceivers im Kontext des Ethernet-Interfaces (Eingangsparameter) [SWS_EthIf_00232].
• TrcvMode: Signalisierter Betriebsmodus des Ethernet-Transceivers vom Typ Eth_ModeType (Eingangsparameter) [SWS_EthIf_00232].
• Rückgabewert: Keiner (void) [SWS_EthIf_00232].

Nebenläufigkeit und Reentranz

Die Funktion ist für denselben Index nicht reentrant, für unterschiedliche Indizes hingegen reentrant spezifiziert [SWS_EthIf_00232]. Die Spezifikationstabelle nennt hierbei Ctrl Idx, was im Kontext dieser Transceiver-Schnittstelle vermutlich als Bezug auf den Transceiver- bzw. Controller-Index zu interpretieren ist [SWS_EthIf_00232]. Frage Q-c0123f1ef0e4ec71 (offen)

Die Funktion EthIf_SwitchPortModeIndication dient dem Ethernet Interface (EthIf) als asynchrone Benachrichtigungsschnittstelle über eine Modusänderung eines Ethernet-Switch-Ports gemeldet durch den Ethernet Switch Driver [SWS_EthIf_91055].

Verwendung und Zusammenspiel

Das EthIf bestimmt die erwarteten Benachrichtigungen anhand der Konfiguration des jeweiligen Switch-Ports: Referenziert der Switch-Port einen Transceiver (EthTrcv), erwartet das EthIf stattdessen eine Benachrichtigung über EthIf_TrcvModeIndication(); andernfalls wird die Benachrichtigung vom Ethernet Switch Driver über EthIf_SwitchPortModeIndication() erwartet [SWS_EthIf_91055].

• SwitchIdx: Index des Ethernet-Switches im Kontext des Ethernet Switch Drivers [SWS_EthIf_91055].
• SwitchPortIdx: Index des Ports am adressierten Ethernet-Switch [SWS_EthIf_91055].
• PortMode: Der neu gemeldete Modus des Switch-Ports vom Typ Eth_ModeType [SWS_EthIf_91055].

Ausführungseigenschaften und Einschränkungen

Die Funktion besitzt keinen Rückgabewert (void) und die Service-ID 0x46 [SWS_EthIf_91055]. Sie ist als asynchron (Asynchronous) und nicht reentrant (Non Reentrant) spezifiziert [SWS_EthIf_91055]. Aufrufer müssen daher sicherstellen, dass konkurrierende Aufrufe für diesen Dienst vermieden werden. Spezifische DET- oder DEM-Fehlermeldungen sind für diese Funktion im Payload nicht definiert.

Verwendung und Aufrufkontext

Die Funktion EthIf_SleepIndication dient als Benachrichtigungsschnittstelle des Ethernet-Interface. Sie wird vom jeweiligen Ethernet-Transceiver-Treiber (EthTrcv) aufgerufen, sobald dieser eine Schlafindikation auf dem Netzwerk registriert hat [SWS_EthIf_91006]. Als einziger Eingabeparameter wird TrcvIdx übergeben, welcher den Index des signalisierenden Ethernet-Transceivers im Kontext des Moduls EthIf eindeutig identifiziert [SWS_EthIf_91006]. Die Funktion besitzt weder Ein-/Ausgabe- noch Rückgabewerte und führt die Benachrichtigung synchron aus [SWS_EthIf_91006].

Hardware-Zusammenspiel

Ein wesentlicher Anwendungsfall ist der Einsatz mit Ethernet-Hardware, die konform zur Spezifikation OPEN Alliance TC10 ausgelegt ist [SWS_EthIf_91006]. In diesem Szenario erkennt der Transceiver (PHY) auf Hardwareebene eine Sleep.Indication, welche durch einen Schlafwunsch (Sleep.Request) des direkt verbundenen Link-Partners ausgelöst wurde [SWS_EthIf_91006].

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als synchron sowie reentrant definiert und wird über die Header-Datei EthIf.h bereitgestellt (Service-ID 0x68) [SWS_EthIf_91006]. Bei der Systemintegration ist zu berücksichtigen, dass das Element als Entwurf mit dem Tag atp.Status=draft gekennzeichnet ist [SWS_EthIf_91006]. Konkrete Fehlerbehandlungsroutinen oder DET-Fehlercodes sind im Spezifikationsumfang nicht definiert; vermutlich erfolgt eine formale Fehlerprüfung erst in künftigen Spezifikationsständen. Frage Q-680af6c43439167f (offen)

Verwendung und Aufrufkontext

Die Funktion EthIf_MainFunctionRx übernimmt im Ethernet-Interface (EthIf) die zentrale Aufgabe, im Polling-Betrieb auf neu eingegangene Datenrahmen zu prüfen und entsprechende Empfangsanzeigen (Reception Indications) an übergeordnete Schichten auszulösen [SWS_EthIf_00097]. Sie ist mit der Signatur void EthIf_MainFunctionRx (void) definiert, nimmt demnach keine Aufrufparameter entgegen und liefert keinen Rückgabewert [SWS_EthIf_00097]. Als Service-ID ist der hexadezimale Wert 0x20 festgelegt [SWS_EthIf_00097].

Die Funktion wird über die Header-Datei SchM_EthIf.h zur Verfügung gestellt [SWS_EthIf_00097]. Dies legt die Interpretation nahe, dass ihr Aufruf periodisch durch den Schedule Manager (SchM) bzw. das Betriebssystem innerhalb eines zyklischen Task-Kontexts der Basissoftware erfolgt.

Nebenläufigkeit und Fehlerbehandlung

Da die Prüfung und Weiterleitung empfangener Rahmen im Polling-Modus spezifiziert ist [SWS_EthIf_00097], erfordert ein reibungsloser Empfangsbetrieb eine adäquate zeitliche Taktung des Aufrufs. Eine verzögerte Ausführung dürfte zu Verzögerungen bei der Weiterleitung eingehender Nachrichten an obere Softwareschichten führen. Frage Q-554ef0cf302c3aa3 (offen) Spezifische Fehlercodes, Entwicklungsfehler (DET) oder Fehlermeldungen an den DEM werden in der Spezifikation nicht für diese Funktion aufgeführt.

Die Hauptfunktion EthIf_MainFunctionTx dient der zyklischen Abwicklung von Sendeoperationen und Zustandsabfragen innerhalb des Ethernet-Interface-Moduls [SWS_EthIf_00113]. Sie besitzt die hexadezimale Service-ID 0x21 und wird gemäß ihrer Signatur void EthIf_MainFunctionTx (void) ohne Übergabeparameter und ohne Rückgabewert ausgeführt, sodass die gesamte Verarbeitung zustandsbasiert erfolgt [SWS_EthIf_00113].

Im laufenden Betrieb übernimmt der Service zwei zentrale Aufgaben bei der Ethernet-Kommunikation:

• Sende-Bestätigungen: Im Polling-Modus erteilt die Funktion Bestätigungen für erfolgreich abgeschlossene Übertragungen (Transmission Confirmations) an übergeordnete Schichten [SWS_EthIf_00113].
• Transceiver-Zustände: Sie überwacht und prüft das System auf eingetretene Zustandsänderungen der angebundenen Ethernet-Transceiver [SWS_EthIf_00113].

Hinsichtlich der Systemintegration ist die Schnittstelle über die Header-Datei SchM_EthIf.h verfügbar [SWS_EthIf_00113]. Interpretation: Aus der Bereitstellung über SchM_EthIf.h dürfte folgen, dass der Aufruf periodisch durch den BSW-Scheduler (SchM) im Kontext einer zyklischen Task erfolgt. Frage Q-b9dde07f9cc74a95 (offen) Dies stellt sicher, dass anstehende Sende-Bestätigungen im Polling-Betrieb und Transceiver-Zustandswechsel regelmäßig sowie ohne Interrupt-Abhängigkeit verarbeitet werden.

Spezifische Fehlercodes, gesonderte Fehlerbehandlungsroutinen über DET oder DEM sowie Anforderungen an die Reentranz sind im vorliegenden Spezifikationsumfang für diesen Service nicht definiert und werden daher nicht ausgewiesen.

Verwendung und Semantik

Die Funktion EthIf_MainFunctionState dient dem zyklischen Abfragen (Polling) von Zustands- und Diagnoseinformationen der angebundenen Ethernet-Kommunikationshardware wie Ethernet-Transceivern und Ethernet-Switch-Ports [SWS_EthIf_91104]. Hierzu zählen beispielsweise der Verbindungsstatus (Link State) sowie die Signalqualität [SWS_EthIf_91104]. Die Funktion besitzt weder Eingangs- noch Ausgangsparameter und gibt keinen Wert zurück (void EthIf_MainFunctionState(void), Service-ID 0x05) [SWS_EthIf_91104]. Das Ausführungsverhalten ist als asynchron spezifiziert [SWS_EthIf_91104].

Nebenläufigkeit und Aufrufbedingungen

Die Funktion ist als nicht reentrant (Non Reentrant) definiert [SWS_EthIf_91104]. Sie darf daher zu keinem Zeitpunkt parallel oder sich selbst unterbrechend ausgeführt werden. Da die Schnittstelle über die Header-Datei EthIf_SchM.h bereitgestellt wird [SWS_EthIf_91104], dürfte der periodische Aufruf typischerweise im Task-Kontext des BSW-Schedulers (SchM) erfolgen. Frage Q-10d02355b276be90 (offen)

Zusammenspiel und Konfiguration

Gemäß [SWS_EthIf_00407] muss EthIf_MainFunctionState die Hardware-Informationen strikt mit der konfigurierten Periodizität EthIfMainFunctionStatePeriod abfragen. Dies gewährleistet eine regelmäßige Aktualisierung der physikalischen Schnittstellenparameter im Ethernet-Interface.

Die Datenstruktur EthIf_SignalQualityResultType ([SWS_EthIf_91057]) dient der Erfassung und Diagnose der Verbindungsqualität auf Ethernet-Ebene und wird über die Header-Datei EthIf.h bereitgestellt.

Die Struktur bündelt drei Messgrößen vom Basistyp uint32:

• ActualSignalQuality: repräsentiert die aktuell anliegende Signalqualität der Ethernet-Verbindung.
• HighestSignalQuality: hält die höchste gemessene Signalqualität der Verbindung seit dem letzten Zurücksetzen fest.
• LowestSignalQuality: dokumentiert die niedrigste gemessene Signalqualität der Verbindung seit dem letzten Zurücksetzen.

Im Zusammenspiel mit dem Modul EthIf spiegeln die Extremwerte den Verlauf der Verbindungsstabilität wider. Das Zurücksetzen der intern gespeicherten Historienwerte wird über dedizierte Schnittstellen gesteuert:

• Für einen über TrcvIdx spezifizierten Transceiver setzt die Funktion EthIf_ClearTrcvSignalQuality die gespeicherten Signalqualitätswerte zurück ([SWS_EthIf_00400]).
• Für einen über SwitchIdx und SwitchPortIdx identifizierten Switch-Port löscht EthIf_ClearSwitchPortSignalQuality die gespeicherten Signalqualitätswerte ([SWS_EthIf_00404]).

Interpretation: Da der Payload keine spezifische Lese-Funktion nennt, dürfte die Struktur vermutlich als Ausgabeparameter entsprechender Statusabfragen für Transceiver und Switch-Ports dienen, um die aktuelle Signalqualität mit den Extremwerten abzugleichen. Frage Q-8e5f2914bade574c (offen)