Ethernet Interface (EthIf)

Gebruik en semantiek

De functie EthIf_Init initialiseert de Ethernet Interface-module ([SWS_EthIf_00024]). Ze wordt synchroon uitgevoerd, is niet-reentrant (Non Reentrant) en beschikbaar via het headerbestand EthIf.h met het service-ID 0x01. Als enige overdrachtsparameter verwacht de functie de pointer CfgPtr, die verwijst naar een implementatiespecifieke configuratiestructuur van het type EthIf_ConfigType. Er bestaan noch inout- noch out-parameters, en de functie heeft geen retourwaarde ([SWS_EthIf_00024]).

Gelijktijdigheid en aanroepcontext

Aangezien EthIf_Init niet-reentrant is, mag er geen gelijktijdige of geneste aanroep plaatsvinden [SWS_EthIf_00024]. Aangezien de specifieke aanroepcontext in de payload niet nader is beschreven, vindt de aanroep vermoedelijk eenmalig plaats tijdens de initialisatiesequentie van het stuurapparaat voorafgaand aan het gebruik van andere Ethernet-diensten. Vraag Q-07e92f9f3c15ea5b (open)

Volgordevoorwaarden en interactie

De aanroep van EthIf_Init vormt de dwingende voorwaarde voor het gebruik van alle verdere functies van de module. Indien ontwikkelingsfoutdetectie (Development Error Detection) is geactiveerd, controleren talrijke diensten van de Ethernet-interface voorafgaand aan hun uitvoering of EthIf_Init tevoren is aangeroepen:

• Wanneer de initialisatie niet is uitgevoerd, melden de afhankelijke functies de ontwikkelingsfout ETHIF_E_UNINIT (bijvoorbeeld [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] en [SWS_EthIf_00304]).
• Meerdere interfaces breken bij achterwege gebleven initialisatie de uitvoering af en leveren bovendien de foutwaarde E_NOT_OK terug (zoals [SWS_EthIf_00246], [SWS_EthIf_00273] alsook [SWS_EthIf_00277]).

Gebruik

De functie EthIf_SetControllerMode activeert of deactiveert de via CtrlIdx opgegeven Ethernet-controller in de context van de Ethernet-interface [SWS_EthIf_00034]. Via de parameter CtrlMode worden de volgende toestanden aangevraagd [SWS_EthIf_00034]:

• ETH_MODE_DOWN: Deactiveert de controller.
• ETH_MODE_ACTIVE: Activeert de controller.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: Activeert de controller en vraagt een wake-up aan op het netwerk.

De functie werkt asynchroon [SWS_EthIf_00034]. Ze levert E_OK terug bij een succesvolle uitvoering of E_NOT_OK als de controllermodus niet kon worden gewijzigd [SWS_EthIf_00034].

Samenspel en doorzending

Wordt EthIf_SetControllerMode met ETH_MODE_ACTIVE aangeroepen voor een controller die refereert aan een EthIfSwitchPortGroup van het type “control”, dan stuurt EthIf de aanroep door naar alle poorten van de groep, mits deze modus voor het eerst voor de poort wordt aangevraagd en de status ervan ETH_MODE_DOWN is. Daarbij worden achtereenvolgens EthSwt_SetSwitchPortMode met ETH_MODE_ACTIVE en EthSwt_PortLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE uitgevoerd [SWS_EthIf_00264].

Bij het aanvragen van ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST stuurt EthIf de aanroepen ongeacht de actuele modus als volgt door:

• Bij verwijzing naar een EthIfTransceiver: aanroep van EthTrcv_SetTransceiverMode met ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST en aansluitend EthTrcv_TransceiverLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE, indien de actuele status ETHTRCV_LINK_STATE_DOWN is [SWS_EthIf_00479].
• Bij verwijzing naar een EthIfSwitch respectievelijk een EthIfSwitchPortGroup van het type “control”: aanroep van EthSwt_SetSwitchPortMode met ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST en aansluitend EthSwt_PortLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE, indien de actuele toestand ETHTRCV_LINK_STATE_DOWN is [SWS_EthIf_00480], [SWS_EthIf_00481].

Beperkingen

De functie is niet-reentrant (Non Reentrant) en beschikbaar via EthIf.h [SWS_EthIf_00034].

De synchrone en niet-re-entrante functie EthIf_SetTransceiverWakeupMode (service-ID 0x2e) dient ertoe de wake-up-modus van een via TrcvIdx geadresseerde transceiver in het Ethernet Interface in te stellen of de wake-up-reden ervan te resetten [SWS_EthIf_00233]. De functie is gedeclareerd in het headerbestand EthIf.h en in release AUTOSAR CP R20-11 gemarkeerd als verouderd (obsolete) [SWS_EthIf_00233].

De besturing vindt plaats via de overdrachtsparameter TrcvWakeupMode [SWS_EthIf_00233]:

• ETHTRCV_WUM_ENABLE: Activeert het wekken van de transceiver [SWS_EthIf_00233]. Bevindt het toegewezen stuurprogramma EthIfTransceiverIdx zich momenteel in de toestand ETHTRCV_WUM_DISABLE, dan wordt de aanroep doorgestuurd naar EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE: Deactiveert het wekken van de transceiver [SWS_EthIf_00233]. Voor zover de actuele toestand van het stuurprogramma ETHTRCV_WUM_ENABLE is, stuurt de functie de aanroep door naar EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR: Wist de wake-up-reden van de geïndexeerde transceiver [SWS_EthIf_00233].

Als retourwaarde levert de aanroep E_OK op bij succesvolle uitvoering of E_NOT_OK wanneer de wake-up-modus niet gewijzigd dan wel de wake-up-reden niet gewist kon worden [SWS_EthIf_00233]. Aangezien de interface is gedefinieerd als niet-re-entrant, zijn gelijktijdige aanroepen niet toegestaan [SWS_EthIf_00233].

De functie EthIf_CheckWakeup verzoekt de betreffende Ethernet-hardware om een gesignaleerde wake-up te controleren [SWS_EthIf_00244]. Dit wordt bijvoorbeeld gebruikt voor Ethernet-hardware die conform de specificatie OPEN Alliance TC10 is [SWS_EthIf_00244]. De aanroep vindt asynchroon en reentrant plaats door de integratiecode, naar keuze in de context van een interrupt of op taakniveau [SWS_EthIf_00244].

Als invoerparameter dient WakeupSource van het type EcuM_WakeupSourceType, die het initiërende bronapparaat aanduidt (Ethernet-transceiver of Ethernet-switch) [SWS_EthIf_00244]. De retourwaarde is E_OK wanneer het controleverzoek door de hardware is geaccepteerd, en anders E_NOT_OK bij afwijzing van het verzoek [SWS_EthIf_00244]. De module stuurt de aanroep intern door naar de onderliggende drivers:

• Voor alle betrokken Ethernet-transceivers (gerefereerd via EthIfTransceiver of EthIfSwitchPortGroups) wordt EthTrcv_CheckWakeup van de betreffende transceiver-driver aangeroepen [SWS_EthIf_00245].
• Voor alle betrokken Ethernet-switches (gerefereerd via EthIfSwitch) wordt EthSwt_SwitchCheckWakeup van de betreffende switch-driver aangeroepen [SWS_EthIf_00500].

De beschikbaarheid van EthIf_CheckWakeup kan tijdens pre-compile-tijd via de configuratieparameter EthIfWakeUpSupport worden geactiveerd en gedeactiveerd [SWS_EthIf_00248]. De API wordt beschikbaar gesteld via het headerbestand EthIf.h [SWS_EthIf_00244].

De synchrone functie EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) dient voor het bijwerken van het adresfilter voor de via CtrlIdx opgegeven Ethernet-controller. Via de parameter Action (van het type Eth_FilterActionType) wordt een fysiek adres aan het filter toegevoegd of eruit verwijderd.

Voor de configuratie verwacht PhysAddrPtr een pointer naar het fysieke MAC-adres in netwerkbytevolgorde, die het multicast-bestemmingsadres van het Layer-2-Ethernet-pakket representeert [SWS_EthIf_00139]. Hoewel de tekstuele functiebeschrijving van een bronadres spreekt, betreft het vermoedelijk een redactionele vergissing, aangezien de parameterspecificatie bindend het multicast-bestemmingsadres vastlegt. Vraag Q-312e20e5eadda94a (open)

Met betrekking tot het verloop en de beperkingen gelden de volgende voorschriften [SWS_EthIf_00139]:

• Retourwaarden: De functie levert E_OK op als de filterconfiguratie met succes is gewijzigd, of E_NOT_OK als de wijziging is mislukt. Specifieke DET- of DEM-foutcodes zijn in de bronnen niet gedefinieerd.
• Hardware-ondersteuning: Indien de onderliggende Ethernet-controller hardwarematig niet in staat is om de filtering uit te voeren, moet de software deze filtertaak overnemen.
• Gelijktijdigheid: De aanroep is voor dezelfde controller-index (CtrlIdx) niet-re-entrant, maar mag voor verschillende controllers gelijktijdig worden uitgevoerd.

Gebruik en aanroepcontext

De functie EthIf_StoreConfiguration dient ertoe om het persistente opslaan van de geleerde MAC-/poorttabellen van een Ethernet-switch aan te vragen [SWS_EthIf_00214]. Als typische aanroeper wordt bijvoorbeeld een Complex Device Driver (CDD) genoemd [SWS_EthIf_00214]. De interface is toegankelijk via het headerbestand EthIf.h en heeft de service-ID 0x2c [SWS_EthIf_00214].

Via de invoerparameter SwitchIdx wordt de index van de doel-switch in de context van het Ethernet-switch-stuurprogramma doorgegeven [SWS_EthIf_00214]. Als retourwaarde levert de functie de status Std_ReturnType: De waarde E_OK geeft aan dat het opslagverzoek is geaccepteerd, terwijl E_NOT_OK de niet-acceptatie signaleert [SWS_EthIf_00214]. Aangezien de specificatie de uitvoering als synchroon/asynchroon aanduidt, zal het aannemen van het verzoek synchroon plaatsvinden, terwijl het feitelijke persisteren vermoedelijk asynchroon in achterliggende modules wordt afgehandeld. Vraag Q-4f10e936c7d30258 (open)

Beperkingen en foutafhandeling

Wat de gelijktijdigheid betreft, is EthIf_StoreConfiguration gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_00214]. Parallelle aanroepen moeten daarom aan de zijde van de aanroeper worden vermeden of gesynchroniseerd. Specifieke DET- of DEM-foutmeldingen zijn voor deze interface niet gedefinieerd; een fout bij de opdrachtacceptatie wordt uitsluitend via de retourwaarde E_NOT_OK gemeld [SWS_EthIf_00214].

Gebruik en aanroepcontext

De functie EthIf_ResetConfiguration dient ertoe om het persistente resetten van de dynamisch geleerde MAC- en poorttabellen van een Ethernet-switch aan te vragen [SWS_EthIf_00219]. Statisch geconfigureerde vermeldingen blijven ongewijzigd in de configuratie aanwezig [SWS_EthIf_00219]. Als aanroeper van deze interface kan bijvoorbeeld een Complex Device Driver (CDD) fungeren [SWS_EthIf_00219].

