lt_do_mutable_fw_update()

lt_ret_t lt_do_mutable_fw_update	(	lt_handle_t *	h,
		const uint8_t *	cpu_fw_data,
		const size_t	cpu_fw_data_size,
		const uint8_t *	spect_fw_data,
		const size_t	spect_fw_data_size
	)

Note

This helper function follows the recommended FW update process.

This helper function is compatible with all silicon revisions. @important Even if this function fails, the Application FW might still be bootable (at least one of the banks was updated successfully). However, ignoring this is strongly discouraged:

• There is a non-negligible security risk.
• Libtropic was not reinitialized to be compatible with the updated Application FW - some functionalities may not be available or may produce undefined behavior.
• Solution: call this function again and make sure it succeeds. If it continues to fail, refer to our FAQ or contact us via our support portal.

Parameters

h	Handle for communication with TROPIC01
cpu_fw_data	Firmware update data for RISC-V main CPU
cpu_fw_data_size	Size of firmware update data for RISC-V main CPU
spect_fw_data	Firmware update data for SPECT coprocessor
spect_fw_data_size	Size of firmware update data for SPECT coprocessor

Return values

LT_OK	Function executed successfully
other	Function did not execute successully, you might use lt_ret_verbose() to get verbose encoding of returned value