SNIP_CLASSIC_EA_SECTION_8_3_4_Ea_Cancel

8.3.4 Ea_Cancel [SWS_Ea_00088] Definition of API function Ea_Cancel Upstream requirements: SRS_MemHwAb_14031 ⌈ Service Name Ea_Cancel Syntax void Ea_Cancel ( void ) Service ID [hex] 0x04 Sync/Async Asynchronous Reentrancy Non Reentrant Parameters (in) None Parameters (inout) None Parameters (out) None Return value None Description Cancels the ongoing asynchronous operation. Available via Ea.h ⌋ [SWS_Ea_00132] Upstream requirements: SRS_BSW_00406 ⌈If development error detection for the module EA is enabled: the function Ea_Cancel shall check if the module state is MEMIF_UNINIT. If this is the case, the function Ea_ Cancel shall raise the development error EA_E_UNINIT and return to the caller without changing any internal variables.⌋ [SWS_Ea_00077] Upstream requirements: SRS_MemHwAb_14031 ⌈If the current module status is MEMIF_BUSY (i.e. the request to cancel a pending job is accepted by the function Ea_Cancel), the function Ea_Cancel shall call the cancel function of the underlying EEPROM driver.⌋ [SWS_Ea_00078] Upstream requirements: SRS_MemHwAb_14031 ⌈If the current module status is MEMIF_BUSY (i.e. the request to cancel a pending job is accepted by the function Ea_Cancel), the function Ea_Cancel shall reset the EA module’s internal variables to make the module ready for a new job request. I.e. the function Ea_Cancel shall set the job result to MEMIF_JOB_CANCELED and the module status to MEMIF_IDLE.⌋ [SWS_Ea_00160] Upstream requirements: SRS_MemHwAb_14031 ⌈If the current module status is not MEMIF_BUSY (i.e. the request to cancel a pending job is rejected by the function Ea_Cancel), the function Ea_Cancel shall not change the current module status or job result.⌋ [SWS_Ea_00173] Upstream requirements: SRS_BSW_00323 ⌈If the current module status is not MEMIF_BUSY (i.e. there is no job to cancel and therefore the request to cancel a pending job is rejected by the function Ea_Cancel), the function Ea_Cancel shall raise the runtime error EA_E_INVALID_CANCEL.⌋