Ethernet Driver (Eth)

De functie Eth_Init dient voor de initialisatie van de Ethernet-driver [SWS_Eth_00027]. Ze wordt gedeclareerd via het headerbestand Eth.h, heeft service-ID 0x01 en heeft geen retourwaarde (void) [SWS_Eth_00027]. Als invoerparameter verwacht ze CfgPtr, die wijst naar een implementatiespecifieke configuratiestructuur van het type Eth_ConfigType [SWS_Eth_00027]. De aanroep geschiedt synchroon en is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_Eth_00027].

In de operationele afloop vormt Eth_Init de fundamentele voorwaarde voor het werken met de module. Alle overige functies vereisen dwingend een voorafgaande controllerinitialisatie door Eth_Init [SWS_Eth_00070], [SWS_Eth_00167], [SWS_Eth_00185]. Deze afhankelijkheid is bindend voorgeschreven voor diverse controllerdiensten van de driver [SWS_Eth_00189], [SWS_Eth_00194], [SWS_Eth_00199], [SWS_Eth_00232].

Voor het geval van een niet-geïnitialiseerde toegang is voorzien in een gerichte foutafhandeling: bij geactiveerde detectie van ontwikkelingsfouten (Development Error Detection, DET) controleren de driverfuncties of de service Eth_Init vooraf correct is aangeroepen [SWS_Eth_00066]. Als deze controle niet slaagt, genereren ze de ontwikkelingsfout ETH_E_UNINIT [SWS_Eth_00164], [SWS_Eth_00182], [SWS_Eth_00187], [SWS_Eth_00196]. Is DET daarentegen gedeactiveerd, dan weigeren de getroffen functies de uitvoering en signaleren ze de ontoelaatbare toestand door het retourneren van de status E_NOT_OK [SWS_Eth_00228], [SWS_Eth_00235], [SWS_Eth_00248], [SWS_Eth_00252].

De functie Eth_SetControllerMode dient voor het activeren (ETH_MODE_ACTIVE) of deactiveren (ETH_MODE_DOWN) van de via parameter CtrlIdx geadresseerde Ethernet-controller [SWS_Eth_00041]. In AUTOSAR Classic R20-11 is deze dienst geclassificeerd als verouderd (obsolete) [SWS_Eth_00041].

De uitvoering van de dienst is asynchroon en niet-re-entrant (Non Reentrant) [SWS_Eth_00041]. Als retourwaarde levert de functie E_OK op bij succesvolle initiatie of E_NOT_OK wanneer de bedrijfsmodus niet gewisseld kon worden [SWS_Eth_00041]. Interpretatie: Aangezien de aanroep als asynchroon is gespecificeerd, maar er in de payload geen callback is gedefinieerd, zal de daadwerkelijke statusovername vermoedelijk hardwarematig op de achtergrond van het stuurprogramma na terugkeer van de functie worden voltooid. Vraag Q-d7ec04578e921eb9 (open)

Indien de controller respectievelijk diens verzend- en ontvangstcommunicatie via Eth_SetControllerMode wordt gedeactiveerd, gelden bindende bufferopschoningen:

• Alle vergrendelde verzendbuffers (locked transmit buffers) moeten worden vrijgegeven [SWS_Eth_00137] [SWS_Eth_00280].
• Alle openstaande verzendbuffers (pending transmit buffers) moeten eveneens worden vrijgegeven [SWS_Eth_00138] [SWS_Eth_00281].

Vanwege de eigenschap Non Reentrant mag de functie voor dezelfde of verdere controller-instanties niet gelijktijdig worden uitgevoerd [SWS_Eth_00041]. Specifieke DET- of DEM-foutmeldingen zijn niet vermeld; foutstatussen worden aan de aanroeper meegedeeld via de retourwaarde E_NOT_OK [SWS_Eth_00041].

De functie Eth_SetControllerMode (service-ID 0x03, ter beschikking gesteld via Eth.h) dient voor het activeren en deactiveren van de ontvangst- en zendcommunicatie (Rx/Tx) van een specifieke Ethernet-controller [SWS_Eth_91009].

