Overview

Data Structures
struct	sdmmchost_pwr_card_t
	card power control More...

struct	sdmmchost_t
	sdmmc host handler More...

Macros
#define	FSL_SDMMC_HOST_ADAPTER_VERSION (MAKE_VERSION(2U, 3U, 1U)) /2.3.1/
	Middleware adapter version. More...

#define	SDMMCHOST_SUPPORT_HIGH_SPEED (1U)
	host capability

#define	SDMMCHOST_INSTANCE_SUPPORT_8_BIT_WIDTH(host) 1U
	sdmmc host instance capability

#define	SDMMCHOST_DMA_DESCRIPTOR_BUFFER_ALIGN_SIZE (4U)
	SDMMC host dma descriptor buffer address align size.

#define	SDMMCHOST_RESET_TIMEOUT_VALUE (1000000U)
	SDMMC host reset timoue value.

Typedefs
typedef sdif_transfer_t	sdmmchost_transfer_t
	sdmmc host transfer function

typedef void(*	sdmmchost_pwr_t )(void)
	card power control function pointer

Enumerations
enum	_sdmmchost_endian_mode { kSDMMCHOST_EndianModeBig = 0U, kSDMMCHOST_EndianModeHalfWordBig = 1U, kSDMMCHOST_EndianModeLittle = 2U }
	host Endian mode corresponding to driver define More...

SDIF host controller function
void	SDMMCHOST_SetCardBusWidth (sdmmchost_t *host, uint32_t dataBusWidth)
	set data bus width. More...

static void	SDMMCHOST_SendCardActive (sdmmchost_t *host)
	Send initilization active 80 clocks to card. More...

static uint32_t	SDMMCHOST_SetCardClock (sdmmchost_t *host, uint32_t targetClock)
	Set card bus clock. More...

static bool	SDMMCHOST_IsCardBusy (sdmmchost_t *host)
	check card status by DATA0. More...

status_t	SDMMCHOST_StartBoot (sdmmchost_t host, sdmmchost_boot_config_t hostConfig, sdmmchost_cmd_t cmd, uint8_t buffer)
	start read boot data. More...

status_t	SDMMCHOST_ReadBootData (sdmmchost_t host, sdmmchost_boot_config_t hostConfig, uint8_t *buffer)
	read boot data. More...

static void	SDMMCHOST_EnableBoot (sdmmchost_t *host, bool enable)
	enable boot mode. More...

static void	SDMMCHOST_EnableCardInt (sdmmchost_t *host, bool enable)
	enable card interrupt. More...

status_t	SDMMCHOST_CardIntInit (sdmmchost_t host, void sdioInt)
	card interrupt function. More...

status_t	SDMMCHOST_CardDetectInit (sdmmchost_t host, void cd)
	card detect init function. More...

status_t	SDMMCHOST_PollingCardDetectStatus (sdmmchost_t *host, uint32_t waitCardStatus, uint32_t timeout)
	Detect card insert, only need for SD cases. More...

uint32_t	SDMMCHOST_CardDetectStatus (sdmmchost_t *host)
	card detect status. More...

status_t	SDMMCHOST_Init (sdmmchost_t *host)
	Init host controller. More...

void	SDMMCHOST_Deinit (sdmmchost_t *host)
	Deinit host controller. More...

void	SDMMCHOST_SetCardPower (sdmmchost_t *host, bool enable)
	host power off card function. More...

status_t	SDMMCHOST_TransferFunction (sdmmchost_t host, sdmmchost_transfer_t content)
	host transfer function. More...

void	SDMMCHOST_Reset (sdmmchost_t *host)
	host reset function. More...

status_t	SDMMCHOST_WaitCardDetectStatus (SDMMCHOST_TYPE hostBase, const sdmmchost_detect_card_t cd, bool waitCardStatus)
	wait card detect status More...

void	SDMMCHOST_PowerOffCard (SDMMCHOST_TYPE base, const sdmmchost_pwr_card_t pwr)
	host power off card function. More...

void	SDMMCHOST_PowerOnCard (SDMMCHOST_TYPE base, const sdmmchost_pwr_card_t pwr)
	host power on card function. More...

Data Structure Documentation

struct sdmmchost_pwr_card_t

Deprecated:: Do not use this structure anymore.

Data Fields
sdmmchost_pwr_t	powerOn
	power on function pointer

uint32_t	powerOnDelay_ms
	power on delay

sdmmchost_pwr_t	powerOff
	power off function pointer

uint32_t	powerOffDelay_ms
	power off delay

struct sdmmchost_t

Data Fields
sdif_host_t	hostController
	host configuration

uint8_t	hostPort
	host port number, used for one instance support two card

void *	dmaDesBuffer
	DMA descriptor buffer address.

uint32_t	dmaDesBufferWordsNum
	DMA descriptor buffer size in byte.

sdif_handle_t	handle
	host controller handler

sdmmc_osa_event_t	hostEvent
	host event handler

void *	cd
	card detect

void *	cardInt
	call back function for card interrupt

Macro Definition Documentation

