emmc_hal.h

/*
 * Copyright (c) 2015-2020, Renesas Electronics Corporation. All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

#ifndef EMMC_HAL_H
#define EMMC_HAL_H

/* memory card error/status types */
#define HAL_MEMCARD_OUT_OF_RANGE		0x80000000L
#define HAL_MEMCARD_ADDRESS_ERROR		0x40000000L
#define HAL_MEMCARD_BLOCK_LEN_ERROR		0x20000000L
#define HAL_MEMCARD_ERASE_SEQ_ERROR		0x10000000L
#define HAL_MEMCARD_ERASE_PARAM			0x08000000L
#define HAL_MEMCARD_WP_VIOLATION		0x04000000L
#define HAL_MEMCARD_CARD_IS_LOCKED		0x02000000L
#define HAL_MEMCARD_LOCK_UNLOCK_FAILED		0x01000000L
#define HAL_MEMCARD_COM_CRC_ERROR		0x00800000L
#define HAL_MEMCARD_ILEGAL_COMMAND		0x00400000L
#define HAL_MEMCARD_CARD_ECC_FAILED		0x00200000L
#define HAL_MEMCARD_CC_ERROR			0x00100000L
#define HAL_MEMCARD_ERROR			0x00080000L
#define HAL_MEMCARD_UNDERRUN			0x00040000L
#define HAL_MEMCARD_OVERRUN			0x00020000L
#define HAL_MEMCARD_CIDCSD_OVERWRITE		0x00010000L
#define HAL_MEMCARD_WP_ERASE_SKIP		0x00008000L
#define HAL_MEMCARD_CARD_ECC_DISABLED		0x00004000L
#define HAL_MEMCARD_ERASE_RESET			0x00002000L
#define HAL_MEMCARD_CARD_STATE			0x00001E00L
#define HAL_MEMCARD_CARD_READY_FOR_DATA		0x00000100L
#define HAL_MEMCARD_APP_CMD			0x00000020L
#define HAL_MEMCARD_SWITCH_ERROR		0x00000080L
#define HAL_MEMCARD_AKE_SEQ_ERROR		0x00000008L
#define HAL_MEMCARD_NO_ERRORS			0x00000000L

/* Memory card response types */
#define HAL_MEMCARD_COMMAND_INDEX_MASK		0x0003f

/* Type of the return value. */
typedef enum {
	HAL_MEMCARD_FAIL = 0U,
	HAL_MEMCARD_OK = 1U,
	HAL_MEMCARD_DMA_ALLOC_FAIL = 2U,     /* DMA channel allocation failed */
	HAL_MEMCARD_DMA_TRANSFER_FAIL = 3U,  /* DMA transfer failed */
	HAL_MEMCARD_CARD_STATUS_ERROR = 4U,  /* card status non-masked error */
	HAL_MEMCARD_CMD_TIMEOUT = 5U,	     /* Command timeout occurred */
	HAL_MEMCARD_DATA_TIMEOUT = 6U,	     /* Data timeout occurred */
	HAL_MEMCARD_CMD_CRC_ERROR = 7U,	     /* Command CRC error occurred */
	HAL_MEMCARD_DATA_CRC_ERROR = 8U	     /* Data CRC error occurred */
} HAL_MEMCARD_RETURN;

/* memory access operation */
typedef enum {
	HAL_MEMCARD_READ = 0U,	 /* read */
	HAL_MEMCARD_WRITE = 1U	 /* write */
} HAL_MEMCARD_OPERATION;

/* Type of data width on memorycard bus */
typedef enum {
	HAL_MEMCARD_DATA_WIDTH_1_BIT = 0U,
	HAL_MEMCARD_DATA_WIDTH_4_BIT = 1U,
	HAL_MEMCARD_DATA_WIDTH_8_BIT = 2U
} HAL_MEMCARD_DATA_WIDTH; /* data (bus) width types */

/* Presence of the memory card */
typedef enum {
	HAL_MEMCARD_CARD_IS_IN = 0U,
	HAL_MEMCARD_CARD_IS_OUT = 1U
} HAL_MEMCARD_PRESENCE_STATUS;	/* presence status of the memory card */

/* mode of data transfer */
typedef enum {
	HAL_MEMCARD_DMA = 0U,
	HAL_MEMCARD_NOT_DMA = 1U
} HAL_MEMCARD_DATA_TRANSFER_MODE;

/* Memory card response types. */
typedef enum hal_memcard_response_type {
	HAL_MEMCARD_RESPONSE_NONE = 0x00000U,
	HAL_MEMCARD_RESPONSE_R1 = 0x00100U,
	HAL_MEMCARD_RESPONSE_R1b = 0x00200U,
	HAL_MEMCARD_RESPONSE_R2 = 0x00300U,
	HAL_MEMCARD_RESPONSE_R3 = 0x00400U,
	HAL_MEMCARD_RESPONSE_R4 = 0x00500U,
	HAL_MEMCARD_RESPONSE_R5 = 0x00600U,
	HAL_MEMCARD_RESPONSE_R6 = 0x00700U,
	HAL_MEMCARD_RESPONSE_R7 = 0x00800U,
	HAL_MEMCARD_RESPONSE_TYPE_MASK = 0x00f00U
} HAL_MEMCARD_RESPONSE_TYPE;

