2 * This file contains code to reset and initialize USB host controllers.
3 * Some of it includes work-arounds for PCI hardware and BIOS quirks.
4 * It may need to run early during booting -- before USB would normally
5 * initialize -- to ensure that Linux doesn't use any legacy modes.
7 * Copyright (c) 1999 Martin Mares <mj@ucw.cz>
11 #include <linux/types.h>
12 #include <linux/kernel.h>
13 #include <linux/pci.h>
14 #include <linux/init.h>
15 #include <linux/delay.h>
16 #include <linux/acpi.h>
17 #include "pci-quirks.h"
18 #include "xhci-ext-caps.h"
21 #define UHCI_USBLEGSUP 0xc0 /* legacy support */
22 #define UHCI_USBCMD 0 /* command register */
23 #define UHCI_USBINTR 4 /* interrupt register */
24 #define UHCI_USBLEGSUP_RWC 0x8f00 /* the R/WC bits */
25 #define UHCI_USBLEGSUP_RO 0x5040 /* R/O and reserved bits */
26 #define UHCI_USBCMD_RUN 0x0001 /* RUN/STOP bit */
27 #define UHCI_USBCMD_HCRESET 0x0002 /* Host Controller reset */
28 #define UHCI_USBCMD_EGSM 0x0008 /* Global Suspend Mode */
29 #define UHCI_USBCMD_CONFIGURE 0x0040 /* Config Flag */
30 #define UHCI_USBINTR_RESUME 0x0002 /* Resume interrupt enable */
32 #define OHCI_CONTROL 0x04
33 #define OHCI_CMDSTATUS 0x08
34 #define OHCI_INTRSTATUS 0x0c
35 #define OHCI_INTRENABLE 0x10
36 #define OHCI_INTRDISABLE 0x14
37 #define OHCI_OCR (1 << 3) /* ownership change request */
38 #define OHCI_CTRL_RWC (1 << 9) /* remote wakeup connected */
39 #define OHCI_CTRL_IR (1 << 8) /* interrupt routing */
40 #define OHCI_INTR_OC (1 << 30) /* ownership change */
42 #define EHCI_HCC_PARAMS 0x08 /* extended capabilities */
43 #define EHCI_USBCMD 0 /* command register */
44 #define EHCI_USBCMD_RUN (1 << 0) /* RUN/STOP bit */
45 #define EHCI_USBSTS 4 /* status register */
46 #define EHCI_USBSTS_HALTED (1 << 12) /* HCHalted bit */
47 #define EHCI_USBINTR 8 /* interrupt register */
48 #define EHCI_CONFIGFLAG 0x40 /* configured flag register */
49 #define EHCI_USBLEGSUP 0 /* legacy support register */
50 #define EHCI_USBLEGSUP_BIOS (1 << 16) /* BIOS semaphore */
51 #define EHCI_USBLEGSUP_OS (1 << 24) /* OS semaphore */
52 #define EHCI_USBLEGCTLSTS 4 /* legacy control/status */
53 #define EHCI_USBLEGCTLSTS_SOOE (1 << 13) /* SMI on ownership change */
57 * Make sure the controller is completely inactive, unable to
58 * generate interrupts or do DMA.
60 void uhci_reset_hc(struct pci_dev *pdev, unsigned long base)
62 /* Turn off PIRQ enable and SMI enable. (This also turns off the
63 * BIOS's USB Legacy Support.) Turn off all the R/WC bits too.
65 pci_write_config_word(pdev, UHCI_USBLEGSUP, UHCI_USBLEGSUP_RWC);
67 /* Reset the HC - this will force us to get a
68 * new notification of any already connected
69 * ports due to the virtual disconnect that it
72 outw(UHCI_USBCMD_HCRESET, base + UHCI_USBCMD);
75 if (inw(base + UHCI_USBCMD) & UHCI_USBCMD_HCRESET)
76 dev_warn(&pdev->dev, "HCRESET not completed yet!\n");
78 /* Just to be safe, disable interrupt requests and
79 * make sure the controller is stopped.
81 outw(0, base + UHCI_USBINTR);
82 outw(0, base + UHCI_USBCMD);
84 EXPORT_SYMBOL_GPL(uhci_reset_hc);
87 * Initialize a controller that was newly discovered or has just been
88 * resumed. In either case we can't be sure of its previous state.
90 * Returns: 1 if the controller was reset, 0 otherwise.
92 int uhci_check_and_reset_hc(struct pci_dev *pdev, unsigned long base)
95 unsigned int cmd, intr;
98 * When restarting a suspended controller, we expect all the
99 * settings to be the same as we left them:
101 * PIRQ and SMI disabled, no R/W bits set in USBLEGSUP;
102 * Controller is stopped and configured with EGSM set;
103 * No interrupts enabled except possibly Resume Detect.
105 * If any of these conditions are violated we do a complete reset.
107 pci_read_config_word(pdev, UHCI_USBLEGSUP, &legsup);
108 if (legsup & ~(UHCI_USBLEGSUP_RO | UHCI_USBLEGSUP_RWC)) {
109 dev_dbg(&pdev->dev, "%s: legsup = 0x%04x\n",
114 cmd = inw(base + UHCI_USBCMD);
115 if ((cmd & UHCI_USBCMD_RUN) || !(cmd & UHCI_USBCMD_CONFIGURE) ||
116 !(cmd & UHCI_USBCMD_EGSM)) {
117 dev_dbg(&pdev->dev, "%s: cmd = 0x%04x\n",
122 intr = inw(base + UHCI_USBINTR);
123 if (intr & (~UHCI_USBINTR_RESUME)) {
124 dev_dbg(&pdev->dev, "%s: intr = 0x%04x\n",
131 dev_dbg(&pdev->dev, "Performing full reset\n");
132 uhci_reset_hc(pdev, base);
135 EXPORT_SYMBOL_GPL(uhci_check_and_reset_hc);
137 static inline int io_type_enabled(struct pci_dev *pdev, unsigned int mask)
140 return !pci_read_config_word(pdev, PCI_COMMAND, &cmd) && (cmd & mask);
143 #define pio_enabled(dev) io_type_enabled(dev, PCI_COMMAND_IO)
144 #define mmio_enabled(dev) io_type_enabled(dev, PCI_COMMAND_MEMORY)
146 static void __devinit quirk_usb_handoff_uhci(struct pci_dev *pdev)
148 unsigned long base = 0;
151 if (!pio_enabled(pdev))
154 for (i = 0; i < PCI_ROM_RESOURCE; i++)
155 if ((pci_resource_flags(pdev, i) & IORESOURCE_IO)) {
156 base = pci_resource_start(pdev, i);
161 uhci_check_and_reset_hc(pdev, base);
164 static int __devinit mmio_resource_enabled(struct pci_dev *pdev, int idx)
166 return pci_resource_start(pdev, idx) && mmio_enabled(pdev);
169 static void __devinit quirk_usb_handoff_ohci(struct pci_dev *pdev)
173 if (!mmio_resource_enabled(pdev, 0))
176 base = pci_ioremap_bar(pdev, 0);
180 /* On PA-RISC, PDC can leave IR set incorrectly; ignore it there. */
183 u32 control = readl(base + OHCI_CONTROL);
184 if (control & OHCI_CTRL_IR) {
185 int wait_time = 500; /* arbitrary; 5 seconds */
186 writel(OHCI_INTR_OC, base + OHCI_INTRENABLE);
187 writel(OHCI_OCR, base + OHCI_CMDSTATUS);
188 while (wait_time > 0 &&
189 readl(base + OHCI_CONTROL) & OHCI_CTRL_IR) {
194 dev_warn(&pdev->dev, "OHCI: BIOS handoff failed"
195 " (BIOS bug?) %08x\n",
196 readl(base + OHCI_CONTROL));
198 /* reset controller, preserving RWC */
199 writel(control & OHCI_CTRL_RWC, base + OHCI_CONTROL);
207 writel(~(u32)0, base + OHCI_INTRDISABLE);
208 writel(~(u32)0, base + OHCI_INTRSTATUS);
213 static void __devinit quirk_usb_disable_ehci(struct pci_dev *pdev)
215 int wait_time, delta;
216 void __iomem *base, *op_reg_base;
218 u8 offset, cap_length;
220 int tried_handoff = 0;
222 if (!mmio_resource_enabled(pdev, 0))
225 base = pci_ioremap_bar(pdev, 0);
229 cap_length = readb(base);
230 op_reg_base = base + cap_length;
232 /* EHCI 0.96 and later may have "extended capabilities"
233 * spec section 5.1 explains the bios handoff, e.g. for
234 * booting from USB disk or using a usb keyboard
236 hcc_params = readl(base + EHCI_HCC_PARAMS);
237 offset = (hcc_params >> 8) & 0xff;
238 while (offset && --count) {
242 pci_read_config_dword(pdev, offset, &cap);
243 switch (cap & 0xff) {
244 case 1: /* BIOS/SMM/... handoff support */
245 if ((cap & EHCI_USBLEGSUP_BIOS)) {
246 dev_dbg(&pdev->dev, "EHCI: BIOS handoff\n");
249 /* aleksey_gorelov@phoenix.com reports that some systems need SMI forced on,
250 * but that seems dubious in general (the BIOS left it off intentionally)
251 * and is known to prevent some systems from booting. so we won't do this
252 * unless maybe we can determine when we're on a system that needs SMI forced.
254 /* BIOS workaround (?): be sure the
255 * pre-Linux code receives the SMI
257 pci_read_config_dword(pdev,
258 offset + EHCI_USBLEGCTLSTS,
260 pci_write_config_dword(pdev,
261 offset + EHCI_USBLEGCTLSTS,
262 val | EHCI_USBLEGCTLSTS_SOOE);
265 /* some systems get upset if this semaphore is
266 * set for any other reason than forcing a BIOS
269 pci_write_config_byte(pdev, offset + 3, 1);
272 /* if boot firmware now owns EHCI, spin till
276 while ((cap & EHCI_USBLEGSUP_BIOS) && (msec > 0)) {
280 pci_read_config_dword(pdev, offset, &cap);
283 if (cap & EHCI_USBLEGSUP_BIOS) {
284 /* well, possibly buggy BIOS... try to shut
285 * it down, and hope nothing goes too wrong
287 dev_warn(&pdev->dev, "EHCI: BIOS handoff failed"
288 " (BIOS bug?) %08x\n", cap);
289 pci_write_config_byte(pdev, offset + 2, 0);
292 /* just in case, always disable EHCI SMIs */
293 pci_write_config_dword(pdev,
294 offset + EHCI_USBLEGCTLSTS,
297 /* If the BIOS ever owned the controller then we
298 * can't expect any power sessions to remain intact.
301 writel(0, op_reg_base + EHCI_CONFIGFLAG);
303 case 0: /* illegal reserved capability */
307 dev_warn(&pdev->dev, "EHCI: unrecognized capability "
308 "%02x\n", cap & 0xff);
311 offset = (cap >> 8) & 0xff;
314 dev_printk(KERN_DEBUG, &pdev->dev, "EHCI: capability loop?\n");
317 * halt EHCI & disable its interrupts in any case
319 val = readl(op_reg_base + EHCI_USBSTS);
320 if ((val & EHCI_USBSTS_HALTED) == 0) {
321 val = readl(op_reg_base + EHCI_USBCMD);
322 val &= ~EHCI_USBCMD_RUN;
323 writel(val, op_reg_base + EHCI_USBCMD);
328 writel(0x3f, op_reg_base + EHCI_USBSTS);
331 val = readl(op_reg_base + EHCI_USBSTS);
332 if ((val == ~(u32)0) || (val & EHCI_USBSTS_HALTED)) {
335 } while (wait_time > 0);
337 writel(0, op_reg_base + EHCI_USBINTR);
338 writel(0x3f, op_reg_base + EHCI_USBSTS);
346 * handshake - spin reading a register until handshake completes
347 * @ptr: address of hc register to be read
348 * @mask: bits to look at in result of read
349 * @done: value of those bits when handshake succeeds
350 * @wait_usec: timeout in microseconds
351 * @delay_usec: delay in microseconds to wait between polling
353 * Polls a register every delay_usec microseconds.
354 * Returns 0 when the mask bits have the value done.
355 * Returns -ETIMEDOUT if this condition is not true after
356 * wait_usec microseconds have passed.
358 static int handshake(void __iomem *ptr, u32 mask, u32 done,
359 int wait_usec, int delay_usec)
369 wait_usec -= delay_usec;
370 } while (wait_usec > 0);
375 * PCI Quirks for xHCI.
377 * Takes care of the handoff between the Pre-OS (i.e. BIOS) and the OS.
378 * It signals to the BIOS that the OS wants control of the host controller,
379 * and then waits 5 seconds for the BIOS to hand over control.
380 * If we timeout, assume the BIOS is broken and take control anyway.
382 static void __devinit quirk_usb_handoff_xhci(struct pci_dev *pdev)
386 void __iomem *op_reg_base;
390 if (!mmio_resource_enabled(pdev, 0))
393 base = ioremap_nocache(pci_resource_start(pdev, 0),
394 pci_resource_len(pdev, 0));
399 * Find the Legacy Support Capability register -
400 * this is optional for xHCI host controllers.
402 ext_cap_offset = xhci_find_next_cap_offset(base, XHCI_HCC_PARAMS_OFFSET);
405 /* We've reached the end of the extended capabilities */
407 val = readl(base + ext_cap_offset);
408 if (XHCI_EXT_CAPS_ID(val) == XHCI_EXT_CAPS_LEGACY)
410 ext_cap_offset = xhci_find_next_cap_offset(base, ext_cap_offset);
413 /* If the BIOS owns the HC, signal that the OS wants it, and wait */
414 if (val & XHCI_HC_BIOS_OWNED) {
415 writel(val & XHCI_HC_OS_OWNED, base + ext_cap_offset);
417 /* Wait for 5 seconds with 10 microsecond polling interval */
418 timeout = handshake(base + ext_cap_offset, XHCI_HC_BIOS_OWNED,
421 /* Assume a buggy BIOS and take HC ownership anyway */
423 dev_warn(&pdev->dev, "xHCI BIOS handoff failed"
424 " (BIOS bug ?) %08x\n", val);
425 writel(val & ~XHCI_HC_BIOS_OWNED, base + ext_cap_offset);
429 /* Disable any BIOS SMIs */
430 writel(XHCI_LEGACY_DISABLE_SMI,
431 base + ext_cap_offset + XHCI_LEGACY_CONTROL_OFFSET);
434 op_reg_base = base + XHCI_HC_LENGTH(readl(base));
436 /* Wait for the host controller to be ready before writing any
437 * operational or runtime registers. Wait 5 seconds and no more.
439 timeout = handshake(op_reg_base + XHCI_STS_OFFSET, XHCI_STS_CNR, 0,
441 /* Assume a buggy HC and start HC initialization anyway */
443 val = readl(op_reg_base + XHCI_STS_OFFSET);
445 "xHCI HW not ready after 5 sec (HC bug?) "
446 "status = 0x%x\n", val);
449 /* Send the halt and disable interrupts command */
450 val = readl(op_reg_base + XHCI_CMD_OFFSET);
451 val &= ~(XHCI_CMD_RUN | XHCI_IRQS);
452 writel(val, op_reg_base + XHCI_CMD_OFFSET);
454 /* Wait for the HC to halt - poll every 125 usec (one microframe). */
455 timeout = handshake(op_reg_base + XHCI_STS_OFFSET, XHCI_STS_HALT, 1,
456 XHCI_MAX_HALT_USEC, 125);
458 val = readl(op_reg_base + XHCI_STS_OFFSET);
460 "xHCI HW did not halt within %d usec "
461 "status = 0x%x\n", XHCI_MAX_HALT_USEC, val);
467 static void __devinit quirk_usb_early_handoff(struct pci_dev *pdev)
469 if (pdev->class == PCI_CLASS_SERIAL_USB_UHCI)
470 quirk_usb_handoff_uhci(pdev);
471 else if (pdev->class == PCI_CLASS_SERIAL_USB_OHCI)
472 quirk_usb_handoff_ohci(pdev);
473 else if (pdev->class == PCI_CLASS_SERIAL_USB_EHCI)
474 quirk_usb_disable_ehci(pdev);
475 else if (pdev->class == PCI_CLASS_SERIAL_USB_XHCI)
476 quirk_usb_handoff_xhci(pdev);
478 DECLARE_PCI_FIXUP_FINAL(PCI_ANY_ID, PCI_ANY_ID, quirk_usb_early_handoff);