Introduction

These APIs try to communicate with whichever flash is connected the OSPI peripheral in 1-1-1 mode. This can be used in bringing up new flashes and mostly used for debug and diagnostic purposes

Functions
int32_t	OSPI_norFlashInit1s1s1s (OSPI_Handle handle)
	This function initializes the NOR flash to work in 1-1-1 mode. More...

void	OSPI_norFlashSetCmds (uint8_t rdCmd, uint8_t wrCmd, uint8_t eraseCmd)
	This function sets up internal bookkeeping variables for read, write and erase commands. This API has to be called immediately before OSPI_norFlashInit1s1s1s. More...

int32_t	OSPI_norFlashReadId (OSPI_Handle handle, uint32_t manufacturerId, uint32_t deviceId)
	This function tries to read the JEDEC ID from the NOR flash connected to the OSPI peripheral. More...

int32_t	OSPI_norFlashWrite (OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len)
	This function writes data to the flash at a specified offset. More...

int32_t	OSPI_norFlashRead (OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len)
	This function reads data from the flash from a specified offset. More...

int32_t	OSPI_norFlashReadSfdp (OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len)
	This function reads SFDP table from the flash from a specified offset. More...

int32_t	OSPI_norFlashErase (OSPI_Handle handle, uint32_t address)
	This function erases 1 block of data starting from a provided address. More...

int32_t	OSPI_configResetPin (OSPI_Handle handle, uint32_t config)
	This function configures reset functionality. More...

int32_t	OSPI_configBaudrate (OSPI_Handle handle, uint32_t baud)
	Configures baud divider. More...

int32_t	OSPI_readBaudRateDivFromReg (OSPI_Handle handle, uint32_t *baudDiv)
	Return value of baudrate that is programmed in IP register. More...

int32_t	OSPI_getBaudRateDivFromObj (OSPI_Handle handle, uint32_t *baudDiv)
	Return value of baudrate that is saved in OSPI Object. More...

Function Documentation

◆ OSPI_norFlashInit1s1s1s()

int32_t OSPI_norFlashInit1s1s1s ( OSPI_Handle handle )

This function initializes the NOR flash to work in 1-1-1 mode.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle An OSPI_Handle returned from an OSPI_open()

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_norFlashSetCmds()

void OSPI_norFlashSetCmds	(	uint8_t	rdCmd,
		uint8_t	wrCmd,
		uint8_t	eraseCmd
	)

This function sets up internal bookkeeping variables for read, write and erase commands. This API has to be called immediately before OSPI_norFlashInit1s1s1s.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

rdCmd	Command to be used in single mode read
wrCmd	Command to be used in single mode write/page program
eraseCmd	Command to be used to erase (block or sector)

◆ OSPI_norFlashReadId()

int32_t OSPI_norFlashReadId	(	OSPI_Handle	handle,
		uint32_t *	manufacturerId,
		uint32_t *	deviceId
	)

This function tries to read the JEDEC ID from the NOR flash connected to the OSPI peripheral.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
manufacturerId	Pointer to a uint32_t variable. This will be filled with the manufacturer ID on success
deviceId	Pointer to a uint32_t variable. This will be filled with the device ID on success

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_norFlashWrite()

int32_t OSPI_norFlashWrite	(	OSPI_Handle	handle,
		uint32_t	offset,
		uint8_t *	buf,
		uint32_t	len
	)

This function writes data to the flash at a specified offset.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
offset	Offset at which the data is to be written
buf	Buffer which has the data to be written to the flash
len	Number of bytes to be written to the flash

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_norFlashRead()

int32_t OSPI_norFlashRead	(	OSPI_Handle	handle,
		uint32_t	offset,
		uint8_t *	buf,
		uint32_t	len
	)

This function reads data from the flash from a specified offset.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
offset	Offset at which the data is to be read from
buf	Buffer to which data will be written into
len	Number of bytes to be read from the flash

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_norFlashReadSfdp()

int32_t OSPI_norFlashReadSfdp	(	OSPI_Handle	handle,
		uint32_t	offset,
		uint8_t *	buf,
		uint32_t	len
	)

This function reads SFDP table from the flash from a specified offset.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
offset	Offset at which the data is to be read from
buf	Buffer to which data will be written into
len	Number of bytes to be read from the flash

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_norFlashErase()

int32_t OSPI_norFlashErase	(	OSPI_Handle	handle,
		uint32_t	address
	)

This function erases 1 block of data starting from a provided address.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
address	Address of the data block to be erased. This address should be block aligned.

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_configResetPin()

int32_t OSPI_configResetPin	(	OSPI_Handle	handle,
		uint32_t	config
	)

This function configures reset functionality.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
config	reset config

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_configBaudrate()

int32_t OSPI_configBaudrate	(	OSPI_Handle	handle,
		uint32_t	baud
	)

Configures baud divider.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
baud	baudrate from 2 to 32 and divisible by 2

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_readBaudRateDivFromReg()

int32_t OSPI_readBaudRateDivFromReg	(	OSPI_Handle	handle,
		uint32_t *	baudDiv
	)

Return value of baudrate that is programmed in IP register.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
baudDiv	pointer to memory into which baudrate will be written

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

◆ OSPI_getBaudRateDivFromObj()

int32_t OSPI_getBaudRateDivFromObj	(	OSPI_Handle	handle,
		uint32_t *	baudDiv
	)

Return value of baudrate that is saved in OSPI Object.

Precondition: OSPI controller has been opened using OSPI_open()

Parameters

handle	An OSPI_Handle returned from an OSPI_open()
baudDiv	pointer to memory into which baudrate will be written

Returns: SystemP_SUCCESS on success, SystemP_FAILURE otherwise

Introduction

Functions

Function Documentation

◆ OSPI_norFlashInit1s1s1s()

◆ OSPI_norFlashSetCmds()

◆ OSPI_norFlashReadId()

◆ OSPI_norFlashWrite()

◆ OSPI_norFlashRead()

◆ OSPI_norFlashReadSfdp()

◆ OSPI_norFlashErase()

◆ OSPI_configResetPin()

◆ OSPI_configBaudrate()

◆ OSPI_readBaudRateDivFromReg()

◆ OSPI_getBaudRateDivFromObj()