core.c 20.9 KB
Newer Older
L
Linus Torvalds 已提交
1
/*
2
 *  linux/drivers/mmc/core/core.c
L
Linus Torvalds 已提交
3 4
 *
 *  Copyright (C) 2003-2004 Russell King, All Rights Reserved.
P
Pierre Ossman 已提交
5
 *  SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
6
 *  Copyright (C) 2005-2008 Pierre Ossman, All Rights Reserved.
7
 *  MMCv4 support Copyright (C) 2006 Philip Langdale, All Rights Reserved.
L
Linus Torvalds 已提交
8 9 10 11 12 13 14 15 16 17 18 19 20
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */
#include <linux/module.h>
#include <linux/init.h>
#include <linux/interrupt.h>
#include <linux/completion.h>
#include <linux/device.h>
#include <linux/delay.h>
#include <linux/pagemap.h>
#include <linux/err.h>
P
Pierre Ossman 已提交
21
#include <linux/leds.h>
P
Pierre Ossman 已提交
22
#include <linux/scatterlist.h>
23
#include <linux/log2.h>
L
Linus Torvalds 已提交
24 25 26

#include <linux/mmc/card.h>
#include <linux/mmc/host.h>
P
Pierre Ossman 已提交
27 28
#include <linux/mmc/mmc.h>
#include <linux/mmc/sd.h>
L
Linus Torvalds 已提交
29

30
#include "core.h"
31 32
#include "bus.h"
#include "host.h"
P
Pierre Ossman 已提交
33
#include "sdio_bus.h"
P
Pierre Ossman 已提交
34 35 36

#include "mmc_ops.h"
#include "sd_ops.h"
P
Pierre Ossman 已提交
37
#include "sdio_ops.h"
L
Linus Torvalds 已提交
38

39 40
static struct workqueue_struct *workqueue;

D
David Brownell 已提交
41 42 43 44 45 46 47 48
/*
 * Enabling software CRCs on the data blocks can be a significant (30%)
 * performance cost, and for other reasons may not always be desired.
 * So we allow it it to be disabled.
 */
int use_spi_crc = 1;
module_param(use_spi_crc, bool, 0);

49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
/*
 * Internal function. Schedule delayed work in the MMC work queue.
 */
static int mmc_schedule_delayed_work(struct delayed_work *work,
				     unsigned long delay)
{
	return queue_delayed_work(workqueue, work, delay);
}

/*
 * Internal function. Flush all scheduled work from the MMC work queue.
 */
static void mmc_flush_scheduled_work(void)
{
	flush_workqueue(workqueue);
}

L
Linus Torvalds 已提交
66
/**
67 68 69
 *	mmc_request_done - finish processing an MMC request
 *	@host: MMC host which completed request
 *	@mrq: MMC request which request
L
Linus Torvalds 已提交
70 71
 *
 *	MMC drivers should call this function when they have completed
72
 *	their processing of a request.
L
Linus Torvalds 已提交
73 74 75 76
 */
void mmc_request_done(struct mmc_host *host, struct mmc_request *mrq)
{
	struct mmc_command *cmd = mrq->cmd;
77 78
	int err = cmd->error;

D
David Brownell 已提交
79 80 81 82 83
	if (err && cmd->retries && mmc_host_is_spi(host)) {
		if (cmd->resp[0] & R1_SPI_ILLEGAL_COMMAND)
			cmd->retries = 0;
	}

L
Linus Torvalds 已提交
84
	if (err && cmd->retries) {
85 86 87
		pr_debug("%s: req failed (CMD%u): %d, retrying...\n",
			mmc_hostname(host), cmd->opcode, err);

L
Linus Torvalds 已提交
88 89 90
		cmd->retries--;
		cmd->error = 0;
		host->ops->request(host, mrq);
91
	} else {
P
Pierre Ossman 已提交
92 93
		led_trigger_event(host->led, LED_OFF);

94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
		pr_debug("%s: req done (CMD%u): %d: %08x %08x %08x %08x\n",
			mmc_hostname(host), cmd->opcode, err,
			cmd->resp[0], cmd->resp[1],
			cmd->resp[2], cmd->resp[3]);

		if (mrq->data) {
			pr_debug("%s:     %d bytes transferred: %d\n",
				mmc_hostname(host),
				mrq->data->bytes_xfered, mrq->data->error);
		}

		if (mrq->stop) {
			pr_debug("%s:     (CMD%u): %d: %08x %08x %08x %08x\n",
				mmc_hostname(host), mrq->stop->opcode,
				mrq->stop->error,
				mrq->stop->resp[0], mrq->stop->resp[1],
				mrq->stop->resp[2], mrq->stop->resp[3]);
		}

		if (mrq->done)
			mrq->done(mrq);
L
Linus Torvalds 已提交
115 116 117 118 119
	}
}