Via de overdrachtsparameter SwitchIdx wordt de index van de desbetreffende switch in de context van het Ethernet-switch-stuurprogramma opgegeven [SWS_EthIf_00219]. Wat de uitvoeringssemantiek betreft, is de operatie aangeduid als synchroon/asynchroon [SWS_EthIf_00219]; dit betekent vermoedelijk dat de aanname van het verzoek synchroon wordt bevestigd, terwijl het resetten van de hardwaretabellen asynchroon verloopt. Vraag Q-9e7f89ec9e809fd0 (open)

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie een status van het type Std_ReturnType [SWS_EthIf_00219]:

• E_OK: Het verzoek tot het persistente resetten van de MAC-/poorttabel is met succes geaccepteerd [SWS_EthIf_00219].
• E_NOT_OK: Het verzoek is afgewezen [SWS_EthIf_00219].

Specifieke DET- of DEM-foutmeldingen zijn in de voorliggende specificatieomvang voor deze functie niet gedocumenteerd.

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_00219]. Aanroepers moeten daarom waarborgen dat er geen gelijktijdige of onderbrekende aanroepen plaatsvinden. De functie is opgenomen via het headerbestand EthIf.h [SWS_EthIf_00219].

De synchrone functie EthIf_EnableEgressTimeStamp dient voor het activeren van de registratie van verzendtijdstempels (egress time stamping) voor een specifiek berichtobject respectievelijk een verzendbuffer [SWS_EthIf_00160]. De interface wordt beschikbaar gesteld via het headerbestand EthIf.h [SWS_EthIf_00160].

Parameters en aanroep

Bij aanroep verwacht de functie de overdracht van twee ingangsparameters [SWS_EthIf_00160]:

• CtrlIdx: index van de geadresseerde Ethernet-controller [SWS_EthIf_00160].
• BufIdx: Index van de berichtenbuffer waarvoor de applicatie de registratie van de verzendtijdstempel verwacht [SWS_EthIf_00160].

De functie heeft geen retourwaarde (void) en geen in- of uitgangsparameters [SWS_EthIf_00160].

Hardwaregedrag en gelijktijdigheid

Het gedrag van de hardware verschilt per controller: sommige hardwaretypen slaan de markering voor de verzendtijdstempel permanent op na eenmalige configuratie, terwijl andere controllers deze verplicht vóór elke afzonderlijke transmissie vereisen [SWS_EthIf_00160]. Interpretatie: Op controllers zonder permanente opslag zal de functie bijgevolg vóór elke verzendactie opnieuw moeten worden aangeroepen door de applicatie. Vraag Q-e87b424598f8a684 (open) Een deactiveringsmogelijkheid bestaat conform de specificatie niet, aangezien het desbetreffende berichttype volgens het netwerkontwerp permanent van een tijdstempel wordt voorzien [SWS_EthIf_00160].

Wat betreft concurrency is de functie gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_00160].

De asynchrone functie EthIf_SwitchPortGroupRequestMode vraagt een bedrijfsmodus aan voor een switch-poortgroep ([SWS_EthIf_91102]). De aanroep is gespecificeerd als niet-reentrant en geeft de index van de poortgroep (PortGroupIdx) en de gewenste doelmodus (PortMode) door. Als modi zijn ETH_MODE_DOWN voor deactivering, ETH_MODE_ACTIVE voor activering en ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST voor activering met netwerkwake-up beschikbaar ([SWS_EthIf_91102]). Bij succesvolle initiatie levert de functie E_OK terug, anders E_NOT_OK ([SWS_EthIf_91102]).

In principe stuurt EthIf het verzoek door naar de onderliggende switch door voor alle gerefereerde poorten EthSwt_SetSwitchPortMode aan te roepen ([SWS_EthIf_91102]). Daarbij gelden specifieke gedragsregels voor de verschillende modi:

• Deactivering (ETH_MODE_DOWN): Bevinden de poorten zich actueel in de toestand ETH_MODE_ACTIVE en is voor alle naar de poorten refererende groepen ETH_MODE_DOWN aangevraagd, dan start EthIf een timer met de vertragingstijd EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Activering (ETH_MODE_ACTIVE of ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): Een lopende uitschakelvertragingstimer voor de poorten van de betreffende poortgroep wordt direct afgebroken ([SWS_EthIf_00483]).
• Wake-up-verzoek (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): De aanroep wordt ongeacht de actuele poortmodus voor alle poorten van de groep verplicht in vaste volgorde doorgestuurd: eerst wordt EthSwt_SetSwitchPortMode met ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST aangeroepen, gevolgd door EthSwt_PortLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE, mits de actuele linkstatus ETHTRCV_LINK_STATE_DOWN is ([SWS_EthIf_00482]).

Specifieke DET- of DEM-foutmeldingen zijn voor deze service niet vermeld; het mislukken van een moduswijziging wordt direct via de retourwaarde E_NOT_OK aangegeven ([SWS_EthIf_91102]).

De functie EthIf_StartAllPorts dient om aan te vragen dat alle geconfigureerde en betrokken Ethernet-switch-poorten in de toestand ETH_MODE_ACTIVE worden gebracht ([SWS_EthIf_91103]). De aanroep geschiedt zonder parameters, heeft een asynchrone semantiek en is gespecificeerd als re-entrant ([SWS_EthIf_91103]). Als retourwaarde geeft E_OK de acceptatie van de aanvraag aan, terwijl E_NOT_OK een weigering aanduidt ([SWS_EthIf_91103]).

Na de aanroep van EthIf_StartAllPorts stuurt EthIf de stuurcommando's in een vast gedefinieerde volgorde door naar alle betrokken poorten van de Ethernet-switches (EthSwtPorts) ([SWS_EthIf_00275]):

• Eerst wordt EthSwt_SetSwitchPortMode met ETH_MODE_ACTIVE aangeroepen, voor zover de actuele modus ETH_MODE_DOWN is ([SWS_EthIf_00275]).
• Daarna volgt de aanroep van EthSwt_PortLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE, indien de actuele linktoestand ETHTRCV_LINK_STATE_DOWN is, en voor al deze poorten wordt een timer met de tijdsduur EthIfPortStartupActiveTime gestart ([SWS_EthIf_00275]).

Als een op deze wijze geactiveerde poort niet binnen de tijdsduur EthIfPortStartupActiveTime regulier met ETH_MODE_ACTIVE wordt aangevraagd, deactiveert EthIf deze poort automatisch weer ([SWS_EthIf_00276]). De deactivering vindt verplicht in omgekeerde volgorde plaats:

• Eerst wordt EthSwt_PortLinkStateRequest met ETHTRCV_LINK_STATE_DOWN aangeroepen ([SWS_EthIf_00276]).
• Vervolgens wordt EthSwt_SetSwitchPortMode met ETH_MODE_DOWN aangeroepen ([SWS_EthIf_00276]).

De functie EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) activeert de registratie van egress-tijdstempels voor een specifiek berichtobject op switch-niveau. Het bijbehorende transmissie-object wordt geadresseerd via de controller-index CtrlIdx en de buffer-index BufIdx.

Aanroep en parameters

De aanroep vindt synchroon plaats ([SWS_EthIf_91007]). Als invoerparameters verwacht de functie de controller-index CtrlIdx binnen de EthIf-context evenals BufIdx voor de berichtenbuffer waarvoor de applicatie de tijdstempeling verwacht. Via de uitvoerparameter MgmtInfo van het type EthSwt_MgmtInfoType* worden bijbehorende managementinformatie beschikbaar gesteld ([SWS_EthIf_91007]).

Retourwaarden en gedrag

De functie signaleert het resultaat via een retourwaarde van het type Std_ReturnType ([SWS_EthIf_91007]):

• E_OK: Het egress-time-stampen is succesvol geactiveerd ([SWS_EthIf_91007]).
• E_NOT_OK: Het activeren van de tijdstempeling is mislukt ([SWS_EthIf_91007]).

Beperkingen en concurrency

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_EthIf_91007]). Aanroepers moeten daarom waarborgen dat parallelle aanroepen worden voorkomen. De declaratie wordt beschikbaar gesteld via de header EthIf.h ([SWS_EthIf_91007]).

De synchrone interfacefunctie EthIf_VerifyConfig dient voor de controle van de switch-configuratie en stuurt de aanroep direct door naar EthSwt_VerifyConfig [SWS_EthIf_91012]. De eigenlijke verificatie wordt uitgevoerd door het Ethernet-switch-stuurprogramma, afhankelijk van de desbetreffende hardwarearchitectuur, de hardwarecapaciteiten en de beoogde controlenauwkeurigheid [SWS_EthIf_91012].

Gebruik en parameters

De functie is via de header EthIf.h met service-ID 0x40 beschikbaar en verwacht twee parameters [SWS_EthIf_91012]:

• SwitchIdx (in): index van de switch in de context van de Ethernet-switchdriver.
• Result (out): Pointer naar een booleaanse waarde die het verificatieresultaat opneemt. TRUE duidt op een met succes gecontroleerde configuratie, terwijl FALSE wijst op gedetecteerde beschadigingen.

Als retourwaarde meldt Std_ReturnType de status van de uitvoering: E_OK signaleert dat de verificatie met succes is voltooid, terwijl E_NOT_OK het mislukken van de configuratiecontrole aangeeft [SWS_EthIf_91012].

Gelijktijdigheid en foutafhandeling

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91012]. Aanroepers moeten daarom waarborgen dat er geen concurrerende aanroepen plaatsvinden. Aangezien de payload geen specifieke foutcodes voor DET of DEM vermeldt, worden gedetailleerde parametercontroles (zoals de validatie van indices of pointers) vermoedelijk aan stuurprogrammizijde of implementatiespecifiek behandeld. Vraag Q-03b5f343e97bec7f (open)

De synchrone functie EthIf_SetForwardingMode wordt via de header EthIf.h beschikbaar gesteld en dient voor de besturing van de frame-forwarding op een Ethernet-switch [SWS_EthIf_91013]. Deze verifieert de actuele switch-configuratie en voert bij geconstateerde ongeldigheid een herconfiguratie van de switch uit [SWS_EthIf_91013].

Parameters en retourwaarden

Bij de aanroep (service-ID 0x41) worden de volgende invoerparameters doorgegeven [SWS_EthIf_91013]:

• SwitchIdx: Index van de betreffende switch in de context van het Ethernet-switch-stuurprogramma [SWS_EthIf_91013].
• mode: Booleaanse schakelaar voor de activering (TRUE) of deactivering (FALSE) van de frame-forwarding [SWS_EthIf_91013].

Als retourwaarde levert de functie Std_ReturnType [SWS_EthIf_91013]:

• E_OK: Signaleerde volgens de specificatie het succesvol stoppen van het doorsturen; interpretatie: Dit bevestigt vermoedelijk algemener de succesvolle overname van de gevraagde forwarding-modus [SWS_EthIf_91013]. Vraag Q-f245de852fe854c0 (open)
• E_NOT_OK: Het omschakelen resp. het stoppen van de frame-forwarding is mislukt [SWS_EthIf_91013].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91013]. Aanroepers moeten daarom waarborgen dat aanroepen voor dezelfde of parallelle switch-contexten geserialiseerd plaatsvinden en dat er geen concurrerende aanroepen plaatsvinden. Specifieke foutcodes voor DET of DEM zijn voor deze service niet gedefinieerd in de standaard.

De functie EthIf_ClearTrcvSignalQuality dient voor het synchroon wissen van de opgeslagen signaalkwaliteitswaarden van een Ethernet-verbinding voor een bepaalde transceiver [SWS_EthIf_91059]. De aanroeper geeft daartoe met de parameter TrcvIdx de index van de transceiver in de context van de Ethernet Interface door, waarna de desbetreffende meetwaarden worden gewist [SWS_EthIf_00400].

