EEPROM Abstraction (Ea)

De functie Ea_Init dient voor de initialisatie van de module EEPROM Abstraction ([SWS_Ea_00084]). Deze wordt beschikbaar gesteld via het headerbestand Ea.h en brengt de module in operationele toestand ([SWS_Ea_00084]).

Conform de interfacespecificatie in [SWS_Ea_00084] gelden voor de aanroep de volgende eigenschappen en randvoorwaarden:

• Semantiek en service-ID: De aanroep vindt synchroon plaats. Aan de service is service-ID 0x00 toegewezen.
• Re-entrantie: De functie is gespecificeerd als niet-re-entrant (Non Reentrant) en mag daarom niet gelijktijdig worden uitgevoerd.
• Parameters: Als invoerparameter dient ConfigPtr (type const Ea_ConfigType*), die verwijst naar de geselecteerde configuratiedataset. Er bestaan noch in-/uitgangs- noch uitgangsparameters.
• Retourwaarde: De functie levert geen retourwaarde (void).

Wat betreft de aanroepcontext bevat dit item geen expliciete bepalingen; de initialisatie zal typisch centraal plaatsvinden tijdens de opstartfase van de ECU, voordat andere modulefuncties worden uitgevoerd. Vraag Q-b2b40930e5fd0ee7 (open) Specifieke foutcodes, reacties in geval van een fout of meldingen aan DET en DEM worden in [SWS_Ea_00084] niet vermeld.

Gebruik en semantiek

De functie Ea_SetMode dient voor het omschakelen van de bedrijfsmodus van de onderliggende EEPROM-driver ([SWS_Ea_00085]). Deze accepteert als invoerparameter de gewenste modus Mode van het type MemIf_ModeType ([SWS_Ea_00085]). De functie heeft geen retourwaarde (void) en is met service-ID 0x01 beschikbaar via het headerbestand Ea.h ([SWS_Ea_00085]).

De uitvoering vindt asynchroon plaats (Asynchronous), zodat de daadwerkelijke omschakeling van de driver na de aanroep op de achtergrond verder wordt verwerkt ([SWS_Ea_00085]).

Gelijktijdigheid en beperkingen

• Re-entrantie: De functie is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_Ea_00085]). Parallelle aanroepen vanuit verschillende taken of contexten moeten aan de aanroeperszijde worden voorkomen.
• Aanroepcontext en parameters: Er mogen geen in-/uitgangs- of zuivere uitgangsparameters worden doorgegeven; er is uitsluitend voorzien in invoerparameter Mode ([SWS_Ea_00085]).

Gebruik en semantiek

De functie Ea_Read dient voor het uitlezen van gebruikersgegevens uit een gespecificeerd logisch EEPROM-blok via de header Ea.h [SWS_Ea_00086]. Via de parameter Block Number wordt het logische blok geadresseerd, die tevens het startadres ervan in het EEPROM bepaalt [SWS_Ea_00086]. De parameter Block Offset legt de relatieve leesoffset binnen het blok vast, terwijl Length het aantal te lezen bytes definieert [SWS_Ea_00086]. De doelgegevens worden geschreven naar de door Data Buffer Ptr gereferentieerde buffer [SWS_Ea_00086].

De aanroep gedraagt zich asynchroon (Asynchronous): De retourwaarde E_OK signaleert uitsluitend dat de Ea-module de opdrachtaanvraag heeft geaccepteerd, terwijl E_NOT_OK een afwijzing van de opdracht aangeeft [SWS_Ea_00086]. Interpretatie: Aangezien de gegevensoverdracht asynchroon op de achtergrond plaatsvindt, zal de gereferentieerde buffer vermoedelijk tot de volledige uitvoering van de opdracht ongewijzigd en geldig beschikbaar moeten worden gehouden. Vraag Q-34c9b29f373bd6cf (open)

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00086]. Parallele aanroepen vanuit verschillende uitvoeringscontexten zijn bijgevolg niet toegestaan en moeten aan de aanroeperszijde worden gesynchroniseerd.

De functie Ea_Write initieert het asynchroon schrijven van gegevens uit een buffer naar een logisch EEPROM-blok [SWS_Ea_00087]. Zij is gedeclareerd via het headerbestand Ea.h en heeft de service-ID 0x03 [SWS_Ea_00087].

Parameters en retourwaarde