EXPORT_SYMBOL(mmc_request_done);

120
static void
L
Linus Torvalds 已提交
121 122
mmc_start_request(struct mmc_host *host, struct mmc_request *mrq)
{
P
Pierre Ossman 已提交
123 124
#ifdef CONFIG_MMC_DEBUG
	unsigned int i, sz;
125
	struct scatterlist *sg;
P
Pierre Ossman 已提交
126 127
#endif

128 129 130
	pr_debug("%s: starting CMD%u arg %08x flags %08x\n",
		 mmc_hostname(host), mrq->cmd->opcode,
		 mrq->cmd->arg, mrq->cmd->flags);
L
Linus Torvalds 已提交
131

132 133 134 135 136
	if (mrq->data) {
		pr_debug("%s:     blksz %d blocks %d flags %08x "
			"tsac %d ms nsac %d\n",
			mmc_hostname(host), mrq->data->blksz,
			mrq->data->blocks, mrq->data->flags,
137
			mrq->data->timeout_ns / 1000000,
138 139 140 141 142 143 144 145 146
			mrq->data->timeout_clks);
	}

	if (mrq->stop) {
		pr_debug("%s:     CMD%u arg %08x flags %08x\n",
			 mmc_hostname(host), mrq->stop->opcode,
			 mrq->stop->arg, mrq->stop->flags);
	}

P
Pierre Ossman 已提交
147
	WARN_ON(!host->claimed);
L
Linus Torvalds 已提交
148

P
Pierre Ossman 已提交
149 150
	led_trigger_event(host->led, LED_FULL);

L
Linus Torvalds 已提交
151 152 153
	mrq->cmd->error = 0;
	mrq->cmd->mrq = mrq;
	if (mrq->data) {
154
		BUG_ON(mrq->data->blksz > host->max_blk_size);
155 156 157
		BUG_ON(mrq->data->blocks > host->max_blk_count);
		BUG_ON(mrq->data->blocks * mrq->data->blksz >
			host->max_req_size);
158

P
Pierre Ossman 已提交
159 160
#ifdef CONFIG_MMC_DEBUG
		sz = 0;
161 162
		for_each_sg(mrq->data->sg, sg, mrq->data->sg_len, i)
			sz += sg->length;
P
Pierre Ossman 已提交
163 164 165
		BUG_ON(sz != mrq->data->blocks * mrq->data->blksz);
#endif

L
Linus Torvalds 已提交
166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182
		mrq->cmd->data = mrq->data;
		mrq->data->error = 0;
		mrq->data->mrq = mrq;
		if (mrq->stop) {
			mrq->data->stop = mrq->stop;
			mrq->stop->error = 0;
			mrq->stop->mrq = mrq;
		}
	}
	host->ops->request(host, mrq);
}

static void mmc_wait_done(struct mmc_request *mrq)
{
	complete(mrq->done_data);
}

P
Pierre Ossman 已提交
183 184 185 186 187 188 189 190 191 192
/**
 *	mmc_wait_for_req - start a request and wait for completion
 *	@host: MMC host to start command
 *	@mrq: MMC request to start
 *
 *	Start a new MMC custom command request for a host, and wait
 *	for the command to complete. Does not attempt to parse the
 *	response.
 */
void mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq)
L
Linus Torvalds 已提交
193
{
194
	DECLARE_COMPLETION_ONSTACK(complete);
L
Linus Torvalds 已提交
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219

	mrq->done_data = &complete;
	mrq->done = mmc_wait_done;

	mmc_start_request(host, mrq);

	wait_for_completion(&complete);
}

EXPORT_SYMBOL(mmc_wait_for_req);

/**
 *	mmc_wait_for_cmd - start a command and wait for completion
 *	@host: MMC host to start command
 *	@cmd: MMC command to start
 *	@retries: maximum number of retries
 *
 *	Start a new MMC command for a host, and wait for the command
 *	to complete.  Return any error that occurred while the command
 *	was executing.  Do not attempt to parse the response.
 */
int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries)
{
	struct mmc_request mrq;

P
Pierre Ossman 已提交
220
	WARN_ON(!host->claimed);
L
Linus Torvalds 已提交
221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236

	memset(&mrq, 0, sizeof(struct mmc_request));

	memset(cmd->resp, 0, sizeof(cmd->resp));
	cmd->retries = retries;

	mrq.cmd = cmd;
	cmd->data = NULL;

	mmc_wait_for_req(host, &mrq);

	return cmd->error;
}