Gebruik en aanroepvoorwaarden

De uitvoering van de functie verloopt asynchroon en is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Eth_91009]. Bij de aanroep worden twee parameters doorgegeven:

• CtrlIdx: Index van de desbetreffende controller in de context van de Ethernet-driver [SWS_Eth_91009].
• CtrlMode: Doelmodus voor de controller, hetzij ETH_MODE_ACTIVE voor het activeren van de Rx/Tx-communicatie of ETH_MODE_DOWN voor het deactiveren ervan [SWS_Eth_91009].

Als retourwaarde levert de functie de status Std_ReturnType: E_OK signaleert een succesvolle uitvoering, terwijl E_NOT_OK aangeeft dat de modus van de controller niet kon worden gewisseld [SWS_Eth_91009].

Interactie en bufferbeheer

Wordt de Rx/Tx-communicatie van de geïndexeerde controller via Eth_SetControllerMode gedeactiveerd (modus ETH_MODE_DOWN), dan moeten dwingend opschoonacties voor de zendbuffers worden uitgevoerd:

• Alle vergrendelde zendbuffers (locked transmit buffers) moeten worden vrijgegeven [SWS_Eth_00280].
• Alle openstaande zendbuffers (pending transmit buffers) moeten eveneens worden vrijgegeven [SWS_Eth_00281].

De actuele bepalingen voor het vrijgeven van vergrendelde en openstaande buffers evenals de functiedefinitie zelf hebben de status „draft” [SWS_Eth_91009], [SWS_Eth_00280], [SWS_Eth_00281]. Zij vervangen de historisch voorafgaande requirements [SWS_Eth_00137] en [SWS_Eth_00138], die als obsoleet zijn geclassificeerd.

De synchrone interface Eth_UpdatePhysAddrFilter wordt beschikbaar gesteld via het headerbestand Eth.h en heeft de service-ID 0x12 [SWS_Eth_00152]. De functie dient ertoe een fysiek adres toe te voegen aan of te verwijderen uit het filter van een geïndexeerde Ethernet-controller [SWS_Eth_00152].

De parameters van de functie omvatten drie invoerwaarden [SWS_Eth_00152]:

• CtrlIdx: bepaalt de index van de desbetreffende Ethernet-controller binnen de drivercontext [SWS_Eth_00152].
• PhysAddrPtr: pointer naar het geheugengebied met het fysieke bestemmingsadres (MAC-adres) in netwerk-bytevolgorde; dit is het multicast-bestemmingsadres van het Layer-2-Ethernet-pakket [SWS_Eth_00152].
• Action: geeft via het opsommingstype Eth_FilterActionType aan of het opgegeven adres aan het filter van de controller wordt toegevoegd of daaruit wordt verwijderd [SWS_Eth_00152].

De functie retourneert een status van het type Std_ReturnType: E_OK bevestigt de succesvolle wijziging van het filter, terwijl E_NOT_OK meldt dat het filter niet gewijzigd kon worden [SWS_Eth_00152]. Als de Ethernet-controller hardwarematig niet in staat is de filtering zelfstandig uit te voeren, moet de filtertaak door de software worden gerealiseerd [SWS_Eth_00152].

Voor de uitvoering geldt een strikte re-entrantiebeperking: de functie is niet re-entrant voor dezelfde controllerindex (CtrlIdx), maar mag voor onderling verschillende controllerindices gelijktijdig en re-entrant worden aangeroepen [SWS_Eth_00152].

De functie Eth_WriteMii dient ertoe een register van een Ethernet-transceiver via de MII-interface te configureren of een door de transceiver bereitgestelde functie te triggeren [SWS_Eth_00058]. De declaratie is beschikbaar via de header Eth.h [SWS_Eth_00058].

Gebruik en parameters

