| 1 |
/* |
| 2 |
* Copyright (c) 2015-2020, Renesas Electronics Corporation. All rights reserved. |
| 3 |
* |
| 4 |
* SPDX-License-Identifier: BSD-3-Clause |
| 5 |
*/ |
| 6 |
|
| 7 |
#ifndef EMMC_HAL_H |
| 8 |
#define EMMC_HAL_H |
| 9 |
|
| 10 |
/* memory card error/status types */ |
| 11 |
#define HAL_MEMCARD_OUT_OF_RANGE 0x80000000L |
| 12 |
#define HAL_MEMCARD_ADDRESS_ERROR 0x40000000L |
| 13 |
#define HAL_MEMCARD_BLOCK_LEN_ERROR 0x20000000L |
| 14 |
#define HAL_MEMCARD_ERASE_SEQ_ERROR 0x10000000L |
| 15 |
#define HAL_MEMCARD_ERASE_PARAM 0x08000000L |
| 16 |
#define HAL_MEMCARD_WP_VIOLATION 0x04000000L |
| 17 |
#define HAL_MEMCARD_CARD_IS_LOCKED 0x02000000L |
| 18 |
#define HAL_MEMCARD_LOCK_UNLOCK_FAILED 0x01000000L |
| 19 |
#define HAL_MEMCARD_COM_CRC_ERROR 0x00800000L |
| 20 |
#define HAL_MEMCARD_ILEGAL_COMMAND 0x00400000L |
| 21 |
#define HAL_MEMCARD_CARD_ECC_FAILED 0x00200000L |
| 22 |
#define HAL_MEMCARD_CC_ERROR 0x00100000L |
| 23 |
#define HAL_MEMCARD_ERROR 0x00080000L |
| 24 |
#define HAL_MEMCARD_UNDERRUN 0x00040000L |
| 25 |
#define HAL_MEMCARD_OVERRUN 0x00020000L |
| 26 |
#define HAL_MEMCARD_CIDCSD_OVERWRITE 0x00010000L |
| 27 |
#define HAL_MEMCARD_WP_ERASE_SKIP 0x00008000L |
| 28 |
#define HAL_MEMCARD_CARD_ECC_DISABLED 0x00004000L |
| 29 |
#define HAL_MEMCARD_ERASE_RESET 0x00002000L |
| 30 |
#define HAL_MEMCARD_CARD_STATE 0x00001E00L |
| 31 |
#define HAL_MEMCARD_CARD_READY_FOR_DATA 0x00000100L |
| 32 |
#define HAL_MEMCARD_APP_CMD 0x00000020L |
| 33 |
#define HAL_MEMCARD_SWITCH_ERROR 0x00000080L |
| 34 |
#define HAL_MEMCARD_AKE_SEQ_ERROR 0x00000008L |
| 35 |
#define HAL_MEMCARD_NO_ERRORS 0x00000000L |
| 36 |
|
| 37 |
/* Memory card response types */ |
| 38 |
#define HAL_MEMCARD_COMMAND_INDEX_MASK 0x0003f |
| 39 |
|
| 40 |
/* Type of the return value. */ |
| 41 |
typedef enum { |
| 42 |
HAL_MEMCARD_FAIL = 0U, |
| 43 |
HAL_MEMCARD_OK = 1U, |
| 44 |
HAL_MEMCARD_DMA_ALLOC_FAIL = 2U, /* DMA channel allocation failed */ |
| 45 |
HAL_MEMCARD_DMA_TRANSFER_FAIL = 3U, /* DMA transfer failed */ |
| 46 |
HAL_MEMCARD_CARD_STATUS_ERROR = 4U, /* card status non-masked error */ |
| 47 |
HAL_MEMCARD_CMD_TIMEOUT = 5U, /* Command timeout occurred */ |
| 48 |
HAL_MEMCARD_DATA_TIMEOUT = 6U, /* Data timeout occurred */ |
| 49 |
HAL_MEMCARD_CMD_CRC_ERROR = 7U, /* Command CRC error occurred */ |
| 50 |
HAL_MEMCARD_DATA_CRC_ERROR = 8U /* Data CRC error occurred */ |
| 51 |
} HAL_MEMCARD_RETURN; |
| 52 |
|
| 53 |
/* memory access operation */ |
| 54 |
typedef enum { |
| 55 |
HAL_MEMCARD_READ = 0U, /* read */ |
| 56 |
HAL_MEMCARD_WRITE = 1U /* write */ |
| 57 |
} HAL_MEMCARD_OPERATION; |
| 58 |
|
| 59 |
/* Type of data width on memorycard bus */ |
| 60 |
typedef enum { |
| 61 |
HAL_MEMCARD_DATA_WIDTH_1_BIT = 0U, |
| 62 |
HAL_MEMCARD_DATA_WIDTH_4_BIT = 1U, |
| 63 |
HAL_MEMCARD_DATA_WIDTH_8_BIT = 2U |
| 64 |
} HAL_MEMCARD_DATA_WIDTH; /* data (bus) width types */ |
| 65 |
|
| 66 |
/* Presence of the memory card */ |
| 67 |
typedef enum { |
| 68 |
HAL_MEMCARD_CARD_IS_IN = 0U, |
| 69 |
HAL_MEMCARD_CARD_IS_OUT = 1U |
| 70 |
} HAL_MEMCARD_PRESENCE_STATUS; /* presence status of the memory card */ |
| 71 |
|
| 72 |
/* mode of data transfer */ |
| 73 |
typedef enum { |
| 74 |
HAL_MEMCARD_DMA = 0U, |
| 75 |
HAL_MEMCARD_NOT_DMA = 1U |
| 76 |
} HAL_MEMCARD_DATA_TRANSFER_MODE; |
| 77 |
|
| 78 |
/* Memory card response types. */ |
| 79 |
typedef enum hal_memcard_response_type { |
| 80 |
HAL_MEMCARD_RESPONSE_NONE = 0x00000U, |
| 81 |
HAL_MEMCARD_RESPONSE_R1 = 0x00100U, |
| 82 |
HAL_MEMCARD_RESPONSE_R1b = 0x00200U, |
| 83 |
HAL_MEMCARD_RESPONSE_R2 = 0x00300U, |
| 84 |
HAL_MEMCARD_RESPONSE_R3 = 0x00400U, |
| 85 |
HAL_MEMCARD_RESPONSE_R4 = 0x00500U, |
| 86 |
HAL_MEMCARD_RESPONSE_R5 = 0x00600U, |
| 87 |
HAL_MEMCARD_RESPONSE_R6 = 0x00700U, |
| 88 |
HAL_MEMCARD_RESPONSE_R7 = 0x00800U, |
| 89 |
HAL_MEMCARD_RESPONSE_TYPE_MASK = 0x00f00U |
| 90 |
} HAL_MEMCARD_RESPONSE_TYPE; |
| 91 |
|
| 92 |
/* Memory card command types. */ |
| 93 |
typedef enum hal_memcard_command_type { |
| 94 |
HAL_MEMCARD_COMMAND_TYPE_BC = 0x00000U, |
| 95 |
HAL_MEMCARD_COMMAND_TYPE_BCR = 0x01000U, |
| 96 |
HAL_MEMCARD_COMMAND_TYPE_AC = 0x02000U, |
| 97 |
HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE = 0x03000U, |
| 98 |
HAL_MEMCARD_COMMAND_TYPE_ADTC_READ = 0x04000U, |
| 99 |
HAL_MEMCARD_COMMAND_TYPE_MASK = 0x07000U |
| 100 |
} HAL_MEMCARD_COMMAND_TYPE; |
| 101 |
|
| 102 |
/* Type of memory card */ |
| 103 |
typedef enum hal_memcard_command_card_type { |
| 104 |
HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON = 0x00000U, |
| 105 |
HAL_MEMCARD_COMMAND_CARD_TYPE_MMC = 0x08000U, |
| 106 |
HAL_MEMCARD_COMMAND_CARD_TYPE_SD = 0x10000U, |
| 107 |
HAL_MEMCARD_COMMAND_CARD_TYPE_MASK = 0x18000U |
| 108 |
} HAL_MEMCARD_COMMAND_CARD_TYPE; |
| 109 |
|
| 110 |
/* Memory card application command. */ |
| 111 |
typedef enum hal_memcard_command_app_norm { |
| 112 |
HAL_MEMCARD_COMMAND_NORMAL = 0x00000U, |
| 113 |
HAL_MEMCARD_COMMAND_APP = 0x20000U, |
| 114 |
HAL_MEMCARD_COMMAND_APP_NORM_MASK = 0x20000U |
| 115 |
} HAL_MEMCARD_COMMAND_APP_NORM; |
| 116 |
|
| 117 |
/* Memory card command codes. */ |
| 118 |
typedef enum { |
| 119 |
/* class 0 and class 1 */ |
| 120 |
/* CMD0 */ |
| 121 |
CMD0_GO_IDLE_STATE = |
| 122 |
0U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE | |
| 123 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BC | |
| 124 |
(uint32_t) HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 125 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 126 |
/* CMD1 */ |
| 127 |
CMD1_SEND_OP_COND = |
| 128 |
1U | (uint32_t)HAL_MEMCARD_RESPONSE_R3 | |
| 129 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 130 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 131 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 132 |
/* CMD2 */ |
| 133 |
CMD2_ALL_SEND_CID_MMC = |
| 134 |
2U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 | |
| 135 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 136 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 137 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 138 |
CMD2_ALL_SEND_CID_SD = |
| 139 |
2U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 | |
| 140 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 141 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 142 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 143 |
/* CMD3 */ |
| 144 |
CMD3_SET_RELATIVE_ADDR = |
| 145 |
3U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 146 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 147 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 148 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 149 |
CMD3_SEND_RELATIVE_ADDR = |
| 150 |
3U | (uint32_t)HAL_MEMCARD_RESPONSE_R6 | |
| 151 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 152 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 153 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 154 |
/* CMD4 */ |
| 155 |
CMD4_SET_DSR = |
| 156 |
4U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE | |
| 157 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BC | |
| 158 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 159 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 160 |
/* CMD5 */ |
| 161 |
CMD5_SLEEP_AWAKE = |
| 162 |
5U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 163 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 164 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 165 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 166 |
/* CMD6 */ |
| 167 |
CMD6_SWITCH = |
| 168 |
6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 169 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 170 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 171 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 172 |
CMD6_SWITCH_FUNC = |
| 173 |
6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 174 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 175 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 176 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 177 |
ACMD6_SET_BUS_WIDTH = |
| 178 |
6U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 179 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 180 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 181 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 182 |
/* CMD7 */ |
| 183 |
CMD7_SELECT_CARD = |
| 184 |
7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 185 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 186 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 187 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 188 |
/* CMD7(from Disconnected State to Programming State) */ |
| 189 |
CMD7_SELECT_CARD_PROG = |
| 190 |
7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 191 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 192 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 193 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 194 |
CMD7_DESELECT_CARD = |
| 195 |
7U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 196 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 197 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 198 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 199 |
/* CMD8 */ |
| 200 |
CMD8_SEND_EXT_CSD = |
| 201 |
8U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 202 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 203 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 204 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 205 |
CMD8_SEND_IF_COND = |
| 206 |
8U | (uint32_t)HAL_MEMCARD_RESPONSE_R7 | |
| 207 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 208 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 209 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 210 |
/* CMD9 */ |
| 211 |
CMD9_SEND_CSD = |
| 212 |
9U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 | |
| 213 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 214 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 215 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 216 |
/* CMD10 */ |
| 217 |
CMD10_SEND_CID = |
| 218 |
10U | (uint32_t)HAL_MEMCARD_RESPONSE_R2 | |
| 219 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 220 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 221 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 222 |
/* CMD11 */ |
| 223 |
CMD11_READ_DAT_UNTIL_STOP = |
| 224 |
11U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 225 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 226 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 227 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 228 |
/* CMD12 */ |
| 229 |
CMD12_STOP_TRANSMISSION = |
| 230 |
12U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 231 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 232 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 233 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 234 |
/* CMD12(R1b : write case) */ |
| 235 |
CMD12_STOP_TRANSMISSION_WRITE = |
| 236 |
12U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 237 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 238 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 239 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 240 |
/* CMD13 */ |
| 241 |
CMD13_SEND_STATUS = |
| 242 |
13U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 243 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 244 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 245 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 246 |
ACMD13_SD_STATUS = |
| 247 |
13U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 248 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 249 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 250 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 251 |
/* CMD14 */ |
| 252 |
CMD14_BUSTEST_R = |
| 253 |
14U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 254 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 255 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 256 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 257 |
/* CMD15 */ |
| 258 |
CMD15_GO_INACTIVE_STATE = |
| 259 |
15U | (uint32_t)HAL_MEMCARD_RESPONSE_NONE | |
| 260 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 261 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 262 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 263 |
|
| 264 |
/* class 2 */ |
| 265 |
/* CMD16 */ |
| 266 |
CMD16_SET_BLOCKLEN = |
| 267 |
16U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 268 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 269 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 270 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 271 |
/* CMD17 */ |
| 272 |
CMD17_READ_SINGLE_BLOCK = |
| 273 |
17U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 274 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 275 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 276 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 277 |
/* CMD18 */ |
| 278 |
CMD18_READ_MULTIPLE_BLOCK = |
| 279 |
18U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 280 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 281 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 282 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 283 |
/* CMD19 */ |
| 284 |
CMD19_BUS_TEST_W = |
| 285 |
19U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 286 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 287 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 288 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 289 |
|
| 290 |
/* class 3 */ |
| 291 |
/* CMD20 */ |
| 292 |
CMD20_WRITE_DAT_UNTIL_STOP = |
| 293 |
20U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 294 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 295 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 296 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 297 |
/* CMD21 */ |
| 298 |
CMD21 = 21U, |
| 299 |
/* CMD22 */ |
| 300 |
CMD22 = 22U, |
| 301 |
ACMD22_SEND_NUM_WR_BLOCKS = |
| 302 |
22U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 303 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 304 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 305 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 306 |
|
| 307 |
/* class 4 */ |
| 308 |
/* CMD23 */ |
| 309 |
CMD23_SET_BLOCK_COUNT = |
| 310 |
23U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 311 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 312 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 313 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 314 |
ACMD23_SET_WR_BLK_ERASE_COUNT = |
| 315 |
23U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 316 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 317 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 318 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 319 |
/* CMD24 */ |
| 320 |
CMD24_WRITE_BLOCK = |
| 321 |
24U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 322 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 323 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 324 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 325 |
/* CMD25 */ |
| 326 |
CMD25_WRITE_MULTIPLE_BLOCK = |
| 327 |
25U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 328 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 329 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 330 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 331 |
/* CMD26 */ |
| 332 |
CMD26_PROGRAM_CID = |
| 333 |
26U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 334 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 335 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 336 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 337 |
/* CMD27 */ |
| 338 |
CMD27_PROGRAM_CSD = |
| 339 |
27U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 340 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 341 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 342 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 343 |
|
| 344 |
/* class 6 */ |
| 345 |
/* CMD28 */ |
| 346 |
CMD28_SET_WRITE_PROT = |
| 347 |
28U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 348 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 349 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 350 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 351 |
/* CMD29 */ |
| 352 |
CMD29_CLR_WRITE_PROT = |
| 353 |
29U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 354 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 355 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 356 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 357 |
/* CMD30 */ |
| 358 |
CMD30_SEND_WRITE_PROT = |
| 359 |
30U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 360 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 361 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 362 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 363 |
/* CMD31 */ |
| 364 |
CMD30_SEND_WRITE_PROT_TYPE = |
| 365 |
31U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 366 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 367 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 368 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 369 |
|
| 370 |
/* class 5 */ |
| 371 |
/* CMD32 */ |
| 372 |
CMD32_ERASE_WR_BLK_START = |
| 373 |
32U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 374 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 375 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 376 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 377 |
/* CMD33 */ |
| 378 |
CMD33_ERASE_WR_BLK_END = |
| 379 |
33U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 380 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 381 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 382 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 383 |
/* CMD34 */ |
| 384 |
CMD34 = 34U, |
| 385 |
/* CMD35 */ |
| 386 |
CMD35_ERASE_GROUP_START = |
| 387 |
35U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 388 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 389 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 390 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 391 |
/* CMD36 */ |
| 392 |
CMD36_ERASE_GROUP_END = |
| 393 |
36U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 394 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 395 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 396 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 397 |
/* CMD37 */ |
| 398 |
CMD37 = 37U, |
| 399 |
/* CMD38 */ |
| 400 |
CMD38_ERASE = |
| 401 |
38U | (uint32_t)HAL_MEMCARD_RESPONSE_R1b | |
| 402 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 403 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 404 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 405 |
|
| 406 |
/* class 9 */ |
| 407 |
/* CMD39 */ |
| 408 |
CMD39_FASTIO = |
| 409 |
39U | (uint32_t)HAL_MEMCARD_RESPONSE_R4 | |
| 410 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 411 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 412 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 413 |
/* CMD40 */ |
| 414 |
CMD40_GO_IRQSTATE = |
| 415 |
40U | (uint32_t)HAL_MEMCARD_RESPONSE_R5 | |
| 416 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 417 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_MMC | |
| 418 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 419 |
/* CMD41 */ |
| 420 |
CMD41 = 41, |
| 421 |
ACMD41_SD_SEND_OP_COND = |
| 422 |
41U | (uint32_t)HAL_MEMCARD_RESPONSE_R3 | |
| 423 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_BCR | |
| 424 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 425 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 426 |
|
| 427 |
/* class 7 */ |
| 428 |
/* CMD42 */ |
| 429 |
CMD42_LOCK_UNLOCK = |
| 430 |
42U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 431 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 432 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 433 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 434 |
ACMD42_SET_CLR_CARD_DETECT = |
| 435 |
42U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 436 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 437 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 438 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 439 |
CMD43 = 43U, /* CMD43 */ |
| 440 |
CMD44 = 44U, /* CMD44 */ |
| 441 |
CMD45 = 45U, /* CMD45 */ |
| 442 |
CMD46 = 46U, /* CMD46 */ |
| 443 |
CMD47 = 47U, /* CMD47 */ |
| 444 |
CMD48 = 48U, /* CMD48 */ |
| 445 |
CMD49 = 49U, /* CMD49 */ |
| 446 |
CMD50 = 50U, /* CMD50 */ |
| 447 |
CMD51 = 51U, /* CMD51 */ |
| 448 |
ACMD51_SEND_SCR = |
| 449 |
51U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 450 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_READ | |
| 451 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_SD | |
| 452 |
(uint32_t)HAL_MEMCARD_COMMAND_APP, |
| 453 |
CMD52 = 52U, /* CMD52 */ |
| 454 |
CMD53 = 53U, /* CMD53 */ |
| 455 |
CMD54 = 54U, /* CMD54 */ |
| 456 |
|
| 457 |
/* class 8 */ |
| 458 |
/* CMD55 */ |
| 459 |
CMD55_APP_CMD = |
| 460 |
55U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 461 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_AC | |
| 462 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 463 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 464 |
/* CMD56 */ |
| 465 |
CMD56_GEN_CMD = |
| 466 |
56U | (uint32_t)HAL_MEMCARD_RESPONSE_R1 | |
| 467 |
(uint32_t)HAL_MEMCARD_COMMAND_TYPE_ADTC_WRITE | |
| 468 |
(uint32_t)HAL_MEMCARD_COMMAND_CARD_TYPE_COMMON | |
| 469 |
(uint32_t)HAL_MEMCARD_COMMAND_NORMAL, |
| 470 |
CMD57 = 57U, /* CMD57 */ |
| 471 |
CMD58 = 58U, /* CMD58 */ |
| 472 |
CMD59 = 59U, /* CMD59 */ |
| 473 |
CMD60 = 60U, /* CMD60 */ |
| 474 |
CMD61 = 61U, /* CMD61 */ |
| 475 |
CMD62 = 62U, /* CMD62 */ |
| 476 |
CMD63 = 63U /* CMD63 */ |
| 477 |
} HAL_MEMCARD_COMMAND; |
| 478 |
|
| 479 |
/* |
| 480 |
* Configuration structure from HAL layer. |
| 481 |
* |
| 482 |
* If some field is not available it should be filled with 0xFF. |
| 483 |
* The API version is 32-bit unsigned integer telling the version of the API. |
| 484 |
* The integer is divided to four sections which each can be treated as a 8-bit |
| 485 |
* unsigned number: |
| 486 |
* Bits 31-24 make the most significant part of the version number. This number |
| 487 |
* starts from 1 i.e. the second version of the API will be 0x02xxxxxx. This |
| 488 |
* number changes only, if the API itself changes so much that it is not |
| 489 |
* compatible anymore with older releases. |
| 490 |
* Bits 23-16 API minor version number. For example API version 2.1 would be |
| 491 |
* 0x0201xxxx. |
| 492 |
* Bits 15-8 are the number of the year when release is done. The 0 is year |
| 493 |
* 2000, 1 is year 2001 and so on |
| 494 |
* Bits 7- are the week number when release is done. First full week of the |
| 495 |
* year is 1 |
| 496 |
* |
| 497 |
* Example: let's assume that release 2.1 is done on week 10 year 2008 |
| 498 |
* the version will get the value 0x0201080A |
| 499 |
*/ |
| 500 |
typedef struct { |
| 501 |
/* |
| 502 |
* Version of the chipset API implementation |
| 503 |
* |
| 504 |
* bits [31:24] API specification major version number.<br> |
| 505 |
* bits [23:16] API specification minor version number.<br> |
| 506 |
* bits [15:8] API implementation year. (2000 = 0, 2001 = 1, ...) |
| 507 |
* bits [7:0] API implementation week. |
| 508 |
* Example: API spec version 4.0, implementation w46 2008 => 0x0400082E |
| 509 |
*/ |
| 510 |
uint32_t api_version; |
| 511 |
|
| 512 |
/* maximum block count which can be transferred at once */ |
| 513 |
uint32_t max_block_count; |
| 514 |
|
| 515 |
/* maximum clock frequency in Hz supported by HW */ |
| 516 |
uint32_t max_clock_freq; |
| 517 |
|
| 518 |
/* maximum data bus width supported by HW */ |
| 519 |
uint16_t max_data_width; |
| 520 |
|
| 521 |
/* Is high-speed mode supported by HW (yes=1, no=0) */ |
| 522 |
uint8_t hs_mode_supported; |
| 523 |
|
| 524 |
/* Is memory card removable (yes=1, no=0) */ |
| 525 |
uint8_t card_removable; |
| 526 |
|
| 527 |
} HAL_MEMCARD_HW_CONF; |
| 528 |
|
| 529 |
/* Configuration structure to HAL layer. */ |
| 530 |
typedef struct { |
| 531 |
/* how many times to try after fail, for instance sending command */ |
| 532 |
uint32_t retries_after_fail; |
| 533 |
} HAL_MEMCARD_INIT_CONF; |
| 534 |
|
| 535 |
#endif /* EMMC_HAL_H */ |