Als retourwaarde levert de interface het type Std_ReturnType: was het resetten van de signaalkwaliteit succesvol, dan wordt E_OK gemeld; anders mislukt de bewerking met E_NOT_OK [SWS_EthIf_91059]. Interpretatie: de foutwaarde E_NOT_OK is vermoedelijk toe te schrijven aan ongeldige indexparameters of fouten bij het doorsturen naar onderliggende drivers, aangezien de payload geen specifieke foutcodes of DET-meldingen vermeldt. Vraag Q-40d8f0c1fc7ba11e (open)

Wat betreft gelijktijdigheid is de service re-entrant geïmplementeerd voor verschillende transceiver-indices, maar expliciet niet-re-entrant voor dezelfde TrcvIdx [SWS_EthIf_91059]. Meerdere aanroepen voor dezelfde transceiver mogen daarom niet gelijktijdig vanuit gelijktijdige contexten plaatsvinden en moeten dienovereenkomstig worden beveiligd.

In de interactie tussen modules wist de aanroep gericht de opgeslagen signaalkwaliteitswaarden van het type EthIf_SignalQualityResultType voor de via TrcvIdx geadresseerde EthIfTransceiver [SWS_EthIf_00400]. De declaratie van de synchrone interface met de service-ID 0x19 wordt beschikbaar gesteld via de header EthIf.h [SWS_EthIf_91059].

Gebruik

De synchrone functie EthIf_ClearSwitchPortSignalQuality dient voor het resetten van de opgeslagen signaalkwaliteitswaarden voor de verbinding van een bepaalde Ethernet-switchpoort [SWS_EthIf_91060]. De adressering van de doelpoort gebeurt via de twee ingangsparameters SwitchIdx (index van de Ethernet-switch) en SwitchPortIdx (index van de poort binnen de interfacecontext) [SWS_EthIf_91060]. De functie is beschikbaar via het headerbestand EthIf.h [SWS_EthIf_91060].

Interactie en datastructuren

Volgens [SWS_EthIf_00404] wist de aanroep de intern bewaarde signaalkwaliteitswaarden van de geadresseerde switchpoort, die overeenkomen met het type EthIf_SignalQualityResultType. Dit stelt bovenliggende modules in staat om historische meetwaarden gericht te verwerpen en een herbeoordeling van de verbindingskwaliteit te initiëren.

Foutafhandeling

Het succes van de bewerking wordt aangegeven via de retourwaarde van het type Std_ReturnType: bij succesvol wissen levert de functie E_OK op, anders E_NOT_OK [SWS_EthIf_91060]. Specifieke DET- of DEM-foutcodes zijn niet gedefinieerd in de payload. Interpretatie: de retourwaarde E_NOT_OK treedt vermoedelijk met name op wanneer ongeldige indices worden doorgegeven of de onderliggende switchdriver het resetten niet kan uitvoeren. Vraag Q-fc42f5b3e5414f6a (open)

Gelijktijdigheid en beperkingen

Wat betreft re-entrantie is EthIf_ClearSwitchPortSignalQuality re-entrant voor verschillende switch- en switchpoortindices [SWS_EthIf_91060]. Voor dezelfde switchpoort (SwitchPortIdx) is de functie echter gespecificeerd als niet-re-entrant [SWS_EthIf_91060]. Aanroepers moeten er daarom voor zorgen dat gelijktijdige aanroepen voor dezelfde poort worden vermeden of door geschikte synchronisatiemechanismen worden beschermd.

De synchrone interfacefunctie EthIf_SetPhyTestMode dient voor de activering van een vooraf ingestelde testmodus op een Ethernet-transceiver [SWS_EthIf_91016]. De service is gedeclareerd in het headerbestand EthIf.h en identificeerbaar via de hexadecimale service-ID 0x17 [SWS_EthIf_91016].

Voor de aanroep verwacht de functie de doorgifte van twee invoerparameters [SWS_EthIf_91016]:

• TrcvIdx: Bepaalt de numerieke index van de doel-transceiver in de context van de Ethernet Interface [SWS_EthIf_91016].
• Mode: Definieert de concrete, te activeren testmodus van het type EthTrcv_PhyTestModeType [SWS_EthIf_91016].

In- en uitvoerparameters bestaan niet [SWS_EthIf_91016]. Als retourwaarde levert de service een status van het type Std_ReturnType [SWS_EthIf_91016]. De retourwaarde E_OK bevestigt dat het verzoek tot testmodusactivering met succes is geaccepteerd [SWS_EthIf_91016]. De waarde E_NOT_OK geeft daarentegen aan dat het verzoek is afgewezen en dat de testmodus niet kon worden geactiveerd [SWS_EthIf_91016].

Wat betreft de gelijktijdigheid is EthIf_SetPhyTestMode re-entrant gespecificeerd voor verschillende transceiver-indices (TrcvIdx) [SWS_EthIf_91016]. Voor dezelfde transceiver-index is de uitvoering expliciet niet-re-entrant [SWS_EthIf_91016]. Aanroepers moeten daarom waarborgen dat concurrerende aanroepen voor dezelfde transceiver-instantie worden vermeden en in plaats daarvan sequentieel worden gecoördineerd.

Gebruik

De synchrone functie EthIf_SetPhyLoopbackMode dient voor de activering van een gespecificeerde loopback-modus op een Ethernet-transceiver [SWS_EthIf_91018]. De declaratie is beschikbaar via het headerbestand EthIf.h [SWS_EthIf_91018].

Bij de aanroep verwacht de functie twee invoerparameters:

• TrcvIdx: Index van de transceiver in de context van de Ethernet Interface [SWS_EthIf_91018].
• Mode: De te activeren loopback-modus van het type EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

Als retourwaarde levert de functie een status van het type Std_ReturnType: E_OK signaleert dat het verzoek is geaccepteerd, terwijl E_NOT_OK aangeeft dat het verzoek niet kon worden geaccepteerd [SWS_EthIf_91018]. Interpretatie: De functie zal de aanroep synchroon doorsturen naar het voor TrcvIdx verantwoordelijke Ethernet-transceiver-stuurprogramma. Vraag Q-c4736bbfd250cca0 (open)

Foutafhandeling

Specifieke foutcodes zoals DET-meldingen of DEM-gebeurtenissen zijn niet gedefinieerd in het specificatiefragment. Mislukt de acceptatie van het verzoek, dan wordt dit direct aan de aanroeper meegedeeld via de retourwaarde E_NOT_OK [SWS_EthIf_91018]. Aanroepers moeten deze retourwaarde controleren voordat opvolgende test- of diagnoseprocedures worden voortgezet.

Gelijktijdigheid en beperkingen

De functie is re-entrant voor verschillende transceiver-indices (TrcvIdx), maar expliciet niet-re-entrant voor dezelfde transceiver-index [SWS_EthIf_91018]. Aanroepers moeten daarom waarborgen dat gelijktijdige aanroepen voor dezelfde transceiver-instantie worden vermeden of door geschikte synchronisatiemechanismen worden afgedekt [SWS_EthIf_91018].

De synchrone interfacefunctie EthIf_SetPhyTxMode dient voor de activering van een gespecificeerde overdrachtsmodus voor een Ethernet-transceiver [SWS_EthIf_91005]. De declaratie van de functie vindt plaats in het headerbestand EthIf.h onder service-ID 0x13 [SWS_EthIf_91005].

Voor de aanroep verwacht de functie twee ingangsparameters [SWS_EthIf_91005]:

• TrcvIdx: Numerieke index van de betreffende transceiver in de context van de Ethernet-interface.
• Mode: De concreet te activeren zendmodus van het type EthTrcv_PhyTxModeType.

De uitvoering vindt synchroon plaats. Als retourwaarde levert de functie een status van het type Std_ReturnType [SWS_EthIf_91005]. De waarde E_OK bevestigt de succesvolle acceptatie van het verzoek, terwijl E_NOT_OK signaleert dat het verzoek niet geaccepteerd kon worden [SWS_EthIf_91005]. Specifieke foutcodes of meldingen aan het ontwikkelingsfout- (DET) of diagnose-eventmanagement (DEM) zijn niet vermeld in de specificatiegegevens.

Wat betreft het concurrency-gedrag is EthIf_SetPhyTxMode re-entrant voor verschillende transceiver-indices (TrcvIdx) [SWS_EthIf_91005]. Worden er echter aanroepen voor dezelfde transceiver-index gedaan, dan is de functie gedefinieerd als niet-re-entrant en vereist deze een gesynchroniseerde respectievelijk sequentiële aanroep [SWS_EthIf_91005].

Als formele beperking dient in acht te worden genomen dat dit interface-element in de specificatie AUTOSAR CP R20-11 gemarkeerd is met de status draft [SWS_EthIf_91005].

De synchrone en reentrante functie EthIf_ProvideTxBuffer (service-ID 0x09) verleent toegang tot een zendbuffer van de via CtrlIdx opgegeven Ethernet-controller en is beschikbaar via de header EthIf.h [SWS_EthIf_00067].

Voor het aanvragen van een buffer geeft de aanroeper de controller-index (CtrlIdx), het Ethernet-frame-type (FrameType) en de prioriteit (Priority) voor het 3-bits PCP-veld van de VLAN-tag door [SWS_EthIf_00067]. Via de in- en uitgangsparameter LenBytePtr specificeert de aanroeper de gewenste buffergrootte in bytes en ontvangt deze de daadwerkelijk beschikbaar gestelde lengte terug [SWS_EthIf_00067]. Bij een succesvolle toewijzing stelt de functie via BufPtr een pointer naar de buffer en via BufIdxPtr de index van de bufferresource voor opvolgende aanvragen beschikbaar [SWS_EthIf_00067].

Het resultaat van de bufferaanvraag wordt gerapporteerd via het retourtype BufReq_ReturnType [SWS_EthIf_00067]:

• BUFREQ_OK: De buffer is met succes beschikbaar gesteld [SWS_EthIf_00067].
• BUFREQ_E_BUSY: alle bufferbronnen zijn momenteel bezet [SWS_EthIf_00067].
• BUFREQ_E_OVFL: De gevraagde bufferlengte overschrijdt de beschikbare grootte [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK: er is een ontwikkelingsfout gedetecteerd [SWS_EthIf_00067].

De synchrone functie EthIf_Transmit triggert de overdracht van een eerder beschikbaar gestelde en gevulde zendbuffer via de Ethernet-interface [SWS_EthIf_00075].

Gebruik en parameters

De aanroep vindt plaats via de in EthIf.h gedeclareerde interface met de volgende overdrachtsparameters [SWS_EthIf_00075]:

• CtrlIdx: Index van de Ethernet-controller in de context van de module EthIf.
• BufIdx: Index van de te verzenden bufferresource.
• FrameType: Ethernet-frametype.
• TxConfirmation: Stuurt de activering van de verzendbevestiging aan.
• LenByte: Datalengte in bytes.
• PhysAddrPtr: Fysiek bestemmingsadres (MAC-adres) in netwerk-bytevolgorde.

Retourwaarden en concurrency

Als retourwaarde levert de functie E_OK bij succesvolle activering van de overdracht of E_NOT_OK als de overdracht is mislukt [SWS_EthIf_00075]. De functie is reentrant voor aanroepen met verschillende buffer- en controller-indices (BufIdx en CtrlIdx) [SWS_EthIf_00075].

De functie EthIf_SwitchPortGetLinkState dient er volgens [SWS_EthIf_91109] voor om de actuele verbindingsstatus van een bepaalde switchpoort op te vragen. Meegegeven worden de switch-index SwitchIdx in de context van de Ethernet-switchdriver en de poortindex SwitchPortIdx op de geadresseerde switch. Het opvraagresultaat wordt beschikbaar gesteld via de pointer LinkStatePtr, die ofwel ETHTRCV_LINK_STATE_DOWN (poort verbroken) ofwel ETHTRCV_LINK_STATE_ACTIVE (poort verbonden) aanneemt. De specificatie typeert het uitvoeringsgedrag als synchroon of asynchroon; dit hangt vermoedelijk af van de onderliggende switchdriver respectievelijk de hardware-koppeling. Vraag Q-dde6f9e8f1b8ba52 (open)

Als retourwaarde levert de functie Std_ReturnType ([SWS_EthIf_91109]). Bij een succesvolle opvraag wordt E_OK geretourneerd. Als het bepalen van de verbindingsstatus mislukt of de functie wordt aangeroepen terwijl de switch zich in de toestand ETHSWT_STATE_UNINIT of ETHSWT_STATE_INIT bevindt, wordt E_NOT_OK geretourneerd.

Wat betreft gelijktijdigheid is de functie gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_EthIf_91109]), waardoor gelijktijdige aanroepen in dezelfde context moeten worden uitgesloten. De declaratie is beschikbaar via de header EthIf.h met de service-ID 0x4b.

Gebruik

De synchrone functie EthIf_TransceiverGetLinkState dient voor het opvragen van de actuele verbindingsstatus (link state) van een via TrcvIdx geadresseerde Ethernet-transceiver volgens [SWS_EthIf_91110]. De declaratie van de interface wordt beschikbaar gesteld via de header EthIf.h [SWS_EthIf_91110].

Bij de aanroep worden de volgende parameters doorgegeven [SWS_EthIf_91110]:

• TrcvIdx (invoer): index van de transceiver in de context van de Ethernet Transceiver Driver.
• LinkStatePtr (uitvoer): pointer naar de geheugenlocatie voor de vastgestelde toestand van het type EthTrcv_LinkStateType. Mogelijke resultaatwaarden zijn ETHTRCV_LINK_STATE_ACTIVE voor een verbonden en ETHTRCV_LINK_STATE_DOWN voor een verbroken transceiver.

Als retourwaarde levert de functie de statuscode van het type Std_ReturnType: E_OK signaleert een succesvolle uitvoering, terwijl E_NOT_OK aangeeft dat de transceiver niet kon worden geïnitialiseerd [SWS_EthIf_91110].

Foutafhandeling en randvoorwaarden

Mislukt de opvraag, dan levert de service met de service-ID 0x4c de retourwaarde E_NOT_OK [SWS_EthIf_91110]. Specifieke DET- of DEM-foutmeldingen worden niet vermeld in de functiespecificatie.

Concurrency

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91110]. Interpretatie: vanwege het ontbreken van re-entrantie is een gelijktijdige aanroep vanuit meerdere threads of taakcontexten vermoedelijk ontoelaatbaar en vereist deze zo nodig synchronisatie aan de aanroeperszijde. Vraag Q-0459aa9b4c187439 (open)

De functie EthIf_SwitchPortGetBaudRate dient voor het opvragen van de actuele overdrachtssnelheid van een bepaalde Ethernet-switchpoort volgens [SWS_EthIf_91111]. Bij de aanroep worden de index van de switch (SwitchIdx) en de index van de poort op de geadresseerde switch (SwitchPortIdx) doorgegeven. Het opvraagresultaat wordt beschikbaar gesteld via de pointer BaudRatePtr van het type EthTrcv_BaudRateType*, die snelheden zoals ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT of ETHTRCV_BAUD_RATE_2500MBIT kan weergeven [SWS_EthIf_91111].

Wat betreft het foutgedrag retourneert de functie E_OK bij succesvolle bepaling van de baudrate. Een retourwaarde van E_NOT_OK signaleert dat de baudrate voor de opgegeven switchpoort niet kon worden uitgelezen of dat de switchdriver zich in de toestand ETHSWT_STATE_UNINIT resp. ETHSWT_STATE_INIT bevindt [SWS_EthIf_91111].

De specificatie typeert de functie als niet-re-entrant (Non Reentrant) en als synchroon/asynchroon [SWS_EthIf_91111]. Vermoedelijk hangt het synchrone of asynchrone gedrag af van de koppeling en implementatie van de onderliggende Ethernet-switchdriver. Vraag Q-1f4d760ff944df9d (open) Vanwege het ontbreken van re-entrantie moeten aanroepers ervoor zorgen dat parallelle aanroepen van de interface worden vermeden.

De synchrone functie EthIf_TransceiverGetBaudRate met de service-ID 0x4e dient voor het uitlezen van de actuele overdrachtssnelheid van een geïndexeerde Ethernet-transceiver [SWS_EthIf_91112]. Ze maakt deel uit van de module EthIf en wordt beschikbaar gesteld via het headerbestand EthIf.h [SWS_EthIf_91112].

De ingangsparameter TrcvIdx van het type uint8 identificeert de transceiver in de context van de Ethernet-transceiverdriver [SWS_EthIf_91112]. Inout-parameters bestaan niet [SWS_EthIf_91112]. Het resultaat van de opvraag wordt geretourneerd via de uitgangsparameter BaudRatePtr [SWS_EthIf_91112]. Geldige waarden van het type Eth_Trcv_BaudRateType zijn ETHTRCV_BAUD_RATE_10MBIT (10 Mbit/s), ETHTRCV_BAUD_RATE_100MBIT (100 Mbit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 Mbit/s) en ETHTRCV_BAUD_RATE_2500MBIT (2500 Mbit/s) [SWS_EthIf_91112].

De functie retourneert een status van het type Std_ReturnType: bij een succesvolle aanroep wordt E_OK doorgegeven [SWS_EthIf_91112]. Kon de transceiver niet worden geïnitialiseerd, dan mislukt de service en meldt deze E_NOT_OK [SWS_EthIf_91112].

Wat betreft de aanroepcontext en gelijktijdigheid is EthIf_TransceiverGetBaudRate gedefinieerd als een synchrone en niet-re-entrante (Non Reentrant) interface [SWS_EthIf_91112]. Aanroepende lagen moeten ervoor zorgen dat concurrerende aanroepen voor deze service worden vermeden of op aanroepersniveau worden geserialiseerd [SWS_EthIf_91112].

De functie EthIf_SwitchPortGetDuplexMode dient voor het opvragen van de actuele duplexmodus van een geïndexeerde poort op een Ethernet-switch [SWS_EthIf_91113]. Ze stuurt de aanroep door naar de functie EthSwt_GetDuplexMode van de via SwitchIdx toegewezen Ethernet-switchdriver [SWS_EthIf_00428].

Parameters en interface

• SwitchIdx: Index van de Ethernet-switch in de context van de driver [SWS_EthIf_91113].
• SwitchPortIdx: Index van de desbetreffende poort op de geadresseerde switch [SWS_EthIf_91113].
• DuplexModePtr: Uitvoerpointer van het type EthTrcv_DuplexModeType* voor de vastgestelde modus, ofwel ETHTRCV_DUPLEX_MODE_HALF (half-duplex) ofwel ETHTRCV_DUPLEXMODE_FULL (full-duplex) [SWS_EthIf_91113].

Uitvoering en foutafhandeling

De retourwaarde E_OK signaleert een succesvolle opvraag [SWS_EthIf_91113]. Kan de duplexmodus van de poort niet worden bepaald of bevindt de driver zich in de toestand ETHSWT_STATE_UNINIT resp. ETHSWT_STATE_INIT, dan retourneert de functie E_NOT_OK [SWS_EthIf_91113].

De interface is niet-re-entrant (Non Reentrant) en in de specificatie gedeclareerd als synchroon/asynchroon [SWS_EthIf_91113]. Interpretatie: de feitelijke synchrone of asynchrone werkwijze hangt vermoedelijk af van de eigenschappen van de aangesloten switchdriver. Vraag Q-339413722431978f (open)

De synchrone functie EthIf_TransceiverGetDuplexMode bepaalt de actuele duplexmodus van een geïndexeerde Ethernet-transceiver volgens [SWS_EthIf_91114].

Gebruik en parameters

De aanroep vindt synchroon plaats en is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91114]:

• TrcvIdx: Geeft als ingangsparameter de index van de transceiver in de context van de Ethernet-transceiverdriver door [SWS_EthIf_91114].
• DuplexModePtr: Dient als uitvoerpointer naar het type EthTrcv_DuplexModeType voor het opslaan van het resultaat. Mogelijke waarden zijn ETHTRCV_DUPLEX_MODE_HALF (half-duplex) of ETHTRCV_DUPLEX_MODE_FULL (full-duplex) [SWS_EthIf_91114].

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie een Std_ReturnType [SWS_EthIf_91114]:

• E_OK: De duplexmodus is succesvol opgevraagd en via DuplexModePtr beschikbaar gesteld [SWS_EthIf_91114].
• E_NOT_OK: De bepaling is mislukt, volgens de specificatie bijvoorbeeld wanneer de transceiver niet kon worden geïnitialiseerd [SWS_EthIf_91114].

Beperkingen en concurrency

Aangezien de interface niet-re-entrant is, mogen parallelle aanroepen voor dezelfde of verschillende transceiver-instanties niet plaatsvinden zonder externe synchronisatie. De declaratie is beschikbaar via de header EthIf.h [SWS_EthIf_91114].

De synchrone functie EthIf_SwitchPortGetCounterValues dient voor het uitlezen van tellerwaarden (drop counters) van een bepaalde Ethernet-switch-poort conform [SWS_EthIf_91115]. Beschikbaar gesteld via de header EthIf.h accepteert de functie de switch-index SwitchIdx en de poort-index SwitchPortIdx en schrijft ze de tellerwaarden terug via de pointer CounterPtr ([SWS_EthIf_91115]).

Werking en doorzending

Conform [SWS_EthIf_00432] stuurt EthIf_SwitchPortGetCounterValues het verzoek direct door naar de functie EthSwt_GetCounterValues van het desbetreffende Ethernet-switch-stuurprogramma. De geretourneerde tellerwaarden zijn gebaseerd op de standaarden IETF RFC 1757, RFC 1643 en RFC 2233, waarbij de exacte semantische betekenis is toegewezen aan de structuur Eth_CounterType ([SWS_EthIf_91115]).

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie Std_ReturnType ([SWS_EthIf_91115]):

• E_OK: Het uitlezen van de tellerwaarden was succesvol ([SWS_EthIf_91115]).
• E_NOT_OK: Bij het lezen van de tellerwaarden is een fout opgetreden ([SWS_EthIf_91115]).

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91115]. Gelijktijdige aanroepen moeten daarom op aanroepersniveau worden gesynchroniseerd. Interpretatie: De aanroeper zal bovendien verantwoordelijk zijn voor het beschikbaar stellen van een geldig en voldoende gedimensioneerd geheugengebied voor CounterPtr, aangezien de specificatie geen interne bufferallocatie vermeldt. Vraag Q-140661eaa9693cce (open)

Gebruik en semantiek