De aanroep vindt plaats met de service-ID 0x05 en verwerkt vier invoerparameters [SWS_Eth_00058]:

• CtrlIdx: Index van de Ethernet-controller in de context van de Ethernet-driver [SWS_Eth_00058].
• TrcvIdx: index van de transceiver op de MII-interface [SWS_Eth_00058].
• RegIdx: index van het te beschrijven transceiverregister op de MII [SWS_Eth_00058].
• RegVal: de 16-bits waarde die naar het geadresseerde register moet worden geschreven [SWS_Eth_00058].

De uitvoering van de dienst is als asynchroon gespecificeerd [SWS_Eth_00058]. Dit betekent dat de feitelijke schrijfbewerking via de hardware-interface doorgaans op de achtergrond zal worden afgehandeld, terwijl de functie na acceptatie van het verzoek onmiddellijk terugkeert. Vraag Q-0f9a9e682985d796 (open)

Retourwaarden en beperkingen

Als retourwaarde levert de functie het type Std_ReturnType [SWS_Eth_00058]:

• E_OK: de schrijfopdracht is succesvol geaccepteerd [SWS_Eth_00058].
• E_NOT_OK: de dienst is afgewezen [SWS_Eth_00058].

Met betrekking tot gelijktijdigheid is Eth_WriteMii gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Eth_00058]. Aanroepen mogen daarom niet gelijktijdig zonder passende synchronisatie door de aanroeper worden uitgevoerd.

Gebruik en parameters

De functie Eth_ReadMii (service-ID 0x06) dient voor het uitlezen van een transceiverregister via de MII-interface en wordt beschikbaar gesteld via het headerbestand Eth.h [SWS_Eth_00064]. Bij aanroep identificeert CtrlIdx de betreffende Ethernet-controller in de stuurprogrammacontext, TrcvIdx de aangesproken transceiver op de MII en RegIdx het concrete transceiverregister [SWS_Eth_00064]. De vastgestelde registerwaarde wordt geschreven naar het geheugengebied waarnaar de pointer RegValPtr verwijst [SWS_Eth_00064].

Uitvoering en gelijktijdigheid

De uitvoering vindt asynchroon plaats (Asynchronous) [SWS_Eth_00064]. Een retourwaarde van E_OK bevestigt daarbij louter dat de service dan wel de leesopdracht succesvol is geaccepteerd (Service accepted), terwijl E_NOT_OK duidt op een afwijzing van de opdracht (Service denied) [SWS_Eth_00064]. Vanwege het asynchrone karakter zal het voor RegValPtr overgedragen geheugengebied vermoedelijk geldig moeten blijven tot de definitieve afronding van het leesproces. Vraag Q-04a94624b96bf51f (open) Aangezien de functie bovendien is aangemerkt als niet-re-entrant (Non Reentrant) [SWS_Eth_00064], mogen aanroepers gelijktijdige toegangen via verschillende taken of interrupt-contexten niet zonder externe synchronisatie uitvoeren.

Foutafhandeling

Kan het stuurprogramma het leesverzoek niet accepteren, dan wordt de aanroep direct met E_NOT_OK beantwoord [SWS_Eth_00064]. Specifieke foutcodes, DET-runtimecontroles of DEM-diagnose-events zijn voor deze functie niet opgenomen in de elementgebonden specificatiegegevens.

De synchrone functie Eth_EnableEgressTimeStamp activeert de registratie van zendtijdstempels (Egress Time Stamping) voor een specifiek berichtobject van de Ethernet-driver [SWS_Eth_00186]. De aanroep geschiedt via de header Eth.h met de service-ID 0x17 en levert geen retourwaarde op [SWS_Eth_00186].

Bij de aanroep moeten de volgende invoerparameters worden meegegeven [SWS_Eth_00186]:

• CtrlIdx: index van de geadresseerde Ethernet-controller [SWS_Eth_00186].
• BufIdx: index van de berichtenbuffer waarvoor de bovenliggende applicatie het genereren van een egress-tijdstempel verwacht [SWS_Eth_00186].

