SNIP_CLASSIC_EA_SECTION_8_3_3_Ea_Write

8.3.3 Ea_Write [SWS_Ea_00087] Definition of API function Ea_Write Upstream requirements: SRS_MemHwAb_14010 ⌈ Service Name Ea_Write Syntax Std_ReturnType Ea_Write ( uint16 BlockNumber, const uint8* DataBufferPtr ) Service ID [hex] 0x03 Sync/Async Asynchronous Reentrancy Non Reentrant BlockNumber Number of logical block, also denoting start address of that block in EEPROM. Parameters (in) DataBufferPtr Pointer to data buffer Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: The requested job has been accepted by the module. E_NOT_OK: The requested job has not been accepted by the EA module. Description Writes the contents of the DataBufferPtr to the block BlockNumber. Available via Ea.h ⌋ [SWS_Ea_00024] Upstream requirements: SRS_MemHwAb_14006, SRS_MemHwAb_14009 ⌈The function Ea_Write shall take the block number and calculate the corresponding memory write address. The block offset shall be fixed to zero for this address calculation.⌋ [SWS_Ea_00151] Upstream requirements: SRS_MemHwAb_14010 ⌈The function Ea_Write shall set the length parameter for the write job to the length configured for this logical block.⌋ [SWS_Ea_00025] Upstream requirements: SRS_MemHwAb_14013 ⌈If the current module status is MEMIF_IDLE or if the current module status is MEMIF_ BUSY INTERNAL, the function Ea_Write shall accept the write request, copy the given / computed parameters to module internal variables, initiate a write job, set the EA module status to MEMIF_BUSY, set the job result to MEMIF_JOB_PENDING and return with E_OK.⌋ [SWS_Ea_00181] Upstream requirements: SRS_MemHwAb_14010 ⌈If the current module status is MEMIF_UNINIT or MEMIF_BUSY, the function Ea_ Write shall reject the job request and return with E_NOT_OK.⌋ [SWS_Ea_00026] ⌈The EA module shall execute the write job of the function Ea_Write asynchronously within the EA module’s main function.⌋ [SWS_Ea_00131] Upstream requirements: SRS_BSW_00406 ⌈If development error detection for the module EA is enabled: the function Ea_Write shall check if the module state is MEMIF_UNINIT. If this is the case, the function Ea_ Write shall reject the write request, raise the development error EA_E_UNINIT and return with E_NOT_OK.⌋ [SWS_Ea_00171] Upstream requirements: SRS_BSW_00406 ⌈The function Ea_Write shall check if the module state is MEMIF_BUSY. If this is the case, the function Ea_Write shall reject the write request, raise the runtime error EA_ E_BUSY and return with E_NOT_OK.⌋ [SWS_Ea_00148] Upstream requirements: SRS_BSW_00323 ⌈If development error detection for the module EA is enabled: the function Ea_Write shall check whether the given block number is valid (i.e. inside the configured range). If this is not the case, the function Ea_Write shall reject the write request, raise the development error EA_E_INVALID_BLOCK_NO and return with E_NOT_OK.⌋ [SWS_Ea_00172] Upstream requirements: SRS_BSW_00323 ⌈If development error detection is enabled for the module: the function Ea_Write shall check that the given data pointer is valid (i.e. that it is not NULL). If this is not the case, the function Ea_Write shall reject the write request, raise the development error EA_ E_PARAM_POINTER and return with E_NOT_OK.⌋ [SWS_Ea_00159] Upstream requirements: SRS_MemHwAb_14010, SRS_BSW_00323 ⌈If a write request is rejected by the function Ea_Write, i.e. requirements SWS_ Ea_00131, SWS_Ea_00171, SWS_Ea_00148, SWS_Ea_00172 or SWS_Ea_00181 apply, the function Ea_Write shall not change the current module status or job result.⌋