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 #ifdef CONFIG_MMC_DEBUG
106 pr_debug("%s: starting CMD%u arg %08x flags %08x\n",
107 mmc_hostname(host), mrq->cmd->opcode,
108 mrq->cmd->arg, mrq->cmd->flags);
110 WARN_ON(!host->claimed);
115 BUG_ON(mrq->data->blksz > host->max_blk_size);
116 BUG_ON(mrq->data->blocks > host->max_blk_count);
117 BUG_ON(mrq->data->blocks * mrq->data->blksz >
120 #ifdef CONFIG_MMC_DEBUG
122 for (i = 0;i < mrq->data->sg_len;i++)
123 sz += mrq->data->sg[i].length;
124 BUG_ON(sz != mrq->data->blocks * mrq->data->blksz);
127 mrq->cmd->data = mrq->data;
128 mrq->data->error = 0;
129 mrq->data->mrq = mrq;
131 mrq->data->stop = mrq->stop;
132 mrq->stop->error = 0;
133 mrq->stop->mrq = mrq;
136 host->ops->request(host, mrq);
139 EXPORT_SYMBOL(mmc_start_request);
141 static void mmc_wait_done(struct mmc_request *mrq)
143 complete(mrq->done_data);
146 int mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq)
148 DECLARE_COMPLETION_ONSTACK(complete);
150 mrq->done_data = &complete;
151 mrq->done = mmc_wait_done;
153 mmc_start_request(host, mrq);
155 wait_for_completion(&complete);
160 EXPORT_SYMBOL(mmc_wait_for_req);
163 * mmc_wait_for_cmd - start a command and wait for completion
164 * @host: MMC host to start command
165 * @cmd: MMC command to start
166 * @retries: maximum number of retries
168 * Start a new MMC command for a host, and wait for the command
169 * to complete. Return any error that occurred while the command
170 * was executing. Do not attempt to parse the response.
172 int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries)
174 struct mmc_request mrq;
176 BUG_ON(!host->claimed);
178 memset(&mrq, 0, sizeof(struct mmc_request));
180 memset(cmd->resp, 0, sizeof(cmd->resp));
181 cmd->retries = retries;
186 mmc_wait_for_req(host, &mrq);
191 EXPORT_SYMBOL(mmc_wait_for_cmd);
194 * mmc_wait_for_app_cmd - start an application command and wait for
196 * @host: MMC host to start command
197 * @rca: RCA to send MMC_APP_CMD to
198 * @cmd: MMC command to start
199 * @retries: maximum number of retries
201 * Sends a MMC_APP_CMD, checks the card response, sends the command
202 * in the parameter and waits for it to complete. Return any error
203 * that occurred while the command was executing. Do not attempt to
204 * parse the response.
206 int mmc_wait_for_app_cmd(struct mmc_host *host, unsigned int rca,
207 struct mmc_command *cmd, int retries)
209 struct mmc_request mrq;
210 struct mmc_command appcmd;
214 BUG_ON(!host->claimed);
217 err = MMC_ERR_INVALID;
220 * We have to resend MMC_APP_CMD for each attempt so
221 * we cannot use the retries field in mmc_command.
223 for (i = 0;i <= retries;i++) {
224 memset(&mrq, 0, sizeof(struct mmc_request));
226 appcmd.opcode = MMC_APP_CMD;
227 appcmd.arg = rca << 16;
228 appcmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
230 memset(appcmd.resp, 0, sizeof(appcmd.resp));
236 mmc_wait_for_req(host, &mrq);
243 /* Check that card supported application commands */
244 if (!(appcmd.resp[0] & R1_APP_CMD))
245 return MMC_ERR_FAILED;
247 memset(&mrq, 0, sizeof(struct mmc_request));
249 memset(cmd->resp, 0, sizeof(cmd->resp));
255 mmc_wait_for_req(host, &mrq);
258 if (cmd->error == MMC_ERR_NONE)
265 EXPORT_SYMBOL(mmc_wait_for_app_cmd);
268 * mmc_set_data_timeout - set the timeout for a data command
269 * @data: data phase for command
270 * @card: the MMC card associated with the data transfer
271 * @write: flag to differentiate reads from writes
273 void mmc_set_data_timeout(struct mmc_data *data, const struct mmc_card *card,
279 * SD cards use a 100 multiplier rather than 10
281 mult = mmc_card_sd(card) ? 100 : 10;
284 * Scale up the multiplier (and therefore the timeout) by
285 * the r2w factor for writes.
288 mult <<= card->csd.r2w_factor;
290 data->timeout_ns = card->csd.tacc_ns * mult;
291 data->timeout_clks = card->csd.tacc_clks * mult;
294 * SD cards also have an upper limit on the timeout.
296 if (mmc_card_sd(card)) {
297 unsigned int timeout_us, limit_us;
299 timeout_us = data->timeout_ns / 1000;
300 timeout_us += data->timeout_clks * 1000 /
301 (card->host->ios.clock / 1000);
309 * SDHC cards always use these fixed values.
311 if (timeout_us > limit_us || mmc_card_blockaddr(card)) {
312 data->timeout_ns = limit_us * 1000;
313 data->timeout_clks = 0;
317 EXPORT_SYMBOL(mmc_set_data_timeout);
319 static int mmc_select_card(struct mmc_host *host, struct mmc_card *card);
322 * __mmc_claim_host - exclusively claim a host
323 * @host: mmc host to claim
324 * @card: mmc card to claim host for
326 * Claim a host for a set of operations. If a valid card
327 * is passed and this wasn't the last card selected, select
328 * the card before returning.
330 * Note: you should use mmc_card_claim_host or mmc_claim_host.
332 int __mmc_claim_host(struct mmc_host *host, struct mmc_card *card)
334 DECLARE_WAITQUEUE(wait, current);
338 add_wait_queue(&host->wq, &wait);
339 spin_lock_irqsave(&host->lock, flags);
341 set_current_state(TASK_UNINTERRUPTIBLE);
344 spin_unlock_irqrestore(&host->lock, flags);
346 spin_lock_irqsave(&host->lock, flags);
348 set_current_state(TASK_RUNNING);
350 spin_unlock_irqrestore(&host->lock, flags);
351 remove_wait_queue(&host->wq, &wait);
353 if (card != (void *)-1) {
354 err = mmc_select_card(host, card);
355 if (err != MMC_ERR_NONE)
362 EXPORT_SYMBOL(__mmc_claim_host);
365 * mmc_release_host - release a host
366 * @host: mmc host to release
368 * Release a MMC host, allowing others to claim the host
369 * for their operations.
371 void mmc_release_host(struct mmc_host *host)
375 BUG_ON(!host->claimed);
377 spin_lock_irqsave(&host->lock, flags);
379 spin_unlock_irqrestore(&host->lock, flags);
384 EXPORT_SYMBOL(mmc_release_host);
386 static inline void mmc_set_ios(struct mmc_host *host)
388 struct mmc_ios *ios = &host->ios;
390 pr_debug("%s: clock %uHz busmode %u powermode %u cs %u Vdd %u "
391 "width %u timing %u\n",
392 mmc_hostname(host), ios->clock, ios->bus_mode,
393 ios->power_mode, ios->chip_select, ios->vdd,
394 ios->bus_width, ios->timing);
396 host->ops->set_ios(host, ios);
399 static int mmc_select_card(struct mmc_host *host, struct mmc_card *card)
402 struct mmc_command cmd;
404 BUG_ON(!host->claimed);
406 if (host->card_selected == card)
409 host->card_selected = card;
411 cmd.opcode = MMC_SELECT_CARD;
412 cmd.arg = card->rca << 16;
413 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
415 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
416 if (err != MMC_ERR_NONE)
420 * We can only change the bus width of SD cards when
421 * they are selected so we have to put the handling
424 * The card is in 1 bit mode by default so
425 * we only need to change if it supports the
428 if (mmc_card_sd(card) &&
429 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) {
432 * Default bus width is 1 bit.
434 host->ios.bus_width = MMC_BUS_WIDTH_1;
436 if (host->caps & MMC_CAP_4_BIT_DATA) {
437 struct mmc_command cmd;
438 cmd.opcode = SD_APP_SET_BUS_WIDTH;
439 cmd.arg = SD_BUS_WIDTH_4;
440 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
442 err = mmc_wait_for_app_cmd(host, card->rca, &cmd,
444 if (err != MMC_ERR_NONE)
447 host->ios.bus_width = MMC_BUS_WIDTH_4;
457 * Ensure that no card is selected.
459 static void mmc_deselect_cards(struct mmc_host *host)
461 struct mmc_command cmd;
463 if (host->card_selected) {
464 host->card_selected = NULL;
466 cmd.opcode = MMC_SELECT_CARD;
468 cmd.flags = MMC_RSP_NONE | MMC_CMD_AC;
470 mmc_wait_for_cmd(host, &cmd, 0);
475 static inline void mmc_delay(unsigned int ms)
477 if (ms < 1000 / HZ) {
486 * Mask off any voltages we don't support and select
489 static u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
493 ocr &= host->ocr_avail;
510 #define UNSTUFF_BITS(resp,start,size) \
512 const int __size = size; \
513 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \
514 const int __off = 3 - ((start) / 32); \
515 const int __shft = (start) & 31; \
518 __res = resp[__off] >> __shft; \
519 if (__size + __shft > 32) \
520 __res |= resp[__off-1] << ((32 - __shft) % 32); \
525 * Given the decoded CSD structure, decode the raw CID to our CID structure.
527 static void mmc_decode_cid(struct mmc_card *card)
529 u32 *resp = card->raw_cid;
531 memset(&card->cid, 0, sizeof(struct mmc_cid));
533 if (mmc_card_sd(card)) {
535 * SD doesn't currently have a version field so we will
536 * have to assume we can parse this.
538 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
539 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
540 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
541 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
542 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
543 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
544 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
545 card->cid.hwrev = UNSTUFF_BITS(resp, 60, 4);
546 card->cid.fwrev = UNSTUFF_BITS(resp, 56, 4);
547 card->cid.serial = UNSTUFF_BITS(resp, 24, 32);
548 card->cid.year = UNSTUFF_BITS(resp, 12, 8);
549 card->cid.month = UNSTUFF_BITS(resp, 8, 4);
551 card->cid.year += 2000; /* SD cards year offset */
554 * The selection of the format here is based upon published
555 * specs from sandisk and from what people have reported.
557 switch (card->csd.mmca_vsn) {
558 case 0: /* MMC v1.0 - v1.2 */
559 case 1: /* MMC v1.4 */
560 card->cid.manfid = UNSTUFF_BITS(resp, 104, 24);
561 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
562 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
563 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
564 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
565 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
566 card->cid.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
567 card->cid.prod_name[6] = UNSTUFF_BITS(resp, 48, 8);
568 card->cid.hwrev = UNSTUFF_BITS(resp, 44, 4);
569 card->cid.fwrev = UNSTUFF_BITS(resp, 40, 4);
570 card->cid.serial = UNSTUFF_BITS(resp, 16, 24);
571 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
572 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
575 case 2: /* MMC v2.0 - v2.2 */
576 case 3: /* MMC v3.1 - v3.3 */
578 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
579 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
580 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
581 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
582 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
583 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
584 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
585 card->cid.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
586 card->cid.serial = UNSTUFF_BITS(resp, 16, 32);
587 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
588 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
592 printk("%s: card has unknown MMCA version %d\n",
593 mmc_hostname(card->host), card->csd.mmca_vsn);
594 mmc_card_set_bad(card);
601 * Given a 128-bit response, decode to our card CSD structure.
603 static void mmc_decode_csd(struct mmc_card *card)
605 struct mmc_csd *csd = &card->csd;
606 unsigned int e, m, csd_struct;
607 u32 *resp = card->raw_csd;
609 if (mmc_card_sd(card)) {
610 csd_struct = UNSTUFF_BITS(resp, 126, 2);
612 switch (csd_struct) {
614 m = UNSTUFF_BITS(resp, 115, 4);
615 e = UNSTUFF_BITS(resp, 112, 3);
616 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
617 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
619 m = UNSTUFF_BITS(resp, 99, 4);
620 e = UNSTUFF_BITS(resp, 96, 3);
621 csd->max_dtr = tran_exp[e] * tran_mant[m];
622 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
624 e = UNSTUFF_BITS(resp, 47, 3);
625 m = UNSTUFF_BITS(resp, 62, 12);
626 csd->capacity = (1 + m) << (e + 2);
628 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
629 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
630 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
631 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
632 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
633 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
634 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
638 * This is a block-addressed SDHC card. Most
639 * interesting fields are unused and have fixed
640 * values. To avoid getting tripped by buggy cards,
641 * we assume those fixed values ourselves.
643 mmc_card_set_blockaddr(card);
645 csd->tacc_ns = 0; /* Unused */
646 csd->tacc_clks = 0; /* Unused */
648 m = UNSTUFF_BITS(resp, 99, 4);
649 e = UNSTUFF_BITS(resp, 96, 3);
650 csd->max_dtr = tran_exp[e] * tran_mant[m];
651 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
653 m = UNSTUFF_BITS(resp, 48, 22);
654 csd->capacity = (1 + m) << 10;
656 csd->read_blkbits = 9;
657 csd->read_partial = 0;
658 csd->write_misalign = 0;
659 csd->read_misalign = 0;
660 csd->r2w_factor = 4; /* Unused */
661 csd->write_blkbits = 9;
662 csd->write_partial = 0;
665 printk("%s: unrecognised CSD structure version %d\n",
666 mmc_hostname(card->host), csd_struct);
667 mmc_card_set_bad(card);
672 * We only understand CSD structure v1.1 and v1.2.
673 * v1.2 has extra information in bits 15, 11 and 10.
675 csd_struct = UNSTUFF_BITS(resp, 126, 2);
676 if (csd_struct != 1 && csd_struct != 2) {
677 printk("%s: unrecognised CSD structure version %d\n",
678 mmc_hostname(card->host), csd_struct);
679 mmc_card_set_bad(card);
683 csd->mmca_vsn = UNSTUFF_BITS(resp, 122, 4);
684 m = UNSTUFF_BITS(resp, 115, 4);
685 e = UNSTUFF_BITS(resp, 112, 3);
686 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
687 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
689 m = UNSTUFF_BITS(resp, 99, 4);
690 e = UNSTUFF_BITS(resp, 96, 3);
691 csd->max_dtr = tran_exp[e] * tran_mant[m];
692 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
694 e = UNSTUFF_BITS(resp, 47, 3);
695 m = UNSTUFF_BITS(resp, 62, 12);
696 csd->capacity = (1 + m) << (e + 2);
698 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
699 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
700 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
701 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
702 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
703 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
704 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
709 * Given a 64-bit response, decode to our card SCR structure.
711 static void mmc_decode_scr(struct mmc_card *card)
713 struct sd_scr *scr = &card->scr;
714 unsigned int scr_struct;
717 BUG_ON(!mmc_card_sd(card));
719 resp[3] = card->raw_scr[1];
720 resp[2] = card->raw_scr[0];
722 scr_struct = UNSTUFF_BITS(resp, 60, 4);
723 if (scr_struct != 0) {
724 printk("%s: unrecognised SCR structure version %d\n",
725 mmc_hostname(card->host), scr_struct);
726 mmc_card_set_bad(card);
730 scr->sda_vsn = UNSTUFF_BITS(resp, 56, 4);
731 scr->bus_widths = UNSTUFF_BITS(resp, 48, 4);
735 * Locate a MMC card on this MMC host given a raw CID.
737 static struct mmc_card *mmc_find_card(struct mmc_host *host, u32 *raw_cid)
739 struct mmc_card *card;
741 list_for_each_entry(card, &host->cards, node) {
742 if (memcmp(card->raw_cid, raw_cid, sizeof(card->raw_cid)) == 0)
749 * Allocate a new MMC card, and assign a unique RCA.
751 static struct mmc_card *
752 mmc_alloc_card(struct mmc_host *host, u32 *raw_cid, unsigned int *frca)
754 struct mmc_card *card, *c;
755 unsigned int rca = *frca;
757 card = kmalloc(sizeof(struct mmc_card), GFP_KERNEL);
759 return ERR_PTR(-ENOMEM);
761 mmc_init_card(card, host);
762 memcpy(card->raw_cid, raw_cid, sizeof(card->raw_cid));
765 list_for_each_entry(c, &host->cards, node)
779 * Tell attached cards to go to IDLE state
781 static void mmc_idle_cards(struct mmc_host *host)
783 struct mmc_command cmd;
785 host->ios.chip_select = MMC_CS_HIGH;
790 cmd.opcode = MMC_GO_IDLE_STATE;
792 cmd.flags = MMC_RSP_NONE | MMC_CMD_BC;
794 mmc_wait_for_cmd(host, &cmd, 0);
798 host->ios.chip_select = MMC_CS_DONTCARE;
805 * Apply power to the MMC stack. This is a two-stage process.
806 * First, we enable power to the card without the clock running.
807 * We then wait a bit for the power to stabilise. Finally,
808 * enable the bus drivers and clock to the card.
810 * We must _NOT_ enable the clock prior to power stablising.
812 * If a host does all the power sequencing itself, ignore the
813 * initial MMC_POWER_UP stage.
815 static void mmc_power_up(struct mmc_host *host)
817 int bit = fls(host->ocr_avail) - 1;
820 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
821 host->ios.chip_select = MMC_CS_DONTCARE;
822 host->ios.power_mode = MMC_POWER_UP;
823 host->ios.bus_width = MMC_BUS_WIDTH_1;
824 host->ios.timing = MMC_TIMING_LEGACY;
829 host->ios.clock = host->f_min;
830 host->ios.power_mode = MMC_POWER_ON;
836 static void mmc_power_off(struct mmc_host *host)
840 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
841 host->ios.chip_select = MMC_CS_DONTCARE;
842 host->ios.power_mode = MMC_POWER_OFF;
843 host->ios.bus_width = MMC_BUS_WIDTH_1;
844 host->ios.timing = MMC_TIMING_LEGACY;
848 static int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
850 struct mmc_command cmd;
853 cmd.opcode = MMC_SEND_OP_COND;
855 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
857 for (i = 100; i; i--) {
858 err = mmc_wait_for_cmd(host, &cmd, 0);
859 if (err != MMC_ERR_NONE)
862 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
865 err = MMC_ERR_TIMEOUT;
876 static int mmc_send_app_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
878 struct mmc_command cmd;
881 cmd.opcode = SD_APP_OP_COND;
883 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
885 for (i = 100; i; i--) {
886 err = mmc_wait_for_app_cmd(host, 0, &cmd, CMD_RETRIES);
887 if (err != MMC_ERR_NONE)
890 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
893 err = MMC_ERR_TIMEOUT;
904 static int mmc_send_if_cond(struct mmc_host *host, u32 ocr, int *rsd2)
906 struct mmc_command cmd;
908 static const u8 test_pattern = 0xAA;
911 * To support SD 2.0 cards, we must always invoke SD_SEND_IF_COND
912 * before SD_APP_OP_COND. This command will harmlessly fail for
915 cmd.opcode = SD_SEND_IF_COND;
916 cmd.arg = ((ocr & 0xFF8000) != 0) << 8 | test_pattern;
917 cmd.flags = MMC_RSP_R7 | MMC_CMD_BCR;
919 err = mmc_wait_for_cmd(host, &cmd, 0);
920 if (err == MMC_ERR_NONE) {
921 if ((cmd.resp[0] & 0xFF) == test_pattern) {
925 err = MMC_ERR_FAILED;
929 * Treat errors as SD 1.0 card.
940 * Discover cards by requesting their CID. If this command
941 * times out, it is not an error; there are no further cards
942 * to be discovered. Add new cards to the list.
944 * Create a mmc_card entry for each discovered card, assigning
945 * it an RCA, and save the raw CID for decoding later.
947 static void mmc_discover_cards(struct mmc_host *host)
949 struct mmc_card *card;
950 unsigned int first_rca = 1, err;
953 struct mmc_command cmd;
955 cmd.opcode = MMC_ALL_SEND_CID;
957 cmd.flags = MMC_RSP_R2 | MMC_CMD_BCR;
959 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
960 if (err == MMC_ERR_TIMEOUT) {
964 if (err != MMC_ERR_NONE) {
965 printk(KERN_ERR "%s: error requesting CID: %d\n",
966 mmc_hostname(host), err);
970 card = mmc_find_card(host, cmd.resp);
972 card = mmc_alloc_card(host, cmd.resp, &first_rca);
977 list_add(&card->node, &host->cards);
980 card->state &= ~MMC_STATE_DEAD;
982 if (host->mode == MMC_MODE_SD) {
983 mmc_card_set_sd(card);
985 cmd.opcode = SD_SEND_RELATIVE_ADDR;
987 cmd.flags = MMC_RSP_R6 | MMC_CMD_BCR;
989 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
990 if (err != MMC_ERR_NONE)
991 mmc_card_set_dead(card);
993 card->rca = cmd.resp[0] >> 16;
995 if (!host->ops->get_ro) {
996 printk(KERN_WARNING "%s: host does not "
997 "support reading read-only "
998 "switch. assuming write-enable.\n",
1001 if (host->ops->get_ro(host))
1002 mmc_card_set_readonly(card);
1006 cmd.opcode = MMC_SET_RELATIVE_ADDR;
1007 cmd.arg = card->rca << 16;
1008 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1010 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1011 if (err != MMC_ERR_NONE)
1012 mmc_card_set_dead(card);
1017 static void mmc_read_csds(struct mmc_host *host)
1019 struct mmc_card *card;
1021 list_for_each_entry(card, &host->cards, node) {
1022 struct mmc_command cmd;
1025 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1028 cmd.opcode = MMC_SEND_CSD;
1029 cmd.arg = card->rca << 16;
1030 cmd.flags = MMC_RSP_R2 | MMC_CMD_AC;
1032 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1033 if (err != MMC_ERR_NONE) {
1034 mmc_card_set_dead(card);
1038 memcpy(card->raw_csd, cmd.resp, sizeof(card->raw_csd));
1040 mmc_decode_csd(card);
1041 mmc_decode_cid(card);
1045 static void mmc_process_ext_csds(struct mmc_host *host)
1048 struct mmc_card *card;
1050 struct mmc_request mrq;
1051 struct mmc_command cmd;
1052 struct mmc_data data;
1054 struct scatterlist sg;
1057 * As the ext_csd is so large and mostly unused, we don't store the
1058 * raw block in mmc_card.
1061 ext_csd = kmalloc(512, GFP_KERNEL);
1063 printk("%s: could not allocate a buffer to receive the ext_csd."
1064 "mmc v4 cards will be treated as v3.\n",
1065 mmc_hostname(host));
1069 list_for_each_entry(card, &host->cards, node) {
1070 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1072 if (mmc_card_sd(card))
1074 if (card->csd.mmca_vsn < CSD_SPEC_VER_4)
1077 err = mmc_select_card(host, card);
1078 if (err != MMC_ERR_NONE) {
1079 mmc_card_set_dead(card);
1083 memset(&cmd, 0, sizeof(struct mmc_command));
1085 cmd.opcode = MMC_SEND_EXT_CSD;
1087 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1089 memset(&data, 0, sizeof(struct mmc_data));
1091 mmc_set_data_timeout(&data, card, 0);
1095 data.flags = MMC_DATA_READ;
1099 memset(&mrq, 0, sizeof(struct mmc_request));
1104 sg_init_one(&sg, ext_csd, 512);
1106 mmc_wait_for_req(host, &mrq);
1108 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1109 if (card->csd.capacity == (4096 * 512)) {
1110 printk(KERN_ERR "%s: unable to read EXT_CSD "
1111 "on a possible high capacity card. "
1112 "Card will be ignored.\n",
1113 mmc_hostname(card->host));
1114 mmc_card_set_dead(card);
1116 printk(KERN_WARNING "%s: unable to read "
1117 "EXT_CSD, performance might "
1119 mmc_hostname(card->host));
1124 card->ext_csd.sectors =
1125 ext_csd[EXT_CSD_SEC_CNT + 0] << 0 |
1126 ext_csd[EXT_CSD_SEC_CNT + 1] << 8 |
1127 ext_csd[EXT_CSD_SEC_CNT + 2] << 16 |
1128 ext_csd[EXT_CSD_SEC_CNT + 3] << 24;
1129 if (card->ext_csd.sectors)
1130 mmc_card_set_blockaddr(card);
1132 switch (ext_csd[EXT_CSD_CARD_TYPE]) {
1133 case EXT_CSD_CARD_TYPE_52 | EXT_CSD_CARD_TYPE_26:
1134 card->ext_csd.hs_max_dtr = 52000000;
1136 case EXT_CSD_CARD_TYPE_26:
1137 card->ext_csd.hs_max_dtr = 26000000;
1140 /* MMC v4 spec says this cannot happen */
1141 printk("%s: card is mmc v4 but doesn't support "
1142 "any high-speed modes.\n",
1143 mmc_hostname(card->host));
1147 if (host->caps & MMC_CAP_MMC_HIGHSPEED) {
1148 /* Activate highspeed support. */
1149 cmd.opcode = MMC_SWITCH;
1150 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1151 (EXT_CSD_HS_TIMING << 16) |
1153 EXT_CSD_CMD_SET_NORMAL;
1154 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1156 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1157 if (err != MMC_ERR_NONE) {
1158 printk("%s: failed to switch card to mmc v4 "
1159 "high-speed mode.\n",
1160 mmc_hostname(card->host));
1164 mmc_card_set_highspeed(card);
1166 host->ios.timing = MMC_TIMING_MMC_HS;
1170 /* Check for host support for wide-bus modes. */
1171 if (host->caps & MMC_CAP_4_BIT_DATA) {
1172 /* Activate 4-bit support. */
1173 cmd.opcode = MMC_SWITCH;
1174 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1175 (EXT_CSD_BUS_WIDTH << 16) |
1176 (EXT_CSD_BUS_WIDTH_4 << 8) |
1177 EXT_CSD_CMD_SET_NORMAL;
1178 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1180 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1181 if (err != MMC_ERR_NONE) {
1182 printk("%s: failed to switch card to "
1183 "mmc v4 4-bit bus mode.\n",
1184 mmc_hostname(card->host));
1188 host->ios.bus_width = MMC_BUS_WIDTH_4;
1195 mmc_deselect_cards(host);
1198 static void mmc_read_scrs(struct mmc_host *host)
1201 struct mmc_card *card;
1202 struct mmc_request mrq;
1203 struct mmc_command cmd;
1204 struct mmc_data data;
1205 struct scatterlist sg;
1207 list_for_each_entry(card, &host->cards, node) {
1208 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1210 if (!mmc_card_sd(card))
1213 err = mmc_select_card(host, card);
1214 if (err != MMC_ERR_NONE) {
1215 mmc_card_set_dead(card);
1219 memset(&cmd, 0, sizeof(struct mmc_command));
1221 cmd.opcode = MMC_APP_CMD;
1222 cmd.arg = card->rca << 16;
1223 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1225 err = mmc_wait_for_cmd(host, &cmd, 0);
1226 if ((err != MMC_ERR_NONE) || !(cmd.resp[0] & R1_APP_CMD)) {
1227 mmc_card_set_dead(card);
1231 memset(&cmd, 0, sizeof(struct mmc_command));
1233 cmd.opcode = SD_APP_SEND_SCR;
1235 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1237 memset(&data, 0, sizeof(struct mmc_data));
1239 mmc_set_data_timeout(&data, card, 0);
1241 data.blksz = 1 << 3;
1243 data.flags = MMC_DATA_READ;
1247 memset(&mrq, 0, sizeof(struct mmc_request));
1252 sg_init_one(&sg, (u8*)card->raw_scr, 8);
1254 mmc_wait_for_req(host, &mrq);
1256 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1257 mmc_card_set_dead(card);
1261 card->raw_scr[0] = ntohl(card->raw_scr[0]);
1262 card->raw_scr[1] = ntohl(card->raw_scr[1]);
1264 mmc_decode_scr(card);
1267 mmc_deselect_cards(host);
1270 static void mmc_read_switch_caps(struct mmc_host *host)
1273 struct mmc_card *card;
1274 struct mmc_request mrq;
1275 struct mmc_command cmd;
1276 struct mmc_data data;
1277 unsigned char *status;
1278 struct scatterlist sg;
1280 if (!(host->caps & MMC_CAP_SD_HIGHSPEED))
1283 status = kmalloc(64, GFP_KERNEL);
1285 printk(KERN_WARNING "%s: Unable to allocate buffer for "
1286 "reading switch capabilities.\n",
1287 mmc_hostname(host));
1291 list_for_each_entry(card, &host->cards, node) {
1292 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
1294 if (!mmc_card_sd(card))
1296 if (card->scr.sda_vsn < SCR_SPEC_VER_1)
1299 err = mmc_select_card(host, card);
1300 if (err != MMC_ERR_NONE) {
1301 mmc_card_set_dead(card);
1305 memset(&cmd, 0, sizeof(struct mmc_command));
1307 cmd.opcode = SD_SWITCH;
1308 cmd.arg = 0x00FFFFF1;
1309 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1311 memset(&data, 0, sizeof(struct mmc_data));
1313 mmc_set_data_timeout(&data, card, 0);
1317 data.flags = MMC_DATA_READ;
1321 memset(&mrq, 0, sizeof(struct mmc_request));
1326 sg_init_one(&sg, status, 64);
1328 mmc_wait_for_req(host, &mrq);
1330 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1331 printk("%s: unable to read switch capabilities, "
1332 "performance might suffer.\n",
1333 mmc_hostname(card->host));
1337 if (status[13] & 0x02)
1338 card->sw_caps.hs_max_dtr = 50000000;
1340 memset(&cmd, 0, sizeof(struct mmc_command));
1342 cmd.opcode = SD_SWITCH;
1343 cmd.arg = 0x80FFFFF1;
1344 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1346 memset(&data, 0, sizeof(struct mmc_data));
1348 mmc_set_data_timeout(&data, card, 0);
1352 data.flags = MMC_DATA_READ;
1356 memset(&mrq, 0, sizeof(struct mmc_request));
1361 sg_init_one(&sg, status, 64);
1363 mmc_wait_for_req(host, &mrq);
1365 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE ||
1366 (status[16] & 0xF) != 1) {
1367 printk(KERN_WARNING "%s: Problem switching card "
1368 "into high-speed mode!\n",
1369 mmc_hostname(host));
1373 mmc_card_set_highspeed(card);
1375 host->ios.timing = MMC_TIMING_SD_HS;
1381 mmc_deselect_cards(host);
1384 static unsigned int mmc_calculate_clock(struct mmc_host *host)
1386 struct mmc_card *card;
1387 unsigned int max_dtr = host->f_max;
1389 list_for_each_entry(card, &host->cards, node)
1390 if (!mmc_card_dead(card)) {
1391 if (mmc_card_highspeed(card) && mmc_card_sd(card)) {
1392 if (max_dtr > card->sw_caps.hs_max_dtr)
1393 max_dtr = card->sw_caps.hs_max_dtr;
1394 } else if (mmc_card_highspeed(card) && !mmc_card_sd(card)) {
1395 if (max_dtr > card->ext_csd.hs_max_dtr)
1396 max_dtr = card->ext_csd.hs_max_dtr;
1397 } else if (max_dtr > card->csd.max_dtr) {
1398 max_dtr = card->csd.max_dtr;
1402 pr_debug("%s: selected %d.%03dMHz transfer rate\n",
1404 max_dtr / 1000000, (max_dtr / 1000) % 1000);
1410 * Check whether cards we already know about are still present.
1411 * We do this by requesting status, and checking whether a card
1414 * A request for status does not cause a state change in data
1417 static void mmc_check_cards(struct mmc_host *host)
1419 struct list_head *l, *n;
1421 mmc_deselect_cards(host);
1423 list_for_each_safe(l, n, &host->cards) {
1424 struct mmc_card *card = mmc_list_to_card(l);
1425 struct mmc_command cmd;
1428 cmd.opcode = MMC_SEND_STATUS;
1429 cmd.arg = card->rca << 16;
1430 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1432 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1433 if (err == MMC_ERR_NONE)
1436 mmc_card_set_dead(card);
1440 static void mmc_setup(struct mmc_host *host)
1442 if (host->ios.power_mode != MMC_POWER_ON) {
1446 host->mode = MMC_MODE_SD;
1449 mmc_idle_cards(host);
1451 err = mmc_send_if_cond(host, host->ocr_avail, NULL);
1452 if (err != MMC_ERR_NONE) {
1455 err = mmc_send_app_op_cond(host, 0, &ocr);
1458 * If we fail to detect any SD cards then try
1459 * searching for MMC cards.
1461 if (err != MMC_ERR_NONE) {
1462 host->mode = MMC_MODE_MMC;
1464 err = mmc_send_op_cond(host, 0, &ocr);
1465 if (err != MMC_ERR_NONE)
1469 host->ocr = mmc_select_voltage(host, ocr);
1472 * Since we're changing the OCR value, we seem to
1473 * need to tell some cards to go back to the idle
1474 * state. We wait 1ms to give cards time to
1478 mmc_idle_cards(host);
1480 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
1481 host->ios.clock = host->f_min;
1485 * We should remember the OCR mask from the existing
1486 * cards, and detect the new cards OCR mask, combine
1487 * the two and re-select the VDD. However, if we do
1488 * change VDD, we should do an idle, and then do a
1489 * full re-initialisation. We would need to notify
1490 * drivers so that they can re-setup the cards as
1491 * well, while keeping their queues at bay.
1493 * For the moment, we take the easy way out - if the
1494 * new cards don't like our currently selected VDD,
1495 * they drop off the bus.
1503 * Send the selected OCR multiple times... until the cards
1504 * all get the idea that they should be ready for CMD2.
1505 * (My SanDisk card seems to need this.)
1507 if (host->mode == MMC_MODE_SD) {
1509 err = mmc_send_if_cond(host, host->ocr, &sd2);
1510 if (err == MMC_ERR_NONE) {
1512 * If SD_SEND_IF_COND indicates an SD 2.0
1513 * compliant card and we should set bit 30
1514 * of the ocr to indicate that we can handle
1515 * block-addressed SDHC cards.
1517 mmc_send_app_op_cond(host, host->ocr | (sd2 << 30), NULL);
1520 /* The extra bit indicates that we support high capacity */
1521 mmc_send_op_cond(host, host->ocr | (1 << 30), NULL);
1524 mmc_discover_cards(host);
1527 * Ok, now switch to push-pull mode.
1529 host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
1532 mmc_read_csds(host);
1534 if (host->mode == MMC_MODE_SD) {
1535 mmc_read_scrs(host);
1536 mmc_read_switch_caps(host);
1538 mmc_process_ext_csds(host);
1543 * mmc_detect_change - process change of state on a MMC socket
1544 * @host: host which changed state.
1545 * @delay: optional delay to wait before detection (jiffies)
1547 * All we know is that card(s) have been inserted or removed
1548 * from the socket(s). We don't know which socket or cards.
1550 void mmc_detect_change(struct mmc_host *host, unsigned long delay)
1552 mmc_schedule_delayed_work(&host->detect, delay);
1555 EXPORT_SYMBOL(mmc_detect_change);
1558 static void mmc_rescan(struct work_struct *work)
1560 struct mmc_host *host =
1561 container_of(work, struct mmc_host, detect.work);
1562 struct list_head *l, *n;
1563 unsigned char power_mode;
1565 mmc_claim_host(host);
1568 * Check for removed cards and newly inserted ones. We check for
1569 * removed cards first so we can intelligently re-select the VDD.
1571 power_mode = host->ios.power_mode;
1572 if (power_mode == MMC_POWER_ON)
1573 mmc_check_cards(host);
1578 * Some broken cards process CMD1 even in stand-by state. There is
1579 * no reply, but an ILLEGAL_COMMAND error is cached and returned
1580 * after next command. We poll for card status here to clear any
1581 * possibly pending error.
1583 if (power_mode == MMC_POWER_ON)
1584 mmc_check_cards(host);
1586 if (!list_empty(&host->cards)) {
1588 * (Re-)calculate the fastest clock rate which the
1589 * attached cards and the host support.
1591 host->ios.clock = mmc_calculate_clock(host);
1595 mmc_release_host(host);
1597 list_for_each_safe(l, n, &host->cards) {
1598 struct mmc_card *card = mmc_list_to_card(l);
1601 * If this is a new and good card, register it.
1603 if (!mmc_card_present(card) && !mmc_card_dead(card)) {
1604 if (mmc_register_card(card))
1605 mmc_card_set_dead(card);
1607 mmc_card_set_present(card);
1611 * If this card is dead, destroy it.
1613 if (mmc_card_dead(card)) {
1614 list_del(&card->node);
1615 mmc_remove_card(card);
1620 * If we discover that there are no cards on the
1621 * bus, turn off the clock and power down.
1623 if (list_empty(&host->cards))
1624 mmc_power_off(host);
1629 * mmc_alloc_host - initialise the per-host structure.
1630 * @extra: sizeof private data structure
1631 * @dev: pointer to host device model structure
1633 * Initialise the per-host structure.
1635 struct mmc_host *mmc_alloc_host(int extra, struct device *dev)
1637 struct mmc_host *host;
1639 host = mmc_alloc_host_sysfs(extra, dev);
1641 spin_lock_init(&host->lock);
1642 init_waitqueue_head(&host->wq);
1643 INIT_LIST_HEAD(&host->cards);
1644 INIT_DELAYED_WORK(&host->detect, mmc_rescan);
1647 * By default, hosts do not support SGIO or large requests.
1648 * They have to set these according to their abilities.
1650 host->max_hw_segs = 1;
1651 host->max_phys_segs = 1;
1652 host->max_seg_size = PAGE_CACHE_SIZE;
1654 host->max_req_size = PAGE_CACHE_SIZE;
1655 host->max_blk_size = 512;
1656 host->max_blk_count = PAGE_CACHE_SIZE / 512;
1662 EXPORT_SYMBOL(mmc_alloc_host);
1665 * mmc_add_host - initialise host hardware
1668 int mmc_add_host(struct mmc_host *host)
1672 ret = mmc_add_host_sysfs(host);
1674 mmc_power_off(host);
1675 mmc_detect_change(host, 0);
1681 EXPORT_SYMBOL(mmc_add_host);
1684 * mmc_remove_host - remove host hardware
1687 * Unregister and remove all cards associated with this host,
1688 * and power down the MMC bus.
1690 void mmc_remove_host(struct mmc_host *host)
1692 struct list_head *l, *n;
1694 list_for_each_safe(l, n, &host->cards) {
1695 struct mmc_card *card = mmc_list_to_card(l);
1697 mmc_remove_card(card);
1700 mmc_power_off(host);
1701 mmc_remove_host_sysfs(host);
1704 EXPORT_SYMBOL(mmc_remove_host);
1707 * mmc_free_host - free the host structure
1710 * Free the host once all references to it have been dropped.
1712 void mmc_free_host(struct mmc_host *host)
1714 mmc_flush_scheduled_work();
1715 mmc_free_host_sysfs(host);
1718 EXPORT_SYMBOL(mmc_free_host);
1723 * mmc_suspend_host - suspend a host
1725 * @state: suspend mode (PM_SUSPEND_xxx)
1727 int mmc_suspend_host(struct mmc_host *host, pm_message_t state)
1729 mmc_claim_host(host);
1730 mmc_deselect_cards(host);
1731 mmc_power_off(host);
1732 mmc_release_host(host);
1737 EXPORT_SYMBOL(mmc_suspend_host);
1740 * mmc_resume_host - resume a previously suspended host
1743 int mmc_resume_host(struct mmc_host *host)
1745 mmc_rescan(&host->detect.work);
1750 EXPORT_SYMBOL(mmc_resume_host);
1754 MODULE_LICENSE("GPL");