hal_mmcsd.h File Reference

MMC/SD cards common header. More...

Go to the source code of this file.

Data Structures
struct	MMCSDBlockDeviceVMT
	MMCSDBlockDevice virtual methods table. More...
struct	MMCSDBlockDevice
	MCC/SD block device class. More...
struct	unpacked_sdc_cid_t
	Unpacked CID register from SDC. More...
struct	unpacked_mmc_cid_t
	Unpacked CID register from MMC. More...
struct	unpacked_sdc_csd_10_t
	Unpacked CSD v1.0 register from SDC. More...
struct	unpacked_sdc_csd_20_t
	Unpacked CSD v2.0 register from SDC. More...
struct	unpacked_mmc_csd_t
	Unpacked CSD register from MMC. More...

Macros
#define	MMCSD_BLOCK_SIZE   512U
	Fixed block size for MMC/SD block devices.
#define	MMCSD_R1_ERROR_MASK   0xFDFFE008U
	Mask of error bits in R1 responses.
#define	MMCSD_CMD8_PATTERN   0x000001AAU
	Fixed pattern for CMD8.
#define	_mmcsd_block_device_methods    _base_block_device_methods
	MMCSDBlockDevice specific methods.
#define	_mmcsd_block_device_data
	MMCSDBlockDevice specific data.