Met betrekking tot gelijktijdigheid is de functie gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Eth_00186]. Een parallelle aanroep voor dezelfde of verdere buffers moet daarom aan de aanroepzijde worden gesynchroniseerd resp. vermeden.

Het gedrag van de hardware varieert afhankelijk van de controllerimplementatie: sommige hardware slaat de markering voor het zendtijdstempel permanent op, terwijl andere controllers de activering dwingend vereisen vóór elke overdracht [SWS_Eth_00186]. Interpretatie: voor een hardware-onafhankelijke aansturing is het daarom wellicht raadzaam om de functie vóór elk verzendproces van de gewenste buffer aan te roepen. Vraag Q-c2b8d2db03e9d13b (open) Een deactiveringsinterface bestaat niet, omdat het berichttype conform het netwerkontwerp altijd met tijdstempel wordt verzonden [SWS_Eth_00186].

Gebruik

De synchrone functie Eth_ProvideTxBuffer verleent toegang tot een Ethernet-zendbuffer van de FIFO die aan de meegegeven prioriteit is toegewezen [SWS_Eth_00077]. Ze wordt beschikbaar gesteld via de header Eth.h en is gespecificeerd als re-entrant [SWS_Eth_00077]. Via de invoerparameters worden de controllerindex CtrlIdx en de frameprioriteit Priority voor de FIFO-selectie meegegeven [SWS_Eth_00077]. De in-outparameter LenBytePtr geeft de gewenste buffergrootte door en levert na de aanroep de daadwerkelijk toegekende bytegrootte terug [SWS_Eth_00077]. De uitvoerparameters BufIdxPtr (bronindex voor latere verzoeken) en BufPtr (pointer naar de buffer) stellen de referenties naar het geheugengebied beschikbaar [SWS_Eth_00077].

Foutafhandeling en retourwaarden

De functie signaleert het resultaat via retourwaarden van het type BufReq_ReturnType [SWS_Eth_00077]:

• BUFREQ_OK: de zendbuffer is succesvol beschikbaar gesteld [SWS_Eth_00077].
• BUFREQ_E_BUSY: alle bufferbronnen zijn momenteel bezet [SWS_Eth_00077].
• BUFREQ_E_OVFL: de aangevraagde buffer is te groot [SWS_Eth_00077].
• BUFREQ_E_NOT_OK: er is een ontwikkelingsfout gedetecteerd [SWS_Eth_00077].

Samenspel

Wanneer EthCtrlConfigSwBufferHandling is geconfigureerd op TRUE, wordt intern een tupel opgeslagen bestaande uit de aan BufIdxPtr meegegeven bufferindex van de software-bufferpool en de opgegeven prioriteit Priority [SWS_Eth_00267].

Wordt vervolgens Eth_Transmit() aangeroepen, dan wordt de gegeven bufferindex toegewezen aan die software-FIFO waarvan de configuratie EthCtrlConfigEgressFifoPriorityAssignment overeenkomt met de eerder in Eth_ProvideTxBuffer() meegegeven prioriteit [SWS_Eth_00268].

Gebruik en aanroepcontext

De synchrone interface Eth_Transmit start het verzendproces voor een eerder beschikbaar gestelde en gevulde Ethernet-zendbuffer [SWS_Eth_00087]. Ze accepteert de volgende parameters:

• CtrlIdx: index van de Ethernet-controller binnen de context van de driver [SWS_Eth_00087].
• BufIdx: index van de over te dragen bufferbron [SWS_Eth_00087].
• FrameType: specifiek Ethernet-frametype [SWS_Eth_00087].
• TxConfirmation: schakelaar voor de activering van de verzendbevestiging [SWS_Eth_00087].
• LenByte: gegevenslengte van de payload in bytes [SWS_Eth_00087].
• PhysAddrPtr: pointer naar het fysieke bestemmingsadres (MAC-adres) in netwerk-bytevolgorde [SWS_Eth_00087].