/* Memory card command types. */
typedef enum hal_memcard_command_type {
	HAL_MEMCARD_COMMAND_TYPE_BC = 0x00000U,
	HAL_MEMCARD_COMMAND_TYPE_BCR = 0x01000U,
	HAL_MEMCARD_COMMAND_TYPE_AC = 0x02000U,
	HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE = 0x03000U,
	HAL_MEMCARD_COMMAND_TYPE_ADTC_READ = 0x04000U,
	HAL_MEMCARD_COMMAND_TYPE_MASK = 0x07000U
} HAL_MEMCARD_COMMAND_TYPE;

/* Type of memory card */
typedef enum hal_memcard_command_card_type {
	HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON = 0x00000U,
	HAL_MEMCARD_COMMAND_CARD_TYPE_MMC = 0x08000U,
	HAL_MEMCARD_COMMAND_CARD_TYPE_SD = 0x10000U,
	HAL_MEMCARD_COMMAND_CARD_TYPE_MASK = 0x18000U
} HAL_MEMCARD_COMMAND_CARD_TYPE;

/* Memory card application command. */
typedef enum hal_memcard_command_app_norm {
	HAL_MEMCARD_COMMAND_NORMAL = 0x00000U,
	HAL_MEMCARD_COMMAND_APP = 0x20000U,
	HAL_MEMCARD_COMMAND_APP_NORM_MASK = 0x20000U
} HAL_MEMCARD_COMMAND_APP_NORM;