De functie EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) dient voor het opvragen van tellers voor ontvangststatistieken voor een poort van een Ethernet-switch. Ze is beschikbaar via de header EthIf.h en is geregistreerd onder de service-ID 0x52 ([SWS_EthIf_91116]).

De aanroep vereist de volgende parameters ([SWS_EthIf_91116]):

• SwitchIdx: Index van de Ethernet-switch in de context van de Ethernet-switchdriver.
• SwitchPortIdx: Index van de poort op de geadresseerde switch.
• RxStatsPtr: Pointer naar een structuur van het type Eth_RxStatsType waarin de tellerwaarden worden geschreven. Het merendeel van deze waarden is afgeleid van IETF RFC 2819 (Remote Network Monitoring Management Information Base).

Retourwaarden en foutafhandeling

De functie levert als resultaat een Std_ReturnType ([SWS_EthIf_91116]):

• E_OK: De statistiekgegevens zijn succesvol uitgelezen.
• E_NOT_OK: De tellerwaarden konden niet worden bepaald ([SWS_EthIf_91116]). Specifieke DET- of DEM-foutmeldingen zijn voor deze aanroep niet gespecificeerd.

Gelijktijdigheid en beperkingen

De functie is geclassificeerd als niet-re-entrant (Non Reentrant) ([SWS_EthIf_91116]). Aangezien de synchroniciteit is aangegeven met „Synchronous /Asynchronous”, hangt het feitelijke blokkeergedrag vermoedelijk af van de implementatie van de onderliggende Ethernet-switchdriver ([SWS_EthIf_91116]). Vraag Q-d1e839075bf42e7f (open) Aanroepers moeten parallelle toegang tot dezelfde interface vermijden.

De functie EthIf_SwitchPortGetTxStats dient voor het uitlezen van overdrachtsstatistieken volgens IETF RFC1213 voor een bepaalde poort van een Ethernet-switch [SWS_EthIf_91117]. Ze is beschikbaar via het headerbestand EthIf.h met de service-ID 0x53 [SWS_EthIf_91117].

Gebruik en parameters

Bij de aanroep worden de switch-index (SwitchIdx) en de poortindex op de geadresseerde switch (SwitchPortIdx) als ingangsparameters doorgegeven [SWS_EthIf_91117]. De vastgestelde tellerstanden worden beschikbaar gesteld via de pointer TxStatsPtr van het type Eth_TxStatsType* [SWS_EthIf_91117]. Indien een teller niet beschikbaar is of niet wordt ondersteund, signaleert de maximaal mogelijke waarde van de teller een ongeldige waarde [SWS_EthIf_91117].

Retourwaarden en foutafhandeling

De functie retourneert een status van het type Std_ReturnType [SWS_EthIf_91117]:

• E_OK: De overdrachtsstatistieken zijn succesvol bepaald [SWS_EthIf_91117].
• E_NOT_OK: De overdrachtsstatistieken konden niet worden verkregen [SWS_EthIf_91117].

Specifieke foutcodes of meldingen aan DET of DEM zijn niet vermeld in de bronnen, zodat foutgevallen primair moeten worden opgevangen via de retourwaarde E_NOT_OK [SWS_EthIf_91117].

Gelijktijdigheid en beperkingen

Volgens de specificatie is EthIf_SwitchPortGetTxStats gedefinieerd als asynchroon (Asynchronous) en niet-re-entrant (Non Reentrant) [SWS_EthIf_91117]. Vanwege het ontbreken van re-entrantie mogen gelijktijdige aanroepen niet plaatsvinden zonder overkoepelende synchronisatie [SWS_EthIf_91117]. Aangezien de service als asynchroon is gedeclareerd, moet de doorgegeven buffer TxStatsPtr vermoedelijk geldig worden gehouden tot de volledige afronding van de bewerking (interpretatie: bufferstabiliteit bij asynchrone opvraag) [SWS_EthIf_91117]. Vraag Q-8a14618d6990206b (open)

De via EthIf.h beschikbaar gestelde synchrone functie EthIf_SwitchPortGetTxErrorCounterValues (service-ID 0x54) leest een lijst van transmissiefouttellers uit voor een poort van een Ethernet-switch [SWS_EthIf_91118]. De tellers komen overeen met de definities uit IETF RFC1213 en RFC1643 en worden beschikbaar gesteld via het type Eth_TxErrorCounterValuesType in de uitvoerparameter TxStatsPtr [SWS_EthIf_91118].

Bij de aanroep adresseert SwitchIdx de switch in de context van het stuurprogramma en SwitchPortIdx de concrete poort op de switch [SWS_EthIf_91118]. De functie levert E_OK op bij succesvolle vaststelling van de waarden en E_NOTOK wanneer de transmissiestatistieken niet konden worden verkregen [SWS_EthIf_91118]. Een tellerwaarde die de maximaal mogelijke waarde aanneemt, duidt daarbij expliciet op een ongeldige respectievelijk niet-beschikbare teller [SWS_EthIf_91118].

Als beperking voor de uitvoering is vastgelegd dat de functie niet-re-entrant (Non Reentrant) is [SWS_EthIf_91118]. Binnen het architectuurverband stuurt EthIf_SwitchPortGetTxErrorCounterValues de aanroep direct door naar de functie EthSwt_GetTxErrorCounterValues van het betreffende Ethernet-switch-stuurprogramma [SWS_EthIf_00438].

De functie EthIf_SwitchPortGetMacLearningMode vraagt de actuele MAC-leermodus voor een bepaalde switchpoort op ([SWS_EthIf_91119]). Tot de te bepalen modi behoren hardware-leren ingeschakeld, hardware-leren uitgeschakeld en software-leren ingeschakeld ([SWS_EthIf_91119]). De beschikbaarheid van deze functie is hardwareafhankelijk, aangezien de desbetreffende switch-hardware de verschillende leermodi moet ondersteunen ([SWS_EthIf_91119]).

Aanroepcontext en parameters

De interface wordt beschikbaar gesteld via de header EthIf.h en heeft de service-ID 0x55 ([SWS_EthIf_91119]). Bij de aanroep moeten de volgende parameters worden doorgegeven:

• SwitchIdx (in): index van de switch in de context van de Ethernet-switchdriver ([SWS_EthIf_91119]).
• SwitchPortIdx (in): index van de poort op de geadresseerde switch ([SWS_EthIf_91119]).
• MacLearningModePtr (out): pointer naar de geheugenlocatie van het type EthSwt_MacLearningType waar de vastgestelde modus wordt opgeslagen ([SWS_EthIf_91119]).

Synchronisatie, gelijktijdigheid en retourwaarden

De uitvoering is gespecificeerd als synchroon/asynchroon en is niet-re-entrant (Non Reentrant) ([SWS_EthIf_91119]). Als retourwaarde dient Std_ReturnType met de volgende statussen:

• E_OK: Opvraag succesvol uitgevoerd ([SWS_EthIf_91119]).
• E_NOT_OK: Fout bij de uitvoering ([SWS_EthIf_91119]). De specificatiebeschrijving bij E_NOT_OK vermeldt weliswaar letterlijk „configuration could be persistently reset”, interpretatie: dit is vermoedelijk een redactionele kopieerfout in de specificatie en signaleert in de reguliere context simpelweg het mislukken van de opvraag. Vraag Q-7565d2fbd70e355d (open)

De synchrone interface EthIf_WritePortMirrorConfiguration dient voor het opslaan van een port-mirroring-configuratie in een shadow-buffer binnen de Ethernet-switchdriver [SWS_EthIf_91122].

Bij de aanroep worden de volgende ingangsparameters doorgegeven [SWS_EthIf_91122]:

• MirroredSwitchIdx: Index van de desbetreffende switch in de context van de Ethernet-switchdriver waarop de te spiegelen switchpoort zich bevindt [SWS_EthIf_91122].
• PortMirrorConfigurationPtr: Pointer naar de configuratiegegevens van de structuur EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

De retourwaarde van het type Std_ReturnType signaleert de status van de uitvoering [SWS_EthIf_91122]:

• E_OK: De port-mirroring-configuratie is succesvol geschreven voor de geïndexeerde poort [SWS_EthIf_91122].
• E_NOT_OK: De configuratie kon niet worden geschreven, bijvoorbeeld omdat de geïndexeerde switch niet beschikbaar is [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: Port-mirroring wordt niet ondersteund door de switch-hardware of de Ethernet-switchdriver [SWS_EthIf_91122].

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) en is beschikbaar via de header EthIf.h [SWS_EthIf_91122]. Interpretatie: aanroepers moeten gelijktijdige toegang vermoedelijk via overkoepelende mechanismen coördineren, aangezien er geen interne synchronisatiebeveiliging is gespecificeerd. Vraag Q-c731aedd871251a4 (open)

Gebruik en semantiek

De functie EthIf_ReadPortMirrorConfiguration dient ertoe de port-mirroring-configuratie van een bepaalde Ethernet-switch op te vragen [SWS_EthIf_91123]. Deze is gedeclareerd in het headerbestand EthIf.h en heeft het service-ID 0x59. Het uitvoeringsgedrag is gespecificeerd als asynchroon (Asynchronous), waarbij de rechtstreekse aanroep een statuswaarde van het type Std_ReturnType retourneert [SWS_EthIf_91123].

Parameters en retourwaarden

• MirroredSwitchIdx (in): Index van de Ethernet-switch in de context van het Ethernet-switch-stuurprogramma waarop de te spiegelen switch-ports zich bevinden [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out): Pointer naar het geheugengebied waarin de uitgelezen configuratie moet worden opgeslagen [SWS_EthIf_91123].
• Retourwaarde: E_OK geeft het succesvol uitlezen van de configuratie aan. In geval van een fout wordt E_NOT_OK geretourneerd, bijvoorbeeld wanneer de geïndexeerde Ethernet-switch niet beschikbaar is [SWS_EthIf_91123].

Interactie en gelijktijdigheid

Voor de uitvoering stuurt EthIf_ReadPortMirrorConfiguration de aanroep direct door naar de functie EthSwt_ReadPortMirrorConfiguration van het corresponderende Ethernet-switch-stuurprogramma [SWS_EthIf_00448]. De functie is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91123]; parallelle aanroepen voor dezelfde interface moeten daarom door de aanroeper worden vermeden.

De synchrone functie EthIf_DeletePortMirrorConfiguration dient voor het wissen van een opgeslagen port-mirror-configuratie voor een bepaalde switch ([SWS_EthIf_91124]). De aanroeper geeft via de parameter Mirrored Switch Idx de index van de switch door in de context van de Ethernet Switch Driver ([SWS_EthIf_91124]). De interface heeft het service-ID 0x5a en wordt beschikbaar gesteld via het headerbestand EthIf.h ([SWS_EthIf_91124]).

De retourwaarde van het type Std_ReturnType informeert over het resultaat van het wissen ([SWS_EthIf_91124]):

• E_OK: De port-mirror-configuratie is succesvol gewist ([SWS_EthIf_91124]). Als er voor de opgegeven switch-index geen opgeslagen configuratie is gevonden, levert de functie volgens de definitie eveneens E_OK op ([SWS_EthIf_91124]).
• E_NOT_OK: Het wissen van de configuratie is mislukt ([SWS_EthIf_91124]). Dit is bijvoorbeeld het geval wanneer port-mirroring op het moment van de aanroep nog is geactiveerd ([SWS_EthIf_91124]).

