UM1634 datasheet(18/43 Pages) STMICROELECTRONICS

18 / 43 page

API specification

UM1634

18/43

DocID024601 Rev 3

Return values

Comments

If the selected main array blocks or the shadow row is locked for programming, those blocks

or the shadow row are not programmed, and ‘FlashProgram()’ still returns C90FL_OK. User

needs to verify the programmed data with ‘ProgramVerify()’ function.

It is impossible to program any Flash block or shadow row when a program or erase

operation is already in progress on C90FL module. ‘FlashProgram()’ returns

C90FL_ERROR_BUSY when doing so. However, user can use the ‘FlashSuspend()’

function to suspend an on-going erase operation on one block to perform a program

operation on another block. An exception is that once the user has begun an erase

operation on the main array or shadow row, it may not be suspended to program the main

array and vice-versa.

It is unsafe to read the data from the Flash partitions having one or more blocks being

programmed when ‘FlashProgram()’ is running. Otherwise, it causes a Read-While-Write

error.

If the address to be programmed by the user lies across the boundaries of LAS, MAS and

HAS, ‘FlashProgram()’ handles them as follows:

Table 15. Return values for FlashProgram()

Return Values

Possible Causes

Solution

C90FL_ERROR_BUSY

New program operation

cannot be performed

because the flash module is

busy with some operation

and cannot meet the

condition for starting a

program operation.

– Wait until the current operations finish.

– Use ProgramVerify() API to find:

- The first address in FLASH which has

NOT been programmed as expected in -

FlashProgram() API.

-The first address in SOURCE buffer

which has NOT been programmed as

expected in FlashProgram() API.

– Program the rest of data based the new

addresses.

Conditions that program cannot start are:

1. program in progress (MCR-PGM high);

2. program not in progress (MCR-PGM low),

but:

a) erase in progress but not suspended

C90FL_ERROR_ALIG

NMENT

This error indicates that

dest/size/source isn’t

properly aligned

Check if dest and size are aligned on double

word (64-bit) boundary. Check if source is

aligned on word boundary

C90FL_ERROR_RANG

The area specified by dest

and size is out of the valid

C90FL address range.

Check dest and dest+size. Both should fall in

the same C90FL address ranges, i.e. both in

main array or both in shadow row

C90FL_ERROR_PGO

Program operation failed.

Re-erase relevant location and do

programming again. If still fails, check if the

power supplied is sufficient or not.

C90FL_OK

Successful completion.

UM1634 Datasheet(PDF) 18 Page - STMicroelectronics

UM1634 Datasheet(HTML) 18 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