CC3X00 Simplelink OTA Extlib API User's Guide: Flc

Abort a file update.

Parameters

[in]

fileHandle

Pointer to the file (assigned from sl_FsOpen)

Abort a file update by closing the file with signature 'A', rolling back to the old file (mirror).

Returns

Returns 0 on success or negative error number.

Close a previously opened file.

Parameters

[in]	fileHandle	File Handle to previously opned file.
[in]	pCeritificateFileName	Reserved for future use. Use NULL.
[in]	pSignature	Reserved for future use. Use NULL.
[in]	SignatureLen	Reserved for future use. Use 0.

Returns

Returns 0 on success or negative error number.

Commits the newly downloaded images (MCU and NWP)

Parameters

[in]

CommitFlag

Commit flag

This function Commits the newly downloaded images for MCU and NWP. After downloading new images, the system is booted in test mode with newly downloaded images. The image(s) should self test and call this function with appropriate CommitFlag to commit or reject the update.

The parameter CommitFlag can be one of the following: \

FLC_COMMITED
FLC_NOT_COMMITED

Returns

Bitmap of reset recommendation to the host: FLC_TEST_RESET_MCU or FLC_TEST_RESET_NWP

See also

Note

Warning

Example:

For example: commit after success NWP start

status = slAccess_start_and_connect(OPEN_LINK_SSID);

if( 0 > status )

{

status = sl_extlib_FlcCommit(FLC_NOT_COMMITED);

if (status == FLC_TEST_RESET_MCU)

{

Report("main: Rebooting...");

Platform_Reset();

}

}

status = sl_extlib_FlcCommit(FLC_COMMITED);

if (status == FLC_TEST_RESET_MCU)

{

Report("main: Rebooting...");

Platform_Reset();

}

Check on bootloader flags if the state is IMG_STATUS_TESTING.

Returns

TRUE/FLASE

Open file for write.

Parameters

[in]	file_name	File name
[in]	file_size	Max size to be allocated for this file
[in]	ulToken	Reserved for future use. Use NULL
[out]	lFileHandle	File handle
[in]	open_flags	File open flags

Opens a file for write. In case of OTA MCU (mcuimgA.bin), this function takes care of renaming it to alternate image (mcuimg2.bin or mcuimg3.bin ) name base on the boot info file.

See SL_HOST sl_FsOpen documentation for more details on flags

Returns

Returns 0 on success, negative error number otherwise.

Read specified number of bytes from a file.

Parameters

[in]	fileHandle	Handle to file opened for reading
[in]	offset	Offset to specific block to be read
[in]	buf	Pointer the data to be read
[in]	len	Length of the data in bytes

This function reads len bytes into buf from the file specified by the` fileHandle.

Returns

Returns the number of bytes read or negative error number.

Set the system to boot in test mode for new downloaded images.

Parameters

[in]

flags

Test flags

This function sets the system to boot in test mode during next boot. The parameter flags can be logical OR of one or more of the following: FLC_TEST_RESET_MCU - There is a new image for testing require a restart FLC_TEST_RESET_MCU_WITH_APP - There is a new MCU for testing. FLC_TEST_RESET_NWP - There is a new NWP for testing.

Use FLC_TEST_RESET_MCU when there is a new image/file but no update to MCU application image is required, use FLC_TEST_RESET_MCU_WITH_APP otherwise.

Returns

Bitmap of reset recommendation to the host: FLC_TEST_RESET_MCU or FLC_TEST_RESET_NWP

See also

Note

Warning

Example:

For example: test images after OTA download done

status = sl_extLib_OtaRun(pvOtaApp);

if ((status & RUN_STAT_DOWNLOAD_DONE))

{

if (status & RUN_STAT_DOWNLOAD_DONE_RESET_MCU) ImageTestFlags |= FLC_TEST_RESET_MCU;

if (status & RUN_STAT_DOWNLOAD_DONE_RESET_MCU) ImageTestFlags |= FLC_TEST_RESET_NWP;

status = sl_extlib_FlcTest(ImageTestFlags);

if (status & FLC_TEST_RESET_MCU)

{

Report("proc_ota_run_step: Rebooting...");

Platform_Reset();

}

if (status & FLC_TEST_RESET_NWP)

{

Report("\nproc_ota_run_step: reset the NWP to test the new image ---\n");

status = slAccess_stop_start(OPEN_LINK_SSID);

}

}

Write specified number of bytes to a file.

Parameters

[in]	fileHandle	Handle to file opened for reading
[in]	offset	Offset to specific block to be read
[in]	buf	Pointer the data to be written
[in]	len	Length of the data in bytes

This function writes len bytes from buf to the file specified by the` fileHandle.

Returns

Returns the number of bytes written or negative error number.