2 * linux/drivers/mmc/mmc.c
4 * Copyright (C) 2003-2004 Russell King, All Rights Reserved.
5 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
6 * SD support Copyright (C) 2005 Pierre Ossman, All Rights Reserved.
7 * MMCv4 support Copyright (C) 2006 Philip Langdale, All Rights Reserved.
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
13 #include <linux/module.h>
14 #include <linux/init.h>
15 #include <linux/interrupt.h>
16 #include <linux/completion.h>
17 #include <linux/device.h>
18 #include <linux/delay.h>
19 #include <linux/pagemap.h>
20 #include <linux/err.h>
21 #include <asm/scatterlist.h>
22 #include <linux/scatterlist.h>
24 #include <linux/mmc/card.h>
25 #include <linux/mmc/host.h>
26 #include <linux/mmc/protocol.h>
33 * OCR Bit positions to 10s of Vdd mV.
35 static const unsigned short mmc_ocr_bit_to_vdd[] = {
36 150, 155, 160, 165, 170, 180, 190, 200,
37 210, 220, 230, 240, 250, 260, 270, 280,
38 290, 300, 310, 320, 330, 340, 350, 360
41 static const unsigned int tran_exp[] = {
42 10000, 100000, 1000000, 10000000,
46 static const unsigned char tran_mant[] = {
47 0, 10, 12, 13, 15, 20, 25, 30,
48 35, 40, 45, 50, 55, 60, 70, 80,
51 static const unsigned int tacc_exp[] = {
52 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000,
55 static const unsigned int tacc_mant[] = {
56 0, 10, 12, 13, 15, 20, 25, 30,
57 35, 40, 45, 50, 55, 60, 70, 80,
62 * mmc_request_done - finish processing an MMC request
63 * @host: MMC host which completed request
64 * @mrq: MMC request which request
66 * MMC drivers should call this function when they have completed
67 * their processing of a request.
69 void mmc_request_done(struct mmc_host *host, struct mmc_request *mrq)
71 struct mmc_command *cmd = mrq->cmd;
74 pr_debug("%s: req done (CMD%u): %d/%d/%d: %08x %08x %08x %08x\n",
75 mmc_hostname(host), cmd->opcode, err,
76 mrq->data ? mrq->data->error : 0,
77 mrq->stop ? mrq->stop->error : 0,
78 cmd->resp[0], cmd->resp[1], cmd->resp[2], cmd->resp[3]);
80 if (err && cmd->retries) {
83 host->ops->request(host, mrq);
84 } else if (mrq->done) {
89 EXPORT_SYMBOL(mmc_request_done);
92 * mmc_start_request - start a command on a host
93 * @host: MMC host to start command on
94 * @mrq: MMC request to start
96 * Queue a command on the specified host. We expect the
97 * caller to be holding the host lock with interrupts disabled.
100 mmc_start_request(struct mmc_host *host, struct mmc_request *mrq)
102 pr_debug("%s: starting CMD%u arg %08x flags %08x\n",
103 mmc_hostname(host), mrq->cmd->opcode,
104 mrq->cmd->arg, mrq->cmd->flags);
106 WARN_ON(host->card_busy == NULL);
111 mrq->cmd->data = mrq->data;
112 mrq->data->error = 0;
113 mrq->data->mrq = mrq;
115 mrq->data->stop = mrq->stop;
116 mrq->stop->error = 0;
117 mrq->stop->mrq = mrq;
120 host->ops->request(host, mrq);
123 EXPORT_SYMBOL(mmc_start_request);
125 static void mmc_wait_done(struct mmc_request *mrq)
127 complete(mrq->done_data);
130 int mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq)
132 DECLARE_COMPLETION_ONSTACK(complete);
134 mrq->done_data = &complete;
135 mrq->done = mmc_wait_done;
137 mmc_start_request(host, mrq);
139 wait_for_completion(&complete);
144 EXPORT_SYMBOL(mmc_wait_for_req);
147 * mmc_wait_for_cmd - start a command and wait for completion
148 * @host: MMC host to start command
149 * @cmd: MMC command to start
150 * @retries: maximum number of retries
152 * Start a new MMC command for a host, and wait for the command
153 * to complete. Return any error that occurred while the command
154 * was executing. Do not attempt to parse the response.
156 int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries)
158 struct mmc_request mrq;
160 BUG_ON(host->card_busy == NULL);
162 memset(&mrq, 0, sizeof(struct mmc_request));
164 memset(cmd->resp, 0, sizeof(cmd->resp));
165 cmd->retries = retries;
170 mmc_wait_for_req(host, &mrq);
175 EXPORT_SYMBOL(mmc_wait_for_cmd);
178 * mmc_wait_for_app_cmd - start an application command and wait for
180 * @host: MMC host to start command
181 * @rca: RCA to send MMC_APP_CMD to
182 * @cmd: MMC command to start
183 * @retries: maximum number of retries
185 * Sends a MMC_APP_CMD, checks the card response, sends the command
186 * in the parameter and waits for it to complete. Return any error
187 * that occurred while the command was executing. Do not attempt to
188 * parse the response.
190 int mmc_wait_for_app_cmd(struct mmc_host *host, unsigned int rca,
191 struct mmc_command *cmd, int retries)
193 struct mmc_request mrq;
194 struct mmc_command appcmd;
198 BUG_ON(host->card_busy == NULL);
201 err = MMC_ERR_INVALID;
204 * We have to resend MMC_APP_CMD for each attempt so
205 * we cannot use the retries field in mmc_command.
207 for (i = 0;i <= retries;i++) {
208 memset(&mrq, 0, sizeof(struct mmc_request));
210 appcmd.opcode = MMC_APP_CMD;
211 appcmd.arg = rca << 16;
212 appcmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
214 memset(appcmd.resp, 0, sizeof(appcmd.resp));
220 mmc_wait_for_req(host, &mrq);
227 /* Check that card supported application commands */
228 if (!(appcmd.resp[0] & R1_APP_CMD))
229 return MMC_ERR_FAILED;
231 memset(&mrq, 0, sizeof(struct mmc_request));
233 memset(cmd->resp, 0, sizeof(cmd->resp));
239 mmc_wait_for_req(host, &mrq);
242 if (cmd->error == MMC_ERR_NONE)
249 EXPORT_SYMBOL(mmc_wait_for_app_cmd);
252 * mmc_set_data_timeout - set the timeout for a data command
253 * @data: data phase for command
254 * @card: the MMC card associated with the data transfer
255 * @write: flag to differentiate reads from writes
257 void mmc_set_data_timeout(struct mmc_data *data, const struct mmc_card *card,
263 * SD cards use a 100 multiplier rather than 10
265 mult = mmc_card_sd(card) ? 100 : 10;
268 * Scale up the multiplier (and therefore the timeout) by
269 * the r2w factor for writes.
272 mult <<= card->csd.r2w_factor;
274 data->timeout_ns = card->csd.tacc_ns * mult;
275 data->timeout_clks = card->csd.tacc_clks * mult;
278 * SD cards also have an upper limit on the timeout.
280 if (mmc_card_sd(card)) {
281 unsigned int timeout_us, limit_us;
283 timeout_us = data->timeout_ns / 1000;
284 timeout_us += data->timeout_clks * 1000 /
285 (card->host->ios.clock / 1000);
292 if (timeout_us > limit_us) {
293 data->timeout_ns = limit_us * 1000;
294 data->timeout_clks = 0;
298 EXPORT_SYMBOL(mmc_set_data_timeout);
300 static int mmc_select_card(struct mmc_host *host, struct mmc_card *card);
303 * __mmc_claim_host - exclusively claim a host
304 * @host: mmc host to claim
305 * @card: mmc card to claim host for
307 * Claim a host for a set of operations. If a valid card
308 * is passed and this wasn't the last card selected, select
309 * the card before returning.
311 * Note: you should use mmc_card_claim_host or mmc_claim_host.
313 int __mmc_claim_host(struct mmc_host *host, struct mmc_card *card)
315 DECLARE_WAITQUEUE(wait, current);
319 add_wait_queue(&host->wq, &wait);
320 spin_lock_irqsave(&host->lock, flags);
322 set_current_state(TASK_UNINTERRUPTIBLE);
323 if (host->card_busy == NULL)
325 spin_unlock_irqrestore(&host->lock, flags);
327 spin_lock_irqsave(&host->lock, flags);
329 set_current_state(TASK_RUNNING);
330 host->card_busy = card;
331 spin_unlock_irqrestore(&host->lock, flags);
332 remove_wait_queue(&host->wq, &wait);
334 if (card != (void *)-1) {
335 err = mmc_select_card(host, card);
336 if (err != MMC_ERR_NONE)
343 EXPORT_SYMBOL(__mmc_claim_host);
346 * mmc_release_host - release a host
347 * @host: mmc host to release
349 * Release a MMC host, allowing others to claim the host
350 * for their operations.
352 void mmc_release_host(struct mmc_host *host)
356 BUG_ON(host->card_busy == NULL);
358 spin_lock_irqsave(&host->lock, flags);
359 host->card_busy = NULL;
360 spin_unlock_irqrestore(&host->lock, flags);
365 EXPORT_SYMBOL(mmc_release_host);
367 static inline void mmc_set_ios(struct mmc_host *host)
369 struct mmc_ios *ios = &host->ios;
371 pr_debug("%s: clock %uHz busmode %u powermode %u cs %u Vdd %u width %u\n",
372 mmc_hostname(host), ios->clock, ios->bus_mode,
373 ios->power_mode, ios->chip_select, ios->vdd,
376 host->ops->set_ios(host, ios);
379 static int mmc_select_card(struct mmc_host *host, struct mmc_card *card)
382 struct mmc_command cmd;
384 BUG_ON(host->card_busy == NULL);
386 if (host->card_selected == card)
389 host->card_selected = card;
391 cmd.opcode = MMC_SELECT_CARD;
392 cmd.arg = card->rca << 16;
393 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
395 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
396 if (err != MMC_ERR_NONE)
400 * We can only change the bus width of SD cards when
401 * they are selected so we have to put the handling
404 * The card is in 1 bit mode by default so
405 * we only need to change if it supports the
408 if (mmc_card_sd(card) &&
409 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) {
412 * Default bus width is 1 bit.
414 host->ios.bus_width = MMC_BUS_WIDTH_1;
416 if (host->caps & MMC_CAP_4_BIT_DATA) {
417 struct mmc_command cmd;
418 cmd.opcode = SD_APP_SET_BUS_WIDTH;
419 cmd.arg = SD_BUS_WIDTH_4;
420 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
422 err = mmc_wait_for_app_cmd(host, card->rca, &cmd,
424 if (err != MMC_ERR_NONE)
427 host->ios.bus_width = MMC_BUS_WIDTH_4;
437 * Ensure that no card is selected.
439 static void mmc_deselect_cards(struct mmc_host *host)
441 struct mmc_command cmd;
443 if (host->card_selected) {
444 host->card_selected = NULL;
446 cmd.opcode = MMC_SELECT_CARD;
448 cmd.flags = MMC_RSP_NONE | MMC_CMD_AC;
450 mmc_wait_for_cmd(host, &cmd, 0);
455 static inline void mmc_delay(unsigned int ms)
457 if (ms < 1000 / HZ) {
466 * Mask off any voltages we don't support and select
469 static u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
473 ocr &= host->ocr_avail;
490 #define UNSTUFF_BITS(resp,start,size) \
492 const int __size = size; \
493 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \
494 const int __off = 3 - ((start) / 32); \
495 const int __shft = (start) & 31; \
498 __res = resp[__off] >> __shft; \
499 if (__size + __shft > 32) \
500 __res |= resp[__off-1] << ((32 - __shft) % 32); \
505 * Given the decoded CSD structure, decode the raw CID to our CID structure.
507 static void mmc_decode_cid(struct mmc_card *card)
509 u32 *resp = card->raw_cid;
511 memset(&card->cid, 0, sizeof(struct mmc_cid));
513 if (mmc_card_sd(card)) {
515 * SD doesn't currently have a version field so we will
516 * have to assume we can parse this.
518 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
519 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
520 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
521 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
522 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
523 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
524 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
525 card->cid.hwrev = UNSTUFF_BITS(resp, 60, 4);
526 card->cid.fwrev = UNSTUFF_BITS(resp, 56, 4);
527 card->cid.serial = UNSTUFF_BITS(resp, 24, 32);
528 card->cid.year = UNSTUFF_BITS(resp, 12, 8);
529 card->cid.month = UNSTUFF_BITS(resp, 8, 4);
531 card->cid.year += 2000; /* SD cards year offset */
534 * The selection of the format here is based upon published
535 * specs from sandisk and from what people have reported.
537 switch (card->csd.mmca_vsn) {
538 case 0: /* MMC v1.0 - v1.2 */
539 case 1: /* MMC v1.4 */
540 card->cid.manfid = UNSTUFF_BITS(resp, 104, 24);
541 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
542 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
543 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
544 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
545 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
546 card->cid.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
547 card->cid.prod_name[6] = UNSTUFF_BITS(resp, 48, 8);
548 card->cid.hwrev = UNSTUFF_BITS(resp, 44, 4);
549 card->cid.fwrev = UNSTUFF_BITS(resp, 40, 4);
550 card->cid.serial = UNSTUFF_BITS(resp, 16, 24);
551 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
552 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
555 case 2: /* MMC v2.0 - v2.2 */
556 case 3: /* MMC v3.1 - v3.3 */
558 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
559 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
560 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
561 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
562 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
563 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
564 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
565 card->cid.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
566 card->cid.serial = UNSTUFF_BITS(resp, 16, 32);
567 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
568 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
572 printk("%s: card has unknown MMCA version %d\n",
573 mmc_hostname(card->host), card->csd.mmca_vsn);
574 mmc_card_set_bad(card);
581 * Given a 128-bit response, decode to our card CSD structure.
583 static void mmc_decode_csd(struct mmc_card *card)
585 struct mmc_csd *csd = &card->csd;
586 unsigned int e, m, csd_struct;
587 u32 *resp = card->raw_csd;
589 if (mmc_card_sd(card)) {
590 csd_struct = UNSTUFF_BITS(resp, 126, 2);
591 if (csd_struct != 0) {
592 printk("%s: unrecognised CSD structure version %d\n",
593 mmc_hostname(card->host), csd_struct);
594 mmc_card_set_bad(card);
598 m = UNSTUFF_BITS(resp, 115, 4);
599 e = UNSTUFF_BITS(resp, 112, 3);
600 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
601 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
603 m = UNSTUFF_BITS(resp, 99, 4);
604 e = UNSTUFF_BITS(resp, 96, 3);
605 csd->max_dtr = tran_exp[e] * tran_mant[m];
606 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
608 e = UNSTUFF_BITS(resp, 47, 3);
609 m = UNSTUFF_BITS(resp, 62, 12);
610 csd->capacity = (1 + m) << (e + 2);
612 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
613 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
614 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
615 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
616 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
617 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
618 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
621 * We only understand CSD structure v1.1 and v1.2.
622 * v1.2 has extra information in bits 15, 11 and 10.
624 csd_struct = UNSTUFF_BITS(resp, 126, 2);
625 if (csd_struct != 1 && csd_struct != 2) {
626 printk("%s: unrecognised CSD structure version %d\n",
627 mmc_hostname(card->host), csd_struct);
628 mmc_card_set_bad(card);
632 csd->mmca_vsn = UNSTUFF_BITS(resp, 122, 4);
633 m = UNSTUFF_BITS(resp, 115, 4);
634 e = UNSTUFF_BITS(resp, 112, 3);
635 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
636 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
638 m = UNSTUFF_BITS(resp, 99, 4);
639 e = UNSTUFF_BITS(resp, 96, 3);
640 csd->max_dtr = tran_exp[e] * tran_mant[m];
641 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
643 e = UNSTUFF_BITS(resp, 47, 3);
644 m = UNSTUFF_BITS(resp, 62, 12);
645 csd->capacity = (1 + m) << (e + 2);
647 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
648 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
649 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
650 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
651 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
652 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
653 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
658 * Given a 64-bit response, decode to our card SCR structure.
660 static void mmc_decode_scr(struct mmc_card *card)
662 struct sd_scr *scr = &card->scr;
663 unsigned int scr_struct;
666 BUG_ON(!mmc_card_sd(card));
668 resp[3] = card->raw_scr[1];
669 resp[2] = card->raw_scr[0];
671 scr_struct = UNSTUFF_BITS(resp, 60, 4);
672 if (scr_struct != 0) {
673 printk("%s: unrecognised SCR structure version %d\n",
674 mmc_hostname(card->host), scr_struct);
675 mmc_card_set_bad(card);
679 scr->sda_vsn = UNSTUFF_BITS(resp, 56, 4);
680 scr->bus_widths = UNSTUFF_BITS(resp, 48, 4);
684 * Locate a MMC card on this MMC host given a raw CID.
686 static struct mmc_card *mmc_find_card(struct mmc_host *host, u32 *raw_cid)
688 struct mmc_card *card;
690 list_for_each_entry(card, &host->cards, node) {
691 if (memcmp(card->raw_cid, raw_cid, sizeof(card->raw_cid)) == 0)
698 * Allocate a new MMC card, and assign a unique RCA.
700 static struct mmc_card *
701 mmc_alloc_card(struct mmc_host *host, u32 *raw_cid, unsigned int *frca)
703 struct mmc_card *card, *c;
704 unsigned int rca = *frca;
706 card = kmalloc(sizeof(struct mmc_card), GFP_KERNEL);
708 return ERR_PTR(-ENOMEM);
710 mmc_init_card(card, host);
711 memcpy(card->raw_cid, raw_cid, sizeof(card->raw_cid));
714 list_for_each_entry(c, &host->cards, node)
728 * Tell attached cards to go to IDLE state
730 static void mmc_idle_cards(struct mmc_host *host)
732 struct mmc_command cmd;
734 host->ios.chip_select = MMC_CS_HIGH;
739 cmd.opcode = MMC_GO_IDLE_STATE;
741 cmd.flags = MMC_RSP_NONE | MMC_CMD_BC;
743 mmc_wait_for_cmd(host, &cmd, 0);
747 host->ios.chip_select = MMC_CS_DONTCARE;
754 * Apply power to the MMC stack. This is a two-stage process.
755 * First, we enable power to the card without the clock running.
756 * We then wait a bit for the power to stabilise. Finally,
757 * enable the bus drivers and clock to the card.
759 * We must _NOT_ enable the clock prior to power stablising.
761 * If a host does all the power sequencing itself, ignore the
762 * initial MMC_POWER_UP stage.
764 static void mmc_power_up(struct mmc_host *host)
766 int bit = fls(host->ocr_avail) - 1;
769 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
770 host->ios.chip_select = MMC_CS_DONTCARE;
771 host->ios.power_mode = MMC_POWER_UP;
772 host->ios.bus_width = MMC_BUS_WIDTH_1;
777 host->ios.clock = host->f_min;
778 host->ios.power_mode = MMC_POWER_ON;
784 static void mmc_power_off(struct mmc_host *host)
788 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
789 host->ios.chip_select = MMC_CS_DONTCARE;
790 host->ios.power_mode = MMC_POWER_OFF;
791 host->ios.bus_width = MMC_BUS_WIDTH_1;
795 static int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
797 struct mmc_command cmd;
800 cmd.opcode = MMC_SEND_OP_COND;
802 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
804 for (i = 100; i; i--) {
805 err = mmc_wait_for_cmd(host, &cmd, 0);
806 if (err != MMC_ERR_NONE)
809 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
812 err = MMC_ERR_TIMEOUT;
823 static int mmc_send_app_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
825 struct mmc_command cmd;
828 cmd.opcode = SD_APP_OP_COND;
830 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
832 for (i = 100; i; i--) {
833 err = mmc_wait_for_app_cmd(host, 0, &cmd, CMD_RETRIES);
834 if (err != MMC_ERR_NONE)
837 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
840 err = MMC_ERR_TIMEOUT;
852 * Discover cards by requesting their CID. If this command
853 * times out, it is not an error; there are no further cards
854 * to be discovered. Add new cards to the list.
856 * Create a mmc_card entry for each discovered card, assigning
857 * it an RCA, and save the raw CID for decoding later.
859 static void mmc_discover_cards(struct mmc_host *host)
861 struct mmc_card *card;
862 unsigned int first_rca = 1, err;
865 struct mmc_command cmd;
867 cmd.opcode = MMC_ALL_SEND_CID;
869 cmd.flags = MMC_RSP_R2 | MMC_CMD_BCR;
871 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
872 if (err == MMC_ERR_TIMEOUT) {
876 if (err != MMC_ERR_NONE) {
877 printk(KERN_ERR "%s: error requesting CID: %d\n",
878 mmc_hostname(host), err);
882 card = mmc_find_card(host, cmd.resp);
884 card = mmc_alloc_card(host, cmd.resp, &first_rca);
889 list_add(&card->node, &host->cards);
892 card->state &= ~MMC_STATE_DEAD;
894 if (host->mode == MMC_MODE_SD) {
895 mmc_card_set_sd(card);
897 cmd.opcode = SD_SEND_RELATIVE_ADDR;
899 cmd.flags = MMC_RSP_R6 | MMC_CMD_BCR;
901 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
902 if (err != MMC_ERR_NONE)
903 mmc_card_set_dead(card);
905 card->rca = cmd.resp[0] >> 16;
907 if (!host->ops->get_ro) {
908 printk(KERN_WARNING "%s: host does not "
909 "support reading read-only "
910 "switch. assuming write-enable.\n",
913 if (host->ops->get_ro(host))
914 mmc_card_set_readonly(card);
918 cmd.opcode = MMC_SET_RELATIVE_ADDR;
919 cmd.arg = card->rca << 16;
920 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
922 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
923 if (err != MMC_ERR_NONE)
924 mmc_card_set_dead(card);
929 static void mmc_read_csds(struct mmc_host *host)
931 struct mmc_card *card;
933 list_for_each_entry(card, &host->cards, node) {
934 struct mmc_command cmd;
937 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
940 cmd.opcode = MMC_SEND_CSD;
941 cmd.arg = card->rca << 16;
942 cmd.flags = MMC_RSP_R2 | MMC_CMD_AC;
944 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
945 if (err != MMC_ERR_NONE) {
946 mmc_card_set_dead(card);
950 memcpy(card->raw_csd, cmd.resp, sizeof(card->raw_csd));
952 mmc_decode_csd(card);
953 mmc_decode_cid(card);
957 static void mmc_process_ext_csds(struct mmc_host *host)
960 struct mmc_card *card;
962 struct mmc_request mrq;
963 struct mmc_command cmd;
964 struct mmc_data data;
966 struct scatterlist sg;
969 * As the ext_csd is so large and mostly unused, we don't store the
970 * raw block in mmc_card.
973 ext_csd = kmalloc(512, GFP_KERNEL);
975 printk("%s: could not allocate a buffer to receive the ext_csd."
976 "mmc v4 cards will be treated as v3.\n",
981 list_for_each_entry(card, &host->cards, node) {
982 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
984 if (mmc_card_sd(card))
986 if (card->csd.mmca_vsn < CSD_SPEC_VER_4)
989 err = mmc_select_card(host, card);
990 if (err != MMC_ERR_NONE) {
991 mmc_card_set_dead(card);
995 memset(&cmd, 0, sizeof(struct mmc_command));
997 cmd.opcode = MMC_SEND_EXT_CSD;
999 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1001 memset(&data, 0, sizeof(struct mmc_data));
1003 mmc_set_data_timeout(&data, card, 0);
1007 data.flags = MMC_DATA_READ;
1011 memset(&mrq, 0, sizeof(struct mmc_request));
1016 sg_init_one(&sg, ext_csd, 512);
1018 mmc_wait_for_req(host, &mrq);
1020 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1021 mmc_card_set_dead(card);
1025 switch (ext_csd[EXT_CSD_CARD_TYPE]) {
1026 case EXT_CSD_CARD_TYPE_52 | EXT_CSD_CARD_TYPE_26:
1027 card->ext_csd.hs_max_dtr = 52000000;
1029 case EXT_CSD_CARD_TYPE_26:
1030 card->ext_csd.hs_max_dtr = 26000000;
1033 /* MMC v4 spec says this cannot happen */
1034 printk("%s: card is mmc v4 but doesn't support "
1035 "any high-speed modes.\n",
1036 mmc_hostname(card->host));
1037 mmc_card_set_bad(card);
1041 /* Activate highspeed support. */
1042 cmd.opcode = MMC_SWITCH;
1043 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1044 (EXT_CSD_HS_TIMING << 16) |
1046 EXT_CSD_CMD_SET_NORMAL;
1047 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1049 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1050 if (err != MMC_ERR_NONE) {
1051 printk("%s: failed to switch card to mmc v4 "
1052 "high-speed mode.\n",
1053 mmc_hostname(card->host));
1057 mmc_card_set_highspeed(card);
1059 /* Check for host support for wide-bus modes. */
1060 if (!(host->caps & MMC_CAP_4_BIT_DATA)) {
1064 /* Activate 4-bit support. */
1065 cmd.opcode = MMC_SWITCH;
1066 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1067 (EXT_CSD_BUS_WIDTH << 16) |
1068 (EXT_CSD_BUS_WIDTH_4 << 8) |
1069 EXT_CSD_CMD_SET_NORMAL;
1070 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1072 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1073 if (err != MMC_ERR_NONE) {
1074 printk("%s: failed to switch card to "
1075 "mmc v4 4-bit bus mode.\n",
1076 mmc_hostname(card->host));
1080 host->ios.bus_width = MMC_BUS_WIDTH_4;
1085 mmc_deselect_cards(host);
1088 static void mmc_read_scrs(struct mmc_host *host)
1091 struct mmc_card *card;
1092 struct mmc_request mrq;
1093 struct mmc_command cmd;
1094 struct mmc_data data;
1095 struct scatterlist sg;
1097 list_for_each_entry(card, &host->cards, node) {
1098 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1100 if (!mmc_card_sd(card))
1103 err = mmc_select_card(host, card);
1104 if (err != MMC_ERR_NONE) {
1105 mmc_card_set_dead(card);
1109 memset(&cmd, 0, sizeof(struct mmc_command));
1111 cmd.opcode = MMC_APP_CMD;
1112 cmd.arg = card->rca << 16;
1113 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1115 err = mmc_wait_for_cmd(host, &cmd, 0);
1116 if ((err != MMC_ERR_NONE) || !(cmd.resp[0] & R1_APP_CMD)) {
1117 mmc_card_set_dead(card);
1121 memset(&cmd, 0, sizeof(struct mmc_command));
1123 cmd.opcode = SD_APP_SEND_SCR;
1125 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1127 memset(&data, 0, sizeof(struct mmc_data));
1129 mmc_set_data_timeout(&data, card, 0);
1131 data.blksz = 1 << 3;
1133 data.flags = MMC_DATA_READ;
1137 memset(&mrq, 0, sizeof(struct mmc_request));
1142 sg_init_one(&sg, (u8*)card->raw_scr, 8);
1144 mmc_wait_for_req(host, &mrq);
1146 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1147 mmc_card_set_dead(card);
1151 card->raw_scr[0] = ntohl(card->raw_scr[0]);
1152 card->raw_scr[1] = ntohl(card->raw_scr[1]);
1154 mmc_decode_scr(card);
1157 mmc_deselect_cards(host);
1160 static void mmc_read_switch_caps(struct mmc_host *host)
1163 struct mmc_card *card;
1164 struct mmc_request mrq;
1165 struct mmc_command cmd;
1166 struct mmc_data data;
1167 unsigned char *status;
1168 struct scatterlist sg;
1170 status = kmalloc(64, GFP_KERNEL);
1172 printk(KERN_WARNING "%s: Unable to allocate buffer for "
1173 "reading switch capabilities.\n",
1174 mmc_hostname(host));
1178 list_for_each_entry(card, &host->cards, node) {
1179 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1181 if (!mmc_card_sd(card))
1183 if (card->scr.sda_vsn < SCR_SPEC_VER_1)
1186 err = mmc_select_card(host, card);
1187 if (err != MMC_ERR_NONE) {
1188 mmc_card_set_dead(card);
1192 memset(&cmd, 0, sizeof(struct mmc_command));
1194 cmd.opcode = SD_SWITCH;
1195 cmd.arg = 0x00FFFFF1;
1196 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1198 memset(&data, 0, sizeof(struct mmc_data));
1200 mmc_set_data_timeout(&data, card, 0);
1204 data.flags = MMC_DATA_READ;
1208 memset(&mrq, 0, sizeof(struct mmc_request));
1213 sg_init_one(&sg, status, 64);
1215 mmc_wait_for_req(host, &mrq);
1217 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1218 mmc_card_set_dead(card);
1222 if (status[13] & 0x02)
1223 card->sw_caps.hs_max_dtr = 50000000;
1225 memset(&cmd, 0, sizeof(struct mmc_command));
1227 cmd.opcode = SD_SWITCH;
1228 cmd.arg = 0x80FFFFF1;
1229 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1231 memset(&data, 0, sizeof(struct mmc_data));
1233 mmc_set_data_timeout(&data, card, 0);
1237 data.flags = MMC_DATA_READ;
1241 memset(&mrq, 0, sizeof(struct mmc_request));
1246 sg_init_one(&sg, status, 64);
1248 mmc_wait_for_req(host, &mrq);
1250 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1251 mmc_card_set_dead(card);
1255 if ((status[16] & 0xF) != 1) {
1256 printk(KERN_WARNING "%s: Problem switching card "
1257 "into high-speed mode!\n",
1258 mmc_hostname(host));
1262 mmc_card_set_highspeed(card);
1267 mmc_deselect_cards(host);
1270 static unsigned int mmc_calculate_clock(struct mmc_host *host)
1272 struct mmc_card *card;
1273 unsigned int max_dtr = host->f_max;
1275 list_for_each_entry(card, &host->cards, node)
1276 if (!mmc_card_dead(card)) {
1277 if (mmc_card_highspeed(card) && mmc_card_sd(card)) {
1278 if (max_dtr > card->sw_caps.hs_max_dtr)
1279 max_dtr = card->sw_caps.hs_max_dtr;
1280 } else if (mmc_card_highspeed(card) && !mmc_card_sd(card)) {
1281 if (max_dtr > card->ext_csd.hs_max_dtr)
1282 max_dtr = card->ext_csd.hs_max_dtr;
1283 } else if (max_dtr > card->csd.max_dtr) {
1284 max_dtr = card->csd.max_dtr;
1288 pr_debug("%s: selected %d.%03dMHz transfer rate\n",
1290 max_dtr / 1000000, (max_dtr / 1000) % 1000);
1296 * Check whether cards we already know about are still present.
1297 * We do this by requesting status, and checking whether a card
1300 * A request for status does not cause a state change in data
1303 static void mmc_check_cards(struct mmc_host *host)
1305 struct list_head *l, *n;
1307 mmc_deselect_cards(host);
1309 list_for_each_safe(l, n, &host->cards) {
1310 struct mmc_card *card = mmc_list_to_card(l);
1311 struct mmc_command cmd;
1314 cmd.opcode = MMC_SEND_STATUS;
1315 cmd.arg = card->rca << 16;
1316 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1318 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1319 if (err == MMC_ERR_NONE)
1322 mmc_card_set_dead(card);
1326 static void mmc_setup(struct mmc_host *host)
1328 if (host->ios.power_mode != MMC_POWER_ON) {
1332 host->mode = MMC_MODE_SD;
1335 mmc_idle_cards(host);
1337 err = mmc_send_app_op_cond(host, 0, &ocr);
1340 * If we fail to detect any SD cards then try
1341 * searching for MMC cards.
1343 if (err != MMC_ERR_NONE) {
1344 host->mode = MMC_MODE_MMC;
1346 err = mmc_send_op_cond(host, 0, &ocr);
1347 if (err != MMC_ERR_NONE)
1351 host->ocr = mmc_select_voltage(host, ocr);
1354 * Since we're changing the OCR value, we seem to
1355 * need to tell some cards to go back to the idle
1356 * state. We wait 1ms to give cards time to
1360 mmc_idle_cards(host);
1362 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
1363 host->ios.clock = host->f_min;
1367 * We should remember the OCR mask from the existing
1368 * cards, and detect the new cards OCR mask, combine
1369 * the two and re-select the VDD. However, if we do
1370 * change VDD, we should do an idle, and then do a
1371 * full re-initialisation. We would need to notify
1372 * drivers so that they can re-setup the cards as
1373 * well, while keeping their queues at bay.
1375 * For the moment, we take the easy way out - if the
1376 * new cards don't like our currently selected VDD,
1377 * they drop off the bus.
1385 * Send the selected OCR multiple times... until the cards
1386 * all get the idea that they should be ready for CMD2.
1387 * (My SanDisk card seems to need this.)
1389 if (host->mode == MMC_MODE_SD)
1390 mmc_send_app_op_cond(host, host->ocr, NULL);
1392 mmc_send_op_cond(host, host->ocr, NULL);
1394 mmc_discover_cards(host);
1397 * Ok, now switch to push-pull mode.
1399 host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
1402 mmc_read_csds(host);
1404 if (host->mode == MMC_MODE_SD) {
1405 mmc_read_scrs(host);
1406 mmc_read_switch_caps(host);
1408 mmc_process_ext_csds(host);
1413 * mmc_detect_change - process change of state on a MMC socket
1414 * @host: host which changed state.
1415 * @delay: optional delay to wait before detection (jiffies)
1417 * All we know is that card(s) have been inserted or removed
1418 * from the socket(s). We don't know which socket or cards.
1420 void mmc_detect_change(struct mmc_host *host, unsigned long delay)
1422 mmc_schedule_delayed_work(&host->detect, delay);
1425 EXPORT_SYMBOL(mmc_detect_change);
1428 static void mmc_rescan(struct work_struct *work)
1430 struct mmc_host *host =
1431 container_of(work, struct mmc_host, detect.work);
1432 struct list_head *l, *n;
1433 unsigned char power_mode;
1435 mmc_claim_host(host);
1438 * Check for removed cards and newly inserted ones. We check for
1439 * removed cards first so we can intelligently re-select the VDD.
1441 power_mode = host->ios.power_mode;
1442 if (power_mode == MMC_POWER_ON)
1443 mmc_check_cards(host);
1448 * Some broken cards process CMD1 even in stand-by state. There is
1449 * no reply, but an ILLEGAL_COMMAND error is cached and returned
1450 * after next command. We poll for card status here to clear any
1451 * possibly pending error.
1453 if (power_mode == MMC_POWER_ON)
1454 mmc_check_cards(host);
1456 if (!list_empty(&host->cards)) {
1458 * (Re-)calculate the fastest clock rate which the
1459 * attached cards and the host support.
1461 host->ios.clock = mmc_calculate_clock(host);
1465 mmc_release_host(host);
1467 list_for_each_safe(l, n, &host->cards) {
1468 struct mmc_card *card = mmc_list_to_card(l);
1471 * If this is a new and good card, register it.
1473 if (!mmc_card_present(card) && !mmc_card_dead(card)) {
1474 if (mmc_register_card(card))
1475 mmc_card_set_dead(card);
1477 mmc_card_set_present(card);
1481 * If this card is dead, destroy it.
1483 if (mmc_card_dead(card)) {
1484 list_del(&card->node);
1485 mmc_remove_card(card);
1490 * If we discover that there are no cards on the
1491 * bus, turn off the clock and power down.
1493 if (list_empty(&host->cards))
1494 mmc_power_off(host);
1499 * mmc_alloc_host - initialise the per-host structure.
1500 * @extra: sizeof private data structure
1501 * @dev: pointer to host device model structure
1503 * Initialise the per-host structure.
1505 struct mmc_host *mmc_alloc_host(int extra, struct device *dev)
1507 struct mmc_host *host;
1509 host = mmc_alloc_host_sysfs(extra, dev);
1511 spin_lock_init(&host->lock);
1512 init_waitqueue_head(&host->wq);
1513 INIT_LIST_HEAD(&host->cards);
1514 INIT_DELAYED_WORK(&host->detect, mmc_rescan);
1517 * By default, hosts do not support SGIO or large requests.
1518 * They have to set these according to their abilities.
1520 host->max_hw_segs = 1;
1521 host->max_phys_segs = 1;
1522 host->max_sectors = 1 << (PAGE_CACHE_SHIFT - 9);
1523 host->max_seg_size = PAGE_CACHE_SIZE;
1529 EXPORT_SYMBOL(mmc_alloc_host);
1532 * mmc_add_host - initialise host hardware
1535 int mmc_add_host(struct mmc_host *host)
1539 ret = mmc_add_host_sysfs(host);
1541 mmc_power_off(host);
1542 mmc_detect_change(host, 0);
1548 EXPORT_SYMBOL(mmc_add_host);
1551 * mmc_remove_host - remove host hardware
1554 * Unregister and remove all cards associated with this host,
1555 * and power down the MMC bus.
1557 void mmc_remove_host(struct mmc_host *host)
1559 struct list_head *l, *n;
1561 list_for_each_safe(l, n, &host->cards) {
1562 struct mmc_card *card = mmc_list_to_card(l);
1564 mmc_remove_card(card);
1567 mmc_power_off(host);
1568 mmc_remove_host_sysfs(host);
1571 EXPORT_SYMBOL(mmc_remove_host);
1574 * mmc_free_host - free the host structure
1577 * Free the host once all references to it have been dropped.
1579 void mmc_free_host(struct mmc_host *host)
1581 mmc_flush_scheduled_work();
1582 mmc_free_host_sysfs(host);
1585 EXPORT_SYMBOL(mmc_free_host);
1590 * mmc_suspend_host - suspend a host
1592 * @state: suspend mode (PM_SUSPEND_xxx)
1594 int mmc_suspend_host(struct mmc_host *host, pm_message_t state)
1596 mmc_claim_host(host);
1597 mmc_deselect_cards(host);
1598 mmc_power_off(host);
1599 mmc_release_host(host);
1604 EXPORT_SYMBOL(mmc_suspend_host);
1607 * mmc_resume_host - resume a previously suspended host
1610 int mmc_resume_host(struct mmc_host *host)
1612 mmc_rescan(&host->detect.work);
1617 EXPORT_SYMBOL(mmc_resume_host);
1621 MODULE_LICENSE("GPL");