EXPORT_SYMBOL(mmc_wait_for_cmd);

237 238 239 240
/**
 *	mmc_set_data_timeout - set the timeout for a data command
 *	@data: data phase for command
 *	@card: the MMC card associated with the data transfer
P
Pierre Ossman 已提交
241 242 243
 *
 *	Computes the data timeout parameters according to the
 *	correct algorithm given the card type.
244
 */
245
void mmc_set_data_timeout(struct mmc_data *data, const struct mmc_card *card)
246 247 248
{
	unsigned int mult;

249 250 251 252 253 254 255 256 257
	/*
	 * SDIO cards only define an upper 1 s limit on access.
	 */
	if (mmc_card_sdio(card)) {
		data->timeout_ns = 1000000000;
		data->timeout_clks = 0;
		return;
	}

258 259 260 261 262 263 264 265 266
	/*
	 * SD cards use a 100 multiplier rather than 10
	 */
	mult = mmc_card_sd(card) ? 100 : 10;

	/*
	 * Scale up the multiplier (and therefore the timeout) by
	 * the r2w factor for writes.
	 */
267
	if (data->flags & MMC_DATA_WRITE)
268 269 270 271 272 273 274 275 276 277 278 279 280 281 282
		mult <<= card->csd.r2w_factor;

	data->timeout_ns = card->csd.tacc_ns * mult;
	data->timeout_clks = card->csd.tacc_clks * mult;

	/*
	 * SD cards also have an upper limit on the timeout.
	 */
	if (mmc_card_sd(card)) {
		unsigned int timeout_us, limit_us;

		timeout_us = data->timeout_ns / 1000;
		timeout_us += data->timeout_clks * 1000 /
			(card->host->ios.clock / 1000);

283
		if (data->flags & MMC_DATA_WRITE)
284 285 286 287 288
			/*
			 * The limit is really 250 ms, but that is
			 * insufficient for some crappy cards.
			 */
			limit_us = 300000;
289 290 291
		else
			limit_us = 100000;

292 293 294 295
		/*
		 * SDHC cards always use these fixed values.
		 */
		if (timeout_us > limit_us || mmc_card_blockaddr(card)) {
296 297 298 299 300 301 302
			data->timeout_ns = limit_us * 1000;
			data->timeout_clks = 0;
		}
	}
}
EXPORT_SYMBOL(mmc_set_data_timeout);

303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
/**
 *	mmc_align_data_size - pads a transfer size to a more optimal value
 *	@card: the MMC card associated with the data transfer
 *	@sz: original transfer size
 *
 *	Pads the original data size with a number of extra bytes in
 *	order to avoid controller bugs and/or performance hits
 *	(e.g. some controllers revert to PIO for certain sizes).
 *
 *	Returns the improved size, which might be unmodified.
 *
 *	Note that this function is only relevant when issuing a
 *	single scatter gather entry.
 */
unsigned int mmc_align_data_size(struct mmc_card *card, unsigned int sz)
{
	/*
	 * FIXME: We don't have a system for the controller to tell
	 * the core about its problems yet, so for now we just 32-bit
	 * align the size.
	 */
	sz = ((sz + 3) / 4) * 4;

	return sz;
}
EXPORT_SYMBOL(mmc_align_data_size);

L
Linus Torvalds 已提交
330
/**
331
 *	__mmc_claim_host - exclusively claim a host
L
Linus Torvalds 已提交
332
 *	@host: mmc host to claim
333
 *	@abort: whether or not the operation should be aborted
L
Linus Torvalds 已提交
334
 *
335 336 337 338
 *	Claim a host for a set of operations.  If @abort is non null and
 *	dereference a non-zero value then this will return prematurely with
 *	that non-zero value without acquiring the lock.  Returns zero
 *	with the lock held otherwise.
L
Linus Torvalds 已提交
339
 */
340
int __mmc_claim_host(struct mmc_host *host, atomic_t *abort)
L
Linus Torvalds 已提交
341 342 343
{
	DECLARE_WAITQUEUE(wait, current);
	unsigned long flags;
344
	int stop;
L
Linus Torvalds 已提交
345

346 347
	might_sleep();

L
Linus Torvalds 已提交
348 349 350 351
	add_wait_queue(&host->wq, &wait);
	spin_lock_irqsave(&host->lock, flags);
	while (1) {
		set_current_state(TASK_UNINTERRUPTIBLE);
352 353
		stop = abort ? atomic_read(abort) : 0;
		if (stop || !host->claimed)
L
Linus Torvalds 已提交
354 355 356 357 358 359
			break;
		spin_unlock_irqrestore(&host->lock, flags);
		schedule();
		spin_lock_irqsave(&host->lock, flags);
	}
	set_current_state(TASK_RUNNING);
360 361 362 363
	if (!stop)
		host->claimed = 1;
	else
		wake_up(&host->wq);
L
Linus Torvalds 已提交
364 365
	spin_unlock_irqrestore(&host->lock, flags);
	remove_wait_queue(&host->wq, &wait);
366
	return stop;
L
Linus Torvalds 已提交
367 368
}