De retourwaarde van het type Std_ReturnType signaleert met E_OK de succesvolle initiatie van de overdracht en met E_NOT_OK een mislukking [SWS_Eth_00087].

Samenspel en bufferafhandeling

In het kader van de verzendafloop wijst Eth_Transmit de bufferpointer BufIdx toe aan de software-FIFO waarvan het configuratie-element EthCtrlConfigEgressFifoPriorityAssignment overeenkomt met de eerder bij Eth_ProvideTxBuffer() vastgelegde prioriteit [SWS_Eth_00268]. Met de aanroep worden de desbetreffende berichten vanuit de software-FIFO's naar de hardware-FIFO overgebracht [SWS_Eth_00269].

Concurrency

De functie is re-entrant voor aanroepen met verschillende bufferindices (BufIdx) en verschillende controllerindices (CtrlIdx) [SWS_Eth_00087].

De synchrone functie Eth_Receive dient voor de ontvangst van een Ethernet-frame uit een specifieke FIFO-buffer van een Ethernet-controller [SWS_Eth_00095]. Ze heeft geen retourwaarde, maar levert het resultaat van de query via de pointer RxStatusPtr van het type Eth_RxStatusType terug aan de aanroeper [SWS_Eth_00095]. Deze uitvoerparameter geeft aan of een frame succesvol is ontvangen en of er voor de desbetreffende FIFO-buffer nog verdere frames klaarstaan om te worden opgehaald [SWS_Eth_00095].

Parameters en aanroepcontext

Als invoerparameter vereist de functie de controllerindex CtrlIdx binnen de Ethernet-driver en de index FifoIdx van de uit te lezen FIFO [SWS_Eth_00095]. De functie is gedeclareerd in het headerbestand Eth.h [SWS_Eth_00095]. De aanroep zal doorgaans periodiek plaatsvinden in het kader van een pollingmechanisme door bovenliggende driver- of interfacelagen. Vraag Q-f5ec0693a5887bcf (open)

Gelijktijdigheid en beperkingen

Met betrekking tot gelijktijdigheid is Eth_Receive re-entrant geïmplementeerd voor verschillende FIFO's, maar niet-re-entrant voor dezelfde FIFO [SWS_Eth_00095]. Gelijktijdige aanroepen die dezelfde FIFO van dezelfde controller bevragen, zijn ontoelaatbaar en moeten door de aanroepende software worden uitgesloten.

Samenspel met de Ethernet-interface

In de pollingmodus is de Ethernet-driver verplicht om bij een succesvol ontvangstproces rechtstreeks vanuit de routine Eth_Receive de functie EthIf_RxIndication aan te roepen, om het ontvangen frame bij de bovenste laag te melden voor verdere verwerking [SWS_Eth_00244].

Gebruik en aanroepcontext

De via de header Eth.h beschikbare functie Eth_TxConfirmation dient voor het gericht triggeren van de transmissiebevestiging voor verzonden Ethernet-frames [SWS_Eth_00100]. Deze heeft het service-ID 0x0C en wordt synchroon uitgevoerd [SWS_Eth_00100]. Als enige overdrachtsparameter verwacht de functie CtrlIdx, die de logische index van de aan te spreken controller binnen de instantie van de Ethernet-driver bepaalt [SWS_Eth_00100]. Een retourwaarde bestaat niet (void), en er worden geen uitvoerparameters doorgegeven [SWS_Eth_00100].

Samenspel in het zendverloop

In het samenspel van de lagen verzorgt Eth_TxConfirmation de doorgifte van de zendstatus aan de bovenliggende Ethernet-interface. Voor zover de desbetreffende notificatie is geactiveerd, is de Ethernet-driver ertoe verplicht om EthIf_TxConfirmation met de resultaatwaarde E_OK aan te roepen om een succesvolle transmissie te signaleren [SWS_Eth_00243]. In de polling-modus vindt deze aanroep expliciet plaats vanuit de context van de routine Eth_TxConfirmation, terwijl deze in de interruptgestuurde modus als alternatief direct vanuit de interruptroutine wordt verstuurd [SWS_Eth_00243].