SD/MMC status conditions
#define	MMCSD_STS_IDLE   0U
#define	MMCSD_STS_READY   1U
#define	MMCSD_STS_IDENT   2U
#define	MMCSD_STS_STBY   3U
#define	MMCSD_STS_TRAN   4U
#define	MMCSD_STS_DATA   5U
#define	MMCSD_STS_RCV   6U
#define	MMCSD_STS_PRG   7U
#define	MMCSD_STS_DIS   8U
SD/MMC commands
#define	MMCSD_CMD_GO_IDLE_STATE   0U
#define	MMCSD_CMD_INIT   1U
#define	MMCSD_CMD_ALL_SEND_CID   2U
#define	MMCSD_CMD_SEND_RELATIVE_ADDR   3U
#define	MMCSD_CMD_SET_RELATIVE_ADDR   MMCSD_CMD_SEND_RELATIVE_ADDR
#define	MMCSD_CMD_SET_BUS_WIDTH   6U
#define	MMCSD_CMD_SWITCH   MMCSD_CMD_SET_BUS_WIDTH
#define	MMCSD_CMD_SEL_DESEL_CARD   7U
#define	MMCSD_CMD_SEND_IF_COND   8U
#define	MMCSD_CMD_SEND_EXT_CSD   MMCSD_CMD_SEND_IF_COND
#define	MMCSD_CMD_SEND_CSD   9U
#define	MMCSD_CMD_SEND_CID   10U
#define	MMCSD_CMD_STOP_TRANSMISSION   12U
#define	MMCSD_CMD_SEND_STATUS   13U
#define	MMCSD_CMD_SET_BLOCKLEN   16U
#define	MMCSD_CMD_READ_SINGLE_BLOCK   17U
#define	MMCSD_CMD_READ_MULTIPLE_BLOCK   18U
#define	MMCSD_CMD_SET_BLOCK_COUNT   23U
#define	MMCSD_CMD_WRITE_BLOCK   24U
#define	MMCSD_CMD_WRITE_MULTIPLE_BLOCK   25U
#define	MMCSD_CMD_ERASE_RW_BLK_START   32U
#define	MMCSD_CMD_ERASE_RW_BLK_END   33U
#define	MMCSD_CMD_ERASE   38U
#define	MMCSD_CMD_APP_OP_COND   41U
#define	MMCSD_CMD_LOCK_UNLOCK   42U
#define	MMCSD_CMD_APP_CMD   55U
#define	MMCSD_CMD_READ_OCR   58U
CSD record offsets
#define	MMCSD_CSD_MMC_CSD_STRUCTURE_SLICE   127U, 126U
#define	MMCSD_CSD_MMC_SPEC_VERS_SLICE   125U, 122U
#define	MMCSD_CSD_MMC_TAAC_SLICE   119U, 112U
#define	MMCSD_CSD_MMC_NSAC_SLICE   111U, 104U
#define	MMCSD_CSD_MMC_TRAN_SPEED_SLICE   103U, 96U
#define	MMCSD_CSD_MMC_CCC_SLICE   95U, 84U
#define	MMCSD_CSD_MMC_READ_BL_LEN_SLICE   83U, 80U
#define	MMCSD_CSD_MMC_READ_BL_PARTIAL_SLICE   79U, 79U
#define	MMCSD_CSD_MMC_WRITE_BLK_MISALIGN_SLICE   78U, 78U
#define	MMCSD_CSD_MMC_READ_BLK_MISALIGN_SLICE   77U, 77U
#define	MMCSD_CSD_MMC_DSR_IMP_SLICE   76U, 76U
#define	MMCSD_CSD_MMC_C_SIZE_SLICE   73U, 62U
#define	MMCSD_CSD_MMC_VDD_R_CURR_MIN_SLICE   61U, 59U
#define	MMCSD_CSD_MMC_VDD_R_CURR_MAX_SLICE   58U, 56U
#define	MMCSD_CSD_MMC_VDD_W_CURR_MIN_SLICE   55U, 53U
#define	MMCSD_CSD_MMC_VDD_W_CURR_MAX_SLICE   52U, 50U
#define	MMCSD_CSD_MMC_C_SIZE_MULT_SLICE   49U, 47U
#define	MMCSD_CSD_MMC_ERASE_GRP_SIZE_SLICE   46U, 42U
#define	MMCSD_CSD_MMC_ERASE_GRP_MULT_SLICE   41U, 37U
#define	MMCSD_CSD_MMC_WP_GRP_SIZE_SLICE   36U, 32U
#define	MMCSD_CSD_MMC_WP_GRP_ENABLE_SLICE   31U, 31U
#define	MMCSD_CSD_MMC_DEFAULT_ECC_SLICE   30U, 29U
#define	MMCSD_CSD_MMC_R2W_FACTOR_SLICE   28U, 26U
#define	MMCSD_CSD_MMC_WRITE_BL_LEN_SLICE   25U, 22U
#define	MMCSD_CSD_MMC_WRITE_BL_PARTIAL_SLICE   21U, 21U
#define	MMCSD_CSD_MMC_CONTENT_PROT_APP_SLICE   16U, 16U
#define	MMCSD_CSD_MMC_FILE_FORMAT_GRP_SLICE   15U, 15U
#define	MMCSD_CSD_MMC_COPY_SLICE   14U, 14U
#define	MMCSD_CSD_MMC_PERM_WRITE_PROTECT_SLICE   13U, 13U
#define	MMCSD_CSD_MMC_TMP_WRITE_PROTECT_SLICE   12U, 12U
#define	MMCSD_CSD_MMC_FILE_FORMAT_SLICE   11U, 10U
#define	MMCSD_CSD_MMC_ECC_SLICE   9U, 8U
#define	MMCSD_CSD_MMC_CRC_SLICE   7U, 1U
#define	MMCSD_CSD_20_CRC_SLICE   7U, 1U
#define	MMCSD_CSD_20_FILE_FORMAT_SLICE   11U, 10U
#define	MMCSD_CSD_20_TMP_WRITE_PROTECT_SLICE   12U, 12U
#define	MMCSD_CSD_20_PERM_WRITE_PROTECT_SLICE   13U, 13U
#define	MMCSD_CSD_20_COPY_SLICE   14U, 14U
#define	MMCSD_CSD_20_FILE_FORMAT_GRP_SLICE   15U, 15U
#define	MMCSD_CSD_20_WRITE_BL_PARTIAL_SLICE   21U, 21U
#define	MMCSD_CSD_20_WRITE_BL_LEN_SLICE   25U, 12U
#define	MMCSD_CSD_20_R2W_FACTOR_SLICE   28U, 26U
#define	MMCSD_CSD_20_WP_GRP_ENABLE_SLICE   31U, 31U
#define	MMCSD_CSD_20_WP_GRP_SIZE_SLICE   38U, 32U
#define	MMCSD_CSD_20_ERASE_SECTOR_SIZE_SLICE   45U, 39U
#define	MMCSD_CSD_20_ERASE_BLK_EN_SLICE   46U, 46U
#define	MMCSD_CSD_20_C_SIZE_SLICE   69U, 48U
#define	MMCSD_CSD_20_DSR_IMP_SLICE   76U, 76U
#define	MMCSD_CSD_20_READ_BLK_MISALIGN_SLICE   77U, 77U
#define	MMCSD_CSD_20_WRITE_BLK_MISALIGN_SLICE   78U, 78U
#define	MMCSD_CSD_20_READ_BL_PARTIAL_SLICE   79U, 79U
#define	MMCSD_CSD_20_READ_BL_LEN_SLICE   83U, 80U
#define	MMCSD_CSD_20_CCC_SLICE   95U, 84U
#define	MMCSD_CSD_20_TRANS_SPEED_SLICE   103U, 96U
#define	MMCSD_CSD_20_NSAC_SLICE   111U, 104U
#define	MMCSD_CSD_20_TAAC_SLICE   119U, 112U
#define	MMCSD_CSD_20_CSD_STRUCTURE_SLICE   127U, 126U
#define	MMCSD_CSD_10_CRC_SLICE   MMCSD_CSD_20_CRC_SLICE
#define	MMCSD_CSD_10_FILE_FORMAT_SLICE   MMCSD_CSD_20_FILE_FORMAT_SLICE
#define	MMCSD_CSD_10_TMP_WRITE_PROTECT_SLICE   MMCSD_CSD_20_TMP_WRITE_PROTECT_SLICE
#define	MMCSD_CSD_10_PERM_WRITE_PROTECT_SLICE   MMCSD_CSD_20_PERM_WRITE_PROTECT_SLICE
#define	MMCSD_CSD_10_COPY_SLICE   MMCSD_CSD_20_COPY_SLICE
#define	MMCSD_CSD_10_FILE_FORMAT_GRP_SLICE   MMCSD_CSD_20_FILE_FORMAT_GRP_SLICE
#define	MMCSD_CSD_10_WRITE_BL_PARTIAL_SLICE   MMCSD_CSD_20_WRITE_BL_PARTIAL_SLICE
#define	MMCSD_CSD_10_WRITE_BL_LEN_SLICE   MMCSD_CSD_20_WRITE_BL_LEN_SLICE
#define	MMCSD_CSD_10_R2W_FACTOR_SLICE   MMCSD_CSD_20_R2W_FACTOR_SLICE
#define	MMCSD_CSD_10_WP_GRP_ENABLE_SLICE   MMCSD_CSD_20_WP_GRP_ENABLE_SLICE
#define	MMCSD_CSD_10_WP_GRP_SIZE_SLICE   MMCSD_CSD_20_WP_GRP_SIZE_SLICE
#define	MMCSD_CSD_10_ERASE_SECTOR_SIZE_SLICE   MMCSD_CSD_20_ERASE_SECTOR_SIZE_SLICE
#define	MMCSD_CSD_10_ERASE_BLK_EN_SLICE   MMCSD_CSD_20_ERASE_BLK_EN_SLICE
#define	MMCSD_CSD_10_C_SIZE_MULT_SLICE   49U, 47U
#define	MMCSD_CSD_10_VDD_W_CURR_MAX_SLICE   52U, 50U
#define	MMCSD_CSD_10_VDD_W_CURR_MIN_SLICE   55U, 53U
#define	MMCSD_CSD_10_VDD_R_CURR_MAX_SLICE   58U, 56U
#define	MMCSD_CSD_10_VDD_R_CURR_MIX_SLICE   61U, 59U
#define	MMCSD_CSD_10_C_SIZE_SLICE   73U, 62U
#define	MMCSD_CSD_10_DSR_IMP_SLICE   MMCSD_CSD_20_DSR_IMP_SLICE
#define	MMCSD_CSD_10_READ_BLK_MISALIGN_SLICE   MMCSD_CSD_20_READ_BLK_MISALIGN_SLICE
#define	MMCSD_CSD_10_WRITE_BLK_MISALIGN_SLICE   MMCSD_CSD_20_WRITE_BLK_MISALIGN_SLICE
#define	MMCSD_CSD_10_READ_BL_PARTIAL_SLICE   MMCSD_CSD_20_READ_BL_PARTIAL_SLICE
#define	MMCSD_CSD_10_READ_BL_LEN_SLICE   83U, 80U
#define	MMCSD_CSD_10_CCC_SLICE   MMCSD_CSD_20_CCC_SLICE
#define	MMCSD_CSD_10_TRANS_SPEED_SLICE   MMCSD_CSD_20_TRANS_SPEED_SLICE
#define	MMCSD_CSD_10_NSAC_SLICE   MMCSD_CSD_20_NSAC_SLICE
#define	MMCSD_CSD_10_TAAC_SLICE   MMCSD_CSD_20_TAAC_SLICE
#define	MMCSD_CSD_10_CSD_STRUCTURE_SLICE   MMCSD_CSD_20_CSD_STRUCTURE_SLICE
CID record offsets
#define	MMCSD_CID_SDC_CRC_SLICE   7U, 1U
#define	MMCSD_CID_SDC_MDT_M_SLICE   11U, 8U
#define	MMCSD_CID_SDC_MDT_Y_SLICE   19U, 12U
#define	MMCSD_CID_SDC_PSN_SLICE   55U, 24U
#define	MMCSD_CID_SDC_PRV_M_SLICE   59U, 56U
#define	MMCSD_CID_SDC_PRV_N_SLICE   63U, 60U
#define	MMCSD_CID_SDC_PNM0_SLICE   71U, 64U
#define	MMCSD_CID_SDC_PNM1_SLICE   79U, 72U
#define	MMCSD_CID_SDC_PNM2_SLICE   87U, 80U
#define	MMCSD_CID_SDC_PNM3_SLICE   95U, 88U
#define	MMCSD_CID_SDC_PNM4_SLICE   103U, 96U
#define	MMCSD_CID_SDC_OID_SLICE   119U, 104U
#define	MMCSD_CID_SDC_MID_SLICE   127U, 120U
#define	MMCSD_CID_MMC_CRC_SLICE   7U, 1U
#define	MMCSD_CID_MMC_MDT_Y_SLICE   11U, 8U
#define	MMCSD_CID_MMC_MDT_M_SLICE   15U, 12U
#define	MMCSD_CID_MMC_PSN_SLICE   47U, 16U
#define	MMCSD_CID_MMC_PRV_M_SLICE   51U, 48U
#define	MMCSD_CID_MMC_PRV_N_SLICE   55U, 52U
#define	MMCSD_CID_MMC_PNM0_SLICE   63U, 56U
#define	MMCSD_CID_MMC_PNM1_SLICE   71U, 64U
#define	MMCSD_CID_MMC_PNM2_SLICE   79U, 72U
#define	MMCSD_CID_MMC_PNM3_SLICE   87U, 80U
#define	MMCSD_CID_MMC_PNM4_SLICE   95U, 88U
#define	MMCSD_CID_MMC_PNM5_SLICE   103U, 96U
#define	MMCSD_CID_MMC_OID_SLICE   119U, 104U
#define	MMCSD_CID_MMC_MID_SLICE   127U, 120U
R1 response utilities
#define	MMCSD_R1_ERROR(r1)
	Evaluates to true if the R1 response contains error flags.