369
EXPORT_SYMBOL(__mmc_claim_host);
L
Linus Torvalds 已提交
370 371 372 373 374 375 376 377 378 379 380 381

/**
 *	mmc_release_host - release a host
 *	@host: mmc host to release
 *
 *	Release a MMC host, allowing others to claim the host
 *	for their operations.
 */
void mmc_release_host(struct mmc_host *host)
{
	unsigned long flags;

P
Pierre Ossman 已提交
382
	WARN_ON(!host->claimed);
L
Linus Torvalds 已提交
383 384

	spin_lock_irqsave(&host->lock, flags);
P
Pierre Ossman 已提交
385
	host->claimed = 0;
L
Linus Torvalds 已提交
386 387 388 389 390 391 392
	spin_unlock_irqrestore(&host->lock, flags);

	wake_up(&host->wq);
}

EXPORT_SYMBOL(mmc_release_host);

P
Pierre Ossman 已提交
393 394 395 396
/*
 * Internal function that does the actual ios call to the host driver,
 * optionally printing some debug output.
 */
397 398 399 400
static inline void mmc_set_ios(struct mmc_host *host)
{
	struct mmc_ios *ios = &host->ios;

401 402
	pr_debug("%s: clock %uHz busmode %u powermode %u cs %u Vdd %u "
		"width %u timing %u\n",
403 404
		 mmc_hostname(host), ios->clock, ios->bus_mode,
		 ios->power_mode, ios->chip_select, ios->vdd,
405
		 ios->bus_width, ios->timing);
406

407 408 409
	host->ops->set_ios(host, ios);
}

P
Pierre Ossman 已提交
410 411 412
/*
 * Control chip select pin on a host.
 */
P
Pierre Ossman 已提交
413
void mmc_set_chip_select(struct mmc_host *host, int mode)
L
Linus Torvalds 已提交
414
{
P
Pierre Ossman 已提交
415 416
	host->ios.chip_select = mode;
	mmc_set_ios(host);
L
Linus Torvalds 已提交
417 418
}

P
Pierre Ossman 已提交
419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451
/*
 * Sets the host clock to the highest possible frequency that
 * is below "hz".
 */
void mmc_set_clock(struct mmc_host *host, unsigned int hz)
{
	WARN_ON(hz < host->f_min);

	if (hz > host->f_max)
		hz = host->f_max;

	host->ios.clock = hz;
	mmc_set_ios(host);
}

/*
 * Change the bus mode (open drain/push-pull) of a host.
 */
void mmc_set_bus_mode(struct mmc_host *host, unsigned int mode)
{
	host->ios.bus_mode = mode;
	mmc_set_ios(host);
}

/*
 * Change data bus width of a host.
 */
void mmc_set_bus_width(struct mmc_host *host, unsigned int width)
{
	host->ios.bus_width = width;
	mmc_set_ios(host);
}

452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525
/**
 * mmc_vdd_to_ocrbitnum - Convert a voltage to the OCR bit number
 * @vdd:	voltage (mV)
 * @low_bits:	prefer low bits in boundary cases
 *
 * This function returns the OCR bit number according to the provided @vdd
 * value. If conversion is not possible a negative errno value returned.
 *
 * Depending on the @low_bits flag the function prefers low or high OCR bits
 * on boundary voltages. For example,
 * with @low_bits = true, 3300 mV translates to ilog2(MMC_VDD_32_33);
 * with @low_bits = false, 3300 mV translates to ilog2(MMC_VDD_33_34);
 *
 * Any value in the [1951:1999] range translates to the ilog2(MMC_VDD_20_21).
 */
static int mmc_vdd_to_ocrbitnum(int vdd, bool low_bits)
{
	const int max_bit = ilog2(MMC_VDD_35_36);
	int bit;

	if (vdd < 1650 || vdd > 3600)
		return -EINVAL;

	if (vdd >= 1650 && vdd <= 1950)
		return ilog2(MMC_VDD_165_195);

	if (low_bits)
		vdd -= 1;

	/* Base 2000 mV, step 100 mV, bit's base 8. */
	bit = (vdd - 2000) / 100 + 8;
	if (bit > max_bit)
		return max_bit;
	return bit;
}