• BlockNumber (ingang, uint16): Duidt het nummer van het logische blok aan en representeert tevens het startadres ervan in het EEPROM [SWS_Ea_00087].
• DataBufferPtr (ingang, const uint8*): Pointer naar de buffer die de te schrijven gegevens bevat [SWS_Ea_00087].
• Retourwaarde (Std_ReturnType): E_OK signaleert dat de schrijfopdracht door de Ea-module voor uitvoering is geaccepteerd; E_NOT_OK betekent dat het verzoek is afgewezen [SWS_Ea_00087].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00087]. Daarom mogen gelijktijdige aanroepen vermoedelijk niet ongecoördineerd zonder voorafgaande externe synchronisatie plaatsvinden. Vraag Q-a52fbcca6963c760 (open) Omdat het schrijfproces asynchroon (Asynchronous) wordt uitgevoerd [SWS_Ea_00087], zal de aanroeper de ter beschikking gestelde buffer DataBufferPtr vermoedelijk tot de volledige beëindiging van de opdracht ongewijzigd in het geheugen moeten behouden. Specifieke DET- of DEM-foutcodes worden in het specificatie-uittreksel van de functie niet genoemd.

De functie Ea_Cancel breekt een momenteel lopend asynchroon proces van de EEPROM Abstraction-module af ([SWS_Ea_00088]). De service wordt beschikbaar gesteld via het headerbestand Ea.h en heeft service-ID 0x04 ([SWS_Ea_00088]).

Met betrekking tot het aanroepgedrag en de interfacedefinitie gelden de volgende kenmerken ([SWS_Ea_00088]):

• Semantiek: De aanroep zelf vindt synchroon plaats (Synchronous), hoewel deze een lopende asynchrone bewerking afbreekt ([SWS_Ea_00088]).
• Parameters en retourwaarde: De signatuur luidt void Ea_Cancel(void). De functie verwacht noch invoer-, noch uitvoer-, noch overdrachtsparameters en heeft geen retourwaarde ([SWS_Ea_00088]).
• Re-entrantie: De interface is gedefinieerd als niet-re-entrant (Non Reentrant) ([SWS_Ea_00088]). Deze mag derhalve niet gelijktijdig vanuit meerdere uitvoeringscontexten of onderbrekende taken worden aangeroepen.

Omdat Ea_Cancel geen opdracht- of blokidentificaties accepteert, heeft het afbreken direct betrekking op het totale asynchrone proces dat momenteel in behandeling is ([SWS_Ea_00088]). Specifieke foutcodes of terugmeldingen aan detectiemechanismen zijn niet opgenomen in de specificatiegegevens. Vermoedelijk vindt de aanroep typisch plaats door bovenliggende lagen zoals de Memory Abstraction Interface (MemIf), om langdurige lees-, schrijf- of wisprocessen gericht voortijdig te beëindigen. Vraag Q-e441cbf6a5097568 (open)

Gebruik

De functie Ea_InvalidateBlock dient voor het invalideren van een door het logische bloknummer aangeduid blok [SWS_Ea_00091]. Deze heeft service-ID 0x07 en wordt beschikbaar gesteld via het headerbestand Ea.h [SWS_Ea_00091]. Als invoerparameter accepteert deze Block Number van het type uint16; deze duidt het logische bloknummer aan en geeft tevens het startadres van het betreffende blok in het EEPROM aan [SWS_Ea_00091]. In-/uitvoerparameters of zuivere uitvoerparameters zijn voor deze service niet gedefinieerd [SWS_Ea_00091].

De aanroep wordt uitgevoerd als een asynchrone bewerking (Asynchronous) [SWS_Ea_00091]. Een retourwaarde E_OK van het type Std_ReturnType bevestigt aan de aanroeper dat de EA-module het opdrachtverzoek voor verdere verwerking heeft geaccepteerd [SWS_Ea_00091].

Foutafhandeling

Kon de EA-module de aangevraagde opdracht niet accepteren, dan wordt de foutwaarde E_NOT_OK geretourneerd [SWS_Ea_00091]. Volgens de specificatie vindt deze teruggave van E_NOT_OK echter uitsluitend plaats wanneer DET geactiveerd is [SWS_Ea_00091].

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00091]. Interpretatie: Aanroepers mogen de functie bijgevolg vermoedelijk niet parallel of onderbrekend aanroepen, aangezien er geen re-entrantie aan de modulezijde wordt gewaarborgd [SWS_Ea_00091]. Vraag Q-81d805517d2eac88 (open)

De functie Ea_EraseImmediateBlock dient voor het wissen van een logisch blok in het EEPROM conform [SWS_Ea_00093].