#define FSL_SDMMC_HOST_ADAPTER_VERSION (MAKE_VERSION(2U, 3U, 1U)) /*2.3.1*/

Enumeration Type Documentation

enum _sdmmchost_endian_mode

Enumerator
kSDMMCHOST_EndianModeBig	Big endian mode.
kSDMMCHOST_EndianModeHalfWordBig	Half word big endian mode.
kSDMMCHOST_EndianModeLittle	Little endian mode.

Function Documentation

void SDMMCHOST_SetCardBusWidth	(	sdmmchost_t *	host,
		uint32_t	dataBusWidth
	)

Parameters

host	host handler
dataBusWidth	data bus width

static void SDMMCHOST_SendCardActive ( sdmmchost_t * host )

inlinestatic

Parameters

host	host handler

static uint32_t SDMMCHOST_SetCardClock	(	sdmmchost_t *	host,
		uint32_t	targetClock
	)

inlinestatic

Parameters

host	host handler
targetClock	target clock frequency

Return values

actual clock frequency can be reach.

static bool SDMMCHOST_IsCardBusy ( sdmmchost_t * host )

inlinestatic

Parameters

host	host handler

Return values

true	is busy, false is idle.

status_t SDMMCHOST_StartBoot	(	sdmmchost_t *	host,
		sdmmchost_boot_config_t *	hostConfig,
		sdmmchost_cmd_t *	cmd,
		uint8_t *	buffer
	)

Parameters

host	host handler
hostConfig	boot configuration
cmd	boot command
buffer	buffer address

status_t SDMMCHOST_ReadBootData	(	sdmmchost_t *	host,
		sdmmchost_boot_config_t *	hostConfig,
		uint8_t *	buffer
	)

Parameters

host	host handler
hostConfig	boot configuration
buffer	buffer address

static void SDMMCHOST_EnableBoot	(	sdmmchost_t *	host,
		bool	enable
	)

inlinestatic

Parameters

host	host handler
enable	true is enable, false is disable

static void SDMMCHOST_EnableCardInt	(	sdmmchost_t *	host,
		bool	enable
	)

inlinestatic

Parameters

host	host handler
enable	true is enable, false is disable.

status_t SDMMCHOST_CardIntInit	(	sdmmchost_t *	host,
		void *	sdioInt
	)

Parameters

host	host handler
sdioInt	card interrupt configuration

status_t SDMMCHOST_CardDetectInit	(	sdmmchost_t *	host,
		void *	cd
	)

Parameters

host	host handler
cd	card detect configuration

status_t SDMMCHOST_PollingCardDetectStatus	(	sdmmchost_t *	host,
		uint32_t	waitCardStatus,
		uint32_t	timeout
	)

Parameters

host	host handler
waitCardStatus	status which user want to wait
timeout	wait time out.

Return values

kStatus_Success	detect card insert
kStatus_Fail	card insert event fail

uint32_t SDMMCHOST_CardDetectStatus ( sdmmchost_t * host )

Parameters

host	host handler

Return values

kSD_Inserted,kSD_Removed

status_t SDMMCHOST_Init ( sdmmchost_t * host )

Parameters

host	host handler

Return values

kStatus_Success	host init success
kStatus_Fail	event fail

void SDMMCHOST_Deinit ( sdmmchost_t * host )

Parameters

host	host handler

void SDMMCHOST_SetCardPower	(	sdmmchost_t *	host,
		bool	enable
	)

Parameters

host	host handler
enable	true is power on, false is power down.

status_t SDMMCHOST_TransferFunction	(	sdmmchost_t *	host,
		sdmmchost_transfer_t *	content
	)

Parameters

host	host handler
content	transfer content.

void SDMMCHOST_Reset ( sdmmchost_t * host )

Deprecated:: Do not use this function. Application should not call this function, driver is responsible for the host reset..

Parameters

host	host handler

status_t SDMMCHOST_WaitCardDetectStatus	(	SDMMCHOST_TYPE *	hostBase,
		const sdmmchost_detect_card_t *	cd,
		bool	waitCardStatus
	)

Deprecated:: Do not use this function.It has been superceded by SDMMCHOST_PollingCardDetectStatus..

Parameters

hostBase	host handler
cd	card detect configuration.
waitCardStatus	status to wait.

void SDMMCHOST_PowerOffCard	(	SDMMCHOST_TYPE *	base,
		const sdmmchost_pwr_card_t *	pwr
	)

Deprecated:: Do not use this function.It has been superceded by SDMMCHOST_SetCardPower..

Parameters

base	host base address.
pwr	depend on user define power configuration.

void SDMMCHOST_PowerOnCard	(	SDMMCHOST_TYPE *	base,
		const sdmmchost_pwr_card_t *	pwr
	)

Deprecated:: Do not use this function.It has been superceded by SDMMCHOST_SetCardPower..

Parameters

base	host base address.
pwr	depend on user define power configuration.

Overview

Data Structures

Macros

Typedefs

Enumerations

SDIF host controller function

Data Structure Documentation

Data Fields

Data Fields

Macro Definition Documentation

Enumeration Type Documentation

Function Documentation