/**
 * mmc_vddrange_to_ocrmask - Convert a voltage range to the OCR mask
 * @vdd_min:	minimum voltage value (mV)
 * @vdd_max:	maximum voltage value (mV)
 *
 * This function returns the OCR mask bits according to the provided @vdd_min
 * and @vdd_max values. If conversion is not possible the function returns 0.
 *
 * Notes wrt boundary cases:
 * This function sets the OCR bits for all boundary voltages, for example
 * [3300:3400] range is translated to MMC_VDD_32_33 | MMC_VDD_33_34 |
 * MMC_VDD_34_35 mask.
 */
u32 mmc_vddrange_to_ocrmask(int vdd_min, int vdd_max)
{
	u32 mask = 0;

	if (vdd_max < vdd_min)
		return 0;

	/* Prefer high bits for the boundary vdd_max values. */
	vdd_max = mmc_vdd_to_ocrbitnum(vdd_max, false);
	if (vdd_max < 0)
		return 0;

	/* Prefer low bits for the boundary vdd_min values. */
	vdd_min = mmc_vdd_to_ocrbitnum(vdd_min, true);
	if (vdd_min < 0)
		return 0;

	/* Fill the mask, from max bit to min bit. */
	while (vdd_max >= vdd_min)
		mask |= 1 << vdd_max--;

	return mask;
}
EXPORT_SYMBOL(mmc_vddrange_to_ocrmask);

L
Linus Torvalds 已提交
526 527 528 529
/*
 * Mask off any voltages we don't support and select
 * the lowest voltage
 */
P
Pierre Ossman 已提交
530
u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
L
Linus Torvalds 已提交
531 532 533 534 535 536 537 538 539
{
	int bit;

	ocr &= host->ocr_avail;

	bit = ffs(ocr);
	if (bit) {
		bit -= 1;

540
		ocr &= 3 << bit;
L
Linus Torvalds 已提交
541 542

		host->ios.vdd = bit;
543
		mmc_set_ios(host);
L
Linus Torvalds 已提交
544
	} else {
545 546
		pr_warning("%s: host doesn't support card's voltages\n",
				mmc_hostname(host));
L
Linus Torvalds 已提交
547 548 549 550 551 552
		ocr = 0;
	}

	return ocr;
}

P
Pierre Ossman 已提交
553
/*
P
Pierre Ossman 已提交
554
 * Select timing parameters for host.
P
Pierre Ossman 已提交
555
 */
P
Pierre Ossman 已提交
556
void mmc_set_timing(struct mmc_host *host, unsigned int timing)
P
Pierre Ossman 已提交
557
{
P
Pierre Ossman 已提交
558 559
	host->ios.timing = timing;
	mmc_set_ios(host);
P
Pierre Ossman 已提交
560 561
}

L
Linus Torvalds 已提交
562
/*
563 564 565 566 567 568 569 570 571
 * Apply power to the MMC stack.  This is a two-stage process.
 * First, we enable power to the card without the clock running.
 * We then wait a bit for the power to stabilise.  Finally,
 * enable the bus drivers and clock to the card.
 *
 * We must _NOT_ enable the clock prior to power stablising.
 *
 * If a host does all the power sequencing itself, ignore the
 * initial MMC_POWER_UP stage.
L
Linus Torvalds 已提交
572 573 574 575 576 577
 */
static void mmc_power_up(struct mmc_host *host)
{
	int bit = fls(host->ocr_avail) - 1;

	host->ios.vdd = bit;
D
David Brownell 已提交
578 579 580 581 582 583 584
	if (mmc_host_is_spi(host)) {
		host->ios.chip_select = MMC_CS_HIGH;
		host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
	} else {
		host->ios.chip_select = MMC_CS_DONTCARE;
		host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
	}
L
Linus Torvalds 已提交
585
	host->ios.power_mode = MMC_POWER_UP;
P
Pierre Ossman 已提交
586
	host->ios.bus_width = MMC_BUS_WIDTH_1;
587
	host->ios.timing = MMC_TIMING_LEGACY;
588
	mmc_set_ios(host);
L
Linus Torvalds 已提交
589

P
Pierre Ossman 已提交
590 591 592 593 594
	/*
	 * This delay should be sufficient to allow the power supply
	 * to reach the minimum voltage.
	 */
	mmc_delay(2);
L
Linus Torvalds 已提交
595 596 597

	host->ios.clock = host->f_min;
	host->ios.power_mode = MMC_POWER_ON;
598
	mmc_set_ios(host);
L
Linus Torvalds 已提交
599

P
Pierre Ossman 已提交
600 601 602 603
	/*
	 * This delay must be at least 74 clock sizes, or 1 ms, or the
	 * time required to reach a stable voltage.
	 */
L
Linus Torvalds 已提交
604 605 606 607 608 609 610
	mmc_delay(2);
}

