Modules
	Compiler abstraction layer and code utilities
	Compiler abstraction layer and code utilities for AT91SAM.

	Preprocessor - Token Paste

	Preprocessor - Stringize

	Preprocessor - Macro Repeat

	Test Suite Framework
	This module is the test suite framework, which provides a set of standard functions and macros for defining and running test suites.

Data Structures
struct	sd_mmc_card
	SD/MMC card information structure. More...

Files
file	compiler.h
	Commonly used includes, types and macros.

file	parts.h
	Atmel part identification macros.

file	parts.h
	Atmel part identification macros.

file	pmc.h
	Power Management Controller (PMC) driver for SAM.

file	suite.h
	Test suite core declarations.

file	tpaste.h
	Preprocessor token pasting utils.

Macros
#define	driver hsmci

#define	driver_adtc_start ATPASTE2(driver, _adtc_start)

#define	driver_adtc_stop ATPASTE2(driver, _send_cmd)

#define	driver_deselect_device ATPASTE2(driver, _deselect_device)

#define	driver_get_bus_width ATPASTE2(driver, _get_bus_width)

#define	driver_get_response ATPASTE2(driver, _get_response)

#define	driver_get_response_128 ATPASTE2(driver, _get_response_128)

#define	driver_init ATPASTE2(driver, _init)

#define	driver_is_high_speed_capable ATPASTE2(driver, _is_high_speed_capable)

#define	driver_read_word ATPASTE2(driver, _read_word)

#define	driver_select_device ATPASTE2(driver, _select_device)

#define	driver_send_clock ATPASTE2(driver, _send_clock)

#define	driver_send_cmd ATPASTE2(driver, _send_cmd)

#define	driver_start_read_blocks ATPASTE2(driver, _start_read_blocks)

#define	driver_start_write_blocks ATPASTE2(driver, _start_write_blocks)

#define	driver_wait_end_of_read_blocks ATPASTE2(driver, _wait_end_of_read_blocks)

#define	driver_wait_end_of_write_blocks ATPASTE2(driver, _wait_end_of_write_blocks)

#define	driver_write_word ATPASTE2(driver, _write_word)

#define	IS_SDIO() (sd_mmc_card->type & CARD_TYPE_SDIO)

#define	sd_mmc_debug(...)

#define	sd_mmc_is_mci() (!sd_mmc_is_spi())

#define	sd_mmc_is_spi() false

#define	SD_MMC_MCI_MEM_CNT 0

#define	SD_MMC_MEM_CNT SD_MMC_HSMCI_MEM_CNT

#define	SD_MMC_SPI_MEM_CNT 0

#define	SD_MMC_VOLTAGE_SUPPORT
	This SD MMC stack supports only the high voltage. More...

Enumerations
enum	card_state { SD_MMC_CARD_STATE_READY = 0, SD_MMC_CARD_STATE_DEBOUNCE = 1, SD_MMC_CARD_STATE_INIT = 2, SD_MMC_CARD_STATE_UNUSABLE = 3, SD_MMC_CARD_STATE_NO_CARD = 4 }
	SD/MMC card states. More...

Variables
uint8_t	sd_mmc_card::bus_width
	Number of DATA lin on bus (MCI only) More...

uint32_t	sd_mmc_card::capacity
	Card capacity in KBytes. More...

uint32_t	sd_mmc_card::cd_gpio
	Card detect GPIO. More...

uint32_t	sd_mmc_card::clock
	Card access clock. More...

uint8_t	sd_mmc_card::csd [CSD_REG_BSIZE]
	CSD register. More...

uint8_t	sd_mmc_card::high_speed
	High speed card (1) More...

const uint32_t	mmc_trans_multipliers [16]
	MMC transfer multiplier factor codes (1/10) list. More...

uint16_t	sd_mmc_card::rca
	Relative card address. More...

static struct sd_mmc_card *	sd_mmc_card
	Pointer on current slot configurated. More...

static struct sd_mmc_card	sd_mmc_cards [SD_MMC_MEM_CNT]
	SD/MMC card list Note: Initialize card detect pin fields if present. More...

static uint16_t	sd_mmc_nb_block_remaining = 0
	Number of block remaining to read or write on the current transfer. More...

static uint16_t	sd_mmc_nb_block_to_tranfer = 0
	Number of block to read or write on the current transfer. More...

static uint8_t	sd_mmc_slot_sel
	Index of current slot configurated. More...

const uint32_t	sd_mmc_trans_units [7]
	SD/MMC transfer rate unit codes (10K) list. More...

const uint32_t	sd_trans_multipliers [16]
	SD transfer multiplier factor codes (1/10) list. More...

enum card_state	sd_mmc_card::state
	Card state. More...

card_type_t	sd_mmc_card::type
	Card type. More...

card_version_t	sd_mmc_card::version
	Card version. More...

MMC, SD and SDIO commands process
static bool	mmc_spi_op_cond (void)
	Sends operation condition command and read OCR (SPI only) More...

static bool	mmc_mci_op_cond (void)
	Sends operation condition command and read OCR (MCI only) More...

static bool	sd_spi_op_cond (uint8_t v2)
	Ask to all cards to send their operations conditions (SPI only). More...

static bool	sd_mci_op_cond (uint8_t v2)
	Ask to all cards to send their operations conditions (MCI only). More...

static bool	sdio_op_cond (void)
	Try to get the SDIO card's operating condition. More...

static bool	sdio_get_max_speed (void)
	Get SDIO max transfer speed in Hz. More...

static bool	sdio_cmd52_set_bus_width (void)
	CMD52 for SDIO - Switches the bus width mode to 4. More...

