High Speed MultiMedia Card Interface (HSMCI)

This driver interfaces the HSMCI module.

It will add functions for SD/MMC card reading, writing and management.

Modules
	High Speed MultiMedia Card Interface
	(HSMCI) implementation

Functions
bool	hsmci_adtc_start (sdmmc_cmd_def_t cmd, uint32_t arg, uint16_t block_size, uint16_t nb_block, bool access_block)
	Send an ADTC command on the selected slot An ADTC (Addressed Data Transfer Commands) command is used for read/write access. More...
bool	hsmci_adtc_stop (sdmmc_cmd_def_t cmd, uint32_t arg)
	Send a command to stop an ADTC command on the selected slot. More...
void	hsmci_deselect_device (uint8_t slot)
	Deselect a slot. More...
uint8_t	hsmci_get_bus_width (uint8_t slot)
	Return the maximum bus width of a slot. More...
uint32_t	hsmci_get_response (void)
	Return the 32 bits response of the last command. More...
void	hsmci_get_response_128 (uint8_t *response)
	Return the 128 bits response of the last command. More...
void	hsmci_init (void)
	Initializes the low level driver. More...
bool	hsmci_is_high_speed_capable (void)
	Return the high speed capability of the driver. More...
bool	hsmci_read_word (uint32_t *value)
	Read a word on the line. More...
void	hsmci_select_device (uint8_t slot, uint32_t clock, uint8_t bus_width, bool high_speed)
	Select a slot and initialize it. More...
void	hsmci_send_clock (void)
	Send 74 clock cycles on the line of selected slot Note: It is required after card plug and before card install. More...
bool	hsmci_send_cmd (sdmmc_cmd_def_t cmd, uint32_t arg)
	Send a command on the selected slot. More...
bool	hsmci_start_read_blocks (void *dest, uint16_t nb_block)
	Start a read blocks transfer on the line Note: The driver will use the DMA available to speed up the transfer. More...
bool	hsmci_start_write_blocks (const void *src, uint16_t nb_block)
	Start a write blocks transfer on the line Note: The driver will use the DMA available to speed up the transfer. More...
bool	hsmci_wait_end_of_read_blocks (void)
	Wait the end of transfer initiated by mci_start_read_blocks() More...
bool	hsmci_wait_end_of_write_blocks (void)
	Wait the end of transfer initiated by mci_start_write_blocks() More...
bool	hsmci_write_word (uint32_t value)
	Write a word on the line. More...

bool hsmci_adtc_start	(	sdmmc_cmd_def_t	cmd,
		uint32_t	arg,
		uint16_t	block_size,
		uint16_t	nb_block,
		bool	access_block
	)

Send an ADTC command on the selected slot An ADTC (Addressed Data Transfer Commands) command is used for read/write access.

Parameters

cmd	Command definition
arg	Argument of the command
block_size	Block size used for the transfer
nb_block	Total number of block for this transfer
access_block	if true, the x_read_blocks() and x_write_blocks() functions must be used after this function. If false, the mci_read_word() and mci_write_word() functions must be used after this function.

Returns

true if success, otherwise false

References Assert, block_size, hsmci_block_size, hsmci_nb_block, hsmci_send_cmd_execute(), hsmci_transfert_pos, SDMMC_CMD_MULTI_BLOCK, SDMMC_CMD_SDIO_BLOCK, SDMMC_CMD_SDIO_BYTE, SDMMC_CMD_SINGLE_BLOCK, SDMMC_CMD_STREAM, and SDMMC_CMD_WRITE.

bool hsmci_adtc_stop	(	sdmmc_cmd_def_t	cmd,
		uint32_t	arg
	)

Send a command to stop an ADTC command on the selected slot.

Parameters

cmd	Command definition
arg	Argument of the command

Returns

true if success, otherwise false

References hsmci_send_cmd_execute().

void hsmci_deselect_device

(

uint8_t

slot

)

Deselect a slot.

Parameters

slot	Selected slot

References UNUSED.

uint8_t hsmci_get_bus_width

(

uint8_t

slot

)

Return the maximum bus width of a slot.

Parameters

slot	Selected slot

Returns

1, 4 or 8 lines.

References SD_MMC_HSMCI_SLOT_0_SIZE.

uint32_t hsmci_get_response

(

void

)

Return the 32 bits response of the last command.

Returns

32 bits response

void hsmci_get_response_128

(

uint8_t *

response

)

Return the 128 bits response of the last command.

Parameters

response

Pointer on the array to fill with the 128 bits response

void hsmci_init

(

void

)

Initializes the low level driver.

This enable the clock required and the hardware interface.

References pmc_enable_periph_clk().

bool hsmci_is_high_speed_capable

(

void

)

Return the high speed capability of the driver.

Returns

true, if the high speed is supported

bool hsmci_read_word

(

uint32_t *

value

)

Read a word on the line.

Parameters

value

Pointer on a word to fill

Returns

true if success, otherwise false

References Assert, hsmci_block_size, hsmci_debug, hsmci_nb_block, hsmci_reset(), and hsmci_transfert_pos.

void hsmci_select_device	(	uint8_t	slot,
		uint32_t	clock,
		uint8_t	bus_width,
		bool	high_speed
	)

Select a slot and initialize it.

Parameters

slot	Selected slot
clock	Maximum clock to use (Hz)
bus_width	Bus width to use (1, 4 or 8)
high_speed	true, to enable high speed mode

References Assert, hsmci_set_speed(), and sysclk_get_peripheral_hz().

void hsmci_send_clock

(

void

)

Send 74 clock cycles on the line of selected slot Note: It is required after card plug and before card install.

bool hsmci_send_cmd	(	sdmmc_cmd_def_t	cmd,
		uint32_t	arg
	)

Send a command on the selected slot.

Parameters

cmd	Command definition
arg	Argument of the command

Returns

true if success, otherwise false

References hsmci_send_cmd_execute().

bool hsmci_start_read_blocks	(	void *	dest,
		uint16_t	nb_block
	)

Start a read blocks transfer on the line Note: The driver will use the DMA available to speed up the transfer.

Parameters

dest	Pointer on the buffer to fill
nb_block	Number of block to transfer

Returns

true if started, otherwise false

bool hsmci_start_write_blocks	(	const void *	src,
		uint16_t	nb_block
	)

Start a write blocks transfer on the line Note: The driver will use the DMA available to speed up the transfer.

Parameters

src	Pointer on the buffer to send
nb_block	Number of block to transfer

Returns

true if started, otherwise false

bool hsmci_wait_end_of_read_blocks

(

void

)

Wait the end of transfer initiated by mci_start_read_blocks()

Returns

true if success, otherwise false

bool hsmci_wait_end_of_write_blocks

(

void

)

Wait the end of transfer initiated by mci_start_write_blocks()

Returns

true if success, otherwise false

bool hsmci_write_word

(

uint32_t

value

)

Write a word on the line.

Parameters

value

Word to send

Returns

true if success, otherwise false

References Assert, hsmci_block_size, hsmci_debug, hsmci_nb_block, hsmci_reset(), and hsmci_transfert_pos.