• For each Program Once Field, FLASH_ProgramOnce can only allowed to be called
once; otherwise, an error code is returned.
• For targets which do not support FLASH_ProgramOnce, the value of the
FLASH_ProgramOnce pointer is 0.
Prototype
status_t flash_program_once (flash_driver_t * driver, uint32_t index, uint32_t *src, uint32_t
lengthInBytes);
Table 22-59. Parameters
Parameter
Description
Config
Pointer to
flash_config_t
data structure in memory, to store driver runtime state.
Index
Index for a certain Program Once Field.
src
Pointer to the source buffer of data that is to be programmed into the Program Once Field.
Lengthinbytes
The length, in bytes (not words or long words) to be programmed. Must be word-aligned.
Table 22-60. Possible status response
Value
Constant
Description
4
kStatus_InvalidArgument
Config or src pointers are NULL.
101
kStatus_FLASH_AlignmentError
index or lengthInBytes is invalid.
103
kStatus_FLASH_AddressError
The following situation causes this response:
1. Command is not available under current mode/
security.
2. An invalid index is supplied.
3. The requested Program Once field has already
been programmed to a non-FFFF value.
4. The requested sector crosses a flash block
boundary.
115
kStatus_FLASH_CommandNotSupported
This function is not supported.
0
kStatus_Success
This function has performed successfully.
Example:
Assume the Program Once Field has not been programmed before.
uint32_t expectedData = 0x78563412;
status_t status = FLASH_ProgramOnce(&flashInstance, 0, &expectedData, 4);
NOTE
For the choice of index and length, see the FTFA chapter in RM
for detailed information.
Chapter 22 Kinetis ROM Bootloader
Kinetis KE1xZ256 Sub-Family Reference Manual, Rev. 3, 07/2018
NXP Semiconductors
515
Summary of Contents for Kinetis KE1xZ256
Page 2: ...Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 2 NXP Semiconductors...
Page 178: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 178 NXP Semiconductors...
Page 356: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 356 NXP Semiconductors...
Page 410: ...Interrupts Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 410 NXP Semiconductors...
Page 604: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 604 NXP Semiconductors...
Page 634: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 634 NXP Semiconductors...
Page 674: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 674 NXP Semiconductors...
Page 820: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 820 NXP Semiconductors...
Page 1030: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1030 NXP Semiconductors...
Page 1052: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1052 NXP Semiconductors...
Page 1066: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1066 NXP Semiconductors...
Page 1268: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1268 NXP Semiconductors...
Page 1314: ...Usage Guide Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1314 NXP Semiconductors...
Page 1316: ...Kinetis KE1xZ256 Sub Family Reference Manual Rev 3 07 2018 1316 NXP Semiconductors...