static bool	sdio_cmd52_set_high_speed (void)
	CMD52 for SDIO - Enable the high speed mode. More...

static bool	sd_cm6_set_high_speed (void)
	CMD6 for SD - Switch card in high speed mode. More...

static bool	mmc_cmd6_set_bus_width (uint8_t bus_width)
	CMD6 for MMC - Switches the bus width mode. More...

static bool	mmc_cmd6_set_high_speed (void)
	CMD6 for MMC - Switches in high speed mode. More...

static bool	sd_cmd8 (uint8_t *v2)
	CMD8 for SD card - Send Interface Condition Command. More...

static bool	mmc_cmd8 (uint8_t *b_authorize_high_speed)
	CMD8 - The card sends its EXT_CSD register as a block of data. More...

static bool	sd_mmc_cmd9_spi (void)
	CMD9: Addressed card sends its card-specific data (CSD) on the CMD line spi. More...

static bool	sd_mmc_cmd9_mci (void)
	CMD9: Addressed card sends its card-specific data (CSD) on the CMD line mci. More...

static void	mmc_decode_csd (void)
	Decodes MMC CSD register. More...

static void	sd_decode_csd (void)
	Decodes SD CSD register. More...

static bool	sd_mmc_cmd13 (void)
	CMD13 - Addressed card sends its status register. More...

static bool	sdio_cmd52 (uint8_t rw_flag, uint8_t func_nb, uint32_t reg_addr, uint8_t rd_after_wr, uint8_t *io_data)
	CMD52 - SDIO IO_RW_DIRECT command. More...

static bool	sdio_cmd53 (uint8_t rw_flag, uint8_t func_nb, uint32_t reg_addr, uint8_t inc_addr, uint32_t size, bool access_block)
	CMD53 - SDIO IO_RW_EXTENDED command This implementation support only the SDIO multi-byte transfer mode which is similar to the single block transfer on memory. More...

static bool	sd_acmd6 (void)
	ACMD6 - Define the data bus width to 4 bits bus. More...

static bool	sd_acmd51 (void)
	ACMD51 - Read the SD Configuration Register. More...

Internal function to process the initialization and install
static sd_mmc_err_t	sd_mmc_select_slot (uint8_t slot)
	Select a card slot and initialize the associated driver. More...

static void	sd_mmc_configure_slot (void)
	Configures the driver with the selected card configuration. More...

static void	sd_mmc_deselect_slot (void)
	Deselect the current card slot. More...

static bool	sd_mmc_spi_card_init (void)
	Initialize the SD card in SPI mode. More...

static bool	sd_mmc_mci_card_init (void)
	Initialize the SD card in MCI mode. More...

static bool	sd_mmc_spi_install_mmc (void)
	Initialize the MMC card in SPI mode. More...

static bool	sd_mmc_mci_install_mmc (void)
	Initialize the MMC card in MCI mode. More...

Internal functions to manage a large timeout after a card insertion
static t_cpu_time	timer

static bool	sd_mmc_sam_systick_used

#define	SD_MMC_START_TIMEOUT() delay_ms(SD_MMC_DEBOUNCE_TIMEOUT)

#define	SD_MMC_IS_TIMEOUT() true

#define	SD_MMC_STOP_TIMEOUT()

#define	SD_MMC_DEBOUNCE_TIMEOUT 1000

#define	SD_MMC_START_TIMEOUT() cpu_set_timeout(cpu_ms_2_cy(SD_MMC_DEBOUNCE_TIMEOUT, sysclk_get_cpu_hz()), &timer)

#define	SD_MMC_IS_TIMEOUT() cpu_is_timeout(&timer)

#define	SD_MMC_STOP_TIMEOUT()

#define driver hsmci

#define driver_adtc_start ATPASTE2(driver, _adtc_start)

Referenced by mmc_cmd8(), sd_acmd51(), sd_cm6_set_high_speed(), sd_mmc_cmd9_spi(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), and sdio_cmd53().

#define driver_adtc_stop ATPASTE2(driver, _send_cmd)

Referenced by sd_mmc_wait_end_of_read_blocks(), and sd_mmc_wait_end_of_write_blocks().

#define driver_deselect_device ATPASTE2(driver, _deselect_device)

Referenced by sd_mmc_deselect_slot().

#define driver_get_bus_width ATPASTE2(driver, _get_bus_width)

Referenced by sd_mmc_mci_card_init(), and sd_mmc_mci_install_mmc().

#define driver_get_response ATPASTE2(driver, _get_response)

