2 * linux/drivers/mmc/core/core.c
4 * Copyright (C) 2003-2004 Russell King, All Rights Reserved.
5 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
6 * Copyright (C) 2005-2007 Pierre Ossman, All Rights Reserved.
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);
320 * __mmc_claim_host - exclusively claim a host
321 * @host: mmc host to claim
322 * @card: mmc card to claim host for
324 * Claim a host for a set of operations. If a valid card
325 * is passed and this wasn't the last card selected, select
326 * the card before returning.
328 * Note: you should use mmc_card_claim_host or mmc_claim_host.
330 void mmc_claim_host(struct mmc_host *host)
332 DECLARE_WAITQUEUE(wait, current);
335 add_wait_queue(&host->wq, &wait);
336 spin_lock_irqsave(&host->lock, flags);
338 set_current_state(TASK_UNINTERRUPTIBLE);
341 spin_unlock_irqrestore(&host->lock, flags);
343 spin_lock_irqsave(&host->lock, flags);
345 set_current_state(TASK_RUNNING);
347 spin_unlock_irqrestore(&host->lock, flags);
348 remove_wait_queue(&host->wq, &wait);
351 EXPORT_SYMBOL(mmc_claim_host);
354 * mmc_release_host - release a host
355 * @host: mmc host to release
357 * Release a MMC host, allowing others to claim the host
358 * for their operations.
360 void mmc_release_host(struct mmc_host *host)
364 BUG_ON(!host->claimed);
366 spin_lock_irqsave(&host->lock, flags);
368 spin_unlock_irqrestore(&host->lock, flags);
373 EXPORT_SYMBOL(mmc_release_host);
375 static inline void mmc_set_ios(struct mmc_host *host)
377 struct mmc_ios *ios = &host->ios;
379 pr_debug("%s: clock %uHz busmode %u powermode %u cs %u Vdd %u "
380 "width %u timing %u\n",
381 mmc_hostname(host), ios->clock, ios->bus_mode,
382 ios->power_mode, ios->chip_select, ios->vdd,
383 ios->bus_width, ios->timing);
385 host->ops->set_ios(host, ios);
388 static int mmc_select_card(struct mmc_card *card)
391 struct mmc_command cmd;
393 BUG_ON(!card->host->claimed);
395 cmd.opcode = MMC_SELECT_CARD;
396 cmd.arg = card->rca << 16;
397 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
399 err = mmc_wait_for_cmd(card->host, &cmd, CMD_RETRIES);
400 if (err != MMC_ERR_NONE)
404 * We can only change the bus width of SD cards when
405 * they are selected so we have to put the handling
408 * The card is in 1 bit mode by default so
409 * we only need to change if it supports the
412 if (mmc_card_sd(card) &&
413 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4) &&
414 (card->host->caps & MMC_CAP_4_BIT_DATA)) {
416 struct mmc_command cmd;
417 cmd.opcode = SD_APP_SET_BUS_WIDTH;
418 cmd.arg = SD_BUS_WIDTH_4;
419 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
421 err = mmc_wait_for_app_cmd(card->host, card->rca,
423 if (err != MMC_ERR_NONE)
426 card->host->ios.bus_width = MMC_BUS_WIDTH_4;
427 mmc_set_ios(card->host);
434 static inline void mmc_delay(unsigned int ms)
436 if (ms < 1000 / HZ) {
445 * Mask off any voltages we don't support and select
448 static u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
452 ocr &= host->ocr_avail;
469 #define UNSTUFF_BITS(resp,start,size) \
471 const int __size = size; \
472 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \
473 const int __off = 3 - ((start) / 32); \
474 const int __shft = (start) & 31; \
477 __res = resp[__off] >> __shft; \
478 if (__size + __shft > 32) \
479 __res |= resp[__off-1] << ((32 - __shft) % 32); \
484 * Given the decoded CSD structure, decode the raw CID to our CID structure.
486 static void mmc_decode_cid(struct mmc_card *card)
488 u32 *resp = card->raw_cid;
490 memset(&card->cid, 0, sizeof(struct mmc_cid));
492 if (mmc_card_sd(card)) {
494 * SD doesn't currently have a version field so we will
495 * have to assume we can parse this.
497 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
498 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
499 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
500 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
501 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
502 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
503 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
504 card->cid.hwrev = UNSTUFF_BITS(resp, 60, 4);
505 card->cid.fwrev = UNSTUFF_BITS(resp, 56, 4);
506 card->cid.serial = UNSTUFF_BITS(resp, 24, 32);
507 card->cid.year = UNSTUFF_BITS(resp, 12, 8);
508 card->cid.month = UNSTUFF_BITS(resp, 8, 4);
510 card->cid.year += 2000; /* SD cards year offset */
513 * The selection of the format here is based upon published
514 * specs from sandisk and from what people have reported.
516 switch (card->csd.mmca_vsn) {
517 case 0: /* MMC v1.0 - v1.2 */
518 case 1: /* MMC v1.4 */
519 card->cid.manfid = UNSTUFF_BITS(resp, 104, 24);
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.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
526 card->cid.prod_name[6] = UNSTUFF_BITS(resp, 48, 8);
527 card->cid.hwrev = UNSTUFF_BITS(resp, 44, 4);
528 card->cid.fwrev = UNSTUFF_BITS(resp, 40, 4);
529 card->cid.serial = UNSTUFF_BITS(resp, 16, 24);
530 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
531 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
534 case 2: /* MMC v2.0 - v2.2 */
535 case 3: /* MMC v3.1 - v3.3 */
537 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
538 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
539 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
540 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
541 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
542 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
543 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
544 card->cid.prod_name[5] = UNSTUFF_BITS(resp, 56, 8);
545 card->cid.serial = UNSTUFF_BITS(resp, 16, 32);
546 card->cid.month = UNSTUFF_BITS(resp, 12, 4);
547 card->cid.year = UNSTUFF_BITS(resp, 8, 4) + 1997;
551 printk("%s: card has unknown MMCA version %d\n",
552 mmc_hostname(card->host), card->csd.mmca_vsn);
553 mmc_card_set_bad(card);
560 * Given a 128-bit response, decode to our card CSD structure.
562 static void mmc_decode_csd(struct mmc_card *card)
564 struct mmc_csd *csd = &card->csd;
565 unsigned int e, m, csd_struct;
566 u32 *resp = card->raw_csd;
568 if (mmc_card_sd(card)) {
569 csd_struct = UNSTUFF_BITS(resp, 126, 2);
571 switch (csd_struct) {
573 m = UNSTUFF_BITS(resp, 115, 4);
574 e = UNSTUFF_BITS(resp, 112, 3);
575 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
576 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
578 m = UNSTUFF_BITS(resp, 99, 4);
579 e = UNSTUFF_BITS(resp, 96, 3);
580 csd->max_dtr = tran_exp[e] * tran_mant[m];
581 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
583 e = UNSTUFF_BITS(resp, 47, 3);
584 m = UNSTUFF_BITS(resp, 62, 12);
585 csd->capacity = (1 + m) << (e + 2);
587 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
588 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
589 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
590 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
591 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
592 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
593 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
597 * This is a block-addressed SDHC card. Most
598 * interesting fields are unused and have fixed
599 * values. To avoid getting tripped by buggy cards,
600 * we assume those fixed values ourselves.
602 mmc_card_set_blockaddr(card);
604 csd->tacc_ns = 0; /* Unused */
605 csd->tacc_clks = 0; /* Unused */
607 m = UNSTUFF_BITS(resp, 99, 4);
608 e = UNSTUFF_BITS(resp, 96, 3);
609 csd->max_dtr = tran_exp[e] * tran_mant[m];
610 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
612 m = UNSTUFF_BITS(resp, 48, 22);
613 csd->capacity = (1 + m) << 10;
615 csd->read_blkbits = 9;
616 csd->read_partial = 0;
617 csd->write_misalign = 0;
618 csd->read_misalign = 0;
619 csd->r2w_factor = 4; /* Unused */
620 csd->write_blkbits = 9;
621 csd->write_partial = 0;
624 printk("%s: unrecognised CSD structure version %d\n",
625 mmc_hostname(card->host), csd_struct);
626 mmc_card_set_bad(card);
631 * We only understand CSD structure v1.1 and v1.2.
632 * v1.2 has extra information in bits 15, 11 and 10.
634 csd_struct = UNSTUFF_BITS(resp, 126, 2);
635 if (csd_struct != 1 && csd_struct != 2) {
636 printk("%s: unrecognised CSD structure version %d\n",
637 mmc_hostname(card->host), csd_struct);
638 mmc_card_set_bad(card);
642 csd->mmca_vsn = UNSTUFF_BITS(resp, 122, 4);
643 m = UNSTUFF_BITS(resp, 115, 4);
644 e = UNSTUFF_BITS(resp, 112, 3);
645 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
646 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
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 e = UNSTUFF_BITS(resp, 47, 3);
654 m = UNSTUFF_BITS(resp, 62, 12);
655 csd->capacity = (1 + m) << (e + 2);
657 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
658 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
659 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
660 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
661 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
662 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
663 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
668 * Given a 64-bit response, decode to our card SCR structure.
670 static void mmc_decode_scr(struct mmc_card *card)
672 struct sd_scr *scr = &card->scr;
673 unsigned int scr_struct;
676 BUG_ON(!mmc_card_sd(card));
678 resp[3] = card->raw_scr[1];
679 resp[2] = card->raw_scr[0];
681 scr_struct = UNSTUFF_BITS(resp, 60, 4);
682 if (scr_struct != 0) {
683 printk("%s: unrecognised SCR structure version %d\n",
684 mmc_hostname(card->host), scr_struct);
685 mmc_card_set_bad(card);
689 scr->sda_vsn = UNSTUFF_BITS(resp, 56, 4);
690 scr->bus_widths = UNSTUFF_BITS(resp, 48, 4);
694 * Allocate a new MMC card
696 static struct mmc_card *
697 mmc_alloc_card(struct mmc_host *host, u32 *raw_cid)
699 struct mmc_card *card;
701 card = kmalloc(sizeof(struct mmc_card), GFP_KERNEL);
703 return ERR_PTR(-ENOMEM);
705 mmc_init_card(card, host);
706 memcpy(card->raw_cid, raw_cid, sizeof(card->raw_cid));
712 * Tell attached cards to go to IDLE state
714 static void mmc_idle_cards(struct mmc_host *host)
716 struct mmc_command cmd;
718 host->ios.chip_select = MMC_CS_HIGH;
723 cmd.opcode = MMC_GO_IDLE_STATE;
725 cmd.flags = MMC_RSP_NONE | MMC_CMD_BC;
727 mmc_wait_for_cmd(host, &cmd, 0);
731 host->ios.chip_select = MMC_CS_DONTCARE;
738 * Apply power to the MMC stack. This is a two-stage process.
739 * First, we enable power to the card without the clock running.
740 * We then wait a bit for the power to stabilise. Finally,
741 * enable the bus drivers and clock to the card.
743 * We must _NOT_ enable the clock prior to power stablising.
745 * If a host does all the power sequencing itself, ignore the
746 * initial MMC_POWER_UP stage.
748 static void mmc_power_up(struct mmc_host *host)
750 int bit = fls(host->ocr_avail) - 1;
753 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
754 host->ios.chip_select = MMC_CS_DONTCARE;
755 host->ios.power_mode = MMC_POWER_UP;
756 host->ios.bus_width = MMC_BUS_WIDTH_1;
757 host->ios.timing = MMC_TIMING_LEGACY;
762 host->ios.clock = host->f_min;
763 host->ios.power_mode = MMC_POWER_ON;
769 static void mmc_power_off(struct mmc_host *host)
773 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
774 host->ios.chip_select = MMC_CS_DONTCARE;
775 host->ios.power_mode = MMC_POWER_OFF;
776 host->ios.bus_width = MMC_BUS_WIDTH_1;
777 host->ios.timing = MMC_TIMING_LEGACY;
781 static int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
783 struct mmc_command cmd;
786 cmd.opcode = MMC_SEND_OP_COND;
788 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
790 for (i = 100; i; i--) {
791 err = mmc_wait_for_cmd(host, &cmd, 0);
792 if (err != MMC_ERR_NONE)
795 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
798 err = MMC_ERR_TIMEOUT;
809 static int mmc_send_app_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
811 struct mmc_command cmd;
814 cmd.opcode = SD_APP_OP_COND;
816 cmd.flags = MMC_RSP_R3 | MMC_CMD_BCR;
818 for (i = 100; i; i--) {
819 err = mmc_wait_for_app_cmd(host, 0, &cmd, CMD_RETRIES);
820 if (err != MMC_ERR_NONE)
823 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
826 err = MMC_ERR_TIMEOUT;
837 static int mmc_send_if_cond(struct mmc_host *host, u32 ocr, int *rsd2)
839 struct mmc_command cmd;
841 static const u8 test_pattern = 0xAA;
844 * To support SD 2.0 cards, we must always invoke SD_SEND_IF_COND
845 * before SD_APP_OP_COND. This command will harmlessly fail for
848 cmd.opcode = SD_SEND_IF_COND;
849 cmd.arg = ((ocr & 0xFF8000) != 0) << 8 | test_pattern;
850 cmd.flags = MMC_RSP_R7 | MMC_CMD_BCR;
852 err = mmc_wait_for_cmd(host, &cmd, 0);
853 if (err == MMC_ERR_NONE) {
854 if ((cmd.resp[0] & 0xFF) == test_pattern) {
858 err = MMC_ERR_FAILED;
862 * Treat errors as SD 1.0 card.
873 * Discover the card by requesting its CID.
875 * Create a mmc_card entry for the discovered card, assigning
876 * it an RCA, and save the raw CID for decoding later.
878 static void mmc_discover_card(struct mmc_host *host)
882 struct mmc_command cmd;
886 cmd.opcode = MMC_ALL_SEND_CID;
888 cmd.flags = MMC_RSP_R2 | MMC_CMD_BCR;
890 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
891 if (err == MMC_ERR_TIMEOUT) {
895 if (err != MMC_ERR_NONE) {
896 printk(KERN_ERR "%s: error requesting CID: %d\n",
897 mmc_hostname(host), err);
901 host->card = mmc_alloc_card(host, cmd.resp);
902 if (IS_ERR(host->card)) {
903 err = PTR_ERR(host->card);
908 if (host->mode == MMC_MODE_SD) {
909 host->card->type = MMC_TYPE_SD;
911 cmd.opcode = SD_SEND_RELATIVE_ADDR;
913 cmd.flags = MMC_RSP_R6 | MMC_CMD_BCR;
915 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
916 if (err != MMC_ERR_NONE)
917 mmc_card_set_dead(host->card);
919 host->card->rca = cmd.resp[0] >> 16;
921 if (!host->ops->get_ro) {
922 printk(KERN_WARNING "%s: host does not "
923 "support reading read-only "
924 "switch. assuming write-enable.\n",
927 if (host->ops->get_ro(host))
928 mmc_card_set_readonly(host->card);
932 host->card->type = MMC_TYPE_MMC;
935 cmd.opcode = MMC_SET_RELATIVE_ADDR;
936 cmd.arg = host->card->rca << 16;
937 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
939 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
940 if (err != MMC_ERR_NONE)
941 mmc_card_set_dead(host->card);
945 static void mmc_read_csd(struct mmc_host *host)
947 struct mmc_command cmd;
952 if (mmc_card_dead(host->card))
955 cmd.opcode = MMC_SEND_CSD;
956 cmd.arg = host->card->rca << 16;
957 cmd.flags = MMC_RSP_R2 | MMC_CMD_AC;
959 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
960 if (err != MMC_ERR_NONE) {
961 mmc_card_set_dead(host->card);
965 memcpy(host->card->raw_csd, cmd.resp, sizeof(host->card->raw_csd));
967 mmc_decode_csd(host->card);
968 mmc_decode_cid(host->card);
971 static void mmc_process_ext_csd(struct mmc_host *host)
975 struct mmc_request mrq;
976 struct mmc_command cmd;
977 struct mmc_data data;
980 struct scatterlist sg;
984 if (mmc_card_dead(host->card))
986 if (mmc_card_sd(host->card))
988 if (host->card->csd.mmca_vsn < CSD_SPEC_VER_4)
992 * As the ext_csd is so large and mostly unused, we don't store the
993 * raw block in mmc_card.
995 ext_csd = kmalloc(512, GFP_KERNEL);
997 printk("%s: could not allocate a buffer to receive the ext_csd."
998 "mmc v4 cards will be treated as v3.\n",
1003 memset(&cmd, 0, sizeof(struct mmc_command));
1005 cmd.opcode = MMC_SEND_EXT_CSD;
1007 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1009 memset(&data, 0, sizeof(struct mmc_data));
1011 mmc_set_data_timeout(&data, host->card, 0);
1015 data.flags = MMC_DATA_READ;
1019 memset(&mrq, 0, sizeof(struct mmc_request));
1024 sg_init_one(&sg, ext_csd, 512);
1026 mmc_wait_for_req(host, &mrq);
1028 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1029 if (host->card->csd.capacity == (4096 * 512)) {
1030 printk(KERN_ERR "%s: unable to read EXT_CSD "
1031 "on a possible high capacity card. "
1032 "Card will be ignored.\n",
1033 mmc_hostname(host));
1034 mmc_card_set_dead(host->card);
1036 printk(KERN_WARNING "%s: unable to read "
1037 "EXT_CSD, performance might "
1039 mmc_hostname(host));
1044 host->card->ext_csd.sectors =
1045 ext_csd[EXT_CSD_SEC_CNT + 0] << 0 |
1046 ext_csd[EXT_CSD_SEC_CNT + 1] << 8 |
1047 ext_csd[EXT_CSD_SEC_CNT + 2] << 16 |
1048 ext_csd[EXT_CSD_SEC_CNT + 3] << 24;
1049 if (host->card->ext_csd.sectors)
1050 mmc_card_set_blockaddr(host->card);
1052 switch (ext_csd[EXT_CSD_CARD_TYPE]) {
1053 case EXT_CSD_CARD_TYPE_52 | EXT_CSD_CARD_TYPE_26:
1054 host->card->ext_csd.hs_max_dtr = 52000000;
1056 case EXT_CSD_CARD_TYPE_26:
1057 host->card->ext_csd.hs_max_dtr = 26000000;
1060 /* MMC v4 spec says this cannot happen */
1061 printk("%s: card is mmc v4 but doesn't support "
1062 "any high-speed modes.\n",
1063 mmc_hostname(host));
1067 if (host->caps & MMC_CAP_MMC_HIGHSPEED) {
1068 /* Activate highspeed support. */
1069 cmd.opcode = MMC_SWITCH;
1070 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1071 (EXT_CSD_HS_TIMING << 16) |
1073 EXT_CSD_CMD_SET_NORMAL;
1074 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1076 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1077 if (err != MMC_ERR_NONE) {
1078 printk("%s: failed to switch card to mmc v4 "
1079 "high-speed mode.\n",
1080 mmc_hostname(host));
1084 mmc_card_set_highspeed(host->card);
1086 host->ios.timing = MMC_TIMING_MMC_HS;
1090 /* Check for host support for wide-bus modes. */
1091 if (host->caps & MMC_CAP_4_BIT_DATA) {
1092 /* Activate 4-bit support. */
1093 cmd.opcode = MMC_SWITCH;
1094 cmd.arg = (MMC_SWITCH_MODE_WRITE_BYTE << 24) |
1095 (EXT_CSD_BUS_WIDTH << 16) |
1096 (EXT_CSD_BUS_WIDTH_4 << 8) |
1097 EXT_CSD_CMD_SET_NORMAL;
1098 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1100 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
1101 if (err != MMC_ERR_NONE) {
1102 printk("%s: failed to switch card to "
1103 "mmc v4 4-bit bus mode.\n",
1104 mmc_hostname(host));
1108 host->ios.bus_width = MMC_BUS_WIDTH_4;
1116 static void mmc_read_scr(struct mmc_host *host)
1119 struct mmc_request mrq;
1120 struct mmc_command cmd;
1121 struct mmc_data data;
1122 struct scatterlist sg;
1126 if (mmc_card_dead(host->card))
1128 if (!mmc_card_sd(host->card))
1131 memset(&cmd, 0, sizeof(struct mmc_command));
1133 cmd.opcode = MMC_APP_CMD;
1134 cmd.arg = host->card->rca << 16;
1135 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1137 err = mmc_wait_for_cmd(host, &cmd, 0);
1138 if ((err != MMC_ERR_NONE) || !(cmd.resp[0] & R1_APP_CMD)) {
1139 mmc_card_set_dead(host->card);
1143 memset(&cmd, 0, sizeof(struct mmc_command));
1145 cmd.opcode = SD_APP_SEND_SCR;
1147 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1149 memset(&data, 0, sizeof(struct mmc_data));
1151 mmc_set_data_timeout(&data, host->card, 0);
1153 data.blksz = 1 << 3;
1155 data.flags = MMC_DATA_READ;
1159 memset(&mrq, 0, sizeof(struct mmc_request));
1164 sg_init_one(&sg, (u8*)host->card->raw_scr, 8);
1166 mmc_wait_for_req(host, &mrq);
1168 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1169 mmc_card_set_dead(host->card);
1173 host->card->raw_scr[0] = ntohl(host->card->raw_scr[0]);
1174 host->card->raw_scr[1] = ntohl(host->card->raw_scr[1]);
1176 mmc_decode_scr(host->card);
1179 static void mmc_read_switch_caps(struct mmc_host *host)
1181 struct mmc_request mrq;
1182 struct mmc_command cmd;
1183 struct mmc_data data;
1184 unsigned char *status;
1185 struct scatterlist sg;
1187 if (!(host->caps & MMC_CAP_SD_HIGHSPEED))
1192 if (mmc_card_dead(host->card))
1194 if (!mmc_card_sd(host->card))
1196 if (host->card->scr.sda_vsn < SCR_SPEC_VER_1)
1199 status = kmalloc(64, GFP_KERNEL);
1201 printk(KERN_WARNING "%s: Unable to allocate buffer for "
1202 "reading switch capabilities.\n",
1203 mmc_hostname(host));
1207 memset(&cmd, 0, sizeof(struct mmc_command));
1209 cmd.opcode = SD_SWITCH;
1210 cmd.arg = 0x00FFFFF1;
1211 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1213 memset(&data, 0, sizeof(struct mmc_data));
1215 mmc_set_data_timeout(&data, host->card, 0);
1219 data.flags = MMC_DATA_READ;
1223 memset(&mrq, 0, sizeof(struct mmc_request));
1228 sg_init_one(&sg, status, 64);
1230 mmc_wait_for_req(host, &mrq);
1232 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE) {
1233 printk("%s: unable to read switch capabilities, "
1234 "performance might suffer.\n",
1235 mmc_hostname(host));
1239 if (status[13] & 0x02)
1240 host->card->sw_caps.hs_max_dtr = 50000000;
1242 memset(&cmd, 0, sizeof(struct mmc_command));
1244 cmd.opcode = SD_SWITCH;
1245 cmd.arg = 0x80FFFFF1;
1246 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1248 memset(&data, 0, sizeof(struct mmc_data));
1250 mmc_set_data_timeout(&data, host->card, 0);
1254 data.flags = MMC_DATA_READ;
1258 memset(&mrq, 0, sizeof(struct mmc_request));
1263 sg_init_one(&sg, status, 64);
1265 mmc_wait_for_req(host, &mrq);
1267 if (cmd.error != MMC_ERR_NONE || data.error != MMC_ERR_NONE ||
1268 (status[16] & 0xF) != 1) {
1269 printk(KERN_WARNING "%s: Problem switching card "
1270 "into high-speed mode!\n",
1271 mmc_hostname(host));
1275 mmc_card_set_highspeed(host->card);
1277 host->ios.timing = MMC_TIMING_SD_HS;
1284 static unsigned int mmc_calculate_clock(struct mmc_host *host)
1286 unsigned int max_dtr = host->f_max;
1288 if (host->card && !mmc_card_dead(host->card)) {
1289 if (mmc_card_highspeed(host->card) && mmc_card_sd(host->card)) {
1290 if (max_dtr > host->card->sw_caps.hs_max_dtr)
1291 max_dtr = host->card->sw_caps.hs_max_dtr;
1292 } else if (mmc_card_highspeed(host->card) && !mmc_card_sd(host->card)) {
1293 if (max_dtr > host->card->ext_csd.hs_max_dtr)
1294 max_dtr = host->card->ext_csd.hs_max_dtr;
1295 } else if (max_dtr > host->card->csd.max_dtr) {
1296 max_dtr = host->card->csd.max_dtr;
1300 pr_debug("%s: selected %d.%03dMHz transfer rate\n",
1302 max_dtr / 1000000, (max_dtr / 1000) % 1000);
1308 * Check whether cards we already know about are still present.
1309 * We do this by requesting status, and checking whether a card
1312 * A request for status does not cause a state change in data
1315 static void mmc_check_card(struct mmc_card *card)
1317 struct mmc_command cmd;
1322 cmd.opcode = MMC_SEND_STATUS;
1323 cmd.arg = card->rca << 16;
1324 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1326 err = mmc_wait_for_cmd(card->host, &cmd, CMD_RETRIES);
1327 if (err == MMC_ERR_NONE)
1330 mmc_card_set_dead(card);
1333 static void mmc_setup(struct mmc_host *host)
1338 host->mode = MMC_MODE_SD;
1341 mmc_idle_cards(host);
1343 err = mmc_send_if_cond(host, host->ocr_avail, NULL);
1344 if (err != MMC_ERR_NONE) {
1347 err = mmc_send_app_op_cond(host, 0, &ocr);
1350 * If we fail to detect any SD cards then try
1351 * searching for MMC cards.
1353 if (err != MMC_ERR_NONE) {
1354 host->mode = MMC_MODE_MMC;
1356 err = mmc_send_op_cond(host, 0, &ocr);
1357 if (err != MMC_ERR_NONE)
1361 host->ocr = mmc_select_voltage(host, ocr);
1367 * Since we're changing the OCR value, we seem to
1368 * need to tell some cards to go back to the idle
1369 * state. We wait 1ms to give cards time to
1372 mmc_idle_cards(host);
1375 * Send the selected OCR multiple times... until the cards
1376 * all get the idea that they should be ready for CMD2.
1377 * (My SanDisk card seems to need this.)
1379 if (host->mode == MMC_MODE_SD) {
1381 err = mmc_send_if_cond(host, host->ocr, &sd2);
1382 if (err == MMC_ERR_NONE) {
1384 * If SD_SEND_IF_COND indicates an SD 2.0
1385 * compliant card and we should set bit 30
1386 * of the ocr to indicate that we can handle
1387 * block-addressed SDHC cards.
1389 mmc_send_app_op_cond(host, host->ocr | (sd2 << 30), NULL);
1392 /* The extra bit indicates that we support high capacity */
1393 mmc_send_op_cond(host, host->ocr | (1 << 30), NULL);
1396 mmc_discover_card(host);
1399 * Ok, now switch to push-pull mode.
1401 host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
1406 if (host->card && !mmc_card_dead(host->card)) {
1407 err = mmc_select_card(host->card);
1408 if (err != MMC_ERR_NONE)
1409 mmc_card_set_dead(host->card);
1412 if (host->mode == MMC_MODE_SD) {
1414 mmc_read_switch_caps(host);
1416 mmc_process_ext_csd(host);
1421 * mmc_detect_change - process change of state on a MMC socket
1422 * @host: host which changed state.
1423 * @delay: optional delay to wait before detection (jiffies)
1425 * All we know is that card(s) have been inserted or removed
1426 * from the socket(s). We don't know which socket or cards.
1428 void mmc_detect_change(struct mmc_host *host, unsigned long delay)
1430 #ifdef CONFIG_MMC_DEBUG
1431 mmc_claim_host(host);
1432 BUG_ON(host->removed);
1433 mmc_release_host(host);
1436 mmc_schedule_delayed_work(&host->detect, delay);
1439 EXPORT_SYMBOL(mmc_detect_change);
1442 static void mmc_rescan(struct work_struct *work)
1444 struct mmc_host *host =
1445 container_of(work, struct mmc_host, detect.work);
1447 mmc_claim_host(host);
1450 * Check for removed card and newly inserted ones. We check for
1451 * removed cards first so we can intelligently re-select the VDD.
1454 mmc_check_card(host->card);
1456 mmc_release_host(host);
1458 if (mmc_card_dead(host->card)) {
1459 mmc_remove_card(host->card);
1468 if (host->card && !mmc_card_dead(host->card)) {
1470 * (Re-)calculate the fastest clock rate which the
1471 * attached cards and the host support.
1473 host->ios.clock = mmc_calculate_clock(host);
1477 mmc_release_host(host);
1480 * If this is a new and good card, register it.
1482 if (host->card && !mmc_card_dead(host->card)) {
1483 if (mmc_register_card(host->card))
1484 mmc_card_set_dead(host->card);
1488 * If this card is dead, destroy it.
1490 if (host->card && mmc_card_dead(host->card)) {
1491 mmc_remove_card(host->card);
1497 * If we discover that there are no cards on the
1498 * bus, turn off the clock and power down.
1501 mmc_power_off(host);
1506 * mmc_alloc_host - initialise the per-host structure.
1507 * @extra: sizeof private data structure
1508 * @dev: pointer to host device model structure
1510 * Initialise the per-host structure.
1512 struct mmc_host *mmc_alloc_host(int extra, struct device *dev)
1514 struct mmc_host *host;
1516 host = mmc_alloc_host_sysfs(extra, dev);
1518 spin_lock_init(&host->lock);
1519 init_waitqueue_head(&host->wq);
1520 INIT_DELAYED_WORK(&host->detect, mmc_rescan);
1523 * By default, hosts do not support SGIO or large requests.
1524 * They have to set these according to their abilities.
1526 host->max_hw_segs = 1;
1527 host->max_phys_segs = 1;
1528 host->max_seg_size = PAGE_CACHE_SIZE;
1530 host->max_req_size = PAGE_CACHE_SIZE;
1531 host->max_blk_size = 512;
1532 host->max_blk_count = PAGE_CACHE_SIZE / 512;
1538 EXPORT_SYMBOL(mmc_alloc_host);
1541 * mmc_add_host - initialise host hardware
1544 int mmc_add_host(struct mmc_host *host)
1548 ret = mmc_add_host_sysfs(host);
1550 mmc_power_off(host);
1551 mmc_detect_change(host, 0);
1557 EXPORT_SYMBOL(mmc_add_host);
1560 * mmc_remove_host - remove host hardware
1563 * Unregister and remove all cards associated with this host,
1564 * and power down the MMC bus.
1566 void mmc_remove_host(struct mmc_host *host)
1568 #ifdef CONFIG_MMC_DEBUG
1569 mmc_claim_host(host);
1571 mmc_release_host(host);
1574 mmc_flush_scheduled_work();
1577 mmc_remove_card(host->card);
1581 mmc_power_off(host);
1582 mmc_remove_host_sysfs(host);
1585 EXPORT_SYMBOL(mmc_remove_host);
1588 * mmc_free_host - free the host structure
1591 * Free the host once all references to it have been dropped.
1593 void mmc_free_host(struct mmc_host *host)
1595 mmc_free_host_sysfs(host);
1598 EXPORT_SYMBOL(mmc_free_host);
1603 * mmc_suspend_host - suspend a host
1605 * @state: suspend mode (PM_SUSPEND_xxx)
1607 int mmc_suspend_host(struct mmc_host *host, pm_message_t state)
1609 mmc_flush_scheduled_work();
1612 mmc_remove_card(host->card);
1616 mmc_power_off(host);
1621 EXPORT_SYMBOL(mmc_suspend_host);
1624 * mmc_resume_host - resume a previously suspended host
1627 int mmc_resume_host(struct mmc_host *host)
1629 mmc_rescan(&host->detect.work);
1634 EXPORT_SYMBOL(mmc_resume_host);
1638 MODULE_LICENSE("GPL");