SNIP_CLASSIC_EA_SECTION_8_3_9_Ea_EraseImmediateBlock

8.3.9 Ea_EraseImmediateBlock [SWS_Ea_00093] Definition of API function Ea_EraseImmediateBlock Upstream requirements: SRS_MemHwAb_14032 ⌈ Service Name Ea_EraseImmediateBlock Syntax Std_ReturnType Ea_EraseImmediateBlock ( uint16 BlockNumber ) Service ID [hex] 0x09 Sync/Async Asynchronous Reentrancy Non Reentrant Parameters (in) BlockNumber Number of logical block, also denoting start address of that block in EEPROM. Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: The requested job has been accepted by the module. E_NOT_OK - only if DET is enabled: The requested job has not been accepted by the EA module. Description Erases the block BlockNumber. Available via Ea.h ⌋ Note: The function Ea_EraseImmediateBlock shall only be called by e.g. diagnostic or similar system services to pre-erase the area for immediate data if necessary. [SWS_Ea_00063] Upstream requirements: SRS_MemHwAb_14009, SRS_MemHwAb_14032 ⌈The function Ea_EraseImmediateBlock shall take the block number and calculate the corresponding memory block address. The block offset shall be fixed to zero for this address calculation.⌋ [SWS_Ea_00064] Upstream requirements: SRS_MemHwAb_14032 ⌈The function Ea_EraseImmediateBlock shall ensure that the EA module can write immediate data. Whether this involves physically erasing a memory area and therefore calling the erase function of the underlying driver depends on the implementation.⌋ [SWS_Ea_00136] Upstream requirements: SRS_BSW_00406 ⌈If development error detection for the module EA is enabled: the function Ea_Erase ImmediateBlock shall check if the module state is MEMIF_UNINIT. If this is the case, the function Ea_EraseImmediateBlock shall reject the erase request, raise the development error EA_E_UNINIT and return with E_NOT_OK.⌋ [SWS_Ea_00176] Upstream requirements: SRS_BSW_00323 ⌈The function Ea_EraseImmediateBlock shall check if the module state is MEMIF_ BUSY. If this is the case, the function shall reject the erase request, raise the runtime error EA_E_BUSY and return with E_NOT_OK.⌋ [SWS_Ea_00152] Upstream requirements: SRS_BSW_00323 ⌈If development error detection for the module EA is enabled: the function Ea_Erase ImmediateBlock shall check whether the given block number is valid (i.e. it has been configured). If this is not the case, the function Ea_EraseImmediateBlock shall reject the erase request, raise the development error EA_E_INVALID_BLOCK_NO and return with E_NOT_OK.⌋ [SWS_Ea_00065] Upstream requirements: SRS_BSW_00323, SRS_MemHwAb_14032 ⌈If development error detection for the EA module is enabled, the function Ea_Erase ImmediateBlock shall check whether the addressed logical block is configured as containing immediate data (configuration parameter EaImmediateData == TRUE). If not, the function Ea_EraseImmediateBlock shall reject the erase request, raise the deleopment error EA_E_INVALID_BLOCK_NO and return with E_NOT_OK.⌋ [SWS_Ea_00162] Upstream requirements: SRS_BSW_00323 ⌈If an erase request for an immediate block is rejected by the function Ea_EraseImmediateBlock, i.e. requirements SWS_Ea_00136, SWS_Ea_00176, SWS_Ea_00152 or SWS_Ea_00065 apply, the function Ea_EraseImmediateBlock shall not change the current module status or job result.⌋