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, HIGH_SPEED_BUS_SPEED
, status
);
383 if ((status
[16] & 0xF) != HIGH_SPEED_BUS_SPEED
) {
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 MMC_DEV_ATTR(vendor
, "0x%04x\n", card
->cis
.vendor
);
711 MMC_DEV_ATTR(device
, "0x%04x\n", card
->cis
.device
);
712 MMC_DEV_ATTR(revision
, "%u.%u\n", card
->major_rev
, card
->minor_rev
);
714 #define sdio_info_attr(num) \
715 static ssize_t info##num##_show(struct device *dev, struct device_attribute *attr, char *buf) \
717 struct mmc_card *card = mmc_dev_to_card(dev); \
719 if (num > card->num_info) \
721 if (!card->info[num-1][0]) \
723 return sprintf(buf, "%s\n", card->info[num-1]); \
725 static DEVICE_ATTR_RO(info##num)
732 static struct attribute
*sd_std_attrs
[] = {
733 &dev_attr_vendor
.attr
,
734 &dev_attr_device
.attr
,
735 &dev_attr_revision
.attr
,
736 &dev_attr_info1
.attr
,
737 &dev_attr_info2
.attr
,
738 &dev_attr_info3
.attr
,
739 &dev_attr_info4
.attr
,
745 &dev_attr_erase_size
.attr
,
746 &dev_attr_preferred_erase_size
.attr
,
747 &dev_attr_fwrev
.attr
,
748 &dev_attr_hwrev
.attr
,
749 &dev_attr_manfid
.attr
,
751 &dev_attr_oemid
.attr
,
752 &dev_attr_serial
.attr
,
759 static umode_t
sd_std_is_visible(struct kobject
*kobj
, struct attribute
*attr
,
762 struct device
*dev
= kobj_to_dev(kobj
);
763 struct mmc_card
*card
= mmc_dev_to_card(dev
);
765 /* CIS vendor and device ids, revision and info string are available only for Combo cards */
766 if ((attr
== &dev_attr_vendor
.attr
||
767 attr
== &dev_attr_device
.attr
||
768 attr
== &dev_attr_revision
.attr
||
769 attr
== &dev_attr_info1
.attr
||
770 attr
== &dev_attr_info2
.attr
||
771 attr
== &dev_attr_info3
.attr
||
772 attr
== &dev_attr_info4
.attr
773 ) && card
->type
!= MMC_TYPE_SD_COMBO
)
779 static const struct attribute_group sd_std_group
= {
780 .attrs
= sd_std_attrs
,
781 .is_visible
= sd_std_is_visible
,
783 __ATTRIBUTE_GROUPS(sd_std
);
785 struct device_type sd_type
= {
786 .groups
= sd_std_groups
,
790 * Fetch CID from card.
792 int mmc_sd_get_cid(struct mmc_host
*host
, u32 ocr
, u32
*cid
, u32
*rocr
)
802 pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host
));
806 * Since we're changing the OCR value, we seem to
807 * need to tell some cards to go back to the idle
808 * state. We wait 1ms to give cards time to
814 * If SD_SEND_IF_COND indicates an SD 2.0
815 * compliant card and we should set bit 30
816 * of the ocr to indicate that we can handle
817 * block-addressed SDHC cards.
819 err
= mmc_send_if_cond(host
, ocr
);
824 * If the host supports one of UHS-I modes, request the card
825 * to switch to 1.8V signaling level. If the card has failed
826 * repeatedly to switch however, skip this.
828 if (retries
&& mmc_host_uhs(host
))
832 * If the host can supply more than 150mA at current voltage,
833 * XPC should be set to 1.
835 max_current
= sd_get_host_max_current(host
);
836 if (max_current
> 150)
839 err
= mmc_send_app_op_cond(host
, ocr
, rocr
);
844 * In case CCS and S18A in the response is set, start Signal Voltage
845 * Switch procedure. SPI mode doesn't support CMD11.
847 if (!mmc_host_is_spi(host
) && rocr
&&
848 ((*rocr
& 0x41000000) == 0x41000000)) {
849 err
= mmc_set_uhs_voltage(host
, pocr
);
850 if (err
== -EAGAIN
) {
859 err
= mmc_send_cid(host
, cid
);
863 int mmc_sd_get_csd(struct mmc_host
*host
, struct mmc_card
*card
)
868 * Fetch CSD from card.
870 err
= mmc_send_csd(card
, card
->raw_csd
);
874 err
= mmc_decode_csd(card
);
881 static int mmc_sd_get_ro(struct mmc_host
*host
)
886 * Some systems don't feature a write-protect pin and don't need one.
887 * E.g. because they only have micro-SD card slot. For those systems
888 * assume that the SD card is always read-write.
890 if (host
->caps2
& MMC_CAP2_NO_WRITE_PROTECT
)
893 if (!host
->ops
->get_ro
)
896 ro
= host
->ops
->get_ro(host
);
901 int mmc_sd_setup_card(struct mmc_host
*host
, struct mmc_card
*card
,
908 * Fetch SCR from card.
910 err
= mmc_app_send_scr(card
);
914 err
= mmc_decode_scr(card
);
919 * Fetch and process SD Status register.
921 err
= mmc_read_ssr(card
);
925 /* Erase init depends on CSD and SSR */
926 mmc_init_erase(card
);
929 * Fetch switch information from card.
931 err
= mmc_read_switch(card
);
937 * For SPI, enable CRC as appropriate.
938 * This CRC enable is located AFTER the reading of the
939 * card registers because some SDHC cards are not able
940 * to provide valid CRCs for non-512-byte blocks.
942 if (mmc_host_is_spi(host
)) {
943 err
= mmc_spi_set_crc(host
, use_spi_crc
);
949 * Check if read-only switch is active.
952 int ro
= mmc_sd_get_ro(host
);
955 pr_warn("%s: host does not support reading read-only switch, assuming write-enable\n",
958 mmc_card_set_readonly(card
);
965 unsigned mmc_sd_get_max_clock(struct mmc_card
*card
)
967 unsigned max_dtr
= (unsigned int)-1;
969 if (mmc_card_hs(card
)) {
970 if (max_dtr
> card
->sw_caps
.hs_max_dtr
)
971 max_dtr
= card
->sw_caps
.hs_max_dtr
;
972 } else if (max_dtr
> card
->csd
.max_dtr
) {
973 max_dtr
= card
->csd
.max_dtr
;
979 static bool mmc_sd_card_using_v18(struct mmc_card
*card
)
982 * According to the SD spec., the Bus Speed Mode (function group 1) bits
983 * 2 to 4 are zero if the card is initialized at 3.3V signal level. Thus
984 * they can be used to determine if the card has already switched to
987 return card
->sw_caps
.sd3_bus_mode
&
988 (SD_MODE_UHS_SDR50
| SD_MODE_UHS_SDR104
| SD_MODE_UHS_DDR50
);
992 * Handle the detection and initialisation of a card.
994 * In the case of a resume, "oldcard" will contain the card
995 * we're trying to reinitialise.
997 static int mmc_sd_init_card(struct mmc_host
*host
, u32 ocr
,
998 struct mmc_card
*oldcard
)
1000 struct mmc_card
*card
;
1004 bool v18_fixup_failed
= false;
1006 WARN_ON(!host
->claimed
);
1008 err
= mmc_sd_get_cid(host
, ocr
, cid
, &rocr
);
1013 if (memcmp(cid
, oldcard
->raw_cid
, sizeof(cid
)) != 0) {
1014 pr_debug("%s: Perhaps the card was replaced\n",
1015 mmc_hostname(host
));
1022 * Allocate card structure.
1024 card
= mmc_alloc_card(host
, &sd_type
);
1026 return PTR_ERR(card
);
1029 card
->type
= MMC_TYPE_SD
;
1030 memcpy(card
->raw_cid
, cid
, sizeof(card
->raw_cid
));
1034 * Call the optional HC's init_card function to handle quirks.
1036 if (host
->ops
->init_card
)
1037 host
->ops
->init_card(host
, card
);
1040 * For native busses: get card RCA and quit open drain mode.
1042 if (!mmc_host_is_spi(host
)) {
1043 err
= mmc_send_relative_addr(host
, &card
->rca
);
1049 err
= mmc_sd_get_csd(host
, card
);
1053 mmc_decode_cid(card
);
1057 * handling only for cards supporting DSR and hosts requesting
1060 if (card
->csd
.dsr_imp
&& host
->dsr_req
)
1064 * Select card, as all following commands rely on that.
1066 if (!mmc_host_is_spi(host
)) {
1067 err
= mmc_select_card(card
);
1072 err
= mmc_sd_setup_card(host
, card
, oldcard
!= NULL
);
1077 * If the card has not been power cycled, it may still be using 1.8V
1078 * signaling. Detect that situation and try to initialize a UHS-I (1.8V)
1081 if (!v18_fixup_failed
&& !mmc_host_is_spi(host
) && mmc_host_uhs(host
) &&
1082 mmc_sd_card_using_v18(card
) &&
1083 host
->ios
.signal_voltage
!= MMC_SIGNAL_VOLTAGE_180
) {
1085 * Re-read switch information in case it has changed since
1086 * oldcard was initialized.
1089 err
= mmc_read_switch(card
);
1093 if (mmc_sd_card_using_v18(card
)) {
1094 if (mmc_host_set_uhs_voltage(host
) ||
1095 mmc_sd_init_uhs_card(card
)) {
1096 v18_fixup_failed
= true;
1097 mmc_power_cycle(host
, ocr
);
1099 mmc_remove_card(card
);
1106 /* Initialization sequence for UHS-I cards */
1107 if (rocr
& SD_ROCR_S18A
&& mmc_host_uhs(host
)) {
1108 err
= mmc_sd_init_uhs_card(card
);
1113 * Attempt to change to high-speed (if supported)
1115 err
= mmc_sd_switch_hs(card
);
1117 mmc_set_timing(card
->host
, MMC_TIMING_SD_HS
);
1124 mmc_set_clock(host
, mmc_sd_get_max_clock(card
));
1127 * Switch to wider bus (if supported).
1129 if ((host
->caps
& MMC_CAP_4_BIT_DATA
) &&
1130 (card
->scr
.bus_widths
& SD_SCR_BUS_WIDTH_4
)) {
1131 err
= mmc_app_set_bus_width(card
, MMC_BUS_WIDTH_4
);
1135 mmc_set_bus_width(host
, MMC_BUS_WIDTH_4
);
1139 if (host
->cqe_ops
&& !host
->cqe_enabled
) {
1140 err
= host
->cqe_ops
->cqe_enable(host
, card
);
1142 host
->cqe_enabled
= true;
1143 host
->hsq_enabled
= true;
1144 pr_info("%s: Host Software Queue enabled\n",
1145 mmc_hostname(host
));
1149 if (host
->caps2
& MMC_CAP2_AVOID_3_3V
&&
1150 host
->ios
.signal_voltage
== MMC_SIGNAL_VOLTAGE_330
) {
1151 pr_err("%s: Host failed to negotiate down from 3.3V\n",
1152 mmc_hostname(host
));
1162 mmc_remove_card(card
);
1168 * Host is being removed. Free up the current card.
1170 static void mmc_sd_remove(struct mmc_host
*host
)
1172 mmc_remove_card(host
->card
);
1177 * Card detection - card is alive.
1179 static int mmc_sd_alive(struct mmc_host
*host
)
1181 return mmc_send_status(host
->card
, NULL
);
1185 * Card detection callback from host.
1187 static void mmc_sd_detect(struct mmc_host
*host
)
1191 mmc_get_card(host
->card
, NULL
);
1194 * Just check if our card has been removed.
1196 err
= _mmc_detect_card_removed(host
);
1198 mmc_put_card(host
->card
, NULL
);
1201 mmc_sd_remove(host
);
1203 mmc_claim_host(host
);
1204 mmc_detach_bus(host
);
1205 mmc_power_off(host
);
1206 mmc_release_host(host
);
1210 static int _mmc_sd_suspend(struct mmc_host
*host
)
1214 mmc_claim_host(host
);
1216 if (mmc_card_suspended(host
->card
))
1219 if (!mmc_host_is_spi(host
))
1220 err
= mmc_deselect_cards(host
);
1223 mmc_power_off(host
);
1224 mmc_card_set_suspended(host
->card
);
1228 mmc_release_host(host
);
1233 * Callback for suspend
1235 static int mmc_sd_suspend(struct mmc_host
*host
)
1239 err
= _mmc_sd_suspend(host
);
1241 pm_runtime_disable(&host
->card
->dev
);
1242 pm_runtime_set_suspended(&host
->card
->dev
);
1249 * This function tries to determine if the same card is still present
1250 * and, if so, restore all state to it.
1252 static int _mmc_sd_resume(struct mmc_host
*host
)
1256 mmc_claim_host(host
);
1258 if (!mmc_card_suspended(host
->card
))
1261 mmc_power_up(host
, host
->card
->ocr
);
1262 err
= mmc_sd_init_card(host
, host
->card
->ocr
, host
->card
);
1263 mmc_card_clr_suspended(host
->card
);
1266 mmc_release_host(host
);
1271 * Callback for resume
1273 static int mmc_sd_resume(struct mmc_host
*host
)
1275 pm_runtime_enable(&host
->card
->dev
);
1280 * Callback for runtime_suspend.
1282 static int mmc_sd_runtime_suspend(struct mmc_host
*host
)
1286 if (!(host
->caps
& MMC_CAP_AGGRESSIVE_PM
))
1289 err
= _mmc_sd_suspend(host
);
1291 pr_err("%s: error %d doing aggressive suspend\n",
1292 mmc_hostname(host
), err
);
1298 * Callback for runtime_resume.
1300 static int mmc_sd_runtime_resume(struct mmc_host
*host
)
1304 err
= _mmc_sd_resume(host
);
1305 if (err
&& err
!= -ENOMEDIUM
)
1306 pr_err("%s: error %d doing runtime resume\n",
1307 mmc_hostname(host
), err
);
1312 static int mmc_sd_hw_reset(struct mmc_host
*host
)
1314 mmc_power_cycle(host
, host
->card
->ocr
);
1315 return mmc_sd_init_card(host
, host
->card
->ocr
, host
->card
);
1318 static const struct mmc_bus_ops mmc_sd_ops
= {
1319 .remove
= mmc_sd_remove
,
1320 .detect
= mmc_sd_detect
,
1321 .runtime_suspend
= mmc_sd_runtime_suspend
,
1322 .runtime_resume
= mmc_sd_runtime_resume
,
1323 .suspend
= mmc_sd_suspend
,
1324 .resume
= mmc_sd_resume
,
1325 .alive
= mmc_sd_alive
,
1326 .shutdown
= mmc_sd_suspend
,
1327 .hw_reset
= mmc_sd_hw_reset
,
1331 * Starting point for SD card init.
1333 int mmc_attach_sd(struct mmc_host
*host
)
1338 WARN_ON(!host
->claimed
);
1340 err
= mmc_send_app_op_cond(host
, 0, &ocr
);
1344 mmc_attach_bus(host
, &mmc_sd_ops
);
1345 if (host
->ocr_avail_sd
)
1346 host
->ocr_avail
= host
->ocr_avail_sd
;
1349 * We need to get OCR a different way for SPI.
1351 if (mmc_host_is_spi(host
)) {
1354 err
= mmc_spi_read_ocr(host
, 0, &ocr
);
1360 * Some SD cards claims an out of spec VDD voltage range. Let's treat
1361 * these bits as being in-valid and especially also bit7.
1365 rocr
= mmc_select_voltage(host
, ocr
);
1368 * Can we support the voltage(s) of the card(s)?
1376 * Detect and init the card.
1378 err
= mmc_sd_init_card(host
, rocr
, NULL
);
1382 mmc_release_host(host
);
1383 err
= mmc_add_card(host
->card
);
1387 mmc_claim_host(host
);
1391 mmc_remove_card(host
->card
);
1393 mmc_claim_host(host
);
1395 mmc_detach_bus(host
);
1397 pr_err("%s: error %d whilst initialising SD card\n",
1398 mmc_hostname(host
), err
);