Re-entrantie en uitvoeringsvoorwaarden

Voor de uitvoering geldt de beperking dat Eth_TxConfirmation als niet-re-entrant (Non Reentrant) is gedefinieerd [SWS_Eth_00100]. Gelijktijdige aanroepen voor dezelfde controller moeten daarom door de aanroeper worden voorkomen. De aanroep zal bij polling-bedrijf typisch cyclisch plaatsvinden door een bovenliggende programmabesturing. Vraag Q-c19295838459b689 (open) Specifieke foutcodes evenals voorschriften voor DET- of DEM-meldingen zijn niet in de functiespecificatie vermeld, waardoor een afzonderlijke foutafhandeling vervalt.

Gebruik en aanroepcontext

De functie Eth_MainFunction heeft de signatuur void Eth_MainFunction(void) en wordt via het headerbestand SchM_Eth.h ter beschikking gesteld [SWS_Eth_00171]. Hieruit kan worden geïnterpreteerd: De aanroep zal vermoedelijk cyclisch door de Schedule Manager (SchM) in een taakgebaseerde context plaatsvinden, aangezien er geen overdrachtsparameters of retourwaarden zijn gedefinieerd. Vraag Q-690a2dc372d49c6a (open)

Functionaliteit en polling

De hoofdtaak van de functie bestaat uit het pollen van toestandsveranderingen evenals het controleren op controllerfouten en verloren gegane Ethernet-frames [SWS_Eth_00171]. Stelt de functie vast dat de modus van de Ethernet-controller is gewijzigd, dan roept zij de functie EthIf_CtrlModeIndication aan om de bovenliggende laag over de toestandsverandering te informeren [SWS_Eth_00171].

Verwerkingsvolgorde in het zendpad

In de context van Eth_MainFunction() is een vaste volgorde voor de verwerking van software-FIFO's voorgeschreven [SWS_Eth_00270]:

• Eerst worden alle SW-FIFO's doorlopen en worden hun tegoedrekeningen (Credits Account) bijgewerkt [SWS_Eth_00270].
• Vervolgens worden alle SW-FIFO's opnieuw doorlopen en gecontroleerd op verzendklare berichten [SWS_Eth_00270].
• Voor elke doorlopen SW-FIFO wordt vervolgens de transmissie ondernomen [SWS_Eth_00270].

Het generieke enumeratietype Eth_ModeType dient in de lagen van de Ethernet-communicatiestack (zoals EthIf, Eth, EthSwt en EthTrcv) ertoe het Ethernet-communicatiekanaal te activeren of te deactiveren, evenals de bijbehorende hardware (zoals Ethernet-controller, Ethernet-switch-port of Ethernet-transceiver) in een energiebesparende slaapstand dan wel actieve modus te plaatsen [SWS_Eth_00158].

Het type is beschikbaar via het headerbestand Eth_GeneralTypes.h en definieert het volgende waardebereik [SWS_Eth_00158]:

• ETH_MODE_DOWN (0x00): Deactiveert het Ethernet-communicatiekanaal en brengt de bijbehorende hardware in een energiebesparende slaapmodus (Low-Power Sleep Mode) [SWS_Eth_00158].
• ETH_MODE_ACTIVE (0x01): Activeert het Ethernet-communicatiekanaal en brengt de hardware in de bedrijfsmodus (Power-On Mode) [SWS_Eth_00158].

Met betrekking tot de levenscyclus en het gebruik dient te worden opgemerkt dat Eth_ModeType in Release R20-11 is gemarkeerd met de status obsolete [SWS_Eth_00158]. In nieuwe ontwikkelingen moet het gebruik van dit type daarom worden vermeden, aangezien verouderde interfacetypes in toekomstige standaarden typisch worden vervangen door modernere controlestructuren.