• Gebruik en semantiek: De aanroep vindt asynchroon plaats ([SWS_Ea_00093]). Via invoerparameter Block Number wordt het nummer van het logische blok doorgegeven, dat tevens het startadres van dit blok in het EEPROM aanduidt ([SWS_Ea_00093]). De retourwaarde is van het type Std_ReturnType: E_OK signaleert dat de aangevraagde opdracht door de module is geaccepteerd ([SWS_Ea_00093]).
• Foutafhandeling: Voor zover de Default Error Tracer (DET) is geactiveerd, retourneert de functie E_NOT_OK wanneer de opdracht niet door de EA-module kon worden geaccepteerd ([SWS_Ea_00093]). Is DET niet geactiveerd, dan zal volgens de bewoordingen van de specificatie in geval van een fout geen E_NOT_OK worden geretourneerd. Vraag Q-5015a2135dbd4723 (open)
• Gelijktijdigheid en beperkingen: De functie is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_Ea_00093]). Aanroepers moeten er daarom voor zorgen dat parallelle of overlappende aanroepen worden vermeden. De declaratie is beschikbaar via het headerbestand Ea.h en de service-ID luidt 0x09 ([SWS_Ea_00093]).

De functie Ea_JobEndNotification dient ertoe de succesvolle voltooiing van een eerder geïnitieerde asynchrone bewerking mee te delen aan module Ea [SWS_Ea_00094]. De interface wordt beschikbaar gesteld via de header Ea.h en heeft service-ID 0x10 [SWS_Ea_00094].

Wat betreft semantiek en interfacedefinitie gelden conform [SWS_Ea_00094] de volgende eigenschappen:

• Signatuur en parameters: De functie verwacht geen overdrachtsparameters (void) en levert geen retourwaarde op (void).
• Synchroniciteit: De aanroep wordt synchroon verwerkt.
• Foutafhandeling: De interface meldt uitsluitend de succesvolle voltooiing; specifieke foutcodes of foutmeldingen zijn voor deze notificatie in het element niet gedefinieerd.

Met betrekking tot gelijktijdigheid is Ea_JobEndNotification gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00094]. Aanroepers moeten er daarom voor zorgen dat er geen parallelle of geneste aanroepen plaatsvinden. Interpretatie: De functie zal typisch worden aangeroepen door een onderliggende driver zodra diens asynchrone verwerking is beëindigd, waarbij de aanroepende context vermoedelijk moet zorgen voor de sequentiële afhandeling zonder wederzijdse verdringing. Vraag Q-296b61b743e7c9b8 (open)

De functie Ea_JobErrorNotification dient als notificatie-interface om de module Ea de fout van een eerder geïnitieerde asynchrone bewerking te melden [SWS_Ea_00095]. Zij is beschikbaar via het headerbestand Ea.h en heeft de service-ID 0x11 [SWS_Ea_00095].

Met betrekking tot de interfacespecificatie en het gebruik gelden de volgende eigenschappen:

• Parameters en retourwaarde: De functie heeft noch overdrachtsparameters (noch in, out of inout) noch een retourwaarde (signatuur void Ea_JobErrorNotification(void)) [SWS_Ea_00095].
• Uitvoeringsgedrag en re-entrantie: De aanroep wordt synchroon verwerkt, maar is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00095]. Aanroepers moeten er daarom voor zorgen dat aanroepen sequentieel plaatsvinden en elkaar niet overlappen door parallelle contexten.
• Samenspel: Omdat de functie het mislukken van een asynchrone opdracht signaleert, zal de aanroep typisch plaatsvinden door een onderliggende hardware-abstractiemodule respectievelijk een geheugendriver zodra een opdracht mislukt (interpretatie). Vraag Q-810e76dee987a5a1 (open)

Specifieke foutcodes, ontwikkelingsfouten (DET) of productiefouten (DEM) zijn voor deze service niet gedefinieerd; een afzonderlijk foutgedrag voor de aanroep zelf wordt in het element niet gespecificeerd.

Gebruik

De functie Ea_MainFunction dient voor het verwerken van aangevraagde opdrachten alsmede de afhandeling van interne beheerbewerkingen binnen de EEPROM Abstraction-module [SWS_Ea_00096]. Conform de interfacedefinitie void Ea_MainFunction(void) accepteert de functie geen overdrachtsparameters en levert deze geen retourwaarde terug aan de aanroeper [SWS_Ea_00096].

