Bulk NvData Manager (BndM)

Initializes or reinitializes this module.

Cancels the writing

This callback function is called when a FLS job has been finished with positive result.

This callback function is called when a FLS job has been canceled or finished with negative result.

Schedule function for the background processing.

This type of the external data structure shall contain the post build initialization data for the BndM.

Unique identification of an bulk nv block. The BndM_BlockId is assigned by the BndM.

The elements of this structure data type is the C-structured representation of the configured ImplementationDataPrototype.

Result of the asynchronous job finish notifications

The BndM shall manage its BndM blocks ( BndMBlockDe- scriptor ) in the direct accessible memory (i.e. via pointer).

A call of BndM_GetBlockPtr shall deliver the base pointer to the corresponding BndM block ( BndMBlockDescriptor ) in the currently active partition.

A call of BndM_WriteStart shall trigger the preparation of the 2nd (free) partition.

A call of BndM_WriteBlock shall trigger the writing of the data to the 2nd (unused) partition. The data (ImplementationDataType) shall be not modified to allow a pointer access.

A call of BndM_WriteFinalize shall trigger the finalization of the 2nd (unused) partition. In background the BndM shall make the 2nd (unused) parti- tion consistent by coping all unchanged BndMBlockDescriptor to the 2nd (unused) partition. If the finalization is successful the BndM shall make the 2nd (unused) partition to the active partition and trigger the callback Xxx_BndMWriteFinalizeFinish with the result set to E_OK .

Type of error Related error code Error value API service called with wrong parameter BNDM_E_PARAM 0x01 API called in wrong sequence BNDM_E_WRONG_SEQUENCE 0x02

After preparation of the 2nd (free) partition [SWS_BndM_00003] is successfully finished (writing to the 2nd partition is pos- sible) the callback Xxx_BndMWriteStartFinish with the result set to E_OK shall be triggered in the context of the BndM_MainFunction .

After writing of [SWS_BndM_00004] the 2nd (free) partition is finished the callback Xxx_BndMWriteBlockFinish with the result set to E_OK shall be triggered in the context of the BndM_MainFunction .

If the finalization is NOT successful (the 2nd partition is not con- sistent and could therefore not be used) the BndM shall keep the current active parti- tion as the active partition and trigger the callback Xxx_BndMWriteFinalizeFinish with the result set to E_NOT_OK .

A call of BndM_WriteFinalize without a previously called BndM_WriteStart or within the finalization mode of the BndM the DET BndM_E_- WRONG_SEQUENCE error shall be thrown.

A call of BndM_WriteBlock shall be rejected with the error- Code E_NOT_OK , if the call is done without a previous call of BndM_WriteStart . or while another writing of the same or another block is ongoing or the call is done within the finalization mode of the BndM.

A call of BndM_WriteBlock shall be rejected with the error- Code E_NOT_OK , if the call is done while another writing of the same or another block is ongoing.

A call of BndM_WriteBlock shall be rejected with the error- Code E_NOT_OK , if the call is done within or after the finalization mode of the BndM.

A call of BndM_WriteStart shall be rejected with the error- Code E_NOT_OK , if the call is done within an active writing phase (phase between BndM_WriteStart and BndM_WriteFinalize ).

There are no mandatory interfaces.

Det_ReportRuntimeError Det.h Service to report runtime errors. If a callout has been configured then this callout shall be called. Fls_Cancel Fls.h Cancels an ongoing job. Fls_Compare Fls_Com.h Compares the contents of an area of flash memory with that of an application data buffer. Fls_Erase Fls.h Erases flash sector(s). Fls_GetJobResult Fls.h Returns the result of the last job. Fls_GetStatus Fls.h Returns the driver state. Fls_Read Fls.h Reads from flash memory. Fls_SetMode Fls.h Sets the flash driver's operation mode. Fls_Write Fls.h Writes one or more complete flash pages.

These requirements are not applicable to this specification.