Wat de gelijktijdigheid betreft, is de functie re-entrant voor verschillende switch-indices (Mirrored Switch Idx), maar niet-re-entrant bij meervoudige aanroepen voor dezelfde index ([SWS_EthIf_91124]). Aangezien actieve mirroring expliciet wordt genoemd als foutoorzaak voor E_NOT_OK, moet port-mirroring vermoedelijk worden gedeactiveerd voordat de configuratie wordt gewist ([SWS_EthIf_91124]). Vraag Q-b9e5665de687dbba (open)

De synchrone functie EthIf_SetPortMirrorState dient ertoe de vereiste toestand van de port-mirroring-configuratie voor een opgegeven Ethernet-switch in te stellen ([SWS_EthIf_91126]). Deze is beschikbaar via het headerbestand EthIf.h ([SWS_EthIf_91126]).

De functie verwacht bij aanroep drie parameters ([SWS_EthIf_91126]):

• MirroredSwitchIdx: Index van de Ethernet-switch in de context van de Ethernet Switch Driver, waarop de te activeren respectievelijk te deactiveren port-mirroring-configuratie zich bevindt.
• PortIdx: Index van de poort op de geadresseerde Ethernet-switch.
• PortMirrorState: De op te vragen status van de portspiegeling, hetzij PORT_MIRRORING_ENABLED hetzij PORT_MIRRORING_DISABLED.

De retourwaarde van het type Std_ReturnType signaleert het resultaat van het verzoek ([SWS_EthIf_91126]):

• E_OK: De aangevraagde status voor de opgegeven switch-port is met succes ingesteld.
• E_NOT_OK: Het instellen is mislukt, bijvoorbeeld wanneer de geadresseerde switch niet beschikbaar is of er geen port-mirroring-configuratie aanwezig is.

De uitvoering vindt synchroon plaats en is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_EthIf_91126]). Binnen het lagenmodel verzorgt de Ethernet Interface het doorsturen: volgens [SWS_EthIf_00454] stuurt EthIf_SetPortMirrorState de aanroep direct door naar de functie EthSwt_SetPortMirrorState van de verantwoordelijke Ethernet Switch Driver.

De functie EthIf_SetPortTestMode dient voor het activeren van een vooraf gedefinieerde testmodus op een geïndexeerde port van een Ethernet-switch [SWS_EthIf_91127]. De synchrone service is beschikbaar via de header EthIf.h met het service-ID 0x5d [SWS_EthIf_91127].

Parameters en retourwaarden

Voor de configuratie van de testmodus verwacht de interface drie invoerparameters, terwijl er geen invoer-/uitvoerparameters of zuivere uitvoerparameters bestaan [SWS_EthIf_91127]:

• SwitchIdx (uint8): Index van de switch in de context van het desbetreffende Ethernet-switch-stuurprogramma [SWS_EthIf_91127].
• PortIdx (uint8): Index van de port op de geadresseerde Ethernet-switch [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType): De op de switch-port te activeren testmodus [SWS_EthIf_91127].

De retourwaarde van het type Std_ReturnType signaleert het succes van de bewerking [SWS_EthIf_91127]:

• E_OK: De port-testmodus voor de geïndexeerde Ethernet-switch-port is met succes ingesteld [SWS_EthIf_91127].
• E_NOT_OK: Het instellen van de port-testmodus was niet succesvol, bijvoorbeeld wanneer de geadresseerde Ethernet-switch-port niet beschikbaar is [SWS_EthIf_91127].

Gelijktijdigheid en wisselwerking

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) en werkt synchroon [SWS_EthIf_91127]. Bij aanroep stuurt EthIf_SetPortTestMode het verzoek direct door naar de onderliggende functie EthSwt_SetPortTestMode van het corresponderende Ethernet-switch-stuurprogramma [SWS_EthIf_00456].

Gebruik

De functie EthIf_SetPortLoopbackMode dient ertoe een vooraf gedefinieerde test-loopback-modus voor een geïndexeerde port van een Ethernet-switch te activeren [SWS_EthIf_91128]. De declaratie wordt beschikbaar gesteld via het headerbestand EthIf.h [SWS_EthIf_91128]. Bij de aanroep worden de volgende invoerparameters doorgegeven:

• SwitchIdx: Index van de Ethernet-switch binnen de context van de Ethernet-switchdriver [SWS_EthIf_91128].
• PortIdx: Index van de desbetreffende port op de eerder geadresseerde switch [SWS_EthIf_91128].
• Mode: Te activeren loopback-modus van het type EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Samenspel en doorzending

De functie voert de configuratie niet zelfstandig uit op hardwareniveau. In plaats daarvan stuurt EthIf_SetPortLoopbackMode de aanroep direct door naar de functie EthSwt_SetPortLoopbackMode van het bijbehorende Ethernet-switch-stuurprogramma [SWS_EthIf_00458].

Foutafhandeling en retourwaarden

De retourwaarde is van het type Std_ReturnType [SWS_EthIf_91128]:

• E_OK: De loopback-modus is voor de geïndexeerde port van de Ethernet-switch met succes geactiveerd [SWS_EthIf_91128].
• E_NOT_OK: De activering is mislukt, bijvoorbeeld wanneer de geïndexeerde Ethernet-switch-port niet beschikbaar is [SWS_EthIf_91128].

Specifieke foutcodes voor DET of DEM worden in de specificatie voor deze service niet vermeld.

Gelijktijdigheid en beperkingen

De uitvoering geschiedt volledig synchroon en de functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91128]. Parallelle aanroepen moeten door de aanroeper worden voorkomen. Interpretatie: Aangezien het gaat om het schakelen van testmodi, zal de aanroep typisch plaatsvinden in het kader van initialisatie-, test- of diagnosesequenties op task-niveau. Vraag Q-cb4575c4a1d9c48b (open)

De synchrone functie EthIf_SetPortTxMode activeert een vooraf gedefinieerde transmissiemodus voor een geïndexeerde Ethernet-switch-port [SWS_EthIf_91129]. Deze is beschikbaar via het headerbestand EthIf.h en heeft het service-ID 0x5f [SWS_EthIf_91129].

Gebruik

De aanroep adresseert de doelport via twee indices en geeft de gewenste modus door [SWS_EthIf_91129]:

• SwitchIdx: Index van de switch binnen de context van het Ethernet-switch-stuurprogramma.
• PortIdx: Index van de poort op de geadresseerde switch.
• Mode: Te activeren overdrachtsmodus van het type EthTrcv_PhyTxModeType.

Als retourwaarde levert de functie Std_ReturnType [SWS_EthIf_91129]:

• E_OK: De transmissiemodus voor de geïndexeerde switch-port is met succes geactiveerd.
• E_NOT_OK: De activering is mislukt, bijvoorbeeld wanneer de geïndexeerde switch-port niet beschikbaar is.

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91129]. Aanroepende instanties moeten er daarom voor zorgen dat er geen concurrerende aanroepen plaatsvinden. Specifieke DET- of DEM-foutmeldingen worden in de functiedefinitie niet vermeld; het foutgedrag beperkt zich volgens de specificatie tot het retourneren van E_NOT_OK [SWS_EthIf_91129].

Gebruik

De asynchrone interface EthIf_RunPortCableDiagnostic brengt een kabeldiagnose op gang voor een geselecteerde port van een Ethernet-switch [SWS_EthIf_91131]. Bij de aanroep worden de parameters SwitchIdx (index van de switch in de context van het Ethernet-switch-stuurprogramma) en PortIdx (index van de geadresseerde port op de switch) doorgegeven. De functie levert E_OK op zodra de trigger voor de kabeldiagnose is geaccepteerd; als de aanzet wordt geweigerd, vindt het retourneren van E_NOT_OK plaats [SWS_EthIf_91131].

Wisselwerking en randvoorwaarden

Bij uitvoering van EthIf_RunPortCableDiagnostic is EthIf verplicht te waarborgen dat de corresponderende EthIfController zich in de operationele toestand ETH_MODE_ACTIVE bevindt [SWS_EthIf_00464]. Onder deze voorwaarde stuurt de Ethernet Interface de aanroep door naar de functie EthSwt_RunPortCableDiagnostic van het toegewezen switch-stuurprogramma [SWS_EthIf_00464].

Gelijktijdigheid en beperkingen

De functie is re-entrant voor onderling verschillende waarden van SwitchIdx en PortIdx [SWS_EthIf_91131]. Voor identieke paren van switch- en port-index is de aanroep daarentegen gespecificeerd als niet-re-entrant, waardoor parallelle uitvoeringen op dezelfde port moeten worden vermeden.

Gebruik

De functie EthIf_RunCableDiagnostic initieert de kabeldiagnose voor een gespecificeerde Ethernet-transceiver [SWS_EthIf_91132]. Deze wordt beschikbaar gesteld via de header EthIf.h en geregistreerd onder het service-ID 0x62 [SWS_EthIf_91132]. Als overdrachtsparameter dient TrcvIdx, die de index van de doel-transceiver in de context van het Ethernet-transceiver-stuurprogramma weergeeft [SWS_EthIf_91132].

De uitvoering vindt asynchroon plaats [SWS_EthIf_91132]. De retourwaarde van het type Std_ReturnType signaleert de acceptatie van de trigger:

• E_OK: De trigger voor de kabeldiagnose is met succes geaccepteerd [SWS_EthIf_91132].
• E_NOT_OK: De trigger is niet geaccepteerd [SWS_EthIf_91132].

Foutafhandeling

Wordt de kabeldiagnose geweigerd, dan levert de functie onmiddellijk E_NOT_OK op [SWS_EthIf_91132]. Specifieke ontwikkelings- of productiefouten (DET/DEM) zijn voor deze functie in de onderhavige specificatie niet gedefinieerd.

Gelijktijdigheid en beperkingen

Met betrekking tot gelijktijdigheid is EthIf_RunCableDiagnostic re-entrant voor aanroepen met verschillende indices (TrcvIdx), maar niet-re-entrant voor dezelfde transceiver-index [SWS_EthIf_91132]. Gelijktijdige diagnoseverzoeken op dezelfde transceiver moeten door de aanroeper worden voorkomen. Interpretatie: Aangezien de functie zuiver asynchroon werkt en geen resultaatgegevens retourneert, zal de beschikbaarstelling van het diagnoseresultaat vermoedelijk via een afzonderlijk mechanisme plaatsvinden. Vraag Q-c65c009cd2e00dea (open)

De interfacefunctie EthIf_SwitchGetCfgDataRaw dient voor het uitlezen van configuratie- of geheugengegevens van een geïndexeerde Ethernet-switch met een variabele lengte [SWS_EthIf_91133]. Binnen het lagenmodel verwerkt de module de aanroep niet zelfstandig, maar stuurt deze direct door naar de functie EthSwt_GetCfgDataRaw van het verantwoordelijke Ethernet-switch-stuurprogramma [SWS_EthIf_00468]. De functie is gedeclareerd in de header EthIf.h en heeft het service-ID 0x63 [SWS_EthIf_91133].

Aanroep en parameters

De aanroep geschiedt asynchroon en initieert slechts de leesoperatie [SWS_EthIf_91133]. Als parameters verwacht de functie:

• SwitchIdx: Index van de Ethernet-switch in de context van het Ethernet-switch-stuurprogramma [SWS_EthIf_91133],
• Offset: Start-offset in het geheugen van de Ethernet-switch, vanaf waar het leesproces begint [SWS_EthIf_91133],
• Length: Aantal te lezen en te kopiëren databytes [SWS_EthIf_91133],
• BufferPtr: Pointer naar de doelgeheugenlocatie waar de gegevens naartoe moeten worden gekopieerd [SWS_EthIf_91133].