static void mmc_power_off(struct mmc_host *host)
{
	host->ios.clock = 0;
	host->ios.vdd = 0;
D
David Brownell 已提交
611 612 613 614
	if (!mmc_host_is_spi(host)) {
		host->ios.bus_mode = MMC_BUSMODE_OPENDRAIN;
		host->ios.chip_select = MMC_CS_DONTCARE;
	}
L
Linus Torvalds 已提交
615
	host->ios.power_mode = MMC_POWER_OFF;
P
Pierre Ossman 已提交
616
	host->ios.bus_width = MMC_BUS_WIDTH_1;
617
	host->ios.timing = MMC_TIMING_LEGACY;
618
	mmc_set_ios(host);
L
Linus Torvalds 已提交
619 620
}

621 622 623
/*
 * Cleanup when the last reference to the bus operator is dropped.
 */
624
static void __mmc_release_bus(struct mmc_host *host)
625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659
{
	BUG_ON(!host);
	BUG_ON(host->bus_refs);
	BUG_ON(!host->bus_dead);

	host->bus_ops = NULL;
}

/*
 * Increase reference count of bus operator
 */
static inline void mmc_bus_get(struct mmc_host *host)
{
	unsigned long flags;

	spin_lock_irqsave(&host->lock, flags);
	host->bus_refs++;
	spin_unlock_irqrestore(&host->lock, flags);
}

/*
 * Decrease reference count of bus operator and free it if
 * it is the last reference.
 */
static inline void mmc_bus_put(struct mmc_host *host)
{
	unsigned long flags;

	spin_lock_irqsave(&host->lock, flags);
	host->bus_refs--;
	if ((host->bus_refs == 0) && host->bus_ops)
		__mmc_release_bus(host);
	spin_unlock_irqrestore(&host->lock, flags);
}

L
Linus Torvalds 已提交
660
/*
P
Pierre Ossman 已提交
661 662
 * Assign a mmc bus handler to a host. Only one bus handler may control a
 * host at any given time.
L
Linus Torvalds 已提交
663
 */
P
Pierre Ossman 已提交
664
void mmc_attach_bus(struct mmc_host *host, const struct mmc_bus_ops *ops)
L
Linus Torvalds 已提交
665
{
P
Pierre Ossman 已提交
666
	unsigned long flags;
667

P
Pierre Ossman 已提交
668 669
	BUG_ON(!host);
	BUG_ON(!ops);
P
Pierre Ossman 已提交
670

P
Pierre Ossman 已提交
671
	WARN_ON(!host->claimed);
672

P
Pierre Ossman 已提交
673
	spin_lock_irqsave(&host->lock, flags);
674

P
Pierre Ossman 已提交
675 676
	BUG_ON(host->bus_ops);
	BUG_ON(host->bus_refs);
P
Pierre Ossman 已提交
677

P
Pierre Ossman 已提交
678 679 680
	host->bus_ops = ops;
	host->bus_refs = 1;
	host->bus_dead = 0;
P
Pierre Ossman 已提交
681

P
Pierre Ossman 已提交
682
	spin_unlock_irqrestore(&host->lock, flags);
P
Pierre Ossman 已提交
683 684
}

P
Pierre Ossman 已提交
685 686 687 688 689
/*
 * Remove the current bus handler from a host. Assumes that there are
 * no interesting cards left, so the bus is powered down.
 */
void mmc_detach_bus(struct mmc_host *host)
690
{
P
Pierre Ossman 已提交
691
	unsigned long flags;
692

P
Pierre Ossman 已提交
693
	BUG_ON(!host);
694

P
Pierre Ossman 已提交
695 696
	WARN_ON(!host->claimed);
	WARN_ON(!host->bus_ops);
697

P
Pierre Ossman 已提交
698
	spin_lock_irqsave(&host->lock, flags);
699

P
Pierre Ossman 已提交
700
	host->bus_dead = 1;
701

P
Pierre Ossman 已提交
702
	spin_unlock_irqrestore(&host->lock, flags);
L
Linus Torvalds 已提交
703

P
Pierre Ossman 已提交
704
	mmc_power_off(host);
L
Linus Torvalds 已提交
705

P
Pierre Ossman 已提交
706
	mmc_bus_put(host);
L
Linus Torvalds 已提交
707 708 709 710 711
}