#define	MMCSD_R1_STS(r1)
	Returns the status field of an R1 response.
#define	MMCSD_R1_IS_CARD_LOCKED(r1)
	Evaluates to true if the R1 response indicates a locked card.
Macro Functions
#define	mmcsdGetCardCapacity(ip)
	Returns the card capacity in blocks.

Functions
uint32_t	_mmcsd_get_slice (const uint32_t *data, uint32_t end, uint32_t start)
	Gets a bit field from a words array.
uint32_t	_mmcsd_get_capacity (const uint32_t *csd)
	Extract card capacity from a CSD.
uint32_t	_mmcsd_get_capacity_ext (const uint8_t *ext_csd)
	Extract MMC card capacity from EXT_CSD.
void	_mmcsd_unpack_sdc_cid (const MMCSDBlockDevice *sdcp, unpacked_sdc_cid_t *cidsdc)
	Unpacks SDC CID array in structure.
void	_mmcsd_unpack_mmc_cid (const MMCSDBlockDevice *sdcp, unpacked_mmc_cid_t *cidmmc)
	Unpacks MMC CID array in structure.
void	_mmcsd_unpack_csd_mmc (const MMCSDBlockDevice *sdcp, unpacked_mmc_csd_t *csdmmc)
	Unpacks MMC CSD array in structure.
void	_mmcsd_unpack_csd_v10 (const MMCSDBlockDevice *sdcp, unpacked_sdc_csd_10_t *csd10)
	Unpacks SDC CSD v1.0 array in structure.
void	_mmcsd_unpack_csd_v20 (const MMCSDBlockDevice *sdcp, unpacked_sdc_csd_20_t *csd20)
	Unpacks SDC CSD v2.0 array in structure.

Detailed Description

MMC/SD cards common header.

This header defines an abstract interface useful to access MMC/SD I/O block devices in a standardized way.

Definition in file hal_mmcsd.h.