UM1634 datasheet(16/43 Pages) STMICROELECTRONICS

16 / 43 page

API specification

UM1634

16/43

DocID024601 Rev 3

Return values

Comments

If the blank checking fails, the first failing address is saved to *pFailAddress, and the failing

data in Flash is saved to *pFailData. The contents pointed by pFailAddress and pFailData

are updated only when there is a non-blank location in the checked Flash range.

Assumptions

It assumes that the Flash block is initialized using a ‘FlashInit()’ API.

size

Size, in bytes, of the Flash

region to check.

If size = 0, the return value is C90FL_OK.

It should be multiple of 8 and its combination with

dest should fall in either main array or shadow row.

pFailAddress

Return the address of the first

non-blank Flash location in the

checking region.

Only valid when this function returns

C90FL_ERROR_NOT_BLANK.

pFailData

Return the content of the first

non-blank Flash location in the

checking region.

Only valid when this function returns

C90FL_ERROR_NOT_BLANK.

CallBack

Address of void callback

function.

Any addressable void function address. To disable

it use NULL_CALLBACK macro.

Table 13. Return values for BlankCheck()

Return Values

Possible Causes

Solution

C90FL_ERROR_ALIGNMENT

The dest and size are not

properly aligned.

Check if dest and size are

aligned on double word (64-bit)

boundary.

C90FL_ERROR_RANGE

The area specified by dest and

size is out of the valid C90FL

array ranges.

Check dest and dest+size. The

area to be checked must be

within main array space or

shadow space.

C90FL_ERROR_NOT_BLANK

There is a non-blank double

word within the area to be

checked.

Re-erase the relevant blocks and

check again.

C90FL_OK

Successful completion.

Table 12. Arguments for BlankCheck()

Argument

Description

Range

UM1634 Datasheet(PDF) 16 Page - STMicroelectronics

UM1634 Datasheet(HTML) 16 Page - STMicroelectronics

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43

Datasheet Download

Link URL