/**
 *	mmc_detect_change - process change of state on a MMC socket
 *	@host: host which changed state.
712
 *	@delay: optional delay to wait before detection (jiffies)
L
Linus Torvalds 已提交
713
 *
P
Pierre Ossman 已提交
714 715 716 717
 *	MMC drivers should call this when they detect a card has been
 *	inserted or removed. The MMC layer will confirm that any
 *	present card is still functional, and initialize any newly
 *	inserted.
L
Linus Torvalds 已提交
718
 */
719
void mmc_detect_change(struct mmc_host *host, unsigned long delay)
L
Linus Torvalds 已提交
720
{
721
#ifdef CONFIG_MMC_DEBUG
722
	unsigned long flags;
A
Andrew Morton 已提交
723
	spin_lock_irqsave(&host->lock, flags);
P
Pierre Ossman 已提交
724
	WARN_ON(host->removed);
A
Andrew Morton 已提交
725
	spin_unlock_irqrestore(&host->lock, flags);
726 727
#endif

D
David Howells 已提交
728
	mmc_schedule_delayed_work(&host->detect, delay);
L
Linus Torvalds 已提交
729 730 731 732 733
}

EXPORT_SYMBOL(mmc_detect_change);


734
void mmc_rescan(struct work_struct *work)
L
Linus Torvalds 已提交
735
{
D
David Howells 已提交
736 737
	struct mmc_host *host =
		container_of(work, struct mmc_host, detect.work);
P
Pierre Ossman 已提交
738 739
	u32 ocr;
	int err;
L
Linus Torvalds 已提交
740

P
Pierre Ossman 已提交
741
	mmc_bus_get(host);
P
Pierre Ossman 已提交
742

P
Pierre Ossman 已提交
743
	if (host->bus_ops == NULL) {
L
Linus Torvalds 已提交
744
		/*
P
Pierre Ossman 已提交
745 746
		 * Only we can add a new handler, so it's safe to
		 * release the lock here.
L
Linus Torvalds 已提交
747
		 */
P
Pierre Ossman 已提交
748
		mmc_bus_put(host);
L
Linus Torvalds 已提交
749

750 751 752
		if (host->ops->get_cd && host->ops->get_cd(host) == 0)
			goto out;

P
Pierre Ossman 已提交
753
		mmc_claim_host(host);
L
Linus Torvalds 已提交
754

P
Pierre Ossman 已提交
755 756
		mmc_power_up(host);
		mmc_go_idle(host);
L
Linus Torvalds 已提交
757

P
Pierre Ossman 已提交
758
		mmc_send_if_cond(host, host->ocr_avail);
L
Linus Torvalds 已提交
759

P
Pierre Ossman 已提交
760 761 762 763 764 765 766
		/*
		 * First we search for SDIO...
		 */
		err = mmc_send_io_op_cond(host, 0, &ocr);
		if (!err) {
			if (mmc_attach_sdio(host, ocr))
				mmc_power_off(host);
767
			goto out;
P
Pierre Ossman 已提交
768 769 770 771 772
		}

		/*
		 * ...then normal SD...
		 */
P
Pierre Ossman 已提交
773
		err = mmc_send_app_op_cond(host, 0, &ocr);
P
Pierre Ossman 已提交
774
		if (!err) {
P
Pierre Ossman 已提交
775 776
			if (mmc_attach_sd(host, ocr))
				mmc_power_off(host);
777
			goto out;
P
Pierre Ossman 已提交
778 779 780 781 782 783 784 785
		}

		/*
		 * ...and finally MMC.
		 */
		err = mmc_send_op_cond(host, 0, &ocr);
		if (!err) {
			if (mmc_attach_mmc(host, ocr))
P
Pierre Ossman 已提交
786
				mmc_power_off(host);
787
			goto out;
P
Pierre Ossman 已提交
788
		}
P
Pierre Ossman 已提交
789 790 791

		mmc_release_host(host);
		mmc_power_off(host);
P
Pierre Ossman 已提交
792 793 794 795 796 797
	} else {
		if (host->bus_ops->detect && !host->bus_dead)
			host->bus_ops->detect(host);

		mmc_bus_put(host);
	}
798 799 800
out:
	if (host->caps & MMC_CAP_NEEDS_POLL)
		mmc_schedule_delayed_work(&host->detect, HZ);
L
Linus Torvalds 已提交
801 802
}

