2 * linux/drivers/mmc/core/sd.c
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.
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.
13 #include <linux/err.h>
14 #include <linux/sizes.h>
15 #include <linux/slab.h>
16 #include <linux/stat.h>
18 #include <linux/mmc/host.h>
19 #include <linux/mmc/card.h>
20 #include <linux/mmc/mmc.h>
21 #include <linux/mmc/sd.h>
29 static const unsigned int tran_exp
[] = {
30 10000, 100000, 1000000, 10000000,
34 static const unsigned char tran_mant
[] = {
35 0, 10, 12, 13, 15, 20, 25, 30,
36 35, 40, 45, 50, 55, 60, 70, 80,
39 static const unsigned int tacc_exp
[] = {
40 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000,
43 static const unsigned int tacc_mant
[] = {
44 0, 10, 12, 13, 15, 20, 25, 30,
45 35, 40, 45, 50, 55, 60, 70, 80,
48 static const unsigned int sd_au_size
[] = {
49 0, SZ_16K
/ 512, SZ_32K
/ 512, SZ_64K
/ 512,
50 SZ_128K
/ 512, SZ_256K
/ 512, SZ_512K
/ 512, SZ_1M
/ 512,
51 SZ_2M
/ 512, SZ_4M
/ 512, SZ_8M
/ 512, (SZ_8M
+ SZ_4M
) / 512,
52 SZ_16M
/ 512, (SZ_16M
+ SZ_8M
) / 512, SZ_32M
/ 512, SZ_64M
/ 512,
55 #define UNSTUFF_BITS(resp,start,size) \
57 const int __size = size; \
58 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \
59 const int __off = 3 - ((start) / 32); \
60 const int __shft = (start) & 31; \
63 __res = resp[__off] >> __shft; \
64 if (__size + __shft > 32) \
65 __res |= resp[__off-1] << ((32 - __shft) % 32); \
70 * Given the decoded CSD structure, decode the raw CID to our CID structure.
72 void mmc_decode_cid(struct mmc_card
*card
)
74 u32
*resp
= card
->raw_cid
;
76 memset(&card
->cid
, 0, sizeof(struct mmc_cid
));
79 * SD doesn't currently have a version field so we will
80 * have to assume we can parse this.
82 card
->cid
.manfid
= UNSTUFF_BITS(resp
, 120, 8);
83 card
->cid
.oemid
= UNSTUFF_BITS(resp
, 104, 16);
84 card
->cid
.prod_name
[0] = UNSTUFF_BITS(resp
, 96, 8);
85 card
->cid
.prod_name
[1] = UNSTUFF_BITS(resp
, 88, 8);
86 card
->cid
.prod_name
[2] = UNSTUFF_BITS(resp
, 80, 8);
87 card
->cid
.prod_name
[3] = UNSTUFF_BITS(resp
, 72, 8);
88 card
->cid
.prod_name
[4] = UNSTUFF_BITS(resp
, 64, 8);
89 card
->cid
.hwrev
= UNSTUFF_BITS(resp
, 60, 4);
90 card
->cid
.fwrev
= UNSTUFF_BITS(resp
, 56, 4);
91 card
->cid
.serial
= UNSTUFF_BITS(resp
, 24, 32);
92 card
->cid
.year
= UNSTUFF_BITS(resp
, 12, 8);
93 card
->cid
.month
= UNSTUFF_BITS(resp
, 8, 4);
95 card
->cid
.year
+= 2000; /* SD cards year offset */
99 * Given a 128-bit response, decode to our card CSD structure.
101 static int mmc_decode_csd(struct mmc_card
*card
)
103 struct mmc_csd
*csd
= &card
->csd
;
104 unsigned int e
, m
, csd_struct
;
105 u32
*resp
= card
->raw_csd
;
107 csd_struct
= UNSTUFF_BITS(resp
, 126, 2);
109 switch (csd_struct
) {
111 m
= UNSTUFF_BITS(resp
, 115, 4);
112 e
= UNSTUFF_BITS(resp
, 112, 3);
113 csd
->tacc_ns
= (tacc_exp
[e
] * tacc_mant
[m
] + 9) / 10;
114 csd
->tacc_clks
= UNSTUFF_BITS(resp
, 104, 8) * 100;
116 m
= UNSTUFF_BITS(resp
, 99, 4);
117 e
= UNSTUFF_BITS(resp
, 96, 3);
118 csd
->max_dtr
= tran_exp
[e
] * tran_mant
[m
];
119 csd
->cmdclass
= UNSTUFF_BITS(resp
, 84, 12);
121 e
= UNSTUFF_BITS(resp
, 47, 3);
122 m
= UNSTUFF_BITS(resp
, 62, 12);
123 csd
->capacity
= (1 + m
) << (e
+ 2);
125 csd
->read_blkbits
= UNSTUFF_BITS(resp
, 80, 4);
126 csd
->read_partial
= UNSTUFF_BITS(resp
, 79, 1);
127 csd
->write_misalign
= UNSTUFF_BITS(resp
, 78, 1);
128 csd
->read_misalign
= UNSTUFF_BITS(resp
, 77, 1);
129 csd
->r2w_factor
= UNSTUFF_BITS(resp
, 26, 3);
130 csd
->write_blkbits
= UNSTUFF_BITS(resp
, 22, 4);
131 csd
->write_partial
= UNSTUFF_BITS(resp
, 21, 1);
133 if (UNSTUFF_BITS(resp
, 46, 1)) {
135 } else if (csd
->write_blkbits
>= 9) {
136 csd
->erase_size
= UNSTUFF_BITS(resp
, 39, 7) + 1;
137 csd
->erase_size
<<= csd
->write_blkbits
- 9;
142 * This is a block-addressed SDHC or SDXC card. Most
143 * interesting fields are unused and have fixed
144 * values. To avoid getting tripped by buggy cards,
145 * we assume those fixed values ourselves.
147 mmc_card_set_blockaddr(card
);
149 csd
->tacc_ns
= 0; /* Unused */
150 csd
->tacc_clks
= 0; /* Unused */
152 m
= UNSTUFF_BITS(resp
, 99, 4);
153 e
= UNSTUFF_BITS(resp
, 96, 3);
154 csd
->max_dtr
= tran_exp
[e
] * tran_mant
[m
];
155 csd
->cmdclass
= UNSTUFF_BITS(resp
, 84, 12);
156 csd
->c_size
= UNSTUFF_BITS(resp
, 48, 22);
158 /* SDXC cards have a minimum C_SIZE of 0x00FFFF */
159 if (csd
->c_size
>= 0xFFFF)
160 mmc_card_set_ext_capacity(card
);
162 m
= UNSTUFF_BITS(resp
, 48, 22);
163 csd
->capacity
= (1 + m
) << 10;
165 csd
->read_blkbits
= 9;
166 csd
->read_partial
= 0;
167 csd
->write_misalign
= 0;
168 csd
->read_misalign
= 0;
169 csd
->r2w_factor
= 4; /* Unused */
170 csd
->write_blkbits
= 9;
171 csd
->write_partial
= 0;
175 pr_err("%s: unrecognised CSD structure version %d\n",
176 mmc_hostname(card
->host
), csd_struct
);
180 card
->erase_size
= csd
->erase_size
;
186 * Given a 64-bit response, decode to our card SCR structure.
188 static int mmc_decode_scr(struct mmc_card
*card
)
190 struct sd_scr
*scr
= &card
->scr
;
191 unsigned int scr_struct
;
194 resp
[3] = card
->raw_scr
[1];
195 resp
[2] = card
->raw_scr
[0];
197 scr_struct
= UNSTUFF_BITS(resp
, 60, 4);
198 if (scr_struct
!= 0) {
199 pr_err("%s: unrecognised SCR structure version %d\n",
200 mmc_hostname(card
->host
), scr_struct
);
204 scr
->sda_vsn
= UNSTUFF_BITS(resp
, 56, 4);
205 scr
->bus_widths
= UNSTUFF_BITS(resp
, 48, 4);
206 if (scr
->sda_vsn
== SCR_SPEC_VER_2
)
207 /* Check if Physical Layer Spec v3.0 is supported */
208 scr
->sda_spec3
= UNSTUFF_BITS(resp
, 47, 1);
210 if (UNSTUFF_BITS(resp
, 55, 1))
211 card
->erased_byte
= 0xFF;
213 card
->erased_byte
= 0x0;
216 scr
->cmds
= UNSTUFF_BITS(resp
, 32, 2);
221 * Fetch and process SD Status register.
223 static int mmc_read_ssr(struct mmc_card
*card
)
225 unsigned int au
, es
, et
, eo
;
229 if (!(card
->csd
.cmdclass
& CCC_APP_SPEC
)) {
230 pr_warning("%s: card lacks mandatory SD Status "
231 "function.\n", mmc_hostname(card
->host
));
235 ssr
= kmalloc(64, GFP_KERNEL
);
239 err
= mmc_app_sd_status(card
, ssr
);
241 pr_warning("%s: problem reading SD Status "
242 "register.\n", mmc_hostname(card
->host
));
247 for (i
= 0; i
< 16; i
++)
248 ssr
[i
] = be32_to_cpu(ssr
[i
]);
251 * UNSTUFF_BITS only works with four u32s so we have to offset the
252 * bitfield positions accordingly.
254 au
= UNSTUFF_BITS(ssr
, 428 - 384, 4);
256 if (au
<= 9 || card
->scr
.sda_spec3
) {
257 card
->ssr
.au
= sd_au_size
[au
];
258 es
= UNSTUFF_BITS(ssr
, 408 - 384, 16);
259 et
= UNSTUFF_BITS(ssr
, 402 - 384, 6);
261 eo
= UNSTUFF_BITS(ssr
, 400 - 384, 2);
262 card
->ssr
.erase_timeout
= (et
* 1000) / es
;
263 card
->ssr
.erase_offset
= eo
* 1000;
266 pr_warning("%s: SD Status: Invalid Allocation Unit size.\n",
267 mmc_hostname(card
->host
));
276 * Fetches and decodes switch information
278 static int mmc_read_switch(struct mmc_card
*card
)
283 if (card
->scr
.sda_vsn
< SCR_SPEC_VER_1
)
286 if (!(card
->csd
.cmdclass
& CCC_SWITCH
)) {
287 pr_warning("%s: card lacks mandatory switch "
288 "function, performance might suffer.\n",
289 mmc_hostname(card
->host
));
295 status
= kmalloc(64, GFP_KERNEL
);
297 pr_err("%s: could not allocate a buffer for "
298 "switch capabilities.\n",
299 mmc_hostname(card
->host
));
304 * Find out the card's support bits with a mode 0 operation.
305 * The argument does not matter, as the support bits do not
306 * change with the arguments.
308 err
= mmc_sd_switch(card
, 0, 0, 0, status
);
311 * If the host or the card can't do the switch,
312 * fail more gracefully.
314 if (err
!= -EINVAL
&& err
!= -ENOSYS
&& err
!= -EFAULT
)
317 pr_warning("%s: problem reading Bus Speed modes.\n",
318 mmc_hostname(card
->host
));
324 if (status
[13] & SD_MODE_HIGH_SPEED
)
325 card
->sw_caps
.hs_max_dtr
= HIGH_SPEED_MAX_DTR
;
327 if (card
->scr
.sda_spec3
) {
328 card
->sw_caps
.sd3_bus_mode
= status
[13];
329 /* Driver Strengths supported by the card */
330 card
->sw_caps
.sd3_drv_type
= status
[9];
340 * Test if the card supports high-speed mode and, if so, switch to it.
342 int mmc_sd_switch_hs(struct mmc_card
*card
)
347 if (card
->scr
.sda_vsn
< SCR_SPEC_VER_1
)
350 if (!(card
->csd
.cmdclass
& CCC_SWITCH
))
353 if (!(card
->host
->caps
& MMC_CAP_SD_HIGHSPEED
))
356 if (card
->sw_caps
.hs_max_dtr
== 0)
361 status
= kmalloc(64, GFP_KERNEL
);
363 pr_err("%s: could not allocate a buffer for "
364 "switch capabilities.\n", mmc_hostname(card
->host
));
368 err
= mmc_sd_switch(card
, 1, 0, 1, status
);
372 if ((status
[16] & 0xF) != 1) {
373 pr_warning("%s: Problem switching card "
374 "into high-speed mode!\n",
375 mmc_hostname(card
->host
));
387 static int sd_select_driver_type(struct mmc_card
*card
, u8
*status
)
389 int host_drv_type
= SD_DRIVER_TYPE_B
;
390 int card_drv_type
= SD_DRIVER_TYPE_B
;
395 * If the host doesn't support any of the Driver Types A,C or D,
396 * or there is no board specific handler then default Driver
399 if (!(card
->host
->caps
& (MMC_CAP_DRIVER_TYPE_A
| MMC_CAP_DRIVER_TYPE_C
400 | MMC_CAP_DRIVER_TYPE_D
)))
403 if (!card
->host
->ops
->select_drive_strength
)
406 if (card
->host
->caps
& MMC_CAP_DRIVER_TYPE_A
)
407 host_drv_type
|= SD_DRIVER_TYPE_A
;
409 if (card
->host
->caps
& MMC_CAP_DRIVER_TYPE_C
)
410 host_drv_type
|= SD_DRIVER_TYPE_C
;
412 if (card
->host
->caps
& MMC_CAP_DRIVER_TYPE_D
)
413 host_drv_type
|= SD_DRIVER_TYPE_D
;
415 if (card
->sw_caps
.sd3_drv_type
& SD_DRIVER_TYPE_A
)
416 card_drv_type
|= SD_DRIVER_TYPE_A
;
418 if (card
->sw_caps
.sd3_drv_type
& SD_DRIVER_TYPE_C
)
419 card_drv_type
|= SD_DRIVER_TYPE_C
;
421 if (card
->sw_caps
.sd3_drv_type
& SD_DRIVER_TYPE_D
)
422 card_drv_type
|= SD_DRIVER_TYPE_D
;
425 * The drive strength that the hardware can support
426 * depends on the board design. Pass the appropriate
427 * information and let the hardware specific code
428 * return what is possible given the options
430 mmc_host_clk_hold(card
->host
);
431 drive_strength
= card
->host
->ops
->select_drive_strength(
432 card
->sw_caps
.uhs_max_dtr
,
433 host_drv_type
, card_drv_type
);
434 mmc_host_clk_release(card
->host
);
436 err
= mmc_sd_switch(card
, 1, 2, drive_strength
, status
);
440 if ((status
[15] & 0xF) != drive_strength
) {
441 pr_warning("%s: Problem setting drive strength!\n",
442 mmc_hostname(card
->host
));
446 mmc_set_driver_type(card
->host
, drive_strength
);
451 static void sd_update_bus_speed_mode(struct mmc_card
*card
)
454 * If the host doesn't support any of the UHS-I modes, fallback on
457 if (!mmc_host_uhs(card
->host
)) {
458 card
->sd_bus_speed
= 0;
462 if ((card
->host
->caps
& MMC_CAP_UHS_SDR104
) &&
463 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_SDR104
)) {
464 card
->sd_bus_speed
= UHS_SDR104_BUS_SPEED
;
465 } else if ((card
->host
->caps
& MMC_CAP_UHS_DDR50
) &&
466 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_DDR50
)) {
467 card
->sd_bus_speed
= UHS_DDR50_BUS_SPEED
;
468 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
469 MMC_CAP_UHS_SDR50
)) && (card
->sw_caps
.sd3_bus_mode
&
470 SD_MODE_UHS_SDR50
)) {
471 card
->sd_bus_speed
= UHS_SDR50_BUS_SPEED
;
472 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
473 MMC_CAP_UHS_SDR50
| MMC_CAP_UHS_SDR25
)) &&
474 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_SDR25
)) {
475 card
->sd_bus_speed
= UHS_SDR25_BUS_SPEED
;
476 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
477 MMC_CAP_UHS_SDR50
| MMC_CAP_UHS_SDR25
|
478 MMC_CAP_UHS_SDR12
)) && (card
->sw_caps
.sd3_bus_mode
&
479 SD_MODE_UHS_SDR12
)) {
480 card
->sd_bus_speed
= UHS_SDR12_BUS_SPEED
;
484 static int sd_set_bus_speed_mode(struct mmc_card
*card
, u8
*status
)
487 unsigned int timing
= 0;
489 switch (card
->sd_bus_speed
) {
490 case UHS_SDR104_BUS_SPEED
:
491 timing
= MMC_TIMING_UHS_SDR104
;
492 card
->sw_caps
.uhs_max_dtr
= UHS_SDR104_MAX_DTR
;
494 case UHS_DDR50_BUS_SPEED
:
495 timing
= MMC_TIMING_UHS_DDR50
;
496 card
->sw_caps
.uhs_max_dtr
= UHS_DDR50_MAX_DTR
;
498 case UHS_SDR50_BUS_SPEED
:
499 timing
= MMC_TIMING_UHS_SDR50
;
500 card
->sw_caps
.uhs_max_dtr
= UHS_SDR50_MAX_DTR
;
502 case UHS_SDR25_BUS_SPEED
:
503 timing
= MMC_TIMING_UHS_SDR25
;
504 card
->sw_caps
.uhs_max_dtr
= UHS_SDR25_MAX_DTR
;
506 case UHS_SDR12_BUS_SPEED
:
507 timing
= MMC_TIMING_UHS_SDR12
;
508 card
->sw_caps
.uhs_max_dtr
= UHS_SDR12_MAX_DTR
;
514 err
= mmc_sd_switch(card
, 1, 0, card
->sd_bus_speed
, status
);
518 if ((status
[16] & 0xF) != card
->sd_bus_speed
)
519 pr_warning("%s: Problem setting bus speed mode!\n",
520 mmc_hostname(card
->host
));
522 mmc_set_timing(card
->host
, timing
);
523 mmc_set_clock(card
->host
, card
->sw_caps
.uhs_max_dtr
);
529 /* Get host's max current setting at its current voltage */
530 static u32
sd_get_host_max_current(struct mmc_host
*host
)
532 u32 voltage
, max_current
;
534 voltage
= 1 << host
->ios
.vdd
;
536 case MMC_VDD_165_195
:
537 max_current
= host
->max_current_180
;
541 max_current
= host
->max_current_300
;
545 max_current
= host
->max_current_330
;
554 static int sd_set_current_limit(struct mmc_card
*card
, u8
*status
)
556 int current_limit
= SD_SET_CURRENT_NO_CHANGE
;
561 * Current limit switch is only defined for SDR50, SDR104, and DDR50
562 * bus speed modes. For other bus speed modes, we do not change the
565 if ((card
->sd_bus_speed
!= UHS_SDR50_BUS_SPEED
) &&
566 (card
->sd_bus_speed
!= UHS_SDR104_BUS_SPEED
) &&
567 (card
->sd_bus_speed
!= UHS_DDR50_BUS_SPEED
))
571 * Host has different current capabilities when operating at
572 * different voltages, so find out its max current first.
574 max_current
= sd_get_host_max_current(card
->host
);
577 * We only check host's capability here, if we set a limit that is
578 * higher than the card's maximum current, the card will be using its
579 * maximum current, e.g. if the card's maximum current is 300ma, and
580 * when we set current limit to 200ma, the card will draw 200ma, and
581 * when we set current limit to 400/600/800ma, the card will draw its
582 * maximum 300ma from the host.
584 if (max_current
>= 800)
585 current_limit
= SD_SET_CURRENT_LIMIT_800
;
586 else if (max_current
>= 600)
587 current_limit
= SD_SET_CURRENT_LIMIT_600
;
588 else if (max_current
>= 400)
589 current_limit
= SD_SET_CURRENT_LIMIT_400
;
590 else if (max_current
>= 200)
591 current_limit
= SD_SET_CURRENT_LIMIT_200
;
593 if (current_limit
!= SD_SET_CURRENT_NO_CHANGE
) {
594 err
= mmc_sd_switch(card
, 1, 3, current_limit
, status
);
598 if (((status
[15] >> 4) & 0x0F) != current_limit
)
599 pr_warning("%s: Problem setting current limit!\n",
600 mmc_hostname(card
->host
));
608 * UHS-I specific initialization procedure
610 static int mmc_sd_init_uhs_card(struct mmc_card
*card
)
615 if (!card
->scr
.sda_spec3
)
618 if (!(card
->csd
.cmdclass
& CCC_SWITCH
))
621 status
= kmalloc(64, GFP_KERNEL
);
623 pr_err("%s: could not allocate a buffer for "
624 "switch capabilities.\n", mmc_hostname(card
->host
));
628 /* Set 4-bit bus width */
629 if ((card
->host
->caps
& MMC_CAP_4_BIT_DATA
) &&
630 (card
->scr
.bus_widths
& SD_SCR_BUS_WIDTH_4
)) {
631 err
= mmc_app_set_bus_width(card
, MMC_BUS_WIDTH_4
);
635 mmc_set_bus_width(card
->host
, MMC_BUS_WIDTH_4
);
639 * Select the bus speed mode depending on host
640 * and card capability.
642 sd_update_bus_speed_mode(card
);
644 /* Set the driver strength for the card */
645 err
= sd_select_driver_type(card
, status
);
649 /* Set current limit for the card */
650 err
= sd_set_current_limit(card
, status
);
654 /* Set bus speed mode of the card */
655 err
= sd_set_bus_speed_mode(card
, status
);
660 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and
661 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104.
663 if (!mmc_host_is_spi(card
->host
) && card
->host
->ops
->execute_tuning
&&
664 (card
->sd_bus_speed
== UHS_SDR50_BUS_SPEED
||
665 card
->sd_bus_speed
== UHS_SDR104_BUS_SPEED
)) {
666 mmc_host_clk_hold(card
->host
);
667 err
= card
->host
->ops
->execute_tuning(card
->host
,
668 MMC_SEND_TUNING_BLOCK
);
669 mmc_host_clk_release(card
->host
);
678 MMC_DEV_ATTR(cid
, "%08x%08x%08x%08x\n", card
->raw_cid
[0], card
->raw_cid
[1],
679 card
->raw_cid
[2], card
->raw_cid
[3]);
680 MMC_DEV_ATTR(csd
, "%08x%08x%08x%08x\n", card
->raw_csd
[0], card
->raw_csd
[1],
681 card
->raw_csd
[2], card
->raw_csd
[3]);
682 MMC_DEV_ATTR(scr
, "%08x%08x\n", card
->raw_scr
[0], card
->raw_scr
[1]);
683 MMC_DEV_ATTR(date
, "%02d/%04d\n", card
->cid
.month
, card
->cid
.year
);
684 MMC_DEV_ATTR(erase_size
, "%u\n", card
->erase_size
<< 9);
685 MMC_DEV_ATTR(preferred_erase_size
, "%u\n", card
->pref_erase
<< 9);
686 MMC_DEV_ATTR(fwrev
, "0x%x\n", card
->cid
.fwrev
);
687 MMC_DEV_ATTR(hwrev
, "0x%x\n", card
->cid
.hwrev
);
688 MMC_DEV_ATTR(manfid
, "0x%06x\n", card
->cid
.manfid
);
689 MMC_DEV_ATTR(name
, "%s\n", card
->cid
.prod_name
);
690 MMC_DEV_ATTR(oemid
, "0x%04x\n", card
->cid
.oemid
);
691 MMC_DEV_ATTR(serial
, "0x%08x\n", card
->cid
.serial
);
694 static struct attribute
*sd_std_attrs
[] = {
699 &dev_attr_erase_size
.attr
,
700 &dev_attr_preferred_erase_size
.attr
,
701 &dev_attr_fwrev
.attr
,
702 &dev_attr_hwrev
.attr
,
703 &dev_attr_manfid
.attr
,
705 &dev_attr_oemid
.attr
,
706 &dev_attr_serial
.attr
,
710 static struct attribute_group sd_std_attr_group
= {
711 .attrs
= sd_std_attrs
,
714 static const struct attribute_group
*sd_attr_groups
[] = {
719 struct device_type sd_type
= {
720 .groups
= sd_attr_groups
,
724 * Fetch CID from card.
726 int mmc_sd_get_cid(struct mmc_host
*host
, u32 ocr
, u32
*cid
, u32
*rocr
)
735 pr_warning("%s: Skipping voltage switch\n",
740 * Since we're changing the OCR value, we seem to
741 * need to tell some cards to go back to the idle
742 * state. We wait 1ms to give cards time to
748 * If SD_SEND_IF_COND indicates an SD 2.0
749 * compliant card and we should set bit 30
750 * of the ocr to indicate that we can handle
751 * block-addressed SDHC cards.
753 err
= mmc_send_if_cond(host
, ocr
);
758 * If the host supports one of UHS-I modes, request the card
759 * to switch to 1.8V signaling level. If the card has failed
760 * repeatedly to switch however, skip this.
762 if (retries
&& mmc_host_uhs(host
))
766 * If the host can supply more than 150mA at current voltage,
767 * XPC should be set to 1.
769 max_current
= sd_get_host_max_current(host
);
770 if (max_current
> 150)
773 err
= mmc_send_app_op_cond(host
, ocr
, rocr
);
778 * In case CCS and S18A in the response is set, start Signal Voltage
779 * Switch procedure. SPI mode doesn't support CMD11.
781 if (!mmc_host_is_spi(host
) && rocr
&&
782 ((*rocr
& 0x41000000) == 0x41000000)) {
783 err
= mmc_set_signal_voltage(host
, MMC_SIGNAL_VOLTAGE_180
);
784 if (err
== -EAGAIN
) {
793 if (mmc_host_is_spi(host
))
794 err
= mmc_send_cid(host
, cid
);
796 err
= mmc_all_send_cid(host
, cid
);
801 int mmc_sd_get_csd(struct mmc_host
*host
, struct mmc_card
*card
)
806 * Fetch CSD from card.
808 err
= mmc_send_csd(card
, card
->raw_csd
);
812 err
= mmc_decode_csd(card
);
819 int mmc_sd_setup_card(struct mmc_host
*host
, struct mmc_card
*card
,
826 * Fetch SCR from card.
828 err
= mmc_app_send_scr(card
, card
->raw_scr
);
832 err
= mmc_decode_scr(card
);
837 * Fetch and process SD Status register.
839 err
= mmc_read_ssr(card
);
843 /* Erase init depends on CSD and SSR */
844 mmc_init_erase(card
);
847 * Fetch switch information from card.
849 err
= mmc_read_switch(card
);
855 * For SPI, enable CRC as appropriate.
856 * This CRC enable is located AFTER the reading of the
857 * card registers because some SDHC cards are not able
858 * to provide valid CRCs for non-512-byte blocks.
860 if (mmc_host_is_spi(host
)) {
861 err
= mmc_spi_set_crc(host
, use_spi_crc
);
867 * Check if read-only switch is active.
872 if (host
->ops
->get_ro
) {
873 mmc_host_clk_hold(card
->host
);
874 ro
= host
->ops
->get_ro(host
);
875 mmc_host_clk_release(card
->host
);
879 pr_warning("%s: host does not "
880 "support reading read-only "
881 "switch. assuming write-enable.\n",
884 mmc_card_set_readonly(card
);
891 unsigned mmc_sd_get_max_clock(struct mmc_card
*card
)
893 unsigned max_dtr
= (unsigned int)-1;
895 if (mmc_card_highspeed(card
)) {
896 if (max_dtr
> card
->sw_caps
.hs_max_dtr
)
897 max_dtr
= card
->sw_caps
.hs_max_dtr
;
898 } else if (max_dtr
> card
->csd
.max_dtr
) {
899 max_dtr
= card
->csd
.max_dtr
;
905 void mmc_sd_go_highspeed(struct mmc_card
*card
)
907 mmc_card_set_highspeed(card
);
908 mmc_set_timing(card
->host
, MMC_TIMING_SD_HS
);
912 * Handle the detection and initialisation of a card.
914 * In the case of a resume, "oldcard" will contain the card
915 * we're trying to reinitialise.
917 static int mmc_sd_init_card(struct mmc_host
*host
, u32 ocr
,
918 struct mmc_card
*oldcard
)
920 struct mmc_card
*card
;
926 WARN_ON(!host
->claimed
);
928 err
= mmc_sd_get_cid(host
, ocr
, cid
, &rocr
);
933 if (memcmp(cid
, oldcard
->raw_cid
, sizeof(cid
)) != 0)
939 * Allocate card structure.
941 card
= mmc_alloc_card(host
, &sd_type
);
943 return PTR_ERR(card
);
945 card
->type
= MMC_TYPE_SD
;
946 memcpy(card
->raw_cid
, cid
, sizeof(card
->raw_cid
));
950 * For native busses: get card RCA and quit open drain mode.
952 if (!mmc_host_is_spi(host
)) {
953 err
= mmc_send_relative_addr(host
, &card
->rca
);
959 err
= mmc_sd_get_csd(host
, card
);
963 mmc_decode_cid(card
);
967 * Select card, as all following commands rely on that.
969 if (!mmc_host_is_spi(host
)) {
970 err
= mmc_select_card(card
);
975 err
= mmc_sd_setup_card(host
, card
, oldcard
!= NULL
);
979 /* Initialization sequence for UHS-I cards */
980 if (rocr
& SD_ROCR_S18A
) {
981 err
= mmc_sd_init_uhs_card(card
);
985 /* Card is an ultra-high-speed card */
986 mmc_card_set_uhs(card
);
989 * Attempt to change to high-speed (if supported)
991 err
= mmc_sd_switch_hs(card
);
993 mmc_sd_go_highspeed(card
);
1000 mmc_set_clock(host
, mmc_sd_get_max_clock(card
));
1003 * Switch to wider bus (if supported).
1005 if ((host
->caps
& MMC_CAP_4_BIT_DATA
) &&
1006 (card
->scr
.bus_widths
& SD_SCR_BUS_WIDTH_4
)) {
1007 err
= mmc_app_set_bus_width(card
, MMC_BUS_WIDTH_4
);
1011 mmc_set_bus_width(host
, MMC_BUS_WIDTH_4
);
1020 mmc_remove_card(card
);
1026 * Host is being removed. Free up the current card.
1028 static void mmc_sd_remove(struct mmc_host
*host
)
1031 BUG_ON(!host
->card
);
1033 mmc_remove_card(host
->card
);
1038 * Card detection - card is alive.
1040 static int mmc_sd_alive(struct mmc_host
*host
)
1042 return mmc_send_status(host
->card
, NULL
);
1046 * Card detection callback from host.
1048 static void mmc_sd_detect(struct mmc_host
*host
)
1053 BUG_ON(!host
->card
);
1055 mmc_get_card(host
->card
);
1058 * Just check if our card has been removed.
1060 err
= _mmc_detect_card_removed(host
);
1062 mmc_put_card(host
->card
);
1065 mmc_sd_remove(host
);
1067 mmc_claim_host(host
);
1068 mmc_detach_bus(host
);
1069 mmc_power_off(host
);
1070 mmc_release_host(host
);
1075 * Suspend callback from host.
1077 static int mmc_sd_suspend(struct mmc_host
*host
)
1082 BUG_ON(!host
->card
);
1084 mmc_claim_host(host
);
1085 if (!mmc_host_is_spi(host
))
1086 err
= mmc_deselect_cards(host
);
1087 host
->card
->state
&= ~MMC_STATE_HIGHSPEED
;
1089 mmc_power_off(host
);
1090 mmc_release_host(host
);
1096 * Resume callback from host.
1098 * This function tries to determine if the same card is still present
1099 * and, if so, restore all state to it.
1101 static int mmc_sd_resume(struct mmc_host
*host
)
1106 BUG_ON(!host
->card
);
1108 mmc_claim_host(host
);
1110 mmc_select_voltage(host
, host
->ocr
);
1111 err
= mmc_sd_init_card(host
, host
->ocr
, host
->card
);
1112 mmc_release_host(host
);
1118 * Callback for runtime_suspend.
1120 static int mmc_sd_runtime_suspend(struct mmc_host
*host
)
1124 if (!(host
->caps
& MMC_CAP_AGGRESSIVE_PM
))
1127 mmc_claim_host(host
);
1129 err
= mmc_sd_suspend(host
);
1131 pr_err("%s: error %d doing aggessive suspend\n",
1132 mmc_hostname(host
), err
);
1135 mmc_power_off(host
);
1138 mmc_release_host(host
);
1143 * Callback for runtime_resume.
1145 static int mmc_sd_runtime_resume(struct mmc_host
*host
)
1149 if (!(host
->caps
& MMC_CAP_AGGRESSIVE_PM
))
1152 mmc_claim_host(host
);
1155 err
= mmc_sd_resume(host
);
1157 pr_err("%s: error %d doing aggessive resume\n",
1158 mmc_hostname(host
), err
);
1160 mmc_release_host(host
);
1164 static int mmc_sd_power_restore(struct mmc_host
*host
)
1168 host
->card
->state
&= ~MMC_STATE_HIGHSPEED
;
1169 mmc_claim_host(host
);
1170 ret
= mmc_sd_init_card(host
, host
->ocr
, host
->card
);
1171 mmc_release_host(host
);
1176 static const struct mmc_bus_ops mmc_sd_ops
= {
1177 .remove
= mmc_sd_remove
,
1178 .detect
= mmc_sd_detect
,
1181 .power_restore
= mmc_sd_power_restore
,
1182 .alive
= mmc_sd_alive
,
1183 .shutdown
= mmc_sd_suspend
,
1186 static const struct mmc_bus_ops mmc_sd_ops_unsafe
= {
1187 .remove
= mmc_sd_remove
,
1188 .detect
= mmc_sd_detect
,
1189 .runtime_suspend
= mmc_sd_runtime_suspend
,
1190 .runtime_resume
= mmc_sd_runtime_resume
,
1191 .suspend
= mmc_sd_suspend
,
1192 .resume
= mmc_sd_resume
,
1193 .power_restore
= mmc_sd_power_restore
,
1194 .alive
= mmc_sd_alive
,
1195 .shutdown
= mmc_sd_suspend
,
1198 static void mmc_sd_attach_bus_ops(struct mmc_host
*host
)
1200 const struct mmc_bus_ops
*bus_ops
;
1202 if (!mmc_card_is_removable(host
))
1203 bus_ops
= &mmc_sd_ops_unsafe
;
1205 bus_ops
= &mmc_sd_ops
;
1206 mmc_attach_bus(host
, bus_ops
);
1210 * Starting point for SD card init.
1212 int mmc_attach_sd(struct mmc_host
*host
)
1218 WARN_ON(!host
->claimed
);
1220 err
= mmc_send_app_op_cond(host
, 0, &ocr
);
1224 mmc_sd_attach_bus_ops(host
);
1225 if (host
->ocr_avail_sd
)
1226 host
->ocr_avail
= host
->ocr_avail_sd
;
1229 * We need to get OCR a different way for SPI.
1231 if (mmc_host_is_spi(host
)) {
1234 err
= mmc_spi_read_ocr(host
, 0, &ocr
);
1240 * Sanity check the voltages that the card claims to
1244 pr_warning("%s: card claims to support voltages "
1245 "below the defined range. These will be ignored.\n",
1246 mmc_hostname(host
));
1250 if ((ocr
& MMC_VDD_165_195
) &&
1251 !(host
->ocr_avail_sd
& MMC_VDD_165_195
)) {
1252 pr_warning("%s: SD card claims to support the "
1253 "incompletely defined 'low voltage range'. This "
1254 "will be ignored.\n", mmc_hostname(host
));
1255 ocr
&= ~MMC_VDD_165_195
;
1258 host
->ocr
= mmc_select_voltage(host
, ocr
);
1261 * Can we support the voltage(s) of the card(s)?
1269 * Detect and init the card.
1271 err
= mmc_sd_init_card(host
, host
->ocr
, NULL
);
1275 mmc_release_host(host
);
1276 err
= mmc_add_card(host
->card
);
1277 mmc_claim_host(host
);
1284 mmc_release_host(host
);
1285 mmc_remove_card(host
->card
);
1287 mmc_claim_host(host
);
1289 mmc_detach_bus(host
);
1291 pr_err("%s: error %d whilst initialising SD card\n",
1292 mmc_hostname(host
), err
);