drivers/mmc/mmc.c

   1 /*
   2  *  linux/drivers/mmc/mmc.c
   3  *
   4  *  Copyright (C) 2003-2004 Russell King, All Rights Reserved.
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 as
   8  * published by the Free Software Foundation.
   9  */
  10 #include <linux/config.h>
  11 #include <linux/module.h>
  12 #include <linux/init.h>
  13 #include <linux/interrupt.h>
  14 #include <linux/completion.h>
  15 #include <linux/device.h>
  16 #include <linux/delay.h>
  17 #include <linux/pagemap.h>
  18 #include <linux/err.h>
  19
  20 #include <linux/mmc/card.h>
  21 #include <linux/mmc/host.h>
  22 #include <linux/mmc/protocol.h>
  23
  24 #include "mmc.h"
  25
  26 #ifdef CONFIG_MMC_DEBUG
  27 #define DBG(x...)       printk(KERN_DEBUG x)
  28 #else
  29 #define DBG(x...)       do { } while (0)
  30 #endif
  31
  32 #define CMD_RETRIES     3
  33
  34 /*
  35  * OCR Bit positions to 10s of Vdd mV.
  36  */
  37 static const unsigned short mmc_ocr_bit_to_vdd[] = {
  38         150,    155,    160,    165,    170,    180,    190,    200,
  39         210,    220,    230,    240,    250,    260,    270,    280,
  40         290,    300,    310,    320,    330,    340,    350,    360
  41 };
  42
  43 static const unsigned int tran_exp[] = {
  44         10000,          100000,         1000000,        10000000,
  45         0,              0,              0,              0
  46 };
  47
  48 static const unsigned char tran_mant[] = {
  49         0,      10,     12,     13,     15,     20,     25,     30,
  50         35,     40,     45,     50,     55,     60,     70,     80,
  51 };
  52
  53 static const unsigned int tacc_exp[] = {
  54         1,      10,     100,    1000,   10000,  100000, 1000000, 10000000,
  55 };
  56
  57 static const unsigned int tacc_mant[] = {
  58         0,      10,     12,     13,     15,     20,     25,     30,
  59         35,     40,     45,     50,     55,     60,     70,     80,
  60 };
  61
  62
  63 /**
  64  *      mmc_request_done - finish processing an MMC command
  65  *      @host: MMC host which completed command
  66  *      @mrq: MMC request which completed
  67  *
  68  *      MMC drivers should call this function when they have completed
  69  *      their processing of a command.  This should be called before the
  70  *      data part of the command has completed.
  71  */
  72 void mmc_request_done(struct mmc_host *host, struct mmc_request *mrq)
  73 {
  74         struct mmc_command *cmd = mrq->cmd;
  75         int err = mrq->cmd->error;
  76         DBG("MMC: req done (%02x): %d: %08x %08x %08x %08x\n", cmd->opcode,
  77             err, cmd->resp[0], cmd->resp[1], cmd->resp[2], cmd->resp[3]);
  78
  79         if (err && cmd->retries) {
  80                 cmd->retries--;
  81                 cmd->error = 0;
  82                 host->ops->request(host, mrq);
  83         } else if (mrq->done) {
  84                 mrq->done(mrq);
  85         }
  86 }
  87
  88 EXPORT_SYMBOL(mmc_request_done);
  89
  90 /**
  91  *      mmc_start_request - start a command on a host
  92  *      @host: MMC host to start command on
  93  *      @mrq: MMC request to start
  94  *
  95  *      Queue a command on the specified host.  We expect the
  96  *      caller to be holding the host lock with interrupts disabled.
  97  */
  98 void
  99 mmc_start_request(struct mmc_host *host, struct mmc_request *mrq)
 100 {
 101         DBG("MMC: starting cmd %02x arg %08x flags %08x\n",
 102             mrq->cmd->opcode, mrq->cmd->arg, mrq->cmd->flags);
 103
 104         WARN_ON(host->card_busy == NULL);
 105
 106         mrq->cmd->error = 0;
 107         mrq->cmd->mrq = mrq;
 108         if (mrq->data) {
 109                 mrq->cmd->data = mrq->data;
 110                 mrq->data->error = 0;
 111                 mrq->data->mrq = mrq;
 112                 if (mrq->stop) {
 113                         mrq->data->stop = mrq->stop;
 114                         mrq->stop->error = 0;
 115                         mrq->stop->mrq = mrq;
 116                 }
 117         }
 118         host->ops->request(host, mrq);
 119 }
 120
 121 EXPORT_SYMBOL(mmc_start_request);
 122
 123 static void mmc_wait_done(struct mmc_request *mrq)
 124 {
 125         complete(mrq->done_data);
 126 }
 127
 128 int mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq)
 129 {
 130         DECLARE_COMPLETION(complete);
 131
 132         mrq->done_data = &complete;
 133         mrq->done = mmc_wait_done;
 134
 135         mmc_start_request(host, mrq);
 136
 137         wait_for_completion(&complete);
 138
 139         return 0;
 140 }
 141
 142 EXPORT_SYMBOL(mmc_wait_for_req);
 143
 144 /**
 145  *      mmc_wait_for_cmd - start a command and wait for completion
 146  *      @host: MMC host to start command
 147  *      @cmd: MMC command to start
 148  *      @retries: maximum number of retries
 149  *
 150  *      Start a new MMC command for a host, and wait for the command
 151  *      to complete.  Return any error that occurred while the command
 152  *      was executing.  Do not attempt to parse the response.
 153  */
 154 int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries)
 155 {
 156         struct mmc_request mrq;
 157
 158         BUG_ON(host->card_busy == NULL);
 159
 160         memset(&mrq, 0, sizeof(struct mmc_request));
 161
 162         memset(cmd->resp, 0, sizeof(cmd->resp));
 163         cmd->retries = retries;
 164
 165         mrq.cmd = cmd;
 166         cmd->data = NULL;
 167
 168         mmc_wait_for_req(host, &mrq);
 169
 170         return cmd->error;
 171 }
 172
 173 EXPORT_SYMBOL(mmc_wait_for_cmd);
 174
 175
 176
 177 /**
 178  *      __mmc_claim_host - exclusively claim a host
 179  *      @host: mmc host to claim
 180  *      @card: mmc card to claim host for
 181  *
 182  *      Claim a host for a set of operations.  If a valid card
 183  *      is passed and this wasn't the last card selected, select
 184  *      the card before returning.
 185  *
 186  *      Note: you should use mmc_card_claim_host or mmc_claim_host.
 187  */
 188 int __mmc_claim_host(struct mmc_host *host, struct mmc_card *card)
 189 {
 190         DECLARE_WAITQUEUE(wait, current);
 191         unsigned long flags;
 192         int err = 0;
 193
 194         add_wait_queue(&host->wq, &wait);
 195         spin_lock_irqsave(&host->lock, flags);
 196         while (1) {
 197                 set_current_state(TASK_UNINTERRUPTIBLE);
 198                 if (host->card_busy == NULL)
 199                         break;
 200                 spin_unlock_irqrestore(&host->lock, flags);
 201                 schedule();
 202                 spin_lock_irqsave(&host->lock, flags);
 203         }
 204         set_current_state(TASK_RUNNING);
 205         host->card_busy = card;
 206         spin_unlock_irqrestore(&host->lock, flags);
 207         remove_wait_queue(&host->wq, &wait);
 208
 209         if (card != (void *)-1 && host->card_selected != card) {
 210                 struct mmc_command cmd;
 211
 212                 host->card_selected = card;
 213
 214                 cmd.opcode = MMC_SELECT_CARD;
 215                 cmd.arg = card->rca << 16;
 216                 cmd.flags = MMC_RSP_R1;
 217
 218                 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
 219         }
 220
 221         return err;
 222 }
 223
 224 EXPORT_SYMBOL(__mmc_claim_host);
 225
 226 /**
 227  *      mmc_release_host - release a host
 228  *      @host: mmc host to release
 229  *
 230  *      Release a MMC host, allowing others to claim the host
 231  *      for their operations.
 232  */
 233 void mmc_release_host(struct mmc_host *host)
 234 {
 235         unsigned long flags;
 236
 237         BUG_ON(host->card_busy == NULL);
 238
 239         spin_lock_irqsave(&host->lock, flags);
 240         host->card_busy = NULL;
 241         spin_unlock_irqrestore(&host->lock, flags);
 242
 243         wake_up(&host->wq);
 244 }
 245
 246 EXPORT_SYMBOL(mmc_release_host);
 247
 248 /*
 249  * Ensure that no card is selected.
 250  */
 251 static void mmc_deselect_cards(struct mmc_host *host)
 252 {
 253         struct mmc_command cmd;
 254
 255         if (host->card_selected) {
 256                 host->card_selected = NULL;
 257
 258                 cmd.opcode = MMC_SELECT_CARD;
 259                 cmd.arg = 0;
 260                 cmd.flags = MMC_RSP_NONE;
 261
 262                 mmc_wait_for_cmd(host, &cmd, 0);
 263         }
 264 }
 265
 266
 267 static inline void mmc_delay(unsigned int ms)
 268 {
 269         if (ms < HZ / 1000) {
 270                 yield();
 271                 mdelay(ms);
 272         } else {
 273                 msleep_interruptible (ms);
 274         }
 275 }
 276
 277 /*
 278  * Mask off any voltages we don't support and select
 279  * the lowest voltage
 280  */
 281 static u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
 282 {
 283         int bit;
 284
 285         ocr &= host->ocr_avail;
 286
 287         bit = ffs(ocr);
 288         if (bit) {
 289                 bit -= 1;
 290
 291                 ocr = 3 << bit;
 292
 293                 host->ios.vdd = bit;
 294                 host->ops->set_ios(host, &host->ios);
 295         } else {
 296                 ocr = 0;
 297         }
 298
 299         return ocr;
 300 }
 301
 302 #define UNSTUFF_BITS(resp,start,size)                                   \
 303         ({                                                              \
 304                 const u32 __mask = (1 << (size)) - 1;                   \
 305                 const int __off = 3 - ((start) / 32);                   \
 306                 const int __shft = (start) & 31;                        \
 307                 u32 __res;                                              \
 308                                                                         \
 309                 __res = resp[__off] >> __shft;                          \
 310                 if ((size) + __shft >= 32)                              \
 311                         __res |= resp[__off-1] << (32 - __shft);        \
 312                 __res & __mask;                                         \
 313         })
 314
 315 /*
 316  * Given the decoded CSD structure, decode the raw CID to our CID structure.
 317  */
 318 static void mmc_decode_cid(struct mmc_card *card)
 319 {
 320         u32 *resp = card->raw_cid;
 321
 322         memset(&card->cid, 0, sizeof(struct mmc_cid));
 323
 324         /*
 325          * The selection of the format here is guesswork based upon
 326          * information people have sent to date.
 327          */
 328         switch (card->csd.mmca_vsn) {
 329         case 0: /* MMC v1.? */
 330         case 1: /* MMC v1.4 */
 331                 card->cid.manfid        = UNSTUFF_BITS(resp, 104, 24);
 332                 card->cid.prod_name[0]  = UNSTUFF_BITS(resp, 96, 8);
 333                 card->cid.prod_name[1]  = UNSTUFF_BITS(resp, 88, 8);
 334                 card->cid.prod_name[2]  = UNSTUFF_BITS(resp, 80, 8);
 335                 card->cid.prod_name[3]  = UNSTUFF_BITS(resp, 72, 8);
 336                 card->cid.prod_name[4]  = UNSTUFF_BITS(resp, 64, 8);
 337                 card->cid.prod_name[5]  = UNSTUFF_BITS(resp, 56, 8);
 338                 card->cid.prod_name[6]  = UNSTUFF_BITS(resp, 48, 8);
 339                 card->cid.hwrev         = UNSTUFF_BITS(resp, 44, 4);
 340                 card->cid.fwrev         = UNSTUFF_BITS(resp, 40, 4);
 341                 card->cid.serial        = UNSTUFF_BITS(resp, 16, 24);
 342                 card->cid.month         = UNSTUFF_BITS(resp, 12, 4);
 343                 card->cid.year          = UNSTUFF_BITS(resp, 8, 4) + 1997;
 344                 break;
 345
 346         case 2: /* MMC v2.x ? */
 347         case 3: /* MMC v3.x ? */
 348                 card->cid.manfid        = UNSTUFF_BITS(resp, 120, 8);
 349                 card->cid.oemid         = UNSTUFF_BITS(resp, 104, 16);
 350                 card->cid.prod_name[0]  = UNSTUFF_BITS(resp, 96, 8);
 351                 card->cid.prod_name[1]  = UNSTUFF_BITS(resp, 88, 8);
 352                 card->cid.prod_name[2]  = UNSTUFF_BITS(resp, 80, 8);
 353                 card->cid.prod_name[3]  = UNSTUFF_BITS(resp, 72, 8);
 354                 card->cid.prod_name[4]  = UNSTUFF_BITS(resp, 64, 8);
 355                 card->cid.prod_name[5]  = UNSTUFF_BITS(resp, 56, 8);
 356                 card->cid.serial        = UNSTUFF_BITS(resp, 16, 32);
 357                 card->cid.month         = UNSTUFF_BITS(resp, 12, 4);
 358                 card->cid.year          = UNSTUFF_BITS(resp, 8, 4) + 1997;
 359                 break;
 360
 361         default:
 362                 printk("%s: card has unknown MMCA version %d\n",
 363                         card->host->host_name, card->csd.mmca_vsn);
 364                 mmc_card_set_bad(card);
 365                 break;
 366         }
 367 }
 368
 369 /*
 370  * Given a 128-bit response, decode to our card CSD structure.
 371  */
 372 static void mmc_decode_csd(struct mmc_card *card)
 373 {
 374         struct mmc_csd *csd = &card->csd;
 375         unsigned int e, m, csd_struct;
 376         u32 *resp = card->raw_csd;
 377
 378         /*
 379          * We only understand CSD structure v1.1 and v2.
 380          * v2 has extra information in bits 15, 11 and 10.
 381          */
 382         csd_struct = UNSTUFF_BITS(resp, 126, 2);
 383         if (csd_struct != 1 && csd_struct != 2) {
 384                 printk("%s: unrecognised CSD structure version %d\n",
 385                         card->host->host_name, csd_struct);
 386                 mmc_card_set_bad(card);
 387                 return;
 388         }
 389
 390         csd->mmca_vsn    = UNSTUFF_BITS(resp, 122, 4);
 391         m = UNSTUFF_BITS(resp, 115, 4);
 392         e = UNSTUFF_BITS(resp, 112, 3);
 393         csd->tacc_ns     = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
 394         csd->tacc_clks   = UNSTUFF_BITS(resp, 104, 8) * 100;
 395
 396         m = UNSTUFF_BITS(resp, 99, 4);
 397         e = UNSTUFF_BITS(resp, 96, 3);
 398         csd->max_dtr      = tran_exp[e] * tran_mant[m];
 399         csd->cmdclass     = UNSTUFF_BITS(resp, 84, 12);
 400
 401         e = UNSTUFF_BITS(resp, 47, 3);
 402         m = UNSTUFF_BITS(resp, 62, 12);
 403         csd->capacity     = (1 + m) << (e + 2);
 404
 405         csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
 406 }
 407
 408 /*
 409  * Locate a MMC card on this MMC host given a raw CID.
 410  */
 411 static struct mmc_card *mmc_find_card(struct mmc_host *host, u32 *raw_cid)
 412 {
 413         struct mmc_card *card;
 414
 415         list_for_each_entry(card, &host->cards, node) {
 416                 if (memcmp(card->raw_cid, raw_cid, sizeof(card->raw_cid)) == 0)
 417                         return card;
 418         }
 419         return NULL;
 420 }
 421
 422 /*
 423  * Allocate a new MMC card, and assign a unique RCA.
 424  */
 425 static struct mmc_card *
 426 mmc_alloc_card(struct mmc_host *host, u32 *raw_cid, unsigned int *frca)
 427 {
 428         struct mmc_card *card, *c;
 429         unsigned int rca = *frca;
 430
 431         card = kmalloc(sizeof(struct mmc_card), GFP_KERNEL);
 432         if (!card)
 433                 return ERR_PTR(-ENOMEM);
 434
 435         mmc_init_card(card, host);
 436         memcpy(card->raw_cid, raw_cid, sizeof(card->raw_cid));
 437
 438  again:
 439         list_for_each_entry(c, &host->cards, node)
 440                 if (c->rca == rca) {
 441                         rca++;
 442                         goto again;
 443                 }
 444
 445         card->rca = rca;
 446
 447         *frca = rca;
 448
 449         return card;
 450 }
 451
 452 /*
 453  * Tell attached cards to go to IDLE state
 454  */
 455 static void mmc_idle_cards(struct mmc_host *host)
 456 {
 457         struct mmc_command cmd;
 458
 459         cmd.opcode = MMC_GO_IDLE_STATE;
 460         cmd.arg = 0;
 461         cmd.flags = MMC_RSP_NONE;
 462
 463         mmc_wait_for_cmd(host, &cmd, 0);
 464
 465         mmc_delay(1);
 466 }
 467
 468 /*
 469  * Apply power to the MMC stack.
 470  */
 471 static void mmc_power_up(struct mmc_host *host)
 472 {
 473         int bit = fls(host->ocr_avail) - 1;
 474
 475         host->ios.vdd = bit;
 476         host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
 477         host->ios.power_mode = MMC_POWER_UP;
 478         host->ops->set_ios(host, &host->ios);
 479
 480         mmc_delay(1);
 481
 482         host->ios.clock = host->f_min;
 483         host->ios.power_mode = MMC_POWER_ON;
 484         host->ops->set_ios(host, &host->ios);
 485
 486         mmc_delay(2);
 487 }
 488
 489 static void mmc_power_off(struct mmc_host *host)
 490 {
 491         host->ios.clock = 0;
 492         host->ios.vdd = 0;
 493         host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
 494         host->ios.power_mode = MMC_POWER_OFF;
 495         host->ops->set_ios(host, &host->ios);
 496 }
 497
 498 static int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
 499 {
 500         struct mmc_command cmd;
 501         int i, err = 0;
 502
 503         cmd.opcode = MMC_SEND_OP_COND;
 504         cmd.arg = ocr;
 505         cmd.flags = MMC_RSP_R3;
 506
 507         for (i = 100; i; i--) {
 508                 err = mmc_wait_for_cmd(host, &cmd, 0);
 509                 if (err != MMC_ERR_NONE)
 510                         break;
 511
 512                 if (cmd.resp[0] & MMC_CARD_BUSY || ocr == 0)
 513                         break;
 514
 515                 err = MMC_ERR_TIMEOUT;
 516
 517                 mmc_delay(10);
 518         }
 519
 520         if (rocr)
 521                 *rocr = cmd.resp[0];
 522
 523         return err;
 524 }
 525
 526 /*
 527  * Discover cards by requesting their CID.  If this command
 528  * times out, it is not an error; there are no further cards
 529  * to be discovered.  Add new cards to the list.
 530  *
 531  * Create a mmc_card entry for each discovered card, assigning
 532  * it an RCA, and save the raw CID for decoding later.
 533  */
 534 static void mmc_discover_cards(struct mmc_host *host)
 535 {
 536         struct mmc_card *card;
 537         unsigned int first_rca = 1, err;
 538
 539         while (1) {
 540                 struct mmc_command cmd;
 541
 542                 cmd.opcode = MMC_ALL_SEND_CID;
 543                 cmd.arg = 0;
 544                 cmd.flags = MMC_RSP_R2;
 545
 546                 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
 547                 if (err == MMC_ERR_TIMEOUT) {
 548                         err = MMC_ERR_NONE;
 549                         break;
 550                 }
 551                 if (err != MMC_ERR_NONE) {
 552                         printk(KERN_ERR "%s: error requesting CID: %d\n",
 553                                 host->host_name, err);
 554                         break;
 555                 }
 556
 557                 card = mmc_find_card(host, cmd.resp);
 558                 if (!card) {
 559                         card = mmc_alloc_card(host, cmd.resp, &first_rca);
 560                         if (IS_ERR(card)) {
 561                                 err = PTR_ERR(card);
 562                                 break;
 563                         }
 564                         list_add(&card->node, &host->cards);
 565                 }
 566
 567                 card->state &= ~MMC_STATE_DEAD;
 568
 569                 cmd.opcode = MMC_SET_RELATIVE_ADDR;
 570                 cmd.arg = card->rca << 16;
 571                 cmd.flags = MMC_RSP_R1;
 572
 573                 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
 574                 if (err != MMC_ERR_NONE)
 575                         mmc_card_set_dead(card);
 576         }
 577 }
 578
 579 static void mmc_read_csds(struct mmc_host *host)
 580 {
 581         struct mmc_card *card;
 582
 583         list_for_each_entry(card, &host->cards, node) {
 584                 struct mmc_command cmd;
 585                 int err;
 586
 587                 if (card->state & (MMC_STATE_DEAD|MMC_STATE_PRESENT))
 588                         continue;
 589
 590                 cmd.opcode = MMC_SEND_CSD;
 591                 cmd.arg = card->rca << 16;
 592                 cmd.flags = MMC_RSP_R2;
 593
 594                 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
 595                 if (err != MMC_ERR_NONE) {
 596                         mmc_card_set_dead(card);
 597                         continue;
 598                 }
 599
 600                 memcpy(card->raw_csd, cmd.resp, sizeof(card->raw_csd));
 601
 602                 mmc_decode_csd(card);
 603                 mmc_decode_cid(card);
 604         }
 605 }
 606
 607 static unsigned int mmc_calculate_clock(struct mmc_host *host)
 608 {
 609         struct mmc_card *card;
 610         unsigned int max_dtr = host->f_max;
 611
 612         list_for_each_entry(card, &host->cards, node)
 613                 if (!mmc_card_dead(card) && max_dtr > card->csd.max_dtr)
 614                         max_dtr = card->csd.max_dtr;
 615
 616         DBG("MMC: selected %d.%03dMHz transfer rate\n",
 617             max_dtr / 1000000, (max_dtr / 1000) % 1000);
 618
 619         return max_dtr;
 620 }
 621
 622 /*
 623  * Check whether cards we already know about are still present.
 624  * We do this by requesting status, and checking whether a card
 625  * responds.
 626  *
 627  * A request for status does not cause a state change in data
 628  * transfer mode.
 629  */
 630 static void mmc_check_cards(struct mmc_host *host)
 631 {
 632         struct list_head *l, *n;
 633
 634         mmc_deselect_cards(host);
 635
 636         list_for_each_safe(l, n, &host->cards) {
 637                 struct mmc_card *card = mmc_list_to_card(l);
 638                 struct mmc_command cmd;
 639                 int err;
 640
 641                 cmd.opcode = MMC_SEND_STATUS;
 642                 cmd.arg = card->rca << 16;
 643                 cmd.flags = MMC_RSP_R1;
 644
 645                 err = mmc_wait_for_cmd(host, &cmd, CMD_RETRIES);
 646                 if (err == MMC_ERR_NONE)
 647                         continue;
 648
 649                 mmc_card_set_dead(card);
 650         }
 651 }
 652
 653 static void mmc_setup(struct mmc_host *host)
 654 {
 655         if (host->ios.power_mode != MMC_POWER_ON) {
 656                 int err;
 657                 u32 ocr;
 658
 659                 mmc_power_up(host);
 660                 mmc_idle_cards(host);
 661
 662                 err = mmc_send_op_cond(host, 0, &ocr);
 663                 if (err != MMC_ERR_NONE)
 664                         return;
 665
 666                 host->ocr = mmc_select_voltage(host, ocr);
 667
 668                 /*
 669                  * Since we're changing the OCR value, we seem to
 670                  * need to tell some cards to go back to the idle
 671                  * state.  We wait 1ms to give cards time to
 672                  * respond.
 673                  */
 674                 if (host->ocr)
 675                         mmc_idle_cards(host);
 676         } else {
 677                 host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
 678                 host->ios.clock = host->f_min;
 679                 host->ops->set_ios(host, &host->ios);
 680
 681                 /*
 682                  * We should remember the OCR mask from the existing
 683                  * cards, and detect the new cards OCR mask, combine
 684                  * the two and re-select the VDD.  However, if we do
 685                  * change VDD, we should do an idle, and then do a
 686                  * full re-initialisation.  We would need to notify
 687                  * drivers so that they can re-setup the cards as
 688                  * well, while keeping their queues at bay.
 689                  *
 690                  * For the moment, we take the easy way out - if the
 691                  * new cards don't like our currently selected VDD,
 692                  * they drop off the bus.
 693                  */
 694         }
 695
 696         if (host->ocr == 0)
 697                 return;
 698
 699         /*
 700          * Send the selected OCR multiple times... until the cards
 701          * all get the idea that they should be ready for CMD2.
 702          * (My SanDisk card seems to need this.)
 703          */
 704         mmc_send_op_cond(host, host->ocr, NULL);
 705
 706         mmc_discover_cards(host);
 707
 708         /*
 709          * Ok, now switch to push-pull mode.
 710          */
 711         host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
 712         host->ops->set_ios(host, &host->ios);
 713
 714         mmc_read_csds(host);
 715 }
 716
 717
 718 /**
 719  *      mmc_detect_change - process change of state on a MMC socket
 720  *      @host: host which changed state.
 721  *
 722  *      All we know is that card(s) have been inserted or removed
 723  *      from the socket(s).  We don't know which socket or cards.
 724  */
 725 void mmc_detect_change(struct mmc_host *host)
 726 {
 727         schedule_work(&host->detect);
 728 }
 729
 730 EXPORT_SYMBOL(mmc_detect_change);
 731
 732
 733 static void mmc_rescan(void *data)
 734 {
 735         struct mmc_host *host = data;
 736         struct list_head *l, *n;
 737
 738         mmc_claim_host(host);
 739
 740         if (host->ios.power_mode == MMC_POWER_ON)
 741                 mmc_check_cards(host);
 742
 743         mmc_setup(host);
 744
 745         if (!list_empty(&host->cards)) {
 746                 /*
 747                  * (Re-)calculate the fastest clock rate which the
 748                  * attached cards and the host support.
 749                  */
 750                 host->ios.clock = mmc_calculate_clock(host);
 751                 host->ops->set_ios(host, &host->ios);
 752         }
 753
 754         mmc_release_host(host);
 755
 756         list_for_each_safe(l, n, &host->cards) {
 757                 struct mmc_card *card = mmc_list_to_card(l);
 758
 759                 /*
 760                  * If this is a new and good card, register it.
 761                  */
 762                 if (!mmc_card_present(card) && !mmc_card_dead(card)) {
 763                         if (mmc_register_card(card))
 764                                 mmc_card_set_dead(card);
 765                         else
 766                                 mmc_card_set_present(card);
 767                 }
 768
 769                 /*
 770                  * If this card is dead, destroy it.
 771                  */
 772                 if (mmc_card_dead(card)) {
 773                         list_del(&card->node);
 774                         mmc_remove_card(card);
 775                 }
 776         }
 777
 778         /*
 779          * If we discover that there are no cards on the
 780          * bus, turn off the clock and power down.
 781          */
 782         if (list_empty(&host->cards))
 783                 mmc_power_off(host);
 784 }
 785
 786
 787 /**
 788  *      mmc_alloc_host - initialise the per-host structure.
 789  *      @extra: sizeof private data structure
 790  *      @dev: pointer to host device model structure
 791  *
 792  *      Initialise the per-host structure.
 793  */
 794 struct mmc_host *mmc_alloc_host(int extra, struct device *dev)
 795 {
 796         struct mmc_host *host;
 797
 798         host = kmalloc(sizeof(struct mmc_host) + extra, GFP_KERNEL);
 799         if (host) {
 800                 memset(host, 0, sizeof(struct mmc_host) + extra);
 801
 802                 spin_lock_init(&host->lock);
 803                 init_waitqueue_head(&host->wq);
 804                 INIT_LIST_HEAD(&host->cards);
 805                 INIT_WORK(&host->detect, mmc_rescan, host);
 806
 807                 host->dev = dev;
 808
 809                 /*
 810                  * By default, hosts do not support SGIO or large requests.
 811                  * They have to set these according to their abilities.
 812                  */
 813                 host->max_hw_segs = 1;
 814                 host->max_phys_segs = 1;
 815                 host->max_sectors = 1 << (PAGE_CACHE_SHIFT - 9);
 816                 host->max_seg_size = PAGE_CACHE_SIZE;
 817         }
 818
 819         return host;
 820 }
 821
 822 EXPORT_SYMBOL(mmc_alloc_host);
 823
 824 /**
 825  *      mmc_add_host - initialise host hardware
 826  *      @host: mmc host
 827  */
 828 int mmc_add_host(struct mmc_host *host)
 829 {
 830         static unsigned int host_num;
 831
 832         snprintf(host->host_name, sizeof(host->host_name),
 833                  "mmc%d", host_num++);
 834
 835         mmc_power_off(host);
 836         mmc_detect_change(host);
 837
 838         return 0;
 839 }
 840
 841 EXPORT_SYMBOL(mmc_add_host);
 842
 843 /**
 844  *      mmc_remove_host - remove host hardware
 845  *      @host: mmc host
 846  *
 847  *      Unregister and remove all cards associated with this host,
 848  *      and power down the MMC bus.
 849  */
 850 void mmc_remove_host(struct mmc_host *host)
 851 {
 852         struct list_head *l, *n;
 853
 854         list_for_each_safe(l, n, &host->cards) {
 855                 struct mmc_card *card = mmc_list_to_card(l);
 856
 857                 mmc_remove_card(card);
 858         }
 859
 860         mmc_power_off(host);
 861 }
 862
 863 EXPORT_SYMBOL(mmc_remove_host);
 864
 865 /**
 866  *      mmc_free_host - free the host structure
 867  *      @host: mmc host
 868  *
 869  *      Free the host once all references to it have been dropped.
 870  */
 871 void mmc_free_host(struct mmc_host *host)
 872 {
 873         flush_scheduled_work();
 874         kfree(host);
 875 }
 876
 877 EXPORT_SYMBOL(mmc_free_host);
 878
 879 #ifdef CONFIG_PM
 880
 881 /**
 882  *      mmc_suspend_host - suspend a host
 883  *      @host: mmc host
 884  *      @state: suspend mode (PM_SUSPEND_xxx)
 885  */
 886 int mmc_suspend_host(struct mmc_host *host, u32 state)
 887 {
 888         mmc_claim_host(host);
 889         mmc_deselect_cards(host);
 890         mmc_power_off(host);
 891         mmc_release_host(host);
 892
 893         return 0;
 894 }
 895
 896 EXPORT_SYMBOL(mmc_suspend_host);
 897
 898 /**
 899  *      mmc_resume_host - resume a previously suspended host
 900  *      @host: mmc host
 901  */
 902 int mmc_resume_host(struct mmc_host *host)
 903 {
 904         mmc_detect_change(host);
 905
 906         return 0;
 907 }
 908
 909 EXPORT_SYMBOL(mmc_resume_host);
 910
 911 #endif
 912
 913 MODULE_LICENSE("GPL");