Het enumeratietype Eth_ModeType wordt gedeclareerd via Eth_GeneralTypes.h en dient als laagoverstijgend modustype in de AUTOSAR-Ethernet-communicatiestack ([SWS_Eth_91008]). Het wordt gebruikt in modules zoals EthIf, Eth, EthSwt en EthTrcv om communicatiekanalen gericht te activeren of te deactiveren en de bijbehorende hardwarecomponent (Ethernet-controller, switch-poorten of transceiver) om te schakelen tussen een energiebesparende slaapmodus en de actieve bedrijfsmodus ([SWS_Eth_91008]).

Het type omvat drie toestanden voor modusbesturing ([SWS_Eth_91008]):

• ETH_MODE_DOWN (0x00): deactiveert de Rx- en Tx-communicatie en brengt de bijbehorende hardware in een low-power-slaapmodus. Voor zover de hardware dit ondersteunt, wordt tegelijkertijd een slaapproces geïnitieerd (bijvoorbeeld het verzoeken van sleep op de datalijn conform OPEN Alliance TC10).
• ETH_MODE_ACTIVE (0x01): activeert de Rx- en Tx-communicatie en schakelt de bijbehorende hardware naar de reguliere bedrijfsmodus (power-on).
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST (0x02): Activeert de Rx- en Tx-communicatie, brengt de hardware in de bedrijfsmodus en triggert bovendien een wekverzoek op het netwerk, voor zover de hardware over wekcapaciteiten beschikt (zoals wake-up op de datalijn volgens OPEN Alliance TC10).

In de interactie binnen de stack ondersteunt Eth_ModeType in het bijzonder het doorgeven van wekverzoeken vanuit de servicelaag (ComM) via de tussenlagen omlaag naar de communicatiedrivers (EthTrcv), waardoor hardware met wake-up- en sleep-functionaliteit op de datalijn naar behoefte wordt aangestuurd ([SWS_Eth_91008]).

Het enumeratietype Eth_StateType wordt via de header Eth_GeneralTypes.h ter beschikking gesteld en dient conform [SWS_Eth_00159] voor de toestandsbewaking van de Ethernet-driver. Het doel ervan is de ondersteuning van de detectie van ontwikkelingsfouten (Development Error Detection), waarbij de actuele toestand volgens de specificatie beschikbaar moet zijn voor debugging-doeleinden ([SWS_Eth_00159]).

Voor het toestandsbeheer definieert Eth_StateType twee discrete enumeratiewaarden ([SWS_Eth_00159]):

• ETH_STATE_UNINIT (waarde 0x00): Geeft aan dat de Ethernet-driver nog niet geconfigureerd is ([SWS_Eth_00159]).
• ETH_STATE_INIT (waarde 0x01): Geeft aan dat de Ethernet-driver succesvol geconfigureerd is ([SWS_Eth_00159]).

Wat betreft de foutafhandeling en het samenspel vormt dit toestandstype de basis voor de interne foutdetectie. Er mag van worden uitgegaan dat driver-API's deze toestand opvragen en aanroepen weigeren zolang de driver zich in de niet-geïnitialiseerde toestand ETH_STATE_UNINIT bevindt ([SWS_Eth_00159]). Vraag Q-35a17e3267274d70 (open) Pas wanneer de driver is overgegaan naar de toestand ETH_STATE_INIT, geldt deze als geconfigureerd en operationeel ([SWS_Eth_00159]). Aangezien de typedefinitie in Eth_GeneralTypes.h staat, is deze driveroverstijgend beschikbaar ([SWS_Eth_00159]).

Gebruik en waardebereik

Het opsommingstype Eth_RxStatusType wordt conform [SWS_Eth_00162] gedefinieerd in het headerbestand Eth_GeneralTypes.h. Het dient als uitgangsparameter (out parameter) in de functie Eth_Receive(), waarmee de Ethernet-driver meldt of er een Ethernet-frame is ontvangen en of er vervolgens verdere frames in de buffer aanwezig zijn dan wel gegevens verloren zijn gegaan [SWS_Eth_00162].

