12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015 |
- /*==================================================================================================
- * Project : RTD AUTOSAR 4.4
- * Platform : CORTEXM
- * Peripheral : IPV_FTFC
- * Dependencies :
- *
- * Autosar Version : 4.4.0
- * Autosar Revision : ASR_REL_4_4_REV_0000
- * Autosar Conf.Variant :
- * SW Version : 1.0.0
- * Build Version : S32K1_RTD_1_0_0_HF01_D2109_ASR_REL_4_4_REV_0000_20210907
- *
- * (c) Copyright 2020-2021 NXP Semiconductors
- * All Rights Reserved.
- *
- * NXP Confidential. This software is owned or controlled by NXP and may only be
- * used strictly in accordance with the applicable license terms. By expressly
- * accepting such terms or by downloading, installing, activating and/or otherwise
- * using the software, you are agreeing that you have read, and that you agree to
- * comply with and are bound by, such license terms. If you do not agree to be
- * bound by the applicable license terms, then you may not retain, install,
- * activate or otherwise use the software.
- ==================================================================================================*/
- /**
- * @file
- *
- * @addtogroup EEP_DRIVER Eeprom Driver
- * @{
- */
- /* implements Eep.c_Artifact */
- #ifdef __cplusplus
- extern "C"{
- #endif
- /* Compiler warning eep_c_REF_CW_01: explicit cast discards volatile qualifier.
- The cast is explicit, intended and the casted value is treated properly.
- Sizes of the pointers and integral types for all the supported platforms/compilers are well known
- and the volatile keyword is not needed when using the pointer value as a eeprom address counter,
- as the pointer value is not updated in the DSI interrupt context or by other hardware means.
- */
- /*==================================================================================================
- * INCLUDE FILES
- * 1) system and project includes
- * 2) needed interfaces from external units
- * 3) internal and external interfaces from this unit
- ==================================================================================================*/
- #include "Eep.h"
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- #include "Dem.h"
- #endif
- #include "Det.h"
- #include "Eep_IPW.h"
- #if (EEP_MCORE_ENABLED == STD_ON)
- #include "CDD_Rm.h"
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- /*==================================================================================================
- * SOURCE FILE VERSION INFORMATION
- ==================================================================================================*/
- #define EEP_VENDOR_ID_C 43
- #define EEP_AR_RELEASE_MAJOR_VERSION_C 4
- #define EEP_AR_RELEASE_MINOR_VERSION_C 4
- #define EEP_AR_RELEASE_REVISION_VERSION_C 0
- #define EEP_SW_MAJOR_VERSION_C 1
- #define EEP_SW_MINOR_VERSION_C 0
- #define EEP_SW_PATCH_VERSION_C 0
- /*==================================================================================================
- * FILE VERSION CHECKS
- ==================================================================================================*/
- /* Check if current file and Eep header file are of the same vendor */
- #if (EEP_VENDOR_ID_C != EEP_VENDOR_ID)
- #error "Eep.c and Eep.h have different vendor ids"
- #endif
- /* Check if current file and Eep header file are of the same Autosar version */
- #if ((EEP_AR_RELEASE_MAJOR_VERSION_C != EEP_AR_RELEASE_MAJOR_VERSION) || \
- (EEP_AR_RELEASE_MINOR_VERSION_C != EEP_AR_RELEASE_MINOR_VERSION) || \
- (EEP_AR_RELEASE_REVISION_VERSION_C != EEP_AR_RELEASE_REVISION_VERSION) \
- )
- #error "AutoSar Version Numbers of Eep.c and Eep.h are different"
- #endif
- /* Check if current file and Eep header file are of the same Software version */
- #if ((EEP_SW_MAJOR_VERSION_C != EEP_SW_MAJOR_VERSION) || \
- (EEP_SW_MINOR_VERSION_C != EEP_SW_MINOR_VERSION) || \
- (EEP_SW_PATCH_VERSION_C != EEP_SW_PATCH_VERSION) \
- )
- #error "Software Version Numbers of Eep.c and Eep.h are different"
- #endif
- /* Check if current file and Eep_IPW header file are of the same vendor */
- #if (EEP_VENDOR_ID_C != EEP_IPW_VENDOR_ID_H)
- #error "Eep.c and Eep_IPW.h have different vendor ids"
- #endif
- /* Check if current file and Eep_IPW header file are of the same Autosar version */
- #if ((EEP_AR_RELEASE_MAJOR_VERSION_C != EEP_IPW_AR_RELEASE_MAJOR_VERSION_H) || \
- (EEP_AR_RELEASE_MINOR_VERSION_C != EEP_IPW_AR_RELEASE_MINOR_VERSION_H) || \
- (EEP_AR_RELEASE_REVISION_VERSION_C != EEP_IPW_AR_RELEASE_REVISION_VERSION_H) \
- )
- #error "AutoSar Version Numbers of Eep.c and Eep_IPW.h are different"
- #endif
- /* Check if current file and Eep_IPW header file are of the same Software version */
- #if ((EEP_SW_MAJOR_VERSION_C != EEP_IPW_SW_MAJOR_VERSION_H) || \
- (EEP_SW_MINOR_VERSION_C != EEP_IPW_SW_MINOR_VERSION_H) || \
- (EEP_SW_PATCH_VERSION_C != EEP_IPW_SW_PATCH_VERSION_H) \
- )
- #error "Software Version Numbers of Eep.c and Eep_IPW.h are different"
- #endif
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- #ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
- /* Check if current file and Dem header file are of the same Autosar version */
- #if ((EEP_AR_RELEASE_MAJOR_VERSION_C != DEM_AR_RELEASE_MAJOR_VERSION) || \
- (EEP_AR_RELEASE_MINOR_VERSION_C != DEM_AR_RELEASE_MINOR_VERSION) \
- )
- #error "AutoSar Version Numbers of Eep.c and Dem.h are different"
- #endif
- #endif
- #endif
- #ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
- /* Check if current file and Det header file are of the same Autosar version */
- #if ((EEP_AR_RELEASE_MAJOR_VERSION_C != DET_AR_RELEASE_MAJOR_VERSION) || \
- (EEP_AR_RELEASE_MINOR_VERSION_C != DET_AR_RELEASE_MINOR_VERSION) \
- )
- #error "AutoSar Version Numbers of Eep.c and Det.h are different"
- #endif
- #endif
- #if (EEP_MCORE_ENABLED == STD_ON)
- #ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
- /* Check if current file and CDD_Rm header file are of the same Autosar version */
- #if ((EEP_AR_RELEASE_MAJOR_VERSION_C != RM_AR_RELEASE_MAJOR_VERSION) || \
- (EEP_AR_RELEASE_MINOR_VERSION_C != RM_AR_RELEASE_MINOR_VERSION) \
- )
- #error "AutoSar Version Numbers of Eep.c and CDD_Rm.h are different"
- #endif
- #endif
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- /*==================================================================================================
- * LOCAL TYPEDEFS (STRUCTURES, UNIONS, ENUMS)
- ==================================================================================================*/
- /*==================================================================================================
- LOCAL MACROS
- ==================================================================================================*/
- /*==================================================================================================
- LOCAL CONSTANTS
- ==================================================================================================*/
- /*==================================================================================================
- LOCAL VARIABLES
- ==================================================================================================*/
- #define EEP_START_SEC_VAR_CLEARED_UNSPECIFIED
- #include "Eep_MemMap.h"
- /**
- * @brief Maximum number of bytes to read or compare in one cycle of Eep_MainFunction
- */
- static Eep_LengthType Eep_u32MaxRead;
- /**
- * @brief Maximum number of bytes to write in one cycle of Eep_MainFunction
- */
- static Eep_LengthType Eep_u32MaxWrite;
- /**
- * @brief Logical address of data block currently processed by Eep_MainFunction
- */
- static Eep_AddressType Eep_u32EepromAddrIt;
- /**
- * @brief Remainin length to be transfered until the end of the job
- */
- static Eep_LengthType Eep_u32RemainingLength;
- /**
- * @brief Result of last eeprom module job
- *
- */
- static MemIf_JobResultType Eep_eJobResult;
- /**
- * @brief Type of currently executed job (erase, write, read, or compare)
- */
- static Eep_JobType Eep_eJob;
- /**
- * @brief Pointer to current eeprom module configuration set
- */
- static const Eep_ConfigType * Eep_pConfigPtr;
- /**
- * @brief Pointer to current eeprom module configuration set
- */
- #if (EEP_MCORE_ENABLED == STD_ON)
- Eep_MCoreHwJobStatusType Eep_MCoreHwJobStatus;
- #endif
- #define EEP_STOP_SEC_VAR_CLEARED_UNSPECIFIED
- #include "Eep_MemMap.h"
- #define EEP_START_SEC_VAR_CLEARED_8
- #include "Eep_MemMap.h"
- /**
- * @brief Pointer to current position in source data buffer
- * @details Used by both write and compare jobs
- */
- static const uint8 * Eep_pu8JobSrcAddrPtr;
- /**
- * @brief Pointer to current position in target data buffer
- * @details Used only by read job
- */
- static uint8 * Eep_pu8JobDataDestPtr;
- #define EEP_STOP_SEC_VAR_CLEARED_8
- #include "Eep_MemMap.h"
- #define EEP_START_SEC_VAR_CLEARED_16
- #include "Eep_MemMap.h"
- /* If FTFC IP is present on the platform */
- #if (EEP_QUICK_WRITES_API == STD_ON)
- /**
- * @brief Requested urgency length to set up number of bytes used for quick writes
- * @details Used only by the Eep_QuickWrite, Eep_MainFunction
- */
- static uint16 Eep_u16QuickWritesLength;
- #endif /* EEP_QUICK_WRITES_API */
- #define EEP_STOP_SEC_VAR_CLEARED_16
- #include "Eep_MemMap.h"
- #define EEP_START_SEC_VAR_CLEARED_32
- #include "Eep_MemMap.h"
- /**
- * @brief Pointer to current eeprom module configuration set
- *
- */
- static uint32 Eep_u32AccCRCremainder;
- #if (EEP_MCORE_ENABLED == STD_ON)
- static uint32 Eep_u32DoMainID;
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- #define EEP_STOP_SEC_VAR_CLEARED_32
- #include "Eep_MemMap.h"
- /*==================================================================================================
- GLOBAL CONSTANTS
- ==================================================================================================*/
- /*==================================================================================================
- * GLOBAL VARIABLES
- ==================================================================================================*/
- /*==================================================================================================
- LOCAL FUNCTION PROTOTYPES
- ==================================================================================================*/
- #define EEP_START_SEC_CODE
- #include "Eep_MemMap.h"
- static void Eep_InitAllVarriable (void);
- static void Eep_AccumulateCRC (uint32 u32InputData);
- static void Eep_ResetCRC (void);
- static uint32 Eep_FinalizeCRC (void);
- static void Eep_UpdateCRCreminder (Eep_CrcDataSizeType eDataSize);
- static Eep_CrcType Eep_CalcCfgCRC (void);
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- static void Eep_ReportDemErrors(void);
- static void Eep_ReportDemPasses(void);
- #endif
- static MemIf_JobResultType Eep_ProcessWriteJob (void);
- #if (EEP_QUICK_WRITES_API == STD_ON)
- static MemIf_JobResultType Eep_ProcessQuickWriteJob (void);
- #endif
- static MemIf_JobResultType Eep_ProcessReadJob (void);
- #if (EEP_COMPARE_API == STD_ON)
- static MemIf_JobResultType Eep_ProcessCompareJob (void);
- #endif
- static MemIf_JobResultType Eep_ProcessRequestedJobs (Eep_JobType eJob);
- static void Eep_CallNotification (MemIf_JobResultType eJobResult);
- static void Eep_EndJobs (void);
- #if (EEP_MCORE_ENABLED == STD_ON)
- static Eep_MCoreReqReturnType Eep_ReqMCore (void);
- static Std_ReturnType Eep_MCoreInitSema4sLock (void);
- static Std_ReturnType Eep_MCoreJobSema4Release (void);
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- #define EEP_STOP_SEC_CODE
- #include "Eep_MemMap.h"
- /*==================================================================================================
- LOCAL FUNCTIONS
- ==================================================================================================*/
- #define EEP_START_SEC_CODE
- #include "Eep_MemMap.h"
- /**
- * @brief Eep_InitAllVarriable
- * @details Initialize global variables to their default values
- *
- * @param[in] void
- *
- * @return void
- * @pre N/A
- */
- static void Eep_InitAllVarriable (void)
- {
- /* Initialize all global variable */
- Eep_u32MaxRead = 0UL;
- Eep_u32MaxWrite = 0UL;
- Eep_u32EepromAddrIt = 0UL;
- Eep_u32RemainingLength = 0UL;
- Eep_eJobResult = MEMIF_JOB_OK;
- Eep_eJob = EEP_JOB_ERASE;
- Eep_pConfigPtr = NULL_PTR;
- Eep_pu8JobSrcAddrPtr = NULL_PTR;
- Eep_pu8JobDataDestPtr = NULL_PTR;
- /* If FTFC IP is present on the platform */
- #if (EEP_QUICK_WRITES_API == STD_ON)
- Eep_u16QuickWritesLength = 0U;
- #endif /* EEP_QUICK_WRITES_API */
- /* Initialize CRC remainder */
- Eep_u32AccCRCremainder = 0U;
- #if (EEP_MCORE_ENABLED == STD_ON)
- Eep_u32DoMainID = 0;
- Eep_MCoreHwJobStatus = EEP_MCORE_HW_JOB_IDLE;
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- }
- /**
- * @brief Function to handle cumulative CRC calculation over input data.
- *
- * @details Handles cumulative CRC calculation over input 32-bit data, .
- *
- * @param[in] inputData ... data to be CRC-ed
- *
- * @return void
- * @retval None.
- *
- * @pre Eep_ResetCRC() was executed before the first call of
- * Eep_AccumulateCRC().
- *
- *
- */
- static void Eep_AccumulateCRC (uint32 u32InputData)
- {
- if (0xFFFFU < u32InputData)
- {
- /* preparation for accumulation of higher 16 bits of the u32InputData */
- Eep_u32AccCRCremainder = (Eep_u32AccCRCremainder << 16U) | (u32InputData >> 16U);
- /* make 16-bit accumulated result (in lower 16-bits of Eep_u32AccCRCremainder) */
- Eep_UpdateCRCreminder(EEP_CRC_16_BITS);
- }
- if (0xFFU < u32InputData)
- {
- /* preparation for accumulation of lower 16 bits of the u32InputData */
- Eep_u32AccCRCremainder = (Eep_u32AccCRCremainder << 16U) | (u32InputData & 0x0000FFFFU);
- /* make 16-bit accumulated result (in lower 16-bits of Eep_u32AccCRCremainder) */
- Eep_UpdateCRCreminder(EEP_CRC_16_BITS);
- }
- else
- {
- /* optimization: only 8 LSB bits are processed */
- /* preparation for accumulation of lower 8 bits of the u32InputData */
- Eep_u32AccCRCremainder = (Eep_u32AccCRCremainder << 8U) | u32InputData;
- /* make 16-bit accumulated result (in lower 16-bits of Eep_u32AccCRCremainder) */
- Eep_UpdateCRCreminder(EEP_CRC_8_BITS);
- }
- return;
- }
- /**
- * @brief Function to reset CRC calculation.
- *
- * @details Resets accumulated Eep_u32AccCRCremainder.
- *
- * @param[in] void
- *
- * @return void
- * @retval None.
- *
- * @pre None.
- *
- *
- */
- static void Eep_ResetCRC (void)
- {
- Eep_u32AccCRCremainder = 0U;
- }
- /**
- * @brief Function to finalize CRC calculation.
- *
- * @details Finalizes accumulated CRC computation and resturns the final
- * CRC checksum.
- *
- * @param[in] void
- *
- * @return uint32
- * @retval The final CRC checksum in the lower 16 bits.
- *
- * @pre Eep_AccumulateCRC() was executed at least once before
- * calling Eep_FinalizeCRC().
- *
- */
- static uint32 Eep_FinalizeCRC (void)
- {
- /* add the final 0x0000 to the remainder */
- Eep_u32AccCRCremainder = (Eep_u32AccCRCremainder << 16U);
- /* make the final 16-bit CRC */
- Eep_UpdateCRCreminder(EEP_CRC_16_BITS);
- return Eep_u32AccCRCremainder;
- }
- /**
- * @brief Function to perfom CRC calculation over input 32-bit data.
- *
- * @details Process 32-bit data to 16-bit reminder.
- *
- * @param[in] accDataPtr ... ptr to data to be processed
- *
- * @return void
- * @retval None.
- *
- * @pre Can be called only from Eep_AccumulateCRC().
- *
- */
- static void Eep_UpdateCRCreminder (Eep_CrcDataSizeType eDataSize)
- {
- uint32 u32CrcPolynomSft;
- uint32 u32LeadingOne;
- uint32 u32AccDataLoc;
- uint32 u32LeadingOneInitial;
- switch (eDataSize)
- {
- case EEP_CRC_8_BITS:
- u32CrcPolynomSft = 0x11021U << 7U; /* shifted CRC-16-CCITT (x.25 protocol)*/
- u32LeadingOneInitial = 0x10000U << 7U;
- break;
- case EEP_CRC_16_BITS:
- default:
- u32CrcPolynomSft = 0x11021U << 15U; /* shifted CRC-16-CCITT (x.25 protocol)*/
- u32LeadingOneInitial = 0x10000U << 15U;
- break;
- }
- /* copy static variable to auto (computation over static may be slow) */
- u32AccDataLoc = Eep_u32AccCRCremainder;
- /* CRC computation */
- for (u32LeadingOne = u32LeadingOneInitial; u32LeadingOne >= 0x00010000U; u32LeadingOne >>= 1U)
- {
- if ((u32AccDataLoc & u32LeadingOne) != 0U)
- {
- u32AccDataLoc ^= u32CrcPolynomSft;
- }
- u32CrcPolynomSft >>= 1U;
- }
- /* copy back to static variable */
- Eep_u32AccCRCremainder = u32AccDataLoc;
- return;
- }
- /**
- * @brief Calculates CRC over Eep configuration.
- *
- * @details Calculates CRC over selected items of Eep configuration set
- * pointed to by ConfigPtr.
- *
- * @param[in] ConfigPtr Pointer to eeprom driver configuration set.
- *
- * @return uint32
- * @retval 0 .. 0xFFFF (16-bit CRC using CRC-16-CCITT polynomial)
- *
- * @pre Eep_pConfigPtr must not be properly initialized.
- *
- */
- static Eep_CrcType Eep_CalcCfgCRC (void)
- {
- /* Reset the accumulated CRC value */
- Eep_ResetCRC();
- /* Accumulate the rest of the params (common for all sectors within a config set) */
- /* CRC - Accumulate eDefaultMode */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->eDefaultMode);
- /* CRC - Accumulate u32MaxReadFastMode */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->u32MaxReadFastMode);
- /* CRC - Accumulate u32MaxReadNormalMode */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->u32MaxReadNormalMode);
- /* CRC - Accumulate u32MaxWriteFastMode */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->u32MaxWriteFastMode);
- /* CRC - Accumulate u32MaxWriteNormalMode */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->u32MaxWriteNormalMode);
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- /* CRC - Accumulate EEP_E_COMPARE_FAILED */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_CompareFailedCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_CompareFailedCfg.id);
- /* CRC - Accumulate EEP_E_ERASE_FAILED */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_EraseFailedCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_EraseFailedCfg.id);
- /* CRC - Accumulate EEP_E_READ_FAILED */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_ReadFailedCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_ReadFailedCfg.id);
- /* CRC - Accumulate EEP_E_WRITE_FAILED */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_WriteFailedCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_WriteFailedCfg.id);
- /* CRC - Accumulate EEP_E_BO_MAINTENANCE */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BOMaintenanceCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BOMaintenanceCfg.id);
- /* CRC - Accumulate EEP_E_BO_QUICK_WRITES */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.id);
- /* CRC - Accumulate EEP_E_BO_NORMAL_WRITES */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BONormalWritesCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_BONormalWritesCfg.id);
- #if (EEP_HIGH_TEMP_CHIP == STD_ON)
- /* CRC - Accumulate EEP_E_MGSTAT_BLOCK */
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_MGSTAT_BlockCfg.state);
- Eep_AccumulateCRC((uint32)Eep_pConfigPtr->Eep_E_MGSTAT_BlockCfg.id);
- #endif
- #endif
- return ((Eep_CrcType)Eep_FinalizeCRC());
- }
- /**
- * @brief Function to call notifications
- *
- * @details The Eep module shall call the callback function defined in the configuration parameter
- * - EepJobEndNotification when a job has been completed with a positive result: Read or Write or Erase or
- * Compare finished & data blocks are equal.
- * - EepJobErrorNotification when a job has been canceled or aborted with negative result:read or write or earse or
- * Compare aborted or data blocks are not equal
- *
- * @param[in] eJobResult ... data
- *
- * @return void
- * @retval None.
- *
- */
- static void Eep_CallNotification (MemIf_JobResultType eJobResult)
- {
- if (MEMIF_JOB_OK == eJobResult)
- {
- if (NULL_PTR != Eep_pConfigPtr->jobEndNotificationPtr)
- {
- /* Call EepJobEndNotification function if configured */
- Eep_pConfigPtr->jobEndNotificationPtr();
- }
- else
- {
- /* Callback notification configured as null pointer */
- }
- }
- else if ((MEMIF_JOB_FAILED == eJobResult) || (MEMIF_BLOCK_INCONSISTENT == eJobResult) ||
- (MEMIF_JOB_CANCELED == eJobResult) || (MEMIF_JOB_PENDING == eJobResult))
- {
- if (NULL_PTR != Eep_pConfigPtr->jobErrorNotificationPtr)
- {
- /* Call EepJobErrorNotification function if configured */
- Eep_pConfigPtr->jobErrorNotificationPtr();
- }
- else
- {
- /* Callback notification configured as null pointer */
- }
- }
- else
- {
- ;/* Not done yet. There is more data to transfer in following Eep_MainFunction call .*/
- }
- }
- #if (EEP_COMPARE_API == STD_ON)
- /**
- * @brief Pocess the compare job
- *
- * @details Compares data from Eep_pu8JobSrcAddrPtr to data from Eep_u32EepromAddrIt
- * of lenth equal to Eep_u32MaxRead or Eep_u32RemainingLength.
- *
- * @param[in]
- *
- * @pre The module must be initialized
- *
- *
- *
- */
- static MemIf_JobResultType Eep_ProcessCompareJob (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_PENDING;
- Eep_ReturnType eTransferRetVal = EEP_E_OK;
- uint32 u32TempSource = 0UL;
- Eep_LengthType u32TransfLength = 0UL;
- /* the function will compare Eep_u32MaxRead or the remaining length */
- /* compute length of transfer */
- if (Eep_u32RemainingLength > Eep_u32MaxRead)
- {
- /* Eep_u32MaxWrite must be transferred */
- u32TransfLength = Eep_u32MaxRead;
- }
- else
- {
- /* Eep_u32RemainingLength must be transferred */
- u32TransfLength = Eep_u32RemainingLength;
- }
- /* if there is something to transfer */
- if (u32TransfLength > 0UL)
- {
- eTransferRetVal = Eep_Ipw_CompareSync(Eep_u32EepromAddrIt, Eep_pu8JobSrcAddrPtr, u32TransfLength);
- }
-
- /* update variables to be used for the next iteration */
- u32TempSource = (uint32)Eep_pu8JobSrcAddrPtr;
- u32TempSource = u32TempSource + u32TransfLength;
- Eep_pu8JobSrcAddrPtr = (uint8 *)u32TempSource;
- Eep_u32EepromAddrIt = Eep_u32EepromAddrIt + u32TransfLength;
- Eep_u32RemainingLength = Eep_u32RemainingLength - u32TransfLength;
- /* check status */
- if (EEP_E_FAILED == eTransferRetVal)
- {
- /* job has failed */
- eRetVal = MEMIF_JOB_FAILED;
- }
- if (EEP_E_BLOCK_INCONSISTENT == eTransferRetVal)
- {
- /* comparison failed */
- eRetVal = MEMIF_BLOCK_INCONSISTENT;
- }
- else if ((0UL == Eep_u32RemainingLength) && (EEP_E_OK == eTransferRetVal))
- {
- /* the job is finished successfully */
- eRetVal = MEMIF_JOB_OK;
- }
- else
- {
- /* do nothing */
- }
- return eRetVal;
- }
- #endif
- /**
- * @brief Pocess a read job
- *
- * @details Reads data from Eep_u32EepromAddrIt to Eep_pu8JobDataDestPtr
- * of lenth equal to Eep_u32MaxRead or Eep_u32RemainingLength.
- *
- * @param[in]
- *
- * @pre The module must be initialized
- *
- *
- *
- */
- static MemIf_JobResultType Eep_ProcessReadJob (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_PENDING;
- Eep_ReturnType eTransferRetVal = EEP_E_OK;
- uint32 u32TempSource = 0UL;
- Eep_LengthType u32TransfLength = 0UL;
- /* transfer information to low level driver */
- /* the function will read Eep_u32MaxRead or the remaining length */
- /* compute length of transfer */
- if (Eep_u32RemainingLength > Eep_u32MaxRead)
- {
- /* Eep_u32MaxWrite must be transferred */
- u32TransfLength = Eep_u32MaxRead;
- }
- else
- {
- /* Eep_u32RemainingLength must be transferred */
- u32TransfLength = Eep_u32RemainingLength;
- }
- /* if there is something to transfer */
- if (u32TransfLength > 0UL)
- {
- eTransferRetVal = Eep_Ipw_Read(Eep_u32EepromAddrIt, Eep_pu8JobDataDestPtr, u32TransfLength);
- }
-
- /* update variables to be used for the next iteration */
- u32TempSource = (uint32)Eep_pu8JobDataDestPtr;
- u32TempSource = u32TempSource + u32TransfLength;
- Eep_pu8JobDataDestPtr = (uint8 *)u32TempSource;
- Eep_u32EepromAddrIt = Eep_u32EepromAddrIt + u32TransfLength;
- Eep_u32RemainingLength = Eep_u32RemainingLength - u32TransfLength;
- /* check status */
- if (EEP_E_FAILED == eTransferRetVal)
- {
- /* job has failed */
- eRetVal = MEMIF_JOB_FAILED;
- }
- else if ((0UL == Eep_u32RemainingLength) && (EEP_E_OK == eTransferRetVal))
- {
- /* the job is finished */
- eRetVal = MEMIF_JOB_OK;
- }
- else
- {
- /* do nothing */
- }
- return eRetVal;
- }
- /**
- * @brief Pocess a write job
- *
- * @details Performs the write operation for a main function call.
- * Calls low level drivers for async or snc behavior.
- *
- * @param[in]
- *
- * @pre The module must be initialized
- *
- *
- *
- */
- static MemIf_JobResultType Eep_ProcessWriteJob (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_PENDING;
- Eep_ReturnType eTransferRetVal = EEP_E_OK;
- #if (EEP_ASYNC_WRITE_OPERATIONS_ENABLED == STD_OFF)
- uint32 u32TempSource = 0UL;
- Eep_LengthType u32TransfLength = 0UL;
- /* transfer information to low level driver */
- /* the function will write Eep_u32MaxWrite or the remaining length */
- /* compute length of transfer */
- if (Eep_u32RemainingLength > Eep_u32MaxWrite)
- {
- /* Eep_u32MaxWrite must be transferred */
- u32TransfLength = Eep_u32MaxWrite;
- }
- else
- {
- /* Eep_u32RemainingLength must be transferred */
- u32TransfLength = Eep_u32RemainingLength;
- }
- /* if there is something to transfer */
- if (u32TransfLength > 0UL)
- {
- eTransferRetVal = Eep_Ipw_Write(Eep_u32EepromAddrIt, Eep_pu8JobSrcAddrPtr, u32TransfLength);
- }
-
- /* update variables to be used for the next iteration */
- u32TempSource = (uint32)Eep_pu8JobSrcAddrPtr;
- u32TempSource = u32TempSource + u32TransfLength;
- Eep_pu8JobSrcAddrPtr = (uint8 *)u32TempSource;
- Eep_u32EepromAddrIt = Eep_u32EepromAddrIt + u32TransfLength;
- Eep_u32RemainingLength = Eep_u32RemainingLength - u32TransfLength;
- #else
- /* in asynchronous mode in one main function call EEP
- * will trigger a hardware write operation for a 1,2, or 4 bytes page and return,
- * it will not wait for operation to finish */
- eTransferRetVal = Eep_Ipw_Write(Eep_u32EepromAddrIt, Eep_pu8JobSrcAddrPtr, Eep_u32RemainingLength);
- /* Clear unused variable */
- (void)Eep_u32MaxWrite;
- #endif /*#if (EEP_ASYNC_WRITE_OPERATIONS_ENABLED == STD_OFF) */
- if (EEP_E_FAILED == eTransferRetVal)
- {
- /* job has failed */
- eRetVal = MEMIF_JOB_FAILED;
- }
- #if (EEP_ASYNC_WRITE_OPERATIONS_ENABLED == STD_OFF)
- else if ((0UL == Eep_u32RemainingLength) && (EEP_E_OK == eTransferRetVal))
- #else
- else if (EEP_E_OK == eTransferRetVal)
- #endif /*#if (EEP_ASYNC_WRITE_OPERATIONS_ENABLED == STD_OFF) */
- {
- /* the job is finished */
- eRetVal = MEMIF_JOB_OK;
- /* job is done */
- Eep_u32RemainingLength = 0UL;
- }
- else
- {
- /* do nothing */
- }
- return eRetVal;
- }
- /* If FTFC IP is present on the platform */
- #if (EEP_QUICK_WRITES_API == STD_ON)
- /**
- * @brief Pocess a quick write job
- *
- * @details Performs the quick write operation for a main function call.
- * Calls low level drivers for async or snc behavior.
- *
- * @pre The module must be initialized
- */
- static MemIf_JobResultType Eep_ProcessQuickWriteJob (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_FAILED;
- Eep_ReturnType eTransferRetVal = EEP_E_OK;
- uint16 Length = Eep_u16QuickWritesLength;
- /* if there is something to transfer */
- if (Eep_u32RemainingLength > 0UL)
- {
- eTransferRetVal = Eep_Ipw_QuickWrite(Eep_u32EepromAddrIt, Eep_pu8JobSrcAddrPtr, Length);
- Eep_pu8JobSrcAddrPtr = (uint8*)((uint32)Eep_pu8JobSrcAddrPtr + Length);
- Eep_u32EepromAddrIt += Length;
- Eep_u32RemainingLength -= Length;
- }
- if (EEP_E_OK == eTransferRetVal)
- {
- if (0UL == Eep_u32RemainingLength)
- {
- eRetVal = MEMIF_JOB_OK;
- }
- else
- {
- eRetVal = MEMIF_JOB_PENDING;
- }
- }
- return eRetVal;
- }
- #endif /* EEP_QUICK_WRITES_API */
- /**
- * @brief Pocess a erase job
- *
- * @details Performs the erase operation for a main function call.
- * Calls low level drivers for async or snc behavior.
- *
- * @param[in]
- *
- * @pre The module must be initialized
- */
- static MemIf_JobResultType Eep_ProcessEraseJob (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_PENDING;
- Eep_ReturnType eTransferRetVal = EEP_E_OK;
- #if (EEP_ASYNC_ERASE_OPERATIONS_ENABLED == STD_OFF)
- Eep_LengthType u32TransfLength = 0UL;
- /* transfer information to low level driver */
- /* the function will write Eep_u32MaxWrite or the remaining length */
- /* compute length of transfer */
- if (Eep_u32RemainingLength > Eep_u32MaxWrite)
- {
- /* Eep_u32MaxWrite must be transferred */
- u32TransfLength = Eep_u32MaxWrite;
- }
- else
- {
- /* Eep_u32RemainingLength must be transferred */
- u32TransfLength = Eep_u32RemainingLength;
- }
- /* if there is something to transfer */
- if (u32TransfLength > 0UL)
- {
- eTransferRetVal = Eep_Ipw_Erase(Eep_u32EepromAddrIt, u32TransfLength);
- }
-
- /* update variables to be used for the next iteration */
- Eep_u32EepromAddrIt = Eep_u32EepromAddrIt + u32TransfLength;
- Eep_u32RemainingLength = Eep_u32RemainingLength - u32TransfLength;
- #else
- eTransferRetVal = Eep_Ipw_Erase(Eep_u32EepromAddrIt, Eep_u32RemainingLength);
- /* Clear unused variable */
- (void)Eep_u32MaxWrite;
- #endif /*#if (EEP_ASYNC_ERASE_OPERATIONS_ENABLED == STD_OFF) */
- if (EEP_E_FAILED == eTransferRetVal)
- {
- /* job has failed */
- eRetVal = MEMIF_JOB_FAILED;
- }
- #if (EEP_ASYNC_ERASE_OPERATIONS_ENABLED == STD_OFF)
- else if ((0UL == Eep_u32RemainingLength) && (EEP_E_OK == eTransferRetVal))
- #else
- else if (EEP_E_OK == eTransferRetVal)
- #endif /*#if (EEP_ASYNC_ERASE_OPERATIONS_ENABLED == STD_OFF) */
- {
- /* the job is finished */
- eRetVal = MEMIF_JOB_OK;
- /* job is done */
- Eep_u32RemainingLength = 0UL;
- }
- else
- {
- /* do nothing */
- }
- return eRetVal;
- }
- /*==================================================================================================
- GLOBAL FUNCTIONS
- ==================================================================================================*/
- /**
- * @brief The function initializes Eep module.
- * @details The function sets the internal module variables according to given
- * configuration set.
- *
- * @param[in] pConfigPtr Pointer to eeprom driver configuration set.
- *
- * @api
- *
- * @pre @p pConfigPtr must not be @p NULL_PTR and the module status must not
- * be @p MEMIF_BUSY.
- *
- * @implements Eep_Init_Activity
- *
- */
- void Eep_Init (const Eep_ConfigType * pConfigPtr)
- {
- Eep_ReturnType eRetVal = EEP_E_OK;
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- /* check DET error codes */
- #if defined(EEP_PRECOMPILE_SUPPORT)
- if (NULL_PTR != pConfigPtr)
- #else
- if (NULL_PTR == pConfigPtr)
- #endif
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_INIT_ID, EEP_E_INIT_FAILED);
- }
- else if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_INIT_ID, EEP_E_BUSY);
- }
- else
- {
- #endif /* EEP_DEV_ERROR_DETECT */
- Eep_InitAllVarriable();
-
- /* set the configuration pointer according to the config variant */
- #if defined(EEP_PRECOMPILE_SUPPORT)
- Eep_pConfigPtr = &Eep_PBCfgVariantPredefined;
- #if (EEP_DEV_ERROR_DETECT == STD_OFF)
- (void)pConfigPtr;
- #endif
- #else
- Eep_pConfigPtr = pConfigPtr;
- #endif
- /* check configuration CRC */
- if (Eep_pConfigPtr->u16ConfigCrc != Eep_CalcCfgCRC())
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_INIT_ID, EEP_E_INIT_FAILED);
- Eep_pConfigPtr = NULL_PTR;
- #endif
- Eep_eJobResult = MEMIF_JOB_FAILED;
- }
- else
- {
- /* Set the max number of bytes to read/write
- during Eep_MainFunction call */
- if (MEMIF_MODE_SLOW == Eep_pConfigPtr->eDefaultMode)
- {
- Eep_u32MaxRead = Eep_pConfigPtr->u32MaxReadNormalMode;
- Eep_u32MaxWrite = Eep_pConfigPtr->u32MaxWriteNormalMode;
- }
- else
- {
- Eep_u32MaxRead = Eep_pConfigPtr->u32MaxReadFastMode;
- Eep_u32MaxWrite = Eep_pConfigPtr->u32MaxWriteFastMode;
- }
- #if (EEP_MCORE_ENABLED == STD_ON)
- /* Get domain ID from Xrdc which configured by users */
- Eep_u32DoMainID = (uint32)Rm_XrdcGetDomainID();
- /* Lock gate */
- if (E_OK == Eep_MCoreInitSema4sLock())
- {
- /* Initialize eeprom hardware */
- eRetVal = Eep_Ipw_Init(Eep_pConfigPtr);
- }
- else
- {
- /* Lock is not successful */
- eRetVal = EEP_E_FAILED;
- (void) Det_ReportRuntimeError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_INIT_ID, EEP_E_TIMEOUT);
- }
- /* Release the taken SEMA4s. */
- if (E_OK != Eep_MCoreJobSema4Release())
- {
- /* Unlock is not successful */
- eRetVal = EEP_E_FAILED;
- }
- #else
- eRetVal = Eep_Ipw_Init(Eep_pConfigPtr);
- #endif /* EEP_MCORE_ENABLED */
- if (EEP_E_FAILED == eRetVal)
- {
- Eep_eJobResult = MEMIF_JOB_FAILED;
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- Eep_pConfigPtr = NULL_PTR;
- #endif
- }
- else
- {
- Eep_eJobResult = MEMIF_JOB_OK;
- }
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif
- }
- /**
- * @brief Erase memory by writing erase value.
- * @details Starts an erase job asynchronously. The actual job is performed
- * by the Eep_MainFunction.
- *
- * @param[in] TargetAddress Target address in eeprom memory.
- * @param[in] Length Number of bytes to erase by writing the erased value.
- *
- * @return Std_ReturnType
- * @retval E_OK Erase command has been accepted.
- * @retval E_NOT_OK Erase command has not been accepted.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- * @post
- *
- * @implements Eep_Erase_Activity
- *
- */
- Std_ReturnType Eep_Erase (Eep_AddressType u32TargetAddress,
- Eep_LengthType u32Length
- )
- {
- Std_ReturnType u8RetVal = E_NOT_OK;
- /* Check driver was initialized */
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_ERASE_ID, EEP_E_UNINIT);
- }
- else
- {
- #endif
- if ((Std_ReturnType)E_OK == Eep_Ipw_CheckEraseParams(u32TargetAddress, u32Length))
- {
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_01();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_ERASE_ID, EEP_E_BUSY);
- #endif
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_01();
- }
- else
- {
- /* Configure the erase job */
- Eep_u32EepromAddrIt = u32TargetAddress;
- Eep_u32RemainingLength = u32Length;
- Eep_eJob = EEP_JOB_ERASE;
- Eep_eJobResult = MEMIF_JOB_PENDING;
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_01();
- u8RetVal = E_OK;
- }
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif
- return u8RetVal;
- }
- /**
- * @brief Write one or more complete eeprom pages to the eeprom device.
- * @details Starts a write job asynchronously. The actual job is performed by
- * Eep_MainFunction.
- *
- * @param[in] TargetAddress Target address in eeprom memory.
- * @param[in] SourceAddressPtr Pointer to source data buffer.
- * @param[in] Length Number of bytes to write.
- *
- * @return Std_ReturnType
- * @retval E_OK Write command has been accepted.
- * @retval E_NOT_OK Write command has not been accepted.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- *
- * @implements Eep_Write_Activity
- *
- */
- Std_ReturnType Eep_Write (Eep_AddressType u32TargetAddress,
- const uint8 * pSourceAddressPtr,
- Eep_LengthType u32Length
- )
- {
- Std_ReturnType u8RetVal = E_NOT_OK;
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_WRITE_ID, EEP_E_UNINIT);
- }
- else
- {
- #endif
- if ((Std_ReturnType)E_OK == Eep_Ipw_CheckWriteParams(u32TargetAddress, pSourceAddressPtr, u32Length))
- {
- /* enter EA to protect global variables */
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_02();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_WRITE_ID, EEP_E_BUSY);
- #endif
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_02();
- }
- else
- {
- /* Configure the write job */
- /* uint32 destination address which will be incremented during job processing */
- Eep_u32EepromAddrIt = u32TargetAddress;
- /* uint8 source pointer which will be incremented during job processing */
- Eep_pu8JobSrcAddrPtr = pSourceAddressPtr;
- /* remaining length to be transfered */
- Eep_u32RemainingLength = u32Length;
- Eep_eJob = EEP_JOB_WRITE;
- Eep_eJobResult = MEMIF_JOB_PENDING;
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_02();
- u8RetVal = E_OK;
- }
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif
- return u8RetVal;
- }
- /* If FTFC IP is present on the platform */
- #if (EEP_QUICK_WRITES_API == STD_ON)
- /**
- * @brief Write one or more complete eeprom pages to the eeprom device in quick write mode.
- * @details Starts a write job asynchronously. The actual job is performed by
- * Eep_MainFunction.
- *
- * @param[in] TargetAddress Target address in eeprom memory.
- * @param[in] SourceAddressPtr Pointer to source data buffer.
- * @param[in] Length Number of bytes to write.
- * @param[in] u16QuickWritesLength Number of bytes to allocated for quick write
- *
- * @return Std_ReturnType
- * @retval E_OK Write command has been accepted.
- * @retval E_NOT_OK Write command has not been accepted.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- * @implements Eep_QuickWrite_Activity
- */
- Std_ReturnType Eep_QuickWrite (Eep_AddressType u32TargetAddress,
- uint8 const * pSourceAddressPtr,
- Eep_LengthType u32Length,
- uint16 u16QuickWritesLength
- )
- {
- Std_ReturnType retVal = E_NOT_OK;
- Eep_ReturnType EepIpwReturn = EEP_E_OK;
- uint8 const * pSourceAdd = pSourceAddressPtr;
- Eep_LengthType u32LengthRemaining = u32Length;
- Eep_AddressType u32DestAdd = u32TargetAddress;
- /* in the quick writes mode only 4 bytes alligned writes are allowed */
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_QUICK_WRITE_ID, EEP_E_UNINIT);
- }
- else
- {
- #endif
- if ((Std_ReturnType)E_OK == Eep_Ipw_CheckQuickWriteParams(u32DestAdd, pSourceAdd, u32LengthRemaining, u16QuickWritesLength))
- {
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_05();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_05();
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_QUICK_WRITE_ID, EEP_E_BUSY);
- #endif
- }
- else
- {
- EepIpwReturn = Eep_Ipw_QuickWrite(u32DestAdd, pSourceAdd, u16QuickWritesLength);
- pSourceAdd = (uint8*)((uint32)pSourceAdd + u16QuickWritesLength);
- u32DestAdd += u16QuickWritesLength;
- u32LengthRemaining -= u16QuickWritesLength;
- if (u32LengthRemaining == 0U)
- {
- if (EEP_E_OK == EepIpwReturn)
- {
- Eep_eJobResult = MEMIF_JOB_OK;
- retVal = E_OK;
- }
- else
- {
- Eep_eJobResult = MEMIF_JOB_FAILED;
- }
- }
- else
- {
- if (EEP_E_OK == EepIpwReturn)
- {
- /* uint8 source pointer which will be incremented during job processing */
- Eep_pu8JobSrcAddrPtr = pSourceAdd;
- /* uint32 destination address which will be incremented during job processing */
- Eep_u32EepromAddrIt = u32DestAdd;
- Eep_u32RemainingLength = u32LengthRemaining;
- Eep_u16QuickWritesLength = u16QuickWritesLength;
- Eep_eJob = EEP_JOB_QUICK_WRITE;
- Eep_eJobResult = MEMIF_JOB_PENDING;
- retVal = E_OK;
- }
- else
- {
- Eep_eJobResult = MEMIF_JOB_FAILED;
- }
- }
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_05();
- }
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif
- return retVal;
- }
- #endif /* EEP_QUICK_WRITES_API */
- #if (EEP_CANCEL_API == STD_ON)
- /**
- * @brief Cancel an ongoing eeprom read, write, erase or compare job.
- * @details Abort a running job synchronously so that directly after returning
- * from this function a new job can be started.
- *
- * @api
- *
- * @pre The module must be initialized.
- * @post @p Eep_Cancel changes module status and @p Eep_eJobResult
- * internal variable.
- *
- * @implements Eep_Cancel_Activity
- */
- void Eep_Cancel (void)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_CANCEL_ID, EEP_E_UNINIT);
- }
- else
- {
- #endif
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_06();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (EEP_MCORE_ENABLED == STD_ON)
- /* Lock gate */
- if (EEP_MCORE_HW_JOB_STARTED == Eep_MCoreHwJobStatus)
- {
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON)*/
- /* If underlying hardware job was successfully canceled */
- if (EEP_E_OK == Eep_Ipw_Cancel())
- {
- /* Update global job result status */
- Eep_eJobResult = MEMIF_JOB_CANCELED;
- }
- #if (EEP_MCORE_ENABLED == STD_ON)
- }
- else
- {
- /* Job is not started on hardware */
- Eep_eJobResult = MEMIF_JOB_CANCELED;
- }
- if ((Std_ReturnType)E_OK != (Std_ReturnType)(Eep_MCoreJobSema4Release()))
- {
- /* Unlock is not successful */
- Eep_eJobResult = MEMIF_JOB_FAILED;
- }
- Eep_MCoreHwJobStatus = EEP_MCORE_HW_JOB_IDLE;
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON)*/
- /* Call the error notification function if configured */
- Eep_CallNotification(Eep_eJobResult);
- }
- else
- {
- /* Leave the job result unchanged */
- }
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_06();
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- }
- #endif /* EEP_CANCEL_API == STD_ON */
- #if (EEP_GET_STATUS_API == STD_ON)
- /**
- * @brief Returns the EEP module status.
- * @details Returns the EEP module status synchronously.
- *
- * @return MemIf_StatusType
- * @retval MEMIF_UNINIT Module has not been initialized (yet).
- * @retval MEMIF_IDLE Module is currently idle.
- * @retval MEMIF_BUSY Module is currently busy.
- *
- * @api
- *
- * @implements Eep_GetStatus_Activity
- */
- MemIf_StatusType Eep_GetStatus (void)
- {
- MemIf_StatusType eRetVal = MEMIF_IDLE;
- /* Check the driver was initialized */
- if (NULL_PTR == Eep_pConfigPtr)
- {
- eRetVal = MEMIF_UNINIT;
- }
- /* There is a pending job */
- else if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- eRetVal = MEMIF_BUSY;
- }
- else
- {
- eRetVal = MEMIF_IDLE;
- }
- return eRetVal;
- }
- #endif /* EEP_GET_STATUS_API == STD_ON */
- #if (EEP_GET_JOB_RESULT_API == STD_ON)
- /**
- * @brief Returns the result of the last job.
- * @details Returns synchronously the result of the last job.
- *
- * @return MemIf_JobResultType
- * @retval MEMIF_JOB_OK Successfully completed job.
- * @retval MEMIF_JOB_FAILED Not successfully completed job.
- * @retval MEMIF_JOB_PENDING Still pending job (not yet completed).
- * @retval MEMIF_JOB_CANCELED Job has been canceled.
- * @retval MEMIF_BLOCK_INCONSISTENT Inconsistent block requested, it may
- * contains corrupted data.
- * @retval MEMIF_BLOCK_INVALID Invalid block requested.
- *
- * @api
- *
- * @implements Eep_GetJobResult_Activity
- */
- MemIf_JobResultType Eep_GetJobResult (void)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_OK;
- /* Check the driver was initialized */
- if (NULL_PTR == Eep_pConfigPtr)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_GETJOBRESULT_ID, EEP_E_UNINIT);
- #endif
- eRetVal = (MemIf_JobResultType)MEMIF_JOB_FAILED;
- }
- else
- {
- /* Get the job result */
- eRetVal = Eep_eJobResult;
- }
- return eRetVal;
- }
- #endif
- /**
- * @brief Reads from eeprom memory.
- * @details Starts a read job asynchronously. The actual job is performed by
- * @p Eep_MainFunction.
- *
- * @param[in] SourceAddress Source address in eeprom memory.
- * @param[in] Length Number of bytes to read.
- * @param[out] TargetAddressPtr Pointer to target data buffer.
- *
- * @return MemIf_JobResultType
- * @retval MEMIF_JOB_OK Successfully completed job.
- * @retval MEMIF_JOB_FAILED Not successfully completed job.
- * @retval MEMIF_JOB_PENDING Still pending job (not yet completed).
- * @retval MEMIF_JOB_CANCELED Job has been canceled.
- * @retval MEMIF_BLOCK_INCONSISTENT Inconsistent block requested, it may
- * contains corrupted data.
- * @retval MEMIF_BLOCK_INVALID Invalid block requested.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- * @post
- *
- * @implements Eep_Read_Activity
- *
- */
- Std_ReturnType Eep_Read (Eep_AddressType u32SourceAddress,
- uint8 * pTargetAddressPtr,
- Eep_LengthType u32Length
- )
- {
- Std_ReturnType u8RetVal = (Std_ReturnType)E_OK;
- /* Check driver was initialized */
- if (NULL_PTR == Eep_pConfigPtr)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_READ_ID, EEP_E_UNINIT);
- #endif
- u8RetVal = (Std_ReturnType)E_NOT_OK;
- }
- else if ((Std_ReturnType)E_NOT_OK == Eep_Ipw_CheckReadParams(u32SourceAddress, pTargetAddressPtr, u32Length))
- {
- u8RetVal = E_NOT_OK;
- }
- else
- {
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_03();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_READ_ID, EEP_E_BUSY);
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- u8RetVal = (Std_ReturnType)E_NOT_OK;
- }
- else
- {
- /* Configure the read job */
- Eep_u32EepromAddrIt = u32SourceAddress;
- Eep_pu8JobDataDestPtr = pTargetAddressPtr;
- Eep_u32RemainingLength = u32Length;
- Eep_eJob = EEP_JOB_READ;
- /* Execute the read job */
- Eep_eJobResult = MEMIF_JOB_PENDING;
- }
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_03();
- }
- return u8RetVal;
- }
- #if (EEP_COMPARE_API == STD_ON)
- /**
- * @brief Compares a eeprom memory area with an application data buffer.
- * @details Starts a compare job asynchronously. The actual job is performed by
- * Eep_MainFunction.
- *
- * @param[in] SourceAddress Source address in eeprom memory.
- * @param[in] TargetAddressPtr Pointer to source data buffer.
- * @param[in] Length Number of bytes to compare.
- *
- * @return Std_ReturnType
- * @retval E_OK Compare command has been accepted.
- * @retval E_NOT_OK Compare command has not been accepted.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- *
- * @implements Eep_Compare_Activity
- */
- Std_ReturnType Eep_Compare (Eep_AddressType u32SourceAddress,
- const uint8 * pTargetAddressPtr,
- Eep_LengthType u32Length
- )
- {
- Std_ReturnType u8RetVal = (Std_ReturnType)E_OK;
- /* Check driver was initialized */
- if (NULL_PTR == Eep_pConfigPtr)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_COMPARE_ID, EEP_E_UNINIT);
- #endif
- u8RetVal = (Std_ReturnType)E_NOT_OK;
- }
- else if ((Std_ReturnType)E_NOT_OK == Eep_Ipw_CheckCompareParams(u32SourceAddress, pTargetAddressPtr, u32Length))
- {
- u8RetVal = E_NOT_OK;
- }
- else
- {
- SchM_Enter_Eep_EEP_EXCLUSIVE_AREA_04();
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_COMPARE_ID, EEP_E_BUSY);
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- u8RetVal = (Std_ReturnType)E_NOT_OK;
- }
- else
- {
- /* Set job for compare operation */
- Eep_u32EepromAddrIt = u32SourceAddress;
- Eep_pu8JobSrcAddrPtr = pTargetAddressPtr;
- Eep_u32RemainingLength = u32Length;
- Eep_eJob = EEP_JOB_COMPARE;
- Eep_eJobResult = MEMIF_JOB_PENDING;
- }
- SchM_Exit_Eep_EEP_EXCLUSIVE_AREA_04();
- }
- return u8RetVal;
- }
- #endif /* EEP_COMPARE_API == STD_ON */
- #if (EEP_SET_MODE_API == STD_ON)
- /**
- * @brief Sets the EEP module's operation mode to the given Mode.
- * @details Every given mode determinates maximum bytes for read-write
- * operations. Every mode has a set of pre-configured values.
- *
- * @param[in] Mode MEMIF_MODE_FAST or MEMIF_MODE_SLOW.
- *
- * @api
- *
- * @pre The module has to be initialized and not busy.
- * @post @p Eep_SetMode changes internal variables @p Eep_u32MaxRead and
- * @p Eep_u32MaxWrite.
- *
- * @implements Eep_SetMode_Activity
- */
- void Eep_SetMode (MemIf_ModeType eMode)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_SETMODE_ID, EEP_E_UNINIT);
- }
- else if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_SETMODE_ID, EEP_E_BUSY);
- }
- else
- {
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- /* Set the max number of bytes to read/write
- during Eep_MainFunction call */
- switch (eMode)
- {
- case MEMIF_MODE_FAST:
- Eep_u32MaxRead = Eep_pConfigPtr->u32MaxReadFastMode;
- Eep_u32MaxWrite = Eep_pConfigPtr->u32MaxWriteFastMode;
- break;
- case MEMIF_MODE_SLOW:
- Eep_u32MaxRead = Eep_pConfigPtr->u32MaxReadNormalMode;
- Eep_u32MaxWrite = Eep_pConfigPtr->u32MaxWriteNormalMode;
- break;
- default:
- /* Do nothing - should not happen in Fully Trusted Environment;
- 'default' clause added to fulfill MISRA Rule 15.3 */
- break;
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- }
- #endif /* EEP_SET_MODE_API == STD_ON */
- #if (EEP_VERSION_INFO_API == STD_ON)
- /**
- * @brief Returns version information about EEP module.
- * @details Version information includes:
- * - Module Id
- * - Vendor Id
- * - Vendor specific version numbers (BSW00407).
- *
- * @param[in,out] pVersionInfoPtr Pointer to where to store the version information of this module.
- *
- * @api
- *
- * @implements Eep_GetVersionInfo_Activity
- *
- */
- void Eep_GetVersionInfo (Std_VersionInfoType * pVersionInfoPtr)
- {
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == pVersionInfoPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_GETVERSIONINFO_ID, EEP_E_PARAM_POINTER);
- }
- else
- {
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- pVersionInfoPtr->moduleID = (uint16)EEP_MODULE_ID;
- pVersionInfoPtr->vendorID = (uint16)EEP_VENDOR_ID;
- pVersionInfoPtr->sw_major_version = (uint8)EEP_SW_MAJOR_VERSION;
- pVersionInfoPtr->sw_minor_version = (uint8)EEP_SW_MINOR_VERSION;
- pVersionInfoPtr->sw_patch_version = (uint8)EEP_SW_PATCH_VERSION;
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- }
- #endif
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- /**
- * @brief Reports DEM errors
- * @details Reports production errors.
- *
- * @param[in,out] -
- *
- * @api
- *
- */
- static void Eep_ReportDemErrors (void)
- {
- switch (Eep_eJob)
- {
- case EEP_JOB_ERASE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_EraseFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_EraseFailedCfg.id, DEM_EVENT_STATUS_FAILED);
- }
- break;
- case EEP_JOB_WRITE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_WriteFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_WriteFailedCfg.id, DEM_EVENT_STATUS_FAILED);
- }
- break;
- case EEP_JOB_READ:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_ReadFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_ReadFailedCfg.id, DEM_EVENT_STATUS_FAILED);
- }
- break;
- #if (EEP_COMPARE_API == STD_ON)
- case EEP_JOB_COMPARE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_CompareFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_CompareFailedCfg.id, DEM_EVENT_STATUS_FAILED);
- }
- break;
- #endif
-
- #if (EEP_QUICK_WRITES_API == STD_ON)
- case EEP_JOB_QUICK_WRITE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.id, DEM_EVENT_STATUS_FAILED);
- }
- break;
- #endif
- default:
- /* Do nothing - should not happen in Fully Trusted Environment;
- 'default' clause added to fulfill MISRA Rule 15.3 */
- break;
- }
- }
- /**
- * @brief Reports DEM passes
- * @details Reports production passes.
- *
- * @param[in,out] -
- *
- * @api
- *
- */
- static void Eep_ReportDemPasses (void)
- {
- switch (Eep_eJob)
- {
- case EEP_JOB_ERASE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_EraseFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_EraseFailedCfg.id, DEM_EVENT_STATUS_PASSED);
- }
- break;
- case EEP_JOB_WRITE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_WriteFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_WriteFailedCfg.id, DEM_EVENT_STATUS_PASSED);
- }
- break;
- case EEP_JOB_READ:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_ReadFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_ReadFailedCfg.id, DEM_EVENT_STATUS_PASSED);
- }
- break;
- #if (EEP_COMPARE_API == STD_ON)
- case EEP_JOB_COMPARE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_CompareFailedCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_CompareFailedCfg.id, DEM_EVENT_STATUS_PASSED);
- }
- break;
- #endif
- #if (EEP_QUICK_WRITES_API == STD_ON)
- case EEP_JOB_QUICK_WRITE:
- if ((uint32)STD_ON == Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.state)
- {
- (void)Dem_SetEventStatus((Dem_EventIdType)Eep_pConfigPtr->Eep_E_BOQuickWritesCfg.id, DEM_EVENT_STATUS_PASSED);
- }
- break;
- #endif
- default:
- /* Do nothing - should not happen in Fully Trusted Environment;
- default clause added to fulfill MISRA Rule 15.3 */
- break;
- }
- }
- #endif
- /**
- * @brief Performs actual eeprom read, write, erase and compare jobs.
- * @pre The module has to be initialized.
- * @param[in] eJob Currently executed job (erase, write, read, or compare)
- *
- * @return MemIf_JobResultType
- * @retval MEMIF_JOB_OK Successfully completed job.
- * @retval MEMIF_JOB_FAILED Not successfully completed job.
- * @retval MEMIF_JOB_PENDING Still pending job (not yet completed).
- * @retval MEMIF_JOB_CANCELED Job has been canceled.
- * @retval MEMIF_BLOCK_INCONSISTENT Inconsistent block requested, it may
- * contains corrupted data.
- * @retval MEMIF_BLOCK_INVALID Invalid block requested.
- */
- static MemIf_JobResultType Eep_ProcessRequestedJobs (Eep_JobType eJob)
- {
- MemIf_JobResultType eRetVal = MEMIF_JOB_FAILED;
- switch (eJob)
- {
- case EEP_JOB_ERASE:
- /* Process erase job */
- eRetVal = Eep_ProcessEraseJob();
- break;
- case EEP_JOB_WRITE:
- /* Process write job */
- eRetVal = Eep_ProcessWriteJob();
- break;
- case EEP_JOB_READ:
- /* Process read job */
- eRetVal = Eep_ProcessReadJob();
- break;
- #if (EEP_COMPARE_API == STD_ON)
- case EEP_JOB_COMPARE:
- /* Process compare job */
- eRetVal = Eep_ProcessCompareJob();
- break;
- #endif
- #if (EEP_QUICK_WRITES_API == STD_ON)
- case EEP_JOB_QUICK_WRITE:
- eRetVal = Eep_ProcessQuickWriteJob();
- break;
- #endif
- default:
- /* Do nothing - should not happen in Fully Trusted Environment;
- 'default' clause added to fulfill MISRA Rule 15.3 */
- break;
- }
- return eRetVal;
- }
- /**
- * @brief Only executed at the end of a new job
- *
- * @param[in] None
- *
- * @pre The module has to be initialized.
- *
- */
- static void Eep_EndJobs (void)
- {
- #if (EEP_DISABLE_DEM_REPORT_ERROR_STATUS == STD_OFF)
- /* if job failed report errors */
- if (MEMIF_JOB_FAILED == Eep_eJobResult)
- {
- Eep_ReportDemErrors();
- }
- else if (MEMIF_JOB_OK == Eep_eJobResult)
- {
- Eep_ReportDemPasses();
- }
- else
- {
- /* Not report any dems */
- }
- #endif
- /* call notifications when job was finished */
- if ((MEMIF_JOB_FAILED == Eep_eJobResult) || (MEMIF_BLOCK_INCONSISTENT == Eep_eJobResult) || (MEMIF_JOB_OK == Eep_eJobResult))
- {
- Eep_CallNotification(Eep_eJobResult);
- }
- }
- /**
- * @brief Performs actual eeprom read, write, erase and compare jobs.
- * @details Bytes number processed per cycle depends by job type (erase, write, read, compare)
- * current EEP module's operating mode (normal, fast)
- * and write, erase Mode of Execution (sync, async).
- *
- * @api
- *
- * @pre The module has to be initialized.
- *
- *
- * @note This function have to be called ciclically by the Basic Software Module;
- * it will do nothing if there aren't pending job.
- * @implements Eep_MainFunction_Activity
- */
- void Eep_MainFunction (void)
- {
- #if (STD_ON == EEP_MCORE_ENABLED)
- static uint32 u32TimeoutTicks = 0U;
- static uint32 u32CurrentTicks = 0U;
- static uint32 u32ElapsedTicks = 0U;
- Eep_MCoreReqReturnType eMcoreStatus;
- #endif
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- if (NULL_PTR == Eep_pConfigPtr)
- {
- (void) Det_ReportError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_MAINFUNCTION_ID, EEP_E_UNINIT);
- }
- else
- {
- #endif
- if (MEMIF_JOB_PENDING == Eep_eJobResult)
- {
- #if (STD_ON == EEP_MCORE_ENABLED)
- if (EEP_MCORE_HW_JOB_IDLE == Eep_MCoreHwJobStatus)
- {
- u32TimeoutTicks = OsIf_MicrosToTicks(EEP_MCORE_LOCK_GATES_TIMEOUT,(OsIf_CounterType)USDHC_IP_TIMEOUT_TYPE);
- u32CurrentTicks = OsIf_GetCounter((OsIf_CounterType)USDHC_IP_TIMEOUT_TYPE);
- u32ElapsedTicks = 0U;
- Eep_MCoreHwJobStatus = EEP_MCORE_HW_JOB_MAINF_STARTED;
- }
- eMcoreStatus = Eep_ReqMCore();
- if (EEP_MCORE_PENDING == eMcoreStatus)
- {
- u32ElapsedTicks += OsIf_GetElapsed(&u32CurrentTicks, (OsIf_CounterType)USDHC_IP_TIMEOUT_TYPE);
- if (u32ElapsedTicks >= u32TimeoutTicks)
- {
- Eep_eJobResult = MEMIF_JOB_FAILED;
- (void)Det_ReportRuntimeError((uint16)EEP_MODULE_ID, EEP_INSTANCE_ID, EEP_MAINFUNCTION_ID, EEP_E_TIMEOUT);
- }
- }
- else
- {
- /* Seme4 is granted */
- Eep_MCoreHwJobStatus = EEP_MCORE_HW_JOB_STARTED;
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- /* Process the requested jobs : write, compare, erase, read */
- Eep_eJobResult = Eep_ProcessRequestedJobs(Eep_eJob);
- #if (EEP_MCORE_ENABLED == STD_ON)
- }
- #endif /*#if (EEP_MCORE_ENABLED == STD_ON)*/
- if (MEMIF_JOB_PENDING != Eep_eJobResult)
- {
- #if (EEP_MCORE_ENABLED == STD_ON)
- Eep_MCoreHwJobStatus = EEP_MCORE_HW_JOB_IDLE;
- /* Release any sema4 used for processing this job in multicore context, if any was used. */
- if ((Std_ReturnType)E_OK != (Std_ReturnType)(Eep_MCoreJobSema4Release()))
- {
- /* Release is not successful */
- Eep_eJobResult = MEMIF_JOB_FAILED;
- }
- #endif /*#if (EEP_MCORE_ENABLED == STD_ON)*/
- /* only executed at the end of a new job */
- Eep_EndJobs();
- }
- }
- else
- {
- /* Nothing to do since no job is pending */
- }
- #if (EEP_DEV_ERROR_DETECT == STD_ON)
- }
- #endif /* EEP_DEV_ERROR_DETECT == STD_ON */
- }
- #if (EEP_MCORE_ENABLED == STD_ON)
- static Eep_MCoreReqReturnType Eep_ReqMCore(void)
- {
- uint32 u32GetGateStatus;
- Eep_MCoreReqReturnType eRetVal = EEP_MCORE_ERROR;
- u32GetGateStatus = Rm_SemaphoreGetStatus(EEP_MCORE_SEMA4_JOB);
- if (Eep_u32DoMainID == u32GetGateStatus)
- {
- eRetVal = EEP_MCORE_GRANTED;
- }
- else if (RM_SEMAPHORE_FREE == u32GetGateStatus)
- {
- if ((Std_ReturnType)E_OK == (Std_ReturnType)(Rm_SemaphoreLockGate(EEP_MCORE_SEMA4_JOB)))
- {
- /* EEP_MCORE_SEMA4_JOB taken. */
- eRetVal = EEP_MCORE_GRANTED;
- }
- else
- {
- /* Due to race condition this core couldn't take the SEMA4. */
- eRetVal = EEP_MCORE_PENDING;
- }
- }
- else
- {
- /* Sema4 is taken by other core */
- eRetVal = EEP_MCORE_PENDING;
- }
- return eRetVal;
- }
- /* Lock Gate */
- static Std_ReturnType Eep_MCoreInitSema4sLock (void)
- {
- Std_ReturnType eRetVal = (Std_ReturnType)E_OK;
- uint32 u32timeoutTicks = OsIf_MicrosToTicks(EEP_MCORE_LOCK_GATES_TIMEOUT, (OsIf_CounterType)USDHC_IP_TIMEOUT_TYPE);
- uint32 u32currentTicks = OsIf_GetCounter((OsIf_CounterType)USDHC_IP_TIMEOUT_TYPE);
- uint32 u32elapsedTicks = 0U;
- while (((Std_ReturnType)E_OK != (Std_ReturnType)Rm_SemaphoreLockGate((uint8)EEP_MCORE_SEMA4_JOB)) && (u32elapsedTicks < u32timeoutTicks))
- {
- u32elapsedTicks += OsIf_GetElapsed(&u32currentTicks, USDHC_IP_TIMEOUT_TYPE);
- }
- if (u32elapsedTicks >= u32timeoutTicks)
- {
- /* Timeout errors */
- eRetVal = E_NOT_OK;
- }
- return eRetVal;
- }
- /* Release Gate */
- static Std_ReturnType Eep_MCoreJobSema4Release (void)
- {
- Std_ReturnType eRetVal = (Std_ReturnType)E_OK;
- if (Eep_u32DoMainID == (uint32)Rm_SemaphoreGetStatus((uint8)EEP_MCORE_SEMA4_JOB))
- {
- if ((Std_ReturnType)E_OK != (Std_ReturnType)(Rm_SemaphoreUnlockGate((uint8)EEP_MCORE_SEMA4_JOB)))
- {
- eRetVal = E_NOT_OK;
- }
- }
- else
- {
- /* Do nothing. */
- }
- return eRetVal;
- }
- #endif /* #if (EEP_MCORE_ENABLED == STD_ON) */
- #define EEP_STOP_SEC_CODE
- #include "Eep_MemMap.h"
- #ifdef __cplusplus
- }
- #endif
- /** @} */
|