1 // SPDX-License-Identifier: GPL-2.0-only
3 * linux/drivers/mmc/core/sd.c
5 * Copyright (C) 2003-2004 Russell King, All Rights Reserved.
6 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
7 * Copyright (C) 2005-2007 Pierre Ossman, All Rights Reserved.
10 #include <linux/err.h>
11 #include <linux/sizes.h>
12 #include <linux/slab.h>
13 #include <linux/stat.h>
14 #include <linux/pm_runtime.h>
16 #include <linux/mmc/host.h>
17 #include <linux/mmc/card.h>
18 #include <linux/mmc/mmc.h>
19 #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 taac_exp
[] = {
40 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000,
43 static const unsigned int taac_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
;
77 * SD doesn't currently have a version field so we will
78 * have to assume we can parse this.
80 card
->cid
.manfid
= UNSTUFF_BITS(resp
, 120, 8);
81 card
->cid
.oemid
= UNSTUFF_BITS(resp
, 104, 16);
82 card
->cid
.prod_name
[0] = UNSTUFF_BITS(resp
, 96, 8);
83 card
->cid
.prod_name
[1] = UNSTUFF_BITS(resp
, 88, 8);
84 card
->cid
.prod_name
[2] = UNSTUFF_BITS(resp
, 80, 8);
85 card
->cid
.prod_name
[3] = UNSTUFF_BITS(resp
, 72, 8);
86 card
->cid
.prod_name
[4] = UNSTUFF_BITS(resp
, 64, 8);
87 card
->cid
.hwrev
= UNSTUFF_BITS(resp
, 60, 4);
88 card
->cid
.fwrev
= UNSTUFF_BITS(resp
, 56, 4);
89 card
->cid
.serial
= UNSTUFF_BITS(resp
, 24, 32);
90 card
->cid
.year
= UNSTUFF_BITS(resp
, 12, 8);
91 card
->cid
.month
= UNSTUFF_BITS(resp
, 8, 4);
93 card
->cid
.year
+= 2000; /* SD cards year offset */
97 * Given a 128-bit response, decode to our card CSD structure.
99 static int mmc_decode_csd(struct mmc_card
*card
)
101 struct mmc_csd
*csd
= &card
->csd
;
102 unsigned int e
, m
, csd_struct
;
103 u32
*resp
= card
->raw_csd
;
105 csd_struct
= UNSTUFF_BITS(resp
, 126, 2);
107 switch (csd_struct
) {
109 m
= UNSTUFF_BITS(resp
, 115, 4);
110 e
= UNSTUFF_BITS(resp
, 112, 3);
111 csd
->taac_ns
= (taac_exp
[e
] * taac_mant
[m
] + 9) / 10;
112 csd
->taac_clks
= UNSTUFF_BITS(resp
, 104, 8) * 100;
114 m
= UNSTUFF_BITS(resp
, 99, 4);
115 e
= UNSTUFF_BITS(resp
, 96, 3);
116 csd
->max_dtr
= tran_exp
[e
] * tran_mant
[m
];
117 csd
->cmdclass
= UNSTUFF_BITS(resp
, 84, 12);
119 e
= UNSTUFF_BITS(resp
, 47, 3);
120 m
= UNSTUFF_BITS(resp
, 62, 12);
121 csd
->capacity
= (1 + m
) << (e
+ 2);
123 csd
->read_blkbits
= UNSTUFF_BITS(resp
, 80, 4);
124 csd
->read_partial
= UNSTUFF_BITS(resp
, 79, 1);
125 csd
->write_misalign
= UNSTUFF_BITS(resp
, 78, 1);
126 csd
->read_misalign
= UNSTUFF_BITS(resp
, 77, 1);
127 csd
->dsr_imp
= UNSTUFF_BITS(resp
, 76, 1);
128 csd
->r2w_factor
= UNSTUFF_BITS(resp
, 26, 3);
129 csd
->write_blkbits
= UNSTUFF_BITS(resp
, 22, 4);
130 csd
->write_partial
= UNSTUFF_BITS(resp
, 21, 1);
132 if (UNSTUFF_BITS(resp
, 46, 1)) {
134 } else if (csd
->write_blkbits
>= 9) {
135 csd
->erase_size
= UNSTUFF_BITS(resp
, 39, 7) + 1;
136 csd
->erase_size
<<= csd
->write_blkbits
- 9;
141 * This is a block-addressed SDHC or SDXC card. Most
142 * interesting fields are unused and have fixed
143 * values. To avoid getting tripped by buggy cards,
144 * we assume those fixed values ourselves.
146 mmc_card_set_blockaddr(card
);
148 csd
->taac_ns
= 0; /* Unused */
149 csd
->taac_clks
= 0; /* Unused */
151 m
= UNSTUFF_BITS(resp
, 99, 4);
152 e
= UNSTUFF_BITS(resp
, 96, 3);
153 csd
->max_dtr
= tran_exp
[e
] * tran_mant
[m
];
154 csd
->cmdclass
= UNSTUFF_BITS(resp
, 84, 12);
155 csd
->c_size
= UNSTUFF_BITS(resp
, 48, 22);
157 /* SDXC cards have a minimum C_SIZE of 0x00FFFF */
158 if (csd
->c_size
>= 0xFFFF)
159 mmc_card_set_ext_capacity(card
);
161 m
= UNSTUFF_BITS(resp
, 48, 22);
162 csd
->capacity
= (1 + m
) << 10;
164 csd
->read_blkbits
= 9;
165 csd
->read_partial
= 0;
166 csd
->write_misalign
= 0;
167 csd
->read_misalign
= 0;
168 csd
->r2w_factor
= 4; /* Unused */
169 csd
->write_blkbits
= 9;
170 csd
->write_partial
= 0;
174 pr_err("%s: unrecognised CSD structure version %d\n",
175 mmc_hostname(card
->host
), csd_struct
);
179 card
->erase_size
= csd
->erase_size
;
185 * Given a 64-bit response, decode to our card SCR structure.
187 static int mmc_decode_scr(struct mmc_card
*card
)
189 struct sd_scr
*scr
= &card
->scr
;
190 unsigned int scr_struct
;
193 resp
[3] = card
->raw_scr
[1];
194 resp
[2] = card
->raw_scr
[0];
196 scr_struct
= UNSTUFF_BITS(resp
, 60, 4);
197 if (scr_struct
!= 0) {
198 pr_err("%s: unrecognised SCR structure version %d\n",
199 mmc_hostname(card
->host
), scr_struct
);
203 scr
->sda_vsn
= UNSTUFF_BITS(resp
, 56, 4);
204 scr
->bus_widths
= UNSTUFF_BITS(resp
, 48, 4);
205 if (scr
->sda_vsn
== SCR_SPEC_VER_2
)
206 /* Check if Physical Layer Spec v3.0 is supported */
207 scr
->sda_spec3
= UNSTUFF_BITS(resp
, 47, 1);
209 if (scr
->sda_spec3
) {
210 scr
->sda_spec4
= UNSTUFF_BITS(resp
, 42, 1);
211 scr
->sda_specx
= UNSTUFF_BITS(resp
, 38, 4);
214 if (UNSTUFF_BITS(resp
, 55, 1))
215 card
->erased_byte
= 0xFF;
217 card
->erased_byte
= 0x0;
220 scr
->cmds
= UNSTUFF_BITS(resp
, 32, 2);
222 /* SD Spec says: any SD Card shall set at least bits 0 and 2 */
223 if (!(scr
->bus_widths
& SD_SCR_BUS_WIDTH_1
) ||
224 !(scr
->bus_widths
& SD_SCR_BUS_WIDTH_4
)) {
225 pr_err("%s: invalid bus width\n", mmc_hostname(card
->host
));
233 * Fetch and process SD Status register.
235 static int mmc_read_ssr(struct mmc_card
*card
)
237 unsigned int au
, es
, et
, eo
;
243 if (!(card
->csd
.cmdclass
& CCC_APP_SPEC
)) {
244 pr_warn("%s: card lacks mandatory SD Status function\n",
245 mmc_hostname(card
->host
));
249 raw_ssr
= kmalloc(sizeof(card
->raw_ssr
), GFP_KERNEL
);
253 if (mmc_app_sd_status(card
, raw_ssr
)) {
254 pr_warn("%s: problem reading SD Status register\n",
255 mmc_hostname(card
->host
));
260 for (i
= 0; i
< 16; i
++)
261 card
->raw_ssr
[i
] = be32_to_cpu(raw_ssr
[i
]);
266 * UNSTUFF_BITS only works with four u32s so we have to offset the
267 * bitfield positions accordingly.
269 au
= UNSTUFF_BITS(card
->raw_ssr
, 428 - 384, 4);
271 if (au
<= 9 || card
->scr
.sda_spec3
) {
272 card
->ssr
.au
= sd_au_size
[au
];
273 es
= UNSTUFF_BITS(card
->raw_ssr
, 408 - 384, 16);
274 et
= UNSTUFF_BITS(card
->raw_ssr
, 402 - 384, 6);
276 eo
= UNSTUFF_BITS(card
->raw_ssr
, 400 - 384, 2);
277 card
->ssr
.erase_timeout
= (et
* 1000) / es
;
278 card
->ssr
.erase_offset
= eo
* 1000;
281 pr_warn("%s: SD Status: Invalid Allocation Unit size\n",
282 mmc_hostname(card
->host
));
287 * starting SD5.1 discard is supported if DISCARD_SUPPORT (b313) is set
289 resp
[3] = card
->raw_ssr
[6];
290 discard_support
= UNSTUFF_BITS(resp
, 313 - 288, 1);
291 card
->erase_arg
= (card
->scr
.sda_specx
&& discard_support
) ?
292 SD_DISCARD_ARG
: SD_ERASE_ARG
;
298 * Fetches and decodes switch information
300 static int mmc_read_switch(struct mmc_card
*card
)
305 if (card
->scr
.sda_vsn
< SCR_SPEC_VER_1
)
308 if (!(card
->csd
.cmdclass
& CCC_SWITCH
)) {
309 pr_warn("%s: card lacks mandatory switch function, performance might suffer\n",
310 mmc_hostname(card
->host
));
314 status
= kmalloc(64, GFP_KERNEL
);
319 * Find out the card's support bits with a mode 0 operation.
320 * The argument does not matter, as the support bits do not
321 * change with the arguments.
323 err
= mmc_sd_switch(card
, 0, 0, 0, status
);
326 * If the host or the card can't do the switch,
327 * fail more gracefully.
329 if (err
!= -EINVAL
&& err
!= -ENOSYS
&& err
!= -EFAULT
)
332 pr_warn("%s: problem reading Bus Speed modes\n",
333 mmc_hostname(card
->host
));
339 if (status
[13] & SD_MODE_HIGH_SPEED
)
340 card
->sw_caps
.hs_max_dtr
= HIGH_SPEED_MAX_DTR
;
342 if (card
->scr
.sda_spec3
) {
343 card
->sw_caps
.sd3_bus_mode
= status
[13];
344 /* Driver Strengths supported by the card */
345 card
->sw_caps
.sd3_drv_type
= status
[9];
346 card
->sw_caps
.sd3_curr_limit
= status
[7] | status
[6] << 8;
356 * Test if the card supports high-speed mode and, if so, switch to it.
358 int mmc_sd_switch_hs(struct mmc_card
*card
)
363 if (card
->scr
.sda_vsn
< SCR_SPEC_VER_1
)
366 if (!(card
->csd
.cmdclass
& CCC_SWITCH
))
369 if (!(card
->host
->caps
& MMC_CAP_SD_HIGHSPEED
))
372 if (card
->sw_caps
.hs_max_dtr
== 0)
375 status
= kmalloc(64, GFP_KERNEL
);
379 err
= mmc_sd_switch(card
, 1, 0, 1, status
);
383 if ((status
[16] & 0xF) != 1) {
384 pr_warn("%s: Problem switching card into high-speed mode!\n",
385 mmc_hostname(card
->host
));
397 static int sd_select_driver_type(struct mmc_card
*card
, u8
*status
)
399 int card_drv_type
, drive_strength
, drv_type
;
402 card
->drive_strength
= 0;
404 card_drv_type
= card
->sw_caps
.sd3_drv_type
| SD_DRIVER_TYPE_B
;
406 drive_strength
= mmc_select_drive_strength(card
,
407 card
->sw_caps
.uhs_max_dtr
,
408 card_drv_type
, &drv_type
);
410 if (drive_strength
) {
411 err
= mmc_sd_switch(card
, 1, 2, drive_strength
, status
);
414 if ((status
[15] & 0xF) != drive_strength
) {
415 pr_warn("%s: Problem setting drive strength!\n",
416 mmc_hostname(card
->host
));
419 card
->drive_strength
= drive_strength
;
423 mmc_set_driver_type(card
->host
, drv_type
);
428 static void sd_update_bus_speed_mode(struct mmc_card
*card
)
431 * If the host doesn't support any of the UHS-I modes, fallback on
434 if (!mmc_host_uhs(card
->host
)) {
435 card
->sd_bus_speed
= 0;
439 if ((card
->host
->caps
& MMC_CAP_UHS_SDR104
) &&
440 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_SDR104
)) {
441 card
->sd_bus_speed
= UHS_SDR104_BUS_SPEED
;
442 } else if ((card
->host
->caps
& MMC_CAP_UHS_DDR50
) &&
443 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_DDR50
)) {
444 card
->sd_bus_speed
= UHS_DDR50_BUS_SPEED
;
445 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
446 MMC_CAP_UHS_SDR50
)) && (card
->sw_caps
.sd3_bus_mode
&
447 SD_MODE_UHS_SDR50
)) {
448 card
->sd_bus_speed
= UHS_SDR50_BUS_SPEED
;
449 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
450 MMC_CAP_UHS_SDR50
| MMC_CAP_UHS_SDR25
)) &&
451 (card
->sw_caps
.sd3_bus_mode
& SD_MODE_UHS_SDR25
)) {
452 card
->sd_bus_speed
= UHS_SDR25_BUS_SPEED
;
453 } else if ((card
->host
->caps
& (MMC_CAP_UHS_SDR104
|
454 MMC_CAP_UHS_SDR50
| MMC_CAP_UHS_SDR25
|
455 MMC_CAP_UHS_SDR12
)) && (card
->sw_caps
.sd3_bus_mode
&
456 SD_MODE_UHS_SDR12
)) {
457 card
->sd_bus_speed
= UHS_SDR12_BUS_SPEED
;
461 static int sd_set_bus_speed_mode(struct mmc_card
*card
, u8
*status
)
464 unsigned int timing
= 0;
466 switch (card
->sd_bus_speed
) {
467 case UHS_SDR104_BUS_SPEED
:
468 timing
= MMC_TIMING_UHS_SDR104
;
469 card
->sw_caps
.uhs_max_dtr
= UHS_SDR104_MAX_DTR
;
471 case UHS_DDR50_BUS_SPEED
:
472 timing
= MMC_TIMING_UHS_DDR50
;
473 card
->sw_caps
.uhs_max_dtr
= UHS_DDR50_MAX_DTR
;
475 case UHS_SDR50_BUS_SPEED
:
476 timing
= MMC_TIMING_UHS_SDR50
;
477 card
->sw_caps
.uhs_max_dtr
= UHS_SDR50_MAX_DTR
;
479 case UHS_SDR25_BUS_SPEED
:
480 timing
= MMC_TIMING_UHS_SDR25
;
481 card
->sw_caps
.uhs_max_dtr
= UHS_SDR25_MAX_DTR
;
483 case UHS_SDR12_BUS_SPEED
:
484 timing
= MMC_TIMING_UHS_SDR12
;
485 card
->sw_caps
.uhs_max_dtr
= UHS_SDR12_MAX_DTR
;
491 err
= mmc_sd_switch(card
, 1, 0, card
->sd_bus_speed
, status
);
495 if ((status
[16] & 0xF) != card
->sd_bus_speed
)
496 pr_warn("%s: Problem setting bus speed mode!\n",
497 mmc_hostname(card
->host
));
499 mmc_set_timing(card
->host
, timing
);
500 mmc_set_clock(card
->host
, card
->sw_caps
.uhs_max_dtr
);
506 /* Get host's max current setting at its current voltage */
507 static u32
sd_get_host_max_current(struct mmc_host
*host
)
509 u32 voltage
, max_current
;
511 voltage
= 1 << host
->ios
.vdd
;
513 case MMC_VDD_165_195
:
514 max_current
= host
->max_current_180
;
518 max_current
= host
->max_current_300
;
522 max_current
= host
->max_current_330
;
531 static int sd_set_current_limit(struct mmc_card
*card
, u8
*status
)
533 int current_limit
= SD_SET_CURRENT_NO_CHANGE
;
538 * Current limit switch is only defined for SDR50, SDR104, and DDR50
539 * bus speed modes. For other bus speed modes, we do not change the
542 if ((card
->sd_bus_speed
!= UHS_SDR50_BUS_SPEED
) &&
543 (card
->sd_bus_speed
!= UHS_SDR104_BUS_SPEED
) &&
544 (card
->sd_bus_speed
!= UHS_DDR50_BUS_SPEED
))
548 * Host has different current capabilities when operating at
549 * different voltages, so find out its max current first.
551 max_current
= sd_get_host_max_current(card
->host
);
554 * We only check host's capability here, if we set a limit that is
555 * higher than the card's maximum current, the card will be using its
556 * maximum current, e.g. if the card's maximum current is 300ma, and
557 * when we set current limit to 200ma, the card will draw 200ma, and
558 * when we set current limit to 400/600/800ma, the card will draw its
559 * maximum 300ma from the host.
561 * The above is incorrect: if we try to set a current limit that is
562 * not supported by the card, the card can rightfully error out the
563 * attempt, and remain at the default current limit. This results
564 * in a 300mA card being limited to 200mA even though the host
565 * supports 800mA. Failures seen with SanDisk 8GB UHS cards with
566 * an iMX6 host. --rmk
568 if (max_current
>= 800 &&
569 card
->sw_caps
.sd3_curr_limit
& SD_MAX_CURRENT_800
)
570 current_limit
= SD_SET_CURRENT_LIMIT_800
;
571 else if (max_current
>= 600 &&
572 card
->sw_caps
.sd3_curr_limit
& SD_MAX_CURRENT_600
)
573 current_limit
= SD_SET_CURRENT_LIMIT_600
;
574 else if (max_current
>= 400 &&
575 card
->sw_caps
.sd3_curr_limit
& SD_MAX_CURRENT_400
)
576 current_limit
= SD_SET_CURRENT_LIMIT_400
;
577 else if (max_current
>= 200 &&
578 card
->sw_caps
.sd3_curr_limit
& SD_MAX_CURRENT_200
)
579 current_limit
= SD_SET_CURRENT_LIMIT_200
;
581 if (current_limit
!= SD_SET_CURRENT_NO_CHANGE
) {
582 err
= mmc_sd_switch(card
, 1, 3, current_limit
, status
);
586 if (((status
[15] >> 4) & 0x0F) != current_limit
)
587 pr_warn("%s: Problem setting current limit!\n",
588 mmc_hostname(card
->host
));
596 * UHS-I specific initialization procedure
598 static int mmc_sd_init_uhs_card(struct mmc_card
*card
)
603 if (!(card
->csd
.cmdclass
& CCC_SWITCH
))
606 status
= kmalloc(64, GFP_KERNEL
);
610 /* Set 4-bit bus width */
611 err
= mmc_app_set_bus_width(card
, MMC_BUS_WIDTH_4
);
615 mmc_set_bus_width(card
->host
, MMC_BUS_WIDTH_4
);
618 * Select the bus speed mode depending on host
619 * and card capability.
621 sd_update_bus_speed_mode(card
);
623 /* Set the driver strength for the card */
624 err
= sd_select_driver_type(card
, status
);
628 /* Set current limit for the card */
629 err
= sd_set_current_limit(card
, status
);
633 /* Set bus speed mode of the card */
634 err
= sd_set_bus_speed_mode(card
, status
);
639 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and
640 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104.
642 if (!mmc_host_is_spi(card
->host
) &&
643 (card
->host
->ios
.timing
== MMC_TIMING_UHS_SDR50
||
644 card
->host
->ios
.timing
== MMC_TIMING_UHS_DDR50
||
645 card
->host
->ios
.timing
== MMC_TIMING_UHS_SDR104
)) {
646 err
= mmc_execute_tuning(card
);
649 * As SD Specifications Part1 Physical Layer Specification
650 * Version 3.01 says, CMD19 tuning is available for unlocked
651 * cards in transfer state of 1.8V signaling mode. The small
652 * difference between v3.00 and 3.01 spec means that CMD19
653 * tuning is also available for DDR50 mode.
655 if (err
&& card
->host
->ios
.timing
== MMC_TIMING_UHS_DDR50
) {
656 pr_warn("%s: ddr50 tuning failed\n",
657 mmc_hostname(card
->host
));
668 MMC_DEV_ATTR(cid
, "%08x%08x%08x%08x\n", card
->raw_cid
[0], card
->raw_cid
[1],
669 card
->raw_cid
[2], card
->raw_cid
[3]);
670 MMC_DEV_ATTR(csd
, "%08x%08x%08x%08x\n", card
->raw_csd
[0], card
->raw_csd
[1],
671 card
->raw_csd
[2], card
->raw_csd
[3]);
672 MMC_DEV_ATTR(scr
, "%08x%08x\n", card
->raw_scr
[0], card
->raw_scr
[1]);
674 "%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x\n",
675 card
->raw_ssr
[0], card
->raw_ssr
[1], card
->raw_ssr
[2],
676 card
->raw_ssr
[3], card
->raw_ssr
[4], card
->raw_ssr
[5],
677 card
->raw_ssr
[6], card
->raw_ssr
[7], card
->raw_ssr
[8],
678 card
->raw_ssr
[9], card
->raw_ssr
[10], card
->raw_ssr
[11],
679 card
->raw_ssr
[12], card
->raw_ssr
[13], card
->raw_ssr
[14],
681 MMC_DEV_ATTR(date
, "%02d/%04d\n", card
->cid
.month
, card
->cid
.year
);
682 MMC_DEV_ATTR(erase_size
, "%u\n", card
->erase_size
<< 9);
683 MMC_DEV_ATTR(preferred_erase_size
, "%u\n", card
->pref_erase
<< 9);
684 MMC_DEV_ATTR(fwrev
, "0x%x\n", card
->cid
.fwrev
);
685 MMC_DEV_ATTR(hwrev
, "0x%x\n", card
->cid
.hwrev
);
686 MMC_DEV_ATTR(manfid
, "0x%06x\n", card
->cid
.manfid
);
687 MMC_DEV_ATTR(name
, "%s\n", card
->cid
.prod_name
);
688 MMC_DEV_ATTR(oemid
, "0x%04x\n", card
->cid
.oemid
);
689 MMC_DEV_ATTR(serial
, "0x%08x\n", card
->cid
.serial
);
690 MMC_DEV_ATTR(ocr
, "0x%08x\n", card
->ocr
);
691 MMC_DEV_ATTR(rca
, "0x%04x\n", card
->rca
);
694 static ssize_t
mmc_dsr_show(struct device
*dev
,
695 struct device_attribute
*attr
,
698 struct mmc_card
*card
= mmc_dev_to_card(dev
);
699 struct mmc_host
*host
= card
->host
;
701 if (card
->csd
.dsr_imp
&& host
->dsr_req
)
702 return sprintf(buf
, "0x%x\n", host
->dsr
);
704 /* return default DSR value */
705 return sprintf(buf
, "0x%x\n", 0x404);
708 static DEVICE_ATTR(dsr
, S_IRUGO
, mmc_dsr_show
, NULL
);
710 static struct attribute
*sd_std_attrs
[] = {
716 &dev_attr_erase_size
.attr
,
717 &dev_attr_preferred_erase_size
.attr
,
718 &dev_attr_fwrev
.attr
,
719 &dev_attr_hwrev
.attr
,
720 &dev_attr_manfid
.attr
,
722 &dev_attr_oemid
.attr
,
723 &dev_attr_serial
.attr
,
729 ATTRIBUTE_GROUPS(sd_std
);
731 struct device_type sd_type
= {
732 .groups
= sd_std_groups
,
736 * Fetch CID from card.
738 int mmc_sd_get_cid(struct mmc_host
*host
, u32 ocr
, u32
*cid
, u32
*rocr
)
748 pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host
));
752 * Since we're changing the OCR value, we seem to
753 * need to tell some cards to go back to the idle
754 * state. We wait 1ms to give cards time to
760 * If SD_SEND_IF_COND indicates an SD 2.0
761 * compliant card and we should set bit 30
762 * of the ocr to indicate that we can handle
763 * block-addressed SDHC cards.
765 err
= mmc_send_if_cond(host
, ocr
);
770 * If the host supports one of UHS-I modes, request the card
771 * to switch to 1.8V signaling level. If the card has failed
772 * repeatedly to switch however, skip this.
774 if (retries
&& mmc_host_uhs(host
))
778 * If the host can supply more than 150mA at current voltage,
779 * XPC should be set to 1.
781 max_current
= sd_get_host_max_current(host
);
782 if (max_current
> 150)
785 err
= mmc_send_app_op_cond(host
, ocr
, rocr
);
790 * In case CCS and S18A in the response is set, start Signal Voltage
791 * Switch procedure. SPI mode doesn't support CMD11.
793 if (!mmc_host_is_spi(host
) && rocr
&&
794 ((*rocr
& 0x41000000) == 0x41000000)) {
795 err
= mmc_set_uhs_voltage(host
, pocr
);
796 if (err
== -EAGAIN
) {
805 err
= mmc_send_cid(host
, cid
);
809 int mmc_sd_get_csd(struct mmc_host
*host
, struct mmc_card
*card
)
814 * Fetch CSD from card.
816 err
= mmc_send_csd(card
, card
->raw_csd
);
820 err
= mmc_decode_csd(card
);
827 static int mmc_sd_get_ro(struct mmc_host
*host
)
832 * Some systems don't feature a write-protect pin and don't need one.
833 * E.g. because they only have micro-SD card slot. For those systems
834 * assume that the SD card is always read-write.
836 if (host
->caps2
& MMC_CAP2_NO_WRITE_PROTECT
)
839 if (!host
->ops
->get_ro
)
842 ro
= host
->ops
->get_ro(host
);
847 int mmc_sd_setup_card(struct mmc_host
*host
, struct mmc_card
*card
,
854 * Fetch SCR from card.
856 err
= mmc_app_send_scr(card
);
860 err
= mmc_decode_scr(card
);
865 * Fetch and process SD Status register.
867 err
= mmc_read_ssr(card
);
871 /* Erase init depends on CSD and SSR */
872 mmc_init_erase(card
);
875 * Fetch switch information from card.
877 err
= mmc_read_switch(card
);
883 * For SPI, enable CRC as appropriate.
884 * This CRC enable is located AFTER the reading of the
885 * card registers because some SDHC cards are not able
886 * to provide valid CRCs for non-512-byte blocks.
888 if (mmc_host_is_spi(host
)) {
889 err
= mmc_spi_set_crc(host
, use_spi_crc
);
895 * Check if read-only switch is active.
898 int ro
= mmc_sd_get_ro(host
);
901 pr_warn("%s: host does not support reading read-only switch, assuming write-enable\n",
904 mmc_card_set_readonly(card
);
911 unsigned mmc_sd_get_max_clock(struct mmc_card
*card
)
913 unsigned max_dtr
= (unsigned int)-1;
915 if (mmc_card_hs(card
)) {
916 if (max_dtr
> card
->sw_caps
.hs_max_dtr
)
917 max_dtr
= card
->sw_caps
.hs_max_dtr
;
918 } else if (max_dtr
> card
->csd
.max_dtr
) {
919 max_dtr
= card
->csd
.max_dtr
;
925 static bool mmc_sd_card_using_v18(struct mmc_card
*card
)
928 * According to the SD spec., the Bus Speed Mode (function group 1) bits
929 * 2 to 4 are zero if the card is initialized at 3.3V signal level. Thus
930 * they can be used to determine if the card has already switched to
933 return card
->sw_caps
.sd3_bus_mode
&
934 (SD_MODE_UHS_SDR50
| SD_MODE_UHS_SDR104
| SD_MODE_UHS_DDR50
);
938 * Handle the detection and initialisation of a card.
940 * In the case of a resume, "oldcard" will contain the card
941 * we're trying to reinitialise.
943 static int mmc_sd_init_card(struct mmc_host
*host
, u32 ocr
,
944 struct mmc_card
*oldcard
)
946 struct mmc_card
*card
;
950 bool v18_fixup_failed
= false;
952 WARN_ON(!host
->claimed
);
954 err
= mmc_sd_get_cid(host
, ocr
, cid
, &rocr
);
959 if (memcmp(cid
, oldcard
->raw_cid
, sizeof(cid
)) != 0) {
960 pr_debug("%s: Perhaps the card was replaced\n",
968 * Allocate card structure.
970 card
= mmc_alloc_card(host
, &sd_type
);
972 return PTR_ERR(card
);
975 card
->type
= MMC_TYPE_SD
;
976 memcpy(card
->raw_cid
, cid
, sizeof(card
->raw_cid
));
980 * Call the optional HC's init_card function to handle quirks.
982 if (host
->ops
->init_card
)
983 host
->ops
->init_card(host
, card
);
986 * For native busses: get card RCA and quit open drain mode.
988 if (!mmc_host_is_spi(host
)) {
989 err
= mmc_send_relative_addr(host
, &card
->rca
);
995 err
= mmc_sd_get_csd(host
, card
);
999 mmc_decode_cid(card
);
1003 * handling only for cards supporting DSR and hosts requesting
1006 if (card
->csd
.dsr_imp
&& host
->dsr_req
)
1010 * Select card, as all following commands rely on that.
1012 if (!mmc_host_is_spi(host
)) {
1013 err
= mmc_select_card(card
);
1018 err
= mmc_sd_setup_card(host
, card
, oldcard
!= NULL
);
1023 * If the card has not been power cycled, it may still be using 1.8V
1024 * signaling. Detect that situation and try to initialize a UHS-I (1.8V)
1027 if (!v18_fixup_failed
&& !mmc_host_is_spi(host
) && mmc_host_uhs(host
) &&
1028 mmc_sd_card_using_v18(card
) &&
1029 host
->ios
.signal_voltage
!= MMC_SIGNAL_VOLTAGE_180
) {
1031 * Re-read switch information in case it has changed since
1032 * oldcard was initialized.
1035 err
= mmc_read_switch(card
);
1039 if (mmc_sd_card_using_v18(card
)) {
1040 if (mmc_host_set_uhs_voltage(host
) ||
1041 mmc_sd_init_uhs_card(card
)) {
1042 v18_fixup_failed
= true;
1043 mmc_power_cycle(host
, ocr
);
1045 mmc_remove_card(card
);
1052 /* Initialization sequence for UHS-I cards */
1053 if (rocr
& SD_ROCR_S18A
&& mmc_host_uhs(host
)) {
1054 err
= mmc_sd_init_uhs_card(card
);
1059 * Attempt to change to high-speed (if supported)
1061 err
= mmc_sd_switch_hs(card
);
1063 mmc_set_timing(card
->host
, MMC_TIMING_SD_HS
);
1070 mmc_set_clock(host
, mmc_sd_get_max_clock(card
));
1073 * Switch to wider bus (if supported).
1075 if ((host
->caps
& MMC_CAP_4_BIT_DATA
) &&
1076 (card
->scr
.bus_widths
& SD_SCR_BUS_WIDTH_4
)) {
1077 err
= mmc_app_set_bus_width(card
, MMC_BUS_WIDTH_4
);
1081 mmc_set_bus_width(host
, MMC_BUS_WIDTH_4
);
1085 if (host
->caps2
& MMC_CAP2_AVOID_3_3V
&&
1086 host
->ios
.signal_voltage
== MMC_SIGNAL_VOLTAGE_330
) {
1087 pr_err("%s: Host failed to negotiate down from 3.3V\n",
1088 mmc_hostname(host
));
1098 mmc_remove_card(card
);
1104 * Host is being removed. Free up the current card.
1106 static void mmc_sd_remove(struct mmc_host
*host
)
1108 mmc_remove_card(host
->card
);
1113 * Card detection - card is alive.
1115 static int mmc_sd_alive(struct mmc_host
*host
)
1117 return mmc_send_status(host
->card
, NULL
);
1121 * Card detection callback from host.
1123 static void mmc_sd_detect(struct mmc_host
*host
)
1127 mmc_get_card(host
->card
, NULL
);
1130 * Just check if our card has been removed.
1132 err
= _mmc_detect_card_removed(host
);
1134 mmc_put_card(host
->card
, NULL
);
1137 mmc_sd_remove(host
);
1139 mmc_claim_host(host
);
1140 mmc_detach_bus(host
);
1141 mmc_power_off(host
);
1142 mmc_release_host(host
);
1146 static int _mmc_sd_suspend(struct mmc_host
*host
)
1150 mmc_claim_host(host
);
1152 if (mmc_card_suspended(host
->card
))
1155 if (!mmc_host_is_spi(host
))
1156 err
= mmc_deselect_cards(host
);
1159 mmc_power_off(host
);
1160 mmc_card_set_suspended(host
->card
);
1164 mmc_release_host(host
);
1169 * Callback for suspend
1171 static int mmc_sd_suspend(struct mmc_host
*host
)
1175 err
= _mmc_sd_suspend(host
);
1177 pm_runtime_disable(&host
->card
->dev
);
1178 pm_runtime_set_suspended(&host
->card
->dev
);
1185 * This function tries to determine if the same card is still present
1186 * and, if so, restore all state to it.
1188 static int _mmc_sd_resume(struct mmc_host
*host
)
1192 mmc_claim_host(host
);
1194 if (!mmc_card_suspended(host
->card
))
1197 mmc_power_up(host
, host
->card
->ocr
);
1198 err
= mmc_sd_init_card(host
, host
->card
->ocr
, host
->card
);
1199 mmc_card_clr_suspended(host
->card
);
1202 mmc_release_host(host
);
1207 * Callback for resume
1209 static int mmc_sd_resume(struct mmc_host
*host
)
1211 pm_runtime_enable(&host
->card
->dev
);
1216 * Callback for runtime_suspend.
1218 static int mmc_sd_runtime_suspend(struct mmc_host
*host
)
1222 if (!(host
->caps
& MMC_CAP_AGGRESSIVE_PM
))
1225 err
= _mmc_sd_suspend(host
);
1227 pr_err("%s: error %d doing aggressive suspend\n",
1228 mmc_hostname(host
), err
);
1234 * Callback for runtime_resume.
1236 static int mmc_sd_runtime_resume(struct mmc_host
*host
)
1240 err
= _mmc_sd_resume(host
);
1241 if (err
&& err
!= -ENOMEDIUM
)
1242 pr_err("%s: error %d doing runtime resume\n",
1243 mmc_hostname(host
), err
);
1248 static int mmc_sd_hw_reset(struct mmc_host
*host
)
1250 mmc_power_cycle(host
, host
->card
->ocr
);
1251 return mmc_sd_init_card(host
, host
->card
->ocr
, host
->card
);
1254 static const struct mmc_bus_ops mmc_sd_ops
= {
1255 .remove
= mmc_sd_remove
,
1256 .detect
= mmc_sd_detect
,
1257 .runtime_suspend
= mmc_sd_runtime_suspend
,
1258 .runtime_resume
= mmc_sd_runtime_resume
,
1259 .suspend
= mmc_sd_suspend
,
1260 .resume
= mmc_sd_resume
,
1261 .alive
= mmc_sd_alive
,
1262 .shutdown
= mmc_sd_suspend
,
1263 .hw_reset
= mmc_sd_hw_reset
,
1267 * Starting point for SD card init.
1269 int mmc_attach_sd(struct mmc_host
*host
)
1274 WARN_ON(!host
->claimed
);
1276 err
= mmc_send_app_op_cond(host
, 0, &ocr
);
1280 mmc_attach_bus(host
, &mmc_sd_ops
);
1281 if (host
->ocr_avail_sd
)
1282 host
->ocr_avail
= host
->ocr_avail_sd
;
1285 * We need to get OCR a different way for SPI.
1287 if (mmc_host_is_spi(host
)) {
1290 err
= mmc_spi_read_ocr(host
, 0, &ocr
);
1296 * Some SD cards claims an out of spec VDD voltage range. Let's treat
1297 * these bits as being in-valid and especially also bit7.
1301 rocr
= mmc_select_voltage(host
, ocr
);
1304 * Can we support the voltage(s) of the card(s)?
1312 * Detect and init the card.
1314 err
= mmc_sd_init_card(host
, rocr
, NULL
);
1318 mmc_release_host(host
);
1319 err
= mmc_add_card(host
->card
);
1323 mmc_claim_host(host
);
1327 mmc_remove_card(host
->card
);
1329 mmc_claim_host(host
);
1331 mmc_detach_bus(host
);
1333 pr_err("%s: error %d whilst initialising SD card\n",
1334 mmc_hostname(host
), err
);