803
void mmc_start_host(struct mmc_host *host)
L
Linus Torvalds 已提交
804
{
805 806
	mmc_power_off(host);
	mmc_detect_change(host, 0);
L
Linus Torvalds 已提交
807 808
}

809
void mmc_stop_host(struct mmc_host *host)
L
Linus Torvalds 已提交
810
{
811
#ifdef CONFIG_MMC_DEBUG
812 813
	unsigned long flags;
	spin_lock_irqsave(&host->lock, flags);
814
	host->removed = 1;
815
	spin_unlock_irqrestore(&host->lock, flags);
816 817
#endif

818
	cancel_delayed_work(&host->detect);
819 820
	mmc_flush_scheduled_work();

P
Pierre Ossman 已提交
821 822 823 824 825 826 827 828
	mmc_bus_get(host);
	if (host->bus_ops && !host->bus_dead) {
		if (host->bus_ops->remove)
			host->bus_ops->remove(host);

		mmc_claim_host(host);
		mmc_detach_bus(host);
		mmc_release_host(host);
L
Linus Torvalds 已提交
829
	}
P
Pierre Ossman 已提交
830 831 832
	mmc_bus_put(host);

	BUG_ON(host->card);
L
Linus Torvalds 已提交
833 834 835 836 837 838 839 840 841 842 843

	mmc_power_off(host);
}

#ifdef CONFIG_PM

/**
 *	mmc_suspend_host - suspend a host
 *	@host: mmc host
 *	@state: suspend mode (PM_SUSPEND_xxx)
 */
844
int mmc_suspend_host(struct mmc_host *host, pm_message_t state)
L
Linus Torvalds 已提交
845
{
846
	cancel_delayed_work(&host->detect);
P
Pierre Ossman 已提交
847 848
	mmc_flush_scheduled_work();

P
Pierre Ossman 已提交
849 850
	mmc_bus_get(host);
	if (host->bus_ops && !host->bus_dead) {
851 852 853 854 855 856 857 858 859 860
		if (host->bus_ops->suspend)
			host->bus_ops->suspend(host);
		if (!host->bus_ops->resume) {
			if (host->bus_ops->remove)
				host->bus_ops->remove(host);

			mmc_claim_host(host);
			mmc_detach_bus(host);
			mmc_release_host(host);
		}
P
Pierre Ossman 已提交
861
	}
P
Pierre Ossman 已提交
862 863
	mmc_bus_put(host);

L
Linus Torvalds 已提交
864 865 866 867 868 869 870 871 872 873 874 875 876
	mmc_power_off(host);

	return 0;
}

EXPORT_SYMBOL(mmc_suspend_host);

/**
 *	mmc_resume_host - resume a previously suspended host
 *	@host: mmc host
 */
int mmc_resume_host(struct mmc_host *host)
{
877 878 879
	mmc_bus_get(host);
	if (host->bus_ops && !host->bus_dead) {
		mmc_power_up(host);
880
		mmc_select_voltage(host, host->ocr);
881 882 883 884 885 886 887 888 889 890
		BUG_ON(!host->bus_ops->resume);
		host->bus_ops->resume(host);
	}
	mmc_bus_put(host);

	/*
	 * We add a slight delay here so that resume can progress
	 * in parallel.
	 */
	mmc_detect_change(host, 1);
L
Linus Torvalds 已提交
891 892 893 894 895 896 897 898

	return 0;
}

EXPORT_SYMBOL(mmc_resume_host);

#endif

899 900 901 902 903 904 905 906 907
static int __init mmc_init(void)
{
	int ret;

	workqueue = create_singlethread_workqueue("kmmcd");
	if (!workqueue)
		return -ENOMEM;

	ret = mmc_register_bus();
P
Pierre Ossman 已提交
908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927
	if (ret)
		goto destroy_workqueue;

	ret = mmc_register_host_class();
	if (ret)
		goto unregister_bus;

	ret = sdio_register_bus();
	if (ret)
		goto unregister_host_class;

	return 0;

unregister_host_class:
	mmc_unregister_host_class();
unregister_bus:
	mmc_unregister_bus();
destroy_workqueue:
	destroy_workqueue(workqueue);

928 929 930 931 932
	return ret;
}

static void __exit mmc_exit(void)
{
P
Pierre Ossman 已提交
933
	sdio_unregister_bus();
934 935 936 937 938
	mmc_unregister_host_class();
	mmc_unregister_bus();
	destroy_workqueue(workqueue);
}

939
subsys_initcall(mmc_init);
940 941
module_exit(mmc_exit);

L
Linus Torvalds 已提交
942
MODULE_LICENSE("GPL");