UM1618 datasheet(21/51 Pages) STMICROELECTRONICS

21 / 51 page

DocID024371 Rev 3

21/51

UM1618

API specification

Return values

Troubleshooting

size

Size, in bytes, of the Flash region

to be programmed.

If size = 0, C55_OK is returned.

It should be multiple of word and its

combination with dest should fall in either

main array or UTest block.

source

Source program buffer address.

This address must reside on word

boundary.

pCtxData

Address of context data structure.

A data structure for storing context

variables

Table 25. Return values for FlashProgram

Type

Description

Possible values

UINT32

Successful completion or error

value.

C55_OK

C55_ERROR_ALTERNATE

C55_ERROR_ALIGNMENTC55_ERROR_BUSY

C55_ERROR_FACTORY_OP

Table 26. Troubleshooting for FlashProgram

Returned Error Bits

Description

Solution

C55_ERROR_ALTERNATE

This error occurs when

user wants to perform

factory program via the

alternate interface.

Use main interface if want to perform

factory program or perform normal

program if want to use alternate

interface.

C55_ERROR_ALIGNMENT

This error indicates that

dest/size/source isn’t

properly aligned.

Check if dest is aligned on double word

(64-bit) boundary. Check if size and

source are aligned on word boundary.

C55_ERROR_BUSY

There is program

operation is in progress

or erase operation is

going on and not in

suspended state.

Wait for the on-going high voltage

operation to finish. Flash program

operation can be started if:

– There is no program or erase

operation being in progress.

– If erase operation is in progress and it

must be in suspended state.

C55_ERROR_FACTORY_OP

The factory program

could not be performed

due to the data at the

‘diary’ location in the

UTest NVM contains at

least one zero.

Check the data at the ‘diary’ location in

the UTest NVM or just perform a normal

program.

Table 24. Arguments for FlashProgram (continued)

Argument

Description

Range

UM1618 Datasheet(PDF) 21 Page - STMicroelectronics

UM1618 Datasheet(HTML) 21 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 44 45 46 47 48 49 50 51

Datasheet Download

Link URL