Linux Audio

Check our new training course

Linux BSP upgrade and security maintenance

Need help to get security updates for your Linux BSP?
Loading...
v4.6
   1/*
   2 * xHCI host controller driver
   3 *
   4 * Copyright (C) 2008 Intel Corp.
   5 *
   6 * Author: Sarah Sharp
   7 * Some code borrowed from the Linux EHCI driver.
   8 *
   9 * This program is free software; you can redistribute it and/or modify
  10 * it under the terms of the GNU General Public License version 2 as
  11 * published by the Free Software Foundation.
  12 *
  13 * This program is distributed in the hope that it will be useful, but
  14 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  15 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  16 * for more details.
  17 *
  18 * You should have received a copy of the GNU General Public License
  19 * along with this program; if not, write to the Free Software Foundation,
  20 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23#include <linux/pci.h>
  24#include <linux/irq.h>
  25#include <linux/log2.h>
  26#include <linux/module.h>
  27#include <linux/moduleparam.h>
  28#include <linux/slab.h>
  29#include <linux/dmi.h>
  30#include <linux/dma-mapping.h>
  31
  32#include "xhci.h"
  33#include "xhci-trace.h"
  34#include "xhci-mtk.h"
  35
  36#define DRIVER_AUTHOR "Sarah Sharp"
  37#define DRIVER_DESC "'eXtensible' Host Controller (xHC) Driver"
  38
  39#define	PORT_WAKE_BITS	(PORT_WKOC_E | PORT_WKDISC_E | PORT_WKCONN_E)
  40
  41/* Some 0.95 hardware can't handle the chain bit on a Link TRB being cleared */
  42static int link_quirk;
  43module_param(link_quirk, int, S_IRUGO | S_IWUSR);
  44MODULE_PARM_DESC(link_quirk, "Don't clear the chain bit on a link TRB");
  45
  46static unsigned int quirks;
  47module_param(quirks, uint, S_IRUGO);
  48MODULE_PARM_DESC(quirks, "Bit flags for quirks to be enabled as default");
  49
  50/* TODO: copied from ehci-hcd.c - can this be refactored? */
  51/*
  52 * xhci_handshake - spin reading hc until handshake completes or fails
  53 * @ptr: address of hc register to be read
  54 * @mask: bits to look at in result of read
  55 * @done: value of those bits when handshake succeeds
  56 * @usec: timeout in microseconds
  57 *
  58 * Returns negative errno, or zero on success
  59 *
  60 * Success happens when the "mask" bits have the specified value (hardware
  61 * handshake done).  There are two failure modes:  "usec" have passed (major
  62 * hardware flakeout), or the register reads as all-ones (hardware removed).
  63 */
  64int xhci_handshake(void __iomem *ptr, u32 mask, u32 done, int usec)
 
  65{
  66	u32	result;
  67
  68	do {
  69		result = readl(ptr);
  70		if (result == ~(u32)0)		/* card removed */
  71			return -ENODEV;
  72		result &= mask;
  73		if (result == done)
  74			return 0;
  75		udelay(1);
  76		usec--;
  77	} while (usec > 0);
  78	return -ETIMEDOUT;
  79}
  80
  81/*
  82 * Disable interrupts and begin the xHCI halting process.
  83 */
  84void xhci_quiesce(struct xhci_hcd *xhci)
  85{
  86	u32 halted;
  87	u32 cmd;
  88	u32 mask;
  89
  90	mask = ~(XHCI_IRQS);
  91	halted = readl(&xhci->op_regs->status) & STS_HALT;
  92	if (!halted)
  93		mask &= ~CMD_RUN;
  94
  95	cmd = readl(&xhci->op_regs->command);
  96	cmd &= mask;
  97	writel(cmd, &xhci->op_regs->command);
  98}
  99
 100/*
 101 * Force HC into halt state.
 102 *
 103 * Disable any IRQs and clear the run/stop bit.
 104 * HC will complete any current and actively pipelined transactions, and
 105 * should halt within 16 ms of the run/stop bit being cleared.
 106 * Read HC Halted bit in the status register to see when the HC is finished.
 107 */
 108int xhci_halt(struct xhci_hcd *xhci)
 109{
 110	int ret;
 111	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "// Halt the HC");
 112	xhci_quiesce(xhci);
 113
 114	ret = xhci_handshake(&xhci->op_regs->status,
 115			STS_HALT, STS_HALT, XHCI_MAX_HALT_USEC);
 116	if (!ret) {
 117		xhci->xhc_state |= XHCI_STATE_HALTED;
 118		xhci->cmd_ring_state = CMD_RING_STATE_STOPPED;
 119	} else
 120		xhci_warn(xhci, "Host not halted after %u microseconds.\n",
 121				XHCI_MAX_HALT_USEC);
 122	return ret;
 123}
 124
 125/*
 126 * Set the run bit and wait for the host to be running.
 127 */
 128static int xhci_start(struct xhci_hcd *xhci)
 129{
 130	u32 temp;
 131	int ret;
 132
 133	temp = readl(&xhci->op_regs->command);
 134	temp |= (CMD_RUN);
 135	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "// Turn on HC, cmd = 0x%x.",
 136			temp);
 137	writel(temp, &xhci->op_regs->command);
 138
 139	/*
 140	 * Wait for the HCHalted Status bit to be 0 to indicate the host is
 141	 * running.
 142	 */
 143	ret = xhci_handshake(&xhci->op_regs->status,
 144			STS_HALT, 0, XHCI_MAX_HALT_USEC);
 145	if (ret == -ETIMEDOUT)
 146		xhci_err(xhci, "Host took too long to start, "
 147				"waited %u microseconds.\n",
 148				XHCI_MAX_HALT_USEC);
 149	if (!ret)
 150		/* clear state flags. Including dying, halted or removing */
 151		xhci->xhc_state = 0;
 152
 153	return ret;
 154}
 155
 156/*
 157 * Reset a halted HC.
 158 *
 159 * This resets pipelines, timers, counters, state machines, etc.
 160 * Transactions will be terminated immediately, and operational registers
 161 * will be set to their defaults.
 162 */
 163int xhci_reset(struct xhci_hcd *xhci)
 164{
 165	u32 command;
 166	u32 state;
 167	int ret, i;
 168
 169	state = readl(&xhci->op_regs->status);
 170	if ((state & STS_HALT) == 0) {
 171		xhci_warn(xhci, "Host controller not halted, aborting reset.\n");
 172		return 0;
 173	}
 174
 175	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "// Reset the HC");
 176	command = readl(&xhci->op_regs->command);
 177	command |= CMD_RESET;
 178	writel(command, &xhci->op_regs->command);
 179
 180	/* Existing Intel xHCI controllers require a delay of 1 mS,
 181	 * after setting the CMD_RESET bit, and before accessing any
 182	 * HC registers. This allows the HC to complete the
 183	 * reset operation and be ready for HC register access.
 184	 * Without this delay, the subsequent HC register access,
 185	 * may result in a system hang very rarely.
 186	 */
 187	if (xhci->quirks & XHCI_INTEL_HOST)
 188		udelay(1000);
 189
 190	ret = xhci_handshake(&xhci->op_regs->command,
 191			CMD_RESET, 0, 10 * 1000 * 1000);
 192	if (ret)
 193		return ret;
 194
 195	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 196			 "Wait for controller to be ready for doorbell rings");
 197	/*
 198	 * xHCI cannot write to any doorbells or operational registers other
 199	 * than status until the "Controller Not Ready" flag is cleared.
 200	 */
 201	ret = xhci_handshake(&xhci->op_regs->status,
 202			STS_CNR, 0, 10 * 1000 * 1000);
 203
 204	for (i = 0; i < 2; ++i) {
 205		xhci->bus_state[i].port_c_suspend = 0;
 206		xhci->bus_state[i].suspended_ports = 0;
 207		xhci->bus_state[i].resuming_ports = 0;
 208	}
 209
 210	return ret;
 211}
 212
 213#ifdef CONFIG_PCI
 214static int xhci_free_msi(struct xhci_hcd *xhci)
 215{
 216	int i;
 217
 218	if (!xhci->msix_entries)
 219		return -EINVAL;
 220
 221	for (i = 0; i < xhci->msix_count; i++)
 222		if (xhci->msix_entries[i].vector)
 223			free_irq(xhci->msix_entries[i].vector,
 224					xhci_to_hcd(xhci));
 225	return 0;
 226}
 227
 228/*
 229 * Set up MSI
 230 */
 231static int xhci_setup_msi(struct xhci_hcd *xhci)
 232{
 233	int ret;
 234	struct pci_dev  *pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 235
 236	ret = pci_enable_msi(pdev);
 237	if (ret) {
 238		xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 239				"failed to allocate MSI entry");
 240		return ret;
 241	}
 242
 243	ret = request_irq(pdev->irq, xhci_msi_irq,
 244				0, "xhci_hcd", xhci_to_hcd(xhci));
 245	if (ret) {
 246		xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 247				"disable MSI interrupt");
 248		pci_disable_msi(pdev);
 249	}
 250
 251	return ret;
 252}
 253
 254/*
 255 * Free IRQs
 256 * free all IRQs request
 257 */
 258static void xhci_free_irq(struct xhci_hcd *xhci)
 259{
 260	struct pci_dev *pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 261	int ret;
 262
 263	/* return if using legacy interrupt */
 264	if (xhci_to_hcd(xhci)->irq > 0)
 265		return;
 266
 267	ret = xhci_free_msi(xhci);
 268	if (!ret)
 269		return;
 270	if (pdev->irq > 0)
 271		free_irq(pdev->irq, xhci_to_hcd(xhci));
 272
 273	return;
 274}
 275
 276/*
 277 * Set up MSI-X
 278 */
 279static int xhci_setup_msix(struct xhci_hcd *xhci)
 280{
 281	int i, ret = 0;
 282	struct usb_hcd *hcd = xhci_to_hcd(xhci);
 283	struct pci_dev *pdev = to_pci_dev(hcd->self.controller);
 284
 285	/*
 286	 * calculate number of msi-x vectors supported.
 287	 * - HCS_MAX_INTRS: the max number of interrupts the host can handle,
 288	 *   with max number of interrupters based on the xhci HCSPARAMS1.
 289	 * - num_online_cpus: maximum msi-x vectors per CPUs core.
 290	 *   Add additional 1 vector to ensure always available interrupt.
 291	 */
 292	xhci->msix_count = min(num_online_cpus() + 1,
 293				HCS_MAX_INTRS(xhci->hcs_params1));
 294
 295	xhci->msix_entries =
 296		kmalloc((sizeof(struct msix_entry))*xhci->msix_count,
 297				GFP_KERNEL);
 298	if (!xhci->msix_entries) {
 299		xhci_err(xhci, "Failed to allocate MSI-X entries\n");
 300		return -ENOMEM;
 301	}
 302
 303	for (i = 0; i < xhci->msix_count; i++) {
 304		xhci->msix_entries[i].entry = i;
 305		xhci->msix_entries[i].vector = 0;
 306	}
 307
 308	ret = pci_enable_msix_exact(pdev, xhci->msix_entries, xhci->msix_count);
 309	if (ret) {
 310		xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 311				"Failed to enable MSI-X");
 312		goto free_entries;
 313	}
 314
 315	for (i = 0; i < xhci->msix_count; i++) {
 316		ret = request_irq(xhci->msix_entries[i].vector,
 317				xhci_msi_irq,
 318				0, "xhci_hcd", xhci_to_hcd(xhci));
 319		if (ret)
 320			goto disable_msix;
 321	}
 322
 323	hcd->msix_enabled = 1;
 324	return ret;
 325
 326disable_msix:
 327	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "disable MSI-X interrupt");
 328	xhci_free_irq(xhci);
 329	pci_disable_msix(pdev);
 330free_entries:
 331	kfree(xhci->msix_entries);
 332	xhci->msix_entries = NULL;
 333	return ret;
 334}
 335
 336/* Free any IRQs and disable MSI-X */
 337static void xhci_cleanup_msix(struct xhci_hcd *xhci)
 338{
 339	struct usb_hcd *hcd = xhci_to_hcd(xhci);
 340	struct pci_dev *pdev = to_pci_dev(hcd->self.controller);
 341
 342	if (xhci->quirks & XHCI_PLAT)
 343		return;
 344
 345	xhci_free_irq(xhci);
 346
 347	if (xhci->msix_entries) {
 348		pci_disable_msix(pdev);
 349		kfree(xhci->msix_entries);
 350		xhci->msix_entries = NULL;
 351	} else {
 352		pci_disable_msi(pdev);
 353	}
 354
 355	hcd->msix_enabled = 0;
 356	return;
 357}
 358
 359static void __maybe_unused xhci_msix_sync_irqs(struct xhci_hcd *xhci)
 360{
 361	int i;
 362
 363	if (xhci->msix_entries) {
 364		for (i = 0; i < xhci->msix_count; i++)
 365			synchronize_irq(xhci->msix_entries[i].vector);
 366	}
 367}
 368
 369static int xhci_try_enable_msi(struct usb_hcd *hcd)
 370{
 371	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 372	struct pci_dev  *pdev;
 373	int ret;
 374
 375	/* The xhci platform device has set up IRQs through usb_add_hcd. */
 376	if (xhci->quirks & XHCI_PLAT)
 377		return 0;
 378
 379	pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 380	/*
 381	 * Some Fresco Logic host controllers advertise MSI, but fail to
 382	 * generate interrupts.  Don't even try to enable MSI.
 383	 */
 384	if (xhci->quirks & XHCI_BROKEN_MSI)
 385		goto legacy_irq;
 386
 387	/* unregister the legacy interrupt */
 388	if (hcd->irq)
 389		free_irq(hcd->irq, hcd);
 390	hcd->irq = 0;
 391
 392	ret = xhci_setup_msix(xhci);
 393	if (ret)
 394		/* fall back to msi*/
 395		ret = xhci_setup_msi(xhci);
 396
 397	if (!ret)
 398		/* hcd->irq is 0, we have MSI */
 399		return 0;
 400
 401	if (!pdev->irq) {
 402		xhci_err(xhci, "No msi-x/msi found and no IRQ in BIOS\n");
 403		return -EINVAL;
 404	}
 405
 406 legacy_irq:
 407	if (!strlen(hcd->irq_descr))
 408		snprintf(hcd->irq_descr, sizeof(hcd->irq_descr), "%s:usb%d",
 409			 hcd->driver->description, hcd->self.busnum);
 410
 411	/* fall back to legacy interrupt*/
 412	ret = request_irq(pdev->irq, &usb_hcd_irq, IRQF_SHARED,
 413			hcd->irq_descr, hcd);
 414	if (ret) {
 415		xhci_err(xhci, "request interrupt %d failed\n",
 416				pdev->irq);
 417		return ret;
 418	}
 419	hcd->irq = pdev->irq;
 420	return 0;
 421}
 422
 423#else
 424
 425static inline int xhci_try_enable_msi(struct usb_hcd *hcd)
 426{
 427	return 0;
 428}
 429
 430static inline void xhci_cleanup_msix(struct xhci_hcd *xhci)
 431{
 432}
 433
 434static inline void xhci_msix_sync_irqs(struct xhci_hcd *xhci)
 435{
 436}
 437
 438#endif
 439
 440static void compliance_mode_recovery(unsigned long arg)
 441{
 442	struct xhci_hcd *xhci;
 443	struct usb_hcd *hcd;
 444	u32 temp;
 445	int i;
 446
 447	xhci = (struct xhci_hcd *)arg;
 448
 449	for (i = 0; i < xhci->num_usb3_ports; i++) {
 450		temp = readl(xhci->usb3_ports[i]);
 451		if ((temp & PORT_PLS_MASK) == USB_SS_PORT_LS_COMP_MOD) {
 452			/*
 453			 * Compliance Mode Detected. Letting USB Core
 454			 * handle the Warm Reset
 455			 */
 456			xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 457					"Compliance mode detected->port %d",
 458					i + 1);
 459			xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 460					"Attempting compliance mode recovery");
 461			hcd = xhci->shared_hcd;
 462
 463			if (hcd->state == HC_STATE_SUSPENDED)
 464				usb_hcd_resume_root_hub(hcd);
 465
 466			usb_hcd_poll_rh_status(hcd);
 467		}
 468	}
 469
 470	if (xhci->port_status_u0 != ((1 << xhci->num_usb3_ports)-1))
 471		mod_timer(&xhci->comp_mode_recovery_timer,
 472			jiffies + msecs_to_jiffies(COMP_MODE_RCVRY_MSECS));
 473}
 474
 475/*
 476 * Quirk to work around issue generated by the SN65LVPE502CP USB3.0 re-driver
 477 * that causes ports behind that hardware to enter compliance mode sometimes.
 478 * The quirk creates a timer that polls every 2 seconds the link state of
 479 * each host controller's port and recovers it by issuing a Warm reset
 480 * if Compliance mode is detected, otherwise the port will become "dead" (no
 481 * device connections or disconnections will be detected anymore). Becasue no
 482 * status event is generated when entering compliance mode (per xhci spec),
 483 * this quirk is needed on systems that have the failing hardware installed.
 484 */
 485static void compliance_mode_recovery_timer_init(struct xhci_hcd *xhci)
 486{
 487	xhci->port_status_u0 = 0;
 488	setup_timer(&xhci->comp_mode_recovery_timer,
 489		    compliance_mode_recovery, (unsigned long)xhci);
 
 
 490	xhci->comp_mode_recovery_timer.expires = jiffies +
 491			msecs_to_jiffies(COMP_MODE_RCVRY_MSECS);
 492
 493	set_timer_slack(&xhci->comp_mode_recovery_timer,
 494			msecs_to_jiffies(COMP_MODE_RCVRY_MSECS));
 495	add_timer(&xhci->comp_mode_recovery_timer);
 496	xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 497			"Compliance mode recovery timer initialized");
 498}
 499
 500/*
 501 * This function identifies the systems that have installed the SN65LVPE502CP
 502 * USB3.0 re-driver and that need the Compliance Mode Quirk.
 503 * Systems:
 504 * Vendor: Hewlett-Packard -> System Models: Z420, Z620 and Z820
 505 */
 506static bool xhci_compliance_mode_recovery_timer_quirk_check(void)
 507{
 508	const char *dmi_product_name, *dmi_sys_vendor;
 509
 510	dmi_product_name = dmi_get_system_info(DMI_PRODUCT_NAME);
 511	dmi_sys_vendor = dmi_get_system_info(DMI_SYS_VENDOR);
 512	if (!dmi_product_name || !dmi_sys_vendor)
 513		return false;
 514
 515	if (!(strstr(dmi_sys_vendor, "Hewlett-Packard")))
 516		return false;
 517
 518	if (strstr(dmi_product_name, "Z420") ||
 519			strstr(dmi_product_name, "Z620") ||
 520			strstr(dmi_product_name, "Z820") ||
 521			strstr(dmi_product_name, "Z1 Workstation"))
 522		return true;
 523
 524	return false;
 525}
 526
 527static int xhci_all_ports_seen_u0(struct xhci_hcd *xhci)
 528{
 529	return (xhci->port_status_u0 == ((1 << xhci->num_usb3_ports)-1));
 530}
 531
 532
 533/*
 534 * Initialize memory for HCD and xHC (one-time init).
 535 *
 536 * Program the PAGESIZE register, initialize the device context array, create
 537 * device contexts (?), set up a command ring segment (or two?), create event
 538 * ring (one for now).
 539 */
 540int xhci_init(struct usb_hcd *hcd)
 541{
 542	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 543	int retval = 0;
 544
 545	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "xhci_init");
 546	spin_lock_init(&xhci->lock);
 547	if (xhci->hci_version == 0x95 && link_quirk) {
 548		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 549				"QUIRK: Not clearing Link TRB chain bits.");
 550		xhci->quirks |= XHCI_LINK_TRB_QUIRK;
 551	} else {
 552		xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 553				"xHCI doesn't need link TRB QUIRK");
 554	}
 555	retval = xhci_mem_init(xhci, GFP_KERNEL);
 556	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "Finished xhci_init");
 557
 558	/* Initializing Compliance Mode Recovery Data If Needed */
 559	if (xhci_compliance_mode_recovery_timer_quirk_check()) {
 560		xhci->quirks |= XHCI_COMP_MODE_QUIRK;
 561		compliance_mode_recovery_timer_init(xhci);
 562	}
 563
 564	return retval;
 565}
 566
 567/*-------------------------------------------------------------------------*/
 568
 569
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 570static int xhci_run_finished(struct xhci_hcd *xhci)
 571{
 572	if (xhci_start(xhci)) {
 573		xhci_halt(xhci);
 574		return -ENODEV;
 575	}
 576	xhci->shared_hcd->state = HC_STATE_RUNNING;
 577	xhci->cmd_ring_state = CMD_RING_STATE_RUNNING;
 578
 579	if (xhci->quirks & XHCI_NEC_HOST)
 580		xhci_ring_cmd_db(xhci);
 581
 582	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 583			"Finished xhci_run for USB3 roothub");
 584	return 0;
 585}
 586
 587/*
 588 * Start the HC after it was halted.
 589 *
 590 * This function is called by the USB core when the HC driver is added.
 591 * Its opposite is xhci_stop().
 592 *
 593 * xhci_init() must be called once before this function can be called.
 594 * Reset the HC, enable device slot contexts, program DCBAAP, and
 595 * set command ring pointer and event ring pointer.
 596 *
 597 * Setup MSI-X vectors and enable interrupts.
 598 */
 599int xhci_run(struct usb_hcd *hcd)
 600{
 601	u32 temp;
 602	u64 temp_64;
 603	int ret;
 604	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 605
 606	/* Start the xHCI host controller running only after the USB 2.0 roothub
 607	 * is setup.
 608	 */
 609
 610	hcd->uses_new_polling = 1;
 611	if (!usb_hcd_is_primary_hcd(hcd))
 612		return xhci_run_finished(xhci);
 613
 614	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "xhci_run");
 615
 616	ret = xhci_try_enable_msi(hcd);
 617	if (ret)
 618		return ret;
 619
 
 
 
 
 
 
 
 
 
 
 
 620	xhci_dbg(xhci, "Command ring memory map follows:\n");
 621	xhci_debug_ring(xhci, xhci->cmd_ring);
 622	xhci_dbg_ring_ptrs(xhci, xhci->cmd_ring);
 623	xhci_dbg_cmd_ptrs(xhci);
 624
 625	xhci_dbg(xhci, "ERST memory map follows:\n");
 626	xhci_dbg_erst(xhci, &xhci->erst);
 627	xhci_dbg(xhci, "Event ring:\n");
 628	xhci_debug_ring(xhci, xhci->event_ring);
 629	xhci_dbg_ring_ptrs(xhci, xhci->event_ring);
 630	temp_64 = xhci_read_64(xhci, &xhci->ir_set->erst_dequeue);
 631	temp_64 &= ~ERST_PTR_MASK;
 632	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 633			"ERST deq = 64'h%0lx", (long unsigned int) temp_64);
 634
 635	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 636			"// Set the interrupt modulation register");
 637	temp = readl(&xhci->ir_set->irq_control);
 638	temp &= ~ER_IRQ_INTERVAL_MASK;
 639	/*
 640	 * the increment interval is 8 times as much as that defined
 641	 * in xHCI spec on MTK's controller
 642	 */
 643	temp |= (u32) ((xhci->quirks & XHCI_MTK_HOST) ? 20 : 160);
 644	writel(temp, &xhci->ir_set->irq_control);
 645
 646	/* Set the HCD state before we enable the irqs */
 647	temp = readl(&xhci->op_regs->command);
 648	temp |= (CMD_EIE);
 649	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 650			"// Enable interrupts, cmd = 0x%x.", temp);
 651	writel(temp, &xhci->op_regs->command);
 652
 653	temp = readl(&xhci->ir_set->irq_pending);
 654	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 655			"// Enabling event ring interrupter %p by writing 0x%x to irq_pending",
 656			xhci->ir_set, (unsigned int) ER_IRQ_ENABLE(temp));
 657	writel(ER_IRQ_ENABLE(temp), &xhci->ir_set->irq_pending);
 
 658	xhci_print_ir_set(xhci, 0);
 659
 660	if (xhci->quirks & XHCI_NEC_HOST) {
 661		struct xhci_command *command;
 662		command = xhci_alloc_command(xhci, false, false, GFP_KERNEL);
 663		if (!command)
 664			return -ENOMEM;
 665		xhci_queue_vendor_command(xhci, command, 0, 0, 0,
 666				TRB_TYPE(TRB_NEC_GET_FW));
 667	}
 668	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 669			"Finished xhci_run for USB2 roothub");
 670	return 0;
 671}
 672EXPORT_SYMBOL_GPL(xhci_run);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 673
 674/*
 675 * Stop xHCI driver.
 676 *
 677 * This function is called by the USB core when the HC driver is removed.
 678 * Its opposite is xhci_run().
 679 *
 680 * Disable device contexts, disable IRQs, and quiesce the HC.
 681 * Reset the HC, finish any completed transactions, and cleanup memory.
 682 */
 683void xhci_stop(struct usb_hcd *hcd)
 684{
 685	u32 temp;
 686	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 687
 688	if (xhci->xhc_state & XHCI_STATE_HALTED)
 
 689		return;
 
 690
 691	mutex_lock(&xhci->mutex);
 692	spin_lock_irq(&xhci->lock);
 693	xhci->xhc_state |= XHCI_STATE_HALTED;
 694	xhci->cmd_ring_state = CMD_RING_STATE_STOPPED;
 695
 696	/* Make sure the xHC is halted for a USB3 roothub
 697	 * (xhci_stop() could be called as part of failed init).
 698	 */
 699	xhci_halt(xhci);
 700	xhci_reset(xhci);
 701	spin_unlock_irq(&xhci->lock);
 702
 703	xhci_cleanup_msix(xhci);
 704
 
 
 
 
 
 
 705	/* Deleting Compliance Mode Recovery Timer */
 706	if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) &&
 707			(!(xhci_all_ports_seen_u0(xhci)))) {
 708		del_timer_sync(&xhci->comp_mode_recovery_timer);
 709		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 710				"%s: compliance mode recovery timer deleted",
 711				__func__);
 712	}
 713
 714	if (xhci->quirks & XHCI_AMD_PLL_FIX)
 715		usb_amd_dev_put();
 716
 717	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 718			"// Disabling event ring interrupts");
 719	temp = readl(&xhci->op_regs->status);
 720	writel(temp & ~STS_EINT, &xhci->op_regs->status);
 721	temp = readl(&xhci->ir_set->irq_pending);
 722	writel(ER_IRQ_DISABLE(temp), &xhci->ir_set->irq_pending);
 723	xhci_print_ir_set(xhci, 0);
 724
 725	xhci_dbg_trace(xhci, trace_xhci_dbg_init, "cleaning up memory");
 726	xhci_mem_cleanup(xhci);
 727	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 728			"xhci_stop completed - status = %x",
 729			readl(&xhci->op_regs->status));
 730	mutex_unlock(&xhci->mutex);
 731}
 732
 733/*
 734 * Shutdown HC (not bus-specific)
 735 *
 736 * This is called when the machine is rebooting or halting.  We assume that the
 737 * machine will be powered off, and the HC's internal state will be reset.
 738 * Don't bother to free memory.
 739 *
 740 * This will only ever be called with the main usb_hcd (the USB3 roothub).
 741 */
 742void xhci_shutdown(struct usb_hcd *hcd)
 743{
 744	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 745
 746	if (xhci->quirks & XHCI_SPURIOUS_REBOOT)
 747		usb_disable_xhci_ports(to_pci_dev(hcd->self.controller));
 748
 749	spin_lock_irq(&xhci->lock);
 750	xhci_halt(xhci);
 751	/* Workaround for spurious wakeups at shutdown with HSW */
 752	if (xhci->quirks & XHCI_SPURIOUS_WAKEUP)
 753		xhci_reset(xhci);
 754	spin_unlock_irq(&xhci->lock);
 755
 756	xhci_cleanup_msix(xhci);
 757
 758	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 759			"xhci_shutdown completed - status = %x",
 760			readl(&xhci->op_regs->status));
 761
 762	/* Yet another workaround for spurious wakeups at shutdown with HSW */
 763	if (xhci->quirks & XHCI_SPURIOUS_WAKEUP)
 764		pci_set_power_state(to_pci_dev(hcd->self.controller), PCI_D3hot);
 765}
 766
 767#ifdef CONFIG_PM
 768static void xhci_save_registers(struct xhci_hcd *xhci)
 769{
 770	xhci->s3.command = readl(&xhci->op_regs->command);
 771	xhci->s3.dev_nt = readl(&xhci->op_regs->dev_notification);
 772	xhci->s3.dcbaa_ptr = xhci_read_64(xhci, &xhci->op_regs->dcbaa_ptr);
 773	xhci->s3.config_reg = readl(&xhci->op_regs->config_reg);
 774	xhci->s3.erst_size = readl(&xhci->ir_set->erst_size);
 775	xhci->s3.erst_base = xhci_read_64(xhci, &xhci->ir_set->erst_base);
 776	xhci->s3.erst_dequeue = xhci_read_64(xhci, &xhci->ir_set->erst_dequeue);
 777	xhci->s3.irq_pending = readl(&xhci->ir_set->irq_pending);
 778	xhci->s3.irq_control = readl(&xhci->ir_set->irq_control);
 779}
 780
 781static void xhci_restore_registers(struct xhci_hcd *xhci)
 782{
 783	writel(xhci->s3.command, &xhci->op_regs->command);
 784	writel(xhci->s3.dev_nt, &xhci->op_regs->dev_notification);
 785	xhci_write_64(xhci, xhci->s3.dcbaa_ptr, &xhci->op_regs->dcbaa_ptr);
 786	writel(xhci->s3.config_reg, &xhci->op_regs->config_reg);
 787	writel(xhci->s3.erst_size, &xhci->ir_set->erst_size);
 788	xhci_write_64(xhci, xhci->s3.erst_base, &xhci->ir_set->erst_base);
 789	xhci_write_64(xhci, xhci->s3.erst_dequeue, &xhci->ir_set->erst_dequeue);
 790	writel(xhci->s3.irq_pending, &xhci->ir_set->irq_pending);
 791	writel(xhci->s3.irq_control, &xhci->ir_set->irq_control);
 792}
 793
 794static void xhci_set_cmd_ring_deq(struct xhci_hcd *xhci)
 795{
 796	u64	val_64;
 797
 798	/* step 2: initialize command ring buffer */
 799	val_64 = xhci_read_64(xhci, &xhci->op_regs->cmd_ring);
 800	val_64 = (val_64 & (u64) CMD_RING_RSVD_BITS) |
 801		(xhci_trb_virt_to_dma(xhci->cmd_ring->deq_seg,
 802				      xhci->cmd_ring->dequeue) &
 803		 (u64) ~CMD_RING_RSVD_BITS) |
 804		xhci->cmd_ring->cycle_state;
 805	xhci_dbg_trace(xhci, trace_xhci_dbg_init,
 806			"// Setting command ring address to 0x%llx",
 807			(long unsigned long) val_64);
 808	xhci_write_64(xhci, val_64, &xhci->op_regs->cmd_ring);
 809}
 810
 811/*
 812 * The whole command ring must be cleared to zero when we suspend the host.
 813 *
 814 * The host doesn't save the command ring pointer in the suspend well, so we
 815 * need to re-program it on resume.  Unfortunately, the pointer must be 64-byte
 816 * aligned, because of the reserved bits in the command ring dequeue pointer
 817 * register.  Therefore, we can't just set the dequeue pointer back in the
 818 * middle of the ring (TRBs are 16-byte aligned).
 819 */
 820static void xhci_clear_command_ring(struct xhci_hcd *xhci)
 821{
 822	struct xhci_ring *ring;
 823	struct xhci_segment *seg;
 824
 825	ring = xhci->cmd_ring;
 826	seg = ring->deq_seg;
 827	do {
 828		memset(seg->trbs, 0,
 829			sizeof(union xhci_trb) * (TRBS_PER_SEGMENT - 1));
 830		seg->trbs[TRBS_PER_SEGMENT - 1].link.control &=
 831			cpu_to_le32(~TRB_CYCLE);
 832		seg = seg->next;
 833	} while (seg != ring->deq_seg);
 834
 835	/* Reset the software enqueue and dequeue pointers */
 836	ring->deq_seg = ring->first_seg;
 837	ring->dequeue = ring->first_seg->trbs;
 838	ring->enq_seg = ring->deq_seg;
 839	ring->enqueue = ring->dequeue;
 840
 841	ring->num_trbs_free = ring->num_segs * (TRBS_PER_SEGMENT - 1) - 1;
 842	/*
 843	 * Ring is now zeroed, so the HW should look for change of ownership
 844	 * when the cycle bit is set to 1.
 845	 */
 846	ring->cycle_state = 1;
 847
 848	/*
 849	 * Reset the hardware dequeue pointer.
 850	 * Yes, this will need to be re-written after resume, but we're paranoid
 851	 * and want to make sure the hardware doesn't access bogus memory
 852	 * because, say, the BIOS or an SMI started the host without changing
 853	 * the command ring pointers.
 854	 */
 855	xhci_set_cmd_ring_deq(xhci);
 856}
 857
 858static void xhci_disable_port_wake_on_bits(struct xhci_hcd *xhci)
 859{
 860	int port_index;
 861	__le32 __iomem **port_array;
 862	unsigned long flags;
 863	u32 t1, t2;
 864
 865	spin_lock_irqsave(&xhci->lock, flags);
 866
 867	/* disble usb3 ports Wake bits*/
 868	port_index = xhci->num_usb3_ports;
 869	port_array = xhci->usb3_ports;
 870	while (port_index--) {
 871		t1 = readl(port_array[port_index]);
 872		t1 = xhci_port_state_to_neutral(t1);
 873		t2 = t1 & ~PORT_WAKE_BITS;
 874		if (t1 != t2)
 875			writel(t2, port_array[port_index]);
 876	}
 877
 878	/* disble usb2 ports Wake bits*/
 879	port_index = xhci->num_usb2_ports;
 880	port_array = xhci->usb2_ports;
 881	while (port_index--) {
 882		t1 = readl(port_array[port_index]);
 883		t1 = xhci_port_state_to_neutral(t1);
 884		t2 = t1 & ~PORT_WAKE_BITS;
 885		if (t1 != t2)
 886			writel(t2, port_array[port_index]);
 887	}
 888
 889	spin_unlock_irqrestore(&xhci->lock, flags);
 890}
 891
 892/*
 893 * Stop HC (not bus-specific)
 894 *
 895 * This is called when the machine transition into S3/S4 mode.
 896 *
 897 */
 898int xhci_suspend(struct xhci_hcd *xhci, bool do_wakeup)
 899{
 900	int			rc = 0;
 901	unsigned int		delay = XHCI_MAX_HALT_USEC;
 902	struct usb_hcd		*hcd = xhci_to_hcd(xhci);
 903	u32			command;
 904
 905	if (!hcd->state)
 906		return 0;
 907
 908	if (hcd->state != HC_STATE_SUSPENDED ||
 909			xhci->shared_hcd->state != HC_STATE_SUSPENDED)
 910		return -EINVAL;
 911
 912	/* Clear root port wake on bits if wakeup not allowed. */
 913	if (!do_wakeup)
 914		xhci_disable_port_wake_on_bits(xhci);
 915
 916	/* Don't poll the roothubs on bus suspend. */
 917	xhci_dbg(xhci, "%s: stopping port polling.\n", __func__);
 918	clear_bit(HCD_FLAG_POLL_RH, &hcd->flags);
 919	del_timer_sync(&hcd->rh_timer);
 920	clear_bit(HCD_FLAG_POLL_RH, &xhci->shared_hcd->flags);
 921	del_timer_sync(&xhci->shared_hcd->rh_timer);
 922
 923	spin_lock_irq(&xhci->lock);
 924	clear_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
 925	clear_bit(HCD_FLAG_HW_ACCESSIBLE, &xhci->shared_hcd->flags);
 926	/* step 1: stop endpoint */
 927	/* skipped assuming that port suspend has done */
 928
 929	/* step 2: clear Run/Stop bit */
 930	command = readl(&xhci->op_regs->command);
 931	command &= ~CMD_RUN;
 932	writel(command, &xhci->op_regs->command);
 933
 934	/* Some chips from Fresco Logic need an extraordinary delay */
 935	delay *= (xhci->quirks & XHCI_SLOW_SUSPEND) ? 10 : 1;
 936
 937	if (xhci_handshake(&xhci->op_regs->status,
 938		      STS_HALT, STS_HALT, delay)) {
 939		xhci_warn(xhci, "WARN: xHC CMD_RUN timeout\n");
 940		spin_unlock_irq(&xhci->lock);
 941		return -ETIMEDOUT;
 942	}
 943	xhci_clear_command_ring(xhci);
 944
 945	/* step 3: save registers */
 946	xhci_save_registers(xhci);
 947
 948	/* step 4: set CSS flag */
 949	command = readl(&xhci->op_regs->command);
 950	command |= CMD_CSS;
 951	writel(command, &xhci->op_regs->command);
 952	if (xhci_handshake(&xhci->op_regs->status,
 953				STS_SAVE, 0, 10 * 1000)) {
 954		xhci_warn(xhci, "WARN: xHC save state timeout\n");
 955		spin_unlock_irq(&xhci->lock);
 956		return -ETIMEDOUT;
 957	}
 958	spin_unlock_irq(&xhci->lock);
 959
 960	/*
 961	 * Deleting Compliance Mode Recovery Timer because the xHCI Host
 962	 * is about to be suspended.
 963	 */
 964	if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) &&
 965			(!(xhci_all_ports_seen_u0(xhci)))) {
 966		del_timer_sync(&xhci->comp_mode_recovery_timer);
 967		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
 968				"%s: compliance mode recovery timer deleted",
 969				__func__);
 970	}
 971
 972	/* step 5: remove core well power */
 973	/* synchronize irq when using MSI-X */
 974	xhci_msix_sync_irqs(xhci);
 975
 976	return rc;
 977}
 978EXPORT_SYMBOL_GPL(xhci_suspend);
 979
 980/*
 981 * start xHC (not bus-specific)
 982 *
 983 * This is called when the machine transition from S3/S4 mode.
 984 *
 985 */
 986int xhci_resume(struct xhci_hcd *xhci, bool hibernated)
 987{
 988	u32			command, temp = 0, status;
 989	struct usb_hcd		*hcd = xhci_to_hcd(xhci);
 990	struct usb_hcd		*secondary_hcd;
 991	int			retval = 0;
 992	bool			comp_timer_running = false;
 993
 994	if (!hcd->state)
 995		return 0;
 996
 997	/* Wait a bit if either of the roothubs need to settle from the
 998	 * transition into bus suspend.
 999	 */
1000	if (time_before(jiffies, xhci->bus_state[0].next_statechange) ||
1001			time_before(jiffies,
1002				xhci->bus_state[1].next_statechange))
1003		msleep(100);
1004
1005	set_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
1006	set_bit(HCD_FLAG_HW_ACCESSIBLE, &xhci->shared_hcd->flags);
1007
1008	spin_lock_irq(&xhci->lock);
1009	if (xhci->quirks & XHCI_RESET_ON_RESUME)
1010		hibernated = true;
1011
1012	if (!hibernated) {
1013		/* step 1: restore register */
1014		xhci_restore_registers(xhci);
1015		/* step 2: initialize command ring buffer */
1016		xhci_set_cmd_ring_deq(xhci);
1017		/* step 3: restore state and start state*/
1018		/* step 3: set CRS flag */
1019		command = readl(&xhci->op_regs->command);
1020		command |= CMD_CRS;
1021		writel(command, &xhci->op_regs->command);
1022		if (xhci_handshake(&xhci->op_regs->status,
1023			      STS_RESTORE, 0, 10 * 1000)) {
1024			xhci_warn(xhci, "WARN: xHC restore state timeout\n");
1025			spin_unlock_irq(&xhci->lock);
1026			return -ETIMEDOUT;
1027		}
1028		temp = readl(&xhci->op_regs->status);
1029	}
1030
1031	/* If restore operation fails, re-initialize the HC during resume */
1032	if ((temp & STS_SRE) || hibernated) {
1033
1034		if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) &&
1035				!(xhci_all_ports_seen_u0(xhci))) {
1036			del_timer_sync(&xhci->comp_mode_recovery_timer);
1037			xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
1038				"Compliance Mode Recovery Timer deleted!");
1039		}
1040
1041		/* Let the USB core know _both_ roothubs lost power. */
1042		usb_root_hub_lost_power(xhci->main_hcd->self.root_hub);
1043		usb_root_hub_lost_power(xhci->shared_hcd->self.root_hub);
1044
1045		xhci_dbg(xhci, "Stop HCD\n");
1046		xhci_halt(xhci);
1047		xhci_reset(xhci);
1048		spin_unlock_irq(&xhci->lock);
1049		xhci_cleanup_msix(xhci);
1050
 
 
 
 
 
 
1051		xhci_dbg(xhci, "// Disabling event ring interrupts\n");
1052		temp = readl(&xhci->op_regs->status);
1053		writel(temp & ~STS_EINT, &xhci->op_regs->status);
1054		temp = readl(&xhci->ir_set->irq_pending);
1055		writel(ER_IRQ_DISABLE(temp), &xhci->ir_set->irq_pending);
 
1056		xhci_print_ir_set(xhci, 0);
1057
1058		xhci_dbg(xhci, "cleaning up memory\n");
1059		xhci_mem_cleanup(xhci);
1060		xhci_dbg(xhci, "xhci_stop completed - status = %x\n",
1061			    readl(&xhci->op_regs->status));
1062
1063		/* USB core calls the PCI reinit and start functions twice:
1064		 * first with the primary HCD, and then with the secondary HCD.
1065		 * If we don't do the same, the host will never be started.
1066		 */
1067		if (!usb_hcd_is_primary_hcd(hcd))
1068			secondary_hcd = hcd;
1069		else
1070			secondary_hcd = xhci->shared_hcd;
1071
1072		xhci_dbg(xhci, "Initialize the xhci_hcd\n");
1073		retval = xhci_init(hcd->primary_hcd);
1074		if (retval)
1075			return retval;
1076		comp_timer_running = true;
1077
1078		xhci_dbg(xhci, "Start the primary HCD\n");
1079		retval = xhci_run(hcd->primary_hcd);
1080		if (!retval) {
1081			xhci_dbg(xhci, "Start the secondary HCD\n");
1082			retval = xhci_run(secondary_hcd);
1083		}
1084		hcd->state = HC_STATE_SUSPENDED;
1085		xhci->shared_hcd->state = HC_STATE_SUSPENDED;
1086		goto done;
1087	}
1088
1089	/* step 4: set Run/Stop bit */
1090	command = readl(&xhci->op_regs->command);
1091	command |= CMD_RUN;
1092	writel(command, &xhci->op_regs->command);
1093	xhci_handshake(&xhci->op_regs->status, STS_HALT,
1094		  0, 250 * 1000);
1095
1096	/* step 5: walk topology and initialize portsc,
1097	 * portpmsc and portli
1098	 */
1099	/* this is done in bus_resume */
1100
1101	/* step 6: restart each of the previously
1102	 * Running endpoints by ringing their doorbells
1103	 */
1104
1105	spin_unlock_irq(&xhci->lock);
1106
1107 done:
1108	if (retval == 0) {
1109		/* Resume root hubs only when have pending events. */
1110		status = readl(&xhci->op_regs->status);
1111		if (status & STS_EINT) {
1112			usb_hcd_resume_root_hub(xhci->shared_hcd);
1113			usb_hcd_resume_root_hub(hcd);
1114		}
1115	}
1116
1117	/*
1118	 * If system is subject to the Quirk, Compliance Mode Timer needs to
1119	 * be re-initialized Always after a system resume. Ports are subject
1120	 * to suffer the Compliance Mode issue again. It doesn't matter if
1121	 * ports have entered previously to U0 before system's suspension.
1122	 */
1123	if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) && !comp_timer_running)
1124		compliance_mode_recovery_timer_init(xhci);
1125
1126	/* Re-enable port polling. */
1127	xhci_dbg(xhci, "%s: starting port polling.\n", __func__);
1128	set_bit(HCD_FLAG_POLL_RH, &xhci->shared_hcd->flags);
1129	usb_hcd_poll_rh_status(xhci->shared_hcd);
1130	set_bit(HCD_FLAG_POLL_RH, &hcd->flags);
1131	usb_hcd_poll_rh_status(hcd);
1132
1133	return retval;
1134}
1135EXPORT_SYMBOL_GPL(xhci_resume);
1136#endif	/* CONFIG_PM */
1137
1138/*-------------------------------------------------------------------------*/
1139
1140/**
1141 * xhci_get_endpoint_index - Used for passing endpoint bitmasks between the core and
1142 * HCDs.  Find the index for an endpoint given its descriptor.  Use the return
1143 * value to right shift 1 for the bitmask.
1144 *
1145 * Index  = (epnum * 2) + direction - 1,
1146 * where direction = 0 for OUT, 1 for IN.
1147 * For control endpoints, the IN index is used (OUT index is unused), so
1148 * index = (epnum * 2) + direction - 1 = (epnum * 2) + 1 - 1 = (epnum * 2)
1149 */
1150unsigned int xhci_get_endpoint_index(struct usb_endpoint_descriptor *desc)
1151{
1152	unsigned int index;
1153	if (usb_endpoint_xfer_control(desc))
1154		index = (unsigned int) (usb_endpoint_num(desc)*2);
1155	else
1156		index = (unsigned int) (usb_endpoint_num(desc)*2) +
1157			(usb_endpoint_dir_in(desc) ? 1 : 0) - 1;
1158	return index;
1159}
1160
1161/* The reverse operation to xhci_get_endpoint_index. Calculate the USB endpoint
1162 * address from the XHCI endpoint index.
1163 */
1164unsigned int xhci_get_endpoint_address(unsigned int ep_index)
1165{
1166	unsigned int number = DIV_ROUND_UP(ep_index, 2);
1167	unsigned int direction = ep_index % 2 ? USB_DIR_OUT : USB_DIR_IN;
1168	return direction | number;
1169}
1170
1171/* Find the flag for this endpoint (for use in the control context).  Use the
1172 * endpoint index to create a bitmask.  The slot context is bit 0, endpoint 0 is
1173 * bit 1, etc.
1174 */
1175unsigned int xhci_get_endpoint_flag(struct usb_endpoint_descriptor *desc)
1176{
1177	return 1 << (xhci_get_endpoint_index(desc) + 1);
1178}
1179
1180/* Find the flag for this endpoint (for use in the control context).  Use the
1181 * endpoint index to create a bitmask.  The slot context is bit 0, endpoint 0 is
1182 * bit 1, etc.
1183 */
1184unsigned int xhci_get_endpoint_flag_from_index(unsigned int ep_index)
1185{
1186	return 1 << (ep_index + 1);
1187}
1188
1189/* Compute the last valid endpoint context index.  Basically, this is the
1190 * endpoint index plus one.  For slot contexts with more than valid endpoint,
1191 * we find the most significant bit set in the added contexts flags.
1192 * e.g. ep 1 IN (with epnum 0x81) => added_ctxs = 0b1000
1193 * fls(0b1000) = 4, but the endpoint context index is 3, so subtract one.
1194 */
1195unsigned int xhci_last_valid_endpoint(u32 added_ctxs)
1196{
1197	return fls(added_ctxs) - 1;
1198}
1199
1200/* Returns 1 if the arguments are OK;
1201 * returns 0 this is a root hub; returns -EINVAL for NULL pointers.
1202 */
1203static int xhci_check_args(struct usb_hcd *hcd, struct usb_device *udev,
1204		struct usb_host_endpoint *ep, int check_ep, bool check_virt_dev,
1205		const char *func) {
1206	struct xhci_hcd	*xhci;
1207	struct xhci_virt_device	*virt_dev;
1208
1209	if (!hcd || (check_ep && !ep) || !udev) {
1210		pr_debug("xHCI %s called with invalid args\n", func);
 
1211		return -EINVAL;
1212	}
1213	if (!udev->parent) {
1214		pr_debug("xHCI %s called for root hub\n", func);
 
1215		return 0;
1216	}
1217
1218	xhci = hcd_to_xhci(hcd);
 
 
 
1219	if (check_virt_dev) {
1220		if (!udev->slot_id || !xhci->devs[udev->slot_id]) {
1221			xhci_dbg(xhci, "xHCI %s called with unaddressed device\n",
1222					func);
1223			return -EINVAL;
1224		}
1225
1226		virt_dev = xhci->devs[udev->slot_id];
1227		if (virt_dev->udev != udev) {
1228			xhci_dbg(xhci, "xHCI %s called with udev and "
1229					  "virt_dev does not match\n", func);
1230			return -EINVAL;
1231		}
1232	}
1233
1234	if (xhci->xhc_state & XHCI_STATE_HALTED)
1235		return -ENODEV;
1236
1237	return 1;
1238}
1239
1240static int xhci_configure_endpoint(struct xhci_hcd *xhci,
1241		struct usb_device *udev, struct xhci_command *command,
1242		bool ctx_change, bool must_succeed);
1243
1244/*
1245 * Full speed devices may have a max packet size greater than 8 bytes, but the
1246 * USB core doesn't know that until it reads the first 8 bytes of the
1247 * descriptor.  If the usb_device's max packet size changes after that point,
1248 * we need to issue an evaluate context command and wait on it.
1249 */
1250static int xhci_check_maxpacket(struct xhci_hcd *xhci, unsigned int slot_id,
1251		unsigned int ep_index, struct urb *urb)
1252{
 
1253	struct xhci_container_ctx *out_ctx;
1254	struct xhci_input_control_ctx *ctrl_ctx;
1255	struct xhci_ep_ctx *ep_ctx;
1256	struct xhci_command *command;
1257	int max_packet_size;
1258	int hw_max_packet_size;
1259	int ret = 0;
1260
1261	out_ctx = xhci->devs[slot_id]->out_ctx;
1262	ep_ctx = xhci_get_ep_ctx(xhci, out_ctx, ep_index);
1263	hw_max_packet_size = MAX_PACKET_DECODED(le32_to_cpu(ep_ctx->ep_info2));
1264	max_packet_size = usb_endpoint_maxp(&urb->dev->ep0.desc);
1265	if (hw_max_packet_size != max_packet_size) {
1266		xhci_dbg_trace(xhci,  trace_xhci_dbg_context_change,
1267				"Max Packet Size for ep 0 changed.");
1268		xhci_dbg_trace(xhci,  trace_xhci_dbg_context_change,
1269				"Max packet size in usb_device = %d",
1270				max_packet_size);
1271		xhci_dbg_trace(xhci,  trace_xhci_dbg_context_change,
1272				"Max packet size in xHCI HW = %d",
1273				hw_max_packet_size);
1274		xhci_dbg_trace(xhci,  trace_xhci_dbg_context_change,
1275				"Issuing evaluate context command.");
1276
1277		/* Set up the input context flags for the command */
1278		/* FIXME: This won't work if a non-default control endpoint
1279		 * changes max packet sizes.
1280		 */
1281
1282		command = xhci_alloc_command(xhci, false, true, GFP_KERNEL);
1283		if (!command)
1284			return -ENOMEM;
1285
1286		command->in_ctx = xhci->devs[slot_id]->in_ctx;
1287		ctrl_ctx = xhci_get_input_control_ctx(command->in_ctx);
1288		if (!ctrl_ctx) {
1289			xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
1290					__func__);
1291			ret = -ENOMEM;
1292			goto command_cleanup;
1293		}
1294		/* Set up the modified control endpoint 0 */
1295		xhci_endpoint_copy(xhci, xhci->devs[slot_id]->in_ctx,
1296				xhci->devs[slot_id]->out_ctx, ep_index);
1297
1298		ep_ctx = xhci_get_ep_ctx(xhci, command->in_ctx, ep_index);
1299		ep_ctx->ep_info2 &= cpu_to_le32(~MAX_PACKET_MASK);
1300		ep_ctx->ep_info2 |= cpu_to_le32(MAX_PACKET(max_packet_size));
1301
 
 
 
 
 
1302		ctrl_ctx->add_flags = cpu_to_le32(EP0_FLAG);
1303		ctrl_ctx->drop_flags = 0;
1304
1305		xhci_dbg(xhci, "Slot %d input context\n", slot_id);
1306		xhci_dbg_ctx(xhci, command->in_ctx, ep_index);
1307		xhci_dbg(xhci, "Slot %d output context\n", slot_id);
1308		xhci_dbg_ctx(xhci, out_ctx, ep_index);
1309
1310		ret = xhci_configure_endpoint(xhci, urb->dev, command,
1311				true, false);
1312
1313		/* Clean up the input context for later use by bandwidth
1314		 * functions.
1315		 */
1316		ctrl_ctx->add_flags = cpu_to_le32(SLOT_FLAG);
1317command_cleanup:
1318		kfree(command->completion);
1319		kfree(command);
1320	}
1321	return ret;
1322}
1323
1324/*
1325 * non-error returns are a promise to giveback() the urb later
1326 * we drop ownership so next owner (or urb unlink) can get it
1327 */
1328int xhci_urb_enqueue(struct usb_hcd *hcd, struct urb *urb, gfp_t mem_flags)
1329{
1330	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
1331	struct xhci_td *buffer;
1332	unsigned long flags;
1333	int ret = 0;
1334	unsigned int slot_id, ep_index;
1335	struct urb_priv	*urb_priv;
1336	int size, i;
1337
1338	if (!urb || xhci_check_args(hcd, urb->dev, urb->ep,
1339					true, true, __func__) <= 0)
1340		return -EINVAL;
1341
1342	slot_id = urb->dev->slot_id;
1343	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1344
1345	if (!HCD_HW_ACCESSIBLE(hcd)) {
1346		if (!in_interrupt())
1347			xhci_dbg(xhci, "urb submitted during PCI suspend\n");
1348		ret = -ESHUTDOWN;
1349		goto exit;
1350	}
1351
1352	if (usb_endpoint_xfer_isoc(&urb->ep->desc))
1353		size = urb->number_of_packets;
1354	else if (usb_endpoint_is_bulk_out(&urb->ep->desc) &&
1355	    urb->transfer_buffer_length > 0 &&
1356	    urb->transfer_flags & URB_ZERO_PACKET &&
1357	    !(urb->transfer_buffer_length % usb_endpoint_maxp(&urb->ep->desc)))
1358		size = 2;
1359	else
1360		size = 1;
1361
1362	urb_priv = kzalloc(sizeof(struct urb_priv) +
1363				  size * sizeof(struct xhci_td *), mem_flags);
1364	if (!urb_priv)
1365		return -ENOMEM;
1366
1367	buffer = kzalloc(size * sizeof(struct xhci_td), mem_flags);
1368	if (!buffer) {
1369		kfree(urb_priv);
1370		return -ENOMEM;
1371	}
1372
1373	for (i = 0; i < size; i++) {
1374		urb_priv->td[i] = buffer;
1375		buffer++;
1376	}
1377
1378	urb_priv->length = size;
1379	urb_priv->td_cnt = 0;
1380	urb->hcpriv = urb_priv;
1381
1382	if (usb_endpoint_xfer_control(&urb->ep->desc)) {
1383		/* Check to see if the max packet size for the default control
1384		 * endpoint changed during FS device enumeration
1385		 */
1386		if (urb->dev->speed == USB_SPEED_FULL) {
1387			ret = xhci_check_maxpacket(xhci, slot_id,
1388					ep_index, urb);
1389			if (ret < 0) {
1390				xhci_urb_free_priv(urb_priv);
1391				urb->hcpriv = NULL;
1392				return ret;
1393			}
1394		}
1395
1396		/* We have a spinlock and interrupts disabled, so we must pass
1397		 * atomic context to this function, which may allocate memory.
1398		 */
1399		spin_lock_irqsave(&xhci->lock, flags);
1400		if (xhci->xhc_state & XHCI_STATE_DYING)
1401			goto dying;
1402		ret = xhci_queue_ctrl_tx(xhci, GFP_ATOMIC, urb,
1403				slot_id, ep_index);
1404		if (ret)
1405			goto free_priv;
1406		spin_unlock_irqrestore(&xhci->lock, flags);
1407	} else if (usb_endpoint_xfer_bulk(&urb->ep->desc)) {
1408		spin_lock_irqsave(&xhci->lock, flags);
1409		if (xhci->xhc_state & XHCI_STATE_DYING)
1410			goto dying;
1411		if (xhci->devs[slot_id]->eps[ep_index].ep_state &
1412				EP_GETTING_STREAMS) {
1413			xhci_warn(xhci, "WARN: Can't enqueue URB while bulk ep "
1414					"is transitioning to using streams.\n");
1415			ret = -EINVAL;
1416		} else if (xhci->devs[slot_id]->eps[ep_index].ep_state &
1417				EP_GETTING_NO_STREAMS) {
1418			xhci_warn(xhci, "WARN: Can't enqueue URB while bulk ep "
1419					"is transitioning to "
1420					"not having streams.\n");
1421			ret = -EINVAL;
1422		} else {
1423			ret = xhci_queue_bulk_tx(xhci, GFP_ATOMIC, urb,
1424					slot_id, ep_index);
1425		}
1426		if (ret)
1427			goto free_priv;
1428		spin_unlock_irqrestore(&xhci->lock, flags);
1429	} else if (usb_endpoint_xfer_int(&urb->ep->desc)) {
1430		spin_lock_irqsave(&xhci->lock, flags);
1431		if (xhci->xhc_state & XHCI_STATE_DYING)
1432			goto dying;
1433		ret = xhci_queue_intr_tx(xhci, GFP_ATOMIC, urb,
1434				slot_id, ep_index);
1435		if (ret)
1436			goto free_priv;
1437		spin_unlock_irqrestore(&xhci->lock, flags);
1438	} else {
1439		spin_lock_irqsave(&xhci->lock, flags);
1440		if (xhci->xhc_state & XHCI_STATE_DYING)
1441			goto dying;
1442		ret = xhci_queue_isoc_tx_prepare(xhci, GFP_ATOMIC, urb,
1443				slot_id, ep_index);
1444		if (ret)
1445			goto free_priv;
1446		spin_unlock_irqrestore(&xhci->lock, flags);
1447	}
1448exit:
1449	return ret;
1450dying:
1451	xhci_dbg(xhci, "Ep 0x%x: URB %p submitted for "
1452			"non-responsive xHCI host.\n",
1453			urb->ep->desc.bEndpointAddress, urb);
1454	ret = -ESHUTDOWN;
1455free_priv:
1456	xhci_urb_free_priv(urb_priv);
1457	urb->hcpriv = NULL;
1458	spin_unlock_irqrestore(&xhci->lock, flags);
1459	return ret;
1460}
1461
1462/* Get the right ring for the given URB.
1463 * If the endpoint supports streams, boundary check the URB's stream ID.
1464 * If the endpoint doesn't support streams, return the singular endpoint ring.
1465 */
1466static struct xhci_ring *xhci_urb_to_transfer_ring(struct xhci_hcd *xhci,
1467		struct urb *urb)
1468{
1469	unsigned int slot_id;
1470	unsigned int ep_index;
1471	unsigned int stream_id;
1472	struct xhci_virt_ep *ep;
1473
1474	slot_id = urb->dev->slot_id;
1475	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1476	stream_id = urb->stream_id;
1477	ep = &xhci->devs[slot_id]->eps[ep_index];
1478	/* Common case: no streams */
1479	if (!(ep->ep_state & EP_HAS_STREAMS))
1480		return ep->ring;
1481
1482	if (stream_id == 0) {
1483		xhci_warn(xhci,
1484				"WARN: Slot ID %u, ep index %u has streams, "
1485				"but URB has no stream ID.\n",
1486				slot_id, ep_index);
1487		return NULL;
1488	}
1489
1490	if (stream_id < ep->stream_info->num_streams)
1491		return ep->stream_info->stream_rings[stream_id];
1492
1493	xhci_warn(xhci,
1494			"WARN: Slot ID %u, ep index %u has "
1495			"stream IDs 1 to %u allocated, "
1496			"but stream ID %u is requested.\n",
1497			slot_id, ep_index,
1498			ep->stream_info->num_streams - 1,
1499			stream_id);
1500	return NULL;
1501}
1502
1503/*
1504 * Remove the URB's TD from the endpoint ring.  This may cause the HC to stop
1505 * USB transfers, potentially stopping in the middle of a TRB buffer.  The HC
1506 * should pick up where it left off in the TD, unless a Set Transfer Ring
1507 * Dequeue Pointer is issued.
1508 *
1509 * The TRBs that make up the buffers for the canceled URB will be "removed" from
1510 * the ring.  Since the ring is a contiguous structure, they can't be physically
1511 * removed.  Instead, there are two options:
1512 *
1513 *  1) If the HC is in the middle of processing the URB to be canceled, we
1514 *     simply move the ring's dequeue pointer past those TRBs using the Set
1515 *     Transfer Ring Dequeue Pointer command.  This will be the common case,
1516 *     when drivers timeout on the last submitted URB and attempt to cancel.
1517 *
1518 *  2) If the HC is in the middle of a different TD, we turn the TRBs into a
1519 *     series of 1-TRB transfer no-op TDs.  (No-ops shouldn't be chained.)  The
1520 *     HC will need to invalidate the any TRBs it has cached after the stop
1521 *     endpoint command, as noted in the xHCI 0.95 errata.
1522 *
1523 *  3) The TD may have completed by the time the Stop Endpoint Command
1524 *     completes, so software needs to handle that case too.
1525 *
1526 * This function should protect against the TD enqueueing code ringing the
1527 * doorbell while this code is waiting for a Stop Endpoint command to complete.
1528 * It also needs to account for multiple cancellations on happening at the same
1529 * time for the same endpoint.
1530 *
1531 * Note that this function can be called in any context, or so says
1532 * usb_hcd_unlink_urb()
1533 */
1534int xhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status)
1535{
1536	unsigned long flags;
1537	int ret, i;
1538	u32 temp;
1539	struct xhci_hcd *xhci;
1540	struct urb_priv	*urb_priv;
1541	struct xhci_td *td;
1542	unsigned int ep_index;
1543	struct xhci_ring *ep_ring;
1544	struct xhci_virt_ep *ep;
1545	struct xhci_command *command;
1546
1547	xhci = hcd_to_xhci(hcd);
1548	spin_lock_irqsave(&xhci->lock, flags);
1549	/* Make sure the URB hasn't completed or been unlinked already */
1550	ret = usb_hcd_check_unlink_urb(hcd, urb, status);
1551	if (ret || !urb->hcpriv)
1552		goto done;
1553	temp = readl(&xhci->op_regs->status);
1554	if (temp == 0xffffffff || (xhci->xhc_state & XHCI_STATE_HALTED)) {
1555		xhci_dbg_trace(xhci, trace_xhci_dbg_cancel_urb,
1556				"HW died, freeing TD.");
1557		urb_priv = urb->hcpriv;
1558		for (i = urb_priv->td_cnt;
1559		     i < urb_priv->length && xhci->devs[urb->dev->slot_id];
1560		     i++) {
1561			td = urb_priv->td[i];
1562			if (!list_empty(&td->td_list))
1563				list_del_init(&td->td_list);
1564			if (!list_empty(&td->cancelled_td_list))
1565				list_del_init(&td->cancelled_td_list);
1566		}
1567
1568		usb_hcd_unlink_urb_from_ep(hcd, urb);
1569		spin_unlock_irqrestore(&xhci->lock, flags);
1570		usb_hcd_giveback_urb(hcd, urb, -ESHUTDOWN);
1571		xhci_urb_free_priv(urb_priv);
1572		return ret;
1573	}
1574	if ((xhci->xhc_state & XHCI_STATE_DYING) ||
1575			(xhci->xhc_state & XHCI_STATE_HALTED)) {
1576		xhci_dbg_trace(xhci, trace_xhci_dbg_cancel_urb,
1577				"Ep 0x%x: URB %p to be canceled on "
1578				"non-responsive xHCI host.",
1579				urb->ep->desc.bEndpointAddress, urb);
1580		/* Let the stop endpoint command watchdog timer (which set this
1581		 * state) finish cleaning up the endpoint TD lists.  We must
1582		 * have caught it in the middle of dropping a lock and giving
1583		 * back an URB.
1584		 */
1585		goto done;
1586	}
1587
1588	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1589	ep = &xhci->devs[urb->dev->slot_id]->eps[ep_index];
1590	ep_ring = xhci_urb_to_transfer_ring(xhci, urb);
1591	if (!ep_ring) {
1592		ret = -EINVAL;
1593		goto done;
1594	}
1595
1596	urb_priv = urb->hcpriv;
1597	i = urb_priv->td_cnt;
1598	if (i < urb_priv->length)
1599		xhci_dbg_trace(xhci, trace_xhci_dbg_cancel_urb,
1600				"Cancel URB %p, dev %s, ep 0x%x, "
1601				"starting at offset 0x%llx",
1602				urb, urb->dev->devpath,
1603				urb->ep->desc.bEndpointAddress,
1604				(unsigned long long) xhci_trb_virt_to_dma(
1605					urb_priv->td[i]->start_seg,
1606					urb_priv->td[i]->first_trb));
1607
1608	for (; i < urb_priv->length; i++) {
1609		td = urb_priv->td[i];
1610		list_add_tail(&td->cancelled_td_list, &ep->cancelled_td_list);
1611	}
1612
1613	/* Queue a stop endpoint command, but only if this is
1614	 * the first cancellation to be handled.
1615	 */
1616	if (!(ep->ep_state & EP_HALT_PENDING)) {
1617		command = xhci_alloc_command(xhci, false, false, GFP_ATOMIC);
1618		if (!command) {
1619			ret = -ENOMEM;
1620			goto done;
1621		}
1622		ep->ep_state |= EP_HALT_PENDING;
1623		ep->stop_cmds_pending++;
1624		ep->stop_cmd_timer.expires = jiffies +
1625			XHCI_STOP_EP_CMD_TIMEOUT * HZ;
1626		add_timer(&ep->stop_cmd_timer);
1627		xhci_queue_stop_endpoint(xhci, command, urb->dev->slot_id,
1628					 ep_index, 0);
1629		xhci_ring_cmd_db(xhci);
1630	}
1631done:
1632	spin_unlock_irqrestore(&xhci->lock, flags);
1633	return ret;
1634}
1635
1636/* Drop an endpoint from a new bandwidth configuration for this device.
1637 * Only one call to this function is allowed per endpoint before
1638 * check_bandwidth() or reset_bandwidth() must be called.
1639 * A call to xhci_drop_endpoint() followed by a call to xhci_add_endpoint() will
1640 * add the endpoint to the schedule with possibly new parameters denoted by a
1641 * different endpoint descriptor in usb_host_endpoint.
1642 * A call to xhci_add_endpoint() followed by a call to xhci_drop_endpoint() is
1643 * not allowed.
1644 *
1645 * The USB core will not allow URBs to be queued to an endpoint that is being
1646 * disabled, so there's no need for mutual exclusion to protect
1647 * the xhci->devs[slot_id] structure.
1648 */
1649int xhci_drop_endpoint(struct usb_hcd *hcd, struct usb_device *udev,
1650		struct usb_host_endpoint *ep)
1651{
1652	struct xhci_hcd *xhci;
1653	struct xhci_container_ctx *in_ctx, *out_ctx;
1654	struct xhci_input_control_ctx *ctrl_ctx;
 
 
1655	unsigned int ep_index;
1656	struct xhci_ep_ctx *ep_ctx;
1657	u32 drop_flag;
1658	u32 new_add_flags, new_drop_flags;
1659	int ret;
1660
1661	ret = xhci_check_args(hcd, udev, ep, 1, true, __func__);
1662	if (ret <= 0)
1663		return ret;
1664	xhci = hcd_to_xhci(hcd);
1665	if (xhci->xhc_state & XHCI_STATE_DYING)
1666		return -ENODEV;
1667
1668	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
1669	drop_flag = xhci_get_endpoint_flag(&ep->desc);
1670	if (drop_flag == SLOT_FLAG || drop_flag == EP0_FLAG) {
1671		xhci_dbg(xhci, "xHCI %s - can't drop slot or ep 0 %#x\n",
1672				__func__, drop_flag);
1673		return 0;
1674	}
1675
1676	in_ctx = xhci->devs[udev->slot_id]->in_ctx;
1677	out_ctx = xhci->devs[udev->slot_id]->out_ctx;
1678	ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
1679	if (!ctrl_ctx) {
1680		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
1681				__func__);
1682		return 0;
1683	}
1684
1685	ep_index = xhci_get_endpoint_index(&ep->desc);
1686	ep_ctx = xhci_get_ep_ctx(xhci, out_ctx, ep_index);
1687	/* If the HC already knows the endpoint is disabled,
1688	 * or the HCD has noted it is disabled, ignore this request
1689	 */
1690	if (((ep_ctx->ep_info & cpu_to_le32(EP_STATE_MASK)) ==
1691	     cpu_to_le32(EP_STATE_DISABLED)) ||
1692	    le32_to_cpu(ctrl_ctx->drop_flags) &
1693	    xhci_get_endpoint_flag(&ep->desc)) {
1694		/* Do not warn when called after a usb_device_reset */
1695		if (xhci->devs[udev->slot_id]->eps[ep_index].ring != NULL)
1696			xhci_warn(xhci, "xHCI %s called with disabled ep %p\n",
1697				  __func__, ep);
1698		return 0;
1699	}
1700
1701	ctrl_ctx->drop_flags |= cpu_to_le32(drop_flag);
1702	new_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags);
1703
1704	ctrl_ctx->add_flags &= cpu_to_le32(~drop_flag);
1705	new_add_flags = le32_to_cpu(ctrl_ctx->add_flags);
1706
1707	xhci_endpoint_zero(xhci, xhci->devs[udev->slot_id], ep);
 
 
 
 
 
 
 
 
1708
1709	if (xhci->quirks & XHCI_MTK_HOST)
1710		xhci_mtk_drop_ep_quirk(hcd, udev, ep);
1711
1712	xhci_dbg(xhci, "drop ep 0x%x, slot id %d, new drop flags = %#x, new add flags = %#x\n",
1713			(unsigned int) ep->desc.bEndpointAddress,
1714			udev->slot_id,
1715			(unsigned int) new_drop_flags,
1716			(unsigned int) new_add_flags);
 
1717	return 0;
1718}
1719
1720/* Add an endpoint to a new possible bandwidth configuration for this device.
1721 * Only one call to this function is allowed per endpoint before
1722 * check_bandwidth() or reset_bandwidth() must be called.
1723 * A call to xhci_drop_endpoint() followed by a call to xhci_add_endpoint() will
1724 * add the endpoint to the schedule with possibly new parameters denoted by a
1725 * different endpoint descriptor in usb_host_endpoint.
1726 * A call to xhci_add_endpoint() followed by a call to xhci_drop_endpoint() is
1727 * not allowed.
1728 *
1729 * The USB core will not allow URBs to be queued to an endpoint until the
1730 * configuration or alt setting is installed in the device, so there's no need
1731 * for mutual exclusion to protect the xhci->devs[slot_id] structure.
1732 */
1733int xhci_add_endpoint(struct usb_hcd *hcd, struct usb_device *udev,
1734		struct usb_host_endpoint *ep)
1735{
1736	struct xhci_hcd *xhci;
1737	struct xhci_container_ctx *in_ctx;
1738	unsigned int ep_index;
 
 
1739	struct xhci_input_control_ctx *ctrl_ctx;
1740	u32 added_ctxs;
1741	u32 new_add_flags, new_drop_flags;
 
1742	struct xhci_virt_device *virt_dev;
1743	int ret = 0;
1744
1745	ret = xhci_check_args(hcd, udev, ep, 1, true, __func__);
1746	if (ret <= 0) {
1747		/* So we won't queue a reset ep command for a root hub */
1748		ep->hcpriv = NULL;
1749		return ret;
1750	}
1751	xhci = hcd_to_xhci(hcd);
1752	if (xhci->xhc_state & XHCI_STATE_DYING)
1753		return -ENODEV;
1754
1755	added_ctxs = xhci_get_endpoint_flag(&ep->desc);
 
1756	if (added_ctxs == SLOT_FLAG || added_ctxs == EP0_FLAG) {
1757		/* FIXME when we have to issue an evaluate endpoint command to
1758		 * deal with ep0 max packet size changing once we get the
1759		 * descriptors
1760		 */
1761		xhci_dbg(xhci, "xHCI %s - can't add slot or ep 0 %#x\n",
1762				__func__, added_ctxs);
1763		return 0;
1764	}
1765
1766	virt_dev = xhci->devs[udev->slot_id];
1767	in_ctx = virt_dev->in_ctx;
1768	ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
1769	if (!ctrl_ctx) {
1770		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
1771				__func__);
1772		return 0;
1773	}
1774
1775	ep_index = xhci_get_endpoint_index(&ep->desc);
 
 
1776	/* If this endpoint is already in use, and the upper layers are trying
1777	 * to add it again without dropping it, reject the addition.
1778	 */
1779	if (virt_dev->eps[ep_index].ring &&
1780			!(le32_to_cpu(ctrl_ctx->drop_flags) & added_ctxs)) {
 
1781		xhci_warn(xhci, "Trying to add endpoint 0x%x "
1782				"without dropping it.\n",
1783				(unsigned int) ep->desc.bEndpointAddress);
1784		return -EINVAL;
1785	}
1786
1787	/* If the HCD has already noted the endpoint is enabled,
1788	 * ignore this request.
1789	 */
1790	if (le32_to_cpu(ctrl_ctx->add_flags) & added_ctxs) {
 
1791		xhci_warn(xhci, "xHCI %s called with enabled ep %p\n",
1792				__func__, ep);
1793		return 0;
1794	}
1795
1796	/*
1797	 * Configuration and alternate setting changes must be done in
1798	 * process context, not interrupt context (or so documenation
1799	 * for usb_set_interface() and usb_set_configuration() claim).
1800	 */
1801	if (xhci_endpoint_init(xhci, virt_dev, udev, ep, GFP_NOIO) < 0) {
1802		dev_dbg(&udev->dev, "%s - could not initialize ep %#x\n",
1803				__func__, ep->desc.bEndpointAddress);
1804		return -ENOMEM;
1805	}
1806
1807	if (xhci->quirks & XHCI_MTK_HOST) {
1808		ret = xhci_mtk_add_ep_quirk(hcd, udev, ep);
1809		if (ret < 0) {
1810			xhci_free_or_cache_endpoint_ring(xhci,
1811				virt_dev, ep_index);
1812			return ret;
1813		}
1814	}
1815
1816	ctrl_ctx->add_flags |= cpu_to_le32(added_ctxs);
1817	new_add_flags = le32_to_cpu(ctrl_ctx->add_flags);
1818
1819	/* If xhci_endpoint_disable() was called for this endpoint, but the
1820	 * xHC hasn't been notified yet through the check_bandwidth() call,
1821	 * this re-adds a new state for the endpoint from the new endpoint
1822	 * descriptors.  We must drop and re-add this endpoint, so we leave the
1823	 * drop flags alone.
1824	 */
1825	new_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags);
1826
 
 
 
 
 
 
 
 
 
1827	/* Store the usb_device pointer for later use */
1828	ep->hcpriv = udev;
1829
1830	xhci_dbg(xhci, "add ep 0x%x, slot id %d, new drop flags = %#x, new add flags = %#x\n",
1831			(unsigned int) ep->desc.bEndpointAddress,
1832			udev->slot_id,
1833			(unsigned int) new_drop_flags,
1834			(unsigned int) new_add_flags);
 
1835	return 0;
1836}
1837
1838static void xhci_zero_in_ctx(struct xhci_hcd *xhci, struct xhci_virt_device *virt_dev)
1839{
1840	struct xhci_input_control_ctx *ctrl_ctx;
1841	struct xhci_ep_ctx *ep_ctx;
1842	struct xhci_slot_ctx *slot_ctx;
1843	int i;
1844
1845	ctrl_ctx = xhci_get_input_control_ctx(virt_dev->in_ctx);
1846	if (!ctrl_ctx) {
1847		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
1848				__func__);
1849		return;
1850	}
1851
1852	/* When a device's add flag and drop flag are zero, any subsequent
1853	 * configure endpoint command will leave that endpoint's state
1854	 * untouched.  Make sure we don't leave any old state in the input
1855	 * endpoint contexts.
1856	 */
 
1857	ctrl_ctx->drop_flags = 0;
1858	ctrl_ctx->add_flags = 0;
1859	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
1860	slot_ctx->dev_info &= cpu_to_le32(~LAST_CTX_MASK);
1861	/* Endpoint 0 is always valid */
1862	slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(1));
1863	for (i = 1; i < 31; ++i) {
1864		ep_ctx = xhci_get_ep_ctx(xhci, virt_dev->in_ctx, i);
1865		ep_ctx->ep_info = 0;
1866		ep_ctx->ep_info2 = 0;
1867		ep_ctx->deq = 0;
1868		ep_ctx->tx_info = 0;
1869	}
1870}
1871
1872static int xhci_configure_endpoint_result(struct xhci_hcd *xhci,
1873		struct usb_device *udev, u32 *cmd_status)
1874{
1875	int ret;
1876
1877	switch (*cmd_status) {
1878	case COMP_CMD_ABORT:
1879	case COMP_CMD_STOP:
1880		xhci_warn(xhci, "Timeout while waiting for configure endpoint command\n");
1881		ret = -ETIME;
1882		break;
1883	case COMP_ENOMEM:
1884		dev_warn(&udev->dev,
1885			 "Not enough host controller resources for new device state.\n");
1886		ret = -ENOMEM;
1887		/* FIXME: can we allocate more resources for the HC? */
1888		break;
1889	case COMP_BW_ERR:
1890	case COMP_2ND_BW_ERR:
1891		dev_warn(&udev->dev,
1892			 "Not enough bandwidth for new device state.\n");
1893		ret = -ENOSPC;
1894		/* FIXME: can we go back to the old state? */
1895		break;
1896	case COMP_TRB_ERR:
1897		/* the HCD set up something wrong */
1898		dev_warn(&udev->dev, "ERROR: Endpoint drop flag = 0, "
1899				"add flag = 1, "
1900				"and endpoint is not disabled.\n");
1901		ret = -EINVAL;
1902		break;
1903	case COMP_DEV_ERR:
1904		dev_warn(&udev->dev,
1905			 "ERROR: Incompatible device for endpoint configure command.\n");
1906		ret = -ENODEV;
1907		break;
1908	case COMP_SUCCESS:
1909		xhci_dbg_trace(xhci, trace_xhci_dbg_context_change,
1910				"Successful Endpoint Configure command");
1911		ret = 0;
1912		break;
1913	default:
1914		xhci_err(xhci, "ERROR: unexpected command completion code 0x%x.\n",
1915				*cmd_status);
1916		ret = -EINVAL;
1917		break;
1918	}
1919	return ret;
1920}
1921
1922static int xhci_evaluate_context_result(struct xhci_hcd *xhci,
1923		struct usb_device *udev, u32 *cmd_status)
1924{
1925	int ret;
1926	struct xhci_virt_device *virt_dev = xhci->devs[udev->slot_id];
1927
1928	switch (*cmd_status) {
1929	case COMP_CMD_ABORT:
1930	case COMP_CMD_STOP:
1931		xhci_warn(xhci, "Timeout while waiting for evaluate context command\n");
1932		ret = -ETIME;
1933		break;
1934	case COMP_EINVAL:
1935		dev_warn(&udev->dev,
1936			 "WARN: xHCI driver setup invalid evaluate context command.\n");
1937		ret = -EINVAL;
1938		break;
1939	case COMP_EBADSLT:
1940		dev_warn(&udev->dev,
1941			"WARN: slot not enabled for evaluate context command.\n");
1942		ret = -EINVAL;
1943		break;
1944	case COMP_CTX_STATE:
1945		dev_warn(&udev->dev,
1946			"WARN: invalid context state for evaluate context command.\n");
1947		xhci_dbg_ctx(xhci, virt_dev->out_ctx, 1);
1948		ret = -EINVAL;
1949		break;
1950	case COMP_DEV_ERR:
1951		dev_warn(&udev->dev,
1952			"ERROR: Incompatible device for evaluate context command.\n");
1953		ret = -ENODEV;
1954		break;
1955	case COMP_MEL_ERR:
1956		/* Max Exit Latency too large error */
1957		dev_warn(&udev->dev, "WARN: Max Exit Latency too large\n");
1958		ret = -EINVAL;
1959		break;
1960	case COMP_SUCCESS:
1961		xhci_dbg_trace(xhci, trace_xhci_dbg_context_change,
1962				"Successful evaluate context command");
1963		ret = 0;
1964		break;
1965	default:
1966		xhci_err(xhci, "ERROR: unexpected command completion code 0x%x.\n",
1967			*cmd_status);
1968		ret = -EINVAL;
1969		break;
1970	}
1971	return ret;
1972}
1973
1974static u32 xhci_count_num_new_endpoints(struct xhci_hcd *xhci,
1975		struct xhci_input_control_ctx *ctrl_ctx)
1976{
 
1977	u32 valid_add_flags;
1978	u32 valid_drop_flags;
1979
 
1980	/* Ignore the slot flag (bit 0), and the default control endpoint flag
1981	 * (bit 1).  The default control endpoint is added during the Address
1982	 * Device command and is never removed until the slot is disabled.
1983	 */
1984	valid_add_flags = le32_to_cpu(ctrl_ctx->add_flags) >> 2;
1985	valid_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags) >> 2;
1986
1987	/* Use hweight32 to count the number of ones in the add flags, or
1988	 * number of endpoints added.  Don't count endpoints that are changed
1989	 * (both added and dropped).
1990	 */
1991	return hweight32(valid_add_flags) -
1992		hweight32(valid_add_flags & valid_drop_flags);
1993}
1994
1995static unsigned int xhci_count_num_dropped_endpoints(struct xhci_hcd *xhci,
1996		struct xhci_input_control_ctx *ctrl_ctx)
1997{
 
1998	u32 valid_add_flags;
1999	u32 valid_drop_flags;
2000
2001	valid_add_flags = le32_to_cpu(ctrl_ctx->add_flags) >> 2;
2002	valid_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags) >> 2;
 
2003
2004	return hweight32(valid_drop_flags) -
2005		hweight32(valid_add_flags & valid_drop_flags);
2006}
2007
2008/*
2009 * We need to reserve the new number of endpoints before the configure endpoint
2010 * command completes.  We can't subtract the dropped endpoints from the number
2011 * of active endpoints until the command completes because we can oversubscribe
2012 * the host in this case:
2013 *
2014 *  - the first configure endpoint command drops more endpoints than it adds
2015 *  - a second configure endpoint command that adds more endpoints is queued
2016 *  - the first configure endpoint command fails, so the config is unchanged
2017 *  - the second command may succeed, even though there isn't enough resources
2018 *
2019 * Must be called with xhci->lock held.
2020 */
2021static int xhci_reserve_host_resources(struct xhci_hcd *xhci,
2022		struct xhci_input_control_ctx *ctrl_ctx)
2023{
2024	u32 added_eps;
2025
2026	added_eps = xhci_count_num_new_endpoints(xhci, ctrl_ctx);
2027	if (xhci->num_active_eps + added_eps > xhci->limit_active_eps) {
2028		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2029				"Not enough ep ctxs: "
2030				"%u active, need to add %u, limit is %u.",
2031				xhci->num_active_eps, added_eps,
2032				xhci->limit_active_eps);
2033		return -ENOMEM;
2034	}
2035	xhci->num_active_eps += added_eps;
2036	xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2037			"Adding %u ep ctxs, %u now active.", added_eps,
2038			xhci->num_active_eps);
2039	return 0;
2040}
2041
2042/*
2043 * The configure endpoint was failed by the xHC for some other reason, so we
2044 * need to revert the resources that failed configuration would have used.
2045 *
2046 * Must be called with xhci->lock held.
2047 */
2048static void xhci_free_host_resources(struct xhci_hcd *xhci,
2049		struct xhci_input_control_ctx *ctrl_ctx)
2050{
2051	u32 num_failed_eps;
2052
2053	num_failed_eps = xhci_count_num_new_endpoints(xhci, ctrl_ctx);
2054	xhci->num_active_eps -= num_failed_eps;
2055	xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2056			"Removing %u failed ep ctxs, %u now active.",
2057			num_failed_eps,
2058			xhci->num_active_eps);
2059}
2060
2061/*
2062 * Now that the command has completed, clean up the active endpoint count by
2063 * subtracting out the endpoints that were dropped (but not changed).
2064 *
2065 * Must be called with xhci->lock held.
2066 */
2067static void xhci_finish_resource_reservation(struct xhci_hcd *xhci,
2068		struct xhci_input_control_ctx *ctrl_ctx)
2069{
2070	u32 num_dropped_eps;
2071
2072	num_dropped_eps = xhci_count_num_dropped_endpoints(xhci, ctrl_ctx);
2073	xhci->num_active_eps -= num_dropped_eps;
2074	if (num_dropped_eps)
2075		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2076				"Removing %u dropped ep ctxs, %u now active.",
2077				num_dropped_eps,
2078				xhci->num_active_eps);
2079}
2080
2081static unsigned int xhci_get_block_size(struct usb_device *udev)
2082{
2083	switch (udev->speed) {
2084	case USB_SPEED_LOW:
2085	case USB_SPEED_FULL:
2086		return FS_BLOCK;
2087	case USB_SPEED_HIGH:
2088		return HS_BLOCK;
2089	case USB_SPEED_SUPER:
2090	case USB_SPEED_SUPER_PLUS:
2091		return SS_BLOCK;
2092	case USB_SPEED_UNKNOWN:
2093	case USB_SPEED_WIRELESS:
2094	default:
2095		/* Should never happen */
2096		return 1;
2097	}
2098}
2099
2100static unsigned int
2101xhci_get_largest_overhead(struct xhci_interval_bw *interval_bw)
2102{
2103	if (interval_bw->overhead[LS_OVERHEAD_TYPE])
2104		return LS_OVERHEAD;
2105	if (interval_bw->overhead[FS_OVERHEAD_TYPE])
2106		return FS_OVERHEAD;
2107	return HS_OVERHEAD;
2108}
2109
2110/* If we are changing a LS/FS device under a HS hub,
2111 * make sure (if we are activating a new TT) that the HS bus has enough
2112 * bandwidth for this new TT.
2113 */
2114static int xhci_check_tt_bw_table(struct xhci_hcd *xhci,
2115		struct xhci_virt_device *virt_dev,
2116		int old_active_eps)
2117{
2118	struct xhci_interval_bw_table *bw_table;
2119	struct xhci_tt_bw_info *tt_info;
2120
2121	/* Find the bandwidth table for the root port this TT is attached to. */
2122	bw_table = &xhci->rh_bw[virt_dev->real_port - 1].bw_table;
2123	tt_info = virt_dev->tt_info;
2124	/* If this TT already had active endpoints, the bandwidth for this TT
2125	 * has already been added.  Removing all periodic endpoints (and thus
2126	 * making the TT enactive) will only decrease the bandwidth used.
2127	 */
2128	if (old_active_eps)
2129		return 0;
2130	if (old_active_eps == 0 && tt_info->active_eps != 0) {
2131		if (bw_table->bw_used + TT_HS_OVERHEAD > HS_BW_LIMIT)
2132			return -ENOMEM;
2133		return 0;
2134	}
2135	/* Not sure why we would have no new active endpoints...
2136	 *
2137	 * Maybe because of an Evaluate Context change for a hub update or a
2138	 * control endpoint 0 max packet size change?
2139	 * FIXME: skip the bandwidth calculation in that case.
2140	 */
2141	return 0;
2142}
2143
2144static int xhci_check_ss_bw(struct xhci_hcd *xhci,
2145		struct xhci_virt_device *virt_dev)
2146{
2147	unsigned int bw_reserved;
2148
2149	bw_reserved = DIV_ROUND_UP(SS_BW_RESERVED*SS_BW_LIMIT_IN, 100);
2150	if (virt_dev->bw_table->ss_bw_in > (SS_BW_LIMIT_IN - bw_reserved))
2151		return -ENOMEM;
2152
2153	bw_reserved = DIV_ROUND_UP(SS_BW_RESERVED*SS_BW_LIMIT_OUT, 100);
2154	if (virt_dev->bw_table->ss_bw_out > (SS_BW_LIMIT_OUT - bw_reserved))
2155		return -ENOMEM;
2156
2157	return 0;
2158}
2159
2160/*
2161 * This algorithm is a very conservative estimate of the worst-case scheduling
2162 * scenario for any one interval.  The hardware dynamically schedules the
2163 * packets, so we can't tell which microframe could be the limiting factor in
2164 * the bandwidth scheduling.  This only takes into account periodic endpoints.
2165 *
2166 * Obviously, we can't solve an NP complete problem to find the minimum worst
2167 * case scenario.  Instead, we come up with an estimate that is no less than
2168 * the worst case bandwidth used for any one microframe, but may be an
2169 * over-estimate.
2170 *
2171 * We walk the requirements for each endpoint by interval, starting with the
2172 * smallest interval, and place packets in the schedule where there is only one
2173 * possible way to schedule packets for that interval.  In order to simplify
2174 * this algorithm, we record the largest max packet size for each interval, and
2175 * assume all packets will be that size.
2176 *
2177 * For interval 0, we obviously must schedule all packets for each interval.
2178 * The bandwidth for interval 0 is just the amount of data to be transmitted
2179 * (the sum of all max ESIT payload sizes, plus any overhead per packet times
2180 * the number of packets).
2181 *
2182 * For interval 1, we have two possible microframes to schedule those packets
2183 * in.  For this algorithm, if we can schedule the same number of packets for
2184 * each possible scheduling opportunity (each microframe), we will do so.  The
2185 * remaining number of packets will be saved to be transmitted in the gaps in
2186 * the next interval's scheduling sequence.
2187 *
2188 * As we move those remaining packets to be scheduled with interval 2 packets,
2189 * we have to double the number of remaining packets to transmit.  This is
2190 * because the intervals are actually powers of 2, and we would be transmitting
2191 * the previous interval's packets twice in this interval.  We also have to be
2192 * sure that when we look at the largest max packet size for this interval, we
2193 * also look at the largest max packet size for the remaining packets and take
2194 * the greater of the two.
2195 *
2196 * The algorithm continues to evenly distribute packets in each scheduling
2197 * opportunity, and push the remaining packets out, until we get to the last
2198 * interval.  Then those packets and their associated overhead are just added
2199 * to the bandwidth used.
2200 */
2201static int xhci_check_bw_table(struct xhci_hcd *xhci,
2202		struct xhci_virt_device *virt_dev,
2203		int old_active_eps)
2204{
2205	unsigned int bw_reserved;
2206	unsigned int max_bandwidth;
2207	unsigned int bw_used;
2208	unsigned int block_size;
2209	struct xhci_interval_bw_table *bw_table;
2210	unsigned int packet_size = 0;
2211	unsigned int overhead = 0;
2212	unsigned int packets_transmitted = 0;
2213	unsigned int packets_remaining = 0;
2214	unsigned int i;
2215
2216	if (virt_dev->udev->speed >= USB_SPEED_SUPER)
2217		return xhci_check_ss_bw(xhci, virt_dev);
2218
2219	if (virt_dev->udev->speed == USB_SPEED_HIGH) {
2220		max_bandwidth = HS_BW_LIMIT;
2221		/* Convert percent of bus BW reserved to blocks reserved */
2222		bw_reserved = DIV_ROUND_UP(HS_BW_RESERVED * max_bandwidth, 100);
2223	} else {
2224		max_bandwidth = FS_BW_LIMIT;
2225		bw_reserved = DIV_ROUND_UP(FS_BW_RESERVED * max_bandwidth, 100);
2226	}
2227
2228	bw_table = virt_dev->bw_table;
2229	/* We need to translate the max packet size and max ESIT payloads into
2230	 * the units the hardware uses.
2231	 */
2232	block_size = xhci_get_block_size(virt_dev->udev);
2233
2234	/* If we are manipulating a LS/FS device under a HS hub, double check
2235	 * that the HS bus has enough bandwidth if we are activing a new TT.
2236	 */
2237	if (virt_dev->tt_info) {
2238		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2239				"Recalculating BW for rootport %u",
2240				virt_dev->real_port);
2241		if (xhci_check_tt_bw_table(xhci, virt_dev, old_active_eps)) {
2242			xhci_warn(xhci, "Not enough bandwidth on HS bus for "
2243					"newly activated TT.\n");
2244			return -ENOMEM;
2245		}
2246		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2247				"Recalculating BW for TT slot %u port %u",
2248				virt_dev->tt_info->slot_id,
2249				virt_dev->tt_info->ttport);
2250	} else {
2251		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2252				"Recalculating BW for rootport %u",
2253				virt_dev->real_port);
2254	}
2255
2256	/* Add in how much bandwidth will be used for interval zero, or the
2257	 * rounded max ESIT payload + number of packets * largest overhead.
2258	 */
2259	bw_used = DIV_ROUND_UP(bw_table->interval0_esit_payload, block_size) +
2260		bw_table->interval_bw[0].num_packets *
2261		xhci_get_largest_overhead(&bw_table->interval_bw[0]);
2262
2263	for (i = 1; i < XHCI_MAX_INTERVAL; i++) {
2264		unsigned int bw_added;
2265		unsigned int largest_mps;
2266		unsigned int interval_overhead;
2267
2268		/*
2269		 * How many packets could we transmit in this interval?
2270		 * If packets didn't fit in the previous interval, we will need
2271		 * to transmit that many packets twice within this interval.
2272		 */
2273		packets_remaining = 2 * packets_remaining +
2274			bw_table->interval_bw[i].num_packets;
2275
2276		/* Find the largest max packet size of this or the previous
2277		 * interval.
2278		 */
2279		if (list_empty(&bw_table->interval_bw[i].endpoints))
2280			largest_mps = 0;
2281		else {
2282			struct xhci_virt_ep *virt_ep;
2283			struct list_head *ep_entry;
2284
2285			ep_entry = bw_table->interval_bw[i].endpoints.next;
2286			virt_ep = list_entry(ep_entry,
2287					struct xhci_virt_ep, bw_endpoint_list);
2288			/* Convert to blocks, rounding up */
2289			largest_mps = DIV_ROUND_UP(
2290					virt_ep->bw_info.max_packet_size,
2291					block_size);
2292		}
2293		if (largest_mps > packet_size)
2294			packet_size = largest_mps;
2295
2296		/* Use the larger overhead of this or the previous interval. */
2297		interval_overhead = xhci_get_largest_overhead(
2298				&bw_table->interval_bw[i]);
2299		if (interval_overhead > overhead)
2300			overhead = interval_overhead;
2301
2302		/* How many packets can we evenly distribute across
2303		 * (1 << (i + 1)) possible scheduling opportunities?
2304		 */
2305		packets_transmitted = packets_remaining >> (i + 1);
2306
2307		/* Add in the bandwidth used for those scheduled packets */
2308		bw_added = packets_transmitted * (overhead + packet_size);
2309
2310		/* How many packets do we have remaining to transmit? */
2311		packets_remaining = packets_remaining % (1 << (i + 1));
2312
2313		/* What largest max packet size should those packets have? */
2314		/* If we've transmitted all packets, don't carry over the
2315		 * largest packet size.
2316		 */
2317		if (packets_remaining == 0) {
2318			packet_size = 0;
2319			overhead = 0;
2320		} else if (packets_transmitted > 0) {
2321			/* Otherwise if we do have remaining packets, and we've
2322			 * scheduled some packets in this interval, take the
2323			 * largest max packet size from endpoints with this
2324			 * interval.
2325			 */
2326			packet_size = largest_mps;
2327			overhead = interval_overhead;
2328		}
2329		/* Otherwise carry over packet_size and overhead from the last
2330		 * time we had a remainder.
2331		 */
2332		bw_used += bw_added;
2333		if (bw_used > max_bandwidth) {
2334			xhci_warn(xhci, "Not enough bandwidth. "
2335					"Proposed: %u, Max: %u\n",
2336				bw_used, max_bandwidth);
2337			return -ENOMEM;
2338		}
2339	}
2340	/*
2341	 * Ok, we know we have some packets left over after even-handedly
2342	 * scheduling interval 15.  We don't know which microframes they will
2343	 * fit into, so we over-schedule and say they will be scheduled every
2344	 * microframe.
2345	 */
2346	if (packets_remaining > 0)
2347		bw_used += overhead + packet_size;
2348
2349	if (!virt_dev->tt_info && virt_dev->udev->speed == USB_SPEED_HIGH) {
2350		unsigned int port_index = virt_dev->real_port - 1;
2351
2352		/* OK, we're manipulating a HS device attached to a
2353		 * root port bandwidth domain.  Include the number of active TTs
2354		 * in the bandwidth used.
2355		 */
2356		bw_used += TT_HS_OVERHEAD *
2357			xhci->rh_bw[port_index].num_active_tts;
2358	}
2359
2360	xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2361		"Final bandwidth: %u, Limit: %u, Reserved: %u, "
2362		"Available: %u " "percent",
2363		bw_used, max_bandwidth, bw_reserved,
2364		(max_bandwidth - bw_used - bw_reserved) * 100 /
2365		max_bandwidth);
2366
2367	bw_used += bw_reserved;
2368	if (bw_used > max_bandwidth) {
2369		xhci_warn(xhci, "Not enough bandwidth. Proposed: %u, Max: %u\n",
2370				bw_used, max_bandwidth);
2371		return -ENOMEM;
2372	}
2373
2374	bw_table->bw_used = bw_used;
2375	return 0;
2376}
2377
2378static bool xhci_is_async_ep(unsigned int ep_type)
2379{
2380	return (ep_type != ISOC_OUT_EP && ep_type != INT_OUT_EP &&
2381					ep_type != ISOC_IN_EP &&
2382					ep_type != INT_IN_EP);
2383}
2384
2385static bool xhci_is_sync_in_ep(unsigned int ep_type)
2386{
2387	return (ep_type == ISOC_IN_EP || ep_type == INT_IN_EP);
2388}
2389
2390static unsigned int xhci_get_ss_bw_consumed(struct xhci_bw_info *ep_bw)
2391{
2392	unsigned int mps = DIV_ROUND_UP(ep_bw->max_packet_size, SS_BLOCK);
2393
2394	if (ep_bw->ep_interval == 0)
2395		return SS_OVERHEAD_BURST +
2396			(ep_bw->mult * ep_bw->num_packets *
2397					(SS_OVERHEAD + mps));
2398	return DIV_ROUND_UP(ep_bw->mult * ep_bw->num_packets *
2399				(SS_OVERHEAD + mps + SS_OVERHEAD_BURST),
2400				1 << ep_bw->ep_interval);
2401
2402}
2403
2404void xhci_drop_ep_from_interval_table(struct xhci_hcd *xhci,
2405		struct xhci_bw_info *ep_bw,
2406		struct xhci_interval_bw_table *bw_table,
2407		struct usb_device *udev,
2408		struct xhci_virt_ep *virt_ep,
2409		struct xhci_tt_bw_info *tt_info)
2410{
2411	struct xhci_interval_bw	*interval_bw;
2412	int normalized_interval;
2413
2414	if (xhci_is_async_ep(ep_bw->type))
2415		return;
2416
2417	if (udev->speed >= USB_SPEED_SUPER) {
2418		if (xhci_is_sync_in_ep(ep_bw->type))
2419			xhci->devs[udev->slot_id]->bw_table->ss_bw_in -=
2420				xhci_get_ss_bw_consumed(ep_bw);
2421		else
2422			xhci->devs[udev->slot_id]->bw_table->ss_bw_out -=
2423				xhci_get_ss_bw_consumed(ep_bw);
2424		return;
2425	}
2426
2427	/* SuperSpeed endpoints never get added to intervals in the table, so
2428	 * this check is only valid for HS/FS/LS devices.
2429	 */
2430	if (list_empty(&virt_ep->bw_endpoint_list))
2431		return;
2432	/* For LS/FS devices, we need to translate the interval expressed in
2433	 * microframes to frames.
2434	 */
2435	if (udev->speed == USB_SPEED_HIGH)
2436		normalized_interval = ep_bw->ep_interval;
2437	else
2438		normalized_interval = ep_bw->ep_interval - 3;
2439
2440	if (normalized_interval == 0)
2441		bw_table->interval0_esit_payload -= ep_bw->max_esit_payload;
2442	interval_bw = &bw_table->interval_bw[normalized_interval];
2443	interval_bw->num_packets -= ep_bw->num_packets;
2444	switch (udev->speed) {
2445	case USB_SPEED_LOW:
2446		interval_bw->overhead[LS_OVERHEAD_TYPE] -= 1;
2447		break;
2448	case USB_SPEED_FULL:
2449		interval_bw->overhead[FS_OVERHEAD_TYPE] -= 1;
2450		break;
2451	case USB_SPEED_HIGH:
2452		interval_bw->overhead[HS_OVERHEAD_TYPE] -= 1;
2453		break;
2454	case USB_SPEED_SUPER:
2455	case USB_SPEED_SUPER_PLUS:
2456	case USB_SPEED_UNKNOWN:
2457	case USB_SPEED_WIRELESS:
2458		/* Should never happen because only LS/FS/HS endpoints will get
2459		 * added to the endpoint list.
2460		 */
2461		return;
2462	}
2463	if (tt_info)
2464		tt_info->active_eps -= 1;
2465	list_del_init(&virt_ep->bw_endpoint_list);
2466}
2467
2468static void xhci_add_ep_to_interval_table(struct xhci_hcd *xhci,
2469		struct xhci_bw_info *ep_bw,
2470		struct xhci_interval_bw_table *bw_table,
2471		struct usb_device *udev,
2472		struct xhci_virt_ep *virt_ep,
2473		struct xhci_tt_bw_info *tt_info)
2474{
2475	struct xhci_interval_bw	*interval_bw;
2476	struct xhci_virt_ep *smaller_ep;
2477	int normalized_interval;
2478
2479	if (xhci_is_async_ep(ep_bw->type))
2480		return;
2481
2482	if (udev->speed == USB_SPEED_SUPER) {
2483		if (xhci_is_sync_in_ep(ep_bw->type))
2484			xhci->devs[udev->slot_id]->bw_table->ss_bw_in +=
2485				xhci_get_ss_bw_consumed(ep_bw);
2486		else
2487			xhci->devs[udev->slot_id]->bw_table->ss_bw_out +=
2488				xhci_get_ss_bw_consumed(ep_bw);
2489		return;
2490	}
2491
2492	/* For LS/FS devices, we need to translate the interval expressed in
2493	 * microframes to frames.
2494	 */
2495	if (udev->speed == USB_SPEED_HIGH)
2496		normalized_interval = ep_bw->ep_interval;
2497	else
2498		normalized_interval = ep_bw->ep_interval - 3;
2499
2500	if (normalized_interval == 0)
2501		bw_table->interval0_esit_payload += ep_bw->max_esit_payload;
2502	interval_bw = &bw_table->interval_bw[normalized_interval];
2503	interval_bw->num_packets += ep_bw->num_packets;
2504	switch (udev->speed) {
2505	case USB_SPEED_LOW:
2506		interval_bw->overhead[LS_OVERHEAD_TYPE] += 1;
2507		break;
2508	case USB_SPEED_FULL:
2509		interval_bw->overhead[FS_OVERHEAD_TYPE] += 1;
2510		break;
2511	case USB_SPEED_HIGH:
2512		interval_bw->overhead[HS_OVERHEAD_TYPE] += 1;
2513		break;
2514	case USB_SPEED_SUPER:
2515	case USB_SPEED_SUPER_PLUS:
2516	case USB_SPEED_UNKNOWN:
2517	case USB_SPEED_WIRELESS:
2518		/* Should never happen because only LS/FS/HS endpoints will get
2519		 * added to the endpoint list.
2520		 */
2521		return;
2522	}
2523
2524	if (tt_info)
2525		tt_info->active_eps += 1;
2526	/* Insert the endpoint into the list, largest max packet size first. */
2527	list_for_each_entry(smaller_ep, &interval_bw->endpoints,
2528			bw_endpoint_list) {
2529		if (ep_bw->max_packet_size >=
2530				smaller_ep->bw_info.max_packet_size) {
2531			/* Add the new ep before the smaller endpoint */
2532			list_add_tail(&virt_ep->bw_endpoint_list,
2533					&smaller_ep->bw_endpoint_list);
2534			return;
2535		}
2536	}
2537	/* Add the new endpoint at the end of the list. */
2538	list_add_tail(&virt_ep->bw_endpoint_list,
2539			&interval_bw->endpoints);
2540}
2541
2542void xhci_update_tt_active_eps(struct xhci_hcd *xhci,
2543		struct xhci_virt_device *virt_dev,
2544		int old_active_eps)
2545{
2546	struct xhci_root_port_bw_info *rh_bw_info;
2547	if (!virt_dev->tt_info)
2548		return;
2549
2550	rh_bw_info = &xhci->rh_bw[virt_dev->real_port - 1];
2551	if (old_active_eps == 0 &&
2552				virt_dev->tt_info->active_eps != 0) {
2553		rh_bw_info->num_active_tts += 1;
2554		rh_bw_info->bw_table.bw_used += TT_HS_OVERHEAD;
2555	} else if (old_active_eps != 0 &&
2556				virt_dev->tt_info->active_eps == 0) {
2557		rh_bw_info->num_active_tts -= 1;
2558		rh_bw_info->bw_table.bw_used -= TT_HS_OVERHEAD;
2559	}
2560}
2561
2562static int xhci_reserve_bandwidth(struct xhci_hcd *xhci,
2563		struct xhci_virt_device *virt_dev,
2564		struct xhci_container_ctx *in_ctx)
2565{
2566	struct xhci_bw_info ep_bw_info[31];
2567	int i;
2568	struct xhci_input_control_ctx *ctrl_ctx;
2569	int old_active_eps = 0;
2570
2571	if (virt_dev->tt_info)
2572		old_active_eps = virt_dev->tt_info->active_eps;
2573
2574	ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
2575	if (!ctrl_ctx) {
2576		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
2577				__func__);
2578		return -ENOMEM;
2579	}
2580
2581	for (i = 0; i < 31; i++) {
2582		if (!EP_IS_ADDED(ctrl_ctx, i) && !EP_IS_DROPPED(ctrl_ctx, i))
2583			continue;
2584
2585		/* Make a copy of the BW info in case we need to revert this */
2586		memcpy(&ep_bw_info[i], &virt_dev->eps[i].bw_info,
2587				sizeof(ep_bw_info[i]));
2588		/* Drop the endpoint from the interval table if the endpoint is
2589		 * being dropped or changed.
2590		 */
2591		if (EP_IS_DROPPED(ctrl_ctx, i))
2592			xhci_drop_ep_from_interval_table(xhci,
2593					&virt_dev->eps[i].bw_info,
2594					virt_dev->bw_table,
2595					virt_dev->udev,
2596					&virt_dev->eps[i],
2597					virt_dev->tt_info);
2598	}
2599	/* Overwrite the information stored in the endpoints' bw_info */
2600	xhci_update_bw_info(xhci, virt_dev->in_ctx, ctrl_ctx, virt_dev);
2601	for (i = 0; i < 31; i++) {
2602		/* Add any changed or added endpoints to the interval table */
2603		if (EP_IS_ADDED(ctrl_ctx, i))
2604			xhci_add_ep_to_interval_table(xhci,
2605					&virt_dev->eps[i].bw_info,
2606					virt_dev->bw_table,
2607					virt_dev->udev,
2608					&virt_dev->eps[i],
2609					virt_dev->tt_info);
2610	}
2611
2612	if (!xhci_check_bw_table(xhci, virt_dev, old_active_eps)) {
2613		/* Ok, this fits in the bandwidth we have.
2614		 * Update the number of active TTs.
2615		 */
2616		xhci_update_tt_active_eps(xhci, virt_dev, old_active_eps);
2617		return 0;
2618	}
2619
2620	/* We don't have enough bandwidth for this, revert the stored info. */
2621	for (i = 0; i < 31; i++) {
2622		if (!EP_IS_ADDED(ctrl_ctx, i) && !EP_IS_DROPPED(ctrl_ctx, i))
2623			continue;
2624
2625		/* Drop the new copies of any added or changed endpoints from
2626		 * the interval table.
2627		 */
2628		if (EP_IS_ADDED(ctrl_ctx, i)) {
2629			xhci_drop_ep_from_interval_table(xhci,
2630					&virt_dev->eps[i].bw_info,
2631					virt_dev->bw_table,
2632					virt_dev->udev,
2633					&virt_dev->eps[i],
2634					virt_dev->tt_info);
2635		}
2636		/* Revert the endpoint back to its old information */
2637		memcpy(&virt_dev->eps[i].bw_info, &ep_bw_info[i],
2638				sizeof(ep_bw_info[i]));
2639		/* Add any changed or dropped endpoints back into the table */
2640		if (EP_IS_DROPPED(ctrl_ctx, i))
2641			xhci_add_ep_to_interval_table(xhci,
2642					&virt_dev->eps[i].bw_info,
2643					virt_dev->bw_table,
2644					virt_dev->udev,
2645					&virt_dev->eps[i],
2646					virt_dev->tt_info);
2647	}
2648	return -ENOMEM;
2649}
2650
2651
2652/* Issue a configure endpoint command or evaluate context command
2653 * and wait for it to finish.
2654 */
2655static int xhci_configure_endpoint(struct xhci_hcd *xhci,
2656		struct usb_device *udev,
2657		struct xhci_command *command,
2658		bool ctx_change, bool must_succeed)
2659{
2660	int ret;
 
2661	unsigned long flags;
2662	struct xhci_input_control_ctx *ctrl_ctx;
 
 
2663	struct xhci_virt_device *virt_dev;
2664
2665	if (!command)
2666		return -EINVAL;
2667
2668	spin_lock_irqsave(&xhci->lock, flags);
2669	virt_dev = xhci->devs[udev->slot_id];
2670
2671	ctrl_ctx = xhci_get_input_control_ctx(command->in_ctx);
2672	if (!ctrl_ctx) {
2673		spin_unlock_irqrestore(&xhci->lock, flags);
2674		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
2675				__func__);
2676		return -ENOMEM;
2677	}
2678
2679	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK) &&
2680			xhci_reserve_host_resources(xhci, ctrl_ctx)) {
2681		spin_unlock_irqrestore(&xhci->lock, flags);
2682		xhci_warn(xhci, "Not enough host resources, "
2683				"active endpoint contexts = %u\n",
2684				xhci->num_active_eps);
2685		return -ENOMEM;
2686	}
2687	if ((xhci->quirks & XHCI_SW_BW_CHECKING) &&
2688	    xhci_reserve_bandwidth(xhci, virt_dev, command->in_ctx)) {
2689		if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK))
2690			xhci_free_host_resources(xhci, ctrl_ctx);
2691		spin_unlock_irqrestore(&xhci->lock, flags);
2692		xhci_warn(xhci, "Not enough bandwidth\n");
2693		return -ENOMEM;
2694	}
2695
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2696	if (!ctx_change)
2697		ret = xhci_queue_configure_endpoint(xhci, command,
2698				command->in_ctx->dma,
2699				udev->slot_id, must_succeed);
2700	else
2701		ret = xhci_queue_evaluate_context(xhci, command,
2702				command->in_ctx->dma,
2703				udev->slot_id, must_succeed);
2704	if (ret < 0) {
 
 
2705		if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK))
2706			xhci_free_host_resources(xhci, ctrl_ctx);
2707		spin_unlock_irqrestore(&xhci->lock, flags);
2708		xhci_dbg_trace(xhci,  trace_xhci_dbg_context_change,
2709				"FIXME allocate a new ring segment");
2710		return -ENOMEM;
2711	}
2712	xhci_ring_cmd_db(xhci);
2713	spin_unlock_irqrestore(&xhci->lock, flags);
2714
2715	/* Wait for the configure endpoint command to complete */
2716	wait_for_completion(command->completion);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2717
2718	if (!ctx_change)
2719		ret = xhci_configure_endpoint_result(xhci, udev,
2720						     &command->status);
2721	else
2722		ret = xhci_evaluate_context_result(xhci, udev,
2723						   &command->status);
2724
2725	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
2726		spin_lock_irqsave(&xhci->lock, flags);
2727		/* If the command failed, remove the reserved resources.
2728		 * Otherwise, clean up the estimate to include dropped eps.
2729		 */
2730		if (ret)
2731			xhci_free_host_resources(xhci, ctrl_ctx);
2732		else
2733			xhci_finish_resource_reservation(xhci, ctrl_ctx);
2734		spin_unlock_irqrestore(&xhci->lock, flags);
2735	}
2736	return ret;
2737}
2738
2739static void xhci_check_bw_drop_ep_streams(struct xhci_hcd *xhci,
2740	struct xhci_virt_device *vdev, int i)
2741{
2742	struct xhci_virt_ep *ep = &vdev->eps[i];
2743
2744	if (ep->ep_state & EP_HAS_STREAMS) {
2745		xhci_warn(xhci, "WARN: endpoint 0x%02x has streams on set_interface, freeing streams.\n",
2746				xhci_get_endpoint_address(i));
2747		xhci_free_stream_info(xhci, ep->stream_info);
2748		ep->stream_info = NULL;
2749		ep->ep_state &= ~EP_HAS_STREAMS;
2750	}
2751}
2752
2753/* Called after one or more calls to xhci_add_endpoint() or
2754 * xhci_drop_endpoint().  If this call fails, the USB core is expected
2755 * to call xhci_reset_bandwidth().
2756 *
2757 * Since we are in the middle of changing either configuration or
2758 * installing a new alt setting, the USB core won't allow URBs to be
2759 * enqueued for any endpoint on the old config or interface.  Nothing
2760 * else should be touching the xhci->devs[slot_id] structure, so we
2761 * don't need to take the xhci->lock for manipulating that.
2762 */
2763int xhci_check_bandwidth(struct usb_hcd *hcd, struct usb_device *udev)
2764{
2765	int i;
2766	int ret = 0;
2767	struct xhci_hcd *xhci;
2768	struct xhci_virt_device	*virt_dev;
2769	struct xhci_input_control_ctx *ctrl_ctx;
2770	struct xhci_slot_ctx *slot_ctx;
2771	struct xhci_command *command;
2772
2773	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
2774	if (ret <= 0)
2775		return ret;
2776	xhci = hcd_to_xhci(hcd);
2777	if ((xhci->xhc_state & XHCI_STATE_DYING) ||
2778		(xhci->xhc_state & XHCI_STATE_REMOVING))
2779		return -ENODEV;
2780
2781	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
2782	virt_dev = xhci->devs[udev->slot_id];
2783
2784	command = xhci_alloc_command(xhci, false, true, GFP_KERNEL);
2785	if (!command)
2786		return -ENOMEM;
2787
2788	command->in_ctx = virt_dev->in_ctx;
2789
2790	/* See section 4.6.6 - A0 = 1; A1 = D0 = D1 = 0 */
2791	ctrl_ctx = xhci_get_input_control_ctx(command->in_ctx);
2792	if (!ctrl_ctx) {
2793		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
2794				__func__);
2795		ret = -ENOMEM;
2796		goto command_cleanup;
2797	}
2798	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
2799	ctrl_ctx->add_flags &= cpu_to_le32(~EP0_FLAG);
2800	ctrl_ctx->drop_flags &= cpu_to_le32(~(SLOT_FLAG | EP0_FLAG));
2801
2802	/* Don't issue the command if there's no endpoints to update. */
2803	if (ctrl_ctx->add_flags == cpu_to_le32(SLOT_FLAG) &&
2804	    ctrl_ctx->drop_flags == 0) {
2805		ret = 0;
2806		goto command_cleanup;
2807	}
2808	/* Fix up Context Entries field. Minimum value is EP0 == BIT(1). */
2809	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
2810	for (i = 31; i >= 1; i--) {
2811		__le32 le32 = cpu_to_le32(BIT(i));
2812
2813		if ((virt_dev->eps[i-1].ring && !(ctrl_ctx->drop_flags & le32))
2814		    || (ctrl_ctx->add_flags & le32) || i == 1) {
2815			slot_ctx->dev_info &= cpu_to_le32(~LAST_CTX_MASK);
2816			slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(i));
2817			break;
2818		}
2819	}
2820	xhci_dbg(xhci, "New Input Control Context:\n");
 
2821	xhci_dbg_ctx(xhci, virt_dev->in_ctx,
2822		     LAST_CTX_TO_EP_NUM(le32_to_cpu(slot_ctx->dev_info)));
2823
2824	ret = xhci_configure_endpoint(xhci, udev, command,
2825			false, false);
2826	if (ret)
2827		/* Callee should call reset_bandwidth() */
2828		goto command_cleanup;
 
2829
2830	xhci_dbg(xhci, "Output context after successful config ep cmd:\n");
2831	xhci_dbg_ctx(xhci, virt_dev->out_ctx,
2832		     LAST_CTX_TO_EP_NUM(le32_to_cpu(slot_ctx->dev_info)));
2833
2834	/* Free any rings that were dropped, but not changed. */
2835	for (i = 1; i < 31; ++i) {
2836		if ((le32_to_cpu(ctrl_ctx->drop_flags) & (1 << (i + 1))) &&
2837		    !(le32_to_cpu(ctrl_ctx->add_flags) & (1 << (i + 1)))) {
2838			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
2839			xhci_check_bw_drop_ep_streams(xhci, virt_dev, i);
2840		}
2841	}
2842	xhci_zero_in_ctx(xhci, virt_dev);
2843	/*
2844	 * Install any rings for completely new endpoints or changed endpoints,
2845	 * and free or cache any old rings from changed endpoints.
2846	 */
2847	for (i = 1; i < 31; ++i) {
2848		if (!virt_dev->eps[i].new_ring)
2849			continue;
2850		/* Only cache or free the old ring if it exists.
2851		 * It may not if this is the first add of an endpoint.
2852		 */
2853		if (virt_dev->eps[i].ring) {
2854			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
2855		}
2856		xhci_check_bw_drop_ep_streams(xhci, virt_dev, i);
2857		virt_dev->eps[i].ring = virt_dev->eps[i].new_ring;
2858		virt_dev->eps[i].new_ring = NULL;
2859	}
2860command_cleanup:
2861	kfree(command->completion);
2862	kfree(command);
2863
2864	return ret;
2865}
2866
2867void xhci_reset_bandwidth(struct usb_hcd *hcd, struct usb_device *udev)
2868{
2869	struct xhci_hcd *xhci;
2870	struct xhci_virt_device	*virt_dev;
2871	int i, ret;
2872
2873	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
2874	if (ret <= 0)
2875		return;
2876	xhci = hcd_to_xhci(hcd);
2877
2878	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
2879	virt_dev = xhci->devs[udev->slot_id];
2880	/* Free any rings allocated for added endpoints */
2881	for (i = 0; i < 31; ++i) {
2882		if (virt_dev->eps[i].new_ring) {
2883			xhci_ring_free(xhci, virt_dev->eps[i].new_ring);
2884			virt_dev->eps[i].new_ring = NULL;
2885		}
2886	}
2887	xhci_zero_in_ctx(xhci, virt_dev);
2888}
2889
2890static void xhci_setup_input_ctx_for_config_ep(struct xhci_hcd *xhci,
2891		struct xhci_container_ctx *in_ctx,
2892		struct xhci_container_ctx *out_ctx,
2893		struct xhci_input_control_ctx *ctrl_ctx,
2894		u32 add_flags, u32 drop_flags)
2895{
 
 
2896	ctrl_ctx->add_flags = cpu_to_le32(add_flags);
2897	ctrl_ctx->drop_flags = cpu_to_le32(drop_flags);
2898	xhci_slot_copy(xhci, in_ctx, out_ctx);
2899	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
2900
2901	xhci_dbg(xhci, "Input Context:\n");
2902	xhci_dbg_ctx(xhci, in_ctx, xhci_last_valid_endpoint(add_flags));
2903}
2904
2905static void xhci_setup_input_ctx_for_quirk(struct xhci_hcd *xhci,
2906		unsigned int slot_id, unsigned int ep_index,
2907		struct xhci_dequeue_state *deq_state)
2908{
2909	struct xhci_input_control_ctx *ctrl_ctx;
2910	struct xhci_container_ctx *in_ctx;
2911	struct xhci_ep_ctx *ep_ctx;
2912	u32 added_ctxs;
2913	dma_addr_t addr;
2914
2915	in_ctx = xhci->devs[slot_id]->in_ctx;
2916	ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
2917	if (!ctrl_ctx) {
2918		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
2919				__func__);
2920		return;
2921	}
2922
2923	xhci_endpoint_copy(xhci, xhci->devs[slot_id]->in_ctx,
2924			xhci->devs[slot_id]->out_ctx, ep_index);
 
2925	ep_ctx = xhci_get_ep_ctx(xhci, in_ctx, ep_index);
2926	addr = xhci_trb_virt_to_dma(deq_state->new_deq_seg,
2927			deq_state->new_deq_ptr);
2928	if (addr == 0) {
2929		xhci_warn(xhci, "WARN Cannot submit config ep after "
2930				"reset ep command\n");
2931		xhci_warn(xhci, "WARN deq seg = %p, deq ptr = %p\n",
2932				deq_state->new_deq_seg,
2933				deq_state->new_deq_ptr);
2934		return;
2935	}
2936	ep_ctx->deq = cpu_to_le64(addr | deq_state->new_cycle_state);
2937
2938	added_ctxs = xhci_get_endpoint_flag_from_index(ep_index);
2939	xhci_setup_input_ctx_for_config_ep(xhci, xhci->devs[slot_id]->in_ctx,
2940			xhci->devs[slot_id]->out_ctx, ctrl_ctx,
2941			added_ctxs, added_ctxs);
2942}
2943
2944void xhci_cleanup_stalled_ring(struct xhci_hcd *xhci,
2945			unsigned int ep_index, struct xhci_td *td)
2946{
2947	struct xhci_dequeue_state deq_state;
2948	struct xhci_virt_ep *ep;
2949	struct usb_device *udev = td->urb->dev;
2950
2951	xhci_dbg_trace(xhci, trace_xhci_dbg_reset_ep,
2952			"Cleaning up stalled endpoint ring");
2953	ep = &xhci->devs[udev->slot_id]->eps[ep_index];
2954	/* We need to move the HW's dequeue pointer past this TD,
2955	 * or it will attempt to resend it on the next doorbell ring.
2956	 */
2957	xhci_find_new_dequeue_state(xhci, udev->slot_id,
2958			ep_index, ep->stopped_stream, td, &deq_state);
2959
2960	if (!deq_state.new_deq_ptr || !deq_state.new_deq_seg)
2961		return;
2962
2963	/* HW with the reset endpoint quirk will use the saved dequeue state to
2964	 * issue a configure endpoint command later.
2965	 */
2966	if (!(xhci->quirks & XHCI_RESET_EP_QUIRK)) {
2967		xhci_dbg_trace(xhci, trace_xhci_dbg_reset_ep,
2968				"Queueing new dequeue state");
2969		xhci_queue_new_dequeue_state(xhci, udev->slot_id,
2970				ep_index, ep->stopped_stream, &deq_state);
2971	} else {
2972		/* Better hope no one uses the input context between now and the
2973		 * reset endpoint completion!
2974		 * XXX: No idea how this hardware will react when stream rings
2975		 * are enabled.
2976		 */
2977		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
2978				"Setting up input context for "
2979				"configure endpoint command");
2980		xhci_setup_input_ctx_for_quirk(xhci, udev->slot_id,
2981				ep_index, &deq_state);
2982	}
2983}
2984
2985/* Called when clearing halted device. The core should have sent the control
2986 * message to clear the device halt condition. The host side of the halt should
2987 * already be cleared with a reset endpoint command issued when the STALL tx
2988 * event was received.
2989 *
2990 * Context: in_interrupt
2991 */
2992
2993void xhci_endpoint_reset(struct usb_hcd *hcd,
2994		struct usb_host_endpoint *ep)
2995{
2996	struct xhci_hcd *xhci;
 
 
 
 
 
2997
2998	xhci = hcd_to_xhci(hcd);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2999
 
 
 
3000	/*
3001	 * We might need to implement the config ep cmd in xhci 4.8.1 note:
3002	 * The Reset Endpoint Command may only be issued to endpoints in the
3003	 * Halted state. If software wishes reset the Data Toggle or Sequence
3004	 * Number of an endpoint that isn't in the Halted state, then software
3005	 * may issue a Configure Endpoint Command with the Drop and Add bits set
3006	 * for the target endpoint. that is in the Stopped state.
3007	 */
 
 
 
 
 
 
 
 
 
3008
3009	/* For now just print debug to follow the situation */
3010	xhci_dbg(xhci, "Endpoint 0x%x ep reset callback called\n",
3011		 ep->desc.bEndpointAddress);
3012}
3013
3014static int xhci_check_streams_endpoint(struct xhci_hcd *xhci,
3015		struct usb_device *udev, struct usb_host_endpoint *ep,
3016		unsigned int slot_id)
3017{
3018	int ret;
3019	unsigned int ep_index;
3020	unsigned int ep_state;
3021
3022	if (!ep)
3023		return -EINVAL;
3024	ret = xhci_check_args(xhci_to_hcd(xhci), udev, ep, 1, true, __func__);
3025	if (ret <= 0)
3026		return -EINVAL;
3027	if (usb_ss_max_streams(&ep->ss_ep_comp) == 0) {
3028		xhci_warn(xhci, "WARN: SuperSpeed Endpoint Companion"
3029				" descriptor for ep 0x%x does not support streams\n",
3030				ep->desc.bEndpointAddress);
3031		return -EINVAL;
3032	}
3033
3034	ep_index = xhci_get_endpoint_index(&ep->desc);
3035	ep_state = xhci->devs[slot_id]->eps[ep_index].ep_state;
3036	if (ep_state & EP_HAS_STREAMS ||
3037			ep_state & EP_GETTING_STREAMS) {
3038		xhci_warn(xhci, "WARN: SuperSpeed bulk endpoint 0x%x "
3039				"already has streams set up.\n",
3040				ep->desc.bEndpointAddress);
3041		xhci_warn(xhci, "Send email to xHCI maintainer and ask for "
3042				"dynamic stream context array reallocation.\n");
3043		return -EINVAL;
3044	}
3045	if (!list_empty(&xhci->devs[slot_id]->eps[ep_index].ring->td_list)) {
3046		xhci_warn(xhci, "Cannot setup streams for SuperSpeed bulk "
3047				"endpoint 0x%x; URBs are pending.\n",
3048				ep->desc.bEndpointAddress);
3049		return -EINVAL;
3050	}
3051	return 0;
3052}
3053
3054static void xhci_calculate_streams_entries(struct xhci_hcd *xhci,
3055		unsigned int *num_streams, unsigned int *num_stream_ctxs)
3056{
3057	unsigned int max_streams;
3058
3059	/* The stream context array size must be a power of two */
3060	*num_stream_ctxs = roundup_pow_of_two(*num_streams);
3061	/*
3062	 * Find out how many primary stream array entries the host controller
3063	 * supports.  Later we may use secondary stream arrays (similar to 2nd
3064	 * level page entries), but that's an optional feature for xHCI host
3065	 * controllers. xHCs must support at least 4 stream IDs.
3066	 */
3067	max_streams = HCC_MAX_PSA(xhci->hcc_params);
3068	if (*num_stream_ctxs > max_streams) {
3069		xhci_dbg(xhci, "xHCI HW only supports %u stream ctx entries.\n",
3070				max_streams);
3071		*num_stream_ctxs = max_streams;
3072		*num_streams = max_streams;
3073	}
3074}
3075
3076/* Returns an error code if one of the endpoint already has streams.
3077 * This does not change any data structures, it only checks and gathers
3078 * information.
3079 */
3080static int xhci_calculate_streams_and_bitmask(struct xhci_hcd *xhci,
3081		struct usb_device *udev,
3082		struct usb_host_endpoint **eps, unsigned int num_eps,
3083		unsigned int *num_streams, u32 *changed_ep_bitmask)
3084{
3085	unsigned int max_streams;
3086	unsigned int endpoint_flag;
3087	int i;
3088	int ret;
3089
3090	for (i = 0; i < num_eps; i++) {
3091		ret = xhci_check_streams_endpoint(xhci, udev,
3092				eps[i], udev->slot_id);
3093		if (ret < 0)
3094			return ret;
3095
3096		max_streams = usb_ss_max_streams(&eps[i]->ss_ep_comp);
3097		if (max_streams < (*num_streams - 1)) {
3098			xhci_dbg(xhci, "Ep 0x%x only supports %u stream IDs.\n",
3099					eps[i]->desc.bEndpointAddress,
3100					max_streams);
3101			*num_streams = max_streams+1;
3102		}
3103
3104		endpoint_flag = xhci_get_endpoint_flag(&eps[i]->desc);
3105		if (*changed_ep_bitmask & endpoint_flag)
3106			return -EINVAL;
3107		*changed_ep_bitmask |= endpoint_flag;
3108	}
3109	return 0;
3110}
3111
3112static u32 xhci_calculate_no_streams_bitmask(struct xhci_hcd *xhci,
3113		struct usb_device *udev,
3114		struct usb_host_endpoint **eps, unsigned int num_eps)
3115{
3116	u32 changed_ep_bitmask = 0;
3117	unsigned int slot_id;
3118	unsigned int ep_index;
3119	unsigned int ep_state;
3120	int i;
3121
3122	slot_id = udev->slot_id;
3123	if (!xhci->devs[slot_id])
3124		return 0;
3125
3126	for (i = 0; i < num_eps; i++) {
3127		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3128		ep_state = xhci->devs[slot_id]->eps[ep_index].ep_state;
3129		/* Are streams already being freed for the endpoint? */
3130		if (ep_state & EP_GETTING_NO_STREAMS) {
3131			xhci_warn(xhci, "WARN Can't disable streams for "
3132					"endpoint 0x%x, "
3133					"streams are being disabled already\n",
3134					eps[i]->desc.bEndpointAddress);
3135			return 0;
3136		}
3137		/* Are there actually any streams to free? */
3138		if (!(ep_state & EP_HAS_STREAMS) &&
3139				!(ep_state & EP_GETTING_STREAMS)) {
3140			xhci_warn(xhci, "WARN Can't disable streams for "
3141					"endpoint 0x%x, "
3142					"streams are already disabled!\n",
3143					eps[i]->desc.bEndpointAddress);
3144			xhci_warn(xhci, "WARN xhci_free_streams() called "
3145					"with non-streams endpoint\n");
3146			return 0;
3147		}
3148		changed_ep_bitmask |= xhci_get_endpoint_flag(&eps[i]->desc);
3149	}
3150	return changed_ep_bitmask;
3151}
3152
3153/*
3154 * The USB device drivers use this function (through the HCD interface in USB
3155 * core) to prepare a set of bulk endpoints to use streams.  Streams are used to
3156 * coordinate mass storage command queueing across multiple endpoints (basically
3157 * a stream ID == a task ID).
3158 *
3159 * Setting up streams involves allocating the same size stream context array
3160 * for each endpoint and issuing a configure endpoint command for all endpoints.
3161 *
3162 * Don't allow the call to succeed if one endpoint only supports one stream
3163 * (which means it doesn't support streams at all).
3164 *
3165 * Drivers may get less stream IDs than they asked for, if the host controller
3166 * hardware or endpoints claim they can't support the number of requested
3167 * stream IDs.
3168 */
3169int xhci_alloc_streams(struct usb_hcd *hcd, struct usb_device *udev,
3170		struct usb_host_endpoint **eps, unsigned int num_eps,
3171		unsigned int num_streams, gfp_t mem_flags)
3172{
3173	int i, ret;
3174	struct xhci_hcd *xhci;
3175	struct xhci_virt_device *vdev;
3176	struct xhci_command *config_cmd;
3177	struct xhci_input_control_ctx *ctrl_ctx;
3178	unsigned int ep_index;
3179	unsigned int num_stream_ctxs;
3180	unsigned long flags;
3181	u32 changed_ep_bitmask = 0;
3182
3183	if (!eps)
3184		return -EINVAL;
3185
3186	/* Add one to the number of streams requested to account for
3187	 * stream 0 that is reserved for xHCI usage.
3188	 */
3189	num_streams += 1;
3190	xhci = hcd_to_xhci(hcd);
3191	xhci_dbg(xhci, "Driver wants %u stream IDs (including stream 0).\n",
3192			num_streams);
3193
3194	/* MaxPSASize value 0 (2 streams) means streams are not supported */
3195	if ((xhci->quirks & XHCI_BROKEN_STREAMS) ||
3196			HCC_MAX_PSA(xhci->hcc_params) < 4) {
3197		xhci_dbg(xhci, "xHCI controller does not support streams.\n");
3198		return -ENOSYS;
3199	}
3200
3201	config_cmd = xhci_alloc_command(xhci, true, true, mem_flags);
3202	if (!config_cmd) {
3203		xhci_dbg(xhci, "Could not allocate xHCI command structure.\n");
3204		return -ENOMEM;
3205	}
3206	ctrl_ctx = xhci_get_input_control_ctx(config_cmd->in_ctx);
3207	if (!ctrl_ctx) {
3208		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
3209				__func__);
3210		xhci_free_command(xhci, config_cmd);
3211		return -ENOMEM;
3212	}
3213
3214	/* Check to make sure all endpoints are not already configured for
3215	 * streams.  While we're at it, find the maximum number of streams that
3216	 * all the endpoints will support and check for duplicate endpoints.
3217	 */
3218	spin_lock_irqsave(&xhci->lock, flags);
3219	ret = xhci_calculate_streams_and_bitmask(xhci, udev, eps,
3220			num_eps, &num_streams, &changed_ep_bitmask);
3221	if (ret < 0) {
3222		xhci_free_command(xhci, config_cmd);
3223		spin_unlock_irqrestore(&xhci->lock, flags);
3224		return ret;
3225	}
3226	if (num_streams <= 1) {
3227		xhci_warn(xhci, "WARN: endpoints can't handle "
3228				"more than one stream.\n");
3229		xhci_free_command(xhci, config_cmd);
3230		spin_unlock_irqrestore(&xhci->lock, flags);
3231		return -EINVAL;
3232	}
3233	vdev = xhci->devs[udev->slot_id];
3234	/* Mark each endpoint as being in transition, so
3235	 * xhci_urb_enqueue() will reject all URBs.
3236	 */
3237	for (i = 0; i < num_eps; i++) {
3238		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3239		vdev->eps[ep_index].ep_state |= EP_GETTING_STREAMS;
3240	}
3241	spin_unlock_irqrestore(&xhci->lock, flags);
3242
3243	/* Setup internal data structures and allocate HW data structures for
3244	 * streams (but don't install the HW structures in the input context
3245	 * until we're sure all memory allocation succeeded).
3246	 */
3247	xhci_calculate_streams_entries(xhci, &num_streams, &num_stream_ctxs);
3248	xhci_dbg(xhci, "Need %u stream ctx entries for %u stream IDs.\n",
3249			num_stream_ctxs, num_streams);
3250
3251	for (i = 0; i < num_eps; i++) {
3252		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3253		vdev->eps[ep_index].stream_info = xhci_alloc_stream_info(xhci,
3254				num_stream_ctxs,
3255				num_streams, mem_flags);
3256		if (!vdev->eps[ep_index].stream_info)
3257			goto cleanup;
3258		/* Set maxPstreams in endpoint context and update deq ptr to
3259		 * point to stream context array. FIXME
3260		 */
3261	}
3262
3263	/* Set up the input context for a configure endpoint command. */
3264	for (i = 0; i < num_eps; i++) {
3265		struct xhci_ep_ctx *ep_ctx;
3266
3267		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3268		ep_ctx = xhci_get_ep_ctx(xhci, config_cmd->in_ctx, ep_index);
3269
3270		xhci_endpoint_copy(xhci, config_cmd->in_ctx,
3271				vdev->out_ctx, ep_index);
3272		xhci_setup_streams_ep_input_ctx(xhci, ep_ctx,
3273				vdev->eps[ep_index].stream_info);
3274	}
3275	/* Tell the HW to drop its old copy of the endpoint context info
3276	 * and add the updated copy from the input context.
3277	 */
3278	xhci_setup_input_ctx_for_config_ep(xhci, config_cmd->in_ctx,
3279			vdev->out_ctx, ctrl_ctx,
3280			changed_ep_bitmask, changed_ep_bitmask);
3281
3282	/* Issue and wait for the configure endpoint command */
3283	ret = xhci_configure_endpoint(xhci, udev, config_cmd,
3284			false, false);
3285
3286	/* xHC rejected the configure endpoint command for some reason, so we
3287	 * leave the old ring intact and free our internal streams data
3288	 * structure.
3289	 */
3290	if (ret < 0)
3291		goto cleanup;
3292
3293	spin_lock_irqsave(&xhci->lock, flags);
3294	for (i = 0; i < num_eps; i++) {
3295		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3296		vdev->eps[ep_index].ep_state &= ~EP_GETTING_STREAMS;
3297		xhci_dbg(xhci, "Slot %u ep ctx %u now has streams.\n",
3298			 udev->slot_id, ep_index);
3299		vdev->eps[ep_index].ep_state |= EP_HAS_STREAMS;
3300	}
3301	xhci_free_command(xhci, config_cmd);
3302	spin_unlock_irqrestore(&xhci->lock, flags);
3303
3304	/* Subtract 1 for stream 0, which drivers can't use */
3305	return num_streams - 1;
3306
3307cleanup:
3308	/* If it didn't work, free the streams! */
3309	for (i = 0; i < num_eps; i++) {
3310		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3311		xhci_free_stream_info(xhci, vdev->eps[ep_index].stream_info);
3312		vdev->eps[ep_index].stream_info = NULL;
3313		/* FIXME Unset maxPstreams in endpoint context and
3314		 * update deq ptr to point to normal string ring.
3315		 */
3316		vdev->eps[ep_index].ep_state &= ~EP_GETTING_STREAMS;
3317		vdev->eps[ep_index].ep_state &= ~EP_HAS_STREAMS;
3318		xhci_endpoint_zero(xhci, vdev, eps[i]);
3319	}
3320	xhci_free_command(xhci, config_cmd);
3321	return -ENOMEM;
3322}
3323
3324/* Transition the endpoint from using streams to being a "normal" endpoint
3325 * without streams.
3326 *
3327 * Modify the endpoint context state, submit a configure endpoint command,
3328 * and free all endpoint rings for streams if that completes successfully.
3329 */
3330int xhci_free_streams(struct usb_hcd *hcd, struct usb_device *udev,
3331		struct usb_host_endpoint **eps, unsigned int num_eps,
3332		gfp_t mem_flags)
3333{
3334	int i, ret;
3335	struct xhci_hcd *xhci;
3336	struct xhci_virt_device *vdev;
3337	struct xhci_command *command;
3338	struct xhci_input_control_ctx *ctrl_ctx;
3339	unsigned int ep_index;
3340	unsigned long flags;
3341	u32 changed_ep_bitmask;
3342
3343	xhci = hcd_to_xhci(hcd);
3344	vdev = xhci->devs[udev->slot_id];
3345
3346	/* Set up a configure endpoint command to remove the streams rings */
3347	spin_lock_irqsave(&xhci->lock, flags);
3348	changed_ep_bitmask = xhci_calculate_no_streams_bitmask(xhci,
3349			udev, eps, num_eps);
3350	if (changed_ep_bitmask == 0) {
3351		spin_unlock_irqrestore(&xhci->lock, flags);
3352		return -EINVAL;
3353	}
3354
3355	/* Use the xhci_command structure from the first endpoint.  We may have
3356	 * allocated too many, but the driver may call xhci_free_streams() for
3357	 * each endpoint it grouped into one call to xhci_alloc_streams().
3358	 */
3359	ep_index = xhci_get_endpoint_index(&eps[0]->desc);
3360	command = vdev->eps[ep_index].stream_info->free_streams_command;
3361	ctrl_ctx = xhci_get_input_control_ctx(command->in_ctx);
3362	if (!ctrl_ctx) {
3363		spin_unlock_irqrestore(&xhci->lock, flags);
3364		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
3365				__func__);
3366		return -EINVAL;
3367	}
3368
3369	for (i = 0; i < num_eps; i++) {
3370		struct xhci_ep_ctx *ep_ctx;
3371
3372		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3373		ep_ctx = xhci_get_ep_ctx(xhci, command->in_ctx, ep_index);
3374		xhci->devs[udev->slot_id]->eps[ep_index].ep_state |=
3375			EP_GETTING_NO_STREAMS;
3376
3377		xhci_endpoint_copy(xhci, command->in_ctx,
3378				vdev->out_ctx, ep_index);
3379		xhci_setup_no_streams_ep_input_ctx(ep_ctx,
3380				&vdev->eps[ep_index]);
3381	}
3382	xhci_setup_input_ctx_for_config_ep(xhci, command->in_ctx,
3383			vdev->out_ctx, ctrl_ctx,
3384			changed_ep_bitmask, changed_ep_bitmask);
3385	spin_unlock_irqrestore(&xhci->lock, flags);
3386
3387	/* Issue and wait for the configure endpoint command,
3388	 * which must succeed.
3389	 */
3390	ret = xhci_configure_endpoint(xhci, udev, command,
3391			false, true);
3392
3393	/* xHC rejected the configure endpoint command for some reason, so we
3394	 * leave the streams rings intact.
3395	 */
3396	if (ret < 0)
3397		return ret;
3398
3399	spin_lock_irqsave(&xhci->lock, flags);
3400	for (i = 0; i < num_eps; i++) {
3401		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3402		xhci_free_stream_info(xhci, vdev->eps[ep_index].stream_info);
3403		vdev->eps[ep_index].stream_info = NULL;
3404		/* FIXME Unset maxPstreams in endpoint context and
3405		 * update deq ptr to point to normal string ring.
3406		 */
3407		vdev->eps[ep_index].ep_state &= ~EP_GETTING_NO_STREAMS;
3408		vdev->eps[ep_index].ep_state &= ~EP_HAS_STREAMS;
3409	}
3410	spin_unlock_irqrestore(&xhci->lock, flags);
3411
3412	return 0;
3413}
3414
3415/*
3416 * Deletes endpoint resources for endpoints that were active before a Reset
3417 * Device command, or a Disable Slot command.  The Reset Device command leaves
3418 * the control endpoint intact, whereas the Disable Slot command deletes it.
3419 *
3420 * Must be called with xhci->lock held.
3421 */
3422void xhci_free_device_endpoint_resources(struct xhci_hcd *xhci,
3423	struct xhci_virt_device *virt_dev, bool drop_control_ep)
3424{
3425	int i;
3426	unsigned int num_dropped_eps = 0;
3427	unsigned int drop_flags = 0;
3428
3429	for (i = (drop_control_ep ? 0 : 1); i < 31; i++) {
3430		if (virt_dev->eps[i].ring) {
3431			drop_flags |= 1 << i;
3432			num_dropped_eps++;
3433		}
3434	}
3435	xhci->num_active_eps -= num_dropped_eps;
3436	if (num_dropped_eps)
3437		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
3438				"Dropped %u ep ctxs, flags = 0x%x, "
3439				"%u now active.",
3440				num_dropped_eps, drop_flags,
3441				xhci->num_active_eps);
3442}
3443
3444/*
3445 * This submits a Reset Device Command, which will set the device state to 0,
3446 * set the device address to 0, and disable all the endpoints except the default
3447 * control endpoint.  The USB core should come back and call
3448 * xhci_address_device(), and then re-set up the configuration.  If this is
3449 * called because of a usb_reset_and_verify_device(), then the old alternate
3450 * settings will be re-installed through the normal bandwidth allocation
3451 * functions.
3452 *
3453 * Wait for the Reset Device command to finish.  Remove all structures
3454 * associated with the endpoints that were disabled.  Clear the input device
3455 * structure?  Cache the rings?  Reset the control endpoint 0 max packet size?
3456 *
3457 * If the virt_dev to be reset does not exist or does not match the udev,
3458 * it means the device is lost, possibly due to the xHC restore error and
3459 * re-initialization during S3/S4. In this case, call xhci_alloc_dev() to
3460 * re-allocate the device.
3461 */
3462int xhci_discover_or_reset_device(struct usb_hcd *hcd, struct usb_device *udev)
3463{
3464	int ret, i;
3465	unsigned long flags;
3466	struct xhci_hcd *xhci;
3467	unsigned int slot_id;
3468	struct xhci_virt_device *virt_dev;
3469	struct xhci_command *reset_device_cmd;
 
3470	int last_freed_endpoint;
3471	struct xhci_slot_ctx *slot_ctx;
3472	int old_active_eps = 0;
3473
3474	ret = xhci_check_args(hcd, udev, NULL, 0, false, __func__);
3475	if (ret <= 0)
3476		return ret;
3477	xhci = hcd_to_xhci(hcd);
3478	slot_id = udev->slot_id;
3479	virt_dev = xhci->devs[slot_id];
3480	if (!virt_dev) {
3481		xhci_dbg(xhci, "The device to be reset with slot ID %u does "
3482				"not exist. Re-allocate the device\n", slot_id);
3483		ret = xhci_alloc_dev(hcd, udev);
3484		if (ret == 1)
3485			return 0;
3486		else
3487			return -EINVAL;
3488	}
3489
3490	if (virt_dev->tt_info)
3491		old_active_eps = virt_dev->tt_info->active_eps;
3492
3493	if (virt_dev->udev != udev) {
3494		/* If the virt_dev and the udev does not match, this virt_dev
3495		 * may belong to another udev.
3496		 * Re-allocate the device.
3497		 */
3498		xhci_dbg(xhci, "The device to be reset with slot ID %u does "
3499				"not match the udev. Re-allocate the device\n",
3500				slot_id);
3501		ret = xhci_alloc_dev(hcd, udev);
3502		if (ret == 1)
3503			return 0;
3504		else
3505			return -EINVAL;
3506	}
3507
3508	/* If device is not setup, there is no point in resetting it */
3509	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->out_ctx);
3510	if (GET_SLOT_STATE(le32_to_cpu(slot_ctx->dev_state)) ==
3511						SLOT_STATE_DISABLED)
3512		return 0;
3513
3514	xhci_dbg(xhci, "Resetting device with slot ID %u\n", slot_id);
3515	/* Allocate the command structure that holds the struct completion.
3516	 * Assume we're in process context, since the normal device reset
3517	 * process has to wait for the device anyway.  Storage devices are
3518	 * reset as part of error handling, so use GFP_NOIO instead of
3519	 * GFP_KERNEL.
3520	 */
3521	reset_device_cmd = xhci_alloc_command(xhci, false, true, GFP_NOIO);
3522	if (!reset_device_cmd) {
3523		xhci_dbg(xhci, "Couldn't allocate command structure.\n");
3524		return -ENOMEM;
3525	}
3526
3527	/* Attempt to submit the Reset Device command to the command ring */
3528	spin_lock_irqsave(&xhci->lock, flags);
 
3529
3530	ret = xhci_queue_reset_device(xhci, reset_device_cmd, slot_id);
 
 
 
 
 
 
 
 
3531	if (ret) {
3532		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
 
3533		spin_unlock_irqrestore(&xhci->lock, flags);
3534		goto command_cleanup;
3535	}
3536	xhci_ring_cmd_db(xhci);
3537	spin_unlock_irqrestore(&xhci->lock, flags);
3538
3539	/* Wait for the Reset Device command to finish */
3540	wait_for_completion(reset_device_cmd->completion);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3541
3542	/* The Reset Device command can't fail, according to the 0.95/0.96 spec,
3543	 * unless we tried to reset a slot ID that wasn't enabled,
3544	 * or the device wasn't in the addressed or configured state.
3545	 */
3546	ret = reset_device_cmd->status;
3547	switch (ret) {
3548	case COMP_CMD_ABORT:
3549	case COMP_CMD_STOP:
3550		xhci_warn(xhci, "Timeout waiting for reset device command\n");
3551		ret = -ETIME;
3552		goto command_cleanup;
3553	case COMP_EBADSLT: /* 0.95 completion code for bad slot ID */
3554	case COMP_CTX_STATE: /* 0.96 completion code for same thing */
3555		xhci_dbg(xhci, "Can't reset device (slot ID %u) in %s state\n",
3556				slot_id,
3557				xhci_get_slot_state(xhci, virt_dev->out_ctx));
3558		xhci_dbg(xhci, "Not freeing device rings.\n");
3559		/* Don't treat this as an error.  May change my mind later. */
3560		ret = 0;
3561		goto command_cleanup;
3562	case COMP_SUCCESS:
3563		xhci_dbg(xhci, "Successful reset device command.\n");
3564		break;
3565	default:
3566		if (xhci_is_vendor_info_code(xhci, ret))
3567			break;
3568		xhci_warn(xhci, "Unknown completion code %u for "
3569				"reset device command.\n", ret);
3570		ret = -EINVAL;
3571		goto command_cleanup;
3572	}
3573
3574	/* Free up host controller endpoint resources */
3575	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
3576		spin_lock_irqsave(&xhci->lock, flags);
3577		/* Don't delete the default control endpoint resources */
3578		xhci_free_device_endpoint_resources(xhci, virt_dev, false);
3579		spin_unlock_irqrestore(&xhci->lock, flags);
3580	}
3581
3582	/* Everything but endpoint 0 is disabled, so free or cache the rings. */
3583	last_freed_endpoint = 1;
3584	for (i = 1; i < 31; ++i) {
3585		struct xhci_virt_ep *ep = &virt_dev->eps[i];
3586
3587		if (ep->ep_state & EP_HAS_STREAMS) {
3588			xhci_warn(xhci, "WARN: endpoint 0x%02x has streams on device reset, freeing streams.\n",
3589					xhci_get_endpoint_address(i));
3590			xhci_free_stream_info(xhci, ep->stream_info);
3591			ep->stream_info = NULL;
3592			ep->ep_state &= ~EP_HAS_STREAMS;
3593		}
3594
3595		if (ep->ring) {
3596			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
3597			last_freed_endpoint = i;
3598		}
3599		if (!list_empty(&virt_dev->eps[i].bw_endpoint_list))
3600			xhci_drop_ep_from_interval_table(xhci,
3601					&virt_dev->eps[i].bw_info,
3602					virt_dev->bw_table,
3603					udev,
3604					&virt_dev->eps[i],
3605					virt_dev->tt_info);
3606		xhci_clear_endpoint_bw_info(&virt_dev->eps[i].bw_info);
3607	}
3608	/* If necessary, update the number of active TTs on this root port */
3609	xhci_update_tt_active_eps(xhci, virt_dev, old_active_eps);
3610
3611	xhci_dbg(xhci, "Output context after successful reset device cmd:\n");
3612	xhci_dbg_ctx(xhci, virt_dev->out_ctx, last_freed_endpoint);
3613	ret = 0;
3614
3615command_cleanup:
3616	xhci_free_command(xhci, reset_device_cmd);
3617	return ret;
3618}
3619
3620/*
3621 * At this point, the struct usb_device is about to go away, the device has
3622 * disconnected, and all traffic has been stopped and the endpoints have been
3623 * disabled.  Free any HC data structures associated with that device.
3624 */
3625void xhci_free_dev(struct usb_hcd *hcd, struct usb_device *udev)
3626{
3627	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3628	struct xhci_virt_device *virt_dev;
3629	unsigned long flags;
3630	u32 state;
3631	int i, ret;
3632	struct xhci_command *command;
3633
3634	command = xhci_alloc_command(xhci, false, false, GFP_KERNEL);
3635	if (!command)
3636		return;
3637
3638#ifndef CONFIG_USB_DEFAULT_PERSIST
3639	/*
3640	 * We called pm_runtime_get_noresume when the device was attached.
3641	 * Decrement the counter here to allow controller to runtime suspend
3642	 * if no devices remain.
3643	 */
3644	if (xhci->quirks & XHCI_RESET_ON_RESUME)
3645		pm_runtime_put_noidle(hcd->self.controller);
3646#endif
3647
3648	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
3649	/* If the host is halted due to driver unload, we still need to free the
3650	 * device.
3651	 */
3652	if (ret <= 0 && ret != -ENODEV) {
3653		kfree(command);
3654		return;
3655	}
3656
3657	virt_dev = xhci->devs[udev->slot_id];
3658
3659	/* Stop any wayward timer functions (which may grab the lock) */
3660	for (i = 0; i < 31; ++i) {
3661		virt_dev->eps[i].ep_state &= ~EP_HALT_PENDING;
3662		del_timer_sync(&virt_dev->eps[i].stop_cmd_timer);
3663	}
3664
 
 
 
 
 
3665	spin_lock_irqsave(&xhci->lock, flags);
3666	/* Don't disable the slot if the host controller is dead. */
3667	state = readl(&xhci->op_regs->status);
3668	if (state == 0xffffffff || (xhci->xhc_state & XHCI_STATE_DYING) ||
3669			(xhci->xhc_state & XHCI_STATE_HALTED)) {
3670		xhci_free_virt_device(xhci, udev->slot_id);
3671		spin_unlock_irqrestore(&xhci->lock, flags);
3672		kfree(command);
3673		return;
3674	}
3675
3676	if (xhci_queue_slot_control(xhci, command, TRB_DISABLE_SLOT,
3677				    udev->slot_id)) {
3678		spin_unlock_irqrestore(&xhci->lock, flags);
3679		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
3680		return;
3681	}
3682	xhci_ring_cmd_db(xhci);
3683	spin_unlock_irqrestore(&xhci->lock, flags);
3684
3685	/*
3686	 * Event command completion handler will free any data structures
3687	 * associated with the slot.  XXX Can free sleep?
3688	 */
3689}
3690
3691/*
3692 * Checks if we have enough host controller resources for the default control
3693 * endpoint.
3694 *
3695 * Must be called with xhci->lock held.
3696 */
3697static int xhci_reserve_host_control_ep_resources(struct xhci_hcd *xhci)
3698{
3699	if (xhci->num_active_eps + 1 > xhci->limit_active_eps) {
3700		xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
3701				"Not enough ep ctxs: "
3702				"%u active, need to add 1, limit is %u.",
3703				xhci->num_active_eps, xhci->limit_active_eps);
3704		return -ENOMEM;
3705	}
3706	xhci->num_active_eps += 1;
3707	xhci_dbg_trace(xhci, trace_xhci_dbg_quirks,
3708			"Adding 1 ep ctx, %u now active.",
3709			xhci->num_active_eps);
3710	return 0;
3711}
3712
3713
3714/*
3715 * Returns 0 if the xHC ran out of device slots, the Enable Slot command
3716 * timed out, or allocating memory failed.  Returns 1 on success.
3717 */
3718int xhci_alloc_dev(struct usb_hcd *hcd, struct usb_device *udev)
3719{
3720	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3721	unsigned long flags;
3722	int ret, slot_id;
3723	struct xhci_command *command;
3724
3725	command = xhci_alloc_command(xhci, false, false, GFP_KERNEL);
3726	if (!command)
3727		return 0;
3728
3729	/* xhci->slot_id and xhci->addr_dev are not thread-safe */
3730	mutex_lock(&xhci->mutex);
3731	spin_lock_irqsave(&xhci->lock, flags);
3732	command->completion = &xhci->addr_dev;
3733	ret = xhci_queue_slot_control(xhci, command, TRB_ENABLE_SLOT, 0);
3734	if (ret) {
3735		spin_unlock_irqrestore(&xhci->lock, flags);
3736		mutex_unlock(&xhci->mutex);
3737		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
3738		kfree(command);
3739		return 0;
3740	}
3741	xhci_ring_cmd_db(xhci);
3742	spin_unlock_irqrestore(&xhci->lock, flags);
3743
3744	wait_for_completion(command->completion);
3745	slot_id = xhci->slot_id;
3746	mutex_unlock(&xhci->mutex);
 
 
 
 
 
 
3747
3748	if (!slot_id || command->status != COMP_SUCCESS) {
3749		xhci_err(xhci, "Error while assigning device slot ID\n");
3750		xhci_err(xhci, "Max number of devices this xHCI host supports is %u.\n",
3751				HCS_MAX_SLOTS(
3752					readl(&xhci->cap_regs->hcs_params1)));
3753		kfree(command);
3754		return 0;
3755	}
3756
3757	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
3758		spin_lock_irqsave(&xhci->lock, flags);
3759		ret = xhci_reserve_host_control_ep_resources(xhci);
3760		if (ret) {
3761			spin_unlock_irqrestore(&xhci->lock, flags);
3762			xhci_warn(xhci, "Not enough host resources, "
3763					"active endpoint contexts = %u\n",
3764					xhci->num_active_eps);
3765			goto disable_slot;
3766		}
3767		spin_unlock_irqrestore(&xhci->lock, flags);
3768	}
3769	/* Use GFP_NOIO, since this function can be called from
3770	 * xhci_discover_or_reset_device(), which may be called as part of
3771	 * mass storage driver error handling.
3772	 */
3773	if (!xhci_alloc_virt_device(xhci, slot_id, udev, GFP_NOIO)) {
3774		xhci_warn(xhci, "Could not allocate xHCI USB device data structures\n");
3775		goto disable_slot;
3776	}
3777	udev->slot_id = slot_id;
3778
3779#ifndef CONFIG_USB_DEFAULT_PERSIST
3780	/*
3781	 * If resetting upon resume, we can't put the controller into runtime
3782	 * suspend if there is a device attached.
3783	 */
3784	if (xhci->quirks & XHCI_RESET_ON_RESUME)
3785		pm_runtime_get_noresume(hcd->self.controller);
3786#endif
3787
3788
3789	kfree(command);
3790	/* Is this a LS or FS device under a HS hub? */
3791	/* Hub or peripherial? */
3792	return 1;
3793
3794disable_slot:
3795	/* Disable slot, if we can do it without mem alloc */
3796	spin_lock_irqsave(&xhci->lock, flags);
3797	command->completion = NULL;
3798	command->status = 0;
3799	if (!xhci_queue_slot_control(xhci, command, TRB_DISABLE_SLOT,
3800				     udev->slot_id))
3801		xhci_ring_cmd_db(xhci);
3802	spin_unlock_irqrestore(&xhci->lock, flags);
3803	return 0;
3804}
3805
3806/*
3807 * Issue an Address Device command and optionally send a corresponding
3808 * SetAddress request to the device.
 
 
 
 
 
3809 */
3810static int xhci_setup_device(struct usb_hcd *hcd, struct usb_device *udev,
3811			     enum xhci_setup_dev setup)
3812{
3813	const char *act = setup == SETUP_CONTEXT_ONLY ? "context" : "address";
3814	unsigned long flags;
 
3815	struct xhci_virt_device *virt_dev;
3816	int ret = 0;
3817	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3818	struct xhci_slot_ctx *slot_ctx;
3819	struct xhci_input_control_ctx *ctrl_ctx;
3820	u64 temp_64;
3821	struct xhci_command *command = NULL;
3822
3823	mutex_lock(&xhci->mutex);
3824
3825	if (xhci->xhc_state)	/* dying, removing or halted */
3826		goto out;
3827
3828	if (!udev->slot_id) {
3829		xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3830				"Bad Slot ID %d", udev->slot_id);
3831		ret = -EINVAL;
3832		goto out;
3833	}
3834
3835	virt_dev = xhci->devs[udev->slot_id];
3836
3837	if (WARN_ON(!virt_dev)) {
3838		/*
3839		 * In plug/unplug torture test with an NEC controller,
3840		 * a zero-dereference was observed once due to virt_dev = 0.
3841		 * Print useful debug rather than crash if it is observed again!
3842		 */
3843		xhci_warn(xhci, "Virt dev invalid for slot_id 0x%x!\n",
3844			udev->slot_id);
3845		ret = -EINVAL;
3846		goto out;
3847	}
3848
3849	if (setup == SETUP_CONTEXT_ONLY) {
3850		slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->out_ctx);
3851		if (GET_SLOT_STATE(le32_to_cpu(slot_ctx->dev_state)) ==
3852		    SLOT_STATE_DEFAULT) {
3853			xhci_dbg(xhci, "Slot already in default state\n");
3854			goto out;
3855		}
3856	}
3857
3858	command = xhci_alloc_command(xhci, false, false, GFP_KERNEL);
3859	if (!command) {
3860		ret = -ENOMEM;
3861		goto out;
3862	}
3863
3864	command->in_ctx = virt_dev->in_ctx;
3865	command->completion = &xhci->addr_dev;
3866
3867	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
3868	ctrl_ctx = xhci_get_input_control_ctx(virt_dev->in_ctx);
3869	if (!ctrl_ctx) {
3870		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
3871				__func__);
3872		ret = -EINVAL;
3873		goto out;
3874	}
3875	/*
3876	 * If this is the first Set Address since device plug-in or
3877	 * virt_device realloaction after a resume with an xHCI power loss,
3878	 * then set up the slot context.
3879	 */
3880	if (!slot_ctx->dev_info)
3881		xhci_setup_addressable_virt_dev(xhci, udev);
3882	/* Otherwise, update the control endpoint ring enqueue pointer. */
3883	else
3884		xhci_copy_ep0_dequeue_into_input_ctx(xhci, udev);
 
3885	ctrl_ctx->add_flags = cpu_to_le32(SLOT_FLAG | EP0_FLAG);
3886	ctrl_ctx->drop_flags = 0;
3887
3888	xhci_dbg(xhci, "Slot ID %d Input Context:\n", udev->slot_id);
3889	xhci_dbg_ctx(xhci, virt_dev->in_ctx, 2);
3890	trace_xhci_address_ctx(xhci, virt_dev->in_ctx,
3891				le32_to_cpu(slot_ctx->dev_info) >> 27);
3892
3893	spin_lock_irqsave(&xhci->lock, flags);
3894	ret = xhci_queue_address_device(xhci, command, virt_dev->in_ctx->dma,
3895					udev->slot_id, setup);
 
3896	if (ret) {
3897		spin_unlock_irqrestore(&xhci->lock, flags);
3898		xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3899				"FIXME: allocate a command ring segment");
3900		goto out;
3901	}
3902	xhci_ring_cmd_db(xhci);
3903	spin_unlock_irqrestore(&xhci->lock, flags);
3904
3905	/* ctrl tx can take up to 5 sec; XXX: need more time for xHC? */
3906	wait_for_completion(command->completion);
3907
3908	/* FIXME: From section 4.3.4: "Software shall be responsible for timing
3909	 * the SetAddress() "recovery interval" required by USB and aborting the
3910	 * command on a timeout.
3911	 */
3912	switch (command->status) {
3913	case COMP_CMD_ABORT:
3914	case COMP_CMD_STOP:
3915		xhci_warn(xhci, "Timeout while waiting for setup device command\n");
3916		ret = -ETIME;
3917		break;
 
 
 
 
 
3918	case COMP_CTX_STATE:
3919	case COMP_EBADSLT:
3920		xhci_err(xhci, "Setup ERROR: setup %s command for slot %d.\n",
3921			 act, udev->slot_id);
3922		ret = -EINVAL;
3923		break;
3924	case COMP_TX_ERR:
3925		dev_warn(&udev->dev, "Device not responding to setup %s.\n", act);
3926		ret = -EPROTO;
3927		break;
3928	case COMP_DEV_ERR:
3929		dev_warn(&udev->dev,
3930			 "ERROR: Incompatible device for setup %s command\n", act);
3931		ret = -ENODEV;
3932		break;
3933	case COMP_SUCCESS:
3934		xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3935			       "Successful setup %s command", act);
3936		break;
3937	default:
3938		xhci_err(xhci,
3939			 "ERROR: unexpected setup %s command completion code 0x%x.\n",
3940			 act, command->status);
3941		xhci_dbg(xhci, "Slot ID %d Output Context:\n", udev->slot_id);
3942		xhci_dbg_ctx(xhci, virt_dev->out_ctx, 2);
3943		trace_xhci_address_ctx(xhci, virt_dev->out_ctx, 1);
3944		ret = -EINVAL;
3945		break;
3946	}
3947	if (ret)
3948		goto out;
 
3949	temp_64 = xhci_read_64(xhci, &xhci->op_regs->dcbaa_ptr);
3950	xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3951			"Op regs DCBAA ptr = %#016llx", temp_64);
3952	xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3953		"Slot ID %d dcbaa entry @%p = %#016llx",
3954		udev->slot_id,
3955		&xhci->dcbaa->dev_context_ptrs[udev->slot_id],
3956		(unsigned long long)
3957		le64_to_cpu(xhci->dcbaa->dev_context_ptrs[udev->slot_id]));
3958	xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3959			"Output Context DMA address = %#08llx",
3960			(unsigned long long)virt_dev->out_ctx->dma);
3961	xhci_dbg(xhci, "Slot ID %d Input Context:\n", udev->slot_id);
3962	xhci_dbg_ctx(xhci, virt_dev->in_ctx, 2);
3963	trace_xhci_address_ctx(xhci, virt_dev->in_ctx,
3964				le32_to_cpu(slot_ctx->dev_info) >> 27);
3965	xhci_dbg(xhci, "Slot ID %d Output Context:\n", udev->slot_id);
3966	xhci_dbg_ctx(xhci, virt_dev->out_ctx, 2);
3967	/*
3968	 * USB core uses address 1 for the roothubs, so we add one to the
3969	 * address given back to us by the HC.
3970	 */
3971	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->out_ctx);
3972	trace_xhci_address_ctx(xhci, virt_dev->out_ctx,
3973				le32_to_cpu(slot_ctx->dev_info) >> 27);
 
 
3974	/* Zero the input context control for later use */
3975	ctrl_ctx->add_flags = 0;
3976	ctrl_ctx->drop_flags = 0;
3977
3978	xhci_dbg_trace(xhci, trace_xhci_dbg_address,
3979		       "Internal device address = %d",
3980		       le32_to_cpu(slot_ctx->dev_state) & DEV_ADDR_MASK);
3981out:
3982	mutex_unlock(&xhci->mutex);
3983	kfree(command);
3984	return ret;
3985}
3986
3987int xhci_address_device(struct usb_hcd *hcd, struct usb_device *udev)
3988{
3989	return xhci_setup_device(hcd, udev, SETUP_CONTEXT_ADDRESS);
3990}
3991
3992int xhci_enable_device(struct usb_hcd *hcd, struct usb_device *udev)
3993{
3994	return xhci_setup_device(hcd, udev, SETUP_CONTEXT_ONLY);
3995}
3996
3997/*
3998 * Transfer the port index into real index in the HW port status
3999 * registers. Caculate offset between the port's PORTSC register
4000 * and port status base. Divide the number of per port register
4001 * to get the real index. The raw port number bases 1.
4002 */
4003int xhci_find_raw_port_number(struct usb_hcd *hcd, int port1)
4004{
4005	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4006	__le32 __iomem *base_addr = &xhci->op_regs->port_status_base;
4007	__le32 __iomem *addr;
4008	int raw_port;
4009
4010	if (hcd->speed < HCD_USB3)
4011		addr = xhci->usb2_ports[port1 - 1];
4012	else
4013		addr = xhci->usb3_ports[port1 - 1];
4014
4015	raw_port = (addr - base_addr)/NUM_PORT_REGS + 1;
4016	return raw_port;
4017}
4018
4019/*
4020 * Issue an Evaluate Context command to change the Maximum Exit Latency in the
4021 * slot context.  If that succeeds, store the new MEL in the xhci_virt_device.
4022 */
4023static int __maybe_unused xhci_change_max_exit_latency(struct xhci_hcd *xhci,
4024			struct usb_device *udev, u16 max_exit_latency)
4025{
4026	struct xhci_virt_device *virt_dev;
4027	struct xhci_command *command;
4028	struct xhci_input_control_ctx *ctrl_ctx;
4029	struct xhci_slot_ctx *slot_ctx;
4030	unsigned long flags;
4031	int ret;
4032
4033	spin_lock_irqsave(&xhci->lock, flags);
4034
4035	virt_dev = xhci->devs[udev->slot_id];
4036
4037	/*
4038	 * virt_dev might not exists yet if xHC resumed from hibernate (S4) and
4039	 * xHC was re-initialized. Exit latency will be set later after
4040	 * hub_port_finish_reset() is done and xhci->devs[] are re-allocated
4041	 */
4042
4043	if (!virt_dev || max_exit_latency == virt_dev->current_mel) {
4044		spin_unlock_irqrestore(&xhci->lock, flags);
4045		return 0;
4046	}
4047
4048	/* Attempt to issue an Evaluate Context command to change the MEL. */
4049	command = xhci->lpm_command;
4050	ctrl_ctx = xhci_get_input_control_ctx(command->in_ctx);
4051	if (!ctrl_ctx) {
4052		spin_unlock_irqrestore(&xhci->lock, flags);
4053		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
4054				__func__);
4055		return -ENOMEM;
4056	}
4057
4058	xhci_slot_copy(xhci, command->in_ctx, virt_dev->out_ctx);
4059	spin_unlock_irqrestore(&xhci->lock, flags);
4060
4061	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
4062	slot_ctx = xhci_get_slot_ctx(xhci, command->in_ctx);
4063	slot_ctx->dev_info2 &= cpu_to_le32(~((u32) MAX_EXIT));
4064	slot_ctx->dev_info2 |= cpu_to_le32(max_exit_latency);
4065	slot_ctx->dev_state = 0;
4066
4067	xhci_dbg_trace(xhci, trace_xhci_dbg_context_change,
4068			"Set up evaluate context for LPM MEL change.");
4069	xhci_dbg(xhci, "Slot %u Input Context:\n", udev->slot_id);
4070	xhci_dbg_ctx(xhci, command->in_ctx, 0);
4071
4072	/* Issue and wait for the evaluate context command. */
4073	ret = xhci_configure_endpoint(xhci, udev, command,
4074			true, true);
4075	xhci_dbg(xhci, "Slot %u Output Context:\n", udev->slot_id);
4076	xhci_dbg_ctx(xhci, virt_dev->out_ctx, 0);
4077
4078	if (!ret) {
4079		spin_lock_irqsave(&xhci->lock, flags);
4080		virt_dev->current_mel = max_exit_latency;
4081		spin_unlock_irqrestore(&xhci->lock, flags);
4082	}
4083	return ret;
4084}
4085
4086#ifdef CONFIG_PM
4087
4088/* BESL to HIRD Encoding array for USB2 LPM */
4089static int xhci_besl_encoding[16] = {125, 150, 200, 300, 400, 500, 1000, 2000,
4090	3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000};
4091
4092/* Calculate HIRD/BESL for USB2 PORTPMSC*/
4093static int xhci_calculate_hird_besl(struct xhci_hcd *xhci,
4094					struct usb_device *udev)
4095{
4096	int u2del, besl, besl_host;
4097	int besl_device = 0;
4098	u32 field;
4099
4100	u2del = HCS_U2_LATENCY(xhci->hcs_params3);
4101	field = le32_to_cpu(udev->bos->ext_cap->bmAttributes);
4102
4103	if (field & USB_BESL_SUPPORT) {
4104		for (besl_host = 0; besl_host < 16; besl_host++) {
4105			if (xhci_besl_encoding[besl_host] >= u2del)
4106				break;
4107		}
4108		/* Use baseline BESL value as default */
4109		if (field & USB_BESL_BASELINE_VALID)
4110			besl_device = USB_GET_BESL_BASELINE(field);
4111		else if (field & USB_BESL_DEEP_VALID)
4112			besl_device = USB_GET_BESL_DEEP(field);
4113	} else {
4114		if (u2del <= 50)
4115			besl_host = 0;
4116		else
4117			besl_host = (u2del - 51) / 75 + 1;
4118	}
4119
4120	besl = besl_host + besl_device;
4121	if (besl > 15)
4122		besl = 15;
4123
4124	return besl;
4125}
4126
4127/* Calculate BESLD, L1 timeout and HIRDM for USB2 PORTHLPMC */
4128static int xhci_calculate_usb2_hw_lpm_params(struct usb_device *udev)
4129{
4130	u32 field;
4131	int l1;
4132	int besld = 0;
4133	int hirdm = 0;
 
 
 
 
 
4134
4135	field = le32_to_cpu(udev->bos->ext_cap->bmAttributes);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4136
4137	/* xHCI l1 is set in steps of 256us, xHCI 1.0 section 5.4.11.2 */
4138	l1 = udev->l1_params.timeout / 256;
 
 
4139
4140	/* device has preferred BESLD */
4141	if (field & USB_BESL_DEEP_VALID) {
4142		besld = USB_GET_BESL_DEEP(field);
4143		hirdm = 1;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4144	}
4145
4146	return PORT_BESLD(besld) | PORT_L1_TIMEOUT(l1) | PORT_HIRDM(hirdm);
 
 
4147}
4148
4149int xhci_set_usb2_hardware_lpm(struct usb_hcd *hcd,
4150			struct usb_device *udev, int enable)
4151{
4152	struct xhci_hcd	*xhci = hcd_to_xhci(hcd);
4153	__le32 __iomem	**port_array;
4154	__le32 __iomem	*pm_addr, *hlpm_addr;
4155	u32		pm_val, hlpm_val, field;
4156	unsigned int	port_num;
4157	unsigned long	flags;
4158	int		hird, exit_latency;
4159	int		ret;
4160
4161	if (hcd->speed >= HCD_USB3 || !xhci->hw_lpm_support ||
4162			!udev->lpm_capable)
4163		return -EPERM;
4164
4165	if (!udev->parent || udev->parent->parent ||
4166			udev->descriptor.bDeviceClass == USB_CLASS_HUB)
4167		return -EPERM;
4168
4169	if (udev->usb2_hw_lpm_capable != 1)
4170		return -EPERM;
4171
4172	spin_lock_irqsave(&xhci->lock, flags);
4173
4174	port_array = xhci->usb2_ports;
4175	port_num = udev->portnum - 1;
4176	pm_addr = port_array[port_num] + PORTPMSC;
4177	pm_val = readl(pm_addr);
4178	hlpm_addr = port_array[port_num] + PORTHLPMC;
4179	field = le32_to_cpu(udev->bos->ext_cap->bmAttributes);
4180
4181	xhci_dbg(xhci, "%s port %d USB2 hardware LPM\n",
4182			enable ? "enable" : "disable", port_num + 1);
4183
4184	if (enable) {
4185		/* Host supports BESL timeout instead of HIRD */
4186		if (udev->usb2_hw_lpm_besl_capable) {
4187			/* if device doesn't have a preferred BESL value use a
4188			 * default one which works with mixed HIRD and BESL
4189			 * systems. See XHCI_DEFAULT_BESL definition in xhci.h
4190			 */
4191			if ((field & USB_BESL_SUPPORT) &&
4192			    (field & USB_BESL_BASELINE_VALID))
4193				hird = USB_GET_BESL_BASELINE(field);
4194			else
4195				hird = udev->l1_params.besl;
4196
4197			exit_latency = xhci_besl_encoding[hird];
4198			spin_unlock_irqrestore(&xhci->lock, flags);
4199
4200			/* USB 3.0 code dedicate one xhci->lpm_command->in_ctx
4201			 * input context for link powermanagement evaluate
4202			 * context commands. It is protected by hcd->bandwidth
4203			 * mutex and is shared by all devices. We need to set
4204			 * the max ext latency in USB 2 BESL LPM as well, so
4205			 * use the same mutex and xhci_change_max_exit_latency()
4206			 */
4207			mutex_lock(hcd->bandwidth_mutex);
4208			ret = xhci_change_max_exit_latency(xhci, udev,
4209							   exit_latency);
4210			mutex_unlock(hcd->bandwidth_mutex);
4211
4212			if (ret < 0)
4213				return ret;
4214			spin_lock_irqsave(&xhci->lock, flags);
4215
4216			hlpm_val = xhci_calculate_usb2_hw_lpm_params(udev);
4217			writel(hlpm_val, hlpm_addr);
4218			/* flush write */
4219			readl(hlpm_addr);
4220		} else {
4221			hird = xhci_calculate_hird_besl(xhci, udev);
4222		}
4223
4224		pm_val &= ~PORT_HIRD_MASK;
4225		pm_val |= PORT_HIRD(hird) | PORT_RWE | PORT_L1DS(udev->slot_id);
4226		writel(pm_val, pm_addr);
4227		pm_val = readl(pm_addr);
4228		pm_val |= PORT_HLE;
4229		writel(pm_val, pm_addr);
4230		/* flush write */
4231		readl(pm_addr);
4232	} else {
4233		pm_val &= ~(PORT_HLE | PORT_RWE | PORT_HIRD_MASK | PORT_L1DS_MASK);
4234		writel(pm_val, pm_addr);
4235		/* flush write */
4236		readl(pm_addr);
4237		if (udev->usb2_hw_lpm_besl_capable) {
4238			spin_unlock_irqrestore(&xhci->lock, flags);
4239			mutex_lock(hcd->bandwidth_mutex);
4240			xhci_change_max_exit_latency(xhci, udev, 0);
4241			mutex_unlock(hcd->bandwidth_mutex);
4242			return 0;
4243		}
4244	}
4245
4246	spin_unlock_irqrestore(&xhci->lock, flags);
4247	return 0;
4248}
4249
4250/* check if a usb2 port supports a given extened capability protocol
4251 * only USB2 ports extended protocol capability values are cached.
4252 * Return 1 if capability is supported
4253 */
4254static int xhci_check_usb2_port_capability(struct xhci_hcd *xhci, int port,
4255					   unsigned capability)
4256{
4257	u32 port_offset, port_count;
4258	int i;
4259
4260	for (i = 0; i < xhci->num_ext_caps; i++) {
4261		if (xhci->ext_caps[i] & capability) {
4262			/* port offsets starts at 1 */
4263			port_offset = XHCI_EXT_PORT_OFF(xhci->ext_caps[i]) - 1;
4264			port_count = XHCI_EXT_PORT_COUNT(xhci->ext_caps[i]);
4265			if (port >= port_offset &&
4266			    port < port_offset + port_count)
4267				return 1;
4268		}
4269	}
 
4270	return 0;
4271}
4272
4273int xhci_update_device(struct usb_hcd *hcd, struct usb_device *udev)
4274{
4275	struct xhci_hcd	*xhci = hcd_to_xhci(hcd);
4276	int		portnum = udev->portnum - 1;
4277
4278	if (hcd->speed >= HCD_USB3 || !xhci->sw_lpm_support ||
4279			!udev->lpm_capable)
4280		return 0;
4281
4282	/* we only support lpm for non-hub device connected to root hub yet */
4283	if (!udev->parent || udev->parent->parent ||
4284			udev->descriptor.bDeviceClass == USB_CLASS_HUB)
4285		return 0;
4286
4287	if (xhci->hw_lpm_support == 1 &&
4288			xhci_check_usb2_port_capability(
4289				xhci, portnum, XHCI_HLC)) {
4290		udev->usb2_hw_lpm_capable = 1;
4291		udev->l1_params.timeout = XHCI_L1_TIMEOUT;
4292		udev->l1_params.besl = XHCI_DEFAULT_BESL;
4293		if (xhci_check_usb2_port_capability(xhci, portnum,
4294					XHCI_BLC))
4295			udev->usb2_hw_lpm_besl_capable = 1;
4296	}
4297
 
 
4298	return 0;
4299}
4300
 
 
4301/*---------------------- USB 3.0 Link PM functions ------------------------*/
4302
 
4303/* Service interval in nanoseconds = 2^(bInterval - 1) * 125us * 1000ns / 1us */
4304static unsigned long long xhci_service_interval_to_ns(
4305		struct usb_endpoint_descriptor *desc)
4306{
4307	return (1ULL << (desc->bInterval - 1)) * 125 * 1000;
4308}
4309
4310static u16 xhci_get_timeout_no_hub_lpm(struct usb_device *udev,
4311		enum usb3_link_state state)
4312{
4313	unsigned long long sel;
4314	unsigned long long pel;
4315	unsigned int max_sel_pel;
4316	char *state_name;
4317
4318	switch (state) {
4319	case USB3_LPM_U1:
4320		/* Convert SEL and PEL stored in nanoseconds to microseconds */
4321		sel = DIV_ROUND_UP(udev->u1_params.sel, 1000);
4322		pel = DIV_ROUND_UP(udev->u1_params.pel, 1000);
4323		max_sel_pel = USB3_LPM_MAX_U1_SEL_PEL;
4324		state_name = "U1";
4325		break;
4326	case USB3_LPM_U2:
4327		sel = DIV_ROUND_UP(udev->u2_params.sel, 1000);
4328		pel = DIV_ROUND_UP(udev->u2_params.pel, 1000);
4329		max_sel_pel = USB3_LPM_MAX_U2_SEL_PEL;
4330		state_name = "U2";
4331		break;
4332	default:
4333		dev_warn(&udev->dev, "%s: Can't get timeout for non-U1 or U2 state.\n",
4334				__func__);
4335		return USB3_LPM_DISABLED;
4336	}
4337
4338	if (sel <= max_sel_pel && pel <= max_sel_pel)
4339		return USB3_LPM_DEVICE_INITIATED;
4340
4341	if (sel > max_sel_pel)
4342		dev_dbg(&udev->dev, "Device-initiated %s disabled "
4343				"due to long SEL %llu ms\n",
4344				state_name, sel);
4345	else
4346		dev_dbg(&udev->dev, "Device-initiated %s disabled "
4347				"due to long PEL %llu ms\n",
4348				state_name, pel);
4349	return USB3_LPM_DISABLED;
4350}
4351
4352/* The U1 timeout should be the maximum of the following values:
 
4353 *  - For control endpoints, U1 system exit latency (SEL) * 3
4354 *  - For bulk endpoints, U1 SEL * 5
4355 *  - For interrupt endpoints:
4356 *    - Notification EPs, U1 SEL * 3
4357 *    - Periodic EPs, max(105% of bInterval, U1 SEL * 2)
4358 *  - For isochronous endpoints, max(105% of bInterval, U1 SEL * 2)
4359 */
4360static unsigned long long xhci_calculate_intel_u1_timeout(
4361		struct usb_device *udev,
4362		struct usb_endpoint_descriptor *desc)
4363{
4364	unsigned long long timeout_ns;
4365	int ep_type;
4366	int intr_type;
4367
4368	ep_type = usb_endpoint_type(desc);
4369	switch (ep_type) {
4370	case USB_ENDPOINT_XFER_CONTROL:
4371		timeout_ns = udev->u1_params.sel * 3;
4372		break;
4373	case USB_ENDPOINT_XFER_BULK:
4374		timeout_ns = udev->u1_params.sel * 5;
4375		break;
4376	case USB_ENDPOINT_XFER_INT:
4377		intr_type = usb_endpoint_interrupt_type(desc);
4378		if (intr_type == USB_ENDPOINT_INTR_NOTIFICATION) {
4379			timeout_ns = udev->u1_params.sel * 3;
4380			break;
4381		}
4382		/* Otherwise the calculation is the same as isoc eps */
4383	case USB_ENDPOINT_XFER_ISOC:
4384		timeout_ns = xhci_service_interval_to_ns(desc);
4385		timeout_ns = DIV_ROUND_UP_ULL(timeout_ns * 105, 100);
4386		if (timeout_ns < udev->u1_params.sel * 2)
4387			timeout_ns = udev->u1_params.sel * 2;
4388		break;
4389	default:
4390		return 0;
4391	}
4392
4393	return timeout_ns;
4394}
4395
4396/* Returns the hub-encoded U1 timeout value. */
4397static u16 xhci_calculate_u1_timeout(struct xhci_hcd *xhci,
4398		struct usb_device *udev,
4399		struct usb_endpoint_descriptor *desc)
4400{
4401	unsigned long long timeout_ns;
4402
4403	if (xhci->quirks & XHCI_INTEL_HOST)
4404		timeout_ns = xhci_calculate_intel_u1_timeout(udev, desc);
4405	else
4406		timeout_ns = udev->u1_params.sel;
4407
4408	/* The U1 timeout is encoded in 1us intervals.
4409	 * Don't return a timeout of zero, because that's USB3_LPM_DISABLED.
4410	 */
4411	if (timeout_ns == USB3_LPM_DISABLED)
4412		timeout_ns = 1;
4413	else
4414		timeout_ns = DIV_ROUND_UP_ULL(timeout_ns, 1000);
4415
4416	/* If the necessary timeout value is bigger than what we can set in the
4417	 * USB 3.0 hub, we have to disable hub-initiated U1.
4418	 */
4419	if (timeout_ns <= USB3_LPM_U1_MAX_TIMEOUT)
4420		return timeout_ns;
4421	dev_dbg(&udev->dev, "Hub-initiated U1 disabled "
4422			"due to long timeout %llu ms\n", timeout_ns);
4423	return xhci_get_timeout_no_hub_lpm(udev, USB3_LPM_U1);
4424}
4425
4426/* The U2 timeout should be the maximum of:
 
4427 *  - 10 ms (to avoid the bandwidth impact on the scheduler)
4428 *  - largest bInterval of any active periodic endpoint (to avoid going
4429 *    into lower power link states between intervals).
4430 *  - the U2 Exit Latency of the device
4431 */
4432static unsigned long long xhci_calculate_intel_u2_timeout(
4433		struct usb_device *udev,
4434		struct usb_endpoint_descriptor *desc)
4435{
4436	unsigned long long timeout_ns;
4437	unsigned long long u2_del_ns;
4438
4439	timeout_ns = 10 * 1000 * 1000;
4440
4441	if ((usb_endpoint_xfer_int(desc) || usb_endpoint_xfer_isoc(desc)) &&
4442			(xhci_service_interval_to_ns(desc) > timeout_ns))
4443		timeout_ns = xhci_service_interval_to_ns(desc);
4444
4445	u2_del_ns = le16_to_cpu(udev->bos->ss_cap->bU2DevExitLat) * 1000ULL;
4446	if (u2_del_ns > timeout_ns)
4447		timeout_ns = u2_del_ns;
4448
4449	return timeout_ns;
4450}
4451
4452/* Returns the hub-encoded U2 timeout value. */
4453static u16 xhci_calculate_u2_timeout(struct xhci_hcd *xhci,
4454		struct usb_device *udev,
4455		struct usb_endpoint_descriptor *desc)
4456{
4457	unsigned long long timeout_ns;
4458
4459	if (xhci->quirks & XHCI_INTEL_HOST)
4460		timeout_ns = xhci_calculate_intel_u2_timeout(udev, desc);
4461	else
4462		timeout_ns = udev->u2_params.sel;
4463
4464	/* The U2 timeout is encoded in 256us intervals */
4465	timeout_ns = DIV_ROUND_UP_ULL(timeout_ns, 256 * 1000);
4466	/* If the necessary timeout value is bigger than what we can set in the
4467	 * USB 3.0 hub, we have to disable hub-initiated U2.
4468	 */
4469	if (timeout_ns <= USB3_LPM_U2_MAX_TIMEOUT)
4470		return timeout_ns;
4471	dev_dbg(&udev->dev, "Hub-initiated U2 disabled "
4472			"due to long timeout %llu ms\n", timeout_ns);
4473	return xhci_get_timeout_no_hub_lpm(udev, USB3_LPM_U2);
4474}
4475
4476static u16 xhci_call_host_update_timeout_for_endpoint(struct xhci_hcd *xhci,
4477		struct usb_device *udev,
4478		struct usb_endpoint_descriptor *desc,
4479		enum usb3_link_state state,
4480		u16 *timeout)
4481{
4482	if (state == USB3_LPM_U1)
4483		return xhci_calculate_u1_timeout(xhci, udev, desc);
4484	else if (state == USB3_LPM_U2)
4485		return xhci_calculate_u2_timeout(xhci, udev, desc);
 
 
 
4486
4487	return USB3_LPM_DISABLED;
4488}
4489
4490static int xhci_update_timeout_for_endpoint(struct xhci_hcd *xhci,
4491		struct usb_device *udev,
4492		struct usb_endpoint_descriptor *desc,
4493		enum usb3_link_state state,
4494		u16 *timeout)
4495{
4496	u16 alt_timeout;
4497
4498	alt_timeout = xhci_call_host_update_timeout_for_endpoint(xhci, udev,
4499		desc, state, timeout);
4500
4501	/* If we found we can't enable hub-initiated LPM, or
4502	 * the U1 or U2 exit latency was too high to allow
4503	 * device-initiated LPM as well, just stop searching.
4504	 */
4505	if (alt_timeout == USB3_LPM_DISABLED ||
4506			alt_timeout == USB3_LPM_DEVICE_INITIATED) {
4507		*timeout = alt_timeout;
4508		return -E2BIG;
4509	}
4510	if (alt_timeout > *timeout)
4511		*timeout = alt_timeout;
4512	return 0;
4513}
4514
4515static int xhci_update_timeout_for_interface(struct xhci_hcd *xhci,
4516		struct usb_device *udev,
4517		struct usb_host_interface *alt,
4518		enum usb3_link_state state,
4519		u16 *timeout)
4520{
4521	int j;
4522
4523	for (j = 0; j < alt->desc.bNumEndpoints; j++) {
4524		if (xhci_update_timeout_for_endpoint(xhci, udev,
4525					&alt->endpoint[j].desc, state, timeout))
4526			return -E2BIG;
4527		continue;
4528	}
4529	return 0;
4530}
4531
4532static int xhci_check_intel_tier_policy(struct usb_device *udev,
4533		enum usb3_link_state state)
4534{
4535	struct usb_device *parent;
4536	unsigned int num_hubs;
4537
4538	if (state == USB3_LPM_U2)
4539		return 0;
4540
4541	/* Don't enable U1 if the device is on a 2nd tier hub or lower. */
4542	for (parent = udev->parent, num_hubs = 0; parent->parent;
4543			parent = parent->parent)
4544		num_hubs++;
4545
4546	if (num_hubs < 2)
4547		return 0;
4548
4549	dev_dbg(&udev->dev, "Disabling U1 link state for device"
4550			" below second-tier hub.\n");
4551	dev_dbg(&udev->dev, "Plug device into first-tier hub "
4552			"to decrease power consumption.\n");
4553	return -E2BIG;
4554}
4555
4556static int xhci_check_tier_policy(struct xhci_hcd *xhci,
4557		struct usb_device *udev,
4558		enum usb3_link_state state)
4559{
4560	if (xhci->quirks & XHCI_INTEL_HOST)
4561		return xhci_check_intel_tier_policy(udev, state);
4562	else
4563		return 0;
4564}
4565
4566/* Returns the U1 or U2 timeout that should be enabled.
4567 * If the tier check or timeout setting functions return with a non-zero exit
4568 * code, that means the timeout value has been finalized and we shouldn't look
4569 * at any more endpoints.
4570 */
4571static u16 xhci_calculate_lpm_timeout(struct usb_hcd *hcd,
4572			struct usb_device *udev, enum usb3_link_state state)
4573{
4574	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4575	struct usb_host_config *config;
4576	char *state_name;
4577	int i;
4578	u16 timeout = USB3_LPM_DISABLED;
4579
4580	if (state == USB3_LPM_U1)
4581		state_name = "U1";
4582	else if (state == USB3_LPM_U2)
4583		state_name = "U2";
4584	else {
4585		dev_warn(&udev->dev, "Can't enable unknown link state %i\n",
4586				state);
4587		return timeout;
4588	}
4589
4590	if (xhci_check_tier_policy(xhci, udev, state) < 0)
4591		return timeout;
4592
4593	/* Gather some information about the currently installed configuration
4594	 * and alternate interface settings.
4595	 */
4596	if (xhci_update_timeout_for_endpoint(xhci, udev, &udev->ep0.desc,
4597			state, &timeout))
4598		return timeout;
4599
4600	config = udev->actconfig;
4601	if (!config)
4602		return timeout;
4603
4604	for (i = 0; i < config->desc.bNumInterfaces; i++) {
4605		struct usb_driver *driver;
4606		struct usb_interface *intf = config->interface[i];
4607
4608		if (!intf)
4609			continue;
4610
4611		/* Check if any currently bound drivers want hub-initiated LPM
4612		 * disabled.
4613		 */
4614		if (intf->dev.driver) {
4615			driver = to_usb_driver(intf->dev.driver);
4616			if (driver && driver->disable_hub_initiated_lpm) {
4617				dev_dbg(&udev->dev, "Hub-initiated %s disabled "
4618						"at request of driver %s\n",
4619						state_name, driver->name);
4620				return xhci_get_timeout_no_hub_lpm(udev, state);
4621			}
4622		}
4623
4624		/* Not sure how this could happen... */
4625		if (!intf->cur_altsetting)
4626			continue;
4627
4628		if (xhci_update_timeout_for_interface(xhci, udev,
4629					intf->cur_altsetting,
4630					state, &timeout))
4631			return timeout;
4632	}
4633	return timeout;
4634}
4635
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4636static int calculate_max_exit_latency(struct usb_device *udev,
4637		enum usb3_link_state state_changed,
4638		u16 hub_encoded_timeout)
4639{
4640	unsigned long long u1_mel_us = 0;
4641	unsigned long long u2_mel_us = 0;
4642	unsigned long long mel_us = 0;
4643	bool disabling_u1;
4644	bool disabling_u2;
4645	bool enabling_u1;
4646	bool enabling_u2;
4647
4648	disabling_u1 = (state_changed == USB3_LPM_U1 &&
4649			hub_encoded_timeout == USB3_LPM_DISABLED);
4650	disabling_u2 = (state_changed == USB3_LPM_U2 &&
4651			hub_encoded_timeout == USB3_LPM_DISABLED);
4652
4653	enabling_u1 = (state_changed == USB3_LPM_U1 &&
4654			hub_encoded_timeout != USB3_LPM_DISABLED);
4655	enabling_u2 = (state_changed == USB3_LPM_U2 &&
4656			hub_encoded_timeout != USB3_LPM_DISABLED);
4657
4658	/* If U1 was already enabled and we're not disabling it,
4659	 * or we're going to enable U1, account for the U1 max exit latency.
4660	 */
4661	if ((udev->u1_params.timeout != USB3_LPM_DISABLED && !disabling_u1) ||
4662			enabling_u1)
4663		u1_mel_us = DIV_ROUND_UP(udev->u1_params.mel, 1000);
4664	if ((udev->u2_params.timeout != USB3_LPM_DISABLED && !disabling_u2) ||
4665			enabling_u2)
4666		u2_mel_us = DIV_ROUND_UP(udev->u2_params.mel, 1000);
4667
4668	if (u1_mel_us > u2_mel_us)
4669		mel_us = u1_mel_us;
4670	else
4671		mel_us = u2_mel_us;
4672	/* xHCI host controller max exit latency field is only 16 bits wide. */
4673	if (mel_us > MAX_EXIT) {
4674		dev_warn(&udev->dev, "Link PM max exit latency of %lluus "
4675				"is too big.\n", mel_us);
4676		return -E2BIG;
4677	}
4678	return mel_us;
4679}
4680
4681/* Returns the USB3 hub-encoded value for the U1/U2 timeout. */
4682int xhci_enable_usb3_lpm_timeout(struct usb_hcd *hcd,
4683			struct usb_device *udev, enum usb3_link_state state)
4684{
4685	struct xhci_hcd	*xhci;
4686	u16 hub_encoded_timeout;
4687	int mel;
4688	int ret;
4689
4690	xhci = hcd_to_xhci(hcd);
4691	/* The LPM timeout values are pretty host-controller specific, so don't
4692	 * enable hub-initiated timeouts unless the vendor has provided
4693	 * information about their timeout algorithm.
4694	 */
4695	if (!xhci || !(xhci->quirks & XHCI_LPM_SUPPORT) ||
4696			!xhci->devs[udev->slot_id])
4697		return USB3_LPM_DISABLED;
4698
4699	hub_encoded_timeout = xhci_calculate_lpm_timeout(hcd, udev, state);
4700	mel = calculate_max_exit_latency(udev, state, hub_encoded_timeout);
4701	if (mel < 0) {
4702		/* Max Exit Latency is too big, disable LPM. */
4703		hub_encoded_timeout = USB3_LPM_DISABLED;
4704		mel = 0;
4705	}
4706
4707	ret = xhci_change_max_exit_latency(xhci, udev, mel);
4708	if (ret)
4709		return ret;
4710	return hub_encoded_timeout;
4711}
4712
4713int xhci_disable_usb3_lpm_timeout(struct usb_hcd *hcd,
4714			struct usb_device *udev, enum usb3_link_state state)
4715{
4716	struct xhci_hcd	*xhci;
4717	u16 mel;
 
4718
4719	xhci = hcd_to_xhci(hcd);
4720	if (!xhci || !(xhci->quirks & XHCI_LPM_SUPPORT) ||
4721			!xhci->devs[udev->slot_id])
4722		return 0;
4723
4724	mel = calculate_max_exit_latency(udev, state, USB3_LPM_DISABLED);
4725	return xhci_change_max_exit_latency(xhci, udev, mel);
4726}
4727#else /* CONFIG_PM */
4728
4729int xhci_set_usb2_hardware_lpm(struct usb_hcd *hcd,
4730				struct usb_device *udev, int enable)
4731{
4732	return 0;
4733}
4734
4735int xhci_update_device(struct usb_hcd *hcd, struct usb_device *udev)
4736{
4737	return 0;
4738}
 
4739
4740int xhci_enable_usb3_lpm_timeout(struct usb_hcd *hcd,
4741			struct usb_device *udev, enum usb3_link_state state)
4742{
4743	return USB3_LPM_DISABLED;
4744}
4745
4746int xhci_disable_usb3_lpm_timeout(struct usb_hcd *hcd,
4747			struct usb_device *udev, enum usb3_link_state state)
4748{
4749	return 0;
4750}
4751#endif	/* CONFIG_PM */
4752
4753/*-------------------------------------------------------------------------*/
4754
4755/* Once a hub descriptor is fetched for a device, we need to update the xHC's
4756 * internal data structures for the device.
4757 */
4758int xhci_update_hub_device(struct usb_hcd *hcd, struct usb_device *hdev,
4759			struct usb_tt *tt, gfp_t mem_flags)
4760{
4761	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4762	struct xhci_virt_device *vdev;
4763	struct xhci_command *config_cmd;
4764	struct xhci_input_control_ctx *ctrl_ctx;
4765	struct xhci_slot_ctx *slot_ctx;
4766	unsigned long flags;
4767	unsigned think_time;
4768	int ret;
4769
4770	/* Ignore root hubs */
4771	if (!hdev->parent)
4772		return 0;
4773
4774	vdev = xhci->devs[hdev->slot_id];
4775	if (!vdev) {
4776		xhci_warn(xhci, "Cannot update hub desc for unknown device.\n");
4777		return -EINVAL;
4778	}
4779	config_cmd = xhci_alloc_command(xhci, true, true, mem_flags);
4780	if (!config_cmd) {
4781		xhci_dbg(xhci, "Could not allocate xHCI command structure.\n");
4782		return -ENOMEM;
4783	}
4784	ctrl_ctx = xhci_get_input_control_ctx(config_cmd->in_ctx);
4785	if (!ctrl_ctx) {
4786		xhci_warn(xhci, "%s: Could not get input context, bad type.\n",
4787				__func__);
4788		xhci_free_command(xhci, config_cmd);
4789		return -ENOMEM;
4790	}
4791
4792	spin_lock_irqsave(&xhci->lock, flags);
4793	if (hdev->speed == USB_SPEED_HIGH &&
4794			xhci_alloc_tt_info(xhci, vdev, hdev, tt, GFP_ATOMIC)) {
4795		xhci_dbg(xhci, "Could not allocate xHCI TT structure.\n");
4796		xhci_free_command(xhci, config_cmd);
4797		spin_unlock_irqrestore(&xhci->lock, flags);
4798		return -ENOMEM;
4799	}
4800
4801	xhci_slot_copy(xhci, config_cmd->in_ctx, vdev->out_ctx);
 
4802	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
4803	slot_ctx = xhci_get_slot_ctx(xhci, config_cmd->in_ctx);
4804	slot_ctx->dev_info |= cpu_to_le32(DEV_HUB);
4805	/*
4806	 * refer to section 6.2.2: MTT should be 0 for full speed hub,
4807	 * but it may be already set to 1 when setup an xHCI virtual
4808	 * device, so clear it anyway.
4809	 */
4810	if (tt->multi)
4811		slot_ctx->dev_info |= cpu_to_le32(DEV_MTT);
4812	else if (hdev->speed == USB_SPEED_FULL)
4813		slot_ctx->dev_info &= cpu_to_le32(~DEV_MTT);
4814
4815	if (xhci->hci_version > 0x95) {
4816		xhci_dbg(xhci, "xHCI version %x needs hub "
4817				"TT think time and number of ports\n",
4818				(unsigned int) xhci->hci_version);
4819		slot_ctx->dev_info2 |= cpu_to_le32(XHCI_MAX_PORTS(hdev->maxchild));
4820		/* Set TT think time - convert from ns to FS bit times.
4821		 * 0 = 8 FS bit times, 1 = 16 FS bit times,
4822		 * 2 = 24 FS bit times, 3 = 32 FS bit times.
4823		 *
4824		 * xHCI 1.0: this field shall be 0 if the device is not a
4825		 * High-spped hub.
4826		 */
4827		think_time = tt->think_time;
4828		if (think_time != 0)
4829			think_time = (think_time / 666) - 1;
4830		if (xhci->hci_version < 0x100 || hdev->speed == USB_SPEED_HIGH)
4831			slot_ctx->tt_info |=
4832				cpu_to_le32(TT_THINK_TIME(think_time));
4833	} else {
4834		xhci_dbg(xhci, "xHCI version %x doesn't need hub "
4835				"TT think time or number of ports\n",
4836				(unsigned int) xhci->hci_version);
4837	}
4838	slot_ctx->dev_state = 0;
4839	spin_unlock_irqrestore(&xhci->lock, flags);
4840
4841	xhci_dbg(xhci, "Set up %s for hub device.\n",
4842			(xhci->hci_version > 0x95) ?
4843			"configure endpoint" : "evaluate context");
4844	xhci_dbg(xhci, "Slot %u Input Context:\n", hdev->slot_id);
4845	xhci_dbg_ctx(xhci, config_cmd->in_ctx, 0);
4846
4847	/* Issue and wait for the configure endpoint or
4848	 * evaluate context command.
4849	 */
4850	if (xhci->hci_version > 0x95)
4851		ret = xhci_configure_endpoint(xhci, hdev, config_cmd,
4852				false, false);
4853	else
4854		ret = xhci_configure_endpoint(xhci, hdev, config_cmd,
4855				true, false);
4856
4857	xhci_dbg(xhci, "Slot %u Output Context:\n", hdev->slot_id);
4858	xhci_dbg_ctx(xhci, vdev->out_ctx, 0);
4859
4860	xhci_free_command(xhci, config_cmd);
4861	return ret;
4862}
4863
4864int xhci_get_frame(struct usb_hcd *hcd)
4865{
4866	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4867	/* EHCI mods by the periodic size.  Why? */
4868	return readl(&xhci->run_regs->microframe_index) >> 3;
4869}
4870
4871int xhci_gen_setup(struct usb_hcd *hcd, xhci_get_quirks_t get_quirks)
4872{
4873	struct xhci_hcd		*xhci;
4874	struct device		*dev = hcd->self.controller;
4875	int			retval;
 
4876
4877	/* Accept arbitrarily long scatter-gather lists */
4878	hcd->self.sg_tablesize = ~0;
4879
4880	/* support to build packet from discontinuous buffers */
4881	hcd->self.no_sg_constraint = 1;
4882
4883	/* XHCI controllers don't stop the ep queue on short packets :| */
4884	hcd->self.no_stop_on_short = 1;
4885
4886	xhci = hcd_to_xhci(hcd);
4887
4888	if (usb_hcd_is_primary_hcd(hcd)) {
 
 
 
 
4889		xhci->main_hcd = hcd;
4890		/* Mark the first roothub as being USB 2.0.
4891		 * The xHCI driver will register the USB 3.0 roothub.
4892		 */
4893		hcd->speed = HCD_USB2;
4894		hcd->self.root_hub->speed = USB_SPEED_HIGH;
4895		/*
4896		 * USB 2.0 roothub under xHCI has an integrated TT,
4897		 * (rate matching hub) as opposed to having an OHCI/UHCI
4898		 * companion controller.
4899		 */
4900		hcd->has_tt = 1;
4901	} else {
4902		if (xhci->sbrn == 0x31) {
4903			xhci_info(xhci, "Host supports USB 3.1 Enhanced SuperSpeed\n");
4904			hcd->speed = HCD_USB31;
4905			hcd->self.root_hub->speed = USB_SPEED_SUPER_PLUS;
4906		}
4907		/* xHCI private pointer was set in xhci_pci_probe for the second
4908		 * registered roothub.
4909		 */
 
 
 
 
 
 
 
 
4910		return 0;
4911	}
4912
4913	mutex_init(&xhci->mutex);
4914	xhci->cap_regs = hcd->regs;
4915	xhci->op_regs = hcd->regs +
4916		HC_LENGTH(readl(&xhci->cap_regs->hc_capbase));
4917	xhci->run_regs = hcd->regs +
4918		(readl(&xhci->cap_regs->run_regs_off) & RTSOFF_MASK);
4919	/* Cache read-only capability registers */
4920	xhci->hcs_params1 = readl(&xhci->cap_regs->hcs_params1);
4921	xhci->hcs_params2 = readl(&xhci->cap_regs->hcs_params2);
4922	xhci->hcs_params3 = readl(&xhci->cap_regs->hcs_params3);
4923	xhci->hcc_params = readl(&xhci->cap_regs->hc_capbase);
4924	xhci->hci_version = HC_VERSION(xhci->hcc_params);
4925	xhci->hcc_params = readl(&xhci->cap_regs->hcc_params);
4926	if (xhci->hci_version > 0x100)
4927		xhci->hcc_params2 = readl(&xhci->cap_regs->hcc_params2);
4928	xhci_print_registers(xhci);
4929
4930	xhci->quirks = quirks;
4931
4932	get_quirks(dev, xhci);
4933
4934	/* In xhci controllers which follow xhci 1.0 spec gives a spurious
4935	 * success event after a short transfer. This quirk will ignore such
4936	 * spurious event.
4937	 */
4938	if (xhci->hci_version > 0x96)
4939		xhci->quirks |= XHCI_SPURIOUS_SUCCESS;
4940
4941	/* Make sure the HC is halted. */
4942	retval = xhci_halt(xhci);
4943	if (retval)
4944		return retval;
4945
4946	xhci_dbg(xhci, "Resetting HCD\n");
4947	/* Reset the internal HC memory state and registers. */
4948	retval = xhci_reset(xhci);
4949	if (retval)
4950		return retval;
4951	xhci_dbg(xhci, "Reset complete\n");
4952
4953	/*
4954	 * On some xHCI controllers (e.g. R-Car SoCs), the AC64 bit (bit 0)
4955	 * of HCCPARAMS1 is set to 1. However, the xHCs don't support 64-bit
4956	 * address memory pointers actually. So, this driver clears the AC64
4957	 * bit of xhci->hcc_params to call dma_set_coherent_mask(dev,
4958	 * DMA_BIT_MASK(32)) in this xhci_gen_setup().
4959	 */
4960	if (xhci->quirks & XHCI_NO_64BIT_SUPPORT)
4961		xhci->hcc_params &= ~BIT(0);
4962
4963	/* Set dma_mask and coherent_dma_mask to 64-bits,
4964	 * if xHC supports 64-bit addressing */
4965	if (HCC_64BIT_ADDR(xhci->hcc_params) &&
4966			!dma_set_mask(dev, DMA_BIT_MASK(64))) {
4967		xhci_dbg(xhci, "Enabling 64-bit DMA addresses.\n");
4968		dma_set_coherent_mask(dev, DMA_BIT_MASK(64));
4969	} else {
4970		/*
4971		 * This is to avoid error in cases where a 32-bit USB
4972		 * controller is used on a 64-bit capable system.
4973		 */
4974		retval = dma_set_mask(dev, DMA_BIT_MASK(32));
4975		if (retval)
4976			return retval;
4977		xhci_dbg(xhci, "Enabling 32-bit DMA addresses.\n");
4978		dma_set_coherent_mask(dev, DMA_BIT_MASK(32));
4979	}
4980
4981	xhci_dbg(xhci, "Calling HCD init\n");
4982	/* Initialize HCD and host controller data structures. */
4983	retval = xhci_init(hcd);
4984	if (retval)
4985		return retval;
4986	xhci_dbg(xhci, "Called HCD init\n");
4987
4988	xhci_info(xhci, "hcc params 0x%08x hci version 0x%x quirks 0x%08x\n",
4989		  xhci->hcc_params, xhci->hci_version, xhci->quirks);
4990
4991	return 0;
 
 
 
4992}
4993EXPORT_SYMBOL_GPL(xhci_gen_setup);
4994
4995static const struct hc_driver xhci_hc_driver = {
4996	.description =		"xhci-hcd",
4997	.product_desc =		"xHCI Host Controller",
4998	.hcd_priv_size =	sizeof(struct xhci_hcd),
4999
5000	/*
5001	 * generic hardware linkage
5002	 */
5003	.irq =			xhci_irq,
5004	.flags =		HCD_MEMORY | HCD_USB3 | HCD_SHARED,
5005
5006	/*
5007	 * basic lifecycle operations
5008	 */
5009	.reset =		NULL, /* set in xhci_init_driver() */
5010	.start =		xhci_run,
5011	.stop =			xhci_stop,
5012	.shutdown =		xhci_shutdown,
5013
5014	/*
5015	 * managing i/o requests and associated device resources
5016	 */
5017	.urb_enqueue =		xhci_urb_enqueue,
5018	.urb_dequeue =		xhci_urb_dequeue,
5019	.alloc_dev =		xhci_alloc_dev,
5020	.free_dev =		xhci_free_dev,
5021	.alloc_streams =	xhci_alloc_streams,
5022	.free_streams =		xhci_free_streams,
5023	.add_endpoint =		xhci_add_endpoint,
5024	.drop_endpoint =	xhci_drop_endpoint,
5025	.endpoint_reset =	xhci_endpoint_reset,
5026	.check_bandwidth =	xhci_check_bandwidth,
5027	.reset_bandwidth =	xhci_reset_bandwidth,
5028	.address_device =	xhci_address_device,
5029	.enable_device =	xhci_enable_device,
5030	.update_hub_device =	xhci_update_hub_device,
5031	.reset_device =		xhci_discover_or_reset_device,
5032
5033	/*
5034	 * scheduling support
5035	 */
5036	.get_frame_number =	xhci_get_frame,
5037
5038	/*
5039	 * root hub support
5040	 */
5041	.hub_control =		xhci_hub_control,
5042	.hub_status_data =	xhci_hub_status_data,
5043	.bus_suspend =		xhci_bus_suspend,
5044	.bus_resume =		xhci_bus_resume,
5045
5046	/*
5047	 * call back when device connected and addressed
5048	 */
5049	.update_device =        xhci_update_device,
5050	.set_usb2_hw_lpm =	xhci_set_usb2_hardware_lpm,
5051	.enable_usb3_lpm_timeout =	xhci_enable_usb3_lpm_timeout,
5052	.disable_usb3_lpm_timeout =	xhci_disable_usb3_lpm_timeout,
5053	.find_raw_port_number =	xhci_find_raw_port_number,
5054};
5055
5056void xhci_init_driver(struct hc_driver *drv,
5057		      const struct xhci_driver_overrides *over)
5058{
5059	BUG_ON(!over);
5060
5061	/* Copy the generic table to drv then apply the overrides */
5062	*drv = xhci_hc_driver;
5063
5064	if (over) {
5065		drv->hcd_priv_size += over->extra_priv_size;
5066		if (over->reset)
5067			drv->reset = over->reset;
5068		if (over->start)
5069			drv->start = over->start;
5070	}
5071}
5072EXPORT_SYMBOL_GPL(xhci_init_driver);
5073
5074MODULE_DESCRIPTION(DRIVER_DESC);
5075MODULE_AUTHOR(DRIVER_AUTHOR);
5076MODULE_LICENSE("GPL");
5077
5078static int __init xhci_hcd_init(void)
5079{
 
 
 
 
 
 
 
 
 
 
 
 
5080	/*
5081	 * Check the compiler generated sizes of structures that must be laid
5082	 * out in specific ways for hardware access.
5083	 */
5084	BUILD_BUG_ON(sizeof(struct xhci_doorbell_array) != 256*32/8);
5085	BUILD_BUG_ON(sizeof(struct xhci_slot_ctx) != 8*32/8);
5086	BUILD_BUG_ON(sizeof(struct xhci_ep_ctx) != 8*32/8);
5087	/* xhci_device_control has eight fields, and also
5088	 * embeds one xhci_slot_ctx and 31 xhci_ep_ctx
5089	 */
5090	BUILD_BUG_ON(sizeof(struct xhci_stream_ctx) != 4*32/8);
5091	BUILD_BUG_ON(sizeof(union xhci_trb) != 4*32/8);
5092	BUILD_BUG_ON(sizeof(struct xhci_erst_entry) != 4*32/8);
5093	BUILD_BUG_ON(sizeof(struct xhci_cap_regs) != 8*32/8);
5094	BUILD_BUG_ON(sizeof(struct xhci_intr_reg) != 8*32/8);
5095	/* xhci_run_regs has eight fields and embeds 128 xhci_intr_regs */
5096	BUILD_BUG_ON(sizeof(struct xhci_run_regs) != (8+8*128)*32/8);
5097
5098	if (usb_disabled())
5099		return -ENODEV;
5100
5101	return 0;
 
 
 
5102}
5103
5104/*
5105 * If an init function is provided, an exit function must also be provided
5106 * to allow module unload.
5107 */
5108static void __exit xhci_hcd_fini(void) { }
5109
5110module_init(xhci_hcd_init);
5111module_exit(xhci_hcd_fini);
 
 
 
 
 
 
v3.5.6
   1/*
   2 * xHCI host controller driver
   3 *
   4 * Copyright (C) 2008 Intel Corp.
   5 *
   6 * Author: Sarah Sharp
   7 * Some code borrowed from the Linux EHCI driver.
   8 *
   9 * This program is free software; you can redistribute it and/or modify
  10 * it under the terms of the GNU General Public License version 2 as
  11 * published by the Free Software Foundation.
  12 *
  13 * This program is distributed in the hope that it will be useful, but
  14 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  15 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  16 * for more details.
  17 *
  18 * You should have received a copy of the GNU General Public License
  19 * along with this program; if not, write to the Free Software Foundation,
  20 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23#include <linux/pci.h>
  24#include <linux/irq.h>
  25#include <linux/log2.h>
  26#include <linux/module.h>
  27#include <linux/moduleparam.h>
  28#include <linux/slab.h>
  29#include <linux/dmi.h>
 
  30
  31#include "xhci.h"
 
 
  32
  33#define DRIVER_AUTHOR "Sarah Sharp"
  34#define DRIVER_DESC "'eXtensible' Host Controller (xHC) Driver"
  35
 
 
  36/* Some 0.95 hardware can't handle the chain bit on a Link TRB being cleared */
  37static int link_quirk;
  38module_param(link_quirk, int, S_IRUGO | S_IWUSR);
  39MODULE_PARM_DESC(link_quirk, "Don't clear the chain bit on a link TRB");
  40
 
 
 
 
  41/* TODO: copied from ehci-hcd.c - can this be refactored? */
  42/*
  43 * handshake - spin reading hc until handshake completes or fails
  44 * @ptr: address of hc register to be read
  45 * @mask: bits to look at in result of read
  46 * @done: value of those bits when handshake succeeds
  47 * @usec: timeout in microseconds
  48 *
  49 * Returns negative errno, or zero on success
  50 *
  51 * Success happens when the "mask" bits have the specified value (hardware
  52 * handshake done).  There are two failure modes:  "usec" have passed (major
  53 * hardware flakeout), or the register reads as all-ones (hardware removed).
  54 */
  55int handshake(struct xhci_hcd *xhci, void __iomem *ptr,
  56		      u32 mask, u32 done, int usec)
  57{
  58	u32	result;
  59
  60	do {
  61		result = xhci_readl(xhci, ptr);
  62		if (result == ~(u32)0)		/* card removed */
  63			return -ENODEV;
  64		result &= mask;
  65		if (result == done)
  66			return 0;
  67		udelay(1);
  68		usec--;
  69	} while (usec > 0);
  70	return -ETIMEDOUT;
  71}
  72
  73/*
  74 * Disable interrupts and begin the xHCI halting process.
  75 */
  76void xhci_quiesce(struct xhci_hcd *xhci)
  77{
  78	u32 halted;
  79	u32 cmd;
  80	u32 mask;
  81
  82	mask = ~(XHCI_IRQS);
  83	halted = xhci_readl(xhci, &xhci->op_regs->status) & STS_HALT;
  84	if (!halted)
  85		mask &= ~CMD_RUN;
  86
  87	cmd = xhci_readl(xhci, &xhci->op_regs->command);
  88	cmd &= mask;
  89	xhci_writel(xhci, cmd, &xhci->op_regs->command);
  90}
  91
  92/*
  93 * Force HC into halt state.
  94 *
  95 * Disable any IRQs and clear the run/stop bit.
  96 * HC will complete any current and actively pipelined transactions, and
  97 * should halt within 16 ms of the run/stop bit being cleared.
  98 * Read HC Halted bit in the status register to see when the HC is finished.
  99 */
 100int xhci_halt(struct xhci_hcd *xhci)
 101{
 102	int ret;
 103	xhci_dbg(xhci, "// Halt the HC\n");
 104	xhci_quiesce(xhci);
 105
 106	ret = handshake(xhci, &xhci->op_regs->status,
 107			STS_HALT, STS_HALT, XHCI_MAX_HALT_USEC);
 108	if (!ret) {
 109		xhci->xhc_state |= XHCI_STATE_HALTED;
 110		xhci->cmd_ring_state = CMD_RING_STATE_STOPPED;
 111	} else
 112		xhci_warn(xhci, "Host not halted after %u microseconds.\n",
 113				XHCI_MAX_HALT_USEC);
 114	return ret;
 115}
 116
 117/*
 118 * Set the run bit and wait for the host to be running.
 119 */
 120static int xhci_start(struct xhci_hcd *xhci)
 121{
 122	u32 temp;
 123	int ret;
 124
 125	temp = xhci_readl(xhci, &xhci->op_regs->command);
 126	temp |= (CMD_RUN);
 127	xhci_dbg(xhci, "// Turn on HC, cmd = 0x%x.\n",
 128			temp);
 129	xhci_writel(xhci, temp, &xhci->op_regs->command);
 130
 131	/*
 132	 * Wait for the HCHalted Status bit to be 0 to indicate the host is
 133	 * running.
 134	 */
 135	ret = handshake(xhci, &xhci->op_regs->status,
 136			STS_HALT, 0, XHCI_MAX_HALT_USEC);
 137	if (ret == -ETIMEDOUT)
 138		xhci_err(xhci, "Host took too long to start, "
 139				"waited %u microseconds.\n",
 140				XHCI_MAX_HALT_USEC);
 141	if (!ret)
 142		xhci->xhc_state &= ~XHCI_STATE_HALTED;
 
 
 143	return ret;
 144}
 145
 146/*
 147 * Reset a halted HC.
 148 *
 149 * This resets pipelines, timers, counters, state machines, etc.
 150 * Transactions will be terminated immediately, and operational registers
 151 * will be set to their defaults.
 152 */
 153int xhci_reset(struct xhci_hcd *xhci)
 154{
 155	u32 command;
 156	u32 state;
 157	int ret, i;
 158
 159	state = xhci_readl(xhci, &xhci->op_regs->status);
 160	if ((state & STS_HALT) == 0) {
 161		xhci_warn(xhci, "Host controller not halted, aborting reset.\n");
 162		return 0;
 163	}
 164
 165	xhci_dbg(xhci, "// Reset the HC\n");
 166	command = xhci_readl(xhci, &xhci->op_regs->command);
 167	command |= CMD_RESET;
 168	xhci_writel(xhci, command, &xhci->op_regs->command);
 
 
 
 
 
 
 
 
 
 
 169
 170	ret = handshake(xhci, &xhci->op_regs->command,
 171			CMD_RESET, 0, 10 * 1000 * 1000);
 172	if (ret)
 173		return ret;
 174
 175	xhci_dbg(xhci, "Wait for controller to be ready for doorbell rings\n");
 
 176	/*
 177	 * xHCI cannot write to any doorbells or operational registers other
 178	 * than status until the "Controller Not Ready" flag is cleared.
 179	 */
 180	ret = handshake(xhci, &xhci->op_regs->status,
 181			STS_CNR, 0, 10 * 1000 * 1000);
 182
 183	for (i = 0; i < 2; ++i) {
 184		xhci->bus_state[i].port_c_suspend = 0;
 185		xhci->bus_state[i].suspended_ports = 0;
 186		xhci->bus_state[i].resuming_ports = 0;
 187	}
 188
 189	return ret;
 190}
 191
 192#ifdef CONFIG_PCI
 193static int xhci_free_msi(struct xhci_hcd *xhci)
 194{
 195	int i;
 196
 197	if (!xhci->msix_entries)
 198		return -EINVAL;
 199
 200	for (i = 0; i < xhci->msix_count; i++)
 201		if (xhci->msix_entries[i].vector)
 202			free_irq(xhci->msix_entries[i].vector,
 203					xhci_to_hcd(xhci));
 204	return 0;
 205}
 206
 207/*
 208 * Set up MSI
 209 */
 210static int xhci_setup_msi(struct xhci_hcd *xhci)
 211{
 212	int ret;
 213	struct pci_dev  *pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 214
 215	ret = pci_enable_msi(pdev);
 216	if (ret) {
 217		xhci_dbg(xhci, "failed to allocate MSI entry\n");
 
 218		return ret;
 219	}
 220
 221	ret = request_irq(pdev->irq, (irq_handler_t)xhci_msi_irq,
 222				0, "xhci_hcd", xhci_to_hcd(xhci));
 223	if (ret) {
 224		xhci_dbg(xhci, "disable MSI interrupt\n");
 
 225		pci_disable_msi(pdev);
 226	}
 227
 228	return ret;
 229}
 230
 231/*
 232 * Free IRQs
 233 * free all IRQs request
 234 */
 235static void xhci_free_irq(struct xhci_hcd *xhci)
 236{
 237	struct pci_dev *pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 238	int ret;
 239
 240	/* return if using legacy interrupt */
 241	if (xhci_to_hcd(xhci)->irq > 0)
 242		return;
 243
 244	ret = xhci_free_msi(xhci);
 245	if (!ret)
 246		return;
 247	if (pdev->irq > 0)
 248		free_irq(pdev->irq, xhci_to_hcd(xhci));
 249
 250	return;
 251}
 252
 253/*
 254 * Set up MSI-X
 255 */
 256static int xhci_setup_msix(struct xhci_hcd *xhci)
 257{
 258	int i, ret = 0;
 259	struct usb_hcd *hcd = xhci_to_hcd(xhci);
 260	struct pci_dev *pdev = to_pci_dev(hcd->self.controller);
 261
 262	/*
 263	 * calculate number of msi-x vectors supported.
 264	 * - HCS_MAX_INTRS: the max number of interrupts the host can handle,
 265	 *   with max number of interrupters based on the xhci HCSPARAMS1.
 266	 * - num_online_cpus: maximum msi-x vectors per CPUs core.
 267	 *   Add additional 1 vector to ensure always available interrupt.
 268	 */
 269	xhci->msix_count = min(num_online_cpus() + 1,
 270				HCS_MAX_INTRS(xhci->hcs_params1));
 271
 272	xhci->msix_entries =
 273		kmalloc((sizeof(struct msix_entry))*xhci->msix_count,
 274				GFP_KERNEL);
 275	if (!xhci->msix_entries) {
 276		xhci_err(xhci, "Failed to allocate MSI-X entries\n");
 277		return -ENOMEM;
 278	}
 279
 280	for (i = 0; i < xhci->msix_count; i++) {
 281		xhci->msix_entries[i].entry = i;
 282		xhci->msix_entries[i].vector = 0;
 283	}
 284
 285	ret = pci_enable_msix(pdev, xhci->msix_entries, xhci->msix_count);
 286	if (ret) {
 287		xhci_dbg(xhci, "Failed to enable MSI-X\n");
 
 288		goto free_entries;
 289	}
 290
 291	for (i = 0; i < xhci->msix_count; i++) {
 292		ret = request_irq(xhci->msix_entries[i].vector,
 293				(irq_handler_t)xhci_msi_irq,
 294				0, "xhci_hcd", xhci_to_hcd(xhci));
 295		if (ret)
 296			goto disable_msix;
 297	}
 298
 299	hcd->msix_enabled = 1;
 300	return ret;
 301
 302disable_msix:
 303	xhci_dbg(xhci, "disable MSI-X interrupt\n");
 304	xhci_free_irq(xhci);
 305	pci_disable_msix(pdev);
 306free_entries:
 307	kfree(xhci->msix_entries);
 308	xhci->msix_entries = NULL;
 309	return ret;
 310}
 311
 312/* Free any IRQs and disable MSI-X */
 313static void xhci_cleanup_msix(struct xhci_hcd *xhci)
 314{
 315	struct usb_hcd *hcd = xhci_to_hcd(xhci);
 316	struct pci_dev *pdev = to_pci_dev(hcd->self.controller);
 317
 
 
 
 318	xhci_free_irq(xhci);
 319
 320	if (xhci->msix_entries) {
 321		pci_disable_msix(pdev);
 322		kfree(xhci->msix_entries);
 323		xhci->msix_entries = NULL;
 324	} else {
 325		pci_disable_msi(pdev);
 326	}
 327
 328	hcd->msix_enabled = 0;
 329	return;
 330}
 331
 332static void xhci_msix_sync_irqs(struct xhci_hcd *xhci)
 333{
 334	int i;
 335
 336	if (xhci->msix_entries) {
 337		for (i = 0; i < xhci->msix_count; i++)
 338			synchronize_irq(xhci->msix_entries[i].vector);
 339	}
 340}
 341
 342static int xhci_try_enable_msi(struct usb_hcd *hcd)
 343{
 344	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 345	struct pci_dev  *pdev = to_pci_dev(xhci_to_hcd(xhci)->self.controller);
 346	int ret;
 347
 
 
 
 
 
 348	/*
 349	 * Some Fresco Logic host controllers advertise MSI, but fail to
 350	 * generate interrupts.  Don't even try to enable MSI.
 351	 */
 352	if (xhci->quirks & XHCI_BROKEN_MSI)
 353		return 0;
 354
 355	/* unregister the legacy interrupt */
 356	if (hcd->irq)
 357		free_irq(hcd->irq, hcd);
 358	hcd->irq = 0;
 359
 360	ret = xhci_setup_msix(xhci);
 361	if (ret)
 362		/* fall back to msi*/
 363		ret = xhci_setup_msi(xhci);
 364
 365	if (!ret)
 366		/* hcd->irq is 0, we have MSI */
 367		return 0;
 368
 369	if (!pdev->irq) {
 370		xhci_err(xhci, "No msi-x/msi found and no IRQ in BIOS\n");
 371		return -EINVAL;
 372	}
 373
 
 
 
 
 
 374	/* fall back to legacy interrupt*/
 375	ret = request_irq(pdev->irq, &usb_hcd_irq, IRQF_SHARED,
 376			hcd->irq_descr, hcd);
 377	if (ret) {
 378		xhci_err(xhci, "request interrupt %d failed\n",
 379				pdev->irq);
 380		return ret;
 381	}
 382	hcd->irq = pdev->irq;
 383	return 0;
 384}
 385
 386#else
 387
 388static int xhci_try_enable_msi(struct usb_hcd *hcd)
 389{
 390	return 0;
 391}
 392
 393static void xhci_cleanup_msix(struct xhci_hcd *xhci)
 394{
 395}
 396
 397static void xhci_msix_sync_irqs(struct xhci_hcd *xhci)
 398{
 399}
 400
 401#endif
 402
 403static void compliance_mode_recovery(unsigned long arg)
 404{
 405	struct xhci_hcd *xhci;
 406	struct usb_hcd *hcd;
 407	u32 temp;
 408	int i;
 409
 410	xhci = (struct xhci_hcd *)arg;
 411
 412	for (i = 0; i < xhci->num_usb3_ports; i++) {
 413		temp = xhci_readl(xhci, xhci->usb3_ports[i]);
 414		if ((temp & PORT_PLS_MASK) == USB_SS_PORT_LS_COMP_MOD) {
 415			/*
 416			 * Compliance Mode Detected. Letting USB Core
 417			 * handle the Warm Reset
 418			 */
 419			xhci_dbg(xhci, "Compliance Mode Detected->Port %d!\n",
 
 420					i + 1);
 421			xhci_dbg(xhci, "Attempting Recovery routine!\n");
 
 422			hcd = xhci->shared_hcd;
 423
 424			if (hcd->state == HC_STATE_SUSPENDED)
 425				usb_hcd_resume_root_hub(hcd);
 426
 427			usb_hcd_poll_rh_status(hcd);
 428		}
 429	}
 430
 431	if (xhci->port_status_u0 != ((1 << xhci->num_usb3_ports)-1))
 432		mod_timer(&xhci->comp_mode_recovery_timer,
 433			jiffies + msecs_to_jiffies(COMP_MODE_RCVRY_MSECS));
 434}
 435
 436/*
 437 * Quirk to work around issue generated by the SN65LVPE502CP USB3.0 re-driver
 438 * that causes ports behind that hardware to enter compliance mode sometimes.
 439 * The quirk creates a timer that polls every 2 seconds the link state of
 440 * each host controller's port and recovers it by issuing a Warm reset
 441 * if Compliance mode is detected, otherwise the port will become "dead" (no
 442 * device connections or disconnections will be detected anymore). Becasue no
 443 * status event is generated when entering compliance mode (per xhci spec),
 444 * this quirk is needed on systems that have the failing hardware installed.
 445 */
 446static void compliance_mode_recovery_timer_init(struct xhci_hcd *xhci)
 447{
 448	xhci->port_status_u0 = 0;
 449	init_timer(&xhci->comp_mode_recovery_timer);
 450
 451	xhci->comp_mode_recovery_timer.data = (unsigned long) xhci;
 452	xhci->comp_mode_recovery_timer.function = compliance_mode_recovery;
 453	xhci->comp_mode_recovery_timer.expires = jiffies +
 454			msecs_to_jiffies(COMP_MODE_RCVRY_MSECS);
 455
 456	set_timer_slack(&xhci->comp_mode_recovery_timer,
 457			msecs_to_jiffies(COMP_MODE_RCVRY_MSECS));
 458	add_timer(&xhci->comp_mode_recovery_timer);
 459	xhci_dbg(xhci, "Compliance Mode Recovery Timer Initialized.\n");
 
 460}
 461
 462/*
 463 * This function identifies the systems that have installed the SN65LVPE502CP
 464 * USB3.0 re-driver and that need the Compliance Mode Quirk.
 465 * Systems:
 466 * Vendor: Hewlett-Packard -> System Models: Z420, Z620 and Z820
 467 */
 468static bool compliance_mode_recovery_timer_quirk_check(void)
 469{
 470	const char *dmi_product_name, *dmi_sys_vendor;
 471
 472	dmi_product_name = dmi_get_system_info(DMI_PRODUCT_NAME);
 473	dmi_sys_vendor = dmi_get_system_info(DMI_SYS_VENDOR);
 474	if (!dmi_product_name || !dmi_sys_vendor)
 475		return false;
 476
 477	if (!(strstr(dmi_sys_vendor, "Hewlett-Packard")))
 478		return false;
 479
 480	if (strstr(dmi_product_name, "Z420") ||
 481			strstr(dmi_product_name, "Z620") ||
 482			strstr(dmi_product_name, "Z820"))
 
 483		return true;
 484
 485	return false;
 486}
 487
 488static int xhci_all_ports_seen_u0(struct xhci_hcd *xhci)
 489{
 490	return (xhci->port_status_u0 == ((1 << xhci->num_usb3_ports)-1));
 491}
 492
 493
 494/*
 495 * Initialize memory for HCD and xHC (one-time init).
 496 *
 497 * Program the PAGESIZE register, initialize the device context array, create
 498 * device contexts (?), set up a command ring segment (or two?), create event
 499 * ring (one for now).
 500 */
 501int xhci_init(struct usb_hcd *hcd)
 502{
 503	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 504	int retval = 0;
 505
 506	xhci_dbg(xhci, "xhci_init\n");
 507	spin_lock_init(&xhci->lock);
 508	if (xhci->hci_version == 0x95 && link_quirk) {
 509		xhci_dbg(xhci, "QUIRK: Not clearing Link TRB chain bits.\n");
 
 510		xhci->quirks |= XHCI_LINK_TRB_QUIRK;
 511	} else {
 512		xhci_dbg(xhci, "xHCI doesn't need link TRB QUIRK\n");
 
 513	}
 514	retval = xhci_mem_init(xhci, GFP_KERNEL);
 515	xhci_dbg(xhci, "Finished xhci_init\n");
 516
 517	/* Initializing Compliance Mode Recovery Data If Needed */
 518	if (compliance_mode_recovery_timer_quirk_check()) {
 519		xhci->quirks |= XHCI_COMP_MODE_QUIRK;
 520		compliance_mode_recovery_timer_init(xhci);
 521	}
 522
 523	return retval;
 524}
 525
 526/*-------------------------------------------------------------------------*/
 527
 528
 529#ifdef CONFIG_USB_XHCI_HCD_DEBUGGING
 530static void xhci_event_ring_work(unsigned long arg)
 531{
 532	unsigned long flags;
 533	int temp;
 534	u64 temp_64;
 535	struct xhci_hcd *xhci = (struct xhci_hcd *) arg;
 536	int i, j;
 537
 538	xhci_dbg(xhci, "Poll event ring: %lu\n", jiffies);
 539
 540	spin_lock_irqsave(&xhci->lock, flags);
 541	temp = xhci_readl(xhci, &xhci->op_regs->status);
 542	xhci_dbg(xhci, "op reg status = 0x%x\n", temp);
 543	if (temp == 0xffffffff || (xhci->xhc_state & XHCI_STATE_DYING) ||
 544			(xhci->xhc_state & XHCI_STATE_HALTED)) {
 545		xhci_dbg(xhci, "HW died, polling stopped.\n");
 546		spin_unlock_irqrestore(&xhci->lock, flags);
 547		return;
 548	}
 549
 550	temp = xhci_readl(xhci, &xhci->ir_set->irq_pending);
 551	xhci_dbg(xhci, "ir_set 0 pending = 0x%x\n", temp);
 552	xhci_dbg(xhci, "HC error bitmask = 0x%x\n", xhci->error_bitmask);
 553	xhci->error_bitmask = 0;
 554	xhci_dbg(xhci, "Event ring:\n");
 555	xhci_debug_segment(xhci, xhci->event_ring->deq_seg);
 556	xhci_dbg_ring_ptrs(xhci, xhci->event_ring);
 557	temp_64 = xhci_read_64(xhci, &xhci->ir_set->erst_dequeue);
 558	temp_64 &= ~ERST_PTR_MASK;
 559	xhci_dbg(xhci, "ERST deq = 64'h%0lx\n", (long unsigned int) temp_64);
 560	xhci_dbg(xhci, "Command ring:\n");
 561	xhci_debug_segment(xhci, xhci->cmd_ring->deq_seg);
 562	xhci_dbg_ring_ptrs(xhci, xhci->cmd_ring);
 563	xhci_dbg_cmd_ptrs(xhci);
 564	for (i = 0; i < MAX_HC_SLOTS; ++i) {
 565		if (!xhci->devs[i])
 566			continue;
 567		for (j = 0; j < 31; ++j) {
 568			xhci_dbg_ep_rings(xhci, i, j, &xhci->devs[i]->eps[j]);
 569		}
 570	}
 571	spin_unlock_irqrestore(&xhci->lock, flags);
 572
 573	if (!xhci->zombie)
 574		mod_timer(&xhci->event_ring_timer, jiffies + POLL_TIMEOUT * HZ);
 575	else
 576		xhci_dbg(xhci, "Quit polling the event ring.\n");
 577}
 578#endif
 579
 580static int xhci_run_finished(struct xhci_hcd *xhci)
 581{
 582	if (xhci_start(xhci)) {
 583		xhci_halt(xhci);
 584		return -ENODEV;
 585	}
 586	xhci->shared_hcd->state = HC_STATE_RUNNING;
 587	xhci->cmd_ring_state = CMD_RING_STATE_RUNNING;
 588
 589	if (xhci->quirks & XHCI_NEC_HOST)
 590		xhci_ring_cmd_db(xhci);
 591
 592	xhci_dbg(xhci, "Finished xhci_run for USB3 roothub\n");
 
 593	return 0;
 594}
 595
 596/*
 597 * Start the HC after it was halted.
 598 *
 599 * This function is called by the USB core when the HC driver is added.
 600 * Its opposite is xhci_stop().
 601 *
 602 * xhci_init() must be called once before this function can be called.
 603 * Reset the HC, enable device slot contexts, program DCBAAP, and
 604 * set command ring pointer and event ring pointer.
 605 *
 606 * Setup MSI-X vectors and enable interrupts.
 607 */
 608int xhci_run(struct usb_hcd *hcd)
 609{
 610	u32 temp;
 611	u64 temp_64;
 612	int ret;
 613	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 614
 615	/* Start the xHCI host controller running only after the USB 2.0 roothub
 616	 * is setup.
 617	 */
 618
 619	hcd->uses_new_polling = 1;
 620	if (!usb_hcd_is_primary_hcd(hcd))
 621		return xhci_run_finished(xhci);
 622
 623	xhci_dbg(xhci, "xhci_run\n");
 624
 625	ret = xhci_try_enable_msi(hcd);
 626	if (ret)
 627		return ret;
 628
 629#ifdef CONFIG_USB_XHCI_HCD_DEBUGGING
 630	init_timer(&xhci->event_ring_timer);
 631	xhci->event_ring_timer.data = (unsigned long) xhci;
 632	xhci->event_ring_timer.function = xhci_event_ring_work;
 633	/* Poll the event ring */
 634	xhci->event_ring_timer.expires = jiffies + POLL_TIMEOUT * HZ;
 635	xhci->zombie = 0;
 636	xhci_dbg(xhci, "Setting event ring polling timer\n");
 637	add_timer(&xhci->event_ring_timer);
 638#endif
 639
 640	xhci_dbg(xhci, "Command ring memory map follows:\n");
 641	xhci_debug_ring(xhci, xhci->cmd_ring);
 642	xhci_dbg_ring_ptrs(xhci, xhci->cmd_ring);
 643	xhci_dbg_cmd_ptrs(xhci);
 644
 645	xhci_dbg(xhci, "ERST memory map follows:\n");
 646	xhci_dbg_erst(xhci, &xhci->erst);
 647	xhci_dbg(xhci, "Event ring:\n");
 648	xhci_debug_ring(xhci, xhci->event_ring);
 649	xhci_dbg_ring_ptrs(xhci, xhci->event_ring);
 650	temp_64 = xhci_read_64(xhci, &xhci->ir_set->erst_dequeue);
 651	temp_64 &= ~ERST_PTR_MASK;
 652	xhci_dbg(xhci, "ERST deq = 64'h%0lx\n", (long unsigned int) temp_64);
 
 653
 654	xhci_dbg(xhci, "// Set the interrupt modulation register\n");
 655	temp = xhci_readl(xhci, &xhci->ir_set->irq_control);
 
 656	temp &= ~ER_IRQ_INTERVAL_MASK;
 657	temp |= (u32) 160;
 658	xhci_writel(xhci, temp, &xhci->ir_set->irq_control);
 
 
 
 
 659
 660	/* Set the HCD state before we enable the irqs */
 661	temp = xhci_readl(xhci, &xhci->op_regs->command);
 662	temp |= (CMD_EIE);
 663	xhci_dbg(xhci, "// Enable interrupts, cmd = 0x%x.\n",
 664			temp);
 665	xhci_writel(xhci, temp, &xhci->op_regs->command);
 666
 667	temp = xhci_readl(xhci, &xhci->ir_set->irq_pending);
 668	xhci_dbg(xhci, "// Enabling event ring interrupter %p by writing 0x%x to irq_pending\n",
 
 669			xhci->ir_set, (unsigned int) ER_IRQ_ENABLE(temp));
 670	xhci_writel(xhci, ER_IRQ_ENABLE(temp),
 671			&xhci->ir_set->irq_pending);
 672	xhci_print_ir_set(xhci, 0);
 673
 674	if (xhci->quirks & XHCI_NEC_HOST)
 675		xhci_queue_vendor_command(xhci, 0, 0, 0,
 
 
 
 
 676				TRB_TYPE(TRB_NEC_GET_FW));
 677
 678	xhci_dbg(xhci, "Finished xhci_run for USB2 roothub\n");
 
 679	return 0;
 680}
 681
 682static void xhci_only_stop_hcd(struct usb_hcd *hcd)
 683{
 684	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 685
 686	spin_lock_irq(&xhci->lock);
 687	xhci_halt(xhci);
 688
 689	/* The shared_hcd is going to be deallocated shortly (the USB core only
 690	 * calls this function when allocation fails in usb_add_hcd(), or
 691	 * usb_remove_hcd() is called).  So we need to unset xHCI's pointer.
 692	 */
 693	xhci->shared_hcd = NULL;
 694	spin_unlock_irq(&xhci->lock);
 695}
 696
 697/*
 698 * Stop xHCI driver.
 699 *
 700 * This function is called by the USB core when the HC driver is removed.
 701 * Its opposite is xhci_run().
 702 *
 703 * Disable device contexts, disable IRQs, and quiesce the HC.
 704 * Reset the HC, finish any completed transactions, and cleanup memory.
 705 */
 706void xhci_stop(struct usb_hcd *hcd)
 707{
 708	u32 temp;
 709	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 710
 711	if (!usb_hcd_is_primary_hcd(hcd)) {
 712		xhci_only_stop_hcd(xhci->shared_hcd);
 713		return;
 714	}
 715
 
 716	spin_lock_irq(&xhci->lock);
 
 
 
 717	/* Make sure the xHC is halted for a USB3 roothub
 718	 * (xhci_stop() could be called as part of failed init).
 719	 */
 720	xhci_halt(xhci);
 721	xhci_reset(xhci);
 722	spin_unlock_irq(&xhci->lock);
 723
 724	xhci_cleanup_msix(xhci);
 725
 726#ifdef CONFIG_USB_XHCI_HCD_DEBUGGING
 727	/* Tell the event ring poll function not to reschedule */
 728	xhci->zombie = 1;
 729	del_timer_sync(&xhci->event_ring_timer);
 730#endif
 731
 732	/* Deleting Compliance Mode Recovery Timer */
 733	if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) &&
 734			(!(xhci_all_ports_seen_u0(xhci))))
 735		del_timer_sync(&xhci->comp_mode_recovery_timer);
 
 
 
 
 736
 737	if (xhci->quirks & XHCI_AMD_PLL_FIX)
 738		usb_amd_dev_put();
 739
 740	xhci_dbg(xhci, "// Disabling event ring interrupts\n");
 741	temp = xhci_readl(xhci, &xhci->op_regs->status);
 742	xhci_writel(xhci, temp & ~STS_EINT, &xhci->op_regs->status);
 743	temp = xhci_readl(xhci, &xhci->ir_set->irq_pending);
 744	xhci_writel(xhci, ER_IRQ_DISABLE(temp),
 745			&xhci->ir_set->irq_pending);
 746	xhci_print_ir_set(xhci, 0);
 747
 748	xhci_dbg(xhci, "cleaning up memory\n");
 749	xhci_mem_cleanup(xhci);
 750	xhci_dbg(xhci, "xhci_stop completed - status = %x\n",
 751		    xhci_readl(xhci, &xhci->op_regs->status));
 
 
 752}
 753
 754/*
 755 * Shutdown HC (not bus-specific)
 756 *
 757 * This is called when the machine is rebooting or halting.  We assume that the
 758 * machine will be powered off, and the HC's internal state will be reset.
 759 * Don't bother to free memory.
 760 *
 761 * This will only ever be called with the main usb_hcd (the USB3 roothub).
 762 */
 763void xhci_shutdown(struct usb_hcd *hcd)
 764{
 765	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
 766
 767	if (xhci->quirks & XHCI_SPURIOUS_REBOOT)
 768		usb_disable_xhci_ports(to_pci_dev(hcd->self.controller));
 769
 770	spin_lock_irq(&xhci->lock);
 771	xhci_halt(xhci);
 
 
 
 772	spin_unlock_irq(&xhci->lock);
 773
 774	xhci_cleanup_msix(xhci);
 775
 776	xhci_dbg(xhci, "xhci_shutdown completed - status = %x\n",
 777		    xhci_readl(xhci, &xhci->op_regs->status));
 
 
 
 
 
 778}
 779
 780#ifdef CONFIG_PM
 781static void xhci_save_registers(struct xhci_hcd *xhci)
 782{
 783	xhci->s3.command = xhci_readl(xhci, &xhci->op_regs->command);
 784	xhci->s3.dev_nt = xhci_readl(xhci, &xhci->op_regs->dev_notification);
 785	xhci->s3.dcbaa_ptr = xhci_read_64(xhci, &xhci->op_regs->dcbaa_ptr);
 786	xhci->s3.config_reg = xhci_readl(xhci, &xhci->op_regs->config_reg);
 787	xhci->s3.erst_size = xhci_readl(xhci, &xhci->ir_set->erst_size);
 788	xhci->s3.erst_base = xhci_read_64(xhci, &xhci->ir_set->erst_base);
 789	xhci->s3.erst_dequeue = xhci_read_64(xhci, &xhci->ir_set->erst_dequeue);
 790	xhci->s3.irq_pending = xhci_readl(xhci, &xhci->ir_set->irq_pending);
 791	xhci->s3.irq_control = xhci_readl(xhci, &xhci->ir_set->irq_control);
 792}
 793
 794static void xhci_restore_registers(struct xhci_hcd *xhci)
 795{
 796	xhci_writel(xhci, xhci->s3.command, &xhci->op_regs->command);
 797	xhci_writel(xhci, xhci->s3.dev_nt, &xhci->op_regs->dev_notification);
 798	xhci_write_64(xhci, xhci->s3.dcbaa_ptr, &xhci->op_regs->dcbaa_ptr);
 799	xhci_writel(xhci, xhci->s3.config_reg, &xhci->op_regs->config_reg);
 800	xhci_writel(xhci, xhci->s3.erst_size, &xhci->ir_set->erst_size);
 801	xhci_write_64(xhci, xhci->s3.erst_base, &xhci->ir_set->erst_base);
 802	xhci_write_64(xhci, xhci->s3.erst_dequeue, &xhci->ir_set->erst_dequeue);
 803	xhci_writel(xhci, xhci->s3.irq_pending, &xhci->ir_set->irq_pending);
 804	xhci_writel(xhci, xhci->s3.irq_control, &xhci->ir_set->irq_control);
 805}
 806
 807static void xhci_set_cmd_ring_deq(struct xhci_hcd *xhci)
 808{
 809	u64	val_64;
 810
 811	/* step 2: initialize command ring buffer */
 812	val_64 = xhci_read_64(xhci, &xhci->op_regs->cmd_ring);
 813	val_64 = (val_64 & (u64) CMD_RING_RSVD_BITS) |
 814		(xhci_trb_virt_to_dma(xhci->cmd_ring->deq_seg,
 815				      xhci->cmd_ring->dequeue) &
 816		 (u64) ~CMD_RING_RSVD_BITS) |
 817		xhci->cmd_ring->cycle_state;
 818	xhci_dbg(xhci, "// Setting command ring address to 0x%llx\n",
 
 819			(long unsigned long) val_64);
 820	xhci_write_64(xhci, val_64, &xhci->op_regs->cmd_ring);
 821}
 822
 823/*
 824 * The whole command ring must be cleared to zero when we suspend the host.
 825 *
 826 * The host doesn't save the command ring pointer in the suspend well, so we
 827 * need to re-program it on resume.  Unfortunately, the pointer must be 64-byte
 828 * aligned, because of the reserved bits in the command ring dequeue pointer
 829 * register.  Therefore, we can't just set the dequeue pointer back in the
 830 * middle of the ring (TRBs are 16-byte aligned).
 831 */
 832static void xhci_clear_command_ring(struct xhci_hcd *xhci)
 833{
 834	struct xhci_ring *ring;
 835	struct xhci_segment *seg;
 836
 837	ring = xhci->cmd_ring;
 838	seg = ring->deq_seg;
 839	do {
 840		memset(seg->trbs, 0,
 841			sizeof(union xhci_trb) * (TRBS_PER_SEGMENT - 1));
 842		seg->trbs[TRBS_PER_SEGMENT - 1].link.control &=
 843			cpu_to_le32(~TRB_CYCLE);
 844		seg = seg->next;
 845	} while (seg != ring->deq_seg);
 846
 847	/* Reset the software enqueue and dequeue pointers */
 848	ring->deq_seg = ring->first_seg;
 849	ring->dequeue = ring->first_seg->trbs;
 850	ring->enq_seg = ring->deq_seg;
 851	ring->enqueue = ring->dequeue;
 852
 853	ring->num_trbs_free = ring->num_segs * (TRBS_PER_SEGMENT - 1) - 1;
 854	/*
 855	 * Ring is now zeroed, so the HW should look for change of ownership
 856	 * when the cycle bit is set to 1.
 857	 */
 858	ring->cycle_state = 1;
 859
 860	/*
 861	 * Reset the hardware dequeue pointer.
 862	 * Yes, this will need to be re-written after resume, but we're paranoid
 863	 * and want to make sure the hardware doesn't access bogus memory
 864	 * because, say, the BIOS or an SMI started the host without changing
 865	 * the command ring pointers.
 866	 */
 867	xhci_set_cmd_ring_deq(xhci);
 868}
 869
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 870/*
 871 * Stop HC (not bus-specific)
 872 *
 873 * This is called when the machine transition into S3/S4 mode.
 874 *
 875 */
 876int xhci_suspend(struct xhci_hcd *xhci)
 877{
 878	int			rc = 0;
 
 879	struct usb_hcd		*hcd = xhci_to_hcd(xhci);
 880	u32			command;
 881
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 882	spin_lock_irq(&xhci->lock);
 883	clear_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
 884	clear_bit(HCD_FLAG_HW_ACCESSIBLE, &xhci->shared_hcd->flags);
 885	/* step 1: stop endpoint */
 886	/* skipped assuming that port suspend has done */
 887
 888	/* step 2: clear Run/Stop bit */
 889	command = xhci_readl(xhci, &xhci->op_regs->command);
 890	command &= ~CMD_RUN;
 891	xhci_writel(xhci, command, &xhci->op_regs->command);
 892	if (handshake(xhci, &xhci->op_regs->status,
 893		      STS_HALT, STS_HALT, XHCI_MAX_HALT_USEC)) {
 
 
 
 
 894		xhci_warn(xhci, "WARN: xHC CMD_RUN timeout\n");
 895		spin_unlock_irq(&xhci->lock);
 896		return -ETIMEDOUT;
 897	}
 898	xhci_clear_command_ring(xhci);
 899
 900	/* step 3: save registers */
 901	xhci_save_registers(xhci);
 902
 903	/* step 4: set CSS flag */
 904	command = xhci_readl(xhci, &xhci->op_regs->command);
 905	command |= CMD_CSS;
 906	xhci_writel(xhci, command, &xhci->op_regs->command);
 907	if (handshake(xhci, &xhci->op_regs->status, STS_SAVE, 0, 10 * 1000)) {
 
 908		xhci_warn(xhci, "WARN: xHC save state timeout\n");
 909		spin_unlock_irq(&xhci->lock);
 910		return -ETIMEDOUT;
 911	}
 912	spin_unlock_irq(&xhci->lock);
 913
 914	/*
 915	 * Deleting Compliance Mode Recovery Timer because the xHCI Host
 916	 * is about to be suspended.
 917	 */
 918	if ((xhci->quirks & XHCI_COMP_MODE_QUIRK) &&
 919			(!(xhci_all_ports_seen_u0(xhci)))) {
 920		del_timer_sync(&xhci->comp_mode_recovery_timer);
 921		xhci_dbg(xhci, "Compliance Mode Recovery Timer Deleted!\n");
 
 
 922	}
 923
 924	/* step 5: remove core well power */
 925	/* synchronize irq when using MSI-X */
 926	xhci_msix_sync_irqs(xhci);
 927
 928	return rc;
 929}
 
 930
 931/*
 932 * start xHC (not bus-specific)
 933 *
 934 * This is called when the machine transition from S3/S4 mode.
 935 *
 936 */
 937int xhci_resume(struct xhci_hcd *xhci, bool hibernated)
 938{
 939	u32			command, temp = 0;
 940	struct usb_hcd		*hcd = xhci_to_hcd(xhci);
 941	struct usb_hcd		*secondary_hcd;
 942	int			retval = 0;
 
 
 
 
 943
 944	/* Wait a bit if either of the roothubs need to settle from the
 945	 * transition into bus suspend.
 946	 */
 947	if (time_before(jiffies, xhci->bus_state[0].next_statechange) ||
 948			time_before(jiffies,
 949				xhci->bus_state[1].next_statechange))
 950		msleep(100);
 951
 952	set_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
 953	set_bit(HCD_FLAG_HW_ACCESSIBLE, &xhci->shared_hcd->flags);
 954
 955	spin_lock_irq(&xhci->lock);
 956	if (xhci->quirks & XHCI_RESET_ON_RESUME)
 957		hibernated = true;
 958
 959	if (!hibernated) {
 960		/* step 1: restore register */
 961		xhci_restore_registers(xhci);
 962		/* step 2: initialize command ring buffer */
 963		xhci_set_cmd_ring_deq(xhci);
 964		/* step 3: restore state and start state*/
 965		/* step 3: set CRS flag */
 966		command = xhci_readl(xhci, &xhci->op_regs->command);
 967		command |= CMD_CRS;
 968		xhci_writel(xhci, command, &xhci->op_regs->command);
 969		if (handshake(xhci, &xhci->op_regs->status,
 970			      STS_RESTORE, 0, 10 * 1000)) {
 971			xhci_warn(xhci, "WARN: xHC restore state timeout\n");
 972			spin_unlock_irq(&xhci->lock);
 973			return -ETIMEDOUT;
 974		}
 975		temp = xhci_readl(xhci, &xhci->op_regs->status);
 976	}
 977
 978	/* If restore operation fails, re-initialize the HC during resume */
 979	if ((temp & STS_SRE) || hibernated) {
 
 
 
 
 
 
 
 
 980		/* Let the USB core know _both_ roothubs lost power. */
 981		usb_root_hub_lost_power(xhci->main_hcd->self.root_hub);
 982		usb_root_hub_lost_power(xhci->shared_hcd->self.root_hub);
 983
 984		xhci_dbg(xhci, "Stop HCD\n");
 985		xhci_halt(xhci);
 986		xhci_reset(xhci);
 987		spin_unlock_irq(&xhci->lock);
 988		xhci_cleanup_msix(xhci);
 989
 990#ifdef CONFIG_USB_XHCI_HCD_DEBUGGING
 991		/* Tell the event ring poll function not to reschedule */
 992		xhci->zombie = 1;
 993		del_timer_sync(&xhci->event_ring_timer);
 994#endif
 995
 996		xhci_dbg(xhci, "// Disabling event ring interrupts\n");
 997		temp = xhci_readl(xhci, &xhci->op_regs->status);
 998		xhci_writel(xhci, temp & ~STS_EINT, &xhci->op_regs->status);
 999		temp = xhci_readl(xhci, &xhci->ir_set->irq_pending);
1000		xhci_writel(xhci, ER_IRQ_DISABLE(temp),
1001				&xhci->ir_set->irq_pending);
1002		xhci_print_ir_set(xhci, 0);
1003
1004		xhci_dbg(xhci, "cleaning up memory\n");
1005		xhci_mem_cleanup(xhci);
1006		xhci_dbg(xhci, "xhci_stop completed - status = %x\n",
1007			    xhci_readl(xhci, &xhci->op_regs->status));
1008
1009		/* USB core calls the PCI reinit and start functions twice:
1010		 * first with the primary HCD, and then with the secondary HCD.
1011		 * If we don't do the same, the host will never be started.
1012		 */
1013		if (!usb_hcd_is_primary_hcd(hcd))
1014			secondary_hcd = hcd;
1015		else
1016			secondary_hcd = xhci->shared_hcd;
1017
1018		xhci_dbg(xhci, "Initialize the xhci_hcd\n");
1019		retval = xhci_init(hcd->primary_hcd);
1020		if (retval)
1021			return retval;
 
 
1022		xhci_dbg(xhci, "Start the primary HCD\n");
1023		retval = xhci_run(hcd->primary_hcd);
1024		if (!retval) {
1025			xhci_dbg(xhci, "Start the secondary HCD\n");
1026			retval = xhci_run(secondary_hcd);
1027		}
1028		hcd->state = HC_STATE_SUSPENDED;
1029		xhci->shared_hcd->state = HC_STATE_SUSPENDED;
1030		goto done;
1031	}
1032
1033	/* step 4: set Run/Stop bit */
1034	command = xhci_readl(xhci, &xhci->op_regs->command);
1035	command |= CMD_RUN;
1036	xhci_writel(xhci, command, &xhci->op_regs->command);
1037	handshake(xhci, &xhci->op_regs->status, STS_HALT,
1038		  0, 250 * 1000);
1039
1040	/* step 5: walk topology and initialize portsc,
1041	 * portpmsc and portli
1042	 */
1043	/* this is done in bus_resume */
1044
1045	/* step 6: restart each of the previously
1046	 * Running endpoints by ringing their doorbells
1047	 */
1048
1049	spin_unlock_irq(&xhci->lock);
1050
1051 done:
1052	if (retval == 0) {
1053		usb_hcd_resume_root_hub(hcd);
1054		usb_hcd_resume_root_hub(xhci->shared_hcd);
 
 
 
 
1055	}
1056
1057	/*
1058	 * If system is subject to the Quirk, Compliance Mode Timer needs to
1059	 * be re-initialized Always after a system resume. Ports are subject
1060	 * to suffer the Compliance Mode issue again. It doesn't matter if
1061	 * ports have entered previously to U0 before system's suspension.
1062	 */
1063	if (xhci->quirks & XHCI_COMP_MODE_QUIRK)
1064		compliance_mode_recovery_timer_init(xhci);
1065
 
 
 
 
 
 
 
1066	return retval;
1067}
 
1068#endif	/* CONFIG_PM */
1069
1070/*-------------------------------------------------------------------------*/
1071
1072/**
1073 * xhci_get_endpoint_index - Used for passing endpoint bitmasks between the core and
1074 * HCDs.  Find the index for an endpoint given its descriptor.  Use the return
1075 * value to right shift 1 for the bitmask.
1076 *
1077 * Index  = (epnum * 2) + direction - 1,
1078 * where direction = 0 for OUT, 1 for IN.
1079 * For control endpoints, the IN index is used (OUT index is unused), so
1080 * index = (epnum * 2) + direction - 1 = (epnum * 2) + 1 - 1 = (epnum * 2)
1081 */
1082unsigned int xhci_get_endpoint_index(struct usb_endpoint_descriptor *desc)
1083{
1084	unsigned int index;
1085	if (usb_endpoint_xfer_control(desc))
1086		index = (unsigned int) (usb_endpoint_num(desc)*2);
1087	else
1088		index = (unsigned int) (usb_endpoint_num(desc)*2) +
1089			(usb_endpoint_dir_in(desc) ? 1 : 0) - 1;
1090	return index;
1091}
1092
 
 
 
 
 
 
 
 
 
 
1093/* Find the flag for this endpoint (for use in the control context).  Use the
1094 * endpoint index to create a bitmask.  The slot context is bit 0, endpoint 0 is
1095 * bit 1, etc.
1096 */
1097unsigned int xhci_get_endpoint_flag(struct usb_endpoint_descriptor *desc)
1098{
1099	return 1 << (xhci_get_endpoint_index(desc) + 1);
1100}
1101
1102/* Find the flag for this endpoint (for use in the control context).  Use the
1103 * endpoint index to create a bitmask.  The slot context is bit 0, endpoint 0 is
1104 * bit 1, etc.
1105 */
1106unsigned int xhci_get_endpoint_flag_from_index(unsigned int ep_index)
1107{
1108	return 1 << (ep_index + 1);
1109}
1110
1111/* Compute the last valid endpoint context index.  Basically, this is the
1112 * endpoint index plus one.  For slot contexts with more than valid endpoint,
1113 * we find the most significant bit set in the added contexts flags.
1114 * e.g. ep 1 IN (with epnum 0x81) => added_ctxs = 0b1000
1115 * fls(0b1000) = 4, but the endpoint context index is 3, so subtract one.
1116 */
1117unsigned int xhci_last_valid_endpoint(u32 added_ctxs)
1118{
1119	return fls(added_ctxs) - 1;
1120}
1121
1122/* Returns 1 if the arguments are OK;
1123 * returns 0 this is a root hub; returns -EINVAL for NULL pointers.
1124 */
1125static int xhci_check_args(struct usb_hcd *hcd, struct usb_device *udev,
1126		struct usb_host_endpoint *ep, int check_ep, bool check_virt_dev,
1127		const char *func) {
1128	struct xhci_hcd	*xhci;
1129	struct xhci_virt_device	*virt_dev;
1130
1131	if (!hcd || (check_ep && !ep) || !udev) {
1132		printk(KERN_DEBUG "xHCI %s called with invalid args\n",
1133				func);
1134		return -EINVAL;
1135	}
1136	if (!udev->parent) {
1137		printk(KERN_DEBUG "xHCI %s called for root hub\n",
1138				func);
1139		return 0;
1140	}
1141
1142	xhci = hcd_to_xhci(hcd);
1143	if (xhci->xhc_state & XHCI_STATE_HALTED)
1144		return -ENODEV;
1145
1146	if (check_virt_dev) {
1147		if (!udev->slot_id || !xhci->devs[udev->slot_id]) {
1148			printk(KERN_DEBUG "xHCI %s called with unaddressed "
1149						"device\n", func);
1150			return -EINVAL;
1151		}
1152
1153		virt_dev = xhci->devs[udev->slot_id];
1154		if (virt_dev->udev != udev) {
1155			printk(KERN_DEBUG "xHCI %s called with udev and "
1156					  "virt_dev does not match\n", func);
1157			return -EINVAL;
1158		}
1159	}
1160
 
 
 
1161	return 1;
1162}
1163
1164static int xhci_configure_endpoint(struct xhci_hcd *xhci,
1165		struct usb_device *udev, struct xhci_command *command,
1166		bool ctx_change, bool must_succeed);
1167
1168/*
1169 * Full speed devices may have a max packet size greater than 8 bytes, but the
1170 * USB core doesn't know that until it reads the first 8 bytes of the
1171 * descriptor.  If the usb_device's max packet size changes after that point,
1172 * we need to issue an evaluate context command and wait on it.
1173 */
1174static int xhci_check_maxpacket(struct xhci_hcd *xhci, unsigned int slot_id,
1175		unsigned int ep_index, struct urb *urb)
1176{
1177	struct xhci_container_ctx *in_ctx;
1178	struct xhci_container_ctx *out_ctx;
1179	struct xhci_input_control_ctx *ctrl_ctx;
1180	struct xhci_ep_ctx *ep_ctx;
 
1181	int max_packet_size;
1182	int hw_max_packet_size;
1183	int ret = 0;
1184
1185	out_ctx = xhci->devs[slot_id]->out_ctx;
1186	ep_ctx = xhci_get_ep_ctx(xhci, out_ctx, ep_index);
1187	hw_max_packet_size = MAX_PACKET_DECODED(le32_to_cpu(ep_ctx->ep_info2));
1188	max_packet_size = usb_endpoint_maxp(&urb->dev->ep0.desc);
1189	if (hw_max_packet_size != max_packet_size) {
1190		xhci_dbg(xhci, "Max Packet Size for ep 0 changed.\n");
1191		xhci_dbg(xhci, "Max packet size in usb_device = %d\n",
 
 
1192				max_packet_size);
1193		xhci_dbg(xhci, "Max packet size in xHCI HW = %d\n",
 
1194				hw_max_packet_size);
1195		xhci_dbg(xhci, "Issuing evaluate context command.\n");
 
1196
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1197		/* Set up the modified control endpoint 0 */
1198		xhci_endpoint_copy(xhci, xhci->devs[slot_id]->in_ctx,
1199				xhci->devs[slot_id]->out_ctx, ep_index);
1200		in_ctx = xhci->devs[slot_id]->in_ctx;
1201		ep_ctx = xhci_get_ep_ctx(xhci, in_ctx, ep_index);
1202		ep_ctx->ep_info2 &= cpu_to_le32(~MAX_PACKET_MASK);
1203		ep_ctx->ep_info2 |= cpu_to_le32(MAX_PACKET(max_packet_size));
1204
1205		/* Set up the input context flags for the command */
1206		/* FIXME: This won't work if a non-default control endpoint
1207		 * changes max packet sizes.
1208		 */
1209		ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
1210		ctrl_ctx->add_flags = cpu_to_le32(EP0_FLAG);
1211		ctrl_ctx->drop_flags = 0;
1212
1213		xhci_dbg(xhci, "Slot %d input context\n", slot_id);
1214		xhci_dbg_ctx(xhci, in_ctx, ep_index);
1215		xhci_dbg(xhci, "Slot %d output context\n", slot_id);
1216		xhci_dbg_ctx(xhci, out_ctx, ep_index);
1217
1218		ret = xhci_configure_endpoint(xhci, urb->dev, NULL,
1219				true, false);
1220
1221		/* Clean up the input context for later use by bandwidth
1222		 * functions.
1223		 */
1224		ctrl_ctx->add_flags = cpu_to_le32(SLOT_FLAG);
 
 
 
1225	}
1226	return ret;
1227}
1228
1229/*
1230 * non-error returns are a promise to giveback() the urb later
1231 * we drop ownership so next owner (or urb unlink) can get it
1232 */
1233int xhci_urb_enqueue(struct usb_hcd *hcd, struct urb *urb, gfp_t mem_flags)
1234{
1235	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
1236	struct xhci_td *buffer;
1237	unsigned long flags;
1238	int ret = 0;
1239	unsigned int slot_id, ep_index;
1240	struct urb_priv	*urb_priv;
1241	int size, i;
1242
1243	if (!urb || xhci_check_args(hcd, urb->dev, urb->ep,
1244					true, true, __func__) <= 0)
1245		return -EINVAL;
1246
1247	slot_id = urb->dev->slot_id;
1248	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1249
1250	if (!HCD_HW_ACCESSIBLE(hcd)) {
1251		if (!in_interrupt())
1252			xhci_dbg(xhci, "urb submitted during PCI suspend\n");
1253		ret = -ESHUTDOWN;
1254		goto exit;
1255	}
1256
1257	if (usb_endpoint_xfer_isoc(&urb->ep->desc))
1258		size = urb->number_of_packets;
 
 
 
 
 
1259	else
1260		size = 1;
1261
1262	urb_priv = kzalloc(sizeof(struct urb_priv) +
1263				  size * sizeof(struct xhci_td *), mem_flags);
1264	if (!urb_priv)
1265		return -ENOMEM;
1266
1267	buffer = kzalloc(size * sizeof(struct xhci_td), mem_flags);
1268	if (!buffer) {
1269		kfree(urb_priv);
1270		return -ENOMEM;
1271	}
1272
1273	for (i = 0; i < size; i++) {
1274		urb_priv->td[i] = buffer;
1275		buffer++;
1276	}
1277
1278	urb_priv->length = size;
1279	urb_priv->td_cnt = 0;
1280	urb->hcpriv = urb_priv;
1281
1282	if (usb_endpoint_xfer_control(&urb->ep->desc)) {
1283		/* Check to see if the max packet size for the default control
1284		 * endpoint changed during FS device enumeration
1285		 */
1286		if (urb->dev->speed == USB_SPEED_FULL) {
1287			ret = xhci_check_maxpacket(xhci, slot_id,
1288					ep_index, urb);
1289			if (ret < 0) {
1290				xhci_urb_free_priv(xhci, urb_priv);
1291				urb->hcpriv = NULL;
1292				return ret;
1293			}
1294		}
1295
1296		/* We have a spinlock and interrupts disabled, so we must pass
1297		 * atomic context to this function, which may allocate memory.
1298		 */
1299		spin_lock_irqsave(&xhci->lock, flags);
1300		if (xhci->xhc_state & XHCI_STATE_DYING)
1301			goto dying;
1302		ret = xhci_queue_ctrl_tx(xhci, GFP_ATOMIC, urb,
1303				slot_id, ep_index);
1304		if (ret)
1305			goto free_priv;
1306		spin_unlock_irqrestore(&xhci->lock, flags);
1307	} else if (usb_endpoint_xfer_bulk(&urb->ep->desc)) {
1308		spin_lock_irqsave(&xhci->lock, flags);
1309		if (xhci->xhc_state & XHCI_STATE_DYING)
1310			goto dying;
1311		if (xhci->devs[slot_id]->eps[ep_index].ep_state &
1312				EP_GETTING_STREAMS) {
1313			xhci_warn(xhci, "WARN: Can't enqueue URB while bulk ep "
1314					"is transitioning to using streams.\n");
1315			ret = -EINVAL;
1316		} else if (xhci->devs[slot_id]->eps[ep_index].ep_state &
1317				EP_GETTING_NO_STREAMS) {
1318			xhci_warn(xhci, "WARN: Can't enqueue URB while bulk ep "
1319					"is transitioning to "
1320					"not having streams.\n");
1321			ret = -EINVAL;
1322		} else {
1323			ret = xhci_queue_bulk_tx(xhci, GFP_ATOMIC, urb,
1324					slot_id, ep_index);
1325		}
1326		if (ret)
1327			goto free_priv;
1328		spin_unlock_irqrestore(&xhci->lock, flags);
1329	} else if (usb_endpoint_xfer_int(&urb->ep->desc)) {
1330		spin_lock_irqsave(&xhci->lock, flags);
1331		if (xhci->xhc_state & XHCI_STATE_DYING)
1332			goto dying;
1333		ret = xhci_queue_intr_tx(xhci, GFP_ATOMIC, urb,
1334				slot_id, ep_index);
1335		if (ret)
1336			goto free_priv;
1337		spin_unlock_irqrestore(&xhci->lock, flags);
1338	} else {
1339		spin_lock_irqsave(&xhci->lock, flags);
1340		if (xhci->xhc_state & XHCI_STATE_DYING)
1341			goto dying;
1342		ret = xhci_queue_isoc_tx_prepare(xhci, GFP_ATOMIC, urb,
1343				slot_id, ep_index);
1344		if (ret)
1345			goto free_priv;
1346		spin_unlock_irqrestore(&xhci->lock, flags);
1347	}
1348exit:
1349	return ret;
1350dying:
1351	xhci_dbg(xhci, "Ep 0x%x: URB %p submitted for "
1352			"non-responsive xHCI host.\n",
1353			urb->ep->desc.bEndpointAddress, urb);
1354	ret = -ESHUTDOWN;
1355free_priv:
1356	xhci_urb_free_priv(xhci, urb_priv);
1357	urb->hcpriv = NULL;
1358	spin_unlock_irqrestore(&xhci->lock, flags);
1359	return ret;
1360}
1361
1362/* Get the right ring for the given URB.
1363 * If the endpoint supports streams, boundary check the URB's stream ID.
1364 * If the endpoint doesn't support streams, return the singular endpoint ring.
1365 */
1366static struct xhci_ring *xhci_urb_to_transfer_ring(struct xhci_hcd *xhci,
1367		struct urb *urb)
1368{
1369	unsigned int slot_id;
1370	unsigned int ep_index;
1371	unsigned int stream_id;
1372	struct xhci_virt_ep *ep;
1373
1374	slot_id = urb->dev->slot_id;
1375	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1376	stream_id = urb->stream_id;
1377	ep = &xhci->devs[slot_id]->eps[ep_index];
1378	/* Common case: no streams */
1379	if (!(ep->ep_state & EP_HAS_STREAMS))
1380		return ep->ring;
1381
1382	if (stream_id == 0) {
1383		xhci_warn(xhci,
1384				"WARN: Slot ID %u, ep index %u has streams, "
1385				"but URB has no stream ID.\n",
1386				slot_id, ep_index);
1387		return NULL;
1388	}
1389
1390	if (stream_id < ep->stream_info->num_streams)
1391		return ep->stream_info->stream_rings[stream_id];
1392
1393	xhci_warn(xhci,
1394			"WARN: Slot ID %u, ep index %u has "
1395			"stream IDs 1 to %u allocated, "
1396			"but stream ID %u is requested.\n",
1397			slot_id, ep_index,
1398			ep->stream_info->num_streams - 1,
1399			stream_id);
1400	return NULL;
1401}
1402
1403/*
1404 * Remove the URB's TD from the endpoint ring.  This may cause the HC to stop
1405 * USB transfers, potentially stopping in the middle of a TRB buffer.  The HC
1406 * should pick up where it left off in the TD, unless a Set Transfer Ring
1407 * Dequeue Pointer is issued.
1408 *
1409 * The TRBs that make up the buffers for the canceled URB will be "removed" from
1410 * the ring.  Since the ring is a contiguous structure, they can't be physically
1411 * removed.  Instead, there are two options:
1412 *
1413 *  1) If the HC is in the middle of processing the URB to be canceled, we
1414 *     simply move the ring's dequeue pointer past those TRBs using the Set
1415 *     Transfer Ring Dequeue Pointer command.  This will be the common case,
1416 *     when drivers timeout on the last submitted URB and attempt to cancel.
1417 *
1418 *  2) If the HC is in the middle of a different TD, we turn the TRBs into a
1419 *     series of 1-TRB transfer no-op TDs.  (No-ops shouldn't be chained.)  The
1420 *     HC will need to invalidate the any TRBs it has cached after the stop
1421 *     endpoint command, as noted in the xHCI 0.95 errata.
1422 *
1423 *  3) The TD may have completed by the time the Stop Endpoint Command
1424 *     completes, so software needs to handle that case too.
1425 *
1426 * This function should protect against the TD enqueueing code ringing the
1427 * doorbell while this code is waiting for a Stop Endpoint command to complete.
1428 * It also needs to account for multiple cancellations on happening at the same
1429 * time for the same endpoint.
1430 *
1431 * Note that this function can be called in any context, or so says
1432 * usb_hcd_unlink_urb()
1433 */
1434int xhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status)
1435{
1436	unsigned long flags;
1437	int ret, i;
1438	u32 temp;
1439	struct xhci_hcd *xhci;
1440	struct urb_priv	*urb_priv;
1441	struct xhci_td *td;
1442	unsigned int ep_index;
1443	struct xhci_ring *ep_ring;
1444	struct xhci_virt_ep *ep;
 
1445
1446	xhci = hcd_to_xhci(hcd);
1447	spin_lock_irqsave(&xhci->lock, flags);
1448	/* Make sure the URB hasn't completed or been unlinked already */
1449	ret = usb_hcd_check_unlink_urb(hcd, urb, status);
1450	if (ret || !urb->hcpriv)
1451		goto done;
1452	temp = xhci_readl(xhci, &xhci->op_regs->status);
1453	if (temp == 0xffffffff || (xhci->xhc_state & XHCI_STATE_HALTED)) {
1454		xhci_dbg(xhci, "HW died, freeing TD.\n");
 
1455		urb_priv = urb->hcpriv;
1456		for (i = urb_priv->td_cnt; i < urb_priv->length; i++) {
 
 
1457			td = urb_priv->td[i];
1458			if (!list_empty(&td->td_list))
1459				list_del_init(&td->td_list);
1460			if (!list_empty(&td->cancelled_td_list))
1461				list_del_init(&td->cancelled_td_list);
1462		}
1463
1464		usb_hcd_unlink_urb_from_ep(hcd, urb);
1465		spin_unlock_irqrestore(&xhci->lock, flags);
1466		usb_hcd_giveback_urb(hcd, urb, -ESHUTDOWN);
1467		xhci_urb_free_priv(xhci, urb_priv);
1468		return ret;
1469	}
1470	if ((xhci->xhc_state & XHCI_STATE_DYING) ||
1471			(xhci->xhc_state & XHCI_STATE_HALTED)) {
1472		xhci_dbg(xhci, "Ep 0x%x: URB %p to be canceled on "
1473				"non-responsive xHCI host.\n",
 
1474				urb->ep->desc.bEndpointAddress, urb);
1475		/* Let the stop endpoint command watchdog timer (which set this
1476		 * state) finish cleaning up the endpoint TD lists.  We must
1477		 * have caught it in the middle of dropping a lock and giving
1478		 * back an URB.
1479		 */
1480		goto done;
1481	}
1482
1483	ep_index = xhci_get_endpoint_index(&urb->ep->desc);
1484	ep = &xhci->devs[urb->dev->slot_id]->eps[ep_index];
1485	ep_ring = xhci_urb_to_transfer_ring(xhci, urb);
1486	if (!ep_ring) {
1487		ret = -EINVAL;
1488		goto done;
1489	}
1490
1491	urb_priv = urb->hcpriv;
1492	i = urb_priv->td_cnt;
1493	if (i < urb_priv->length)
1494		xhci_dbg(xhci, "Cancel URB %p, dev %s, ep 0x%x, "
1495				"starting at offset 0x%llx\n",
 
1496				urb, urb->dev->devpath,
1497				urb->ep->desc.bEndpointAddress,
1498				(unsigned long long) xhci_trb_virt_to_dma(
1499					urb_priv->td[i]->start_seg,
1500					urb_priv->td[i]->first_trb));
1501
1502	for (; i < urb_priv->length; i++) {
1503		td = urb_priv->td[i];
1504		list_add_tail(&td->cancelled_td_list, &ep->cancelled_td_list);
1505	}
1506
1507	/* Queue a stop endpoint command, but only if this is
1508	 * the first cancellation to be handled.
1509	 */
1510	if (!(ep->ep_state & EP_HALT_PENDING)) {
 
 
 
 
 
1511		ep->ep_state |= EP_HALT_PENDING;
1512		ep->stop_cmds_pending++;
1513		ep->stop_cmd_timer.expires = jiffies +
1514			XHCI_STOP_EP_CMD_TIMEOUT * HZ;
1515		add_timer(&ep->stop_cmd_timer);
1516		xhci_queue_stop_endpoint(xhci, urb->dev->slot_id, ep_index, 0);
 
1517		xhci_ring_cmd_db(xhci);
1518	}
1519done:
1520	spin_unlock_irqrestore(&xhci->lock, flags);
1521	return ret;
1522}
1523
1524/* Drop an endpoint from a new bandwidth configuration for this device.
1525 * Only one call to this function is allowed per endpoint before
1526 * check_bandwidth() or reset_bandwidth() must be called.
1527 * A call to xhci_drop_endpoint() followed by a call to xhci_add_endpoint() will
1528 * add the endpoint to the schedule with possibly new parameters denoted by a
1529 * different endpoint descriptor in usb_host_endpoint.
1530 * A call to xhci_add_endpoint() followed by a call to xhci_drop_endpoint() is
1531 * not allowed.
1532 *
1533 * The USB core will not allow URBs to be queued to an endpoint that is being
1534 * disabled, so there's no need for mutual exclusion to protect
1535 * the xhci->devs[slot_id] structure.
1536 */
1537int xhci_drop_endpoint(struct usb_hcd *hcd, struct usb_device *udev,
1538		struct usb_host_endpoint *ep)
1539{
1540	struct xhci_hcd *xhci;
1541	struct xhci_container_ctx *in_ctx, *out_ctx;
1542	struct xhci_input_control_ctx *ctrl_ctx;
1543	struct xhci_slot_ctx *slot_ctx;
1544	unsigned int last_ctx;
1545	unsigned int ep_index;
1546	struct xhci_ep_ctx *ep_ctx;
1547	u32 drop_flag;
1548	u32 new_add_flags, new_drop_flags, new_slot_info;
1549	int ret;
1550
1551	ret = xhci_check_args(hcd, udev, ep, 1, true, __func__);
1552	if (ret <= 0)
1553		return ret;
1554	xhci = hcd_to_xhci(hcd);
1555	if (xhci->xhc_state & XHCI_STATE_DYING)
1556		return -ENODEV;
1557
1558	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
1559	drop_flag = xhci_get_endpoint_flag(&ep->desc);
1560	if (drop_flag == SLOT_FLAG || drop_flag == EP0_FLAG) {
1561		xhci_dbg(xhci, "xHCI %s - can't drop slot or ep 0 %#x\n",
1562				__func__, drop_flag);
1563		return 0;
1564	}
1565
1566	in_ctx = xhci->devs[udev->slot_id]->in_ctx;
1567	out_ctx = xhci->devs[udev->slot_id]->out_ctx;
1568	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
 
 
 
 
 
 
1569	ep_index = xhci_get_endpoint_index(&ep->desc);
1570	ep_ctx = xhci_get_ep_ctx(xhci, out_ctx, ep_index);
1571	/* If the HC already knows the endpoint is disabled,
1572	 * or the HCD has noted it is disabled, ignore this request
1573	 */
1574	if (((ep_ctx->ep_info & cpu_to_le32(EP_STATE_MASK)) ==
1575	     cpu_to_le32(EP_STATE_DISABLED)) ||
1576	    le32_to_cpu(ctrl_ctx->drop_flags) &
1577	    xhci_get_endpoint_flag(&ep->desc)) {
1578		xhci_warn(xhci, "xHCI %s called with disabled ep %p\n",
1579				__func__, ep);
 
 
1580		return 0;
1581	}
1582
1583	ctrl_ctx->drop_flags |= cpu_to_le32(drop_flag);
1584	new_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags);
1585
1586	ctrl_ctx->add_flags &= cpu_to_le32(~drop_flag);
1587	new_add_flags = le32_to_cpu(ctrl_ctx->add_flags);
1588
1589	last_ctx = xhci_last_valid_endpoint(le32_to_cpu(ctrl_ctx->add_flags));
1590	slot_ctx = xhci_get_slot_ctx(xhci, in_ctx);
1591	/* Update the last valid endpoint context, if we deleted the last one */
1592	if ((le32_to_cpu(slot_ctx->dev_info) & LAST_CTX_MASK) >
1593	    LAST_CTX(last_ctx)) {
1594		slot_ctx->dev_info &= cpu_to_le32(~LAST_CTX_MASK);
1595		slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(last_ctx));
1596	}
1597	new_slot_info = le32_to_cpu(slot_ctx->dev_info);
1598
1599	xhci_endpoint_zero(xhci, xhci->devs[udev->slot_id], ep);
 
1600
1601	xhci_dbg(xhci, "drop ep 0x%x, slot id %d, new drop flags = %#x, new add flags = %#x, new slot info = %#x\n",
1602			(unsigned int) ep->desc.bEndpointAddress,
1603			udev->slot_id,
1604			(unsigned int) new_drop_flags,
1605			(unsigned int) new_add_flags,
1606			(unsigned int) new_slot_info);
1607	return 0;
1608}
1609
1610/* Add an endpoint to a new possible bandwidth configuration for this device.
1611 * Only one call to this function is allowed per endpoint before
1612 * check_bandwidth() or reset_bandwidth() must be called.
1613 * A call to xhci_drop_endpoint() followed by a call to xhci_add_endpoint() will
1614 * add the endpoint to the schedule with possibly new parameters denoted by a
1615 * different endpoint descriptor in usb_host_endpoint.
1616 * A call to xhci_add_endpoint() followed by a call to xhci_drop_endpoint() is
1617 * not allowed.
1618 *
1619 * The USB core will not allow URBs to be queued to an endpoint until the
1620 * configuration or alt setting is installed in the device, so there's no need
1621 * for mutual exclusion to protect the xhci->devs[slot_id] structure.
1622 */
1623int xhci_add_endpoint(struct usb_hcd *hcd, struct usb_device *udev,
1624		struct usb_host_endpoint *ep)
1625{
1626	struct xhci_hcd *xhci;
1627	struct xhci_container_ctx *in_ctx, *out_ctx;
1628	unsigned int ep_index;
1629	struct xhci_ep_ctx *ep_ctx;
1630	struct xhci_slot_ctx *slot_ctx;
1631	struct xhci_input_control_ctx *ctrl_ctx;
1632	u32 added_ctxs;
1633	unsigned int last_ctx;
1634	u32 new_add_flags, new_drop_flags, new_slot_info;
1635	struct xhci_virt_device *virt_dev;
1636	int ret = 0;
1637
1638	ret = xhci_check_args(hcd, udev, ep, 1, true, __func__);
1639	if (ret <= 0) {
1640		/* So we won't queue a reset ep command for a root hub */
1641		ep->hcpriv = NULL;
1642		return ret;
1643	}
1644	xhci = hcd_to_xhci(hcd);
1645	if (xhci->xhc_state & XHCI_STATE_DYING)
1646		return -ENODEV;
1647
1648	added_ctxs = xhci_get_endpoint_flag(&ep->desc);
1649	last_ctx = xhci_last_valid_endpoint(added_ctxs);
1650	if (added_ctxs == SLOT_FLAG || added_ctxs == EP0_FLAG) {
1651		/* FIXME when we have to issue an evaluate endpoint command to
1652		 * deal with ep0 max packet size changing once we get the
1653		 * descriptors
1654		 */
1655		xhci_dbg(xhci, "xHCI %s - can't add slot or ep 0 %#x\n",
1656				__func__, added_ctxs);
1657		return 0;
1658	}
1659
1660	virt_dev = xhci->devs[udev->slot_id];
1661	in_ctx = virt_dev->in_ctx;
1662	out_ctx = virt_dev->out_ctx;
1663	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
 
 
 
 
 
1664	ep_index = xhci_get_endpoint_index(&ep->desc);
1665	ep_ctx = xhci_get_ep_ctx(xhci, out_ctx, ep_index);
1666
1667	/* If this endpoint is already in use, and the upper layers are trying
1668	 * to add it again without dropping it, reject the addition.
1669	 */
1670	if (virt_dev->eps[ep_index].ring &&
1671			!(le32_to_cpu(ctrl_ctx->drop_flags) &
1672				xhci_get_endpoint_flag(&ep->desc))) {
1673		xhci_warn(xhci, "Trying to add endpoint 0x%x "
1674				"without dropping it.\n",
1675				(unsigned int) ep->desc.bEndpointAddress);
1676		return -EINVAL;
1677	}
1678
1679	/* If the HCD has already noted the endpoint is enabled,
1680	 * ignore this request.
1681	 */
1682	if (le32_to_cpu(ctrl_ctx->add_flags) &
1683	    xhci_get_endpoint_flag(&ep->desc)) {
1684		xhci_warn(xhci, "xHCI %s called with enabled ep %p\n",
1685				__func__, ep);
1686		return 0;
1687	}
1688
1689	/*
1690	 * Configuration and alternate setting changes must be done in
1691	 * process context, not interrupt context (or so documenation
1692	 * for usb_set_interface() and usb_set_configuration() claim).
1693	 */
1694	if (xhci_endpoint_init(xhci, virt_dev, udev, ep, GFP_NOIO) < 0) {
1695		dev_dbg(&udev->dev, "%s - could not initialize ep %#x\n",
1696				__func__, ep->desc.bEndpointAddress);
1697		return -ENOMEM;
1698	}
1699
 
 
 
 
 
 
 
 
 
1700	ctrl_ctx->add_flags |= cpu_to_le32(added_ctxs);
1701	new_add_flags = le32_to_cpu(ctrl_ctx->add_flags);
1702
1703	/* If xhci_endpoint_disable() was called for this endpoint, but the
1704	 * xHC hasn't been notified yet through the check_bandwidth() call,
1705	 * this re-adds a new state for the endpoint from the new endpoint
1706	 * descriptors.  We must drop and re-add this endpoint, so we leave the
1707	 * drop flags alone.
1708	 */
1709	new_drop_flags = le32_to_cpu(ctrl_ctx->drop_flags);
1710
1711	slot_ctx = xhci_get_slot_ctx(xhci, in_ctx);
1712	/* Update the last valid endpoint context, if we just added one past */
1713	if ((le32_to_cpu(slot_ctx->dev_info) & LAST_CTX_MASK) <
1714	    LAST_CTX(last_ctx)) {
1715		slot_ctx->dev_info &= cpu_to_le32(~LAST_CTX_MASK);
1716		slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(last_ctx));
1717	}
1718	new_slot_info = le32_to_cpu(slot_ctx->dev_info);
1719
1720	/* Store the usb_device pointer for later use */
1721	ep->hcpriv = udev;
1722
1723	xhci_dbg(xhci, "add ep 0x%x, slot id %d, new drop flags = %#x, new add flags = %#x, new slot info = %#x\n",
1724			(unsigned int) ep->desc.bEndpointAddress,
1725			udev->slot_id,
1726			(unsigned int) new_drop_flags,
1727			(unsigned int) new_add_flags,
1728			(unsigned int) new_slot_info);
1729	return 0;
1730}
1731
1732static void xhci_zero_in_ctx(struct xhci_hcd *xhci, struct xhci_virt_device *virt_dev)
1733{
1734	struct xhci_input_control_ctx *ctrl_ctx;
1735	struct xhci_ep_ctx *ep_ctx;
1736	struct xhci_slot_ctx *slot_ctx;
1737	int i;
1738
 
 
 
 
 
 
 
1739	/* When a device's add flag and drop flag are zero, any subsequent
1740	 * configure endpoint command will leave that endpoint's state
1741	 * untouched.  Make sure we don't leave any old state in the input
1742	 * endpoint contexts.
1743	 */
1744	ctrl_ctx = xhci_get_input_control_ctx(xhci, virt_dev->in_ctx);
1745	ctrl_ctx->drop_flags = 0;
1746	ctrl_ctx->add_flags = 0;
1747	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
1748	slot_ctx->dev_info &= cpu_to_le32(~LAST_CTX_MASK);
1749	/* Endpoint 0 is always valid */
1750	slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(1));
1751	for (i = 1; i < 31; ++i) {
1752		ep_ctx = xhci_get_ep_ctx(xhci, virt_dev->in_ctx, i);
1753		ep_ctx->ep_info = 0;
1754		ep_ctx->ep_info2 = 0;
1755		ep_ctx->deq = 0;
1756		ep_ctx->tx_info = 0;
1757	}
1758}
1759
1760static int xhci_configure_endpoint_result(struct xhci_hcd *xhci,
1761		struct usb_device *udev, u32 *cmd_status)
1762{
1763	int ret;
1764
1765	switch (*cmd_status) {
 
 
 
 
 
1766	case COMP_ENOMEM:
1767		dev_warn(&udev->dev, "Not enough host controller resources "
1768				"for new device state.\n");
1769		ret = -ENOMEM;
1770		/* FIXME: can we allocate more resources for the HC? */
1771		break;
1772	case COMP_BW_ERR:
1773	case COMP_2ND_BW_ERR:
1774		dev_warn(&udev->dev, "Not enough bandwidth "
1775				"for new device state.\n");
1776		ret = -ENOSPC;
1777		/* FIXME: can we go back to the old state? */
1778		break;
1779	case COMP_TRB_ERR:
1780		/* the HCD set up something wrong */
1781		dev_warn(&udev->dev, "ERROR: Endpoint drop flag = 0, "
1782				"add flag = 1, "
1783				"and endpoint is not disabled.\n");
1784		ret = -EINVAL;
1785		break;
1786	case COMP_DEV_ERR:
1787		dev_warn(&udev->dev, "ERROR: Incompatible device for endpoint "
1788				"configure command.\n");
1789		ret = -ENODEV;
1790		break;
1791	case COMP_SUCCESS:
1792		dev_dbg(&udev->dev, "Successful Endpoint Configure command\n");
 
1793		ret = 0;
1794		break;
1795	default:
1796		xhci_err(xhci, "ERROR: unexpected command completion "
1797				"code 0x%x.\n", *cmd_status);
1798		ret = -EINVAL;
1799		break;
1800	}
1801	return ret;
1802}
1803
1804static int xhci_evaluate_context_result(struct xhci_hcd *xhci,
1805		struct usb_device *udev, u32 *cmd_status)
1806{
1807	int ret;
1808	struct xhci_virt_device *virt_dev = xhci->devs[udev->slot_id];
1809
1810	switch (*cmd_status) {
 
 
 
 
 
1811	case COMP_EINVAL:
1812		dev_warn(&udev->dev, "WARN: xHCI driver setup invalid evaluate "
1813				"context command.\n");
1814		ret = -EINVAL;
1815		break;
1816	case COMP_EBADSLT:
1817		dev_warn(&udev->dev, "WARN: slot not enabled for"
1818				"evaluate context command.\n");
 
 
1819	case COMP_CTX_STATE:
1820		dev_warn(&udev->dev, "WARN: invalid context state for "
1821				"evaluate context command.\n");
1822		xhci_dbg_ctx(xhci, virt_dev->out_ctx, 1);
1823		ret = -EINVAL;
1824		break;
1825	case COMP_DEV_ERR:
1826		dev_warn(&udev->dev, "ERROR: Incompatible device for evaluate "
1827				"context command.\n");
1828		ret = -ENODEV;
1829		break;
1830	case COMP_MEL_ERR:
1831		/* Max Exit Latency too large error */
1832		dev_warn(&udev->dev, "WARN: Max Exit Latency too large\n");
1833		ret = -EINVAL;
1834		break;
1835	case COMP_SUCCESS:
1836		dev_dbg(&udev->dev, "Successful evaluate context command\n");
 
1837		ret = 0;
1838		break;
1839	default:
1840		xhci_err(xhci, "ERROR: unexpected command completion "
1841				"code 0x%x.\n", *cmd_status);
1842		ret = -EINVAL;
1843		break;
1844	}
1845	return ret;
1846}
1847
1848static u32 xhci_count_num_new_endpoints(struct xhci_hcd *xhci,
1849		struct xhci_container_ctx *in_ctx)
1850{
1851	struct xhci_input_control_ctx *ctrl_ctx;
1852	u32 valid_add_flags;
1853	u32 valid_drop_flags;
1854
1855	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
1856	/* Ignore the slot flag (bit 0), and the default control endpoint flag
1857	 * (bit 1).  The default control endpoint is added during the Address
1858	 * Device command and is never removed until the slot is disabled.
1859	 */
1860	valid_add_flags = ctrl_ctx->add_flags >> 2;
1861	valid_drop_flags = ctrl_ctx->drop_flags >> 2;
1862
1863	/* Use hweight32 to count the number of ones in the add flags, or
1864	 * number of endpoints added.  Don't count endpoints that are changed
1865	 * (both added and dropped).
1866	 */
1867	return hweight32(valid_add_flags) -
1868		hweight32(valid_add_flags & valid_drop_flags);
1869}
1870
1871static unsigned int xhci_count_num_dropped_endpoints(struct xhci_hcd *xhci,
1872		struct xhci_container_ctx *in_ctx)
1873{
1874	struct xhci_input_control_ctx *ctrl_ctx;
1875	u32 valid_add_flags;
1876	u32 valid_drop_flags;
1877
1878	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
1879	valid_add_flags = ctrl_ctx->add_flags >> 2;
1880	valid_drop_flags = ctrl_ctx->drop_flags >> 2;
1881
1882	return hweight32(valid_drop_flags) -
1883		hweight32(valid_add_flags & valid_drop_flags);
1884}
1885
1886/*
1887 * We need to reserve the new number of endpoints before the configure endpoint
1888 * command completes.  We can't subtract the dropped endpoints from the number
1889 * of active endpoints until the command completes because we can oversubscribe
1890 * the host in this case:
1891 *
1892 *  - the first configure endpoint command drops more endpoints than it adds
1893 *  - a second configure endpoint command that adds more endpoints is queued
1894 *  - the first configure endpoint command fails, so the config is unchanged
1895 *  - the second command may succeed, even though there isn't enough resources
1896 *
1897 * Must be called with xhci->lock held.
1898 */
1899static int xhci_reserve_host_resources(struct xhci_hcd *xhci,
1900		struct xhci_container_ctx *in_ctx)
1901{
1902	u32 added_eps;
1903
1904	added_eps = xhci_count_num_new_endpoints(xhci, in_ctx);
1905	if (xhci->num_active_eps + added_eps > xhci->limit_active_eps) {
1906		xhci_dbg(xhci, "Not enough ep ctxs: "
1907				"%u active, need to add %u, limit is %u.\n",
 
1908				xhci->num_active_eps, added_eps,
1909				xhci->limit_active_eps);
1910		return -ENOMEM;
1911	}
1912	xhci->num_active_eps += added_eps;
1913	xhci_dbg(xhci, "Adding %u ep ctxs, %u now active.\n", added_eps,
 
1914			xhci->num_active_eps);
1915	return 0;
1916}
1917
1918/*
1919 * The configure endpoint was failed by the xHC for some other reason, so we
1920 * need to revert the resources that failed configuration would have used.
1921 *
1922 * Must be called with xhci->lock held.
1923 */
1924static void xhci_free_host_resources(struct xhci_hcd *xhci,
1925		struct xhci_container_ctx *in_ctx)
1926{
1927	u32 num_failed_eps;
1928
1929	num_failed_eps = xhci_count_num_new_endpoints(xhci, in_ctx);
1930	xhci->num_active_eps -= num_failed_eps;
1931	xhci_dbg(xhci, "Removing %u failed ep ctxs, %u now active.\n",
 
1932			num_failed_eps,
1933			xhci->num_active_eps);
1934}
1935
1936/*
1937 * Now that the command has completed, clean up the active endpoint count by
1938 * subtracting out the endpoints that were dropped (but not changed).
1939 *
1940 * Must be called with xhci->lock held.
1941 */
1942static void xhci_finish_resource_reservation(struct xhci_hcd *xhci,
1943		struct xhci_container_ctx *in_ctx)
1944{
1945	u32 num_dropped_eps;
1946
1947	num_dropped_eps = xhci_count_num_dropped_endpoints(xhci, in_ctx);
1948	xhci->num_active_eps -= num_dropped_eps;
1949	if (num_dropped_eps)
1950		xhci_dbg(xhci, "Removing %u dropped ep ctxs, %u now active.\n",
 
1951				num_dropped_eps,
1952				xhci->num_active_eps);
1953}
1954
1955unsigned int xhci_get_block_size(struct usb_device *udev)
1956{
1957	switch (udev->speed) {
1958	case USB_SPEED_LOW:
1959	case USB_SPEED_FULL:
1960		return FS_BLOCK;
1961	case USB_SPEED_HIGH:
1962		return HS_BLOCK;
1963	case USB_SPEED_SUPER:
 
1964		return SS_BLOCK;
1965	case USB_SPEED_UNKNOWN:
1966	case USB_SPEED_WIRELESS:
1967	default:
1968		/* Should never happen */
1969		return 1;
1970	}
1971}
1972
1973unsigned int xhci_get_largest_overhead(struct xhci_interval_bw *interval_bw)
 
1974{
1975	if (interval_bw->overhead[LS_OVERHEAD_TYPE])
1976		return LS_OVERHEAD;
1977	if (interval_bw->overhead[FS_OVERHEAD_TYPE])
1978		return FS_OVERHEAD;
1979	return HS_OVERHEAD;
1980}
1981
1982/* If we are changing a LS/FS device under a HS hub,
1983 * make sure (if we are activating a new TT) that the HS bus has enough
1984 * bandwidth for this new TT.
1985 */
1986static int xhci_check_tt_bw_table(struct xhci_hcd *xhci,
1987		struct xhci_virt_device *virt_dev,
1988		int old_active_eps)
1989{
1990	struct xhci_interval_bw_table *bw_table;
1991	struct xhci_tt_bw_info *tt_info;
1992
1993	/* Find the bandwidth table for the root port this TT is attached to. */
1994	bw_table = &xhci->rh_bw[virt_dev->real_port - 1].bw_table;
1995	tt_info = virt_dev->tt_info;
1996	/* If this TT already had active endpoints, the bandwidth for this TT
1997	 * has already been added.  Removing all periodic endpoints (and thus
1998	 * making the TT enactive) will only decrease the bandwidth used.
1999	 */
2000	if (old_active_eps)
2001		return 0;
2002	if (old_active_eps == 0 && tt_info->active_eps != 0) {
2003		if (bw_table->bw_used + TT_HS_OVERHEAD > HS_BW_LIMIT)
2004			return -ENOMEM;
2005		return 0;
2006	}
2007	/* Not sure why we would have no new active endpoints...
2008	 *
2009	 * Maybe because of an Evaluate Context change for a hub update or a
2010	 * control endpoint 0 max packet size change?
2011	 * FIXME: skip the bandwidth calculation in that case.
2012	 */
2013	return 0;
2014}
2015
2016static int xhci_check_ss_bw(struct xhci_hcd *xhci,
2017		struct xhci_virt_device *virt_dev)
2018{
2019	unsigned int bw_reserved;
2020
2021	bw_reserved = DIV_ROUND_UP(SS_BW_RESERVED*SS_BW_LIMIT_IN, 100);
2022	if (virt_dev->bw_table->ss_bw_in > (SS_BW_LIMIT_IN - bw_reserved))
2023		return -ENOMEM;
2024
2025	bw_reserved = DIV_ROUND_UP(SS_BW_RESERVED*SS_BW_LIMIT_OUT, 100);
2026	if (virt_dev->bw_table->ss_bw_out > (SS_BW_LIMIT_OUT - bw_reserved))
2027		return -ENOMEM;
2028
2029	return 0;
2030}
2031
2032/*
2033 * This algorithm is a very conservative estimate of the worst-case scheduling
2034 * scenario for any one interval.  The hardware dynamically schedules the
2035 * packets, so we can't tell which microframe could be the limiting factor in
2036 * the bandwidth scheduling.  This only takes into account periodic endpoints.
2037 *
2038 * Obviously, we can't solve an NP complete problem to find the minimum worst
2039 * case scenario.  Instead, we come up with an estimate that is no less than
2040 * the worst case bandwidth used for any one microframe, but may be an
2041 * over-estimate.
2042 *
2043 * We walk the requirements for each endpoint by interval, starting with the
2044 * smallest interval, and place packets in the schedule where there is only one
2045 * possible way to schedule packets for that interval.  In order to simplify
2046 * this algorithm, we record the largest max packet size for each interval, and
2047 * assume all packets will be that size.
2048 *
2049 * For interval 0, we obviously must schedule all packets for each interval.
2050 * The bandwidth for interval 0 is just the amount of data to be transmitted
2051 * (the sum of all max ESIT payload sizes, plus any overhead per packet times
2052 * the number of packets).
2053 *
2054 * For interval 1, we have two possible microframes to schedule those packets
2055 * in.  For this algorithm, if we can schedule the same number of packets for
2056 * each possible scheduling opportunity (each microframe), we will do so.  The
2057 * remaining number of packets will be saved to be transmitted in the gaps in
2058 * the next interval's scheduling sequence.
2059 *
2060 * As we move those remaining packets to be scheduled with interval 2 packets,
2061 * we have to double the number of remaining packets to transmit.  This is
2062 * because the intervals are actually powers of 2, and we would be transmitting
2063 * the previous interval's packets twice in this interval.  We also have to be
2064 * sure that when we look at the largest max packet size for this interval, we
2065 * also look at the largest max packet size for the remaining packets and take
2066 * the greater of the two.
2067 *
2068 * The algorithm continues to evenly distribute packets in each scheduling
2069 * opportunity, and push the remaining packets out, until we get to the last
2070 * interval.  Then those packets and their associated overhead are just added
2071 * to the bandwidth used.
2072 */
2073static int xhci_check_bw_table(struct xhci_hcd *xhci,
2074		struct xhci_virt_device *virt_dev,
2075		int old_active_eps)
2076{
2077	unsigned int bw_reserved;
2078	unsigned int max_bandwidth;
2079	unsigned int bw_used;
2080	unsigned int block_size;
2081	struct xhci_interval_bw_table *bw_table;
2082	unsigned int packet_size = 0;
2083	unsigned int overhead = 0;
2084	unsigned int packets_transmitted = 0;
2085	unsigned int packets_remaining = 0;
2086	unsigned int i;
2087
2088	if (virt_dev->udev->speed == USB_SPEED_SUPER)
2089		return xhci_check_ss_bw(xhci, virt_dev);
2090
2091	if (virt_dev->udev->speed == USB_SPEED_HIGH) {
2092		max_bandwidth = HS_BW_LIMIT;
2093		/* Convert percent of bus BW reserved to blocks reserved */
2094		bw_reserved = DIV_ROUND_UP(HS_BW_RESERVED * max_bandwidth, 100);
2095	} else {
2096		max_bandwidth = FS_BW_LIMIT;
2097		bw_reserved = DIV_ROUND_UP(FS_BW_RESERVED * max_bandwidth, 100);
2098	}
2099
2100	bw_table = virt_dev->bw_table;
2101	/* We need to translate the max packet size and max ESIT payloads into
2102	 * the units the hardware uses.
2103	 */
2104	block_size = xhci_get_block_size(virt_dev->udev);
2105
2106	/* If we are manipulating a LS/FS device under a HS hub, double check
2107	 * that the HS bus has enough bandwidth if we are activing a new TT.
2108	 */
2109	if (virt_dev->tt_info) {
2110		xhci_dbg(xhci, "Recalculating BW for rootport %u\n",
 
2111				virt_dev->real_port);
2112		if (xhci_check_tt_bw_table(xhci, virt_dev, old_active_eps)) {
2113			xhci_warn(xhci, "Not enough bandwidth on HS bus for "
2114					"newly activated TT.\n");
2115			return -ENOMEM;
2116		}
2117		xhci_dbg(xhci, "Recalculating BW for TT slot %u port %u\n",
 
2118				virt_dev->tt_info->slot_id,
2119				virt_dev->tt_info->ttport);
2120	} else {
2121		xhci_dbg(xhci, "Recalculating BW for rootport %u\n",
 
2122				virt_dev->real_port);
2123	}
2124
2125	/* Add in how much bandwidth will be used for interval zero, or the
2126	 * rounded max ESIT payload + number of packets * largest overhead.
2127	 */
2128	bw_used = DIV_ROUND_UP(bw_table->interval0_esit_payload, block_size) +
2129		bw_table->interval_bw[0].num_packets *
2130		xhci_get_largest_overhead(&bw_table->interval_bw[0]);
2131
2132	for (i = 1; i < XHCI_MAX_INTERVAL; i++) {
2133		unsigned int bw_added;
2134		unsigned int largest_mps;
2135		unsigned int interval_overhead;
2136
2137		/*
2138		 * How many packets could we transmit in this interval?
2139		 * If packets didn't fit in the previous interval, we will need
2140		 * to transmit that many packets twice within this interval.
2141		 */
2142		packets_remaining = 2 * packets_remaining +
2143			bw_table->interval_bw[i].num_packets;
2144
2145		/* Find the largest max packet size of this or the previous
2146		 * interval.
2147		 */
2148		if (list_empty(&bw_table->interval_bw[i].endpoints))
2149			largest_mps = 0;
2150		else {
2151			struct xhci_virt_ep *virt_ep;
2152			struct list_head *ep_entry;
2153
2154			ep_entry = bw_table->interval_bw[i].endpoints.next;
2155			virt_ep = list_entry(ep_entry,
2156					struct xhci_virt_ep, bw_endpoint_list);
2157			/* Convert to blocks, rounding up */
2158			largest_mps = DIV_ROUND_UP(
2159					virt_ep->bw_info.max_packet_size,
2160					block_size);
2161		}
2162		if (largest_mps > packet_size)
2163			packet_size = largest_mps;
2164
2165		/* Use the larger overhead of this or the previous interval. */
2166		interval_overhead = xhci_get_largest_overhead(
2167				&bw_table->interval_bw[i]);
2168		if (interval_overhead > overhead)
2169			overhead = interval_overhead;
2170
2171		/* How many packets can we evenly distribute across
2172		 * (1 << (i + 1)) possible scheduling opportunities?
2173		 */
2174		packets_transmitted = packets_remaining >> (i + 1);
2175
2176		/* Add in the bandwidth used for those scheduled packets */
2177		bw_added = packets_transmitted * (overhead + packet_size);
2178
2179		/* How many packets do we have remaining to transmit? */
2180		packets_remaining = packets_remaining % (1 << (i + 1));
2181
2182		/* What largest max packet size should those packets have? */
2183		/* If we've transmitted all packets, don't carry over the
2184		 * largest packet size.
2185		 */
2186		if (packets_remaining == 0) {
2187			packet_size = 0;
2188			overhead = 0;
2189		} else if (packets_transmitted > 0) {
2190			/* Otherwise if we do have remaining packets, and we've
2191			 * scheduled some packets in this interval, take the
2192			 * largest max packet size from endpoints with this
2193			 * interval.
2194			 */
2195			packet_size = largest_mps;
2196			overhead = interval_overhead;
2197		}
2198		/* Otherwise carry over packet_size and overhead from the last
2199		 * time we had a remainder.
2200		 */
2201		bw_used += bw_added;
2202		if (bw_used > max_bandwidth) {
2203			xhci_warn(xhci, "Not enough bandwidth. "
2204					"Proposed: %u, Max: %u\n",
2205				bw_used, max_bandwidth);
2206			return -ENOMEM;
2207		}
2208	}
2209	/*
2210	 * Ok, we know we have some packets left over after even-handedly
2211	 * scheduling interval 15.  We don't know which microframes they will
2212	 * fit into, so we over-schedule and say they will be scheduled every
2213	 * microframe.
2214	 */
2215	if (packets_remaining > 0)
2216		bw_used += overhead + packet_size;
2217
2218	if (!virt_dev->tt_info && virt_dev->udev->speed == USB_SPEED_HIGH) {
2219		unsigned int port_index = virt_dev->real_port - 1;
2220
2221		/* OK, we're manipulating a HS device attached to a
2222		 * root port bandwidth domain.  Include the number of active TTs
2223		 * in the bandwidth used.
2224		 */
2225		bw_used += TT_HS_OVERHEAD *
2226			xhci->rh_bw[port_index].num_active_tts;
2227	}
2228
2229	xhci_dbg(xhci, "Final bandwidth: %u, Limit: %u, Reserved: %u, "
2230		"Available: %u " "percent\n",
 
2231		bw_used, max_bandwidth, bw_reserved,
2232		(max_bandwidth - bw_used - bw_reserved) * 100 /
2233		max_bandwidth);
2234
2235	bw_used += bw_reserved;
2236	if (bw_used > max_bandwidth) {
2237		xhci_warn(xhci, "Not enough bandwidth. Proposed: %u, Max: %u\n",
2238				bw_used, max_bandwidth);
2239		return -ENOMEM;
2240	}
2241
2242	bw_table->bw_used = bw_used;
2243	return 0;
2244}
2245
2246static bool xhci_is_async_ep(unsigned int ep_type)
2247{
2248	return (ep_type != ISOC_OUT_EP && ep_type != INT_OUT_EP &&
2249					ep_type != ISOC_IN_EP &&
2250					ep_type != INT_IN_EP);
2251}
2252
2253static bool xhci_is_sync_in_ep(unsigned int ep_type)
2254{
2255	return (ep_type == ISOC_IN_EP || ep_type != INT_IN_EP);
2256}
2257
2258static unsigned int xhci_get_ss_bw_consumed(struct xhci_bw_info *ep_bw)
2259{
2260	unsigned int mps = DIV_ROUND_UP(ep_bw->max_packet_size, SS_BLOCK);
2261
2262	if (ep_bw->ep_interval == 0)
2263		return SS_OVERHEAD_BURST +
2264			(ep_bw->mult * ep_bw->num_packets *
2265					(SS_OVERHEAD + mps));
2266	return DIV_ROUND_UP(ep_bw->mult * ep_bw->num_packets *
2267				(SS_OVERHEAD + mps + SS_OVERHEAD_BURST),
2268				1 << ep_bw->ep_interval);
2269
2270}
2271
2272void xhci_drop_ep_from_interval_table(struct xhci_hcd *xhci,
2273		struct xhci_bw_info *ep_bw,
2274		struct xhci_interval_bw_table *bw_table,
2275		struct usb_device *udev,
2276		struct xhci_virt_ep *virt_ep,
2277		struct xhci_tt_bw_info *tt_info)
2278{
2279	struct xhci_interval_bw	*interval_bw;
2280	int normalized_interval;
2281
2282	if (xhci_is_async_ep(ep_bw->type))
2283		return;
2284
2285	if (udev->speed == USB_SPEED_SUPER) {
2286		if (xhci_is_sync_in_ep(ep_bw->type))
2287			xhci->devs[udev->slot_id]->bw_table->ss_bw_in -=
2288				xhci_get_ss_bw_consumed(ep_bw);
2289		else
2290			xhci->devs[udev->slot_id]->bw_table->ss_bw_out -=
2291				xhci_get_ss_bw_consumed(ep_bw);
2292		return;
2293	}
2294
2295	/* SuperSpeed endpoints never get added to intervals in the table, so
2296	 * this check is only valid for HS/FS/LS devices.
2297	 */
2298	if (list_empty(&virt_ep->bw_endpoint_list))
2299		return;
2300	/* For LS/FS devices, we need to translate the interval expressed in
2301	 * microframes to frames.
2302	 */
2303	if (udev->speed == USB_SPEED_HIGH)
2304		normalized_interval = ep_bw->ep_interval;
2305	else
2306		normalized_interval = ep_bw->ep_interval - 3;
2307
2308	if (normalized_interval == 0)
2309		bw_table->interval0_esit_payload -= ep_bw->max_esit_payload;
2310	interval_bw = &bw_table->interval_bw[normalized_interval];
2311	interval_bw->num_packets -= ep_bw->num_packets;
2312	switch (udev->speed) {
2313	case USB_SPEED_LOW:
2314		interval_bw->overhead[LS_OVERHEAD_TYPE] -= 1;
2315		break;
2316	case USB_SPEED_FULL:
2317		interval_bw->overhead[FS_OVERHEAD_TYPE] -= 1;
2318		break;
2319	case USB_SPEED_HIGH:
2320		interval_bw->overhead[HS_OVERHEAD_TYPE] -= 1;
2321		break;
2322	case USB_SPEED_SUPER:
 
2323	case USB_SPEED_UNKNOWN:
2324	case USB_SPEED_WIRELESS:
2325		/* Should never happen because only LS/FS/HS endpoints will get
2326		 * added to the endpoint list.
2327		 */
2328		return;
2329	}
2330	if (tt_info)
2331		tt_info->active_eps -= 1;
2332	list_del_init(&virt_ep->bw_endpoint_list);
2333}
2334
2335static void xhci_add_ep_to_interval_table(struct xhci_hcd *xhci,
2336		struct xhci_bw_info *ep_bw,
2337		struct xhci_interval_bw_table *bw_table,
2338		struct usb_device *udev,
2339		struct xhci_virt_ep *virt_ep,
2340		struct xhci_tt_bw_info *tt_info)
2341{
2342	struct xhci_interval_bw	*interval_bw;
2343	struct xhci_virt_ep *smaller_ep;
2344	int normalized_interval;
2345
2346	if (xhci_is_async_ep(ep_bw->type))
2347		return;
2348
2349	if (udev->speed == USB_SPEED_SUPER) {
2350		if (xhci_is_sync_in_ep(ep_bw->type))
2351			xhci->devs[udev->slot_id]->bw_table->ss_bw_in +=
2352				xhci_get_ss_bw_consumed(ep_bw);
2353		else
2354			xhci->devs[udev->slot_id]->bw_table->ss_bw_out +=
2355				xhci_get_ss_bw_consumed(ep_bw);
2356		return;
2357	}
2358
2359	/* For LS/FS devices, we need to translate the interval expressed in
2360	 * microframes to frames.
2361	 */
2362	if (udev->speed == USB_SPEED_HIGH)
2363		normalized_interval = ep_bw->ep_interval;
2364	else
2365		normalized_interval = ep_bw->ep_interval - 3;
2366
2367	if (normalized_interval == 0)
2368		bw_table->interval0_esit_payload += ep_bw->max_esit_payload;
2369	interval_bw = &bw_table->interval_bw[normalized_interval];
2370	interval_bw->num_packets += ep_bw->num_packets;
2371	switch (udev->speed) {
2372	case USB_SPEED_LOW:
2373		interval_bw->overhead[LS_OVERHEAD_TYPE] += 1;
2374		break;
2375	case USB_SPEED_FULL:
2376		interval_bw->overhead[FS_OVERHEAD_TYPE] += 1;
2377		break;
2378	case USB_SPEED_HIGH:
2379		interval_bw->overhead[HS_OVERHEAD_TYPE] += 1;
2380		break;
2381	case USB_SPEED_SUPER:
 
2382	case USB_SPEED_UNKNOWN:
2383	case USB_SPEED_WIRELESS:
2384		/* Should never happen because only LS/FS/HS endpoints will get
2385		 * added to the endpoint list.
2386		 */
2387		return;
2388	}
2389
2390	if (tt_info)
2391		tt_info->active_eps += 1;
2392	/* Insert the endpoint into the list, largest max packet size first. */
2393	list_for_each_entry(smaller_ep, &interval_bw->endpoints,
2394			bw_endpoint_list) {
2395		if (ep_bw->max_packet_size >=
2396				smaller_ep->bw_info.max_packet_size) {
2397			/* Add the new ep before the smaller endpoint */
2398			list_add_tail(&virt_ep->bw_endpoint_list,
2399					&smaller_ep->bw_endpoint_list);
2400			return;
2401		}
2402	}
2403	/* Add the new endpoint at the end of the list. */
2404	list_add_tail(&virt_ep->bw_endpoint_list,
2405			&interval_bw->endpoints);
2406}
2407
2408void xhci_update_tt_active_eps(struct xhci_hcd *xhci,
2409		struct xhci_virt_device *virt_dev,
2410		int old_active_eps)
2411{
2412	struct xhci_root_port_bw_info *rh_bw_info;
2413	if (!virt_dev->tt_info)
2414		return;
2415
2416	rh_bw_info = &xhci->rh_bw[virt_dev->real_port - 1];
2417	if (old_active_eps == 0 &&
2418				virt_dev->tt_info->active_eps != 0) {
2419		rh_bw_info->num_active_tts += 1;
2420		rh_bw_info->bw_table.bw_used += TT_HS_OVERHEAD;
2421	} else if (old_active_eps != 0 &&
2422				virt_dev->tt_info->active_eps == 0) {
2423		rh_bw_info->num_active_tts -= 1;
2424		rh_bw_info->bw_table.bw_used -= TT_HS_OVERHEAD;
2425	}
2426}
2427
2428static int xhci_reserve_bandwidth(struct xhci_hcd *xhci,
2429		struct xhci_virt_device *virt_dev,
2430		struct xhci_container_ctx *in_ctx)
2431{
2432	struct xhci_bw_info ep_bw_info[31];
2433	int i;
2434	struct xhci_input_control_ctx *ctrl_ctx;
2435	int old_active_eps = 0;
2436
2437	if (virt_dev->tt_info)
2438		old_active_eps = virt_dev->tt_info->active_eps;
2439
2440	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
 
 
 
 
 
2441
2442	for (i = 0; i < 31; i++) {
2443		if (!EP_IS_ADDED(ctrl_ctx, i) && !EP_IS_DROPPED(ctrl_ctx, i))
2444			continue;
2445
2446		/* Make a copy of the BW info in case we need to revert this */
2447		memcpy(&ep_bw_info[i], &virt_dev->eps[i].bw_info,
2448				sizeof(ep_bw_info[i]));
2449		/* Drop the endpoint from the interval table if the endpoint is
2450		 * being dropped or changed.
2451		 */
2452		if (EP_IS_DROPPED(ctrl_ctx, i))
2453			xhci_drop_ep_from_interval_table(xhci,
2454					&virt_dev->eps[i].bw_info,
2455					virt_dev->bw_table,
2456					virt_dev->udev,
2457					&virt_dev->eps[i],
2458					virt_dev->tt_info);
2459	}
2460	/* Overwrite the information stored in the endpoints' bw_info */
2461	xhci_update_bw_info(xhci, virt_dev->in_ctx, ctrl_ctx, virt_dev);
2462	for (i = 0; i < 31; i++) {
2463		/* Add any changed or added endpoints to the interval table */
2464		if (EP_IS_ADDED(ctrl_ctx, i))
2465			xhci_add_ep_to_interval_table(xhci,
2466					&virt_dev->eps[i].bw_info,
2467					virt_dev->bw_table,
2468					virt_dev->udev,
2469					&virt_dev->eps[i],
2470					virt_dev->tt_info);
2471	}
2472
2473	if (!xhci_check_bw_table(xhci, virt_dev, old_active_eps)) {
2474		/* Ok, this fits in the bandwidth we have.
2475		 * Update the number of active TTs.
2476		 */
2477		xhci_update_tt_active_eps(xhci, virt_dev, old_active_eps);
2478		return 0;
2479	}
2480
2481	/* We don't have enough bandwidth for this, revert the stored info. */
2482	for (i = 0; i < 31; i++) {
2483		if (!EP_IS_ADDED(ctrl_ctx, i) && !EP_IS_DROPPED(ctrl_ctx, i))
2484			continue;
2485
2486		/* Drop the new copies of any added or changed endpoints from
2487		 * the interval table.
2488		 */
2489		if (EP_IS_ADDED(ctrl_ctx, i)) {
2490			xhci_drop_ep_from_interval_table(xhci,
2491					&virt_dev->eps[i].bw_info,
2492					virt_dev->bw_table,
2493					virt_dev->udev,
2494					&virt_dev->eps[i],
2495					virt_dev->tt_info);
2496		}
2497		/* Revert the endpoint back to its old information */
2498		memcpy(&virt_dev->eps[i].bw_info, &ep_bw_info[i],
2499				sizeof(ep_bw_info[i]));
2500		/* Add any changed or dropped endpoints back into the table */
2501		if (EP_IS_DROPPED(ctrl_ctx, i))
2502			xhci_add_ep_to_interval_table(xhci,
2503					&virt_dev->eps[i].bw_info,
2504					virt_dev->bw_table,
2505					virt_dev->udev,
2506					&virt_dev->eps[i],
2507					virt_dev->tt_info);
2508	}
2509	return -ENOMEM;
2510}
2511
2512
2513/* Issue a configure endpoint command or evaluate context command
2514 * and wait for it to finish.
2515 */
2516static int xhci_configure_endpoint(struct xhci_hcd *xhci,
2517		struct usb_device *udev,
2518		struct xhci_command *command,
2519		bool ctx_change, bool must_succeed)
2520{
2521	int ret;
2522	int timeleft;
2523	unsigned long flags;
2524	struct xhci_container_ctx *in_ctx;
2525	struct completion *cmd_completion;
2526	u32 *cmd_status;
2527	struct xhci_virt_device *virt_dev;
2528	union xhci_trb *cmd_trb;
 
 
2529
2530	spin_lock_irqsave(&xhci->lock, flags);
2531	virt_dev = xhci->devs[udev->slot_id];
2532
2533	if (command)
2534		in_ctx = command->in_ctx;
2535	else
2536		in_ctx = virt_dev->in_ctx;
 
 
 
2537
2538	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK) &&
2539			xhci_reserve_host_resources(xhci, in_ctx)) {
2540		spin_unlock_irqrestore(&xhci->lock, flags);
2541		xhci_warn(xhci, "Not enough host resources, "
2542				"active endpoint contexts = %u\n",
2543				xhci->num_active_eps);
2544		return -ENOMEM;
2545	}
2546	if ((xhci->quirks & XHCI_SW_BW_CHECKING) &&
2547			xhci_reserve_bandwidth(xhci, virt_dev, in_ctx)) {
2548		if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK))
2549			xhci_free_host_resources(xhci, in_ctx);
2550		spin_unlock_irqrestore(&xhci->lock, flags);
2551		xhci_warn(xhci, "Not enough bandwidth\n");
2552		return -ENOMEM;
2553	}
2554
2555	if (command) {
2556		cmd_completion = command->completion;
2557		cmd_status = &command->status;
2558		command->command_trb = xhci->cmd_ring->enqueue;
2559
2560		/* Enqueue pointer can be left pointing to the link TRB,
2561		 * we must handle that
2562		 */
2563		if (TRB_TYPE_LINK_LE32(command->command_trb->link.control))
2564			command->command_trb =
2565				xhci->cmd_ring->enq_seg->next->trbs;
2566
2567		list_add_tail(&command->cmd_list, &virt_dev->cmd_list);
2568	} else {
2569		cmd_completion = &virt_dev->cmd_completion;
2570		cmd_status = &virt_dev->cmd_status;
2571	}
2572	init_completion(cmd_completion);
2573
2574	cmd_trb = xhci->cmd_ring->dequeue;
2575	if (!ctx_change)
2576		ret = xhci_queue_configure_endpoint(xhci, in_ctx->dma,
 
2577				udev->slot_id, must_succeed);
2578	else
2579		ret = xhci_queue_evaluate_context(xhci, in_ctx->dma,
 
2580				udev->slot_id, must_succeed);
2581	if (ret < 0) {
2582		if (command)
2583			list_del(&command->cmd_list);
2584		if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK))
2585			xhci_free_host_resources(xhci, in_ctx);
2586		spin_unlock_irqrestore(&xhci->lock, flags);
2587		xhci_dbg(xhci, "FIXME allocate a new ring segment\n");
 
2588		return -ENOMEM;
2589	}
2590	xhci_ring_cmd_db(xhci);
2591	spin_unlock_irqrestore(&xhci->lock, flags);
2592
2593	/* Wait for the configure endpoint command to complete */
2594	timeleft = wait_for_completion_interruptible_timeout(
2595			cmd_completion,
2596			XHCI_CMD_DEFAULT_TIMEOUT);
2597	if (timeleft <= 0) {
2598		xhci_warn(xhci, "%s while waiting for %s command\n",
2599				timeleft == 0 ? "Timeout" : "Signal",
2600				ctx_change == 0 ?
2601					"configure endpoint" :
2602					"evaluate context");
2603		/* cancel the configure endpoint command */
2604		ret = xhci_cancel_cmd(xhci, command, cmd_trb);
2605		if (ret < 0)
2606			return ret;
2607		return -ETIME;
2608	}
2609
2610	if (!ctx_change)
2611		ret = xhci_configure_endpoint_result(xhci, udev, cmd_status);
 
2612	else
2613		ret = xhci_evaluate_context_result(xhci, udev, cmd_status);
 
2614
2615	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
2616		spin_lock_irqsave(&xhci->lock, flags);
2617		/* If the command failed, remove the reserved resources.
2618		 * Otherwise, clean up the estimate to include dropped eps.
2619		 */
2620		if (ret)
2621			xhci_free_host_resources(xhci, in_ctx);
2622		else
2623			xhci_finish_resource_reservation(xhci, in_ctx);
2624		spin_unlock_irqrestore(&xhci->lock, flags);
2625	}
2626	return ret;
2627}
2628
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2629/* Called after one or more calls to xhci_add_endpoint() or
2630 * xhci_drop_endpoint().  If this call fails, the USB core is expected
2631 * to call xhci_reset_bandwidth().
2632 *
2633 * Since we are in the middle of changing either configuration or
2634 * installing a new alt setting, the USB core won't allow URBs to be
2635 * enqueued for any endpoint on the old config or interface.  Nothing
2636 * else should be touching the xhci->devs[slot_id] structure, so we
2637 * don't need to take the xhci->lock for manipulating that.
2638 */
2639int xhci_check_bandwidth(struct usb_hcd *hcd, struct usb_device *udev)
2640{
2641	int i;
2642	int ret = 0;
2643	struct xhci_hcd *xhci;
2644	struct xhci_virt_device	*virt_dev;
2645	struct xhci_input_control_ctx *ctrl_ctx;
2646	struct xhci_slot_ctx *slot_ctx;
 
2647
2648	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
2649	if (ret <= 0)
2650		return ret;
2651	xhci = hcd_to_xhci(hcd);
2652	if (xhci->xhc_state & XHCI_STATE_DYING)
 
2653		return -ENODEV;
2654
2655	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
2656	virt_dev = xhci->devs[udev->slot_id];
2657
 
 
 
 
 
 
2658	/* See section 4.6.6 - A0 = 1; A1 = D0 = D1 = 0 */
2659	ctrl_ctx = xhci_get_input_control_ctx(xhci, virt_dev->in_ctx);
 
 
 
 
 
 
2660	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
2661	ctrl_ctx->add_flags &= cpu_to_le32(~EP0_FLAG);
2662	ctrl_ctx->drop_flags &= cpu_to_le32(~(SLOT_FLAG | EP0_FLAG));
2663
2664	/* Don't issue the command if there's no endpoints to update. */
2665	if (ctrl_ctx->add_flags == cpu_to_le32(SLOT_FLAG) &&
2666			ctrl_ctx->drop_flags == 0)
2667		return 0;
 
 
 
 
 
 
2668
 
 
 
 
 
 
 
2669	xhci_dbg(xhci, "New Input Control Context:\n");
2670	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
2671	xhci_dbg_ctx(xhci, virt_dev->in_ctx,
2672		     LAST_CTX_TO_EP_NUM(le32_to_cpu(slot_ctx->dev_info)));
2673
2674	ret = xhci_configure_endpoint(xhci, udev, NULL,
2675			false, false);
2676	if (ret) {
2677		/* Callee should call reset_bandwidth() */
2678		return ret;
2679	}
2680
2681	xhci_dbg(xhci, "Output context after successful config ep cmd:\n");
2682	xhci_dbg_ctx(xhci, virt_dev->out_ctx,
2683		     LAST_CTX_TO_EP_NUM(le32_to_cpu(slot_ctx->dev_info)));
2684
2685	/* Free any rings that were dropped, but not changed. */
2686	for (i = 1; i < 31; ++i) {
2687		if ((le32_to_cpu(ctrl_ctx->drop_flags) & (1 << (i + 1))) &&
2688		    !(le32_to_cpu(ctrl_ctx->add_flags) & (1 << (i + 1))))
2689			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
 
 
2690	}
2691	xhci_zero_in_ctx(xhci, virt_dev);
2692	/*
2693	 * Install any rings for completely new endpoints or changed endpoints,
2694	 * and free or cache any old rings from changed endpoints.
2695	 */
2696	for (i = 1; i < 31; ++i) {
2697		if (!virt_dev->eps[i].new_ring)
2698			continue;
2699		/* Only cache or free the old ring if it exists.
2700		 * It may not if this is the first add of an endpoint.
2701		 */
2702		if (virt_dev->eps[i].ring) {
2703			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
2704		}
 
2705		virt_dev->eps[i].ring = virt_dev->eps[i].new_ring;
2706		virt_dev->eps[i].new_ring = NULL;
2707	}
 
 
 
2708
2709	return ret;
2710}
2711
2712void xhci_reset_bandwidth(struct usb_hcd *hcd, struct usb_device *udev)
2713{
2714	struct xhci_hcd *xhci;
2715	struct xhci_virt_device	*virt_dev;
2716	int i, ret;
2717
2718	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
2719	if (ret <= 0)
2720		return;
2721	xhci = hcd_to_xhci(hcd);
2722
2723	xhci_dbg(xhci, "%s called for udev %p\n", __func__, udev);
2724	virt_dev = xhci->devs[udev->slot_id];
2725	/* Free any rings allocated for added endpoints */
2726	for (i = 0; i < 31; ++i) {
2727		if (virt_dev->eps[i].new_ring) {
2728			xhci_ring_free(xhci, virt_dev->eps[i].new_ring);
2729			virt_dev->eps[i].new_ring = NULL;
2730		}
2731	}
2732	xhci_zero_in_ctx(xhci, virt_dev);
2733}
2734
2735static void xhci_setup_input_ctx_for_config_ep(struct xhci_hcd *xhci,
2736		struct xhci_container_ctx *in_ctx,
2737		struct xhci_container_ctx *out_ctx,
 
2738		u32 add_flags, u32 drop_flags)
2739{
2740	struct xhci_input_control_ctx *ctrl_ctx;
2741	ctrl_ctx = xhci_get_input_control_ctx(xhci, in_ctx);
2742	ctrl_ctx->add_flags = cpu_to_le32(add_flags);
2743	ctrl_ctx->drop_flags = cpu_to_le32(drop_flags);
2744	xhci_slot_copy(xhci, in_ctx, out_ctx);
2745	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
2746
2747	xhci_dbg(xhci, "Input Context:\n");
2748	xhci_dbg_ctx(xhci, in_ctx, xhci_last_valid_endpoint(add_flags));
2749}
2750
2751static void xhci_setup_input_ctx_for_quirk(struct xhci_hcd *xhci,
2752		unsigned int slot_id, unsigned int ep_index,
2753		struct xhci_dequeue_state *deq_state)
2754{
 
2755	struct xhci_container_ctx *in_ctx;
2756	struct xhci_ep_ctx *ep_ctx;
2757	u32 added_ctxs;
2758	dma_addr_t addr;
2759
 
 
 
 
 
 
 
 
2760	xhci_endpoint_copy(xhci, xhci->devs[slot_id]->in_ctx,
2761			xhci->devs[slot_id]->out_ctx, ep_index);
2762	in_ctx = xhci->devs[slot_id]->in_ctx;
2763	ep_ctx = xhci_get_ep_ctx(xhci, in_ctx, ep_index);
2764	addr = xhci_trb_virt_to_dma(deq_state->new_deq_seg,
2765			deq_state->new_deq_ptr);
2766	if (addr == 0) {
2767		xhci_warn(xhci, "WARN Cannot submit config ep after "
2768				"reset ep command\n");
2769		xhci_warn(xhci, "WARN deq seg = %p, deq ptr = %p\n",
2770				deq_state->new_deq_seg,
2771				deq_state->new_deq_ptr);
2772		return;
2773	}
2774	ep_ctx->deq = cpu_to_le64(addr | deq_state->new_cycle_state);
2775
2776	added_ctxs = xhci_get_endpoint_flag_from_index(ep_index);
2777	xhci_setup_input_ctx_for_config_ep(xhci, xhci->devs[slot_id]->in_ctx,
2778			xhci->devs[slot_id]->out_ctx, added_ctxs, added_ctxs);
 
2779}
2780
2781void xhci_cleanup_stalled_ring(struct xhci_hcd *xhci,
2782		struct usb_device *udev, unsigned int ep_index)
2783{
2784	struct xhci_dequeue_state deq_state;
2785	struct xhci_virt_ep *ep;
 
2786
2787	xhci_dbg(xhci, "Cleaning up stalled endpoint ring\n");
 
2788	ep = &xhci->devs[udev->slot_id]->eps[ep_index];
2789	/* We need to move the HW's dequeue pointer past this TD,
2790	 * or it will attempt to resend it on the next doorbell ring.
2791	 */
2792	xhci_find_new_dequeue_state(xhci, udev->slot_id,
2793			ep_index, ep->stopped_stream, ep->stopped_td,
2794			&deq_state);
 
 
2795
2796	/* HW with the reset endpoint quirk will use the saved dequeue state to
2797	 * issue a configure endpoint command later.
2798	 */
2799	if (!(xhci->quirks & XHCI_RESET_EP_QUIRK)) {
2800		xhci_dbg(xhci, "Queueing new dequeue state\n");
 
2801		xhci_queue_new_dequeue_state(xhci, udev->slot_id,
2802				ep_index, ep->stopped_stream, &deq_state);
2803	} else {
2804		/* Better hope no one uses the input context between now and the
2805		 * reset endpoint completion!
2806		 * XXX: No idea how this hardware will react when stream rings
2807		 * are enabled.
2808		 */
2809		xhci_dbg(xhci, "Setting up input context for "
2810				"configure endpoint command\n");
 
2811		xhci_setup_input_ctx_for_quirk(xhci, udev->slot_id,
2812				ep_index, &deq_state);
2813	}
2814}
2815
2816/* Deal with stalled endpoints.  The core should have sent the control message
2817 * to clear the halt condition.  However, we need to make the xHCI hardware
2818 * reset its sequence number, since a device will expect a sequence number of
2819 * zero after the halt condition is cleared.
 
2820 * Context: in_interrupt
2821 */
 
2822void xhci_endpoint_reset(struct usb_hcd *hcd,
2823		struct usb_host_endpoint *ep)
2824{
2825	struct xhci_hcd *xhci;
2826	struct usb_device *udev;
2827	unsigned int ep_index;
2828	unsigned long flags;
2829	int ret;
2830	struct xhci_virt_ep *virt_ep;
2831
2832	xhci = hcd_to_xhci(hcd);
2833	udev = (struct usb_device *) ep->hcpriv;
2834	/* Called with a root hub endpoint (or an endpoint that wasn't added
2835	 * with xhci_add_endpoint()
2836	 */
2837	if (!ep->hcpriv)
2838		return;
2839	ep_index = xhci_get_endpoint_index(&ep->desc);
2840	virt_ep = &xhci->devs[udev->slot_id]->eps[ep_index];
2841	if (!virt_ep->stopped_td) {
2842		xhci_dbg(xhci, "Endpoint 0x%x not halted, refusing to reset.\n",
2843				ep->desc.bEndpointAddress);
2844		return;
2845	}
2846	if (usb_endpoint_xfer_control(&ep->desc)) {
2847		xhci_dbg(xhci, "Control endpoint stall already handled.\n");
2848		return;
2849	}
2850
2851	xhci_dbg(xhci, "Queueing reset endpoint command\n");
2852	spin_lock_irqsave(&xhci->lock, flags);
2853	ret = xhci_queue_reset_ep(xhci, udev->slot_id, ep_index);
2854	/*
2855	 * Can't change the ring dequeue pointer until it's transitioned to the
2856	 * stopped state, which is only upon a successful reset endpoint
2857	 * command.  Better hope that last command worked!
 
 
 
2858	 */
2859	if (!ret) {
2860		xhci_cleanup_stalled_ring(xhci, udev, ep_index);
2861		kfree(virt_ep->stopped_td);
2862		xhci_ring_cmd_db(xhci);
2863	}
2864	virt_ep->stopped_td = NULL;
2865	virt_ep->stopped_trb = NULL;
2866	virt_ep->stopped_stream = 0;
2867	spin_unlock_irqrestore(&xhci->lock, flags);
2868
2869	if (ret)
2870		xhci_warn(xhci, "FIXME allocate a new ring segment\n");
 
2871}
2872
2873static int xhci_check_streams_endpoint(struct xhci_hcd *xhci,
2874		struct usb_device *udev, struct usb_host_endpoint *ep,
2875		unsigned int slot_id)
2876{
2877	int ret;
2878	unsigned int ep_index;
2879	unsigned int ep_state;
2880
2881	if (!ep)
2882		return -EINVAL;
2883	ret = xhci_check_args(xhci_to_hcd(xhci), udev, ep, 1, true, __func__);
2884	if (ret <= 0)
2885		return -EINVAL;
2886	if (ep->ss_ep_comp.bmAttributes == 0) {
2887		xhci_warn(xhci, "WARN: SuperSpeed Endpoint Companion"
2888				" descriptor for ep 0x%x does not support streams\n",
2889				ep->desc.bEndpointAddress);
2890		return -EINVAL;
2891	}
2892
2893	ep_index = xhci_get_endpoint_index(&ep->desc);
2894	ep_state = xhci->devs[slot_id]->eps[ep_index].ep_state;
2895	if (ep_state & EP_HAS_STREAMS ||
2896			ep_state & EP_GETTING_STREAMS) {
2897		xhci_warn(xhci, "WARN: SuperSpeed bulk endpoint 0x%x "
2898				"already has streams set up.\n",
2899				ep->desc.bEndpointAddress);
2900		xhci_warn(xhci, "Send email to xHCI maintainer and ask for "
2901				"dynamic stream context array reallocation.\n");
2902		return -EINVAL;
2903	}
2904	if (!list_empty(&xhci->devs[slot_id]->eps[ep_index].ring->td_list)) {
2905		xhci_warn(xhci, "Cannot setup streams for SuperSpeed bulk "
2906				"endpoint 0x%x; URBs are pending.\n",
2907				ep->desc.bEndpointAddress);
2908		return -EINVAL;
2909	}
2910	return 0;
2911}
2912
2913static void xhci_calculate_streams_entries(struct xhci_hcd *xhci,
2914		unsigned int *num_streams, unsigned int *num_stream_ctxs)
2915{
2916	unsigned int max_streams;
2917
2918	/* The stream context array size must be a power of two */
2919	*num_stream_ctxs = roundup_pow_of_two(*num_streams);
2920	/*
2921	 * Find out how many primary stream array entries the host controller
2922	 * supports.  Later we may use secondary stream arrays (similar to 2nd
2923	 * level page entries), but that's an optional feature for xHCI host
2924	 * controllers. xHCs must support at least 4 stream IDs.
2925	 */
2926	max_streams = HCC_MAX_PSA(xhci->hcc_params);
2927	if (*num_stream_ctxs > max_streams) {
2928		xhci_dbg(xhci, "xHCI HW only supports %u stream ctx entries.\n",
2929				max_streams);
2930		*num_stream_ctxs = max_streams;
2931		*num_streams = max_streams;
2932	}
2933}
2934
2935/* Returns an error code if one of the endpoint already has streams.
2936 * This does not change any data structures, it only checks and gathers
2937 * information.
2938 */
2939static int xhci_calculate_streams_and_bitmask(struct xhci_hcd *xhci,
2940		struct usb_device *udev,
2941		struct usb_host_endpoint **eps, unsigned int num_eps,
2942		unsigned int *num_streams, u32 *changed_ep_bitmask)
2943{
2944	unsigned int max_streams;
2945	unsigned int endpoint_flag;
2946	int i;
2947	int ret;
2948
2949	for (i = 0; i < num_eps; i++) {
2950		ret = xhci_check_streams_endpoint(xhci, udev,
2951				eps[i], udev->slot_id);
2952		if (ret < 0)
2953			return ret;
2954
2955		max_streams = usb_ss_max_streams(&eps[i]->ss_ep_comp);
2956		if (max_streams < (*num_streams - 1)) {
2957			xhci_dbg(xhci, "Ep 0x%x only supports %u stream IDs.\n",
2958					eps[i]->desc.bEndpointAddress,
2959					max_streams);
2960			*num_streams = max_streams+1;
2961		}
2962
2963		endpoint_flag = xhci_get_endpoint_flag(&eps[i]->desc);
2964		if (*changed_ep_bitmask & endpoint_flag)
2965			return -EINVAL;
2966		*changed_ep_bitmask |= endpoint_flag;
2967	}
2968	return 0;
2969}
2970
2971static u32 xhci_calculate_no_streams_bitmask(struct xhci_hcd *xhci,
2972		struct usb_device *udev,
2973		struct usb_host_endpoint **eps, unsigned int num_eps)
2974{
2975	u32 changed_ep_bitmask = 0;
2976	unsigned int slot_id;
2977	unsigned int ep_index;
2978	unsigned int ep_state;
2979	int i;
2980
2981	slot_id = udev->slot_id;
2982	if (!xhci->devs[slot_id])
2983		return 0;
2984
2985	for (i = 0; i < num_eps; i++) {
2986		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
2987		ep_state = xhci->devs[slot_id]->eps[ep_index].ep_state;
2988		/* Are streams already being freed for the endpoint? */
2989		if (ep_state & EP_GETTING_NO_STREAMS) {
2990			xhci_warn(xhci, "WARN Can't disable streams for "
2991					"endpoint 0x%x\n, "
2992					"streams are being disabled already.",
2993					eps[i]->desc.bEndpointAddress);
2994			return 0;
2995		}
2996		/* Are there actually any streams to free? */
2997		if (!(ep_state & EP_HAS_STREAMS) &&
2998				!(ep_state & EP_GETTING_STREAMS)) {
2999			xhci_warn(xhci, "WARN Can't disable streams for "
3000					"endpoint 0x%x\n, "
3001					"streams are already disabled!",
3002					eps[i]->desc.bEndpointAddress);
3003			xhci_warn(xhci, "WARN xhci_free_streams() called "
3004					"with non-streams endpoint\n");
3005			return 0;
3006		}
3007		changed_ep_bitmask |= xhci_get_endpoint_flag(&eps[i]->desc);
3008	}
3009	return changed_ep_bitmask;
3010}
3011
3012/*
3013 * The USB device drivers use this function (though the HCD interface in USB
3014 * core) to prepare a set of bulk endpoints to use streams.  Streams are used to
3015 * coordinate mass storage command queueing across multiple endpoints (basically
3016 * a stream ID == a task ID).
3017 *
3018 * Setting up streams involves allocating the same size stream context array
3019 * for each endpoint and issuing a configure endpoint command for all endpoints.
3020 *
3021 * Don't allow the call to succeed if one endpoint only supports one stream
3022 * (which means it doesn't support streams at all).
3023 *
3024 * Drivers may get less stream IDs than they asked for, if the host controller
3025 * hardware or endpoints claim they can't support the number of requested
3026 * stream IDs.
3027 */
3028int xhci_alloc_streams(struct usb_hcd *hcd, struct usb_device *udev,
3029		struct usb_host_endpoint **eps, unsigned int num_eps,
3030		unsigned int num_streams, gfp_t mem_flags)
3031{
3032	int i, ret;
3033	struct xhci_hcd *xhci;
3034	struct xhci_virt_device *vdev;
3035	struct xhci_command *config_cmd;
 
3036	unsigned int ep_index;
3037	unsigned int num_stream_ctxs;
3038	unsigned long flags;
3039	u32 changed_ep_bitmask = 0;
3040
3041	if (!eps)
3042		return -EINVAL;
3043
3044	/* Add one to the number of streams requested to account for
3045	 * stream 0 that is reserved for xHCI usage.
3046	 */
3047	num_streams += 1;
3048	xhci = hcd_to_xhci(hcd);
3049	xhci_dbg(xhci, "Driver wants %u stream IDs (including stream 0).\n",
3050			num_streams);
3051
 
 
 
 
 
 
 
3052	config_cmd = xhci_alloc_command(xhci, true, true, mem_flags);
3053	if (!config_cmd) {
3054		xhci_dbg(xhci, "Could not allocate xHCI command structure.\n");
3055		return -ENOMEM;
3056	}
 
 
 
 
 
 
 
3057
3058	/* Check to make sure all endpoints are not already configured for
3059	 * streams.  While we're at it, find the maximum number of streams that
3060	 * all the endpoints will support and check for duplicate endpoints.
3061	 */
3062	spin_lock_irqsave(&xhci->lock, flags);
3063	ret = xhci_calculate_streams_and_bitmask(xhci, udev, eps,
3064			num_eps, &num_streams, &changed_ep_bitmask);
3065	if (ret < 0) {
3066		xhci_free_command(xhci, config_cmd);
3067		spin_unlock_irqrestore(&xhci->lock, flags);
3068		return ret;
3069	}
3070	if (num_streams <= 1) {
3071		xhci_warn(xhci, "WARN: endpoints can't handle "
3072				"more than one stream.\n");
3073		xhci_free_command(xhci, config_cmd);
3074		spin_unlock_irqrestore(&xhci->lock, flags);
3075		return -EINVAL;
3076	}
3077	vdev = xhci->devs[udev->slot_id];
3078	/* Mark each endpoint as being in transition, so
3079	 * xhci_urb_enqueue() will reject all URBs.
3080	 */
3081	for (i = 0; i < num_eps; i++) {
3082		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3083		vdev->eps[ep_index].ep_state |= EP_GETTING_STREAMS;
3084	}
3085	spin_unlock_irqrestore(&xhci->lock, flags);
3086
3087	/* Setup internal data structures and allocate HW data structures for
3088	 * streams (but don't install the HW structures in the input context
3089	 * until we're sure all memory allocation succeeded).
3090	 */
3091	xhci_calculate_streams_entries(xhci, &num_streams, &num_stream_ctxs);
3092	xhci_dbg(xhci, "Need %u stream ctx entries for %u stream IDs.\n",
3093			num_stream_ctxs, num_streams);
3094
3095	for (i = 0; i < num_eps; i++) {
3096		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3097		vdev->eps[ep_index].stream_info = xhci_alloc_stream_info(xhci,
3098				num_stream_ctxs,
3099				num_streams, mem_flags);
3100		if (!vdev->eps[ep_index].stream_info)
3101			goto cleanup;
3102		/* Set maxPstreams in endpoint context and update deq ptr to
3103		 * point to stream context array. FIXME
3104		 */
3105	}
3106
3107	/* Set up the input context for a configure endpoint command. */
3108	for (i = 0; i < num_eps; i++) {
3109		struct xhci_ep_ctx *ep_ctx;
3110
3111		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3112		ep_ctx = xhci_get_ep_ctx(xhci, config_cmd->in_ctx, ep_index);
3113
3114		xhci_endpoint_copy(xhci, config_cmd->in_ctx,
3115				vdev->out_ctx, ep_index);
3116		xhci_setup_streams_ep_input_ctx(xhci, ep_ctx,
3117				vdev->eps[ep_index].stream_info);
3118	}
3119	/* Tell the HW to drop its old copy of the endpoint context info
3120	 * and add the updated copy from the input context.
3121	 */
3122	xhci_setup_input_ctx_for_config_ep(xhci, config_cmd->in_ctx,
3123			vdev->out_ctx, changed_ep_bitmask, changed_ep_bitmask);
 
3124
3125	/* Issue and wait for the configure endpoint command */
3126	ret = xhci_configure_endpoint(xhci, udev, config_cmd,
3127			false, false);
3128
3129	/* xHC rejected the configure endpoint command for some reason, so we
3130	 * leave the old ring intact and free our internal streams data
3131	 * structure.
3132	 */
3133	if (ret < 0)
3134		goto cleanup;
3135
3136	spin_lock_irqsave(&xhci->lock, flags);
3137	for (i = 0; i < num_eps; i++) {
3138		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3139		vdev->eps[ep_index].ep_state &= ~EP_GETTING_STREAMS;
3140		xhci_dbg(xhci, "Slot %u ep ctx %u now has streams.\n",
3141			 udev->slot_id, ep_index);
3142		vdev->eps[ep_index].ep_state |= EP_HAS_STREAMS;
3143	}
3144	xhci_free_command(xhci, config_cmd);
3145	spin_unlock_irqrestore(&xhci->lock, flags);
3146
3147	/* Subtract 1 for stream 0, which drivers can't use */
3148	return num_streams - 1;
3149
3150cleanup:
3151	/* If it didn't work, free the streams! */
3152	for (i = 0; i < num_eps; i++) {
3153		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3154		xhci_free_stream_info(xhci, vdev->eps[ep_index].stream_info);
3155		vdev->eps[ep_index].stream_info = NULL;
3156		/* FIXME Unset maxPstreams in endpoint context and
3157		 * update deq ptr to point to normal string ring.
3158		 */
3159		vdev->eps[ep_index].ep_state &= ~EP_GETTING_STREAMS;
3160		vdev->eps[ep_index].ep_state &= ~EP_HAS_STREAMS;
3161		xhci_endpoint_zero(xhci, vdev, eps[i]);
3162	}
3163	xhci_free_command(xhci, config_cmd);
3164	return -ENOMEM;
3165}
3166
3167/* Transition the endpoint from using streams to being a "normal" endpoint
3168 * without streams.
3169 *
3170 * Modify the endpoint context state, submit a configure endpoint command,
3171 * and free all endpoint rings for streams if that completes successfully.
3172 */
3173int xhci_free_streams(struct usb_hcd *hcd, struct usb_device *udev,
3174		struct usb_host_endpoint **eps, unsigned int num_eps,
3175		gfp_t mem_flags)
3176{
3177	int i, ret;
3178	struct xhci_hcd *xhci;
3179	struct xhci_virt_device *vdev;
3180	struct xhci_command *command;
 
3181	unsigned int ep_index;
3182	unsigned long flags;
3183	u32 changed_ep_bitmask;
3184
3185	xhci = hcd_to_xhci(hcd);
3186	vdev = xhci->devs[udev->slot_id];
3187
3188	/* Set up a configure endpoint command to remove the streams rings */
3189	spin_lock_irqsave(&xhci->lock, flags);
3190	changed_ep_bitmask = xhci_calculate_no_streams_bitmask(xhci,
3191			udev, eps, num_eps);
3192	if (changed_ep_bitmask == 0) {
3193		spin_unlock_irqrestore(&xhci->lock, flags);
3194		return -EINVAL;
3195	}
3196
3197	/* Use the xhci_command structure from the first endpoint.  We may have
3198	 * allocated too many, but the driver may call xhci_free_streams() for
3199	 * each endpoint it grouped into one call to xhci_alloc_streams().
3200	 */
3201	ep_index = xhci_get_endpoint_index(&eps[0]->desc);
3202	command = vdev->eps[ep_index].stream_info->free_streams_command;
 
 
 
 
 
 
 
 
3203	for (i = 0; i < num_eps; i++) {
3204		struct xhci_ep_ctx *ep_ctx;
3205
3206		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3207		ep_ctx = xhci_get_ep_ctx(xhci, command->in_ctx, ep_index);
3208		xhci->devs[udev->slot_id]->eps[ep_index].ep_state |=
3209			EP_GETTING_NO_STREAMS;
3210
3211		xhci_endpoint_copy(xhci, command->in_ctx,
3212				vdev->out_ctx, ep_index);
3213		xhci_setup_no_streams_ep_input_ctx(xhci, ep_ctx,
3214				&vdev->eps[ep_index]);
3215	}
3216	xhci_setup_input_ctx_for_config_ep(xhci, command->in_ctx,
3217			vdev->out_ctx, changed_ep_bitmask, changed_ep_bitmask);
 
3218	spin_unlock_irqrestore(&xhci->lock, flags);
3219
3220	/* Issue and wait for the configure endpoint command,
3221	 * which must succeed.
3222	 */
3223	ret = xhci_configure_endpoint(xhci, udev, command,
3224			false, true);
3225
3226	/* xHC rejected the configure endpoint command for some reason, so we
3227	 * leave the streams rings intact.
3228	 */
3229	if (ret < 0)
3230		return ret;
3231
3232	spin_lock_irqsave(&xhci->lock, flags);
3233	for (i = 0; i < num_eps; i++) {
3234		ep_index = xhci_get_endpoint_index(&eps[i]->desc);
3235		xhci_free_stream_info(xhci, vdev->eps[ep_index].stream_info);
3236		vdev->eps[ep_index].stream_info = NULL;
3237		/* FIXME Unset maxPstreams in endpoint context and
3238		 * update deq ptr to point to normal string ring.
3239		 */
3240		vdev->eps[ep_index].ep_state &= ~EP_GETTING_NO_STREAMS;
3241		vdev->eps[ep_index].ep_state &= ~EP_HAS_STREAMS;
3242	}
3243	spin_unlock_irqrestore(&xhci->lock, flags);
3244
3245	return 0;
3246}
3247
3248/*
3249 * Deletes endpoint resources for endpoints that were active before a Reset
3250 * Device command, or a Disable Slot command.  The Reset Device command leaves
3251 * the control endpoint intact, whereas the Disable Slot command deletes it.
3252 *
3253 * Must be called with xhci->lock held.
3254 */
3255void xhci_free_device_endpoint_resources(struct xhci_hcd *xhci,
3256	struct xhci_virt_device *virt_dev, bool drop_control_ep)
3257{
3258	int i;
3259	unsigned int num_dropped_eps = 0;
3260	unsigned int drop_flags = 0;
3261
3262	for (i = (drop_control_ep ? 0 : 1); i < 31; i++) {
3263		if (virt_dev->eps[i].ring) {
3264			drop_flags |= 1 << i;
3265			num_dropped_eps++;
3266		}
3267	}
3268	xhci->num_active_eps -= num_dropped_eps;
3269	if (num_dropped_eps)
3270		xhci_dbg(xhci, "Dropped %u ep ctxs, flags = 0x%x, "
3271				"%u now active.\n",
 
3272				num_dropped_eps, drop_flags,
3273				xhci->num_active_eps);
3274}
3275
3276/*
3277 * This submits a Reset Device Command, which will set the device state to 0,
3278 * set the device address to 0, and disable all the endpoints except the default
3279 * control endpoint.  The USB core should come back and call
3280 * xhci_address_device(), and then re-set up the configuration.  If this is
3281 * called because of a usb_reset_and_verify_device(), then the old alternate
3282 * settings will be re-installed through the normal bandwidth allocation
3283 * functions.
3284 *
3285 * Wait for the Reset Device command to finish.  Remove all structures
3286 * associated with the endpoints that were disabled.  Clear the input device
3287 * structure?  Cache the rings?  Reset the control endpoint 0 max packet size?
3288 *
3289 * If the virt_dev to be reset does not exist or does not match the udev,
3290 * it means the device is lost, possibly due to the xHC restore error and
3291 * re-initialization during S3/S4. In this case, call xhci_alloc_dev() to
3292 * re-allocate the device.
3293 */
3294int xhci_discover_or_reset_device(struct usb_hcd *hcd, struct usb_device *udev)
3295{
3296	int ret, i;
3297	unsigned long flags;
3298	struct xhci_hcd *xhci;
3299	unsigned int slot_id;
3300	struct xhci_virt_device *virt_dev;
3301	struct xhci_command *reset_device_cmd;
3302	int timeleft;
3303	int last_freed_endpoint;
3304	struct xhci_slot_ctx *slot_ctx;
3305	int old_active_eps = 0;
3306
3307	ret = xhci_check_args(hcd, udev, NULL, 0, false, __func__);
3308	if (ret <= 0)
3309		return ret;
3310	xhci = hcd_to_xhci(hcd);
3311	slot_id = udev->slot_id;
3312	virt_dev = xhci->devs[slot_id];
3313	if (!virt_dev) {
3314		xhci_dbg(xhci, "The device to be reset with slot ID %u does "
3315				"not exist. Re-allocate the device\n", slot_id);
3316		ret = xhci_alloc_dev(hcd, udev);
3317		if (ret == 1)
3318			return 0;
3319		else
3320			return -EINVAL;
3321	}
3322
 
 
 
3323	if (virt_dev->udev != udev) {
3324		/* If the virt_dev and the udev does not match, this virt_dev
3325		 * may belong to another udev.
3326		 * Re-allocate the device.
3327		 */
3328		xhci_dbg(xhci, "The device to be reset with slot ID %u does "
3329				"not match the udev. Re-allocate the device\n",
3330				slot_id);
3331		ret = xhci_alloc_dev(hcd, udev);
3332		if (ret == 1)
3333			return 0;
3334		else
3335			return -EINVAL;
3336	}
3337
3338	/* If device is not setup, there is no point in resetting it */
3339	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->out_ctx);
3340	if (GET_SLOT_STATE(le32_to_cpu(slot_ctx->dev_state)) ==
3341						SLOT_STATE_DISABLED)
3342		return 0;
3343
3344	xhci_dbg(xhci, "Resetting device with slot ID %u\n", slot_id);
3345	/* Allocate the command structure that holds the struct completion.
3346	 * Assume we're in process context, since the normal device reset
3347	 * process has to wait for the device anyway.  Storage devices are
3348	 * reset as part of error handling, so use GFP_NOIO instead of
3349	 * GFP_KERNEL.
3350	 */
3351	reset_device_cmd = xhci_alloc_command(xhci, false, true, GFP_NOIO);
3352	if (!reset_device_cmd) {
3353		xhci_dbg(xhci, "Couldn't allocate command structure.\n");
3354		return -ENOMEM;
3355	}
3356
3357	/* Attempt to submit the Reset Device command to the command ring */
3358	spin_lock_irqsave(&xhci->lock, flags);
3359	reset_device_cmd->command_trb = xhci->cmd_ring->enqueue;
3360
3361	/* Enqueue pointer can be left pointing to the link TRB,
3362	 * we must handle that
3363	 */
3364	if (TRB_TYPE_LINK_LE32(reset_device_cmd->command_trb->link.control))
3365		reset_device_cmd->command_trb =
3366			xhci->cmd_ring->enq_seg->next->trbs;
3367
3368	list_add_tail(&reset_device_cmd->cmd_list, &virt_dev->cmd_list);
3369	ret = xhci_queue_reset_device(xhci, slot_id);
3370	if (ret) {
3371		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
3372		list_del(&reset_device_cmd->cmd_list);
3373		spin_unlock_irqrestore(&xhci->lock, flags);
3374		goto command_cleanup;
3375	}
3376	xhci_ring_cmd_db(xhci);
3377	spin_unlock_irqrestore(&xhci->lock, flags);
3378
3379	/* Wait for the Reset Device command to finish */
3380	timeleft = wait_for_completion_interruptible_timeout(
3381			reset_device_cmd->completion,
3382			USB_CTRL_SET_TIMEOUT);
3383	if (timeleft <= 0) {
3384		xhci_warn(xhci, "%s while waiting for reset device command\n",
3385				timeleft == 0 ? "Timeout" : "Signal");
3386		spin_lock_irqsave(&xhci->lock, flags);
3387		/* The timeout might have raced with the event ring handler, so
3388		 * only delete from the list if the item isn't poisoned.
3389		 */
3390		if (reset_device_cmd->cmd_list.next != LIST_POISON1)
3391			list_del(&reset_device_cmd->cmd_list);
3392		spin_unlock_irqrestore(&xhci->lock, flags);
3393		ret = -ETIME;
3394		goto command_cleanup;
3395	}
3396
3397	/* The Reset Device command can't fail, according to the 0.95/0.96 spec,
3398	 * unless we tried to reset a slot ID that wasn't enabled,
3399	 * or the device wasn't in the addressed or configured state.
3400	 */
3401	ret = reset_device_cmd->status;
3402	switch (ret) {
 
 
 
 
 
3403	case COMP_EBADSLT: /* 0.95 completion code for bad slot ID */
3404	case COMP_CTX_STATE: /* 0.96 completion code for same thing */
3405		xhci_info(xhci, "Can't reset device (slot ID %u) in %s state\n",
3406				slot_id,
3407				xhci_get_slot_state(xhci, virt_dev->out_ctx));
3408		xhci_info(xhci, "Not freeing device rings.\n");
3409		/* Don't treat this as an error.  May change my mind later. */
3410		ret = 0;
3411		goto command_cleanup;
3412	case COMP_SUCCESS:
3413		xhci_dbg(xhci, "Successful reset device command.\n");
3414		break;
3415	default:
3416		if (xhci_is_vendor_info_code(xhci, ret))
3417			break;
3418		xhci_warn(xhci, "Unknown completion code %u for "
3419				"reset device command.\n", ret);
3420		ret = -EINVAL;
3421		goto command_cleanup;
3422	}
3423
3424	/* Free up host controller endpoint resources */
3425	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
3426		spin_lock_irqsave(&xhci->lock, flags);
3427		/* Don't delete the default control endpoint resources */
3428		xhci_free_device_endpoint_resources(xhci, virt_dev, false);
3429		spin_unlock_irqrestore(&xhci->lock, flags);
3430	}
3431
3432	/* Everything but endpoint 0 is disabled, so free or cache the rings. */
3433	last_freed_endpoint = 1;
3434	for (i = 1; i < 31; ++i) {
3435		struct xhci_virt_ep *ep = &virt_dev->eps[i];
3436
3437		if (ep->ep_state & EP_HAS_STREAMS) {
 
 
3438			xhci_free_stream_info(xhci, ep->stream_info);
3439			ep->stream_info = NULL;
3440			ep->ep_state &= ~EP_HAS_STREAMS;
3441		}
3442
3443		if (ep->ring) {
3444			xhci_free_or_cache_endpoint_ring(xhci, virt_dev, i);
3445			last_freed_endpoint = i;
3446		}
3447		if (!list_empty(&virt_dev->eps[i].bw_endpoint_list))
3448			xhci_drop_ep_from_interval_table(xhci,
3449					&virt_dev->eps[i].bw_info,
3450					virt_dev->bw_table,
3451					udev,
3452					&virt_dev->eps[i],
3453					virt_dev->tt_info);
3454		xhci_clear_endpoint_bw_info(&virt_dev->eps[i].bw_info);
3455	}
3456	/* If necessary, update the number of active TTs on this root port */
3457	xhci_update_tt_active_eps(xhci, virt_dev, old_active_eps);
3458
3459	xhci_dbg(xhci, "Output context after successful reset device cmd:\n");
3460	xhci_dbg_ctx(xhci, virt_dev->out_ctx, last_freed_endpoint);
3461	ret = 0;
3462
3463command_cleanup:
3464	xhci_free_command(xhci, reset_device_cmd);
3465	return ret;
3466}
3467
3468/*
3469 * At this point, the struct usb_device is about to go away, the device has
3470 * disconnected, and all traffic has been stopped and the endpoints have been
3471 * disabled.  Free any HC data structures associated with that device.
3472 */
3473void xhci_free_dev(struct usb_hcd *hcd, struct usb_device *udev)
3474{
3475	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3476	struct xhci_virt_device *virt_dev;
3477	unsigned long flags;
3478	u32 state;
3479	int i, ret;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3480
3481	ret = xhci_check_args(hcd, udev, NULL, 0, true, __func__);
3482	/* If the host is halted due to driver unload, we still need to free the
3483	 * device.
3484	 */
3485	if (ret <= 0 && ret != -ENODEV)
 
3486		return;
 
3487
3488	virt_dev = xhci->devs[udev->slot_id];
3489
3490	/* Stop any wayward timer functions (which may grab the lock) */
3491	for (i = 0; i < 31; ++i) {
3492		virt_dev->eps[i].ep_state &= ~EP_HALT_PENDING;
3493		del_timer_sync(&virt_dev->eps[i].stop_cmd_timer);
3494	}
3495
3496	if (udev->usb2_hw_lpm_enabled) {
3497		xhci_set_usb2_hardware_lpm(hcd, udev, 0);
3498		udev->usb2_hw_lpm_enabled = 0;
3499	}
3500
3501	spin_lock_irqsave(&xhci->lock, flags);
3502	/* Don't disable the slot if the host controller is dead. */
3503	state = xhci_readl(xhci, &xhci->op_regs->status);
3504	if (state == 0xffffffff || (xhci->xhc_state & XHCI_STATE_DYING) ||
3505			(xhci->xhc_state & XHCI_STATE_HALTED)) {
3506		xhci_free_virt_device(xhci, udev->slot_id);
3507		spin_unlock_irqrestore(&xhci->lock, flags);
 
3508		return;
3509	}
3510
3511	if (xhci_queue_slot_control(xhci, TRB_DISABLE_SLOT, udev->slot_id)) {
 
3512		spin_unlock_irqrestore(&xhci->lock, flags);
3513		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
3514		return;
3515	}
3516	xhci_ring_cmd_db(xhci);
3517	spin_unlock_irqrestore(&xhci->lock, flags);
 
3518	/*
3519	 * Event command completion handler will free any data structures
3520	 * associated with the slot.  XXX Can free sleep?
3521	 */
3522}
3523
3524/*
3525 * Checks if we have enough host controller resources for the default control
3526 * endpoint.
3527 *
3528 * Must be called with xhci->lock held.
3529 */
3530static int xhci_reserve_host_control_ep_resources(struct xhci_hcd *xhci)
3531{
3532	if (xhci->num_active_eps + 1 > xhci->limit_active_eps) {
3533		xhci_dbg(xhci, "Not enough ep ctxs: "
3534				"%u active, need to add 1, limit is %u.\n",
 
3535				xhci->num_active_eps, xhci->limit_active_eps);
3536		return -ENOMEM;
3537	}
3538	xhci->num_active_eps += 1;
3539	xhci_dbg(xhci, "Adding 1 ep ctx, %u now active.\n",
 
3540			xhci->num_active_eps);
3541	return 0;
3542}
3543
3544
3545/*
3546 * Returns 0 if the xHC ran out of device slots, the Enable Slot command
3547 * timed out, or allocating memory failed.  Returns 1 on success.
3548 */
3549int xhci_alloc_dev(struct usb_hcd *hcd, struct usb_device *udev)
3550{
3551	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3552	unsigned long flags;
3553	int timeleft;
3554	int ret;
3555	union xhci_trb *cmd_trb;
 
 
 
3556
 
 
3557	spin_lock_irqsave(&xhci->lock, flags);
3558	cmd_trb = xhci->cmd_ring->dequeue;
3559	ret = xhci_queue_slot_control(xhci, TRB_ENABLE_SLOT, 0);
3560	if (ret) {
3561		spin_unlock_irqrestore(&xhci->lock, flags);
 
3562		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
 
3563		return 0;
3564	}
3565	xhci_ring_cmd_db(xhci);
3566	spin_unlock_irqrestore(&xhci->lock, flags);
3567
3568	/* XXX: how much time for xHC slot assignment? */
3569	timeleft = wait_for_completion_interruptible_timeout(&xhci->addr_dev,
3570			XHCI_CMD_DEFAULT_TIMEOUT);
3571	if (timeleft <= 0) {
3572		xhci_warn(xhci, "%s while waiting for a slot\n",
3573				timeleft == 0 ? "Timeout" : "Signal");
3574		/* cancel the enable slot request */
3575		return xhci_cancel_cmd(xhci, NULL, cmd_trb);
3576	}
3577
3578	if (!xhci->slot_id) {
3579		xhci_err(xhci, "Error while assigning device slot ID\n");
 
 
 
 
3580		return 0;
3581	}
3582
3583	if ((xhci->quirks & XHCI_EP_LIMIT_QUIRK)) {
3584		spin_lock_irqsave(&xhci->lock, flags);
3585		ret = xhci_reserve_host_control_ep_resources(xhci);
3586		if (ret) {
3587			spin_unlock_irqrestore(&xhci->lock, flags);
3588			xhci_warn(xhci, "Not enough host resources, "
3589					"active endpoint contexts = %u\n",
3590					xhci->num_active_eps);
3591			goto disable_slot;
3592		}
3593		spin_unlock_irqrestore(&xhci->lock, flags);
3594	}
3595	/* Use GFP_NOIO, since this function can be called from
3596	 * xhci_discover_or_reset_device(), which may be called as part of
3597	 * mass storage driver error handling.
3598	 */
3599	if (!xhci_alloc_virt_device(xhci, xhci->slot_id, udev, GFP_NOIO)) {
3600		xhci_warn(xhci, "Could not allocate xHCI USB device data structures\n");
3601		goto disable_slot;
3602	}
3603	udev->slot_id = xhci->slot_id;
 
 
 
 
 
 
 
 
 
 
 
 
3604	/* Is this a LS or FS device under a HS hub? */
3605	/* Hub or peripherial? */
3606	return 1;
3607
3608disable_slot:
3609	/* Disable slot, if we can do it without mem alloc */
3610	spin_lock_irqsave(&xhci->lock, flags);
3611	if (!xhci_queue_slot_control(xhci, TRB_DISABLE_SLOT, udev->slot_id))
 
 
 
3612		xhci_ring_cmd_db(xhci);
3613	spin_unlock_irqrestore(&xhci->lock, flags);
3614	return 0;
3615}
3616
3617/*
3618 * Issue an Address Device command (which will issue a SetAddress request to
3619 * the device).
3620 * We should be protected by the usb_address0_mutex in khubd's hub_port_init, so
3621 * we should only issue and wait on one address command at the same time.
3622 *
3623 * We add one to the device address issued by the hardware because the USB core
3624 * uses address 1 for the root hubs (even though they're not really devices).
3625 */
3626int xhci_address_device(struct usb_hcd *hcd, struct usb_device *udev)
 
3627{
 
3628	unsigned long flags;
3629	int timeleft;
3630	struct xhci_virt_device *virt_dev;
3631	int ret = 0;
3632	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
3633	struct xhci_slot_ctx *slot_ctx;
3634	struct xhci_input_control_ctx *ctrl_ctx;
3635	u64 temp_64;
3636	union xhci_trb *cmd_trb;
 
 
 
 
 
3637
3638	if (!udev->slot_id) {
3639		xhci_dbg(xhci, "Bad Slot ID %d\n", udev->slot_id);
3640		return -EINVAL;
 
 
3641	}
3642
3643	virt_dev = xhci->devs[udev->slot_id];
3644
3645	if (WARN_ON(!virt_dev)) {
3646		/*
3647		 * In plug/unplug torture test with an NEC controller,
3648		 * a zero-dereference was observed once due to virt_dev = 0.
3649		 * Print useful debug rather than crash if it is observed again!
3650		 */
3651		xhci_warn(xhci, "Virt dev invalid for slot_id 0x%x!\n",
3652			udev->slot_id);
3653		return -EINVAL;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3654	}
3655
 
 
 
3656	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->in_ctx);
 
 
 
 
 
 
 
3657	/*
3658	 * If this is the first Set Address since device plug-in or
3659	 * virt_device realloaction after a resume with an xHCI power loss,
3660	 * then set up the slot context.
3661	 */
3662	if (!slot_ctx->dev_info)
3663		xhci_setup_addressable_virt_dev(xhci, udev);
3664	/* Otherwise, update the control endpoint ring enqueue pointer. */
3665	else
3666		xhci_copy_ep0_dequeue_into_input_ctx(xhci, udev);
3667	ctrl_ctx = xhci_get_input_control_ctx(xhci, virt_dev->in_ctx);
3668	ctrl_ctx->add_flags = cpu_to_le32(SLOT_FLAG | EP0_FLAG);
3669	ctrl_ctx->drop_flags = 0;
3670
3671	xhci_dbg(xhci, "Slot ID %d Input Context:\n", udev->slot_id);
3672	xhci_dbg_ctx(xhci, virt_dev->in_ctx, 2);
 
 
3673
3674	spin_lock_irqsave(&xhci->lock, flags);
3675	cmd_trb = xhci->cmd_ring->dequeue;
3676	ret = xhci_queue_address_device(xhci, virt_dev->in_ctx->dma,
3677					udev->slot_id);
3678	if (ret) {
3679		spin_unlock_irqrestore(&xhci->lock, flags);
3680		xhci_dbg(xhci, "FIXME: allocate a command ring segment\n");
3681		return ret;
 
3682	}
3683	xhci_ring_cmd_db(xhci);
3684	spin_unlock_irqrestore(&xhci->lock, flags);
3685
3686	/* ctrl tx can take up to 5 sec; XXX: need more time for xHC? */
3687	timeleft = wait_for_completion_interruptible_timeout(&xhci->addr_dev,
3688			XHCI_CMD_DEFAULT_TIMEOUT);
3689	/* FIXME: From section 4.3.4: "Software shall be responsible for timing
3690	 * the SetAddress() "recovery interval" required by USB and aborting the
3691	 * command on a timeout.
3692	 */
3693	if (timeleft <= 0) {
3694		xhci_warn(xhci, "%s while waiting for address device command\n",
3695				timeleft == 0 ? "Timeout" : "Signal");
3696		/* cancel the address device command */
3697		ret = xhci_cancel_cmd(xhci, NULL, cmd_trb);
3698		if (ret < 0)
3699			return ret;
3700		return -ETIME;
3701	}
3702
3703	switch (virt_dev->cmd_status) {
3704	case COMP_CTX_STATE:
3705	case COMP_EBADSLT:
3706		xhci_err(xhci, "Setup ERROR: address device command for slot %d.\n",
3707				udev->slot_id);
3708		ret = -EINVAL;
3709		break;
3710	case COMP_TX_ERR:
3711		dev_warn(&udev->dev, "Device not responding to set address.\n");
3712		ret = -EPROTO;
3713		break;
3714	case COMP_DEV_ERR:
3715		dev_warn(&udev->dev, "ERROR: Incompatible device for address "
3716				"device command.\n");
3717		ret = -ENODEV;
3718		break;
3719	case COMP_SUCCESS:
3720		xhci_dbg(xhci, "Successful Address Device command\n");
 
3721		break;
3722	default:
3723		xhci_err(xhci, "ERROR: unexpected command completion "
3724				"code 0x%x.\n", virt_dev->cmd_status);
 
3725		xhci_dbg(xhci, "Slot ID %d Output Context:\n", udev->slot_id);
3726		xhci_dbg_ctx(xhci, virt_dev->out_ctx, 2);
 
3727		ret = -EINVAL;
3728		break;
3729	}
3730	if (ret) {
3731		return ret;
3732	}
3733	temp_64 = xhci_read_64(xhci, &xhci->op_regs->dcbaa_ptr);
3734	xhci_dbg(xhci, "Op regs DCBAA ptr = %#016llx\n", temp_64);
3735	xhci_dbg(xhci, "Slot ID %d dcbaa entry @%p = %#016llx\n",
3736		 udev->slot_id,
3737		 &xhci->dcbaa->dev_context_ptrs[udev->slot_id],
3738		 (unsigned long long)
3739		 le64_to_cpu(xhci->dcbaa->dev_context_ptrs[udev->slot_id]));
3740	xhci_dbg(xhci, "Output Context DMA address = %#08llx\n",
 
 
 
3741			(unsigned long long)virt_dev->out_ctx->dma);
3742	xhci_dbg(xhci, "Slot ID %d Input Context:\n", udev->slot_id);
3743	xhci_dbg_ctx(xhci, virt_dev->in_ctx, 2);
 
 
3744	xhci_dbg(xhci, "Slot ID %d Output Context:\n", udev->slot_id);
3745	xhci_dbg_ctx(xhci, virt_dev->out_ctx, 2);
3746	/*
3747	 * USB core uses address 1 for the roothubs, so we add one to the
3748	 * address given back to us by the HC.
3749	 */
3750	slot_ctx = xhci_get_slot_ctx(xhci, virt_dev->out_ctx);
3751	/* Use kernel assigned address for devices; store xHC assigned
3752	 * address locally. */
3753	virt_dev->address = (le32_to_cpu(slot_ctx->dev_state) & DEV_ADDR_MASK)
3754		+ 1;
3755	/* Zero the input context control for later use */
3756	ctrl_ctx->add_flags = 0;
3757	ctrl_ctx->drop_flags = 0;
3758
3759	xhci_dbg(xhci, "Internal device address = %d\n", virt_dev->address);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3760
3761	return 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3762}
3763
3764#ifdef CONFIG_USB_SUSPEND
3765
3766/* BESL to HIRD Encoding array for USB2 LPM */
3767static int xhci_besl_encoding[16] = {125, 150, 200, 300, 400, 500, 1000, 2000,
3768	3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000};
3769
3770/* Calculate HIRD/BESL for USB2 PORTPMSC*/
3771static int xhci_calculate_hird_besl(struct xhci_hcd *xhci,
3772					struct usb_device *udev)
3773{
3774	int u2del, besl, besl_host;
3775	int besl_device = 0;
3776	u32 field;
3777
3778	u2del = HCS_U2_LATENCY(xhci->hcs_params3);
3779	field = le32_to_cpu(udev->bos->ext_cap->bmAttributes);
3780
3781	if (field & USB_BESL_SUPPORT) {
3782		for (besl_host = 0; besl_host < 16; besl_host++) {
3783			if (xhci_besl_encoding[besl_host] >= u2del)
3784				break;
3785		}
3786		/* Use baseline BESL value as default */
3787		if (field & USB_BESL_BASELINE_VALID)
3788			besl_device = USB_GET_BESL_BASELINE(field);
3789		else if (field & USB_BESL_DEEP_VALID)
3790			besl_device = USB_GET_BESL_DEEP(field);
3791	} else {
3792		if (u2del <= 50)
3793			besl_host = 0;
3794		else
3795			besl_host = (u2del - 51) / 75 + 1;
3796	}
3797
3798	besl = besl_host + besl_device;
3799	if (besl > 15)
3800		besl = 15;
3801
3802	return besl;
3803}
3804
3805static int xhci_usb2_software_lpm_test(struct usb_hcd *hcd,
3806					struct usb_device *udev)
3807{
3808	struct xhci_hcd	*xhci = hcd_to_xhci(hcd);
3809	struct dev_info	*dev_info;
3810	__le32 __iomem	**port_array;
3811	__le32 __iomem	*addr, *pm_addr;
3812	u32		temp, dev_id;
3813	unsigned int	port_num;
3814	unsigned long	flags;
3815	int		hird;
3816	int		ret;
3817
3818	if (hcd->speed == HCD_USB3 || !xhci->sw_lpm_support ||
3819			!udev->lpm_capable)
3820		return -EINVAL;
3821
3822	/* we only support lpm for non-hub device connected to root hub yet */
3823	if (!udev->parent || udev->parent->parent ||
3824			udev->descriptor.bDeviceClass == USB_CLASS_HUB)
3825		return -EINVAL;
3826
3827	spin_lock_irqsave(&xhci->lock, flags);
3828
3829	/* Look for devices in lpm_failed_devs list */
3830	dev_id = le16_to_cpu(udev->descriptor.idVendor) << 16 |
3831			le16_to_cpu(udev->descriptor.idProduct);
3832	list_for_each_entry(dev_info, &xhci->lpm_failed_devs, list) {
3833		if (dev_info->dev_id == dev_id) {
3834			ret = -EINVAL;
3835			goto finish;
3836		}
3837	}
3838
3839	port_array = xhci->usb2_ports;
3840	port_num = udev->portnum - 1;
3841
3842	if (port_num > HCS_MAX_PORTS(xhci->hcs_params1)) {
3843		xhci_dbg(xhci, "invalid port number %d\n", udev->portnum);
3844		ret = -EINVAL;
3845		goto finish;
3846	}
3847
3848	/*
3849	 * Test USB 2.0 software LPM.
3850	 * FIXME: some xHCI 1.0 hosts may implement a new register to set up
3851	 * hardware-controlled USB 2.0 LPM. See section 5.4.11 and 4.23.5.1.1.1
3852	 * in the June 2011 errata release.
3853	 */
3854	xhci_dbg(xhci, "test port %d software LPM\n", port_num);
3855	/*
3856	 * Set L1 Device Slot and HIRD/BESL.
3857	 * Check device's USB 2.0 extension descriptor to determine whether
3858	 * HIRD or BESL shoule be used. See USB2.0 LPM errata.
3859	 */
3860	pm_addr = port_array[port_num] + 1;
3861	hird = xhci_calculate_hird_besl(xhci, udev);
3862	temp = PORT_L1DS(udev->slot_id) | PORT_HIRD(hird);
3863	xhci_writel(xhci, temp, pm_addr);
3864
3865	/* Set port link state to U2(L1) */
3866	addr = port_array[port_num];
3867	xhci_set_link_state(xhci, port_array, port_num, XDEV_U2);
3868
3869	/* wait for ACK */
3870	spin_unlock_irqrestore(&xhci->lock, flags);
3871	msleep(10);
3872	spin_lock_irqsave(&xhci->lock, flags);
3873
3874	/* Check L1 Status */
3875	ret = handshake(xhci, pm_addr, PORT_L1S_MASK, PORT_L1S_SUCCESS, 125);
3876	if (ret != -ETIMEDOUT) {
3877		/* enter L1 successfully */
3878		temp = xhci_readl(xhci, addr);
3879		xhci_dbg(xhci, "port %d entered L1 state, port status 0x%x\n",
3880				port_num, temp);
3881		ret = 0;
3882	} else {
3883		temp = xhci_readl(xhci, pm_addr);
3884		xhci_dbg(xhci, "port %d software lpm failed, L1 status %d\n",
3885				port_num, temp & PORT_L1S_MASK);
3886		ret = -EINVAL;
3887	}
3888
3889	/* Resume the port */
3890	xhci_set_link_state(xhci, port_array, port_num, XDEV_U0);
3891
3892	spin_unlock_irqrestore(&xhci->lock, flags);
3893	msleep(10);
3894	spin_lock_irqsave(&xhci->lock, flags);
3895
3896	/* Clear PLC */
3897	xhci_test_and_clear_bit(xhci, port_array, port_num, PORT_PLC);
3898
3899	/* Check PORTSC to make sure the device is in the right state */
3900	if (!ret) {
3901		temp = xhci_readl(xhci, addr);
3902		xhci_dbg(xhci, "resumed port %d status 0x%x\n",	port_num, temp);
3903		if (!(temp & PORT_CONNECT) || !(temp & PORT_PE) ||
3904				(temp & PORT_PLS_MASK) != XDEV_U0) {
3905			xhci_dbg(xhci, "port L1 resume fail\n");
3906			ret = -EINVAL;
3907		}
3908	}
3909
3910	if (ret) {
3911		/* Insert dev to lpm_failed_devs list */
3912		xhci_warn(xhci, "device LPM test failed, may disconnect and "
3913				"re-enumerate\n");
3914		dev_info = kzalloc(sizeof(struct dev_info), GFP_ATOMIC);
3915		if (!dev_info) {
3916			ret = -ENOMEM;
3917			goto finish;
3918		}
3919		dev_info->dev_id = dev_id;
3920		INIT_LIST_HEAD(&dev_info->list);
3921		list_add(&dev_info->list, &xhci->lpm_failed_devs);
3922	} else {
3923		xhci_ring_device(xhci, udev->slot_id);
3924	}
3925
3926finish:
3927	spin_unlock_irqrestore(&xhci->lock, flags);
3928	return ret;
3929}
3930
3931int xhci_set_usb2_hardware_lpm(struct usb_hcd *hcd,
3932			struct usb_device *udev, int enable)
3933{
3934	struct xhci_hcd	*xhci = hcd_to_xhci(hcd);
3935	__le32 __iomem	**port_array;
3936	__le32 __iomem	*pm_addr;
3937	u32		temp;
3938	unsigned int	port_num;
3939	unsigned long	flags;
3940	int		hird;
 
3941
3942	if (hcd->speed == HCD_USB3 || !xhci->hw_lpm_support ||
3943			!udev->lpm_capable)
3944		return -EPERM;
3945
3946	if (!udev->parent || udev->parent->parent ||
3947			udev->descriptor.bDeviceClass == USB_CLASS_HUB)
3948		return -EPERM;
3949
3950	if (udev->usb2_hw_lpm_capable != 1)
3951		return -EPERM;
3952
3953	spin_lock_irqsave(&xhci->lock, flags);
3954
3955	port_array = xhci->usb2_ports;
3956	port_num = udev->portnum - 1;
3957	pm_addr = port_array[port_num] + 1;
3958	temp = xhci_readl(xhci, pm_addr);
 
 
3959
3960	xhci_dbg(xhci, "%s port %d USB2 hardware LPM\n",
3961			enable ? "enable" : "disable", port_num);
3962
3963	hird = xhci_calculate_hird_besl(xhci, udev);
 
 
 
 
 
 
 
 
 
 
 
3964
3965	if (enable) {
3966		temp &= ~PORT_HIRD_MASK;
3967		temp |= PORT_HIRD(hird) | PORT_RWE;
3968		xhci_writel(xhci, temp, pm_addr);
3969		temp = xhci_readl(xhci, pm_addr);
3970		temp |= PORT_HLE;
3971		xhci_writel(xhci, temp, pm_addr);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3972	} else {
3973		temp &= ~(PORT_HLE | PORT_RWE | PORT_HIRD_MASK);
3974		xhci_writel(xhci, temp, pm_addr);
 
 
 
 
 
 
 
 
 
3975	}
3976
3977	spin_unlock_irqrestore(&xhci->lock, flags);
3978	return 0;
3979}
3980
3981int xhci_update_device(struct usb_hcd *hcd, struct usb_device *udev)
 
 
 
 
 
3982{
3983	struct xhci_hcd	*xhci = hcd_to_xhci(hcd);
3984	int		ret;
3985
3986	ret = xhci_usb2_software_lpm_test(hcd, udev);
3987	if (!ret) {
3988		xhci_dbg(xhci, "software LPM test succeed\n");
3989		if (xhci->hw_lpm_support == 1) {
3990			udev->usb2_hw_lpm_capable = 1;
3991			ret = xhci_set_usb2_hardware_lpm(hcd, udev, 1);
3992			if (!ret)
3993				udev->usb2_hw_lpm_enabled = 1;
3994		}
3995	}
3996
3997	return 0;
3998}
3999
4000#else
 
 
 
 
 
 
 
 
 
 
 
 
4001
4002int xhci_set_usb2_hardware_lpm(struct usb_hcd *hcd,
4003				struct usb_device *udev, int enable)
4004{
4005	return 0;
4006}
 
 
 
 
 
4007
4008int xhci_update_device(struct usb_hcd *hcd, struct usb_device *udev)
4009{
4010	return 0;
4011}
4012
4013#endif /* CONFIG_USB_SUSPEND */
4014
4015/*---------------------- USB 3.0 Link PM functions ------------------------*/
4016
4017#ifdef CONFIG_PM
4018/* Service interval in nanoseconds = 2^(bInterval - 1) * 125us * 1000ns / 1us */
4019static unsigned long long xhci_service_interval_to_ns(
4020		struct usb_endpoint_descriptor *desc)
4021{
4022	return (1 << (desc->bInterval - 1)) * 125 * 1000;
4023}
4024
4025static u16 xhci_get_timeout_no_hub_lpm(struct usb_device *udev,
4026		enum usb3_link_state state)
4027{
4028	unsigned long long sel;
4029	unsigned long long pel;
4030	unsigned int max_sel_pel;
4031	char *state_name;
4032
4033	switch (state) {
4034	case USB3_LPM_U1:
4035		/* Convert SEL and PEL stored in nanoseconds to microseconds */
4036		sel = DIV_ROUND_UP(udev->u1_params.sel, 1000);
4037		pel = DIV_ROUND_UP(udev->u1_params.pel, 1000);
4038		max_sel_pel = USB3_LPM_MAX_U1_SEL_PEL;
4039		state_name = "U1";
4040		break;
4041	case USB3_LPM_U2:
4042		sel = DIV_ROUND_UP(udev->u2_params.sel, 1000);
4043		pel = DIV_ROUND_UP(udev->u2_params.pel, 1000);
4044		max_sel_pel = USB3_LPM_MAX_U2_SEL_PEL;
4045		state_name = "U2";
4046		break;
4047	default:
4048		dev_warn(&udev->dev, "%s: Can't get timeout for non-U1 or U2 state.\n",
4049				__func__);
4050		return USB3_LPM_DISABLED;
4051	}
4052
4053	if (sel <= max_sel_pel && pel <= max_sel_pel)
4054		return USB3_LPM_DEVICE_INITIATED;
4055
4056	if (sel > max_sel_pel)
4057		dev_dbg(&udev->dev, "Device-initiated %s disabled "
4058				"due to long SEL %llu ms\n",
4059				state_name, sel);
4060	else
4061		dev_dbg(&udev->dev, "Device-initiated %s disabled "
4062				"due to long PEL %llu\n ms",
4063				state_name, pel);
4064	return USB3_LPM_DISABLED;
4065}
4066
4067/* Returns the hub-encoded U1 timeout value.
4068 * The U1 timeout should be the maximum of the following values:
4069 *  - For control endpoints, U1 system exit latency (SEL) * 3
4070 *  - For bulk endpoints, U1 SEL * 5
4071 *  - For interrupt endpoints:
4072 *    - Notification EPs, U1 SEL * 3
4073 *    - Periodic EPs, max(105% of bInterval, U1 SEL * 2)
4074 *  - For isochronous endpoints, max(105% of bInterval, U1 SEL * 2)
4075 */
4076static u16 xhci_calculate_intel_u1_timeout(struct usb_device *udev,
 
4077		struct usb_endpoint_descriptor *desc)
4078{
4079	unsigned long long timeout_ns;
4080	int ep_type;
4081	int intr_type;
4082
4083	ep_type = usb_endpoint_type(desc);
4084	switch (ep_type) {
4085	case USB_ENDPOINT_XFER_CONTROL:
4086		timeout_ns = udev->u1_params.sel * 3;
4087		break;
4088	case USB_ENDPOINT_XFER_BULK:
4089		timeout_ns = udev->u1_params.sel * 5;
4090		break;
4091	case USB_ENDPOINT_XFER_INT:
4092		intr_type = usb_endpoint_interrupt_type(desc);
4093		if (intr_type == USB_ENDPOINT_INTR_NOTIFICATION) {
4094			timeout_ns = udev->u1_params.sel * 3;
4095			break;
4096		}
4097		/* Otherwise the calculation is the same as isoc eps */
4098	case USB_ENDPOINT_XFER_ISOC:
4099		timeout_ns = xhci_service_interval_to_ns(desc);
4100		timeout_ns = DIV_ROUND_UP_ULL(timeout_ns * 105, 100);
4101		if (timeout_ns < udev->u1_params.sel * 2)
4102			timeout_ns = udev->u1_params.sel * 2;
4103		break;
4104	default:
4105		return 0;
4106	}
4107
4108	/* The U1 timeout is encoded in 1us intervals. */
4109	timeout_ns = DIV_ROUND_UP_ULL(timeout_ns, 1000);
4110	/* Don't return a timeout of zero, because that's USB3_LPM_DISABLED. */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4111	if (timeout_ns == USB3_LPM_DISABLED)
4112		timeout_ns++;
 
 
4113
4114	/* If the necessary timeout value is bigger than what we can set in the
4115	 * USB 3.0 hub, we have to disable hub-initiated U1.
4116	 */
4117	if (timeout_ns <= USB3_LPM_U1_MAX_TIMEOUT)
4118		return timeout_ns;
4119	dev_dbg(&udev->dev, "Hub-initiated U1 disabled "
4120			"due to long timeout %llu ms\n", timeout_ns);
4121	return xhci_get_timeout_no_hub_lpm(udev, USB3_LPM_U1);
4122}
4123
4124/* Returns the hub-encoded U2 timeout value.
4125 * The U2 timeout should be the maximum of:
4126 *  - 10 ms (to avoid the bandwidth impact on the scheduler)
4127 *  - largest bInterval of any active periodic endpoint (to avoid going
4128 *    into lower power link states between intervals).
4129 *  - the U2 Exit Latency of the device
4130 */
4131static u16 xhci_calculate_intel_u2_timeout(struct usb_device *udev,
 
4132		struct usb_endpoint_descriptor *desc)
4133{
4134	unsigned long long timeout_ns;
4135	unsigned long long u2_del_ns;
4136
4137	timeout_ns = 10 * 1000 * 1000;
4138
4139	if ((usb_endpoint_xfer_int(desc) || usb_endpoint_xfer_isoc(desc)) &&
4140			(xhci_service_interval_to_ns(desc) > timeout_ns))
4141		timeout_ns = xhci_service_interval_to_ns(desc);
4142
4143	u2_del_ns = udev->bos->ss_cap->bU2DevExitLat * 1000;
4144	if (u2_del_ns > timeout_ns)
4145		timeout_ns = u2_del_ns;
4146
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4147	/* The U2 timeout is encoded in 256us intervals */
4148	timeout_ns = DIV_ROUND_UP_ULL(timeout_ns, 256 * 1000);
4149	/* If the necessary timeout value is bigger than what we can set in the
4150	 * USB 3.0 hub, we have to disable hub-initiated U2.
4151	 */
4152	if (timeout_ns <= USB3_LPM_U2_MAX_TIMEOUT)
4153		return timeout_ns;
4154	dev_dbg(&udev->dev, "Hub-initiated U2 disabled "
4155			"due to long timeout %llu ms\n", timeout_ns);
4156	return xhci_get_timeout_no_hub_lpm(udev, USB3_LPM_U2);
4157}
4158
4159static u16 xhci_call_host_update_timeout_for_endpoint(struct xhci_hcd *xhci,
4160		struct usb_device *udev,
4161		struct usb_endpoint_descriptor *desc,
4162		enum usb3_link_state state,
4163		u16 *timeout)
4164{
4165	if (state == USB3_LPM_U1) {
4166		if (xhci->quirks & XHCI_INTEL_HOST)
4167			return xhci_calculate_intel_u1_timeout(udev, desc);
4168	} else {
4169		if (xhci->quirks & XHCI_INTEL_HOST)
4170			return xhci_calculate_intel_u2_timeout(udev, desc);
4171	}
4172
4173	return USB3_LPM_DISABLED;
4174}
4175
4176static int xhci_update_timeout_for_endpoint(struct xhci_hcd *xhci,
4177		struct usb_device *udev,
4178		struct usb_endpoint_descriptor *desc,
4179		enum usb3_link_state state,
4180		u16 *timeout)
4181{
4182	u16 alt_timeout;
4183
4184	alt_timeout = xhci_call_host_update_timeout_for_endpoint(xhci, udev,
4185		desc, state, timeout);
4186
4187	/* If we found we can't enable hub-initiated LPM, or
4188	 * the U1 or U2 exit latency was too high to allow
4189	 * device-initiated LPM as well, just stop searching.
4190	 */
4191	if (alt_timeout == USB3_LPM_DISABLED ||
4192			alt_timeout == USB3_LPM_DEVICE_INITIATED) {
4193		*timeout = alt_timeout;
4194		return -E2BIG;
4195	}
4196	if (alt_timeout > *timeout)
4197		*timeout = alt_timeout;
4198	return 0;
4199}
4200
4201static int xhci_update_timeout_for_interface(struct xhci_hcd *xhci,
4202		struct usb_device *udev,
4203		struct usb_host_interface *alt,
4204		enum usb3_link_state state,
4205		u16 *timeout)
4206{
4207	int j;
4208
4209	for (j = 0; j < alt->desc.bNumEndpoints; j++) {
4210		if (xhci_update_timeout_for_endpoint(xhci, udev,
4211					&alt->endpoint[j].desc, state, timeout))
4212			return -E2BIG;
4213		continue;
4214	}
4215	return 0;
4216}
4217
4218static int xhci_check_intel_tier_policy(struct usb_device *udev,
4219		enum usb3_link_state state)
4220{
4221	struct usb_device *parent;
4222	unsigned int num_hubs;
4223
4224	if (state == USB3_LPM_U2)
4225		return 0;
4226
4227	/* Don't enable U1 if the device is on a 2nd tier hub or lower. */
4228	for (parent = udev->parent, num_hubs = 0; parent->parent;
4229			parent = parent->parent)
4230		num_hubs++;
4231
4232	if (num_hubs < 2)
4233		return 0;
4234
4235	dev_dbg(&udev->dev, "Disabling U1 link state for device"
4236			" below second-tier hub.\n");
4237	dev_dbg(&udev->dev, "Plug device into first-tier hub "
4238			"to decrease power consumption.\n");
4239	return -E2BIG;
4240}
4241
4242static int xhci_check_tier_policy(struct xhci_hcd *xhci,
4243		struct usb_device *udev,
4244		enum usb3_link_state state)
4245{
4246	if (xhci->quirks & XHCI_INTEL_HOST)
4247		return xhci_check_intel_tier_policy(udev, state);
4248	return -EINVAL;
 
4249}
4250
4251/* Returns the U1 or U2 timeout that should be enabled.
4252 * If the tier check or timeout setting functions return with a non-zero exit
4253 * code, that means the timeout value has been finalized and we shouldn't look
4254 * at any more endpoints.
4255 */
4256static u16 xhci_calculate_lpm_timeout(struct usb_hcd *hcd,
4257			struct usb_device *udev, enum usb3_link_state state)
4258{
4259	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4260	struct usb_host_config *config;
4261	char *state_name;
4262	int i;
4263	u16 timeout = USB3_LPM_DISABLED;
4264
4265	if (state == USB3_LPM_U1)
4266		state_name = "U1";
4267	else if (state == USB3_LPM_U2)
4268		state_name = "U2";
4269	else {
4270		dev_warn(&udev->dev, "Can't enable unknown link state %i\n",
4271				state);
4272		return timeout;
4273	}
4274
4275	if (xhci_check_tier_policy(xhci, udev, state) < 0)
4276		return timeout;
4277
4278	/* Gather some information about the currently installed configuration
4279	 * and alternate interface settings.
4280	 */
4281	if (xhci_update_timeout_for_endpoint(xhci, udev, &udev->ep0.desc,
4282			state, &timeout))
4283		return timeout;
4284
4285	config = udev->actconfig;
4286	if (!config)
4287		return timeout;
4288
4289	for (i = 0; i < USB_MAXINTERFACES; i++) {
4290		struct usb_driver *driver;
4291		struct usb_interface *intf = config->interface[i];
4292
4293		if (!intf)
4294			continue;
4295
4296		/* Check if any currently bound drivers want hub-initiated LPM
4297		 * disabled.
4298		 */
4299		if (intf->dev.driver) {
4300			driver = to_usb_driver(intf->dev.driver);
4301			if (driver && driver->disable_hub_initiated_lpm) {
4302				dev_dbg(&udev->dev, "Hub-initiated %s disabled "
4303						"at request of driver %s\n",
4304						state_name, driver->name);
4305				return xhci_get_timeout_no_hub_lpm(udev, state);
4306			}
4307		}
4308
4309		/* Not sure how this could happen... */
4310		if (!intf->cur_altsetting)
4311			continue;
4312
4313		if (xhci_update_timeout_for_interface(xhci, udev,
4314					intf->cur_altsetting,
4315					state, &timeout))
4316			return timeout;
4317	}
4318	return timeout;
4319}
4320
4321/*
4322 * Issue an Evaluate Context command to change the Maximum Exit Latency in the
4323 * slot context.  If that succeeds, store the new MEL in the xhci_virt_device.
4324 */
4325static int xhci_change_max_exit_latency(struct xhci_hcd *xhci,
4326			struct usb_device *udev, u16 max_exit_latency)
4327{
4328	struct xhci_virt_device *virt_dev;
4329	struct xhci_command *command;
4330	struct xhci_input_control_ctx *ctrl_ctx;
4331	struct xhci_slot_ctx *slot_ctx;
4332	unsigned long flags;
4333	int ret;
4334
4335	spin_lock_irqsave(&xhci->lock, flags);
4336	if (max_exit_latency == xhci->devs[udev->slot_id]->current_mel) {
4337		spin_unlock_irqrestore(&xhci->lock, flags);
4338		return 0;
4339	}
4340
4341	/* Attempt to issue an Evaluate Context command to change the MEL. */
4342	virt_dev = xhci->devs[udev->slot_id];
4343	command = xhci->lpm_command;
4344	xhci_slot_copy(xhci, command->in_ctx, virt_dev->out_ctx);
4345	spin_unlock_irqrestore(&xhci->lock, flags);
4346
4347	ctrl_ctx = xhci_get_input_control_ctx(xhci, command->in_ctx);
4348	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
4349	slot_ctx = xhci_get_slot_ctx(xhci, command->in_ctx);
4350	slot_ctx->dev_info2 &= cpu_to_le32(~((u32) MAX_EXIT));
4351	slot_ctx->dev_info2 |= cpu_to_le32(max_exit_latency);
4352
4353	xhci_dbg(xhci, "Set up evaluate context for LPM MEL change.\n");
4354	xhci_dbg(xhci, "Slot %u Input Context:\n", udev->slot_id);
4355	xhci_dbg_ctx(xhci, command->in_ctx, 0);
4356
4357	/* Issue and wait for the evaluate context command. */
4358	ret = xhci_configure_endpoint(xhci, udev, command,
4359			true, true);
4360	xhci_dbg(xhci, "Slot %u Output Context:\n", udev->slot_id);
4361	xhci_dbg_ctx(xhci, virt_dev->out_ctx, 0);
4362
4363	if (!ret) {
4364		spin_lock_irqsave(&xhci->lock, flags);
4365		virt_dev->current_mel = max_exit_latency;
4366		spin_unlock_irqrestore(&xhci->lock, flags);
4367	}
4368	return ret;
4369}
4370
4371static int calculate_max_exit_latency(struct usb_device *udev,
4372		enum usb3_link_state state_changed,
4373		u16 hub_encoded_timeout)
4374{
4375	unsigned long long u1_mel_us = 0;
4376	unsigned long long u2_mel_us = 0;
4377	unsigned long long mel_us = 0;
4378	bool disabling_u1;
4379	bool disabling_u2;
4380	bool enabling_u1;
4381	bool enabling_u2;
4382
4383	disabling_u1 = (state_changed == USB3_LPM_U1 &&
4384			hub_encoded_timeout == USB3_LPM_DISABLED);
4385	disabling_u2 = (state_changed == USB3_LPM_U2 &&
4386			hub_encoded_timeout == USB3_LPM_DISABLED);
4387
4388	enabling_u1 = (state_changed == USB3_LPM_U1 &&
4389			hub_encoded_timeout != USB3_LPM_DISABLED);
4390	enabling_u2 = (state_changed == USB3_LPM_U2 &&
4391			hub_encoded_timeout != USB3_LPM_DISABLED);
4392
4393	/* If U1 was already enabled and we're not disabling it,
4394	 * or we're going to enable U1, account for the U1 max exit latency.
4395	 */
4396	if ((udev->u1_params.timeout != USB3_LPM_DISABLED && !disabling_u1) ||
4397			enabling_u1)
4398		u1_mel_us = DIV_ROUND_UP(udev->u1_params.mel, 1000);
4399	if ((udev->u2_params.timeout != USB3_LPM_DISABLED && !disabling_u2) ||
4400			enabling_u2)
4401		u2_mel_us = DIV_ROUND_UP(udev->u2_params.mel, 1000);
4402
4403	if (u1_mel_us > u2_mel_us)
4404		mel_us = u1_mel_us;
4405	else
4406		mel_us = u2_mel_us;
4407	/* xHCI host controller max exit latency field is only 16 bits wide. */
4408	if (mel_us > MAX_EXIT) {
4409		dev_warn(&udev->dev, "Link PM max exit latency of %lluus "
4410				"is too big.\n", mel_us);
4411		return -E2BIG;
4412	}
4413	return mel_us;
4414}
4415
4416/* Returns the USB3 hub-encoded value for the U1/U2 timeout. */
4417int xhci_enable_usb3_lpm_timeout(struct usb_hcd *hcd,
4418			struct usb_device *udev, enum usb3_link_state state)
4419{
4420	struct xhci_hcd	*xhci;
4421	u16 hub_encoded_timeout;
4422	int mel;
4423	int ret;
4424
4425	xhci = hcd_to_xhci(hcd);
4426	/* The LPM timeout values are pretty host-controller specific, so don't
4427	 * enable hub-initiated timeouts unless the vendor has provided
4428	 * information about their timeout algorithm.
4429	 */
4430	if (!xhci || !(xhci->quirks & XHCI_LPM_SUPPORT) ||
4431			!xhci->devs[udev->slot_id])
4432		return USB3_LPM_DISABLED;
4433
4434	hub_encoded_timeout = xhci_calculate_lpm_timeout(hcd, udev, state);
4435	mel = calculate_max_exit_latency(udev, state, hub_encoded_timeout);
4436	if (mel < 0) {
4437		/* Max Exit Latency is too big, disable LPM. */
4438		hub_encoded_timeout = USB3_LPM_DISABLED;
4439		mel = 0;
4440	}
4441
4442	ret = xhci_change_max_exit_latency(xhci, udev, mel);
4443	if (ret)
4444		return ret;
4445	return hub_encoded_timeout;
4446}
4447
4448int xhci_disable_usb3_lpm_timeout(struct usb_hcd *hcd,
4449			struct usb_device *udev, enum usb3_link_state state)
4450{
4451	struct xhci_hcd	*xhci;
4452	u16 mel;
4453	int ret;
4454
4455	xhci = hcd_to_xhci(hcd);
4456	if (!xhci || !(xhci->quirks & XHCI_LPM_SUPPORT) ||
4457			!xhci->devs[udev->slot_id])
4458		return 0;
4459
4460	mel = calculate_max_exit_latency(udev, state, USB3_LPM_DISABLED);
4461	ret = xhci_change_max_exit_latency(xhci, udev, mel);
4462	if (ret)
4463		return ret;
 
 
 
 
 
 
 
 
 
4464	return 0;
4465}
4466#else /* CONFIG_PM */
4467
4468int xhci_enable_usb3_lpm_timeout(struct usb_hcd *hcd,
4469			struct usb_device *udev, enum usb3_link_state state)
4470{
4471	return USB3_LPM_DISABLED;
4472}
4473
4474int xhci_disable_usb3_lpm_timeout(struct usb_hcd *hcd,
4475			struct usb_device *udev, enum usb3_link_state state)
4476{
4477	return 0;
4478}
4479#endif	/* CONFIG_PM */
4480
4481/*-------------------------------------------------------------------------*/
4482
4483/* Once a hub descriptor is fetched for a device, we need to update the xHC's
4484 * internal data structures for the device.
4485 */
4486int xhci_update_hub_device(struct usb_hcd *hcd, struct usb_device *hdev,
4487			struct usb_tt *tt, gfp_t mem_flags)
4488{
4489	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4490	struct xhci_virt_device *vdev;
4491	struct xhci_command *config_cmd;
4492	struct xhci_input_control_ctx *ctrl_ctx;
4493	struct xhci_slot_ctx *slot_ctx;
4494	unsigned long flags;
4495	unsigned think_time;
4496	int ret;
4497
4498	/* Ignore root hubs */
4499	if (!hdev->parent)
4500		return 0;
4501
4502	vdev = xhci->devs[hdev->slot_id];
4503	if (!vdev) {
4504		xhci_warn(xhci, "Cannot update hub desc for unknown device.\n");
4505		return -EINVAL;
4506	}
4507	config_cmd = xhci_alloc_command(xhci, true, true, mem_flags);
4508	if (!config_cmd) {
4509		xhci_dbg(xhci, "Could not allocate xHCI command structure.\n");
4510		return -ENOMEM;
4511	}
 
 
 
 
 
 
 
4512
4513	spin_lock_irqsave(&xhci->lock, flags);
4514	if (hdev->speed == USB_SPEED_HIGH &&
4515			xhci_alloc_tt_info(xhci, vdev, hdev, tt, GFP_ATOMIC)) {
4516		xhci_dbg(xhci, "Could not allocate xHCI TT structure.\n");
4517		xhci_free_command(xhci, config_cmd);
4518		spin_unlock_irqrestore(&xhci->lock, flags);
4519		return -ENOMEM;
4520	}
4521
4522	xhci_slot_copy(xhci, config_cmd->in_ctx, vdev->out_ctx);
4523	ctrl_ctx = xhci_get_input_control_ctx(xhci, config_cmd->in_ctx);
4524	ctrl_ctx->add_flags |= cpu_to_le32(SLOT_FLAG);
4525	slot_ctx = xhci_get_slot_ctx(xhci, config_cmd->in_ctx);
4526	slot_ctx->dev_info |= cpu_to_le32(DEV_HUB);
 
 
 
 
 
4527	if (tt->multi)
4528		slot_ctx->dev_info |= cpu_to_le32(DEV_MTT);
 
 
 
4529	if (xhci->hci_version > 0x95) {
4530		xhci_dbg(xhci, "xHCI version %x needs hub "
4531				"TT think time and number of ports\n",
4532				(unsigned int) xhci->hci_version);
4533		slot_ctx->dev_info2 |= cpu_to_le32(XHCI_MAX_PORTS(hdev->maxchild));
4534		/* Set TT think time - convert from ns to FS bit times.
4535		 * 0 = 8 FS bit times, 1 = 16 FS bit times,
4536		 * 2 = 24 FS bit times, 3 = 32 FS bit times.
4537		 *
4538		 * xHCI 1.0: this field shall be 0 if the device is not a
4539		 * High-spped hub.
4540		 */
4541		think_time = tt->think_time;
4542		if (think_time != 0)
4543			think_time = (think_time / 666) - 1;
4544		if (xhci->hci_version < 0x100 || hdev->speed == USB_SPEED_HIGH)
4545			slot_ctx->tt_info |=
4546				cpu_to_le32(TT_THINK_TIME(think_time));
4547	} else {
4548		xhci_dbg(xhci, "xHCI version %x doesn't need hub "
4549				"TT think time or number of ports\n",
4550				(unsigned int) xhci->hci_version);
4551	}
4552	slot_ctx->dev_state = 0;
4553	spin_unlock_irqrestore(&xhci->lock, flags);
4554
4555	xhci_dbg(xhci, "Set up %s for hub device.\n",
4556			(xhci->hci_version > 0x95) ?
4557			"configure endpoint" : "evaluate context");
4558	xhci_dbg(xhci, "Slot %u Input Context:\n", hdev->slot_id);
4559	xhci_dbg_ctx(xhci, config_cmd->in_ctx, 0);
4560
4561	/* Issue and wait for the configure endpoint or
4562	 * evaluate context command.
4563	 */
4564	if (xhci->hci_version > 0x95)
4565		ret = xhci_configure_endpoint(xhci, hdev, config_cmd,
4566				false, false);
4567	else
4568		ret = xhci_configure_endpoint(xhci, hdev, config_cmd,
4569				true, false);
4570
4571	xhci_dbg(xhci, "Slot %u Output Context:\n", hdev->slot_id);
4572	xhci_dbg_ctx(xhci, vdev->out_ctx, 0);
4573
4574	xhci_free_command(xhci, config_cmd);
4575	return ret;
4576}
4577
4578int xhci_get_frame(struct usb_hcd *hcd)
4579{
4580	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
4581	/* EHCI mods by the periodic size.  Why? */
4582	return xhci_readl(xhci, &xhci->run_regs->microframe_index) >> 3;
4583}
4584
4585int xhci_gen_setup(struct usb_hcd *hcd, xhci_get_quirks_t get_quirks)
4586{
4587	struct xhci_hcd		*xhci;
4588	struct device		*dev = hcd->self.controller;
4589	int			retval;
4590	u32			temp;
4591
4592	/* Accept arbitrarily long scatter-gather lists */
4593	hcd->self.sg_tablesize = ~0;
4594
 
 
 
 
 
 
 
 
4595	if (usb_hcd_is_primary_hcd(hcd)) {
4596		xhci = kzalloc(sizeof(struct xhci_hcd), GFP_KERNEL);
4597		if (!xhci)
4598			return -ENOMEM;
4599		*((struct xhci_hcd **) hcd->hcd_priv) = xhci;
4600		xhci->main_hcd = hcd;
4601		/* Mark the first roothub as being USB 2.0.
4602		 * The xHCI driver will register the USB 3.0 roothub.
4603		 */
4604		hcd->speed = HCD_USB2;
4605		hcd->self.root_hub->speed = USB_SPEED_HIGH;
4606		/*
4607		 * USB 2.0 roothub under xHCI has an integrated TT,
4608		 * (rate matching hub) as opposed to having an OHCI/UHCI
4609		 * companion controller.
4610		 */
4611		hcd->has_tt = 1;
4612	} else {
 
 
 
 
 
4613		/* xHCI private pointer was set in xhci_pci_probe for the second
4614		 * registered roothub.
4615		 */
4616		xhci = hcd_to_xhci(hcd);
4617		temp = xhci_readl(xhci, &xhci->cap_regs->hcc_params);
4618		if (HCC_64BIT_ADDR(temp)) {
4619			xhci_dbg(xhci, "Enabling 64-bit DMA addresses.\n");
4620			dma_set_mask(hcd->self.controller, DMA_BIT_MASK(64));
4621		} else {
4622			dma_set_mask(hcd->self.controller, DMA_BIT_MASK(32));
4623		}
4624		return 0;
4625	}
4626
 
4627	xhci->cap_regs = hcd->regs;
4628	xhci->op_regs = hcd->regs +
4629		HC_LENGTH(xhci_readl(xhci, &xhci->cap_regs->hc_capbase));
4630	xhci->run_regs = hcd->regs +
4631		(xhci_readl(xhci, &xhci->cap_regs->run_regs_off) & RTSOFF_MASK);
4632	/* Cache read-only capability registers */
4633	xhci->hcs_params1 = xhci_readl(xhci, &xhci->cap_regs->hcs_params1);
4634	xhci->hcs_params2 = xhci_readl(xhci, &xhci->cap_regs->hcs_params2);
4635	xhci->hcs_params3 = xhci_readl(xhci, &xhci->cap_regs->hcs_params3);
4636	xhci->hcc_params = xhci_readl(xhci, &xhci->cap_regs->hc_capbase);
4637	xhci->hci_version = HC_VERSION(xhci->hcc_params);
4638	xhci->hcc_params = xhci_readl(xhci, &xhci->cap_regs->hcc_params);
 
 
4639	xhci_print_registers(xhci);
4640
 
 
4641	get_quirks(dev, xhci);
4642
 
 
 
 
 
 
 
4643	/* Make sure the HC is halted. */
4644	retval = xhci_halt(xhci);
4645	if (retval)
4646		goto error;
4647
4648	xhci_dbg(xhci, "Resetting HCD\n");
4649	/* Reset the internal HC memory state and registers. */
4650	retval = xhci_reset(xhci);
4651	if (retval)
4652		goto error;
4653	xhci_dbg(xhci, "Reset complete\n");
4654
4655	temp = xhci_readl(xhci, &xhci->cap_regs->hcc_params);
4656	if (HCC_64BIT_ADDR(temp)) {
 
 
 
 
 
 
 
 
 
 
 
 
4657		xhci_dbg(xhci, "Enabling 64-bit DMA addresses.\n");
4658		dma_set_mask(hcd->self.controller, DMA_BIT_MASK(64));
4659	} else {
4660		dma_set_mask(hcd->self.controller, DMA_BIT_MASK(32));
 
 
 
 
 
 
 
 
4661	}
4662
4663	xhci_dbg(xhci, "Calling HCD init\n");
4664	/* Initialize HCD and host controller data structures. */
4665	retval = xhci_init(hcd);
4666	if (retval)
4667		goto error;
4668	xhci_dbg(xhci, "Called HCD init\n");
 
 
 
 
4669	return 0;
4670error:
4671	kfree(xhci);
4672	return retval;
4673}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4674
4675MODULE_DESCRIPTION(DRIVER_DESC);
4676MODULE_AUTHOR(DRIVER_AUTHOR);
4677MODULE_LICENSE("GPL");
4678
4679static int __init xhci_hcd_init(void)
4680{
4681	int retval;
4682
4683	retval = xhci_register_pci();
4684	if (retval < 0) {
4685		printk(KERN_DEBUG "Problem registering PCI driver.");
4686		return retval;
4687	}
4688	retval = xhci_register_plat();
4689	if (retval < 0) {
4690		printk(KERN_DEBUG "Problem registering platform driver.");
4691		goto unreg_pci;
4692	}
4693	/*
4694	 * Check the compiler generated sizes of structures that must be laid
4695	 * out in specific ways for hardware access.
4696	 */
4697	BUILD_BUG_ON(sizeof(struct xhci_doorbell_array) != 256*32/8);
4698	BUILD_BUG_ON(sizeof(struct xhci_slot_ctx) != 8*32/8);
4699	BUILD_BUG_ON(sizeof(struct xhci_ep_ctx) != 8*32/8);
4700	/* xhci_device_control has eight fields, and also
4701	 * embeds one xhci_slot_ctx and 31 xhci_ep_ctx
4702	 */
4703	BUILD_BUG_ON(sizeof(struct xhci_stream_ctx) != 4*32/8);
4704	BUILD_BUG_ON(sizeof(union xhci_trb) != 4*32/8);
4705	BUILD_BUG_ON(sizeof(struct xhci_erst_entry) != 4*32/8);
4706	BUILD_BUG_ON(sizeof(struct xhci_cap_regs) != 7*32/8);
4707	BUILD_BUG_ON(sizeof(struct xhci_intr_reg) != 8*32/8);
4708	/* xhci_run_regs has eight fields and embeds 128 xhci_intr_regs */
4709	BUILD_BUG_ON(sizeof(struct xhci_run_regs) != (8+8*128)*32/8);
 
 
 
 
4710	return 0;
4711unreg_pci:
4712	xhci_unregister_pci();
4713	return retval;
4714}
 
 
 
 
 
 
 
4715module_init(xhci_hcd_init);
4716
4717static void __exit xhci_hcd_cleanup(void)
4718{
4719	xhci_unregister_pci();
4720	xhci_unregister_plat();
4721}
4722module_exit(xhci_hcd_cleanup);