Aanroepcontext en gelijktijdigheid

De interface heeft het service-ID 0x12 en wordt gedeclareerd via het headerbestand SchM_Ea.h [SWS_Ea_00096]. Interpretatie: Vanwege de beschikbaarstelling via SchM_Ea.h zal de aanroep typisch cyclisch plaatsvinden door de Schedule Manager (BSW Scheduler) in de taskcontext, om de asynchrone verwerking van geheugenopdrachten continu op de achtergrond voort te zetten. Vraag Q-23f33a40a1e08c34 (open)

Foutafhandeling

Aangezien Ea_MainFunction geen retourwaarde oplevert, worden foutstatussen of de voortgang van de opdracht niet direct via de functieaanroep doorgegeven [SWS_Ea_00096]. Specifieke foutcodes en vereisten voor melding aan de ontwikkelingsinterfacemodule (DET) of de diagnosemodule (DEM) zijn in het onderhavige specificatie-uittreksel niet voor deze service gedefinieerd.

Gebruik en semantiek

De callback-functie NvM_JobEndNotification dient er conform [SWS_Ea_00099] van de onderliggende geheugenabstractie toe om het succesvolle einde van een opdracht zonder fouten aan bovengelegen modules te signaleren. De service heeft de signatuur void NvM_JobEndNotification(void); deze verwacht noch invoer- noch invoer-/uitvoerparameters en retourneert geen waarde [SWS_Ea_00099]. De uitvoering is synchroon gespecificeerd en de interface wordt beschikbaar gesteld via het headerbestand NvM_MemIf.h [SWS_Ea_00099].

Gelijktijdigheid en aanroepvoorwaarden

Met betrekking tot het runtimegedrag is NvM_JobEndNotification geclassificeerd als niet-re-entrant (Non Reentrant) [SWS_Ea_00099]. Aanroepende instanties moeten er daarom voor zorgen dat de melding niet onderbrekend of parallel vanuit meerdere contexten wordt aangeroepen. Interpretatie: De geheugenabstractielaag zal de functie typisch uitvoeren binnen het kader van haar cyclische hoofdfunctie of na afronding van een asynchrone driveropdracht, zodra vaststaat dat de operatie foutloos is beëindigd. Vraag Q-adabc07be0a3e7d2 (open)

Foutafhandeling en wisselwerking

Voor deze meldingsfunctie zijn in [SWS_Ea_00099] noch specifieke foutcodes, noch ontwikkelingsfouten (DET) of productiefouten (DEM) gedefinieerd. Dit berust op het feit dat de aanroep uitsluitend de foutloze beëindiging van een opdracht aangeeft [SWS_Ea_00099]. Treedt er tijdens een geheugenopdracht een fout op, dan wordt deze melding niet aangeroepen.

De meldingsfunctie NvM_JobErrorNotification wordt door de onderliggende geheugenabstractie (Memory Abstraction) gebruikt om de foutieve voltooiing van een opdracht aan de NVRAM Manager te melden [SWS_Ea_00100]. De declaratie van deze interface wordt via het headerbestand NvM_MemIf.h ter beschikking gesteld [SWS_Ea_00100].

Voor de aanroep en integratie van de interface gelden volgens specificatie [SWS_Ea_00100] de volgende eigenschappen:

• Signatuur en syntaxis: De functie heeft de signatuur void NvM_JobErrorNotification (void) [SWS_Ea_00100].
• Parameters en retourwaarden: De functie heeft noch invoerparameters (Parameters (in): None), invoer-/uitvoerparameters (Parameters (inout): None), noch uitvoerparameters (Parameters (out): None) en retourneert geen waarde (Return value: None) [SWS_Ea_00100].
• Synchroniciteit: De aanroep is gespecificeerd als synchroon (Synchronous) [SWS_Ea_00100].
• Concurrente uitvoering: De functie is vastgelegd als niet-re-entrant (Non Reentrant) [SWS_Ea_00100]. Overeenkomstige aanroepen vanuit de geheugenabstractie mogen dus niet concurrent of overlappend plaatsvinden.

Specifieke foutcodes, parameters voor foutdifferentiatie of vereisten voor meldingen aan de Default Error Tracer (DET)- of de Diagnostic Event Manager (DEM)-module zijn niet opgenomen in de definitie [SWS_Ea_00100]. De functie dient uitsluitend als zuivere statusmelding over het met een fout beëindigde jobresultaat [SWS_Ea_00100].