/* Memory card command codes. */
typedef enum {
/* class 0 and class 1 */
	/* CMD0 */
	CMD0_GO_IDLE_STATE =
	    0U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BC |
	    (uint32_t) HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD1 */
	CMD1_SEND_OP_COND =
	    1U | (uint32_t)HAL_MEMCARD_RESPONSE_R3 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD2 */
	CMD2_ALL_SEND_CID_MMC =
	    2U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD2_ALL_SEND_CID_SD =
	    2U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD3 */
	CMD3_SET_RELATIVE_ADDR =
	    3U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD3_SEND_RELATIVE_ADDR =
	    3U | (uint32_t)HAL_MEMCARD_RESPONSE_R6 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD4 */
	CMD4_SET_DSR =
	    4U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD5 */
	CMD5_SLEEP_AWAKE =
	    5U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD6 */
	CMD6_SWITCH =
	    6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD6_SWITCH_FUNC =
	    6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	ACMD6_SET_BUS_WIDTH =
	    6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,
	/* CMD7 */
	CMD7_SELECT_CARD =
	    7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD7(from Disconnected State to Programming State) */
	CMD7_SELECT_CARD_PROG =
	    7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD7_DESELECT_CARD =
	    7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD8 */
	CMD8_SEND_EXT_CSD =
	    8U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD8_SEND_IF_COND =
	    8U | (uint32_t)HAL_MEMCARD_RESPONSE_R7 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD9 */
	CMD9_SEND_CSD =
	    9U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD10 */
	CMD10_SEND_CID =
	    10U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD11 */
	CMD11_READ_DAT_UNTIL_STOP =
	    11U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD12 */
	CMD12_STOP_TRANSMISSION =
	    12U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD12(R1b : write case) */
	CMD12_STOP_TRANSMISSION_WRITE =
	    12U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD13 */
	CMD13_SEND_STATUS =
	    13U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	ACMD13_SD_STATUS =
	    13U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,
	/* CMD14 */
	CMD14_BUSTEST_R =
	    14U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD15 */
	CMD15_GO_INACTIVE_STATE =
	    15U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,

/* class 2 */
	/* CMD16 */
	CMD16_SET_BLOCKLEN =
	    16U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD17 */
	CMD17_READ_SINGLE_BLOCK =
	     17U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	     (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	     (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	     (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD18 */
	CMD18_READ_MULTIPLE_BLOCK =
	    18U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD19 */
	CMD19_BUS_TEST_W =
	    19U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,

/* class 3 */
	/* CMD20 */
	CMD20_WRITE_DAT_UNTIL_STOP =
	    20U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD21 */
	CMD21 = 21U,
	/* CMD22 */
	CMD22 = 22U,
	ACMD22_SEND_NUM_WR_BLOCKS =
	    22U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,

/* class 4 */
	/* CMD23 */
	CMD23_SET_BLOCK_COUNT =
	    23U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	ACMD23_SET_WR_BLK_ERASE_COUNT =
	    23U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,
	/* CMD24 */
	CMD24_WRITE_BLOCK =
	    24U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD25 */
	CMD25_WRITE_MULTIPLE_BLOCK =
	    25U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD26 */
	CMD26_PROGRAM_CID =
	    26U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD27 */
	CMD27_PROGRAM_CSD =
	    27U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,

/* class 6 */
	/* CMD28 */
	CMD28_SET_WRITE_PROT =
	    28U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD29 */
	CMD29_CLR_WRITE_PROT =
	    29U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD30 */
	CMD30_SEND_WRITE_PROT =
	    30U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD31 */
	CMD30_SEND_WRITE_PROT_TYPE =
	    31U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,

/* class 5 */
	/* CMD32 */
	CMD32_ERASE_WR_BLK_START =
	    32U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD33 */
	CMD33_ERASE_WR_BLK_END =
	    33U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD34 */
	CMD34 = 34U,
	/* CMD35 */
	CMD35_ERASE_GROUP_START =
	    35U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD36 */
	CMD36_ERASE_GROUP_END =
	    36U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD37 */
	CMD37 = 37U,
	/* CMD38 */
	CMD38_ERASE =
	    38U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,

/* class 9 */
	/* CMD39 */
	CMD39_FASTIO =
	    39U | (uint32_t)HAL_MEMCARD_RESPONSE_R4 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD40 */
	CMD40_GO_IRQSTATE =
	    40U | (uint32_t)HAL_MEMCARD_RESPONSE_R5 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD41 */
	CMD41 = 41,
	ACMD41_SD_SEND_OP_COND =
	     41U | (uint32_t)HAL_MEMCARD_RESPONSE_R3 |
	     (uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR |
	     (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	     (uint32_t)HAL_MEMCARD_COMMAND_APP,

/* class 7 */
	/* CMD42 */
	CMD42_LOCK_UNLOCK =
	    42U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	    (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	ACMD42_SET_CLR_CARD_DETECT =
	    42U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,
	CMD43 = 43U,		/* CMD43 */
	CMD44 = 44U,		/* CMD44 */
	CMD45 = 45U,		/* CMD45 */
	CMD46 = 46U,		/* CMD46 */
	CMD47 = 47U,		/* CMD47 */
	CMD48 = 48U,		/* CMD48 */
	CMD49 = 49U,		/* CMD49 */
	CMD50 = 50U,		/* CMD50 */
	CMD51 = 51U,		/* CMD51 */
	ACMD51_SEND_SCR =
	    51U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	    (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ |
	    (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD |
	    (uint32_t)HAL_MEMCARD_COMMAND_APP,
	CMD52 = 52U,		/* CMD52 */
	CMD53 = 53U,		/* CMD53 */
	CMD54 = 54U,		/* CMD54 */

/* class 8 */
	/* CMD55 */
	CMD55_APP_CMD =
	   55U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	   (uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC |
	   (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	   (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	/* CMD56 */
	CMD56_GEN_CMD =
	   56U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 |
	   (uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE |
	   (uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON |
	   (uint32_t)HAL_MEMCARD_COMMAND_NORMAL,
	CMD57 = 57U,		/* CMD57 */
	CMD58 = 58U,		/* CMD58 */
	CMD59 = 59U,		/* CMD59 */
	CMD60 = 60U,		/* CMD60 */
	CMD61 = 61U,		/* CMD61 */
	CMD62 = 62U,		/* CMD62 */
	CMD63 = 63U		/* CMD63 */
} HAL_MEMCARD_COMMAND;

/*
 * Configuration structure from HAL layer.
 *
 * If some field is not available it should be filled with 0xFF.
 * The API version is 32-bit unsigned integer telling the version of the API.
 * The integer is divided to four sections which each can be treated as a 8-bit
 * unsigned number:
 * Bits 31-24 make the most significant part of the version number. This number
 * starts from 1 i.e. the second version of the API will be 0x02xxxxxx. This
 * number changes only, if the API itself changes so much that it is not
 * compatible anymore with older releases.
 * Bits 23-16 API minor version number. For example API version 2.1 would be
 * 0x0201xxxx.
 * Bits 15-8 are the number of the year when release is done. The 0 is year
 * 2000, 1 is year 2001 and so on
 * Bits 7- are the week number when release is done. First full week of the
 * year is 1
 *
 * Example: let's assume that release 2.1 is done on week 10 year 2008
 * the version will get the value 0x0201080A
 */
typedef struct {
	/*
	 * Version of the chipset API implementation
	 *
	 * bits [31:24] API specification major version number.<br>
	 * bits [23:16] API specification minor version number.<br>
	 * bits [15:8] API implementation year. (2000 = 0, 2001 = 1, ...)
	 * bits [7:0] API implementation week.
	 * Example: API spec version 4.0, implementation w46 2008 => 0x0400082E
	 */
	uint32_t api_version;

	/* maximum block count which can be transferred at once */
	uint32_t max_block_count;

	/* maximum clock frequence in Hz supported by HW */
	uint32_t max_clock_freq;

	/* maximum data bus width supported by HW */
	uint16_t max_data_width;

	/* Is high-speed mode supported by HW (yes=1, no=0) */
	uint8_t hs_mode_supported;

	/* Is memory card removable (yes=1, no=0) */
	uint8_t card_removable;

} HAL_MEMCARD_HW_CONF;

/* Configuration structure to HAL layer. */
typedef struct {
	/* how many times to try after fail, for instance sending command */
	uint32_t retries_after_fail;
} HAL_MEMCARD_INIT_CONF;

#endif /* EMMC_HAL_H */