1 /* 2 * linux/drivers/mmc/core/sd.c 3 * 4 * Copyright (C) 2003-2004 Russell King, All Rights Reserved. 5 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved. 6 * Copyright (C) 2005-2007 Pierre Ossman, All Rights Reserved. 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License version 2 as 10 * published by the Free Software Foundation. 11 */ 12 13 #include <linux/err.h> 14 #include <linux/sizes.h> 15 #include <linux/slab.h> 16 #include <linux/stat.h> 17 #include <linux/pm_runtime.h> 18 19 #include <linux/mmc/host.h> 20 #include <linux/mmc/card.h> 21 #include <linux/mmc/mmc.h> 22 #include <linux/mmc/sd.h> 23 24 #include "core.h" 25 #include "bus.h" 26 #include "mmc_ops.h" 27 #include "sd.h" 28 #include "sd_ops.h" 29 30 static const unsigned int tran_exp[] = { 31 10000, 100000, 1000000, 10000000, 32 0, 0, 0, 0 33 }; 34 35 static const unsigned char tran_mant[] = { 36 0, 10, 12, 13, 15, 20, 25, 30, 37 35, 40, 45, 50, 55, 60, 70, 80, 38 }; 39 40 static const unsigned int tacc_exp[] = { 41 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000, 42 }; 43 44 static const unsigned int tacc_mant[] = { 45 0, 10, 12, 13, 15, 20, 25, 30, 46 35, 40, 45, 50, 55, 60, 70, 80, 47 }; 48 49 static const unsigned int sd_au_size[] = { 50 0, SZ_16K / 512, SZ_32K / 512, SZ_64K / 512, 51 SZ_128K / 512, SZ_256K / 512, SZ_512K / 512, SZ_1M / 512, 52 SZ_2M / 512, SZ_4M / 512, SZ_8M / 512, (SZ_8M + SZ_4M) / 512, 53 SZ_16M / 512, (SZ_16M + SZ_8M) / 512, SZ_32M / 512, SZ_64M / 512, 54 }; 55 56 #define UNSTUFF_BITS(resp,start,size) \ 57 ({ \ 58 const int __size = size; \ 59 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \ 60 const int __off = 3 - ((start) / 32); \ 61 const int __shft = (start) & 31; \ 62 u32 __res; \ 63 \ 64 __res = resp[__off] >> __shft; \ 65 if (__size + __shft > 32) \ 66 __res |= resp[__off-1] << ((32 - __shft) % 32); \ 67 __res & __mask; \ 68 }) 69 70 /* 71 * Given the decoded CSD structure, decode the raw CID to our CID structure. 72 */ 73 void mmc_decode_cid(struct mmc_card *card) 74 { 75 u32 *resp = card->raw_cid; 76 77 memset(&card->cid, 0, sizeof(struct mmc_cid)); 78 79 /* 80 * SD doesn't currently have a version field so we will 81 * have to assume we can parse this. 82 */ 83 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8); 84 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16); 85 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8); 86 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8); 87 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8); 88 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8); 89 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8); 90 card->cid.hwrev = UNSTUFF_BITS(resp, 60, 4); 91 card->cid.fwrev = UNSTUFF_BITS(resp, 56, 4); 92 card->cid.serial = UNSTUFF_BITS(resp, 24, 32); 93 card->cid.year = UNSTUFF_BITS(resp, 12, 8); 94 card->cid.month = UNSTUFF_BITS(resp, 8, 4); 95 96 card->cid.year += 2000; /* SD cards year offset */ 97 } 98 99 /* 100 * Given a 128-bit response, decode to our card CSD structure. 101 */ 102 static int mmc_decode_csd(struct mmc_card *card) 103 { 104 struct mmc_csd *csd = &card->csd; 105 unsigned int e, m, csd_struct; 106 u32 *resp = card->raw_csd; 107 108 csd_struct = UNSTUFF_BITS(resp, 126, 2); 109 110 switch (csd_struct) { 111 case 0: 112 m = UNSTUFF_BITS(resp, 115, 4); 113 e = UNSTUFF_BITS(resp, 112, 3); 114 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10; 115 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100; 116 117 m = UNSTUFF_BITS(resp, 99, 4); 118 e = UNSTUFF_BITS(resp, 96, 3); 119 csd->max_dtr = tran_exp[e] * tran_mant[m]; 120 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12); 121 122 e = UNSTUFF_BITS(resp, 47, 3); 123 m = UNSTUFF_BITS(resp, 62, 12); 124 csd->capacity = (1 + m) << (e + 2); 125 126 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4); 127 csd->read_partial = UNSTUFF_BITS(resp, 79, 1); 128 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1); 129 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1); 130 csd->dsr_imp = UNSTUFF_BITS(resp, 76, 1); 131 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3); 132 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4); 133 csd->write_partial = UNSTUFF_BITS(resp, 21, 1); 134 135 if (UNSTUFF_BITS(resp, 46, 1)) { 136 csd->erase_size = 1; 137 } else if (csd->write_blkbits >= 9) { 138 csd->erase_size = UNSTUFF_BITS(resp, 39, 7) + 1; 139 csd->erase_size <<= csd->write_blkbits - 9; 140 } 141 break; 142 case 1: 143 /* 144 * This is a block-addressed SDHC or SDXC card. Most 145 * interesting fields are unused and have fixed 146 * values. To avoid getting tripped by buggy cards, 147 * we assume those fixed values ourselves. 148 */ 149 mmc_card_set_blockaddr(card); 150 151 csd->tacc_ns = 0; /* Unused */ 152 csd->tacc_clks = 0; /* Unused */ 153 154 m = UNSTUFF_BITS(resp, 99, 4); 155 e = UNSTUFF_BITS(resp, 96, 3); 156 csd->max_dtr = tran_exp[e] * tran_mant[m]; 157 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12); 158 csd->c_size = UNSTUFF_BITS(resp, 48, 22); 159 160 /* SDXC cards have a minimum C_SIZE of 0x00FFFF */ 161 if (csd->c_size >= 0xFFFF) 162 mmc_card_set_ext_capacity(card); 163 164 m = UNSTUFF_BITS(resp, 48, 22); 165 csd->capacity = (1 + m) << 10; 166 167 csd->read_blkbits = 9; 168 csd->read_partial = 0; 169 csd->write_misalign = 0; 170 csd->read_misalign = 0; 171 csd->r2w_factor = 4; /* Unused */ 172 csd->write_blkbits = 9; 173 csd->write_partial = 0; 174 csd->erase_size = 1; 175 break; 176 default: 177 pr_err("%s: unrecognised CSD structure version %d\n", 178 mmc_hostname(card->host), csd_struct); 179 return -EINVAL; 180 } 181 182 card->erase_size = csd->erase_size; 183 184 return 0; 185 } 186 187 /* 188 * Given a 64-bit response, decode to our card SCR structure. 189 */ 190 static int mmc_decode_scr(struct mmc_card *card) 191 { 192 struct sd_scr *scr = &card->scr; 193 unsigned int scr_struct; 194 u32 resp[4]; 195 196 resp[3] = card->raw_scr[1]; 197 resp[2] = card->raw_scr[0]; 198 199 scr_struct = UNSTUFF_BITS(resp, 60, 4); 200 if (scr_struct != 0) { 201 pr_err("%s: unrecognised SCR structure version %d\n", 202 mmc_hostname(card->host), scr_struct); 203 return -EINVAL; 204 } 205 206 scr->sda_vsn = UNSTUFF_BITS(resp, 56, 4); 207 scr->bus_widths = UNSTUFF_BITS(resp, 48, 4); 208 if (scr->sda_vsn == SCR_SPEC_VER_2) 209 /* Check if Physical Layer Spec v3.0 is supported */ 210 scr->sda_spec3 = UNSTUFF_BITS(resp, 47, 1); 211 212 if (UNSTUFF_BITS(resp, 55, 1)) 213 card->erased_byte = 0xFF; 214 else 215 card->erased_byte = 0x0; 216 217 if (scr->sda_spec3) 218 scr->cmds = UNSTUFF_BITS(resp, 32, 2); 219 return 0; 220 } 221 222 /* 223 * Fetch and process SD Status register. 224 */ 225 static int mmc_read_ssr(struct mmc_card *card) 226 { 227 unsigned int au, es, et, eo; 228 int err, i; 229 u32 *ssr; 230 231 if (!(card->csd.cmdclass & CCC_APP_SPEC)) { 232 pr_warn("%s: card lacks mandatory SD Status function\n", 233 mmc_hostname(card->host)); 234 return 0; 235 } 236 237 ssr = kmalloc(64, GFP_KERNEL); 238 if (!ssr) 239 return -ENOMEM; 240 241 err = mmc_app_sd_status(card, ssr); 242 if (err) { 243 pr_warn("%s: problem reading SD Status register\n", 244 mmc_hostname(card->host)); 245 err = 0; 246 goto out; 247 } 248 249 for (i = 0; i < 16; i++) 250 ssr[i] = be32_to_cpu(ssr[i]); 251 252 /* 253 * UNSTUFF_BITS only works with four u32s so we have to offset the 254 * bitfield positions accordingly. 255 */ 256 au = UNSTUFF_BITS(ssr, 428 - 384, 4); 257 if (au) { 258 if (au <= 9 || card->scr.sda_spec3) { 259 card->ssr.au = sd_au_size[au]; 260 es = UNSTUFF_BITS(ssr, 408 - 384, 16); 261 et = UNSTUFF_BITS(ssr, 402 - 384, 6); 262 if (es && et) { 263 eo = UNSTUFF_BITS(ssr, 400 - 384, 2); 264 card->ssr.erase_timeout = (et * 1000) / es; 265 card->ssr.erase_offset = eo * 1000; 266 } 267 } else { 268 pr_warn("%s: SD Status: Invalid Allocation Unit size\n", 269 mmc_hostname(card->host)); 270 } 271 } 272 out: 273 kfree(ssr); 274 return err; 275 } 276 277 /* 278 * Fetches and decodes switch information 279 */ 280 static int mmc_read_switch(struct mmc_card *card) 281 { 282 int err; 283 u8 *status; 284 285 if (card->scr.sda_vsn < SCR_SPEC_VER_1) 286 return 0; 287 288 if (!(card->csd.cmdclass & CCC_SWITCH)) { 289 pr_warn("%s: card lacks mandatory switch function, performance might suffer\n", 290 mmc_hostname(card->host)); 291 return 0; 292 } 293 294 err = -EIO; 295 296 status = kmalloc(64, GFP_KERNEL); 297 if (!status) { 298 pr_err("%s: could not allocate a buffer for " 299 "switch capabilities.\n", 300 mmc_hostname(card->host)); 301 return -ENOMEM; 302 } 303 304 /* 305 * Find out the card's support bits with a mode 0 operation. 306 * The argument does not matter, as the support bits do not 307 * change with the arguments. 308 */ 309 err = mmc_sd_switch(card, 0, 0, 0, status); 310 if (err) { 311 /* 312 * If the host or the card can't do the switch, 313 * fail more gracefully. 314 */ 315 if (err != -EINVAL && err != -ENOSYS && err != -EFAULT) 316 goto out; 317 318 pr_warn("%s: problem reading Bus Speed modes\n", 319 mmc_hostname(card->host)); 320 err = 0; 321 322 goto out; 323 } 324 325 if (status[13] & SD_MODE_HIGH_SPEED) 326 card->sw_caps.hs_max_dtr = HIGH_SPEED_MAX_DTR; 327 328 if (card->scr.sda_spec3) { 329 card->sw_caps.sd3_bus_mode = status[13]; 330 /* Driver Strengths supported by the card */ 331 card->sw_caps.sd3_drv_type = status[9]; 332 } 333 334 out: 335 kfree(status); 336 337 return err; 338 } 339 340 /* 341 * Test if the card supports high-speed mode and, if so, switch to it. 342 */ 343 int mmc_sd_switch_hs(struct mmc_card *card) 344 { 345 int err; 346 u8 *status; 347 348 if (card->scr.sda_vsn < SCR_SPEC_VER_1) 349 return 0; 350 351 if (!(card->csd.cmdclass & CCC_SWITCH)) 352 return 0; 353 354 if (!(card->host->caps & MMC_CAP_SD_HIGHSPEED)) 355 return 0; 356 357 if (card->sw_caps.hs_max_dtr == 0) 358 return 0; 359 360 err = -EIO; 361 362 status = kmalloc(64, GFP_KERNEL); 363 if (!status) { 364 pr_err("%s: could not allocate a buffer for " 365 "switch capabilities.\n", mmc_hostname(card->host)); 366 return -ENOMEM; 367 } 368 369 err = mmc_sd_switch(card, 1, 0, 1, status); 370 if (err) 371 goto out; 372 373 if ((status[16] & 0xF) != 1) { 374 pr_warn("%s: Problem switching card into high-speed mode!\n", 375 mmc_hostname(card->host)); 376 err = 0; 377 } else { 378 err = 1; 379 } 380 381 out: 382 kfree(status); 383 384 return err; 385 } 386 387 static int sd_select_driver_type(struct mmc_card *card, u8 *status) 388 { 389 int card_drv_type, drive_strength, drv_type; 390 int err; 391 392 card->drive_strength = 0; 393 394 card_drv_type = card->sw_caps.sd3_drv_type | SD_DRIVER_TYPE_B; 395 396 drive_strength = mmc_select_drive_strength(card, 397 card->sw_caps.uhs_max_dtr, 398 card_drv_type, &drv_type); 399 400 if (drive_strength) { 401 err = mmc_sd_switch(card, 1, 2, drive_strength, status); 402 if (err) 403 return err; 404 if ((status[15] & 0xF) != drive_strength) { 405 pr_warn("%s: Problem setting drive strength!\n", 406 mmc_hostname(card->host)); 407 return 0; 408 } 409 card->drive_strength = drive_strength; 410 } 411 412 if (drv_type) 413 mmc_set_driver_type(card->host, drv_type); 414 415 return 0; 416 } 417 418 static void sd_update_bus_speed_mode(struct mmc_card *card) 419 { 420 /* 421 * If the host doesn't support any of the UHS-I modes, fallback on 422 * default speed. 423 */ 424 if (!mmc_host_uhs(card->host)) { 425 card->sd_bus_speed = 0; 426 return; 427 } 428 429 if ((card->host->caps & MMC_CAP_UHS_SDR104) && 430 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR104)) { 431 card->sd_bus_speed = UHS_SDR104_BUS_SPEED; 432 } else if ((card->host->caps & MMC_CAP_UHS_DDR50) && 433 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_DDR50)) { 434 card->sd_bus_speed = UHS_DDR50_BUS_SPEED; 435 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 | 436 MMC_CAP_UHS_SDR50)) && (card->sw_caps.sd3_bus_mode & 437 SD_MODE_UHS_SDR50)) { 438 card->sd_bus_speed = UHS_SDR50_BUS_SPEED; 439 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 | 440 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25)) && 441 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR25)) { 442 card->sd_bus_speed = UHS_SDR25_BUS_SPEED; 443 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 | 444 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25 | 445 MMC_CAP_UHS_SDR12)) && (card->sw_caps.sd3_bus_mode & 446 SD_MODE_UHS_SDR12)) { 447 card->sd_bus_speed = UHS_SDR12_BUS_SPEED; 448 } 449 } 450 451 static int sd_set_bus_speed_mode(struct mmc_card *card, u8 *status) 452 { 453 int err; 454 unsigned int timing = 0; 455 456 switch (card->sd_bus_speed) { 457 case UHS_SDR104_BUS_SPEED: 458 timing = MMC_TIMING_UHS_SDR104; 459 card->sw_caps.uhs_max_dtr = UHS_SDR104_MAX_DTR; 460 break; 461 case UHS_DDR50_BUS_SPEED: 462 timing = MMC_TIMING_UHS_DDR50; 463 card->sw_caps.uhs_max_dtr = UHS_DDR50_MAX_DTR; 464 break; 465 case UHS_SDR50_BUS_SPEED: 466 timing = MMC_TIMING_UHS_SDR50; 467 card->sw_caps.uhs_max_dtr = UHS_SDR50_MAX_DTR; 468 break; 469 case UHS_SDR25_BUS_SPEED: 470 timing = MMC_TIMING_UHS_SDR25; 471 card->sw_caps.uhs_max_dtr = UHS_SDR25_MAX_DTR; 472 break; 473 case UHS_SDR12_BUS_SPEED: 474 timing = MMC_TIMING_UHS_SDR12; 475 card->sw_caps.uhs_max_dtr = UHS_SDR12_MAX_DTR; 476 break; 477 default: 478 return 0; 479 } 480 481 err = mmc_sd_switch(card, 1, 0, card->sd_bus_speed, status); 482 if (err) 483 return err; 484 485 if ((status[16] & 0xF) != card->sd_bus_speed) 486 pr_warn("%s: Problem setting bus speed mode!\n", 487 mmc_hostname(card->host)); 488 else { 489 mmc_set_timing(card->host, timing); 490 mmc_set_clock(card->host, card->sw_caps.uhs_max_dtr); 491 } 492 493 return 0; 494 } 495 496 /* Get host's max current setting at its current voltage */ 497 static u32 sd_get_host_max_current(struct mmc_host *host) 498 { 499 u32 voltage, max_current; 500 501 voltage = 1 << host->ios.vdd; 502 switch (voltage) { 503 case MMC_VDD_165_195: 504 max_current = host->max_current_180; 505 break; 506 case MMC_VDD_29_30: 507 case MMC_VDD_30_31: 508 max_current = host->max_current_300; 509 break; 510 case MMC_VDD_32_33: 511 case MMC_VDD_33_34: 512 max_current = host->max_current_330; 513 break; 514 default: 515 max_current = 0; 516 } 517 518 return max_current; 519 } 520 521 static int sd_set_current_limit(struct mmc_card *card, u8 *status) 522 { 523 int current_limit = SD_SET_CURRENT_NO_CHANGE; 524 int err; 525 u32 max_current; 526 527 /* 528 * Current limit switch is only defined for SDR50, SDR104, and DDR50 529 * bus speed modes. For other bus speed modes, we do not change the 530 * current limit. 531 */ 532 if ((card->sd_bus_speed != UHS_SDR50_BUS_SPEED) && 533 (card->sd_bus_speed != UHS_SDR104_BUS_SPEED) && 534 (card->sd_bus_speed != UHS_DDR50_BUS_SPEED)) 535 return 0; 536 537 /* 538 * Host has different current capabilities when operating at 539 * different voltages, so find out its max current first. 540 */ 541 max_current = sd_get_host_max_current(card->host); 542 543 /* 544 * We only check host's capability here, if we set a limit that is 545 * higher than the card's maximum current, the card will be using its 546 * maximum current, e.g. if the card's maximum current is 300ma, and 547 * when we set current limit to 200ma, the card will draw 200ma, and 548 * when we set current limit to 400/600/800ma, the card will draw its 549 * maximum 300ma from the host. 550 */ 551 if (max_current >= 800) 552 current_limit = SD_SET_CURRENT_LIMIT_800; 553 else if (max_current >= 600) 554 current_limit = SD_SET_CURRENT_LIMIT_600; 555 else if (max_current >= 400) 556 current_limit = SD_SET_CURRENT_LIMIT_400; 557 else if (max_current >= 200) 558 current_limit = SD_SET_CURRENT_LIMIT_200; 559 560 if (current_limit != SD_SET_CURRENT_NO_CHANGE) { 561 err = mmc_sd_switch(card, 1, 3, current_limit, status); 562 if (err) 563 return err; 564 565 if (((status[15] >> 4) & 0x0F) != current_limit) 566 pr_warn("%s: Problem setting current limit!\n", 567 mmc_hostname(card->host)); 568 569 } 570 571 return 0; 572 } 573 574 /* 575 * UHS-I specific initialization procedure 576 */ 577 static int mmc_sd_init_uhs_card(struct mmc_card *card) 578 { 579 int err; 580 u8 *status; 581 582 if (!card->scr.sda_spec3) 583 return 0; 584 585 if (!(card->csd.cmdclass & CCC_SWITCH)) 586 return 0; 587 588 status = kmalloc(64, GFP_KERNEL); 589 if (!status) { 590 pr_err("%s: could not allocate a buffer for " 591 "switch capabilities.\n", mmc_hostname(card->host)); 592 return -ENOMEM; 593 } 594 595 /* Set 4-bit bus width */ 596 if ((card->host->caps & MMC_CAP_4_BIT_DATA) && 597 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) { 598 err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4); 599 if (err) 600 goto out; 601 602 mmc_set_bus_width(card->host, MMC_BUS_WIDTH_4); 603 } 604 605 /* 606 * Select the bus speed mode depending on host 607 * and card capability. 608 */ 609 sd_update_bus_speed_mode(card); 610 611 /* Set the driver strength for the card */ 612 err = sd_select_driver_type(card, status); 613 if (err) 614 goto out; 615 616 /* Set current limit for the card */ 617 err = sd_set_current_limit(card, status); 618 if (err) 619 goto out; 620 621 /* Set bus speed mode of the card */ 622 err = sd_set_bus_speed_mode(card, status); 623 if (err) 624 goto out; 625 626 /* 627 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and 628 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104. 629 */ 630 if (!mmc_host_is_spi(card->host) && 631 (card->sd_bus_speed == UHS_SDR50_BUS_SPEED || 632 card->sd_bus_speed == UHS_SDR104_BUS_SPEED)) 633 err = mmc_execute_tuning(card); 634 out: 635 kfree(status); 636 637 return err; 638 } 639 640 MMC_DEV_ATTR(cid, "%08x%08x%08x%08x\n", card->raw_cid[0], card->raw_cid[1], 641 card->raw_cid[2], card->raw_cid[3]); 642 MMC_DEV_ATTR(csd, "%08x%08x%08x%08x\n", card->raw_csd[0], card->raw_csd[1], 643 card->raw_csd[2], card->raw_csd[3]); 644 MMC_DEV_ATTR(scr, "%08x%08x\n", card->raw_scr[0], card->raw_scr[1]); 645 MMC_DEV_ATTR(date, "%02d/%04d\n", card->cid.month, card->cid.year); 646 MMC_DEV_ATTR(erase_size, "%u\n", card->erase_size << 9); 647 MMC_DEV_ATTR(preferred_erase_size, "%u\n", card->pref_erase << 9); 648 MMC_DEV_ATTR(fwrev, "0x%x\n", card->cid.fwrev); 649 MMC_DEV_ATTR(hwrev, "0x%x\n", card->cid.hwrev); 650 MMC_DEV_ATTR(manfid, "0x%06x\n", card->cid.manfid); 651 MMC_DEV_ATTR(name, "%s\n", card->cid.prod_name); 652 MMC_DEV_ATTR(oemid, "0x%04x\n", card->cid.oemid); 653 MMC_DEV_ATTR(serial, "0x%08x\n", card->cid.serial); 654 655 656 static struct attribute *sd_std_attrs[] = { 657 &dev_attr_cid.attr, 658 &dev_attr_csd.attr, 659 &dev_attr_scr.attr, 660 &dev_attr_date.attr, 661 &dev_attr_erase_size.attr, 662 &dev_attr_preferred_erase_size.attr, 663 &dev_attr_fwrev.attr, 664 &dev_attr_hwrev.attr, 665 &dev_attr_manfid.attr, 666 &dev_attr_name.attr, 667 &dev_attr_oemid.attr, 668 &dev_attr_serial.attr, 669 NULL, 670 }; 671 ATTRIBUTE_GROUPS(sd_std); 672 673 struct device_type sd_type = { 674 .groups = sd_std_groups, 675 }; 676 677 /* 678 * Fetch CID from card. 679 */ 680 int mmc_sd_get_cid(struct mmc_host *host, u32 ocr, u32 *cid, u32 *rocr) 681 { 682 int err; 683 u32 max_current; 684 int retries = 10; 685 u32 pocr = ocr; 686 687 try_again: 688 if (!retries) { 689 ocr &= ~SD_OCR_S18R; 690 pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host)); 691 } 692 693 /* 694 * Since we're changing the OCR value, we seem to 695 * need to tell some cards to go back to the idle 696 * state. We wait 1ms to give cards time to 697 * respond. 698 */ 699 mmc_go_idle(host); 700 701 /* 702 * If SD_SEND_IF_COND indicates an SD 2.0 703 * compliant card and we should set bit 30 704 * of the ocr to indicate that we can handle 705 * block-addressed SDHC cards. 706 */ 707 err = mmc_send_if_cond(host, ocr); 708 if (!err) 709 ocr |= SD_OCR_CCS; 710 711 /* 712 * If the host supports one of UHS-I modes, request the card 713 * to switch to 1.8V signaling level. If the card has failed 714 * repeatedly to switch however, skip this. 715 */ 716 if (retries && mmc_host_uhs(host)) 717 ocr |= SD_OCR_S18R; 718 719 /* 720 * If the host can supply more than 150mA at current voltage, 721 * XPC should be set to 1. 722 */ 723 max_current = sd_get_host_max_current(host); 724 if (max_current > 150) 725 ocr |= SD_OCR_XPC; 726 727 err = mmc_send_app_op_cond(host, ocr, rocr); 728 if (err) 729 return err; 730 731 /* 732 * In case CCS and S18A in the response is set, start Signal Voltage 733 * Switch procedure. SPI mode doesn't support CMD11. 734 */ 735 if (!mmc_host_is_spi(host) && rocr && 736 ((*rocr & 0x41000000) == 0x41000000)) { 737 err = mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_180, 738 pocr); 739 if (err == -EAGAIN) { 740 retries--; 741 goto try_again; 742 } else if (err) { 743 retries = 0; 744 goto try_again; 745 } 746 } 747 748 if (mmc_host_is_spi(host)) 749 err = mmc_send_cid(host, cid); 750 else 751 err = mmc_all_send_cid(host, cid); 752 753 return err; 754 } 755 756 int mmc_sd_get_csd(struct mmc_host *host, struct mmc_card *card) 757 { 758 int err; 759 760 /* 761 * Fetch CSD from card. 762 */ 763 err = mmc_send_csd(card, card->raw_csd); 764 if (err) 765 return err; 766 767 err = mmc_decode_csd(card); 768 if (err) 769 return err; 770 771 return 0; 772 } 773 774 static int mmc_sd_get_ro(struct mmc_host *host) 775 { 776 int ro; 777 778 /* 779 * Some systems don't feature a write-protect pin and don't need one. 780 * E.g. because they only have micro-SD card slot. For those systems 781 * assume that the SD card is always read-write. 782 */ 783 if (host->caps2 & MMC_CAP2_NO_WRITE_PROTECT) 784 return 0; 785 786 if (!host->ops->get_ro) 787 return -1; 788 789 mmc_host_clk_hold(host); 790 ro = host->ops->get_ro(host); 791 mmc_host_clk_release(host); 792 793 return ro; 794 } 795 796 int mmc_sd_setup_card(struct mmc_host *host, struct mmc_card *card, 797 bool reinit) 798 { 799 int err; 800 801 if (!reinit) { 802 /* 803 * Fetch SCR from card. 804 */ 805 err = mmc_app_send_scr(card, card->raw_scr); 806 if (err) 807 return err; 808 809 err = mmc_decode_scr(card); 810 if (err) 811 return err; 812 813 /* 814 * Fetch and process SD Status register. 815 */ 816 err = mmc_read_ssr(card); 817 if (err) 818 return err; 819 820 /* Erase init depends on CSD and SSR */ 821 mmc_init_erase(card); 822 823 /* 824 * Fetch switch information from card. 825 */ 826 err = mmc_read_switch(card); 827 if (err) 828 return err; 829 } 830 831 /* 832 * For SPI, enable CRC as appropriate. 833 * This CRC enable is located AFTER the reading of the 834 * card registers because some SDHC cards are not able 835 * to provide valid CRCs for non-512-byte blocks. 836 */ 837 if (mmc_host_is_spi(host)) { 838 err = mmc_spi_set_crc(host, use_spi_crc); 839 if (err) 840 return err; 841 } 842 843 /* 844 * Check if read-only switch is active. 845 */ 846 if (!reinit) { 847 int ro = mmc_sd_get_ro(host); 848 849 if (ro < 0) { 850 pr_warn("%s: host does not support reading read-only switch, assuming write-enable\n", 851 mmc_hostname(host)); 852 } else if (ro > 0) { 853 mmc_card_set_readonly(card); 854 } 855 } 856 857 return 0; 858 } 859 860 unsigned mmc_sd_get_max_clock(struct mmc_card *card) 861 { 862 unsigned max_dtr = (unsigned int)-1; 863 864 if (mmc_card_hs(card)) { 865 if (max_dtr > card->sw_caps.hs_max_dtr) 866 max_dtr = card->sw_caps.hs_max_dtr; 867 } else if (max_dtr > card->csd.max_dtr) { 868 max_dtr = card->csd.max_dtr; 869 } 870 871 return max_dtr; 872 } 873 874 /* 875 * Handle the detection and initialisation of a card. 876 * 877 * In the case of a resume, "oldcard" will contain the card 878 * we're trying to reinitialise. 879 */ 880 static int mmc_sd_init_card(struct mmc_host *host, u32 ocr, 881 struct mmc_card *oldcard) 882 { 883 struct mmc_card *card; 884 int err; 885 u32 cid[4]; 886 u32 rocr = 0; 887 888 BUG_ON(!host); 889 WARN_ON(!host->claimed); 890 891 err = mmc_sd_get_cid(host, ocr, cid, &rocr); 892 if (err) 893 return err; 894 895 if (oldcard) { 896 if (memcmp(cid, oldcard->raw_cid, sizeof(cid)) != 0) 897 return -ENOENT; 898 899 card = oldcard; 900 } else { 901 /* 902 * Allocate card structure. 903 */ 904 card = mmc_alloc_card(host, &sd_type); 905 if (IS_ERR(card)) 906 return PTR_ERR(card); 907 908 card->ocr = ocr; 909 card->type = MMC_TYPE_SD; 910 memcpy(card->raw_cid, cid, sizeof(card->raw_cid)); 911 } 912 913 /* 914 * Call the optional HC's init_card function to handle quirks. 915 */ 916 if (host->ops->init_card) 917 host->ops->init_card(host, card); 918 919 /* 920 * For native busses: get card RCA and quit open drain mode. 921 */ 922 if (!mmc_host_is_spi(host)) { 923 err = mmc_send_relative_addr(host, &card->rca); 924 if (err) 925 goto free_card; 926 } 927 928 if (!oldcard) { 929 err = mmc_sd_get_csd(host, card); 930 if (err) 931 goto free_card; 932 933 mmc_decode_cid(card); 934 } 935 936 /* 937 * handling only for cards supporting DSR and hosts requesting 938 * DSR configuration 939 */ 940 if (card->csd.dsr_imp && host->dsr_req) 941 mmc_set_dsr(host); 942 943 /* 944 * Select card, as all following commands rely on that. 945 */ 946 if (!mmc_host_is_spi(host)) { 947 err = mmc_select_card(card); 948 if (err) 949 goto free_card; 950 } 951 952 err = mmc_sd_setup_card(host, card, oldcard != NULL); 953 if (err) 954 goto free_card; 955 956 /* Initialization sequence for UHS-I cards */ 957 if (rocr & SD_ROCR_S18A) { 958 err = mmc_sd_init_uhs_card(card); 959 if (err) 960 goto free_card; 961 } else { 962 /* 963 * Attempt to change to high-speed (if supported) 964 */ 965 err = mmc_sd_switch_hs(card); 966 if (err > 0) 967 mmc_set_timing(card->host, MMC_TIMING_SD_HS); 968 else if (err) 969 goto free_card; 970 971 /* 972 * Set bus speed. 973 */ 974 mmc_set_clock(host, mmc_sd_get_max_clock(card)); 975 976 /* 977 * Switch to wider bus (if supported). 978 */ 979 if ((host->caps & MMC_CAP_4_BIT_DATA) && 980 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) { 981 err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4); 982 if (err) 983 goto free_card; 984 985 mmc_set_bus_width(host, MMC_BUS_WIDTH_4); 986 } 987 } 988 989 host->card = card; 990 return 0; 991 992 free_card: 993 if (!oldcard) 994 mmc_remove_card(card); 995 996 return err; 997 } 998 999 /* 1000 * Host is being removed. Free up the current card. 1001 */ 1002 static void mmc_sd_remove(struct mmc_host *host) 1003 { 1004 BUG_ON(!host); 1005 BUG_ON(!host->card); 1006 1007 mmc_remove_card(host->card); 1008 host->card = NULL; 1009 } 1010 1011 /* 1012 * Card detection - card is alive. 1013 */ 1014 static int mmc_sd_alive(struct mmc_host *host) 1015 { 1016 return mmc_send_status(host->card, NULL); 1017 } 1018 1019 /* 1020 * Card detection callback from host. 1021 */ 1022 static void mmc_sd_detect(struct mmc_host *host) 1023 { 1024 int err; 1025 1026 BUG_ON(!host); 1027 BUG_ON(!host->card); 1028 1029 mmc_get_card(host->card); 1030 1031 /* 1032 * Just check if our card has been removed. 1033 */ 1034 err = _mmc_detect_card_removed(host); 1035 1036 mmc_put_card(host->card); 1037 1038 if (err) { 1039 mmc_sd_remove(host); 1040 1041 mmc_claim_host(host); 1042 mmc_detach_bus(host); 1043 mmc_power_off(host); 1044 mmc_release_host(host); 1045 } 1046 } 1047 1048 static int _mmc_sd_suspend(struct mmc_host *host) 1049 { 1050 int err = 0; 1051 1052 BUG_ON(!host); 1053 BUG_ON(!host->card); 1054 1055 mmc_claim_host(host); 1056 1057 if (mmc_card_suspended(host->card)) 1058 goto out; 1059 1060 if (!mmc_host_is_spi(host)) 1061 err = mmc_deselect_cards(host); 1062 1063 if (!err) { 1064 mmc_power_off(host); 1065 mmc_card_set_suspended(host->card); 1066 } 1067 1068 out: 1069 mmc_release_host(host); 1070 return err; 1071 } 1072 1073 /* 1074 * Callback for suspend 1075 */ 1076 static int mmc_sd_suspend(struct mmc_host *host) 1077 { 1078 int err; 1079 1080 err = _mmc_sd_suspend(host); 1081 if (!err) { 1082 pm_runtime_disable(&host->card->dev); 1083 pm_runtime_set_suspended(&host->card->dev); 1084 } 1085 1086 return err; 1087 } 1088 1089 /* 1090 * This function tries to determine if the same card is still present 1091 * and, if so, restore all state to it. 1092 */ 1093 static int _mmc_sd_resume(struct mmc_host *host) 1094 { 1095 int err = 0; 1096 1097 BUG_ON(!host); 1098 BUG_ON(!host->card); 1099 1100 mmc_claim_host(host); 1101 1102 if (!mmc_card_suspended(host->card)) 1103 goto out; 1104 1105 mmc_power_up(host, host->card->ocr); 1106 err = mmc_sd_init_card(host, host->card->ocr, host->card); 1107 mmc_card_clr_suspended(host->card); 1108 1109 out: 1110 mmc_release_host(host); 1111 return err; 1112 } 1113 1114 /* 1115 * Callback for resume 1116 */ 1117 static int mmc_sd_resume(struct mmc_host *host) 1118 { 1119 int err = 0; 1120 1121 if (!(host->caps & MMC_CAP_RUNTIME_RESUME)) { 1122 err = _mmc_sd_resume(host); 1123 pm_runtime_set_active(&host->card->dev); 1124 pm_runtime_mark_last_busy(&host->card->dev); 1125 } 1126 pm_runtime_enable(&host->card->dev); 1127 1128 return err; 1129 } 1130 1131 /* 1132 * Callback for runtime_suspend. 1133 */ 1134 static int mmc_sd_runtime_suspend(struct mmc_host *host) 1135 { 1136 int err; 1137 1138 if (!(host->caps & MMC_CAP_AGGRESSIVE_PM)) 1139 return 0; 1140 1141 err = _mmc_sd_suspend(host); 1142 if (err) 1143 pr_err("%s: error %d doing aggressive suspend\n", 1144 mmc_hostname(host), err); 1145 1146 return err; 1147 } 1148 1149 /* 1150 * Callback for runtime_resume. 1151 */ 1152 static int mmc_sd_runtime_resume(struct mmc_host *host) 1153 { 1154 int err; 1155 1156 if (!(host->caps & (MMC_CAP_AGGRESSIVE_PM | MMC_CAP_RUNTIME_RESUME))) 1157 return 0; 1158 1159 err = _mmc_sd_resume(host); 1160 if (err) 1161 pr_err("%s: error %d doing aggressive resume\n", 1162 mmc_hostname(host), err); 1163 1164 return 0; 1165 } 1166 1167 static int mmc_sd_reset(struct mmc_host *host) 1168 { 1169 mmc_power_cycle(host, host->card->ocr); 1170 return mmc_sd_init_card(host, host->card->ocr, host->card); 1171 } 1172 1173 static const struct mmc_bus_ops mmc_sd_ops = { 1174 .remove = mmc_sd_remove, 1175 .detect = mmc_sd_detect, 1176 .runtime_suspend = mmc_sd_runtime_suspend, 1177 .runtime_resume = mmc_sd_runtime_resume, 1178 .suspend = mmc_sd_suspend, 1179 .resume = mmc_sd_resume, 1180 .alive = mmc_sd_alive, 1181 .shutdown = mmc_sd_suspend, 1182 .reset = mmc_sd_reset, 1183 }; 1184 1185 /* 1186 * Starting point for SD card init. 1187 */ 1188 int mmc_attach_sd(struct mmc_host *host) 1189 { 1190 int err; 1191 u32 ocr, rocr; 1192 1193 BUG_ON(!host); 1194 WARN_ON(!host->claimed); 1195 1196 err = mmc_send_app_op_cond(host, 0, &ocr); 1197 if (err) 1198 return err; 1199 1200 mmc_attach_bus(host, &mmc_sd_ops); 1201 if (host->ocr_avail_sd) 1202 host->ocr_avail = host->ocr_avail_sd; 1203 1204 /* 1205 * We need to get OCR a different way for SPI. 1206 */ 1207 if (mmc_host_is_spi(host)) { 1208 mmc_go_idle(host); 1209 1210 err = mmc_spi_read_ocr(host, 0, &ocr); 1211 if (err) 1212 goto err; 1213 } 1214 1215 rocr = mmc_select_voltage(host, ocr); 1216 1217 /* 1218 * Can we support the voltage(s) of the card(s)? 1219 */ 1220 if (!rocr) { 1221 err = -EINVAL; 1222 goto err; 1223 } 1224 1225 /* 1226 * Detect and init the card. 1227 */ 1228 err = mmc_sd_init_card(host, rocr, NULL); 1229 if (err) 1230 goto err; 1231 1232 mmc_release_host(host); 1233 err = mmc_add_card(host->card); 1234 mmc_claim_host(host); 1235 if (err) 1236 goto remove_card; 1237 1238 return 0; 1239 1240 remove_card: 1241 mmc_release_host(host); 1242 mmc_remove_card(host->card); 1243 host->card = NULL; 1244 mmc_claim_host(host); 1245 err: 1246 mmc_detach_bus(host); 1247 1248 pr_err("%s: error %d whilst initialising SD card\n", 1249 mmc_hostname(host), err); 1250 1251 return err; 1252 } 1253