Linux Audio

Check our new training course

Loading...
v6.8
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 *  linux/drivers/mmc/sdio.c
   4 *
   5 *  Copyright 2006-2007 Pierre Ossman
 
 
 
 
 
   6 */
   7
   8#include <linux/err.h>
   9#include <linux/pm_runtime.h>
  10#include <linux/sysfs.h>
  11
  12#include <linux/mmc/host.h>
  13#include <linux/mmc/card.h>
  14#include <linux/mmc/mmc.h>
  15#include <linux/mmc/sdio.h>
  16#include <linux/mmc/sdio_func.h>
  17#include <linux/mmc/sdio_ids.h>
  18
  19#include "core.h"
  20#include "card.h"
  21#include "host.h"
  22#include "bus.h"
  23#include "quirks.h"
  24#include "sd.h"
  25#include "sdio_bus.h"
  26#include "mmc_ops.h"
  27#include "sd_ops.h"
  28#include "sdio_ops.h"
  29#include "sdio_cis.h"
  30
  31MMC_DEV_ATTR(vendor, "0x%04x\n", card->cis.vendor);
  32MMC_DEV_ATTR(device, "0x%04x\n", card->cis.device);
  33MMC_DEV_ATTR(revision, "%u.%u\n", card->major_rev, card->minor_rev);
  34MMC_DEV_ATTR(ocr, "0x%08x\n", card->ocr);
  35MMC_DEV_ATTR(rca, "0x%04x\n", card->rca);
  36
  37#define sdio_info_attr(num)									\
  38static ssize_t info##num##_show(struct device *dev, struct device_attribute *attr, char *buf)	\
  39{												\
  40	struct mmc_card *card = mmc_dev_to_card(dev);						\
  41												\
  42	if (num > card->num_info)								\
  43		return -ENODATA;								\
  44	if (!card->info[num - 1][0])								\
  45		return 0;									\
  46	return sysfs_emit(buf, "%s\n", card->info[num - 1]);					\
  47}												\
  48static DEVICE_ATTR_RO(info##num)
  49
  50sdio_info_attr(1);
  51sdio_info_attr(2);
  52sdio_info_attr(3);
  53sdio_info_attr(4);
  54
  55static struct attribute *sdio_std_attrs[] = {
  56	&dev_attr_vendor.attr,
  57	&dev_attr_device.attr,
  58	&dev_attr_revision.attr,
  59	&dev_attr_info1.attr,
  60	&dev_attr_info2.attr,
  61	&dev_attr_info3.attr,
  62	&dev_attr_info4.attr,
  63	&dev_attr_ocr.attr,
  64	&dev_attr_rca.attr,
  65	NULL,
  66};
  67ATTRIBUTE_GROUPS(sdio_std);
  68
  69static struct device_type sdio_type = {
  70	.groups = sdio_std_groups,
  71};
  72
  73static int sdio_read_fbr(struct sdio_func *func)
  74{
  75	int ret;
  76	unsigned char data;
  77
  78	if (mmc_card_nonstd_func_interface(func->card)) {
  79		func->class = SDIO_CLASS_NONE;
  80		return 0;
  81	}
  82
  83	ret = mmc_io_rw_direct(func->card, 0, 0,
  84		SDIO_FBR_BASE(func->num) + SDIO_FBR_STD_IF, 0, &data);
  85	if (ret)
  86		goto out;
  87
  88	data &= 0x0f;
  89
  90	if (data == 0x0f) {
  91		ret = mmc_io_rw_direct(func->card, 0, 0,
  92			SDIO_FBR_BASE(func->num) + SDIO_FBR_STD_IF_EXT, 0, &data);
  93		if (ret)
  94			goto out;
  95	}
  96
  97	func->class = data;
  98
  99out:
 100	return ret;
 101}
 102
 103static int sdio_init_func(struct mmc_card *card, unsigned int fn)
 104{
 105	int ret;
 106	struct sdio_func *func;
 107
 108	if (WARN_ON(fn > SDIO_MAX_FUNCS))
 109		return -EINVAL;
 110
 111	func = sdio_alloc_func(card);
 112	if (IS_ERR(func))
 113		return PTR_ERR(func);
 114
 115	func->num = fn;
 116
 117	if (!(card->quirks & MMC_QUIRK_NONSTD_SDIO)) {
 118		ret = sdio_read_fbr(func);
 119		if (ret)
 120			goto fail;
 121
 122		ret = sdio_read_func_cis(func);
 123		if (ret)
 124			goto fail;
 125	} else {
 126		func->vendor = func->card->cis.vendor;
 127		func->device = func->card->cis.device;
 128		func->max_blksize = func->card->cis.blksize;
 129	}
 130
 131	card->sdio_func[fn - 1] = func;
 132
 133	return 0;
 134
 135fail:
 136	/*
 137	 * It is okay to remove the function here even though we hold
 138	 * the host lock as we haven't registered the device yet.
 139	 */
 140	sdio_remove_func(func);
 141	return ret;
 142}
 143
 144static int sdio_read_cccr(struct mmc_card *card, u32 ocr)
 145{
 146	int ret;
 147	int cccr_vsn;
 148	int uhs = ocr & R4_18V_PRESENT;
 149	unsigned char data;
 150	unsigned char speed;
 151
 152	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_CCCR, 0, &data);
 153	if (ret)
 154		goto out;
 155
 156	cccr_vsn = data & 0x0f;
 157
 158	if (cccr_vsn > SDIO_CCCR_REV_3_00) {
 159		pr_err("%s: unrecognised CCCR structure version %d\n",
 160			mmc_hostname(card->host), cccr_vsn);
 161		return -EINVAL;
 162	}
 163
 164	card->cccr.sdio_vsn = (data & 0xf0) >> 4;
 165
 166	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_CAPS, 0, &data);
 167	if (ret)
 168		goto out;
 169
 170	if (data & SDIO_CCCR_CAP_SMB)
 171		card->cccr.multi_block = 1;
 172	if (data & SDIO_CCCR_CAP_LSC)
 173		card->cccr.low_speed = 1;
 174	if (data & SDIO_CCCR_CAP_4BLS)
 175		card->cccr.wide_bus = 1;
 176
 177	if (cccr_vsn >= SDIO_CCCR_REV_1_10) {
 178		ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_POWER, 0, &data);
 179		if (ret)
 180			goto out;
 181
 182		if (data & SDIO_POWER_SMPC)
 183			card->cccr.high_power = 1;
 184	}
 185
 186	if (cccr_vsn >= SDIO_CCCR_REV_1_20) {
 187		ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 188		if (ret)
 189			goto out;
 190
 191		card->scr.sda_spec3 = 0;
 192		card->sw_caps.sd3_bus_mode = 0;
 193		card->sw_caps.sd3_drv_type = 0;
 194		if (cccr_vsn >= SDIO_CCCR_REV_3_00 && uhs) {
 195			card->scr.sda_spec3 = 1;
 196			ret = mmc_io_rw_direct(card, 0, 0,
 197				SDIO_CCCR_UHS, 0, &data);
 198			if (ret)
 199				goto out;
 200
 201			if (mmc_host_uhs(card->host)) {
 202				if (data & SDIO_UHS_DDR50)
 203					card->sw_caps.sd3_bus_mode
 204						|= SD_MODE_UHS_DDR50 | SD_MODE_UHS_SDR50
 205							| SD_MODE_UHS_SDR25 | SD_MODE_UHS_SDR12;
 206
 207				if (data & SDIO_UHS_SDR50)
 208					card->sw_caps.sd3_bus_mode
 209						|= SD_MODE_UHS_SDR50 | SD_MODE_UHS_SDR25
 210							| SD_MODE_UHS_SDR12;
 211
 212				if (data & SDIO_UHS_SDR104)
 213					card->sw_caps.sd3_bus_mode
 214						|= SD_MODE_UHS_SDR104 | SD_MODE_UHS_SDR50
 215							| SD_MODE_UHS_SDR25 | SD_MODE_UHS_SDR12;
 216			}
 217
 218			ret = mmc_io_rw_direct(card, 0, 0,
 219				SDIO_CCCR_DRIVE_STRENGTH, 0, &data);
 220			if (ret)
 221				goto out;
 222
 223			if (data & SDIO_DRIVE_SDTA)
 224				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_A;
 225			if (data & SDIO_DRIVE_SDTC)
 226				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_C;
 227			if (data & SDIO_DRIVE_SDTD)
 228				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_D;
 229
 230			ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_INTERRUPT_EXT, 0, &data);
 231			if (ret)
 232				goto out;
 233
 234			if (data & SDIO_INTERRUPT_EXT_SAI) {
 235				data |= SDIO_INTERRUPT_EXT_EAI;
 236				ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_INTERRUPT_EXT,
 237						       data, NULL);
 238				if (ret)
 239					goto out;
 240
 241				card->cccr.enable_async_irq = 1;
 242			}
 243		}
 244
 245		/* if no uhs mode ensure we check for high speed */
 246		if (!card->sw_caps.sd3_bus_mode) {
 247			if (speed & SDIO_SPEED_SHS) {
 248				card->cccr.high_speed = 1;
 249				card->sw_caps.hs_max_dtr = 50000000;
 250			} else {
 251				card->cccr.high_speed = 0;
 252				card->sw_caps.hs_max_dtr = 25000000;
 253			}
 254		}
 255	}
 256
 257out:
 258	return ret;
 259}
 260
 261static int sdio_enable_wide(struct mmc_card *card)
 262{
 263	int ret;
 264	u8 ctrl;
 265
 266	if (!(card->host->caps & MMC_CAP_4_BIT_DATA))
 267		return 0;
 268
 269	if (card->cccr.low_speed && !card->cccr.wide_bus)
 270		return 0;
 271
 272	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 273	if (ret)
 274		return ret;
 275
 276	if ((ctrl & SDIO_BUS_WIDTH_MASK) == SDIO_BUS_WIDTH_RESERVED)
 277		pr_warn("%s: SDIO_CCCR_IF is invalid: 0x%02x\n",
 278			mmc_hostname(card->host), ctrl);
 279
 280	/* set as 4-bit bus width */
 281	ctrl &= ~SDIO_BUS_WIDTH_MASK;
 282	ctrl |= SDIO_BUS_WIDTH_4BIT;
 283
 284	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 285	if (ret)
 286		return ret;
 287
 288	return 1;
 289}
 290
 291/*
 292 * If desired, disconnect the pull-up resistor on CD/DAT[3] (pin 1)
 293 * of the card. This may be required on certain setups of boards,
 294 * controllers and embedded sdio device which do not need the card's
 295 * pull-up. As a result, card detection is disabled and power is saved.
 296 */
 297static int sdio_disable_cd(struct mmc_card *card)
 298{
 299	int ret;
 300	u8 ctrl;
 301
 302	if (!mmc_card_disable_cd(card))
 303		return 0;
 304
 305	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 306	if (ret)
 307		return ret;
 308
 309	ctrl |= SDIO_BUS_CD_DISABLE;
 310
 311	return mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 312}
 313
 314/*
 315 * Devices that remain active during a system suspend are
 316 * put back into 1-bit mode.
 317 */
 318static int sdio_disable_wide(struct mmc_card *card)
 319{
 320	int ret;
 321	u8 ctrl;
 322
 323	if (!(card->host->caps & MMC_CAP_4_BIT_DATA))
 324		return 0;
 325
 326	if (card->cccr.low_speed && !card->cccr.wide_bus)
 327		return 0;
 328
 329	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 330	if (ret)
 331		return ret;
 332
 333	if (!(ctrl & SDIO_BUS_WIDTH_4BIT))
 334		return 0;
 335
 336	ctrl &= ~SDIO_BUS_WIDTH_4BIT;
 337	ctrl |= SDIO_BUS_ASYNC_INT;
 338
 339	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 340	if (ret)
 341		return ret;
 342
 343	mmc_set_bus_width(card->host, MMC_BUS_WIDTH_1);
 344
 345	return 0;
 346}
 347
 348static int sdio_disable_4bit_bus(struct mmc_card *card)
 349{
 350	int err;
 351
 352	if (mmc_card_sdio(card))
 353		goto out;
 354
 355	if (!(card->host->caps & MMC_CAP_4_BIT_DATA))
 356		return 0;
 357
 358	if (!(card->scr.bus_widths & SD_SCR_BUS_WIDTH_4))
 359		return 0;
 360
 361	err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_1);
 362	if (err)
 363		return err;
 364
 365out:
 366	return sdio_disable_wide(card);
 367}
 368
 369
 370static int sdio_enable_4bit_bus(struct mmc_card *card)
 371{
 372	int err;
 373
 374	err = sdio_enable_wide(card);
 375	if (err <= 0)
 376		return err;
 377	if (mmc_card_sdio(card))
 378		goto out;
 379
 380	if (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4) {
 381		err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4);
 382		if (err) {
 383			sdio_disable_wide(card);
 384			return err;
 385		}
 
 
 
 
 
 
 
 
 386	}
 387out:
 388	mmc_set_bus_width(card->host, MMC_BUS_WIDTH_4);
 389
 390	return 0;
 391}
 392
 393
 394/*
 395 * Test if the card supports high-speed mode and, if so, switch to it.
 396 */
 397static int mmc_sdio_switch_hs(struct mmc_card *card, int enable)
 398{
 399	int ret;
 400	u8 speed;
 401
 402	if (!(card->host->caps & MMC_CAP_SD_HIGHSPEED))
 403		return 0;
 404
 405	if (!card->cccr.high_speed)
 406		return 0;
 407
 408	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 409	if (ret)
 410		return ret;
 411
 412	if (enable)
 413		speed |= SDIO_SPEED_EHS;
 414	else
 415		speed &= ~SDIO_SPEED_EHS;
 416
 417	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_SPEED, speed, NULL);
 418	if (ret)
 419		return ret;
 420
 421	return 1;
 422}
 423
 424/*
 425 * Enable SDIO/combo card's high-speed mode. Return 0/1 if [not]supported.
 426 */
 427static int sdio_enable_hs(struct mmc_card *card)
 428{
 429	int ret;
 430
 431	ret = mmc_sdio_switch_hs(card, true);
 432	if (ret <= 0 || mmc_card_sdio(card))
 433		return ret;
 434
 435	ret = mmc_sd_switch_hs(card);
 436	if (ret <= 0)
 437		mmc_sdio_switch_hs(card, false);
 438
 439	return ret;
 440}
 441
 442static unsigned mmc_sdio_get_max_clock(struct mmc_card *card)
 443{
 444	unsigned max_dtr;
 445
 446	if (mmc_card_hs(card)) {
 447		/*
 448		 * The SDIO specification doesn't mention how
 449		 * the CIS transfer speed register relates to
 450		 * high-speed, but it seems that 50 MHz is
 451		 * mandatory.
 452		 */
 453		max_dtr = 50000000;
 454	} else {
 455		max_dtr = card->cis.max_dtr;
 456	}
 457
 458	if (mmc_card_sd_combo(card))
 459		max_dtr = min(max_dtr, mmc_sd_get_max_clock(card));
 460
 461	return max_dtr;
 462}
 463
 464static unsigned char host_drive_to_sdio_drive(int host_strength)
 465{
 466	switch (host_strength) {
 467	case MMC_SET_DRIVER_TYPE_A:
 468		return SDIO_DTSx_SET_TYPE_A;
 469	case MMC_SET_DRIVER_TYPE_B:
 470		return SDIO_DTSx_SET_TYPE_B;
 471	case MMC_SET_DRIVER_TYPE_C:
 472		return SDIO_DTSx_SET_TYPE_C;
 473	case MMC_SET_DRIVER_TYPE_D:
 474		return SDIO_DTSx_SET_TYPE_D;
 475	default:
 476		return SDIO_DTSx_SET_TYPE_B;
 477	}
 478}
 479
 480static void sdio_select_driver_type(struct mmc_card *card)
 481{
 482	int card_drv_type, drive_strength, drv_type;
 483	unsigned char card_strength;
 484	int err;
 485
 486	card->drive_strength = 0;
 487
 488	card_drv_type = card->sw_caps.sd3_drv_type | SD_DRIVER_TYPE_B;
 489
 490	drive_strength = mmc_select_drive_strength(card,
 491						   card->sw_caps.uhs_max_dtr,
 492						   card_drv_type, &drv_type);
 493
 494	if (drive_strength) {
 495		/* if error just use default for drive strength B */
 496		err = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_DRIVE_STRENGTH, 0,
 497				       &card_strength);
 498		if (err)
 499			return;
 500
 501		card_strength &= ~(SDIO_DRIVE_DTSx_MASK<<SDIO_DRIVE_DTSx_SHIFT);
 502		card_strength |= host_drive_to_sdio_drive(drive_strength);
 503
 504		/* if error default to drive strength B */
 505		err = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_DRIVE_STRENGTH,
 506				       card_strength, NULL);
 507		if (err)
 508			return;
 509		card->drive_strength = drive_strength;
 510	}
 511
 512	if (drv_type)
 513		mmc_set_driver_type(card->host, drv_type);
 514}
 515
 516
 517static int sdio_set_bus_speed_mode(struct mmc_card *card)
 518{
 519	unsigned int bus_speed, timing;
 520	int err;
 521	unsigned char speed;
 522	unsigned int max_rate;
 523
 524	/*
 525	 * If the host doesn't support any of the UHS-I modes, fallback on
 526	 * default speed.
 527	 */
 528	if (!mmc_host_uhs(card->host))
 529		return 0;
 530
 531	bus_speed = SDIO_SPEED_SDR12;
 532	timing = MMC_TIMING_UHS_SDR12;
 533	if ((card->host->caps & MMC_CAP_UHS_SDR104) &&
 534	    (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR104)) {
 535			bus_speed = SDIO_SPEED_SDR104;
 536			timing = MMC_TIMING_UHS_SDR104;
 537			card->sw_caps.uhs_max_dtr = UHS_SDR104_MAX_DTR;
 538			card->sd_bus_speed = UHS_SDR104_BUS_SPEED;
 539	} else if ((card->host->caps & MMC_CAP_UHS_DDR50) &&
 540		   (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_DDR50)) {
 541			bus_speed = SDIO_SPEED_DDR50;
 542			timing = MMC_TIMING_UHS_DDR50;
 543			card->sw_caps.uhs_max_dtr = UHS_DDR50_MAX_DTR;
 544			card->sd_bus_speed = UHS_DDR50_BUS_SPEED;
 545	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 546		    MMC_CAP_UHS_SDR50)) && (card->sw_caps.sd3_bus_mode &
 547		    SD_MODE_UHS_SDR50)) {
 548			bus_speed = SDIO_SPEED_SDR50;
 549			timing = MMC_TIMING_UHS_SDR50;
 550			card->sw_caps.uhs_max_dtr = UHS_SDR50_MAX_DTR;
 551			card->sd_bus_speed = UHS_SDR50_BUS_SPEED;
 552	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 553		    MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25)) &&
 554		   (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR25)) {
 555			bus_speed = SDIO_SPEED_SDR25;
 556			timing = MMC_TIMING_UHS_SDR25;
 557			card->sw_caps.uhs_max_dtr = UHS_SDR25_MAX_DTR;
 558			card->sd_bus_speed = UHS_SDR25_BUS_SPEED;
 559	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 560		    MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25 |
 561		    MMC_CAP_UHS_SDR12)) && (card->sw_caps.sd3_bus_mode &
 562		    SD_MODE_UHS_SDR12)) {
 563			bus_speed = SDIO_SPEED_SDR12;
 564			timing = MMC_TIMING_UHS_SDR12;
 565			card->sw_caps.uhs_max_dtr = UHS_SDR12_MAX_DTR;
 566			card->sd_bus_speed = UHS_SDR12_BUS_SPEED;
 567	}
 568
 569	err = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 570	if (err)
 571		return err;
 572
 573	speed &= ~SDIO_SPEED_BSS_MASK;
 574	speed |= bus_speed;
 575	err = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_SPEED, speed, NULL);
 576	if (err)
 577		return err;
 578
 579	max_rate = min_not_zero(card->quirk_max_rate,
 580				card->sw_caps.uhs_max_dtr);
 581
 582	mmc_set_timing(card->host, timing);
 583	mmc_set_clock(card->host, max_rate);
 584
 585	return 0;
 586}
 587
 588/*
 589 * UHS-I specific initialization procedure
 590 */
 591static int mmc_sdio_init_uhs_card(struct mmc_card *card)
 592{
 593	int err;
 594
 595	if (!card->scr.sda_spec3)
 596		return 0;
 597
 598	/* Switch to wider bus */
 599	err = sdio_enable_4bit_bus(card);
 600	if (err)
 601		goto out;
 602
 603	/* Set the driver strength for the card */
 604	sdio_select_driver_type(card);
 605
 606	/* Set bus speed mode of the card */
 607	err = sdio_set_bus_speed_mode(card);
 608	if (err)
 609		goto out;
 610
 611	/*
 612	 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and
 613	 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104.
 614	 */
 615	if (!mmc_host_is_spi(card->host) &&
 616	    ((card->host->ios.timing == MMC_TIMING_UHS_SDR50) ||
 617	      (card->host->ios.timing == MMC_TIMING_UHS_SDR104)))
 618		err = mmc_execute_tuning(card);
 619out:
 620	return err;
 621}
 622
 623static int mmc_sdio_pre_init(struct mmc_host *host, u32 ocr,
 624			     struct mmc_card *card)
 625{
 626	if (card)
 627		mmc_remove_card(card);
 628
 629	/*
 630	 * Reset the card by performing the same steps that are taken by
 631	 * mmc_rescan_try_freq() and mmc_attach_sdio() during a "normal" probe.
 632	 *
 633	 * sdio_reset() is technically not needed. Having just powered up the
 634	 * hardware, it should already be in reset state. However, some
 635	 * platforms (such as SD8686 on OLPC) do not instantly cut power,
 636	 * meaning that a reset is required when restoring power soon after
 637	 * powering off. It is harmless in other cases.
 638	 *
 639	 * The CMD5 reset (mmc_send_io_op_cond()), according to the SDIO spec,
 640	 * is not necessary for non-removable cards. However, it is required
 641	 * for OLPC SD8686 (which expects a [CMD5,5,3,7] init sequence), and
 642	 * harmless in other situations.
 643	 *
 644	 */
 645
 646	sdio_reset(host);
 647	mmc_go_idle(host);
 648	mmc_send_if_cond(host, ocr);
 649	return mmc_send_io_op_cond(host, 0, NULL);
 650}
 651
 652/*
 653 * Handle the detection and initialisation of a card.
 654 *
 655 * In the case of a resume, "oldcard" will contain the card
 656 * we're trying to reinitialise.
 657 */
 658static int mmc_sdio_init_card(struct mmc_host *host, u32 ocr,
 659			      struct mmc_card *oldcard)
 660{
 661	struct mmc_card *card;
 662	int err;
 663	int retries = 10;
 664	u32 rocr = 0;
 665	u32 ocr_card = ocr;
 666
 667	WARN_ON(!host->claimed);
 668
 669	/* to query card if 1.8V signalling is supported */
 670	if (mmc_host_uhs(host))
 671		ocr |= R4_18V_PRESENT;
 672
 673try_again:
 674	if (!retries) {
 675		pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host));
 676		ocr &= ~R4_18V_PRESENT;
 677	}
 678
 679	/*
 680	 * Inform the card of the voltage
 681	 */
 682	err = mmc_send_io_op_cond(host, ocr, &rocr);
 683	if (err)
 684		return err;
 
 
 685
 686	/*
 687	 * For SPI, enable CRC as appropriate.
 688	 */
 689	if (mmc_host_is_spi(host)) {
 690		err = mmc_spi_set_crc(host, use_spi_crc);
 691		if (err)
 692			return err;
 693	}
 694
 695	/*
 696	 * Allocate card structure.
 697	 */
 698	card = mmc_alloc_card(host, &sdio_type);
 699	if (IS_ERR(card))
 700		return PTR_ERR(card);
 
 
 701
 702	if ((rocr & R4_MEMORY_PRESENT) &&
 703	    mmc_sd_get_cid(host, ocr & rocr, card->raw_cid, NULL) == 0) {
 704		card->type = MMC_TYPE_SD_COMBO;
 705
 706		if (oldcard && (!mmc_card_sd_combo(oldcard) ||
 707		    memcmp(card->raw_cid, oldcard->raw_cid, sizeof(card->raw_cid)) != 0)) {
 708			err = -ENOENT;
 709			goto mismatch;
 710		}
 711	} else {
 712		card->type = MMC_TYPE_SDIO;
 713
 714		if (oldcard && !mmc_card_sdio(oldcard)) {
 715			err = -ENOENT;
 716			goto mismatch;
 717		}
 718	}
 719
 720	/*
 721	 * Call the optional HC's init_card function to handle quirks.
 722	 */
 723	if (host->ops->init_card)
 724		host->ops->init_card(host, card);
 725	mmc_fixup_device(card, sdio_card_init_methods);
 726
 727	card->ocr = ocr_card;
 728
 729	/*
 730	 * If the host and card support UHS-I mode request the card
 731	 * to switch to 1.8V signaling level.  No 1.8v signalling if
 732	 * UHS mode is not enabled to maintain compatibility and some
 733	 * systems that claim 1.8v signalling in fact do not support
 734	 * it. Per SDIO spec v3, section 3.1.2, if the voltage is already
 735	 * 1.8v, the card sets S18A to 0 in the R4 response. So it will
 736	 * fails to check rocr & R4_18V_PRESENT,  but we still need to
 737	 * try to init uhs card. sdio_read_cccr will take over this task
 738	 * to make sure which speed mode should work.
 739	 */
 740	if (rocr & ocr & R4_18V_PRESENT) {
 741		err = mmc_set_uhs_voltage(host, ocr_card);
 742		if (err == -EAGAIN) {
 743			mmc_sdio_pre_init(host, ocr_card, card);
 744			retries--;
 745			goto try_again;
 746		} else if (err) {
 747			ocr &= ~R4_18V_PRESENT;
 748		}
 749	}
 750
 751	/*
 752	 * For native busses:  set card RCA and quit open drain mode.
 753	 */
 754	if (!mmc_host_is_spi(host)) {
 755		err = mmc_send_relative_addr(host, &card->rca);
 756		if (err)
 757			goto remove;
 758
 759		/*
 760		 * Update oldcard with the new RCA received from the SDIO
 761		 * device -- we're doing this so that it's updated in the
 762		 * "card" struct when oldcard overwrites that later.
 763		 */
 764		if (oldcard)
 765			oldcard->rca = card->rca;
 766	}
 767
 768	/*
 769	 * Read CSD, before selecting the card
 770	 */
 771	if (!oldcard && mmc_card_sd_combo(card)) {
 772		err = mmc_sd_get_csd(card);
 773		if (err)
 774			goto remove;
 775
 776		mmc_decode_cid(card);
 777	}
 778
 779	/*
 780	 * Select card, as all following commands rely on that.
 781	 */
 782	if (!mmc_host_is_spi(host)) {
 783		err = mmc_select_card(card);
 784		if (err)
 785			goto remove;
 786	}
 787
 788	if (card->quirks & MMC_QUIRK_NONSTD_SDIO) {
 789		/*
 790		 * This is non-standard SDIO device, meaning it doesn't
 791		 * have any CIA (Common I/O area) registers present.
 792		 * It's host's responsibility to fill cccr and cis
 793		 * structures in init_card().
 794		 */
 795		mmc_set_clock(host, card->cis.max_dtr);
 796
 797		if (card->cccr.high_speed) {
 798			mmc_set_timing(card->host, MMC_TIMING_SD_HS);
 799		}
 800
 801		if (oldcard)
 802			mmc_remove_card(card);
 803		else
 804			host->card = card;
 805
 806		return 0;
 807	}
 808
 809	/*
 810	 * Read the common registers. Note that we should try to
 811	 * validate whether UHS would work or not.
 812	 */
 813	err = sdio_read_cccr(card, ocr);
 814	if (err) {
 815		mmc_sdio_pre_init(host, ocr_card, card);
 816		if (ocr & R4_18V_PRESENT) {
 817			/* Retry init sequence, but without R4_18V_PRESENT. */
 818			retries = 0;
 819			goto try_again;
 
 
 820		}
 821		return err;
 822	}
 823
 824	/*
 825	 * Read the common CIS tuples.
 826	 */
 827	err = sdio_read_common_cis(card);
 828	if (err)
 829		goto remove;
 830
 831	if (oldcard) {
 832		if (card->cis.vendor == oldcard->cis.vendor &&
 833		    card->cis.device == oldcard->cis.device) {
 834			mmc_remove_card(card);
 835			card = oldcard;
 836		} else {
 837			err = -ENOENT;
 838			goto mismatch;
 839		}
 840	}
 841
 
 
 
 842	mmc_fixup_device(card, sdio_fixup_methods);
 843
 844	if (mmc_card_sd_combo(card)) {
 845		err = mmc_sd_setup_card(host, card, oldcard != NULL);
 846		/* handle as SDIO-only card if memory init failed */
 847		if (err) {
 848			mmc_go_idle(host);
 849			if (mmc_host_is_spi(host))
 850				/* should not fail, as it worked previously */
 851				mmc_spi_set_crc(host, use_spi_crc);
 852			card->type = MMC_TYPE_SDIO;
 853		} else
 854			card->dev.type = &sd_type;
 855	}
 856
 857	/*
 858	 * If needed, disconnect card detection pull-up resistor.
 859	 */
 860	err = sdio_disable_cd(card);
 861	if (err)
 862		goto remove;
 863
 864	/* Initialization sequence for UHS-I cards */
 865	/* Only if card supports 1.8v and UHS signaling */
 866	if ((ocr & R4_18V_PRESENT) && card->sw_caps.sd3_bus_mode) {
 867		err = mmc_sdio_init_uhs_card(card);
 868		if (err)
 869			goto remove;
 870	} else {
 871		/*
 872		 * Switch to high-speed (if supported).
 873		 */
 874		err = sdio_enable_hs(card);
 875		if (err > 0)
 876			mmc_set_timing(card->host, MMC_TIMING_SD_HS);
 877		else if (err)
 878			goto remove;
 879
 880		/*
 881		 * Change to the card's maximum speed.
 882		 */
 883		mmc_set_clock(host, mmc_sdio_get_max_clock(card));
 884
 885		/*
 886		 * Switch to wider bus (if supported).
 887		 */
 888		err = sdio_enable_4bit_bus(card);
 889		if (err)
 890			goto remove;
 891	}
 892
 893	if (host->caps2 & MMC_CAP2_AVOID_3_3V &&
 894	    host->ios.signal_voltage == MMC_SIGNAL_VOLTAGE_330) {
 895		pr_err("%s: Host failed to negotiate down from 3.3V\n",
 896			mmc_hostname(host));
 897		err = -EINVAL;
 898		goto remove;
 899	}
 900
 901	host->card = card;
 902	return 0;
 903
 904mismatch:
 905	pr_debug("%s: Perhaps the card was replaced\n", mmc_hostname(host));
 906remove:
 907	if (oldcard != card)
 908		mmc_remove_card(card);
 909	return err;
 910}
 911
 912static int mmc_sdio_reinit_card(struct mmc_host *host)
 913{
 914	int ret;
 915
 916	ret = mmc_sdio_pre_init(host, host->card->ocr, NULL);
 917	if (ret)
 918		return ret;
 919
 920	return mmc_sdio_init_card(host, host->card->ocr, host->card);
 921}
 922
 923/*
 924 * Host is being removed. Free up the current card.
 925 */
 926static void mmc_sdio_remove(struct mmc_host *host)
 927{
 928	int i;
 929
 930	for (i = 0;i < host->card->sdio_funcs;i++) {
 931		if (host->card->sdio_func[i]) {
 932			sdio_remove_func(host->card->sdio_func[i]);
 933			host->card->sdio_func[i] = NULL;
 934		}
 935	}
 936
 937	mmc_remove_card(host->card);
 938	host->card = NULL;
 939}
 940
 941/*
 942 * Card detection - card is alive.
 943 */
 944static int mmc_sdio_alive(struct mmc_host *host)
 945{
 946	return mmc_select_card(host->card);
 947}
 948
 949/*
 950 * Card detection callback from host.
 951 */
 952static void mmc_sdio_detect(struct mmc_host *host)
 953{
 954	int err;
 955
 956	/* Make sure card is powered before detecting it */
 957	if (host->caps & MMC_CAP_POWER_OFF_CARD) {
 958		err = pm_runtime_resume_and_get(&host->card->dev);
 959		if (err < 0)
 
 960			goto out;
 
 961	}
 962
 963	mmc_claim_host(host);
 964
 965	/*
 966	 * Just check if our card has been removed.
 967	 */
 968	err = _mmc_detect_card_removed(host);
 969
 970	mmc_release_host(host);
 971
 972	/*
 973	 * Tell PM core it's OK to power off the card now.
 974	 *
 975	 * The _sync variant is used in order to ensure that the card
 976	 * is left powered off in case an error occurred, and the card
 977	 * is going to be removed.
 978	 *
 979	 * Since there is no specific reason to believe a new user
 980	 * is about to show up at this point, the _sync variant is
 981	 * desirable anyway.
 982	 */
 983	if (host->caps & MMC_CAP_POWER_OFF_CARD)
 984		pm_runtime_put_sync(&host->card->dev);
 985
 986out:
 987	if (err) {
 988		mmc_sdio_remove(host);
 989
 990		mmc_claim_host(host);
 991		mmc_detach_bus(host);
 992		mmc_power_off(host);
 993		mmc_release_host(host);
 994	}
 995}
 996
 997/*
 998 * SDIO pre_suspend.  We need to suspend all functions separately.
 999 * Therefore all registered functions must have drivers with suspend
1000 * and resume methods.  Failing that we simply remove the whole card.
1001 */
1002static int mmc_sdio_pre_suspend(struct mmc_host *host)
1003{
1004	int i;
1005
1006	for (i = 0; i < host->card->sdio_funcs; i++) {
1007		struct sdio_func *func = host->card->sdio_func[i];
1008		if (func && sdio_func_present(func) && func->dev.driver) {
1009			const struct dev_pm_ops *pmops = func->dev.driver->pm;
1010			if (!pmops || !pmops->suspend || !pmops->resume)
1011				/* force removal of entire card in that case */
1012				goto remove;
 
 
1013		}
1014	}
1015
1016	return 0;
1017
1018remove:
1019	if (!mmc_card_is_removable(host)) {
1020		dev_warn(mmc_dev(host),
1021			 "missing suspend/resume ops for non-removable SDIO card\n");
1022		/* Don't remove a non-removable card - we can't re-detect it. */
1023		return 0;
1024	}
1025
1026	/* Remove the SDIO card and let it be re-detected later on. */
1027	mmc_sdio_remove(host);
1028	mmc_claim_host(host);
1029	mmc_detach_bus(host);
1030	mmc_power_off(host);
1031	mmc_release_host(host);
1032	host->pm_flags = 0;
1033
1034	return 0;
1035}
1036
1037/*
1038 * SDIO suspend.  Suspend all functions separately.
1039 */
1040static int mmc_sdio_suspend(struct mmc_host *host)
1041{
1042	WARN_ON(host->sdio_irqs && !mmc_card_keep_power(host));
1043
1044	/* Prevent processing of SDIO IRQs in suspended state. */
1045	mmc_card_set_suspended(host->card);
1046	cancel_work_sync(&host->sdio_irq_work);
1047
1048	mmc_claim_host(host);
1049
1050	if (mmc_card_keep_power(host) && mmc_card_wake_sdio_irq(host))
1051		sdio_disable_4bit_bus(host->card);
1052
1053	if (!mmc_card_keep_power(host)) {
1054		mmc_power_off(host);
1055	} else if (host->retune_period) {
1056		mmc_retune_timer_stop(host);
1057		mmc_retune_needed(host);
1058	}
1059
1060	mmc_release_host(host);
1061
1062	return 0;
1063}
1064
1065static int mmc_sdio_resume(struct mmc_host *host)
1066{
1067	int err = 0;
1068
1069	/* Basic card reinitialization. */
1070	mmc_claim_host(host);
1071
1072	/*
1073	 * Restore power and reinitialize the card when needed. Note that a
1074	 * removable card is checked from a detect work later on in the resume
1075	 * process.
1076	 */
1077	if (!mmc_card_keep_power(host)) {
1078		mmc_power_up(host, host->card->ocr);
1079		/*
1080		 * Tell runtime PM core we just powered up the card,
1081		 * since it still believes the card is powered off.
1082		 * Note that currently runtime PM is only enabled
1083		 * for SDIO cards that are MMC_CAP_POWER_OFF_CARD
1084		 */
1085		if (host->caps & MMC_CAP_POWER_OFF_CARD) {
1086			pm_runtime_disable(&host->card->dev);
1087			pm_runtime_set_active(&host->card->dev);
1088			pm_runtime_enable(&host->card->dev);
1089		}
1090		err = mmc_sdio_reinit_card(host);
1091	} else if (mmc_card_wake_sdio_irq(host)) {
1092		/*
1093		 * We may have switched to 1-bit mode during suspend,
1094		 * need to hold retuning, because tuning only supprt
1095		 * 4-bit mode or 8 bit mode.
1096		 */
1097		mmc_retune_hold_now(host);
1098		err = sdio_enable_4bit_bus(host->card);
1099		mmc_retune_release(host);
1100	}
1101
1102	if (err)
1103		goto out;
1104
1105	/* Allow SDIO IRQs to be processed again. */
1106	mmc_card_clr_suspended(host->card);
 
 
 
 
 
 
 
 
 
1107
1108	if (host->sdio_irqs) {
1109		if (!(host->caps2 & MMC_CAP2_SDIO_IRQ_NOTHREAD))
1110			wake_up_process(host->sdio_irq_thread);
1111		else if (host->caps & MMC_CAP_SDIO_IRQ)
1112			schedule_work(&host->sdio_irq_work);
1113	}
1114
1115out:
1116	mmc_release_host(host);
1117
1118	host->pm_flags &= ~MMC_PM_KEEP_POWER;
1119	return err;
1120}
1121
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1122static int mmc_sdio_runtime_suspend(struct mmc_host *host)
1123{
1124	/* No references to the card, cut the power to it. */
1125	mmc_claim_host(host);
1126	mmc_power_off(host);
1127	mmc_release_host(host);
1128
1129	return 0;
1130}
1131
1132static int mmc_sdio_runtime_resume(struct mmc_host *host)
1133{
1134	int ret;
1135
1136	/* Restore power and re-initialize. */
1137	mmc_claim_host(host);
1138	mmc_power_up(host, host->card->ocr);
1139	ret = mmc_sdio_reinit_card(host);
1140	mmc_release_host(host);
1141
1142	return ret;
1143}
1144
1145/*
1146 * SDIO HW reset
1147 *
1148 * Returns 0 if the HW reset was executed synchronously, returns 1 if the HW
1149 * reset was asynchronously scheduled, else a negative error code.
1150 */
1151static int mmc_sdio_hw_reset(struct mmc_host *host)
1152{
1153	struct mmc_card *card = host->card;
1154
1155	/*
1156	 * In case the card is shared among multiple func drivers, reset the
1157	 * card through a rescan work. In this way it will be removed and
1158	 * re-detected, thus all func drivers becomes informed about it.
1159	 */
1160	if (atomic_read(&card->sdio_funcs_probed) > 1) {
1161		if (mmc_card_removed(card))
1162			return 1;
1163		host->rescan_entered = 0;
1164		mmc_card_set_removed(card);
1165		_mmc_detect_change(host, 0, false);
1166		return 1;
1167	}
1168
1169	/*
1170	 * A single func driver has been probed, then let's skip the heavy
1171	 * hotplug dance above and execute the reset immediately.
1172	 */
1173	mmc_power_cycle(host, card->ocr);
1174	return mmc_sdio_reinit_card(host);
1175}
1176
1177static int mmc_sdio_sw_reset(struct mmc_host *host)
1178{
1179	mmc_set_clock(host, host->f_init);
1180	sdio_reset(host);
1181	mmc_go_idle(host);
1182
1183	mmc_set_initial_state(host);
1184	mmc_set_initial_signal_voltage(host);
1185
1186	return mmc_sdio_reinit_card(host);
1187}
1188
1189static const struct mmc_bus_ops mmc_sdio_ops = {
1190	.remove = mmc_sdio_remove,
1191	.detect = mmc_sdio_detect,
1192	.pre_suspend = mmc_sdio_pre_suspend,
1193	.suspend = mmc_sdio_suspend,
1194	.resume = mmc_sdio_resume,
1195	.runtime_suspend = mmc_sdio_runtime_suspend,
1196	.runtime_resume = mmc_sdio_runtime_resume,
 
1197	.alive = mmc_sdio_alive,
1198	.hw_reset = mmc_sdio_hw_reset,
1199	.sw_reset = mmc_sdio_sw_reset,
1200};
1201
1202
1203/*
1204 * Starting point for SDIO card init.
1205 */
1206int mmc_attach_sdio(struct mmc_host *host)
1207{
1208	int err, i, funcs;
1209	u32 ocr, rocr;
1210	struct mmc_card *card;
1211
1212	WARN_ON(!host->claimed);
1213
1214	err = mmc_send_io_op_cond(host, 0, &ocr);
1215	if (err)
1216		return err;
1217
1218	mmc_attach_bus(host, &mmc_sdio_ops);
1219	if (host->ocr_avail_sdio)
1220		host->ocr_avail = host->ocr_avail_sdio;
1221
1222
1223	rocr = mmc_select_voltage(host, ocr);
1224
1225	/*
1226	 * Can we support the voltage(s) of the card(s)?
1227	 */
1228	if (!rocr) {
1229		err = -EINVAL;
1230		goto err;
1231	}
1232
1233	/*
1234	 * Detect and init the card.
1235	 */
1236	err = mmc_sdio_init_card(host, rocr, NULL);
1237	if (err)
1238		goto err;
1239
1240	card = host->card;
1241
1242	/*
1243	 * Enable runtime PM only if supported by host+card+board
1244	 */
1245	if (host->caps & MMC_CAP_POWER_OFF_CARD) {
1246		/*
1247		 * Do not allow runtime suspend until after SDIO function
1248		 * devices are added.
1249		 */
1250		pm_runtime_get_noresume(&card->dev);
1251
1252		/*
1253		 * Let runtime PM core know our card is active
1254		 */
1255		err = pm_runtime_set_active(&card->dev);
1256		if (err)
1257			goto remove;
1258
1259		/*
1260		 * Enable runtime PM for this card
1261		 */
1262		pm_runtime_enable(&card->dev);
1263	}
1264
1265	/*
1266	 * The number of functions on the card is encoded inside
1267	 * the ocr.
1268	 */
1269	funcs = (ocr & 0x70000000) >> 28;
1270	card->sdio_funcs = 0;
1271
1272	/*
1273	 * Initialize (but don't add) all present functions.
1274	 */
1275	for (i = 0; i < funcs; i++, card->sdio_funcs++) {
1276		err = sdio_init_func(host->card, i + 1);
1277		if (err)
1278			goto remove;
1279
1280		/*
1281		 * Enable Runtime PM for this func (if supported)
1282		 */
1283		if (host->caps & MMC_CAP_POWER_OFF_CARD)
1284			pm_runtime_enable(&card->sdio_func[i]->dev);
1285	}
1286
1287	/*
1288	 * First add the card to the driver model...
1289	 */
1290	mmc_release_host(host);
1291	err = mmc_add_card(host->card);
1292	if (err)
1293		goto remove_added;
1294
1295	/*
1296	 * ...then the SDIO functions.
1297	 */
1298	for (i = 0;i < funcs;i++) {
1299		err = sdio_add_func(host->card->sdio_func[i]);
1300		if (err)
1301			goto remove_added;
1302	}
1303
1304	if (host->caps & MMC_CAP_POWER_OFF_CARD)
1305		pm_runtime_put(&card->dev);
1306
1307	mmc_claim_host(host);
1308	return 0;
1309
1310
1311remove:
1312	mmc_release_host(host);
1313remove_added:
1314	/*
1315	 * The devices are being deleted so it is not necessary to disable
1316	 * runtime PM. Similarly we also don't pm_runtime_put() the SDIO card
1317	 * because it needs to be active to remove any function devices that
1318	 * were probed, and after that it gets deleted.
1319	 */
1320	mmc_sdio_remove(host);
1321	mmc_claim_host(host);
1322err:
1323	mmc_detach_bus(host);
1324
1325	pr_err("%s: error %d whilst initialising SDIO card\n",
1326		mmc_hostname(host), err);
1327
1328	return err;
1329}
1330
v4.17
 
   1/*
   2 *  linux/drivers/mmc/sdio.c
   3 *
   4 *  Copyright 2006-2007 Pierre Ossman
   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 as published by
   8 * the Free Software Foundation; either version 2 of the License, or (at
   9 * your option) any later version.
  10 */
  11
  12#include <linux/err.h>
  13#include <linux/pm_runtime.h>
 
  14
  15#include <linux/mmc/host.h>
  16#include <linux/mmc/card.h>
  17#include <linux/mmc/mmc.h>
  18#include <linux/mmc/sdio.h>
  19#include <linux/mmc/sdio_func.h>
  20#include <linux/mmc/sdio_ids.h>
  21
  22#include "core.h"
  23#include "card.h"
  24#include "host.h"
  25#include "bus.h"
  26#include "quirks.h"
  27#include "sd.h"
  28#include "sdio_bus.h"
  29#include "mmc_ops.h"
  30#include "sd_ops.h"
  31#include "sdio_ops.h"
  32#include "sdio_cis.h"
  33
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  34static int sdio_read_fbr(struct sdio_func *func)
  35{
  36	int ret;
  37	unsigned char data;
  38
  39	if (mmc_card_nonstd_func_interface(func->card)) {
  40		func->class = SDIO_CLASS_NONE;
  41		return 0;
  42	}
  43
  44	ret = mmc_io_rw_direct(func->card, 0, 0,
  45		SDIO_FBR_BASE(func->num) + SDIO_FBR_STD_IF, 0, &data);
  46	if (ret)
  47		goto out;
  48
  49	data &= 0x0f;
  50
  51	if (data == 0x0f) {
  52		ret = mmc_io_rw_direct(func->card, 0, 0,
  53			SDIO_FBR_BASE(func->num) + SDIO_FBR_STD_IF_EXT, 0, &data);
  54		if (ret)
  55			goto out;
  56	}
  57
  58	func->class = data;
  59
  60out:
  61	return ret;
  62}
  63
  64static int sdio_init_func(struct mmc_card *card, unsigned int fn)
  65{
  66	int ret;
  67	struct sdio_func *func;
  68
  69	if (WARN_ON(fn > SDIO_MAX_FUNCS))
  70		return -EINVAL;
  71
  72	func = sdio_alloc_func(card);
  73	if (IS_ERR(func))
  74		return PTR_ERR(func);
  75
  76	func->num = fn;
  77
  78	if (!(card->quirks & MMC_QUIRK_NONSTD_SDIO)) {
  79		ret = sdio_read_fbr(func);
  80		if (ret)
  81			goto fail;
  82
  83		ret = sdio_read_func_cis(func);
  84		if (ret)
  85			goto fail;
  86	} else {
  87		func->vendor = func->card->cis.vendor;
  88		func->device = func->card->cis.device;
  89		func->max_blksize = func->card->cis.blksize;
  90	}
  91
  92	card->sdio_func[fn - 1] = func;
  93
  94	return 0;
  95
  96fail:
  97	/*
  98	 * It is okay to remove the function here even though we hold
  99	 * the host lock as we haven't registered the device yet.
 100	 */
 101	sdio_remove_func(func);
 102	return ret;
 103}
 104
 105static int sdio_read_cccr(struct mmc_card *card, u32 ocr)
 106{
 107	int ret;
 108	int cccr_vsn;
 109	int uhs = ocr & R4_18V_PRESENT;
 110	unsigned char data;
 111	unsigned char speed;
 112
 113	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_CCCR, 0, &data);
 114	if (ret)
 115		goto out;
 116
 117	cccr_vsn = data & 0x0f;
 118
 119	if (cccr_vsn > SDIO_CCCR_REV_3_00) {
 120		pr_err("%s: unrecognised CCCR structure version %d\n",
 121			mmc_hostname(card->host), cccr_vsn);
 122		return -EINVAL;
 123	}
 124
 125	card->cccr.sdio_vsn = (data & 0xf0) >> 4;
 126
 127	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_CAPS, 0, &data);
 128	if (ret)
 129		goto out;
 130
 131	if (data & SDIO_CCCR_CAP_SMB)
 132		card->cccr.multi_block = 1;
 133	if (data & SDIO_CCCR_CAP_LSC)
 134		card->cccr.low_speed = 1;
 135	if (data & SDIO_CCCR_CAP_4BLS)
 136		card->cccr.wide_bus = 1;
 137
 138	if (cccr_vsn >= SDIO_CCCR_REV_1_10) {
 139		ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_POWER, 0, &data);
 140		if (ret)
 141			goto out;
 142
 143		if (data & SDIO_POWER_SMPC)
 144			card->cccr.high_power = 1;
 145	}
 146
 147	if (cccr_vsn >= SDIO_CCCR_REV_1_20) {
 148		ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 149		if (ret)
 150			goto out;
 151
 152		card->scr.sda_spec3 = 0;
 153		card->sw_caps.sd3_bus_mode = 0;
 154		card->sw_caps.sd3_drv_type = 0;
 155		if (cccr_vsn >= SDIO_CCCR_REV_3_00 && uhs) {
 156			card->scr.sda_spec3 = 1;
 157			ret = mmc_io_rw_direct(card, 0, 0,
 158				SDIO_CCCR_UHS, 0, &data);
 159			if (ret)
 160				goto out;
 161
 162			if (mmc_host_uhs(card->host)) {
 163				if (data & SDIO_UHS_DDR50)
 164					card->sw_caps.sd3_bus_mode
 165						|= SD_MODE_UHS_DDR50;
 
 166
 167				if (data & SDIO_UHS_SDR50)
 168					card->sw_caps.sd3_bus_mode
 169						|= SD_MODE_UHS_SDR50;
 
 170
 171				if (data & SDIO_UHS_SDR104)
 172					card->sw_caps.sd3_bus_mode
 173						|= SD_MODE_UHS_SDR104;
 
 174			}
 175
 176			ret = mmc_io_rw_direct(card, 0, 0,
 177				SDIO_CCCR_DRIVE_STRENGTH, 0, &data);
 178			if (ret)
 179				goto out;
 180
 181			if (data & SDIO_DRIVE_SDTA)
 182				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_A;
 183			if (data & SDIO_DRIVE_SDTC)
 184				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_C;
 185			if (data & SDIO_DRIVE_SDTD)
 186				card->sw_caps.sd3_drv_type |= SD_DRIVER_TYPE_D;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 187		}
 188
 189		/* if no uhs mode ensure we check for high speed */
 190		if (!card->sw_caps.sd3_bus_mode) {
 191			if (speed & SDIO_SPEED_SHS) {
 192				card->cccr.high_speed = 1;
 193				card->sw_caps.hs_max_dtr = 50000000;
 194			} else {
 195				card->cccr.high_speed = 0;
 196				card->sw_caps.hs_max_dtr = 25000000;
 197			}
 198		}
 199	}
 200
 201out:
 202	return ret;
 203}
 204
 205static int sdio_enable_wide(struct mmc_card *card)
 206{
 207	int ret;
 208	u8 ctrl;
 209
 210	if (!(card->host->caps & MMC_CAP_4_BIT_DATA))
 211		return 0;
 212
 213	if (card->cccr.low_speed && !card->cccr.wide_bus)
 214		return 0;
 215
 216	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 217	if (ret)
 218		return ret;
 219
 220	if ((ctrl & SDIO_BUS_WIDTH_MASK) == SDIO_BUS_WIDTH_RESERVED)
 221		pr_warn("%s: SDIO_CCCR_IF is invalid: 0x%02x\n",
 222			mmc_hostname(card->host), ctrl);
 223
 224	/* set as 4-bit bus width */
 225	ctrl &= ~SDIO_BUS_WIDTH_MASK;
 226	ctrl |= SDIO_BUS_WIDTH_4BIT;
 227
 228	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 229	if (ret)
 230		return ret;
 231
 232	return 1;
 233}
 234
 235/*
 236 * If desired, disconnect the pull-up resistor on CD/DAT[3] (pin 1)
 237 * of the card. This may be required on certain setups of boards,
 238 * controllers and embedded sdio device which do not need the card's
 239 * pull-up. As a result, card detection is disabled and power is saved.
 240 */
 241static int sdio_disable_cd(struct mmc_card *card)
 242{
 243	int ret;
 244	u8 ctrl;
 245
 246	if (!mmc_card_disable_cd(card))
 247		return 0;
 248
 249	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 250	if (ret)
 251		return ret;
 252
 253	ctrl |= SDIO_BUS_CD_DISABLE;
 254
 255	return mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 256}
 257
 258/*
 259 * Devices that remain active during a system suspend are
 260 * put back into 1-bit mode.
 261 */
 262static int sdio_disable_wide(struct mmc_card *card)
 263{
 264	int ret;
 265	u8 ctrl;
 266
 267	if (!(card->host->caps & MMC_CAP_4_BIT_DATA))
 268		return 0;
 269
 270	if (card->cccr.low_speed && !card->cccr.wide_bus)
 271		return 0;
 272
 273	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_IF, 0, &ctrl);
 274	if (ret)
 275		return ret;
 276
 277	if (!(ctrl & SDIO_BUS_WIDTH_4BIT))
 278		return 0;
 279
 280	ctrl &= ~SDIO_BUS_WIDTH_4BIT;
 281	ctrl |= SDIO_BUS_ASYNC_INT;
 282
 283	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_IF, ctrl, NULL);
 284	if (ret)
 285		return ret;
 286
 287	mmc_set_bus_width(card->host, MMC_BUS_WIDTH_1);
 288
 289	return 0;
 290}
 291
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 292
 293static int sdio_enable_4bit_bus(struct mmc_card *card)
 294{
 295	int err;
 296
 297	if (card->type == MMC_TYPE_SDIO)
 298		err = sdio_enable_wide(card);
 299	else if ((card->host->caps & MMC_CAP_4_BIT_DATA) &&
 300		 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) {
 
 
 
 301		err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4);
 302		if (err)
 
 303			return err;
 304		err = sdio_enable_wide(card);
 305		if (err <= 0)
 306			mmc_app_set_bus_width(card, MMC_BUS_WIDTH_1);
 307	} else
 308		return 0;
 309
 310	if (err > 0) {
 311		mmc_set_bus_width(card->host, MMC_BUS_WIDTH_4);
 312		err = 0;
 313	}
 
 
 314
 315	return err;
 316}
 317
 318
 319/*
 320 * Test if the card supports high-speed mode and, if so, switch to it.
 321 */
 322static int mmc_sdio_switch_hs(struct mmc_card *card, int enable)
 323{
 324	int ret;
 325	u8 speed;
 326
 327	if (!(card->host->caps & MMC_CAP_SD_HIGHSPEED))
 328		return 0;
 329
 330	if (!card->cccr.high_speed)
 331		return 0;
 332
 333	ret = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 334	if (ret)
 335		return ret;
 336
 337	if (enable)
 338		speed |= SDIO_SPEED_EHS;
 339	else
 340		speed &= ~SDIO_SPEED_EHS;
 341
 342	ret = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_SPEED, speed, NULL);
 343	if (ret)
 344		return ret;
 345
 346	return 1;
 347}
 348
 349/*
 350 * Enable SDIO/combo card's high-speed mode. Return 0/1 if [not]supported.
 351 */
 352static int sdio_enable_hs(struct mmc_card *card)
 353{
 354	int ret;
 355
 356	ret = mmc_sdio_switch_hs(card, true);
 357	if (ret <= 0 || card->type == MMC_TYPE_SDIO)
 358		return ret;
 359
 360	ret = mmc_sd_switch_hs(card);
 361	if (ret <= 0)
 362		mmc_sdio_switch_hs(card, false);
 363
 364	return ret;
 365}
 366
 367static unsigned mmc_sdio_get_max_clock(struct mmc_card *card)
 368{
 369	unsigned max_dtr;
 370
 371	if (mmc_card_hs(card)) {
 372		/*
 373		 * The SDIO specification doesn't mention how
 374		 * the CIS transfer speed register relates to
 375		 * high-speed, but it seems that 50 MHz is
 376		 * mandatory.
 377		 */
 378		max_dtr = 50000000;
 379	} else {
 380		max_dtr = card->cis.max_dtr;
 381	}
 382
 383	if (card->type == MMC_TYPE_SD_COMBO)
 384		max_dtr = min(max_dtr, mmc_sd_get_max_clock(card));
 385
 386	return max_dtr;
 387}
 388
 389static unsigned char host_drive_to_sdio_drive(int host_strength)
 390{
 391	switch (host_strength) {
 392	case MMC_SET_DRIVER_TYPE_A:
 393		return SDIO_DTSx_SET_TYPE_A;
 394	case MMC_SET_DRIVER_TYPE_B:
 395		return SDIO_DTSx_SET_TYPE_B;
 396	case MMC_SET_DRIVER_TYPE_C:
 397		return SDIO_DTSx_SET_TYPE_C;
 398	case MMC_SET_DRIVER_TYPE_D:
 399		return SDIO_DTSx_SET_TYPE_D;
 400	default:
 401		return SDIO_DTSx_SET_TYPE_B;
 402	}
 403}
 404
 405static void sdio_select_driver_type(struct mmc_card *card)
 406{
 407	int card_drv_type, drive_strength, drv_type;
 408	unsigned char card_strength;
 409	int err;
 410
 411	card->drive_strength = 0;
 412
 413	card_drv_type = card->sw_caps.sd3_drv_type | SD_DRIVER_TYPE_B;
 414
 415	drive_strength = mmc_select_drive_strength(card,
 416						   card->sw_caps.uhs_max_dtr,
 417						   card_drv_type, &drv_type);
 418
 419	if (drive_strength) {
 420		/* if error just use default for drive strength B */
 421		err = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_DRIVE_STRENGTH, 0,
 422				       &card_strength);
 423		if (err)
 424			return;
 425
 426		card_strength &= ~(SDIO_DRIVE_DTSx_MASK<<SDIO_DRIVE_DTSx_SHIFT);
 427		card_strength |= host_drive_to_sdio_drive(drive_strength);
 428
 429		/* if error default to drive strength B */
 430		err = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_DRIVE_STRENGTH,
 431				       card_strength, NULL);
 432		if (err)
 433			return;
 434		card->drive_strength = drive_strength;
 435	}
 436
 437	if (drv_type)
 438		mmc_set_driver_type(card->host, drv_type);
 439}
 440
 441
 442static int sdio_set_bus_speed_mode(struct mmc_card *card)
 443{
 444	unsigned int bus_speed, timing;
 445	int err;
 446	unsigned char speed;
 
 447
 448	/*
 449	 * If the host doesn't support any of the UHS-I modes, fallback on
 450	 * default speed.
 451	 */
 452	if (!mmc_host_uhs(card->host))
 453		return 0;
 454
 455	bus_speed = SDIO_SPEED_SDR12;
 456	timing = MMC_TIMING_UHS_SDR12;
 457	if ((card->host->caps & MMC_CAP_UHS_SDR104) &&
 458	    (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR104)) {
 459			bus_speed = SDIO_SPEED_SDR104;
 460			timing = MMC_TIMING_UHS_SDR104;
 461			card->sw_caps.uhs_max_dtr = UHS_SDR104_MAX_DTR;
 462			card->sd_bus_speed = UHS_SDR104_BUS_SPEED;
 463	} else if ((card->host->caps & MMC_CAP_UHS_DDR50) &&
 464		   (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_DDR50)) {
 465			bus_speed = SDIO_SPEED_DDR50;
 466			timing = MMC_TIMING_UHS_DDR50;
 467			card->sw_caps.uhs_max_dtr = UHS_DDR50_MAX_DTR;
 468			card->sd_bus_speed = UHS_DDR50_BUS_SPEED;
 469	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 470		    MMC_CAP_UHS_SDR50)) && (card->sw_caps.sd3_bus_mode &
 471		    SD_MODE_UHS_SDR50)) {
 472			bus_speed = SDIO_SPEED_SDR50;
 473			timing = MMC_TIMING_UHS_SDR50;
 474			card->sw_caps.uhs_max_dtr = UHS_SDR50_MAX_DTR;
 475			card->sd_bus_speed = UHS_SDR50_BUS_SPEED;
 476	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 477		    MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25)) &&
 478		   (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR25)) {
 479			bus_speed = SDIO_SPEED_SDR25;
 480			timing = MMC_TIMING_UHS_SDR25;
 481			card->sw_caps.uhs_max_dtr = UHS_SDR25_MAX_DTR;
 482			card->sd_bus_speed = UHS_SDR25_BUS_SPEED;
 483	} else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
 484		    MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25 |
 485		    MMC_CAP_UHS_SDR12)) && (card->sw_caps.sd3_bus_mode &
 486		    SD_MODE_UHS_SDR12)) {
 487			bus_speed = SDIO_SPEED_SDR12;
 488			timing = MMC_TIMING_UHS_SDR12;
 489			card->sw_caps.uhs_max_dtr = UHS_SDR12_MAX_DTR;
 490			card->sd_bus_speed = UHS_SDR12_BUS_SPEED;
 491	}
 492
 493	err = mmc_io_rw_direct(card, 0, 0, SDIO_CCCR_SPEED, 0, &speed);
 494	if (err)
 495		return err;
 496
 497	speed &= ~SDIO_SPEED_BSS_MASK;
 498	speed |= bus_speed;
 499	err = mmc_io_rw_direct(card, 1, 0, SDIO_CCCR_SPEED, speed, NULL);
 500	if (err)
 501		return err;
 502
 503	if (bus_speed) {
 504		mmc_set_timing(card->host, timing);
 505		mmc_set_clock(card->host, card->sw_caps.uhs_max_dtr);
 506	}
 
 507
 508	return 0;
 509}
 510
 511/*
 512 * UHS-I specific initialization procedure
 513 */
 514static int mmc_sdio_init_uhs_card(struct mmc_card *card)
 515{
 516	int err;
 517
 518	if (!card->scr.sda_spec3)
 519		return 0;
 520
 521	/* Switch to wider bus */
 522	err = sdio_enable_4bit_bus(card);
 523	if (err)
 524		goto out;
 525
 526	/* Set the driver strength for the card */
 527	sdio_select_driver_type(card);
 528
 529	/* Set bus speed mode of the card */
 530	err = sdio_set_bus_speed_mode(card);
 531	if (err)
 532		goto out;
 533
 534	/*
 535	 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and
 536	 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104.
 537	 */
 538	if (!mmc_host_is_spi(card->host) &&
 539	    ((card->host->ios.timing == MMC_TIMING_UHS_SDR50) ||
 540	      (card->host->ios.timing == MMC_TIMING_UHS_SDR104)))
 541		err = mmc_execute_tuning(card);
 542out:
 543	return err;
 544}
 545
 546static void mmc_sdio_resend_if_cond(struct mmc_host *host,
 547				    struct mmc_card *card)
 548{
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 549	sdio_reset(host);
 550	mmc_go_idle(host);
 551	mmc_send_if_cond(host, host->ocr_avail);
 552	mmc_remove_card(card);
 553}
 554
 555/*
 556 * Handle the detection and initialisation of a card.
 557 *
 558 * In the case of a resume, "oldcard" will contain the card
 559 * we're trying to reinitialise.
 560 */
 561static int mmc_sdio_init_card(struct mmc_host *host, u32 ocr,
 562			      struct mmc_card *oldcard, int powered_resume)
 563{
 564	struct mmc_card *card;
 565	int err;
 566	int retries = 10;
 567	u32 rocr = 0;
 568	u32 ocr_card = ocr;
 569
 570	WARN_ON(!host->claimed);
 571
 572	/* to query card if 1.8V signalling is supported */
 573	if (mmc_host_uhs(host))
 574		ocr |= R4_18V_PRESENT;
 575
 576try_again:
 577	if (!retries) {
 578		pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host));
 579		ocr &= ~R4_18V_PRESENT;
 580	}
 581
 582	/*
 583	 * Inform the card of the voltage
 584	 */
 585	if (!powered_resume) {
 586		err = mmc_send_io_op_cond(host, ocr, &rocr);
 587		if (err)
 588			goto err;
 589	}
 590
 591	/*
 592	 * For SPI, enable CRC as appropriate.
 593	 */
 594	if (mmc_host_is_spi(host)) {
 595		err = mmc_spi_set_crc(host, use_spi_crc);
 596		if (err)
 597			goto err;
 598	}
 599
 600	/*
 601	 * Allocate card structure.
 602	 */
 603	card = mmc_alloc_card(host, NULL);
 604	if (IS_ERR(card)) {
 605		err = PTR_ERR(card);
 606		goto err;
 607	}
 608
 609	if ((rocr & R4_MEMORY_PRESENT) &&
 610	    mmc_sd_get_cid(host, ocr & rocr, card->raw_cid, NULL) == 0) {
 611		card->type = MMC_TYPE_SD_COMBO;
 612
 613		if (oldcard && (oldcard->type != MMC_TYPE_SD_COMBO ||
 614		    memcmp(card->raw_cid, oldcard->raw_cid, sizeof(card->raw_cid)) != 0)) {
 615			mmc_remove_card(card);
 616			return -ENOENT;
 617		}
 618	} else {
 619		card->type = MMC_TYPE_SDIO;
 620
 621		if (oldcard && oldcard->type != MMC_TYPE_SDIO) {
 622			mmc_remove_card(card);
 623			return -ENOENT;
 624		}
 625	}
 626
 627	/*
 628	 * Call the optional HC's init_card function to handle quirks.
 629	 */
 630	if (host->ops->init_card)
 631		host->ops->init_card(host, card);
 
 
 
 632
 633	/*
 634	 * If the host and card support UHS-I mode request the card
 635	 * to switch to 1.8V signaling level.  No 1.8v signalling if
 636	 * UHS mode is not enabled to maintain compatibility and some
 637	 * systems that claim 1.8v signalling in fact do not support
 638	 * it. Per SDIO spec v3, section 3.1.2, if the voltage is already
 639	 * 1.8v, the card sets S18A to 0 in the R4 response. So it will
 640	 * fails to check rocr & R4_18V_PRESENT,  but we still need to
 641	 * try to init uhs card. sdio_read_cccr will take over this task
 642	 * to make sure which speed mode should work.
 643	 */
 644	if (!powered_resume && (rocr & ocr & R4_18V_PRESENT)) {
 645		err = mmc_set_uhs_voltage(host, ocr_card);
 646		if (err == -EAGAIN) {
 647			mmc_sdio_resend_if_cond(host, card);
 648			retries--;
 649			goto try_again;
 650		} else if (err) {
 651			ocr &= ~R4_18V_PRESENT;
 652		}
 653	}
 654
 655	/*
 656	 * For native busses:  set card RCA and quit open drain mode.
 657	 */
 658	if (!powered_resume && !mmc_host_is_spi(host)) {
 659		err = mmc_send_relative_addr(host, &card->rca);
 660		if (err)
 661			goto remove;
 662
 663		/*
 664		 * Update oldcard with the new RCA received from the SDIO
 665		 * device -- we're doing this so that it's updated in the
 666		 * "card" struct when oldcard overwrites that later.
 667		 */
 668		if (oldcard)
 669			oldcard->rca = card->rca;
 670	}
 671
 672	/*
 673	 * Read CSD, before selecting the card
 674	 */
 675	if (!oldcard && card->type == MMC_TYPE_SD_COMBO) {
 676		err = mmc_sd_get_csd(host, card);
 677		if (err)
 678			return err;
 679
 680		mmc_decode_cid(card);
 681	}
 682
 683	/*
 684	 * Select card, as all following commands rely on that.
 685	 */
 686	if (!powered_resume && !mmc_host_is_spi(host)) {
 687		err = mmc_select_card(card);
 688		if (err)
 689			goto remove;
 690	}
 691
 692	if (card->quirks & MMC_QUIRK_NONSTD_SDIO) {
 693		/*
 694		 * This is non-standard SDIO device, meaning it doesn't
 695		 * have any CIA (Common I/O area) registers present.
 696		 * It's host's responsibility to fill cccr and cis
 697		 * structures in init_card().
 698		 */
 699		mmc_set_clock(host, card->cis.max_dtr);
 700
 701		if (card->cccr.high_speed) {
 702			mmc_set_timing(card->host, MMC_TIMING_SD_HS);
 703		}
 704
 705		goto finish;
 
 
 
 
 
 706	}
 707
 708	/*
 709	 * Read the common registers. Note that we should try to
 710	 * validate whether UHS would work or not.
 711	 */
 712	err = sdio_read_cccr(card, ocr);
 713	if (err) {
 714		mmc_sdio_resend_if_cond(host, card);
 715		if (ocr & R4_18V_PRESENT) {
 716			/* Retry init sequence, but without R4_18V_PRESENT. */
 717			retries = 0;
 718			goto try_again;
 719		} else {
 720			goto remove;
 721		}
 
 722	}
 723
 724	/*
 725	 * Read the common CIS tuples.
 726	 */
 727	err = sdio_read_common_cis(card);
 728	if (err)
 729		goto remove;
 730
 731	if (oldcard) {
 732		int same = (card->cis.vendor == oldcard->cis.vendor &&
 733			    card->cis.device == oldcard->cis.device);
 734		mmc_remove_card(card);
 735		if (!same)
 736			return -ENOENT;
 
 
 
 
 737
 738		card = oldcard;
 739	}
 740	card->ocr = ocr_card;
 741	mmc_fixup_device(card, sdio_fixup_methods);
 742
 743	if (card->type == MMC_TYPE_SD_COMBO) {
 744		err = mmc_sd_setup_card(host, card, oldcard != NULL);
 745		/* handle as SDIO-only card if memory init failed */
 746		if (err) {
 747			mmc_go_idle(host);
 748			if (mmc_host_is_spi(host))
 749				/* should not fail, as it worked previously */
 750				mmc_spi_set_crc(host, use_spi_crc);
 751			card->type = MMC_TYPE_SDIO;
 752		} else
 753			card->dev.type = &sd_type;
 754	}
 755
 756	/*
 757	 * If needed, disconnect card detection pull-up resistor.
 758	 */
 759	err = sdio_disable_cd(card);
 760	if (err)
 761		goto remove;
 762
 763	/* Initialization sequence for UHS-I cards */
 764	/* Only if card supports 1.8v and UHS signaling */
 765	if ((ocr & R4_18V_PRESENT) && card->sw_caps.sd3_bus_mode) {
 766		err = mmc_sdio_init_uhs_card(card);
 767		if (err)
 768			goto remove;
 769	} else {
 770		/*
 771		 * Switch to high-speed (if supported).
 772		 */
 773		err = sdio_enable_hs(card);
 774		if (err > 0)
 775			mmc_set_timing(card->host, MMC_TIMING_SD_HS);
 776		else if (err)
 777			goto remove;
 778
 779		/*
 780		 * Change to the card's maximum speed.
 781		 */
 782		mmc_set_clock(host, mmc_sdio_get_max_clock(card));
 783
 784		/*
 785		 * Switch to wider bus (if supported).
 786		 */
 787		err = sdio_enable_4bit_bus(card);
 788		if (err)
 789			goto remove;
 790	}
 791finish:
 792	if (!oldcard)
 793		host->card = card;
 
 
 
 
 
 
 
 794	return 0;
 795
 
 
 796remove:
 797	if (!oldcard)
 798		mmc_remove_card(card);
 
 
 
 
 
 
 799
 800err:
 801	return err;
 
 
 
 802}
 803
 804/*
 805 * Host is being removed. Free up the current card.
 806 */
 807static void mmc_sdio_remove(struct mmc_host *host)
 808{
 809	int i;
 810
 811	for (i = 0;i < host->card->sdio_funcs;i++) {
 812		if (host->card->sdio_func[i]) {
 813			sdio_remove_func(host->card->sdio_func[i]);
 814			host->card->sdio_func[i] = NULL;
 815		}
 816	}
 817
 818	mmc_remove_card(host->card);
 819	host->card = NULL;
 820}
 821
 822/*
 823 * Card detection - card is alive.
 824 */
 825static int mmc_sdio_alive(struct mmc_host *host)
 826{
 827	return mmc_select_card(host->card);
 828}
 829
 830/*
 831 * Card detection callback from host.
 832 */
 833static void mmc_sdio_detect(struct mmc_host *host)
 834{
 835	int err;
 836
 837	/* Make sure card is powered before detecting it */
 838	if (host->caps & MMC_CAP_POWER_OFF_CARD) {
 839		err = pm_runtime_get_sync(&host->card->dev);
 840		if (err < 0) {
 841			pm_runtime_put_noidle(&host->card->dev);
 842			goto out;
 843		}
 844	}
 845
 846	mmc_claim_host(host);
 847
 848	/*
 849	 * Just check if our card has been removed.
 850	 */
 851	err = _mmc_detect_card_removed(host);
 852
 853	mmc_release_host(host);
 854
 855	/*
 856	 * Tell PM core it's OK to power off the card now.
 857	 *
 858	 * The _sync variant is used in order to ensure that the card
 859	 * is left powered off in case an error occurred, and the card
 860	 * is going to be removed.
 861	 *
 862	 * Since there is no specific reason to believe a new user
 863	 * is about to show up at this point, the _sync variant is
 864	 * desirable anyway.
 865	 */
 866	if (host->caps & MMC_CAP_POWER_OFF_CARD)
 867		pm_runtime_put_sync(&host->card->dev);
 868
 869out:
 870	if (err) {
 871		mmc_sdio_remove(host);
 872
 873		mmc_claim_host(host);
 874		mmc_detach_bus(host);
 875		mmc_power_off(host);
 876		mmc_release_host(host);
 877	}
 878}
 879
 880/*
 881 * SDIO pre_suspend.  We need to suspend all functions separately.
 882 * Therefore all registered functions must have drivers with suspend
 883 * and resume methods.  Failing that we simply remove the whole card.
 884 */
 885static int mmc_sdio_pre_suspend(struct mmc_host *host)
 886{
 887	int i, err = 0;
 888
 889	for (i = 0; i < host->card->sdio_funcs; i++) {
 890		struct sdio_func *func = host->card->sdio_func[i];
 891		if (func && sdio_func_present(func) && func->dev.driver) {
 892			const struct dev_pm_ops *pmops = func->dev.driver->pm;
 893			if (!pmops || !pmops->suspend || !pmops->resume) {
 894				/* force removal of entire card in that case */
 895				err = -ENOSYS;
 896				break;
 897			}
 898		}
 899	}
 900
 901	return err;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 902}
 903
 904/*
 905 * SDIO suspend.  Suspend all functions separately.
 906 */
 907static int mmc_sdio_suspend(struct mmc_host *host)
 908{
 
 
 
 
 
 
 909	mmc_claim_host(host);
 910
 911	if (mmc_card_keep_power(host) && mmc_card_wake_sdio_irq(host))
 912		sdio_disable_wide(host->card);
 913
 914	if (!mmc_card_keep_power(host)) {
 915		mmc_power_off(host);
 916	} else if (host->retune_period) {
 917		mmc_retune_timer_stop(host);
 918		mmc_retune_needed(host);
 919	}
 920
 921	mmc_release_host(host);
 922
 923	return 0;
 924}
 925
 926static int mmc_sdio_resume(struct mmc_host *host)
 927{
 928	int err = 0;
 929
 930	/* Basic card reinitialization. */
 931	mmc_claim_host(host);
 932
 933	/* Restore power if needed */
 
 
 
 
 934	if (!mmc_card_keep_power(host)) {
 935		mmc_power_up(host, host->card->ocr);
 936		/*
 937		 * Tell runtime PM core we just powered up the card,
 938		 * since it still believes the card is powered off.
 939		 * Note that currently runtime PM is only enabled
 940		 * for SDIO cards that are MMC_CAP_POWER_OFF_CARD
 941		 */
 942		if (host->caps & MMC_CAP_POWER_OFF_CARD) {
 943			pm_runtime_disable(&host->card->dev);
 944			pm_runtime_set_active(&host->card->dev);
 945			pm_runtime_enable(&host->card->dev);
 946		}
 
 
 
 
 
 
 
 
 
 
 947	}
 948
 949	/* No need to reinitialize powered-resumed nonremovable cards */
 950	if (mmc_card_is_removable(host) || !mmc_card_keep_power(host)) {
 951		sdio_reset(host);
 952		mmc_go_idle(host);
 953		mmc_send_if_cond(host, host->card->ocr);
 954		err = mmc_send_io_op_cond(host, 0, NULL);
 955		if (!err)
 956			err = mmc_sdio_init_card(host, host->card->ocr,
 957						 host->card,
 958						 mmc_card_keep_power(host));
 959	} else if (mmc_card_keep_power(host) && mmc_card_wake_sdio_irq(host)) {
 960		/* We may have switched to 1-bit mode during suspend */
 961		err = sdio_enable_4bit_bus(host->card);
 962	}
 963
 964	if (!err && host->sdio_irqs) {
 965		if (!(host->caps2 & MMC_CAP2_SDIO_IRQ_NOTHREAD))
 966			wake_up_process(host->sdio_irq_thread);
 967		else if (host->caps & MMC_CAP_SDIO_IRQ)
 968			host->ops->enable_sdio_irq(host, 1);
 969	}
 970
 
 971	mmc_release_host(host);
 972
 973	host->pm_flags &= ~MMC_PM_KEEP_POWER;
 974	return err;
 975}
 976
 977static int mmc_sdio_power_restore(struct mmc_host *host)
 978{
 979	int ret;
 980
 981	mmc_claim_host(host);
 982
 983	/*
 984	 * Reset the card by performing the same steps that are taken by
 985	 * mmc_rescan_try_freq() and mmc_attach_sdio() during a "normal" probe.
 986	 *
 987	 * sdio_reset() is technically not needed. Having just powered up the
 988	 * hardware, it should already be in reset state. However, some
 989	 * platforms (such as SD8686 on OLPC) do not instantly cut power,
 990	 * meaning that a reset is required when restoring power soon after
 991	 * powering off. It is harmless in other cases.
 992	 *
 993	 * The CMD5 reset (mmc_send_io_op_cond()), according to the SDIO spec,
 994	 * is not necessary for non-removable cards. However, it is required
 995	 * for OLPC SD8686 (which expects a [CMD5,5,3,7] init sequence), and
 996	 * harmless in other situations.
 997	 *
 998	 */
 999
1000	sdio_reset(host);
1001	mmc_go_idle(host);
1002	mmc_send_if_cond(host, host->card->ocr);
1003
1004	ret = mmc_send_io_op_cond(host, 0, NULL);
1005	if (ret)
1006		goto out;
1007
1008	ret = mmc_sdio_init_card(host, host->card->ocr, host->card,
1009				mmc_card_keep_power(host));
1010	if (!ret && host->sdio_irqs)
1011		mmc_signal_sdio_irq(host);
1012
1013out:
1014	mmc_release_host(host);
1015
1016	return ret;
1017}
1018
1019static int mmc_sdio_runtime_suspend(struct mmc_host *host)
1020{
1021	/* No references to the card, cut the power to it. */
1022	mmc_claim_host(host);
1023	mmc_power_off(host);
1024	mmc_release_host(host);
1025
1026	return 0;
1027}
1028
1029static int mmc_sdio_runtime_resume(struct mmc_host *host)
1030{
1031	int ret;
1032
1033	/* Restore power and re-initialize. */
1034	mmc_claim_host(host);
1035	mmc_power_up(host, host->card->ocr);
1036	ret = mmc_sdio_power_restore(host);
1037	mmc_release_host(host);
1038
1039	return ret;
1040}
1041
1042static int mmc_sdio_reset(struct mmc_host *host)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1043{
1044	mmc_power_cycle(host, host->card->ocr);
1045	return mmc_sdio_power_restore(host);
 
 
 
 
 
 
1046}
1047
1048static const struct mmc_bus_ops mmc_sdio_ops = {
1049	.remove = mmc_sdio_remove,
1050	.detect = mmc_sdio_detect,
1051	.pre_suspend = mmc_sdio_pre_suspend,
1052	.suspend = mmc_sdio_suspend,
1053	.resume = mmc_sdio_resume,
1054	.runtime_suspend = mmc_sdio_runtime_suspend,
1055	.runtime_resume = mmc_sdio_runtime_resume,
1056	.power_restore = mmc_sdio_power_restore,
1057	.alive = mmc_sdio_alive,
1058	.reset = mmc_sdio_reset,
 
1059};
1060
1061
1062/*
1063 * Starting point for SDIO card init.
1064 */
1065int mmc_attach_sdio(struct mmc_host *host)
1066{
1067	int err, i, funcs;
1068	u32 ocr, rocr;
1069	struct mmc_card *card;
1070
1071	WARN_ON(!host->claimed);
1072
1073	err = mmc_send_io_op_cond(host, 0, &ocr);
1074	if (err)
1075		return err;
1076
1077	mmc_attach_bus(host, &mmc_sdio_ops);
1078	if (host->ocr_avail_sdio)
1079		host->ocr_avail = host->ocr_avail_sdio;
1080
1081
1082	rocr = mmc_select_voltage(host, ocr);
1083
1084	/*
1085	 * Can we support the voltage(s) of the card(s)?
1086	 */
1087	if (!rocr) {
1088		err = -EINVAL;
1089		goto err;
1090	}
1091
1092	/*
1093	 * Detect and init the card.
1094	 */
1095	err = mmc_sdio_init_card(host, rocr, NULL, 0);
1096	if (err)
1097		goto err;
1098
1099	card = host->card;
1100
1101	/*
1102	 * Enable runtime PM only if supported by host+card+board
1103	 */
1104	if (host->caps & MMC_CAP_POWER_OFF_CARD) {
1105		/*
1106		 * Do not allow runtime suspend until after SDIO function
1107		 * devices are added.
1108		 */
1109		pm_runtime_get_noresume(&card->dev);
1110
1111		/*
1112		 * Let runtime PM core know our card is active
1113		 */
1114		err = pm_runtime_set_active(&card->dev);
1115		if (err)
1116			goto remove;
1117
1118		/*
1119		 * Enable runtime PM for this card
1120		 */
1121		pm_runtime_enable(&card->dev);
1122	}
1123
1124	/*
1125	 * The number of functions on the card is encoded inside
1126	 * the ocr.
1127	 */
1128	funcs = (ocr & 0x70000000) >> 28;
1129	card->sdio_funcs = 0;
1130
1131	/*
1132	 * Initialize (but don't add) all present functions.
1133	 */
1134	for (i = 0; i < funcs; i++, card->sdio_funcs++) {
1135		err = sdio_init_func(host->card, i + 1);
1136		if (err)
1137			goto remove;
1138
1139		/*
1140		 * Enable Runtime PM for this func (if supported)
1141		 */
1142		if (host->caps & MMC_CAP_POWER_OFF_CARD)
1143			pm_runtime_enable(&card->sdio_func[i]->dev);
1144	}
1145
1146	/*
1147	 * First add the card to the driver model...
1148	 */
1149	mmc_release_host(host);
1150	err = mmc_add_card(host->card);
1151	if (err)
1152		goto remove_added;
1153
1154	/*
1155	 * ...then the SDIO functions.
1156	 */
1157	for (i = 0;i < funcs;i++) {
1158		err = sdio_add_func(host->card->sdio_func[i]);
1159		if (err)
1160			goto remove_added;
1161	}
1162
1163	if (host->caps & MMC_CAP_POWER_OFF_CARD)
1164		pm_runtime_put(&card->dev);
1165
1166	mmc_claim_host(host);
1167	return 0;
1168
1169
1170remove:
1171	mmc_release_host(host);
1172remove_added:
1173	/*
1174	 * The devices are being deleted so it is not necessary to disable
1175	 * runtime PM. Similarly we also don't pm_runtime_put() the SDIO card
1176	 * because it needs to be active to remove any function devices that
1177	 * were probed, and after that it gets deleted.
1178	 */
1179	mmc_sdio_remove(host);
1180	mmc_claim_host(host);
1181err:
1182	mmc_detach_bus(host);
1183
1184	pr_err("%s: error %d whilst initialising SDIO card\n",
1185		mmc_hostname(host), err);
1186
1187	return err;
1188}
1189