2.1.3.6 BootloaderProcessorUnlock()

static bl_result_t BootloaderProcessorUnlock (uint8_t * bufferPtr)[static]

Unlocks the bootloader processor using the provided buffer.

This function attempts to unlock the bootloader processor by processing the meta data found at the data pointer.

Parameters:
in	bufferPtr	Pointer to a buffer containing meta data

Returns:
BL_PASS - Bootloader metadata block has been validated and the core memory functions can now be used BL_ERROR_VERIFICATION_FAIL - Invalid data was found in the metadata block and core memory functions remain disabled BL_FAIL - Metadata validation failed unexpectedly

Verify the file format major version. The core must use the exact major version of the file format.

If the file has a lower major version then there are likely missing data elements that are required by the running version of the core.

If the file has a larger major version then the data elements in the new file format have likely shifted around and may not function as intended, so it is more stable to reject it, in this case.

Note: We must always increase the major version of the file anytime the metadata block changes or a new block is added to the file definition, that is a requirement of the core firmware in order to perform an update.