De specificatie definieert voor dit type drie discrete enumeratiewaarden [SWS_Eth_00162]:

• ETH_RECEIVED (0x00): er is een Ethernet-frame ontvangen; in de controller zijn geen verdere frames meer beschikbaar.
• ETH_NOT_RECEIVED (0x01): er is geen Ethernet-frame ontvangen; er zijn geen verdere frames aanwezig.
• ETH_RECEIVED_MORE_DATA_AVAILABLE (0x02): er is een Ethernet-frame ontvangen en er staan aanvullende frames klaar om te worden opgehaald.

Samenspel bij de frameverwerking

Bij de aanroep van Eth_Receive() geeft de aanroepende laag een pointer door naar een variabele van het type Eth_RxStatusType. De evaluatie van deze uitvoerparameter stuurt het verdere verloop van de ontvangstcyclus: de retourwaarde ETH_RECEIVED_MORE_DATA_AVAILABLE zal voor de aanroeper vermoedelijk dienen als criterium om Eth_Receive() onmiddellijk opnieuw aan te roepen om resterende frames vlot uit de ontvangstbuffer te verwerken [SWS_Eth_00162]. Vraag Q-4ed309522aa004f8 (open) De toestanden ETH_RECEIVED en ETH_NOT_RECEIVED signaleren daarentegen dat de buffer uitgeput is en er geen verdere gegevens wachten op verwerking. De beschikbaarstelling via Eth_GeneralTypes.h waarborgt daarbij een uniform typegebruik over de modules heen [SWS_Eth_00162].

Gebruik en doel

Het datatype Eth_TxErrorCounterValuesType is conform [SWS_Eth_91004] gespecificeerd als structuur voor statistische tellers voor diagnosedoeleinden in het Ethernet-stuurprogramma. De definitie staat ter beschikking via het headerbestand Eth_GeneralTypes.h. De structuur bundelt meerdere 32-bits tellers (uint32), die specifieke transmissietoestanden en zendbelemmeringen op interfaceniveau weergeven.

Structuurcomponenten en semantiek

De afzonderlijke tellers zijn volgens [SWS_Eth_91004] gebaseerd op gestandaardiseerde netwerk-MIB-definities:

• Tx Dropped No Error Pkts: Aantal uitgaande pakketten dat ondanks een foutloze toestand werd verworpen, bijvoorbeeld om buffergeheugen vrij te maken (RFC1213 ifOutDiscards).
• Tx Dropped Error Pkts: Aantal pakketten dat als gevolg van opgetreden fouten niet kon worden verzonden (RFC1213 ifOutErrors).
• Tx Deferred Trans: Aantal frames waarvan de eerste verzendpoging werd vertraagd omdat het transmissiemedium bezet was (RFC1643 dot3StatsDeferredTransmissions).
• Tx Single Collision en Tx Multiple Collision: Succesvol overgedragen frames waarvan de verzending door respectievelijk precies één of meerdere botsingen werd vertraagd (RFC1643).
• Tx Late Collision: Botsingen die later dan 512 bittijden na het begin van de pakketoverdracht werden gedetecteerd (RFC1643 dot3StatsLateCollisions).
• Tx Excessive Collison: Aantal overdrachten dat als gevolg van te veel botsingen definitief is mislukt (RFC1643 dot3StatsExcessiveCollisions).

Aanroepcontext en beperkingen

Interpretatie: Aangezien het specificatie-uittreksel geen bijbehorende API-functie vermeldt, wordt dit diagnosetype vermoedelijk als uitvoerparameter via een pointer doorgegeven aan overeenkomstige stuurprogrammafuncties voor het opvragen van tellers. Vraag Q-2bfbe59d1fb81938 (open) Specifieke eisen voor foutafhandeling, DET-meldingen of gelijktijdigheid zijn voor deze pure gegevensstructuur in de bronnen niet gedefinieerd.