Referenced by mmc_cmd6_set_bus_width(), mmc_cmd6_set_high_speed(), mmc_mci_op_cond(), mmc_spi_op_cond(), sd_cm6_set_high_speed(), sd_cmd8(), sd_mci_op_cond(), sd_mmc_cmd13(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_mci_card_init(), sd_spi_op_cond(), sdio_cmd52(), and sdio_op_cond().

#define driver_get_response_128 ATPASTE2(driver, _get_response_128)

Referenced by sd_mmc_cmd9_mci().

#define driver_init ATPASTE2(driver, _init)

#define driver_is_high_speed_capable ATPASTE2(driver, _is_high_speed_capable)

Referenced by sd_mmc_mci_card_init(), and sd_mmc_mci_install_mmc().

#define driver_read_word ATPASTE2(driver, _read_word)

Referenced by mmc_cmd8().

#define driver_select_device ATPASTE2(driver, _select_device)

Referenced by sd_mmc_configure_slot().

#define driver_send_clock ATPASTE2(driver, _send_clock)

Referenced by sd_cm6_set_high_speed(), sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

#define driver_send_cmd ATPASTE2(driver, _send_cmd)

Referenced by mmc_cmd6_set_bus_width(), mmc_cmd6_set_high_speed(), mmc_mci_op_cond(), mmc_spi_op_cond(), sd_acmd51(), sd_acmd6(), sd_cmd8(), sd_mci_op_cond(), sd_mmc_cmd13(), sd_mmc_cmd9_mci(), sd_mmc_mci_card_init(), sd_mmc_mci_install_mmc(), sd_mmc_spi_card_init(), sd_mmc_spi_install_mmc(), sd_spi_op_cond(), sdio_cmd52(), and sdio_op_cond().

#define driver_start_read_blocks ATPASTE2(driver, _start_read_blocks)

Referenced by sd_acmd51(), sd_cm6_set_high_speed(), sd_mmc_cmd9_spi(), sd_mmc_start_read_blocks(), and sdio_read_extended().

#define driver_start_write_blocks ATPASTE2(driver, _start_write_blocks)

Referenced by sd_mmc_start_write_blocks(), and sdio_write_extended().

#define driver_wait_end_of_read_blocks ATPASTE2(driver, _wait_end_of_read_blocks)

Referenced by sd_acmd51(), sd_cm6_set_high_speed(), sd_mmc_cmd9_spi(), sd_mmc_wait_end_of_read_blocks(), and sdio_read_extended().

#define driver_wait_end_of_write_blocks ATPASTE2(driver, _wait_end_of_write_blocks)

Referenced by sd_mmc_wait_end_of_write_blocks(), and sdio_write_extended().

#define driver_write_word ATPASTE2(driver, _write_word)

#define IS_SDIO ( ) (sd_mmc_card->type & CARD_TYPE_SDIO)

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

#define SD_MMC_DEBOUNCE_TIMEOUT 1000

#define sd_mmc_debug ( ... )

Referenced by mmc_cmd6_set_bus_width(), mmc_cmd6_set_high_speed(), mmc_mci_op_cond(), mmc_spi_op_cond(), sd_acmd6(), sd_cm6_set_high_speed(), sd_cmd8(), sd_mci_op_cond(), sd_mmc_check(), sd_mmc_cmd13(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_mci_card_init(), sd_mmc_spi_card_init(), sd_spi_op_cond(), sdio_cmd52_set_bus_width(), and sdio_op_cond().

#define sd_mmc_is_mci ( ) (!sd_mmc_is_spi())

Referenced by sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), and sd_mmc_wait_end_of_write_blocks().

#define sd_mmc_is_spi ( ) false

Referenced by sd_mmc_check(), and sd_mmc_cmd13().

static bool SD_MMC_IS_TIMEOUT ( void ) true

inline

Referenced by sd_mmc_select_slot().

#define SD_MMC_IS_TIMEOUT ( ) cpu_is_timeout(&timer)

#define SD_MMC_MCI_MEM_CNT 0

#define SD_MMC_MEM_CNT SD_MMC_HSMCI_MEM_CNT

Referenced by sd_mmc_deselect_slot(), sd_mmc_nb_slot(), and sd_mmc_select_slot().

#define SD_MMC_SPI_MEM_CNT 0

static void SD_MMC_START_TIMEOUT ( void ) delay_ms(SD_MMC_DEBOUNCE_TIMEOUT)

inline

Referenced by sd_mmc_select_slot().

#define SD_MMC_START_TIMEOUT ( ) cpu_set_timeout(cpu_ms_2_cy(SD_MMC_DEBOUNCE_TIMEOUT, sysclk_get_cpu_hz()), &timer)

static void SD_MMC_STOP_TIMEOUT ( void )

inline

Referenced by sd_mmc_select_slot().

#define SD_MMC_STOP_TIMEOUT ( )

#define SD_MMC_VOLTAGE_SUPPORT

Value:

(OCR_VDD_27_28 | OCR_VDD_28_29 | \
		OCR_VDD_29_30 | OCR_VDD_30_31 | \
		OCR_VDD_31_32 | OCR_VDD_32_33)

This SD MMC stack supports only the high voltage.

Referenced by mmc_mci_op_cond(), sd_mci_op_cond(), and sdio_op_cond().

enum card_state

SD/MMC card states.

Enumerator
SD_MMC_CARD_STATE_READY	Ready to use.
SD_MMC_CARD_STATE_DEBOUNCE	Debounce on going.
SD_MMC_CARD_STATE_INIT	Initialization on going.
SD_MMC_CARD_STATE_UNUSABLE	Unusable card.
SD_MMC_CARD_STATE_NO_CARD	No SD/MMC card inserted.

static bool mmc_cmd6_set_bus_width ( uint8_t bus_width )

static

CMD6 for MMC - Switches the bus width mode.

Note: CMD6 is valid under the "trans" state.; sd_mmc_card->bus_width is updated.

Parameters

bus_width Bus width to set

Returns: true if success, otherwise false

References sd_mmc_card::bus_width, CARD_STATUS_SWITCH_ERROR, driver_get_response, driver_send_cmd, MMC_CMD6_ACCESS_SET_BITS, MMC_CMD6_INDEX_BUS_WIDTH, MMC_CMD6_SWITCH, MMC_CMD6_VALUE_BUS_WIDTH_1BIT, MMC_CMD6_VALUE_BUS_WIDTH_4BIT, MMC_CMD6_VALUE_BUS_WIDTH_8BIT, and sd_mmc_debug.

Referenced by sd_mmc_mci_install_mmc().

static bool mmc_cmd6_set_high_speed ( void )

static

CMD6 for MMC - Switches in high speed mode.

Note: CMD6 is valid under the "trans" state.; sd_mmc_card->high_speed is updated.; sd_mmc_card->clock is updated.

Returns: true if success, otherwise false

References CARD_STATUS_SWITCH_ERROR, sd_mmc_card::clock, driver_get_response, driver_send_cmd, sd_mmc_card::high_speed, MMC_CMD6_ACCESS_WRITE_BYTE, MMC_CMD6_INDEX_HS_TIMING, MMC_CMD6_SWITCH, MMC_CMD6_VALUE_HS_TIMING_ENABLE, and sd_mmc_debug.

Referenced by sd_mmc_mci_install_mmc().

static bool mmc_cmd8 ( uint8_t * b_authorize_high_speed )

static

CMD8 - The card sends its EXT_CSD register as a block of data.

Parameters

b_authorize_high_speed Pointer to update with the high speed support information

Returns: true if success, otherwise false

References sd_mmc_card::capacity, sd_mmc_card::csd, driver_adtc_start, driver_read_word, EXT_CSD_BSIZE, EXT_CSD_CARD_TYPE_INDEX, EXT_CSD_SEC_COUNT_INDEX, MMC_CMD8_SEND_EXT_CSD, MMC_CSD_C_SIZE, and MMC_CTYPE_52MHZ.

Referenced by sd_mmc_mci_install_mmc(), and sd_mmc_spi_install_mmc().

static void mmc_decode_csd ( void )

static

Decodes MMC CSD register.

References sd_mmc_card::capacity, CARD_VER_MMC_1_2, CARD_VER_MMC_1_4, CARD_VER_MMC_2_2, CARD_VER_MMC_3, CARD_VER_MMC_4, sd_mmc_card::clock, sd_mmc_card::csd, CSD_TRAN_SPEED, MMC_CSD_C_SIZE, MMC_CSD_C_SIZE_MULT, MMC_CSD_READ_BL_LEN, MMC_CSD_SPEC_VERS, mmc_trans_multipliers, sd_mmc_trans_units, and sd_mmc_card::version.

Referenced by sd_mmc_mci_install_mmc(), and sd_mmc_spi_install_mmc().

static bool mmc_mci_op_cond ( void )

static

Sends operation condition command and read OCR (MCI only)

CMD1 sends operation condition command
CMD1 reads OCR

Returns: true if success, otherwise false

References CARD_TYPE_HC, driver_get_response, driver_send_cmd, MMC_MCI_CMD1_SEND_OP_COND, OCR_ACCESS_MODE_MASK, OCR_ACCESS_MODE_SECTOR, OCR_POWER_UP_BUSY, sd_mmc_debug, SD_MMC_VOLTAGE_SUPPORT, and sd_mmc_card::type.

Referenced by sd_mmc_mci_install_mmc().

static bool mmc_spi_op_cond ( void )

static

Sends operation condition command and read OCR (SPI only)

CMD1 sends operation condition command
CMD58 reads OCR

Returns: true if success, otherwise false

References CARD_TYPE_HC, driver_get_response, driver_send_cmd, MMC_SPI_CMD1_SEND_OP_COND, OCR_ACCESS_MODE_MASK, OCR_ACCESS_MODE_SECTOR, R1_SPI_IDLE, sd_mmc_debug, SDMMC_SPI_CMD58_READ_OCR, and sd_mmc_card::type.

Referenced by sd_mmc_spi_install_mmc().

static bool sd_acmd51 ( void )

static

ACMD51 - Read the SD Configuration Register.

Note: SD Card Configuration Register (SCR) provides information on the SD Memory Card's special features that were configured into the given card. The size of SCR register is 64 bits.

Returns: true if success, otherwise false

References CARD_VER_SD_1_0, CARD_VER_SD_1_10, CARD_VER_SD_2_0, CARD_VER_SD_3_0, driver_adtc_start, driver_send_cmd, driver_start_read_blocks, driver_wait_end_of_read_blocks, sd_mmc_card::rca, SD_ACMD51_SEND_SCR, SD_SCR_REG_BSIZE, SD_SCR_SD_SPEC, SD_SCR_SD_SPEC3, SD_SCR_SD_SPEC_1_0_01, SD_SCR_SD_SPEC_1_10, SD_SCR_SD_SPEC_2_00, SD_SCR_SD_SPEC_3_00, SDMMC_CMD55_APP_CMD, and sd_mmc_card::version.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

static bool sd_acmd6 ( void )

static

ACMD6 - Define the data bus width to 4 bits bus.

Returns: true if success, otherwise false

References sd_mmc_card::bus_width, driver_send_cmd, sd_mmc_card::rca, SD_ACMD6_SET_BUS_WIDTH, sd_mmc_debug, and SDMMC_CMD55_APP_CMD.

Referenced by sd_mmc_mci_card_init().

static bool sd_cm6_set_high_speed ( void )

static

CMD6 for SD - Switch card in high speed mode.

Note: CMD6 for SD is valid under the "trans" state.; sd_mmc_card->high_speed is updated.; sd_mmc_card->clock is updated.

Returns: true if success, otherwise false

References CARD_STATUS_SWITCH_ERROR, sd_mmc_card::clock, driver_adtc_start, driver_get_response, driver_send_clock, driver_start_read_blocks, driver_wait_end_of_read_blocks, sd_mmc_card::high_speed, SD_CMD6_GRP1_HIGH_SPEED, SD_CMD6_GRP2_DEFAULT, SD_CMD6_GRP3_NO_INFLUENCE, SD_CMD6_GRP4_NO_INFLUENCE, SD_CMD6_GRP5_NO_INFLUENCE, SD_CMD6_GRP6_NO_INFLUENCE, SD_CMD6_MODE_SWITCH, SD_CMD6_SWITCH_FUNC, sd_mmc_debug, SD_SW_STATUS_BSIZE, SD_SW_STATUS_FUN_GRP1_BUSY, SD_SW_STATUS_FUN_GRP1_RC, and SD_SW_STATUS_FUN_GRP_RC_ERROR.

Referenced by sd_mmc_mci_card_init().

static bool sd_cmd8 ( uint8_t * v2 )

static

CMD8 for SD card - Send Interface Condition Command.

Note: Send SD Memory Card interface condition, which includes host supply voltage information and asks the card whether card supports voltage. Should be performed at initialization time to detect the card type.

Parameters

v2	Pointer to v2 flag to update

Returns: true if success, otherwise false with a update of sd_mmc_err.

References driver_get_response, driver_send_cmd, SD_CMD8_HIGH_VOLTAGE, SD_CMD8_MASK_PATTERN, SD_CMD8_MASK_VOLTAGE, SD_CMD8_PATTERN, SD_CMD8_SEND_IF_COND, and sd_mmc_debug.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

static void sd_decode_csd ( void )

static

Decodes SD CSD register.

References sd_mmc_card::capacity, sd_mmc_card::clock, sd_mmc_card::csd, CSD_STRUCTURE_VERSION, CSD_TRAN_SPEED, SD_CSD_1_0_C_SIZE, SD_CSD_1_0_C_SIZE_MULT, SD_CSD_1_0_READ_BL_LEN, SD_CSD_2_0_C_SIZE, SD_CSD_VER_2_0, sd_mmc_trans_units, and sd_trans_multipliers.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

static bool sd_mci_op_cond ( uint8_t v2 )

static

Ask to all cards to send their operations conditions (MCI only).

ACMD41 sends operation condition command.
ACMD41 reads OCR

Parameters

v2	Shall be 1 if it is a SD card V2

Returns: true if success, otherwise false

References CARD_TYPE_HC, driver_get_response, driver_send_cmd, OCR_CCS, OCR_POWER_UP_BUSY, SD_ACMD41_HCS, SD_MCI_ACMD41_SD_SEND_OP_COND, sd_mmc_debug, SD_MMC_VOLTAGE_SUPPORT, SDMMC_CMD55_APP_CMD, and sd_mmc_card::type.

Referenced by sd_mmc_mci_card_init().

static bool sd_mmc_cmd13 ( void )

static

CMD13 - Addressed card sends its status register.

This function waits the clear of the busy flag

Returns: true if success, otherwise false

References CARD_STATUS_READY_FOR_DATA, driver_get_response, driver_send_cmd, sd_mmc_card::rca, sd_mmc_debug, sd_mmc_is_spi, SDMMC_MCI_CMD13_SEND_STATUS, and SDMMC_SPI_CMD13_SEND_STATUS.

Referenced by sd_mmc_init_read_blocks(), sd_mmc_spi_card_init(), and sd_mmc_spi_install_mmc().

static bool sd_mmc_cmd9_mci ( void )

static

CMD9: Addressed card sends its card-specific data (CSD) on the CMD line mci.

Returns: true if success, otherwise false

References sd_mmc_card::csd, driver_get_response_128, driver_send_cmd, sd_mmc_card::rca, and SDMMC_MCI_CMD9_SEND_CSD.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_mci_install_mmc().

static bool sd_mmc_cmd9_spi ( void )

static

CMD9: Addressed card sends its card-specific data (CSD) on the CMD line spi.

Returns: true if success, otherwise false

References sd_mmc_card::csd, CSD_REG_BSIZE, driver_adtc_start, driver_start_read_blocks, driver_wait_end_of_read_blocks, sd_mmc_card::rca, and SDMMC_SPI_CMD9_SEND_CSD.

Referenced by sd_mmc_spi_card_init(), and sd_mmc_spi_install_mmc().

static void sd_mmc_configure_slot ( void )

static

Configures the driver with the selected card configuration.

References sd_mmc_card::bus_width, sd_mmc_card::clock, driver_select_device, sd_mmc_card::high_speed, and sd_mmc_slot_sel.

Referenced by sd_mmc_mci_card_init(), sd_mmc_mci_install_mmc(), sd_mmc_select_slot(), sd_mmc_spi_card_init(), and sd_mmc_spi_install_mmc().

static void sd_mmc_deselect_slot ( void )

static

Deselect the current card slot.

References driver_deselect_device, SD_MMC_MEM_CNT, and sd_mmc_slot_sel.

Referenced by sd_mmc_check(), sd_mmc_get_capacity(), sd_mmc_get_type(), sd_mmc_get_version(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_wait_end_of_read_blocks(), sd_mmc_wait_end_of_write_blocks(), sdio_read_direct(), sdio_read_extended(), sdio_write_direct(), and sdio_write_extended().

static bool sd_mmc_mci_card_init ( void )

static

Initialize the SD card in MCI mode.

Note: This function runs the initialization procedure and the identification process, then it sets the SD/MMC card in transfer state. At last, it will automaticly enable maximum bus width and transfer speed.

Returns: true if success, otherwise false

References CARD_TYPE_MMC, CARD_TYPE_SD, CARD_VER_SD_1_0, CARD_VER_UNKNOWN, driver_get_bus_width, driver_get_response, driver_is_high_speed_capable, driver_send_clock, driver_send_cmd, IS_SDIO, sd_mmc_card::rca, sd_acmd51(), sd_acmd6(), sd_cm6_set_high_speed(), SD_CMD3_SEND_RELATIVE_ADDR, sd_cmd8(), sd_decode_csd(), sd_mci_op_cond(), SD_MMC_BLOCK_SIZE, sd_mmc_cmd9_mci(), sd_mmc_configure_slot(), sd_mmc_debug, sd_mmc_mci_install_mmc(), sd_mmc_slot_sel, SDIO_CCCR_IOA, SDIO_CIA, sdio_cmd52(), sdio_cmd52_set_bus_width(), sdio_cmd52_set_high_speed(), SDIO_CMD52_WRITE_FLAG, sdio_get_max_speed(), sdio_op_cond(), SDMMC_CMD16_SET_BLOCKLEN, SDMMC_CMD2_ALL_SEND_CID, SDMMC_CMD7_SELECT_CARD_CMD, SDMMC_MCI_CMD0_GO_IDLE_STATE, sd_mmc_card::type, and sd_mmc_card::version.

Referenced by sd_mmc_check().

static bool sd_mmc_mci_install_mmc ( void )

static

Initialize the MMC card in MCI mode.

Note: This function runs the initialization procedure and the identification process, then it sets the SD/MMC card in transfer state. At last, it will automaticly enable maximum bus width and transfer speed.

Returns: true if success, otherwise false

References CARD_VER_MMC_4, driver_get_bus_width, driver_is_high_speed_capable, driver_send_cmd, MMC_CMD3_SET_RELATIVE_ADDR, mmc_cmd6_set_bus_width(), mmc_cmd6_set_high_speed(), mmc_cmd8(), mmc_decode_csd(), mmc_mci_op_cond(), sd_mmc_card::rca, SD_MMC_BLOCK_SIZE, sd_mmc_cmd9_mci(), sd_mmc_configure_slot(), sd_mmc_slot_sel, SDMMC_CMD16_SET_BLOCKLEN, SDMMC_CMD2_ALL_SEND_CID, SDMMC_CMD7_SELECT_CARD_CMD, SDMMC_MCI_CMD0_GO_IDLE_STATE, and sd_mmc_card::version.

Referenced by sd_mmc_mci_card_init().

static sd_mmc_err_t sd_mmc_select_slot ( uint8_t slot )

static

Select a card slot and initialize the associated driver.

Parameters

slot	Card slot number

Return values

SD_MMC_ERR_SLOT	Wrong slot number
SD_MMC_ERR_NO_CARD	No card present on slot
SD_MMC_ERR_UNUSABLE	Unusable card
SD_MMC_INIT_ONGOING	Card initialization requested
SD_MMC_OK	Card present

Card Detect pins

References Assert, sd_mmc_card::bus_width, sd_mmc_card::cd_gpio, sd_mmc_card::clock, sd_mmc_card::high_speed, ioport_get_pin_level(), SD_MMC_0_CD_DETECT_VALUE, SD_MMC_CARD_STATE_DEBOUNCE, SD_MMC_CARD_STATE_INIT, SD_MMC_CARD_STATE_NO_CARD, SD_MMC_CARD_STATE_UNUSABLE, sd_mmc_cards, sd_mmc_configure_slot(), SD_MMC_ERR_NO_CARD, SD_MMC_ERR_SLOT, SD_MMC_ERR_UNUSABLE, SD_MMC_INIT_ONGOING, SD_MMC_IS_TIMEOUT, SD_MMC_MEM_CNT, sd_mmc_nb_block_remaining, SD_MMC_OK, sd_mmc_slot_sel, SD_MMC_START_TIMEOUT, SD_MMC_STOP_TIMEOUT, SDMMC_CLOCK_INIT, and sd_mmc_card::state.

Referenced by sd_mmc_check(), sd_mmc_get_capacity(), sd_mmc_get_type(), sd_mmc_get_version(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sdio_read_direct(), sdio_read_extended(), sdio_write_direct(), and sdio_write_extended().

static bool sd_mmc_spi_card_init ( void )

static

Initialize the SD card in SPI mode.

Note: This function runs the initialization procedure and the identification process, then it sets the SD/MMC card in transfer state. At last, it will automaticly enable maximum bus width and transfer speed.

Returns: true if success, otherwise false

References CARD_TYPE_HC, CARD_TYPE_MMC, CARD_TYPE_SD, CARD_VER_UNKNOWN, driver_send_clock, driver_send_cmd, IS_SDIO, sd_mmc_card::rca, sd_acmd51(), sd_cmd8(), sd_decode_csd(), SD_MMC_BLOCK_SIZE, sd_mmc_cmd13(), sd_mmc_cmd9_spi(), sd_mmc_configure_slot(), sd_mmc_debug, sd_mmc_spi_install_mmc(), sd_spi_op_cond(), sdio_get_max_speed(), sdio_op_cond(), SDMMC_CMD16_SET_BLOCKLEN, SDMMC_SPI_CMD0_GO_IDLE_STATE, SDMMC_SPI_CMD59_CRC_ON_OFF, sd_mmc_card::type, and sd_mmc_card::version.

Referenced by sd_mmc_check().

static bool sd_mmc_spi_install_mmc ( void )

static

Initialize the MMC card in SPI mode.

Note: This function runs the initialization procedure and the identification process, then it sets the SD/MMC card in transfer state. At last, it will automaticly enable maximum bus width and transfer speed.

Returns: true if success, otherwise false

References CARD_VER_MMC_4, driver_send_cmd, mmc_cmd8(), mmc_decode_csd(), mmc_spi_op_cond(), SD_MMC_BLOCK_SIZE, sd_mmc_cmd13(), sd_mmc_cmd9_spi(), sd_mmc_configure_slot(), SDMMC_CMD16_SET_BLOCKLEN, SDMMC_SPI_CMD0_GO_IDLE_STATE, SDMMC_SPI_CMD59_CRC_ON_OFF, and sd_mmc_card::version.

Referenced by sd_mmc_spi_card_init().

static bool sd_spi_op_cond ( uint8_t v2 )

static

Ask to all cards to send their operations conditions (SPI only).

ACMD41 sends operation condition command.
CMD58 reads OCR

Parameters

v2	Shall be 1 if it is a SD card V2

Returns: true if success, otherwise false

References CARD_TYPE_HC, driver_get_response, driver_send_cmd, OCR_CCS, R1_SPI_IDLE, SD_ACMD41_HCS, sd_mmc_debug, SD_SPI_ACMD41_SD_SEND_OP_COND, SDMMC_CMD55_APP_CMD, SDMMC_SPI_CMD58_READ_OCR, and sd_mmc_card::type.

Referenced by sd_mmc_spi_card_init().

static bool sdio_cmd52	(	uint8_t	rw_flag,
		uint8_t	func_nb,
		uint32_t	reg_addr,
		uint8_t	rd_after_wr,
		uint8_t *	io_data
	)

static

CMD52 - SDIO IO_RW_DIRECT command.

Parameters

rw_flag	Direction, 1:write, 0:read.
func_nb	Number of the function.
rd_after_wr	Read after Write flag.
reg_addr	register address.
io_data	Pointer to input argument and response buffer.

Returns: true if success, otherwise false

References Assert, driver_get_response, driver_send_cmd, SDIO_CMD52_FUNCTION_NUM, SDIO_CMD52_IO_RW_DIRECT, SDIO_CMD52_RAW_FLAG, SDIO_CMD52_REG_ADRR, SDIO_CMD52_RW_FLAG, and SDIO_CMD52_WR_DATA.

Referenced by sd_mmc_mci_card_init(), sdio_cmd52_set_bus_width(), sdio_cmd52_set_high_speed(), sdio_get_max_speed(), sdio_read_direct(), and sdio_write_direct().

static bool sdio_cmd52_set_bus_width ( void )

static

CMD52 for SDIO - Switches the bus width mode to 4.

Note: sd_mmc_card->bus_width is updated.

Returns: true if success, otherwise false

A SD memory card always supports bus 4bit A SD COMBO card always supports bus 4bit A SDIO Full-Speed alone always supports 4bit A SDIO Low-Speed alone can supports 4bit (Optional)

References sd_mmc_card::bus_width, sd_mmc_debug, SDIO_BUSWIDTH_4B, SDIO_CAP_4BLS, SDIO_CCCR_BUS_CTRL, SDIO_CCCR_CAP, SDIO_CIA, sdio_cmd52(), SDIO_CMD52_READ_FLAG, and SDIO_CMD52_WRITE_FLAG.

Referenced by sd_mmc_mci_card_init().

static bool sdio_cmd52_set_high_speed ( void )

static

CMD52 for SDIO - Enable the high speed mode.

Note: sd_mmc_card->high_speed is updated.; sd_mmc_card->clock is updated.

Returns: true if success, otherwise false

References sd_mmc_card::clock, sd_mmc_card::high_speed, SDIO_CCCR_HS, SDIO_CIA, sdio_cmd52(), SDIO_CMD52_READ_FLAG, SDIO_CMD52_WRITE_FLAG, SDIO_EHS, and SDIO_SHS.

Referenced by sd_mmc_mci_card_init().

static bool sdio_cmd53	(	uint8_t	rw_flag,
		uint8_t	func_nb,
		uint32_t	reg_addr,
		uint8_t	inc_addr,
		uint32_t	size,
		bool	access_block
	)

static

CMD53 - SDIO IO_RW_EXTENDED command This implementation support only the SDIO multi-byte transfer mode which is similar to the single block transfer on memory.

Note: The SDIO block transfer mode is optional for SDIO card.

Parameters

rw_flag	Direction, 1:write, 0:read.
func_nb	Number of the function.
reg_addr	Register address.
inc_addr	1:Incrementing address, 0: fixed.
size	Transfer data size.
access_block	true, if the block access (DMA) is used

Returns: true if success, otherwise false

References Assert, driver_adtc_start, SDIO_CMD53_BLOCK_MODE, SDIO_CMD53_COUNT, SDIO_CMD53_FUNCTION_NUM, SDIO_CMD53_IO_R_BYTE_EXTENDED, SDIO_CMD53_IO_W_BYTE_EXTENDED, SDIO_CMD53_OP_CODE, SDIO_CMD53_READ_FLAG, SDIO_CMD53_REG_ADDR, and SDIO_CMD53_RW_FLAG.

Referenced by sdio_read_extended(), and sdio_write_extended().

static bool sdio_get_max_speed ( void )

static

Get SDIO max transfer speed in Hz.

CMD53 reads CIS area address in CCCR area.
Nx CMD53 search Fun0 tuple in CIS area
CMD53 reads TPLFE_MAX_TRAN_SPEED in Fun0 tuple
Compute maximum speed of SDIO and update sd_mmc_card->clock

Returns: true if success, otherwise false

Note: A combo card shall be a Full-Speed SDIO card which supports upto 25MHz. A SDIO card alone can be:

a Low-Speed SDIO card which supports 400Khz minimum
a Full-Speed SDIO card which supports upto 25MHz

References sd_mmc_card::clock, sd_mmc_trans_units, sd_trans_multipliers, SDIO_CCCR_CIS_PTR, SDIO_CIA, SDIO_CISTPL_END, SDIO_CISTPL_FUNCE, sdio_cmd52(), and SDIO_CMD52_READ_FLAG.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

static bool sdio_op_cond ( void )

static

Try to get the SDIO card's operating condition.

CMD5 to read OCR NF field
CMD5 to wait OCR power up busy
CMD5 to read OCR MP field sd_mmc_card->type is updated

Returns: true if success, otherwise false

References CARD_TYPE_SD_COMBO, CARD_TYPE_SDIO, driver_get_response, driver_send_cmd, OCR_POWER_UP_BUSY, OCR_SDIO_MP, OCR_SDIO_NF, sd_mmc_debug, SD_MMC_VOLTAGE_SUPPORT, SDIO_CMD5_SEND_OP_COND, and sd_mmc_card::type.

Referenced by sd_mmc_mci_card_init(), and sd_mmc_spi_card_init().

uint8_t sd_mmc_card::bus_width

Number of DATA lin on bus (MCI only)

Referenced by mmc_cmd6_set_bus_width(), sd_acmd6(), sd_mmc_configure_slot(), sd_mmc_select_slot(), and sdio_cmd52_set_bus_width().

uint32_t sd_mmc_card::capacity

Card capacity in KBytes.

Referenced by mmc_cmd8(), mmc_decode_csd(), sd_decode_csd(), and sd_mmc_get_capacity().

uint32_t sd_mmc_card::cd_gpio

Card detect GPIO.

Referenced by sd_mmc_select_slot().

uint32_t sd_mmc_card::clock

Card access clock.

Referenced by mmc_cmd6_set_high_speed(), mmc_decode_csd(), sd_cm6_set_high_speed(), sd_decode_csd(), sd_mmc_configure_slot(), sd_mmc_select_slot(), sdio_cmd52_set_high_speed(), and sdio_get_max_speed().

uint8_t sd_mmc_card::csd[CSD_REG_BSIZE]

CSD register.

Referenced by mmc_cmd8(), mmc_decode_csd(), sd_decode_csd(), sd_mmc_cmd9_mci(), and sd_mmc_cmd9_spi().

uint8_t sd_mmc_card::high_speed

High speed card (1)

Referenced by mmc_cmd6_set_high_speed(), sd_cm6_set_high_speed(), sd_mmc_configure_slot(), sd_mmc_select_slot(), and sdio_cmd52_set_high_speed().

const uint32_t mmc_trans_multipliers[16]

Initial value:

= {
    0, 10, 12, 13, 15, 20, 26, 30, 35, 40, 45, 52, 55, 60, 70, 80
}

MMC transfer multiplier factor codes (1/10) list.

Referenced by mmc_decode_csd().

uint16_t sd_mmc_card::rca

Relative card address.

Referenced by sd_acmd51(), sd_acmd6(), sd_mmc_cmd13(), sd_mmc_cmd9_mci(), sd_mmc_cmd9_spi(), sd_mmc_mci_card_init(), sd_mmc_mci_install_mmc(), and sd_mmc_spi_card_init().

struct sd_mmc_card* sd_mmc_card

static

Pointer on current slot configurated.

struct sd_mmc_card sd_mmc_cards[SD_MMC_MEM_CNT]

static

Initial value:

= {
#define SD_MMC_CD(slot, unused) 
}

SD/MMC card list Note: Initialize card detect pin fields if present.

Referenced by sd_mmc_is_write_protected(), and sd_mmc_select_slot().

uint16_t sd_mmc_nb_block_remaining = 0

static

Number of block remaining to read or write on the current transfer.

Referenced by sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_select_slot(), sd_mmc_start_read_blocks(), sd_mmc_start_write_blocks(), sd_mmc_wait_end_of_read_blocks(), and sd_mmc_wait_end_of_write_blocks().

uint16_t sd_mmc_nb_block_to_tranfer = 0

static

Number of block to read or write on the current transfer.

Referenced by sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_wait_end_of_read_blocks(), and sd_mmc_wait_end_of_write_blocks().

bool sd_mmc_sam_systick_used

static

uint8_t sd_mmc_slot_sel

static

Index of current slot configurated.

Referenced by sd_mmc_configure_slot(), sd_mmc_deselect_slot(), sd_mmc_mci_card_init(), sd_mmc_mci_install_mmc(), and sd_mmc_select_slot().

const uint32_t sd_mmc_trans_units[7]

Initial value:

= {
    10, 100, 1000, 10000, 0, 0, 0
}

SD/MMC transfer rate unit codes (10K) list.

Referenced by mmc_decode_csd(), sd_decode_csd(), and sdio_get_max_speed().

const uint32_t sd_trans_multipliers[16]

Initial value:

= {
    0, 10, 12, 13, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 70, 80
}

SD transfer multiplier factor codes (1/10) list.

Referenced by sd_decode_csd(), and sdio_get_max_speed().

enum card_state sd_mmc_card::state

Card state.

Referenced by sd_mmc_check(), and sd_mmc_select_slot().

t_cpu_time timer

static

card_type_t sd_mmc_card::type

Card type.

Referenced by mmc_mci_op_cond(), mmc_spi_op_cond(), sd_mci_op_cond(), sd_mmc_get_type(), sd_mmc_init_read_blocks(), sd_mmc_init_write_blocks(), sd_mmc_mci_card_init(), sd_mmc_spi_card_init(), sd_spi_op_cond(), and sdio_op_cond().

card_version_t sd_mmc_card::version

Card version.

Referenced by mmc_decode_csd(), sd_acmd51(), sd_mmc_get_version(), sd_mmc_mci_card_init(), sd_mmc_mci_install_mmc(), sd_mmc_spi_card_init(), and sd_mmc_spi_install_mmc().

Microchip® Advanced Software Framework

Modules

Data Structures

Files

Macros

Enumerations

Variables

MMC, SD and SDIO commands process

Internal function to process the initialization and install

Internal functions to manage a large timeout after a card insertion