Als retourwaarde levert de functie E_OK op wanneer het leesproces succesvol is gestart [SWS_EthIf_91133]. Kan het proces niet worden gestart – bijvoorbeeld wanneer de geadresseerde switch niet beschikbaar is –, dan wordt E_NOT_OK gemeld [SWS_EthIf_91133].

Concurrency

De functie is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91133]. Aanroepers moeten er daarom voor zorgen dat aanroepen sequentieel plaatsvinden. Interpretatie: Vanwege het asynchrone karakter zal de bufferinhoud bij terugkeer van E_OK vermoedelijk nog niet definitief gevuld zijn, maar pas met vertraging door het stuurprogramma beschikbaar worden gesteld. Vraag Q-0abda93fb8830dd4 (open)

De functie EthIf_SwitchGetCfgDataInfo bepaalt de totale omvang van de configuratiegegevens evenals het startadres van de configuratieregisters voor een geïndexeerde Ethernet-switch [SWS_EthIf_91134]. De interface is gedeclareerd in de header EthIf.h en wordt gevoerd onder het service-ID 0x64 [SWS_EthIf_91134].

De functie accepteert de volgende parameters [SWS_EthIf_91134]:

• SwitchIdx (in): Index van de Ethernet-switch in de context van het Ethernet-switch-stuurprogramma.
• DataSizePtr (out): Pointer naar de geheugenlocatie waar de totale omvang van de configuratiegegevens naartoe moet worden gekopieerd.
• DataAdressPtr (out): Pointer naar de geheugenlocatie waar het startadres van de configuratieregisters naartoe moet worden gekopieerd.

Als retourwaarde levert de functie E_OK op wanneer de gegevens met succes zijn verkregen, of E_NOT_OK indien het proces mislukt, bijvoorbeeld omdat de geïndexeerde switch niet beschikbaar is [SWS_EthIf_91134]. Specifieke foutcodes voor DET of DEM zijn voor deze service in de onderhavige specificatieomvang niet gedefinieerd.

Voor de aanroepcontext is de functie gespecificeerd als re-entrant en formeel als asynchroon [SWS_EthIf_91134]. Aangezien er geen callback-mechanismen zijn gespecificeerd, zal de beschikbaarstelling van de gegevens bij retournering van E_OK vermoedelijk direct gereed zijn (interpretatie: de asynchrone classificatie duidt vermoedelijk op interne stuurprogrammatoegangen). Vraag Q-bf49882a16548ea4 (open)

Gebruik en aanroep

De functie EthIf_SwitchPortGetMaxFIFOBufferFillLevel bepaalt het maximaal gealloceerde FIFO-buffergeheugen (in bytes) sinds de laatste leestoegang voor een bepaalde egress-port van een Ethernet-switch [SWS_EthIf_91135]. De aanroep kan bijvoorbeeld plaatsvinden door een Complex Device Driver (CDD) [SWS_EthIf_91135]. Voor de adressering worden de switch-index (SwitchPortIdx), de port-index (PortIdx) en de FIFO-index (SwitchPortEgressFifoIdx) doorgegeven. Het vastgestelde niveau wordt geschreven naar het geheugengebied waarnaar SwitchPortEgressFifoBufferLevelPtr verwijst [SWS_EthIf_91135].

Gelijktijdigheid en uitvoering

De functie heeft een asynchrone uitvoeringssemantiek [SWS_EthIf_91135]. Deze is re-entrant voor verschillende switch- en port-indices, maar mag voor dezelfde combinatie van SwitchPortIdx en PortIdx niet gelijktijdig worden aangeroepen [SWS_EthIf_91135]. Vanwege de asynchrone semantiek bij gelijktijdige pointeroverdracht zal het gerefereerde geheugengebied voor het resultaat vermoedelijk geldig moeten blijven tot de voltooiing van de bewerking. Vraag Q-c941ffec278a86cd (open)

Foutafhandeling en stuurprogramma-interactie

Bij succesvol opvragen levert de functie E_OK op, anders E_NOT_OK [SWS_EthIf_91135]. Indien de switch-hardware de portgebaseerde bepaling van het maximale FIFO-bufferniveau niet ondersteunt, wordt de waarde op het doeladres SwitchPortEgressFifoBufferLevelPtr op 0xFFFFFFFF ingesteld [SWS_EthIf_91135]. De module stuurt de aanroep voor verdere uitvoering door naar de driverfunctie EthSwt_GetMaxFIFOBufferFillLevel van het toegewezen Ethernet-switch-stuurprogramma [SWS_EthIf_00472].

Gebruik en semantiek

De functie EthIf_TransceiverGetMacMethod (service-ID 0x66) dient voor het synchroon opvragen van de geconfigureerde mediumtoegangsmethode van een Ethernet-transceiver [SWS_EthIf_91021]. Deze is beschikbaar via het headerbestand EthIf.h en maakt gebruik van de volgende interfaceparameters:

• TrcvIdx (in): Index van de transceiver binnen de context van het Ethernet-transceiver-stuurprogramma [SWS_EthIf_91021].
• MacModePtr (out): Pointer naar de opslaglocatie voor de bepaalde toegangsmethode van het type EthTrcv_MacMethodType [SWS_EthIf_91021]. Geldige resultaatwaarden zijn ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access met Collision Detection) en ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

Retourwaarden en foutafhandeling

Als retourwaarde levert de interface een status van het type Std_ReturnType [SWS_EthIf_91021]:

• E_OK: De mediumtoegangsmethode is met succes uitgelezen en via MacModePtr beschikbaar gesteld.
• E_NOT_OK: Het verzoek aan de transceiver is niet geaccepteerd [SWS_EthIf_91021]. Specifieke DET- of DEM-foutcodes zijn in de specificatie voor deze service niet opgenomen.

Gelijktijdigheid en randvoorwaarden

De uitvoering vindt synchroon plaats, maar de functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91021]. Een gelijktijdige of onderbrekende aanroep binnen dezelfde stuurprogrammacontext moet daarom door de aanroeper worden uitgesloten. Er dient voorts op te worden gelet dat de service in release R20-11 is aangeduid met de status atp.Status=draft [SWS_EthIf_91021].

Gebruik en semantiek

De synchrone functie EthIf_RxIndication verwerkt een Ethernet-frame dat via een geïndexeerde fysieke Ethernet-controller is ontvangen [SWS_EthIf_00085]. De dienst heeft geen retourwaarde en handelt de doorzending van de ontvangen gegevens binnen de Ethernet-interface af [SWS_EthIf_00085]. Interpretatie: De aanroep vindt vermoedelijk typisch plaats door de onderliggende Ethernet-driver (Eth), zodra nieuwe ontvangstgegevens volledig beschikbaar zijn. Vraag Q-c3d25d0b89e6cd7f (open)

Parameter

Voor de verdere verwerking accepteert de functie de volgende parameters [SWS_EthIf_00085]:

• CtrlIdx: Index van de fysieke Ethernet-controller in de context van de Ethernet-interface [SWS_EthIf_00085].
• FrameType: Frame-type van het ontvangen Ethernet-frame [SWS_EthIf_00085].
• IsBroadcast: aanduiding of het om een broadcast-frame gaat [SWS_EthIf_00085].
• PhysAddrPtr: Pointer naar het fysieke bronadres (MAC-adres in netwerk-bytevolgorde) van het ontvangen frame [SWS_EthIf_00085].
• DataPtr: pointer naar de payload (nuttige data) van het ontvangen frame [SWS_EthIf_00085].
• LenByte: Lengte van de payload in het ontvangen frame in bytes [SWS_EthIf_00085].

Gelijktijdigheid en beperkingen

De interface is gedeclareerd als niet-reentrant (Non Reentrant) en onder het service-ID 0x10 beschikbaar via het headerbestand EthIf.h [SWS_EthIf_00085]. Aanroepers moeten ervoor zorgen dat er geen concurrerende aanroepen plaatsvinden. Specifieke foutcodes, retourwaarden of DET-/DEM-meldingen zijn binnen de specificatieomvang voor deze functie niet opgenomen.

Gebruik en aanroepcontext

De synchrone functie EthIf_TxConfirmation (service-ID 0x11) bevestigt de overdracht van een Ethernet-frame door de via CtrlIdx gerefereerde fysieke Ethernet-controller [SWS_EthIf_00091]. De functie heeft geen retourwaarde en is beschikbaar via het headerbestand EthIf.h [SWS_EthIf_00091].

De invoerparameters zijn als volgt gedefinieerd [SWS_EthIf_00091]:

• CtrlIdx (uint8): Index van de fysieke Ethernet-controller in de context van de Ethernet-interface.
• BufIdx (Eth_BufIdxType): Index van de overgedragen buffer.
• Result (Std_ReturnType): Resultaat van de overdracht; E_OK signaleert een succesvolle verzendprocedure, E_NOT_OK een transmissiefout.

Samenspel met bovenliggende lagen

Conform [SWS_EthIf_00255] stuurt EthIf_TxConfirmation het ontvangen overdrachtsresultaat Result via diens callback <UL>_TxConfirmation door naar de geconfigureerde hogere laag.

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-reentrant (Non Reentrant) [SWS_EthIf_00091]. Parallelle aanroepen moeten daarom worden vermeden. Specifieke DET- of DEM-foutmeldingen zijn in het specificatiefragment niet voorzien; fouten worden uitsluitend overgedragen via de parameter Result met de waarde E_NOT_OK [SWS_EthIf_00091].

De notificatiefunctie EthIf_CtrlModeIndication wordt conform [SWS_EthIf_00231] aangeroepen zodra de bedrijfsmodus van een Ethernet-controller succesvol is uitgelezen. Het triggeren vindt asynchroon plaats als gevolg van een voorafgaande aanroep van Eth_SetControllerMode, waarbij de aanroep direct binnen de respectievelijke triggerfuncties kan plaatsvinden. De functie zelf bezit een synchrone uitvoeringssemantiek en levert geen retourwaarde ([SWS_EthIf_00231]).

Via de parameters worden de index van de fysieke Ethernet-controller in de context van de Ethernet-interface (CtrlIdx) en de gemelde controllermodus (CtrlMode) doorgegeven ([SWS_EthIf_00231]). Met betrekking tot de gelijktijdigheid specificeert [SWS_EthIf_00231] dat de functie voor dezelfde controllerindex niet-reentrant is, maar voor verschillende indices wel reentrant mag worden uitgevoerd.

Met betrekking tot het samenspel met verdere modules verwijzen gerelateerde eisen naar nageschakelde acties, die in de onderhavige release echter als obsoleet zijn geclassificeerd:

• Conform [SWS_EthIf_00267] (OBSOLETE) was in de context van deze functie voorzien om EthSwt_SetSwitchPortMode voor alle poorten van een switch-poortgroep aan te roepen, mits er een overeenkomstige aansturingsreferentie bestaat, en bij ETH_MODE_DOWN conflicten met actieve groepen op te lossen.
• Conform [SWS_EthIf_00413] (OBSOLETE) was in de context van deze functie voorzien om bij een aanwezige transceiver-referentie EthTrcv_TransceiverLinkStateRequest met ETHTRCV_LINK_STATE_ACTIVE respectievelijk ETHTRCV_LINK_STATE_DOWN aan te roepen, afhankelijk van het feit of eerder ETH_MODE_ACTIVE of ETH_MODE_DOWN was aangevraagd.

