Ftftx CACHE Driver

Overview

Data Structures
struct	ftfx_prefetch_speculation_status_t
	FTFx prefetch speculation status. More...
struct	ftfx_cache_config_t
	FTFx cache driver state information. More...

Enumerations
enum	_ftfx_cache_ram_func_constants { kFTFx_CACHE_RamFuncMaxSizeInWords = 16U }
	Constants for execute-in-RAM flash function. More...

Functions
status_t	FTFx_CACHE_Init (ftfx_cache_config_t *config)
	Initializes the global FTFx cache structure members. More...
status_t	FTFx_CACHE_ClearCachePrefetchSpeculation (ftfx_cache_config_t *config, bool isPreProcess)
	Process the cache/prefetch/speculation to the flash. More...
status_t	FTFx_CACHE_PflashSetPrefetchSpeculation (ftfx_prefetch_speculation_status_t *speculationStatus)
	Sets the PFlash prefetch speculation to the intended speculation status. More...
status_t	FTFx_CACHE_PflashGetPrefetchSpeculation (ftfx_prefetch_speculation_status_t *speculationStatus)
	Gets the PFlash prefetch speculation status. More...

FTFx cache version
#define	FSL_FTFX_CACHE_DRIVER_VERSION   (MAKE_VERSION(3, 0, 0))
	Flexnvm driver version for SDK. More...

---

Data Structure Documentation

struct ftfx_prefetch_speculation_status_t

Data Fields
bool	instructionOff
	Instruction speculation. More...
bool	dataOff
	Data speculation. More...

Field Documentation

bool ftfx_prefetch_speculation_status_t::instructionOff

bool ftfx_prefetch_speculation_status_t::dataOff

struct ftfx_cache_config_t

An instance of this structure is allocated by the user of the flash driver and passed into each of the driver APIs.

Data Fields
uint8_t	flashMemoryIndex
	0 - primary flash; 1 - secondary flash
uint32_t *	comBitOperFuncAddr
	An buffer point to the flash execute-in-RAM function. More...

Field Documentation

uint32_t* ftfx_cache_config_t::comBitOperFuncAddr

Macro Definition Documentation

#define FSL_FTFX_CACHE_DRIVER_VERSION   (MAKE_VERSION(3, 0, 0))

Version 1.0.0.

Enumeration Type Documentation

enum _ftfx_cache_ram_func_constants

Enumerator
kFTFx_CACHE_RamFuncMaxSizeInWords	The maximum size of execute-in-RAM function.

Function Documentation

status_t FTFx_CACHE_Init

(

ftfx_cache_config_t *

config

)

This function checks and initializes the Flash module for the other FTFx cache APIs.

Parameters

config

Pointer to the storage for the driver runtime state.

Return values

kStatus_FTFx_Success	API was executed successfully.
kStatus_FTFx_InvalidArgument	An invalid argument is provided.
kStatus_FTFx_ExecuteInRamFunctionNotReady	Execute-in-RAM function is not available.

status_t FTFx_CACHE_ClearCachePrefetchSpeculation	(	ftfx_cache_config_t *	config,
		bool	isPreProcess
	)

Parameters

config	A pointer to the storage for the driver runtime state.
process	The possible option used to control flash cache/prefetch/speculation

Return values

kStatus_FTFx_Success	API was executed successfully.
kStatus_FTFx_InvalidArgument	Invalid argument is provided.
kStatus_FTFx_ExecuteInRamFunctionNotReady	Execute-in-RAM function is not available.

status_t FTFx_CACHE_PflashSetPrefetchSpeculation

(

ftfx_prefetch_speculation_status_t *

speculationStatus

)

Parameters

speculationStatus

The expected protect status to set to the PFlash protection register. Each bit is

Return values

kStatus_FTFx_Success	API was executed successfully.
kStatus_FTFx_InvalidSpeculationOption	An invalid speculation option argument is provided.

status_t FTFx_CACHE_PflashGetPrefetchSpeculation

(

ftfx_prefetch_speculation_status_t *

speculationStatus

)

Parameters

speculationStatus

Speculation status returned by the PFlash IP.

Return values

kStatus_FTFx_Success

API was executed successfully.