NXP Semiconductors Kinetis KE1xZ256, Reference Manual

Page: 513 / 1325

flash_margin_value_t margin,
uint32_t *failedAddress,
uint32_t *failedData);
Table 22-54. Parameters
Parameter Description
Config Pointer to
flash_config_t
data structure in memory, to store driver runtime state.
Start The start address of the desired flash memory to be verified.
LengthInBytes The length, given in bytes (not words or long-words) to be verified. Must be word-aligned.
ExpectedData Pointer to the expected data that is to be verified against.
Margin Read margin choice as follows:
kFLASH_MarginValueUser 1 kFLASH_MarginValueFactory 2
FailedAddress Pointer to returned failing address.
FailedData Pointer to return failing data. Some derivatives do not include failed data as part of the FCCOBx
registers. In this instance, 0x00s are returned upon failure.
Table 22-55. Possible status response
Value Contants Description
4 kStatus_InvalidArgument Config or expectedData pointers are NULL.
101 kStatus_FlashAlignmentError Start or lengthInBytes is not longword-aligned.
102 kStatus_FLASH_AddressError The range to be verified is invalid.
103 kStatus_FLASH_AccessError The following situation causes this response:
1. Command is not available under current mode/
security.
2. An invalid margin code is supplied.
105 kStatus_FLASH_CommandFailure Either of the margin reads does not match the
expected data.
0 kStatus_Success This function has performed successfully.
Example:
Assume that flash region from 0x800 to 0x807 is successfully programmed with:
0x01 0x23 0x45 0x67 0x89 0xab 0xcd 0xef
uint8_t expectedData[] = {0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef };
status_t status = FLASH_VerifyProgram (&flashInstance, 0x800, 8,
&expectedData[0], kFlashMargin_User, NULL, NULL);
NOTE
For the choice of margin, see the FTFA chapter in the reference
manual for detailed information.
22.4.5.11 FLASH_GetProperty
Chapter 22 Kinetis ROM Bootloader
Kinetis KE1xZ256 Sub-Family Reference Manual, Rev. 3, 07/2018
NXP Semiconductors 513