Gebruik en semantiek

De functie EthIf_TrcvModeIndication dient als notificatie-interface van de Ethernet-interface, die wordt aangeroepen zodra een moduswijziging van de transceiver is uitgelezen [SWS_EthIf_00232]. Ze is beschikbaar via het headerbestand EthIf.h en heeft de service-ID 0x0f [SWS_EthIf_00232].

De uitvoering van de functie zelf is synchroon gespecificeerd, terwijl de aanroep asynchroon plaatsvindt wanneer de moduswijziging is vastgesteld [SWS_EthIf_00232]. Indien de functie wordt getriggerd door een voorafgaande aanroep van EthTrcv_SetTransceiverMode, mag ze direct binnen deze triggerende functie worden aangeroepen [SWS_EthIf_00232].

Parameters en retourwaarden

• TrcvIdx: Index van de Ethernet-transceiver in de context van de Ethernet-interface (ingangsparameter) [SWS_EthIf_00232].
• TrcvMode: Gesignaleerde bedrijfsmodus van de Ethernet-transceiver van het type Eth_ModeType (ingangsparameter) [SWS_EthIf_00232].
• Retourwaarde: Geen (void) [SWS_EthIf_00232].

Gelijktijdigheid en re-entrantie

De functie is voor dezelfde index niet-re-entrant, maar voor verschillende indices re-entrant gespecificeerd [SWS_EthIf_00232]. De specificatietabel vermeldt hierbij Ctrl Idx, wat in de context van deze transceiver-interface vermoedelijk moet worden geïnterpreteerd als een verwijzing naar de transceiver- respectievelijk controller-index [SWS_EthIf_00232]. Vraag Q-c0123f1ef0e4ec71 (open)

De functie EthIf_SwitchPortModeIndication dient voor de Ethernet Interface (EthIf) als asynchrone notificatie-interface over een moduswijziging van een Ethernet-switchpoort gemeld door de Ethernet Switch Driver [SWS_EthIf_91055].

Gebruik en samenspel

De EthIf bepaalt de verwachte notificaties aan de hand van de configuratie van de desbetreffende switchpoort: als de switchpoort refereert aan een transceiver (EthTrcv), verwacht de EthIf in plaats daarvan een notificatie via EthIf_TrcvModeIndication(); anders wordt de notificatie van de Ethernet Switch Driver via EthIf_SwitchPortModeIndication() verwacht [SWS_EthIf_91055].

• SwitchIdx: Index van de Ethernet-switch in de context van de Ethernet Switch Driver [SWS_EthIf_91055].
• SwitchPortIdx: Index van de poort op de geadresseerde Ethernet-switch [SWS_EthIf_91055].
• PortMode: De nieuw gemelde modus van de switchpoort van het type Eth_ModeType [SWS_EthIf_91055].

Uitvoeringseigenschappen en beperkingen

De functie heeft geen retourwaarde (void) en heeft de service-ID 0x46 [SWS_EthIf_91055]. Ze is gespecificeerd als asynchroon (Asynchronous) en niet-re-entrant (Non Reentrant) [SWS_EthIf_91055]. Aanroepers moeten er daarom voor zorgen dat concurrerende aanroepen voor deze service worden vermeden. Specifieke DET- of DEM-foutmeldingen zijn voor deze functie niet gedefinieerd in de payload.

Gebruik en aanroepcontext

De functie EthIf_SleepIndication dient als notificatie-interface van de Ethernet-interface. Ze wordt aangeroepen door het desbetreffende Ethernet-transceiver-stuurprogramma (EthTrcv) zodra dit een slaapindicatie op het netwerk heeft geregistreerd [SWS_EthIf_91006]. Als enige invoerparameter wordt TrcvIdx meegegeven, die de index van de signalerende Ethernet-transceiver in de context van de module EthIf eenduidig identificeert [SWS_EthIf_91006]. De functie heeft noch invoer-/uitvoer- noch retourwaarden en voert de notificatie synchroon uit [SWS_EthIf_91006].

Hardware-interactie

Een essentiële usecase is de inzet met Ethernet-hardware die conform de specificatie OPEN Alliance TC10 is ontworpen [SWS_EthIf_91006]. In dit scenario detecteert de transceiver (PHY) op hardwareniveau een Sleep.Indication, die werd getriggerd door een slaapwens (Sleep.Request) van de direct verbonden linkpartner [SWS_EthIf_91006].

Gelijktijdigheid en beperkingen

De interface is gedefinieerd als synchroon en re-entrant en wordt beschikbaar gesteld via het headerbestand EthIf.h (service-ID 0x68) [SWS_EthIf_91006]. Bij de systeemintegratie dient er rekening mee te worden gehouden dat het element als ontwerp is gemarkeerd met de tag atp.Status=draft [SWS_EthIf_91006]. Concrete foutafhandelingsroutines of DET-foutcodes zijn in de specificatieomvang niet gedefinieerd; vermoedelijk vindt een formele foutcontrole pas plaats in toekomstige specificatiestatussen. Vraag Q-680af6c43439167f (open)

Gebruik en aanroepcontext

De functie EthIf_MainFunctionRx vervult in de Ethernet-interface (EthIf) de centrale taak om in polling-modus te controleren op nieuw binnengekomen dataframes en bijbehorende ontvangstindicaties (Reception Indications) naar bovenliggende lagen te triggeren [SWS_EthIf_00097]. Ze is gedefinieerd met de signatuur void EthIf_MainFunctionRx (void), accepteert derhalve geen aanroepparameters en levert geen retourwaarde op [SWS_EthIf_00097]. Als service-ID is de hexadecimale waarde 0x20 vastgelegd [SWS_EthIf_00097].

De functie wordt beschikbaar gesteld via het headerbestand SchM_EthIf.h [SWS_EthIf_00097]. Dit suggereert de interpretatie dat de aanroep ervan periodiek plaatsvindt door de Schedule Manager (SchM) dan wel het besturingssysteem binnen een cyclische taakcontext van de basissoftware.

Gelijktijdigheid en foutafhandeling

Aangezien de controle en het doorsturen van ontvangen frames in polling-modus is gespecificeerd [SWS_EthIf_00097], vereist een soepele ontvangstwerking een adequate timing van de aanroep. Een vertraagde uitvoering zal vermoedelijk leiden tot vertragingen bij het doorsturen van inkomende berichten naar hogere softwarelagen. Vraag Q-554ef0cf302c3aa3 (open) Specifieke foutcodes, ontwikkelingsfouten (DET) of foutmeldingen aan de DEM worden in de specificatie niet vermeld voor deze functie.

De hoofdfunctie EthIf_MainFunctionTx dient voor de cyclische afhandeling van verzendoperaties en statusopvragingen binnen de Ethernet-interfacemodule [SWS_EthIf_00113]. Ze heeft de hexadecimale service-ID 0x21 en wordt conform haar signatuur void EthIf_MainFunctionTx (void) uitgevoerd zonder overdrachtsparameters en zonder retourwaarde, zodat de volledige verwerking statusgebaseerd plaatsvindt [SWS_EthIf_00113].

Tijdens bedrijf vervult de service twee centrale taken bij de Ethernet-communicatie:

• Verzendbevestigingen: In polling-modus geeft de functie bevestigingen voor succesvol voltooide transmissies (Transmission Confirmations) af aan bovenliggende lagen [SWS_EthIf_00113].
• Transceiverstatussen: Ze bewaakt en controleert het systeem op opgetreden statuswijzigingen van de aangesloten Ethernet-transceivers [SWS_EthIf_00113].

Met betrekking tot de systeemintegratie is de interface beschikbaar via het headerbestand SchM_EthIf.h [SWS_EthIf_00113]. Interpretatie: Uit de beschikbaarstelling via SchM_EthIf.h volgt vermoedelijk dat de aanroep periodiek plaatsvindt door de BSW-scheduler (SchM) in de context van een cyclische taak. Vraag Q-b9dde07f9cc74a95 (open) Dit waarborgt dat openstaande verzendbevestigingen in polling-modus en transceiverstatusovergangen regelmatig en zonder interrupt-afhankelijkheid worden verwerkt.

Specifieke foutcodes, afzonderlijke foutafhandelingsroutines via DET of DEM evenals re-entrantie-eisen zijn in de onderhavige specificatieomvang niet gedefinieerd voor deze service en worden daarom niet vermeld.

Gebruik en semantiek

De functie EthIf_MainFunctionState dient voor het cyclisch opvragen (polling) van status- en diagnose-informatie van de aangesloten Ethernet-communicatiehardware zoals Ethernet-transceivers en Ethernet-switch-poorten [SWS_EthIf_91104]. Hiertoe behoren bijvoorbeeld de verbindingsstatus (link state) en de signaalkwaliteit [SWS_EthIf_91104]. De functie heeft invoer- noch uitvoerparameters en retourneert geen waarde (void EthIf_MainFunctionState(void), service-ID 0x05) [SWS_EthIf_91104]. Het uitvoeringsgedrag is gespecificeerd als asynchroon [SWS_EthIf_91104].

Gelijktijdigheid en aanroepvoorwaarden

De functie is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_EthIf_91104]. Ze mag daarom op geen enkel moment parallel of zichzelf onderbrekend worden uitgevoerd. Aangezien de interface beschikbaar wordt gesteld via het headerbestand EthIf_SchM.h [SWS_EthIf_91104], zal de periodieke aanroep doorgaans plaatsvinden in de taakcontext van de BSW-scheduler (SchM). Vraag Q-10d02355b276be90 (open)

Interactie en configuratie

Conform [SWS_EthIf_00407] moet EthIf_MainFunctionState de hardware-informatie strikt opvragen met de geconfigureerde periodiciteit EthIfMainFunctionStatePeriod. Dit waarborgt een regelmatige actualisering van de fysieke interfaceparameters in de Ethernet-interface.

De datastructuur EthIf_SignalQualityResultType ([SWS_EthIf_91057]) dient voor de registratie en diagnose van de verbindingskwaliteit op Ethernet-niveau en wordt beschikbaar gesteld via het headerbestand EthIf.h.

De structuur bundelt drie meetgrootheden van het basistype uint32:

• ActualSignalQuality: representeert de actueel aanwezige signaalkwaliteit van de Ethernet-verbinding.
• HighestSignalQuality: legt de hoogste gemeten signaalkwaliteit van de verbinding sinds de laatste reset vast.
• LowestSignalQuality: documenteert de laagste gemeten signaalkwaliteit van de verbinding sinds de laatste reset.

In samenspel met de module EthIf weerspiegelen de uiterste waarden het verloop van de verbindingsstabiliteit. Het resetten van de intern opgeslagen historiewaarden wordt aangestuurd via specifieke interfaces:

• Voor een via TrcvIdx gespecificeerde transceiver reset de functie EthIf_ClearTrcvSignalQuality de opgeslagen signaalkwaliteitswaarden ([SWS_EthIf_00400]).
• Voor een via SwitchIdx en SwitchPortIdx geïdentificeerde switch-poort wist EthIf_ClearSwitchPortSignalQuality de opgeslagen signaalkwaliteitswaarden ([SWS_EthIf_00404]).

Interpretatie: Aangezien de payload geen specifieke leesfunctie noemt, dient de structuur vermoedelijk als uitvoerparameter van overeenkomstige statusopvragingen voor transceivers en switch-poorten, om de actuele signaalkwaliteit te vergelijken met de uiterste waarden. Vraag Q-8e5f2914bade574c (open)