FSS

Table of Contents

• Usage of FSS driver
• Example Usage
  • Configuring FSS for Bootseg peripheral
  • Configuring FSS for ECCM
• API

Usage of FSS driver

FSS driver is used to configure bootseg IP and ECCM IP.

Bootseg IP is used to perform A/B swap in Firmware-Update-Over-The-Air (FOTA) application. Please refer to Technical Resource Manual of the deivce for more details of this IP.

ECCM is on-the-fly-Ecc module which perform ECC check on the fly which makes XIP from external flash secure. Please refer to Technical Resource Manual of the deivce for more details of this IP.

Example Usage

Configuring FSS for Bootseg peripheral

Includes the following files

#include <drivers/fss.h>
#include <drivers/hw_include/cslr_fss.h>

Initilize the following struct

    FSS_Config fssConf;
    /* IP base addrress is defined in the CSL files */
    fssConf.ipBaseAddress = CSL_MSS_CTRL_U_BASE;
    /* Assume that size of external flash is 32MB */
    fssConf.extFlashSize = 32 * 1024 * 1024;;

Note that, ipBaseAddress address is in CSLR file.

To remap 2nd half of flash to 1st half of the flash (or boot from 2nd half of flash.)

    DebugP_assert(FSS_selectRegionB(&fssConf) == SystemP_SUCCESS);

To boot from 1st half of flash,

    DebugP_assert(FSS_selectRegionA(&fssConf) == SystemP_SUCCESS);

Somtimes, it is requried to find from which part of flash, application boots from. Following code snippet shows that:

    uint32_t bootRegion = FSS_getBootRegion(&fssConf);
    if(1U == bootRegion)
    {
        DebugP_log("Booting from 2nd half of flash (or B region).");
    }
    else
    {
        DebugP_log("Booting from 1st half of flash (or A region).");
    }

Configuring FSS for ECCM

    FSS_ECCRegionConfig region;
    /*
        ECCM IP can config 4 regions. Index is to indicate
        for which region this config is for.
    */
    region.regionIndex = 0;
    region.size = 1 * 1024 * 1024;
    region.startAddress = 16 * 1024;
    /* disable ECC initially */
    FSS_disableECC();
    FSS_configECCMRegion(&region);
    FSS_enableECC();

make sure to disable ECC before configuring it.

API

APIs for FSS