2 * EHCI-compliant USB host controller driver for NVIDIA Tegra SoCs
4 * Copyright (C) 2010 Google, Inc.
5 * Copyright (C) 2009 - 2013 NVIDIA Corporation
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation; either version 2 of the License, or (at your
10 * option) any later version.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
19 #include <linux/clk.h>
20 #include <linux/dma-mapping.h>
21 #include <linux/err.h>
22 #include <linux/gpio.h>
24 #include <linux/irq.h>
25 #include <linux/module.h>
27 #include <linux/of_device.h>
28 #include <linux/of_gpio.h>
29 #include <linux/platform_device.h>
30 #include <linux/pm_runtime.h>
31 #include <linux/reset.h>
32 #include <linux/slab.h>
33 #include <linux/usb/ehci_def.h>
34 #include <linux/usb/tegra_usb_phy.h>
35 #include <linux/usb.h>
36 #include <linux/usb/hcd.h>
37 #include <linux/usb/otg.h>
41 #define PORT_WAKE_BITS (PORT_WKOC_E|PORT_WKDISC_E|PORT_WKCONN_E)
43 #define TEGRA_USB_DMA_ALIGN 32
45 #define DRIVER_DESC "Tegra EHCI driver"
46 #define DRV_NAME "tegra-ehci"
48 static struct hc_driver __read_mostly tegra_ehci_hc_driver;
49 static bool usb1_reset_attempted;
51 struct tegra_ehci_soc_config {
55 struct tegra_ehci_hcd {
56 struct tegra_usb_phy *phy;
58 struct reset_control *rst;
60 bool needs_double_reset;
61 enum tegra_usb_phy_port_speed port_speed;
65 * The 1st USB controller contains some UTMI pad registers that are global for
66 * all the controllers on the chip. Those registers are also cleared when
67 * reset is asserted to the 1st controller. This means that the 1st controller
68 * can only be reset when no other controlled has finished probing. So we'll
69 * reset the 1st controller before doing any other setup on any of the
70 * controllers, and then never again.
72 * Since this is a PHY issue, the Tegra PHY driver should probably be doing
73 * the resetting of the USB controllers. But to keep compatibility with old
74 * device trees that don't have reset phandles in the PHYs, do it here.
75 * Those old DTs will be vulnerable to total USB breakage if the 1st EHCI
76 * device isn't the first one to finish probing, so warn them.
78 static int tegra_reset_usb_controller(struct platform_device *pdev)
80 struct device_node *phy_np;
81 struct usb_hcd *hcd = platform_get_drvdata(pdev);
82 struct tegra_ehci_hcd *tegra =
83 (struct tegra_ehci_hcd *)hcd_to_ehci(hcd)->priv;
84 bool has_utmi_pad_registers = false;
86 phy_np = of_parse_phandle(pdev->dev.of_node, "nvidia,phy", 0);
90 if (of_property_read_bool(phy_np, "nvidia,has-utmi-pad-registers"))
91 has_utmi_pad_registers = true;
93 if (!usb1_reset_attempted) {
94 struct reset_control *usb1_reset;
96 if (!has_utmi_pad_registers)
97 usb1_reset = of_reset_control_get(phy_np, "utmi-pads");
99 usb1_reset = tegra->rst;
101 if (IS_ERR(usb1_reset)) {
103 "can't get utmi-pads reset from the PHY\n");
105 "continuing, but please update your DT\n");
107 reset_control_assert(usb1_reset);
109 reset_control_deassert(usb1_reset);
111 if (!has_utmi_pad_registers)
112 reset_control_put(usb1_reset);
115 usb1_reset_attempted = true;
118 if (!has_utmi_pad_registers) {
119 reset_control_assert(tegra->rst);
121 reset_control_deassert(tegra->rst);
129 static int tegra_ehci_internal_port_reset(
130 struct ehci_hcd *ehci,
131 u32 __iomem *portsc_reg
140 spin_lock_irqsave(&ehci->lock, flags);
141 saved_usbintr = ehci_readl(ehci, &ehci->regs->intr_enable);
142 /* disable USB interrupt */
143 ehci_writel(ehci, 0, &ehci->regs->intr_enable);
144 spin_unlock_irqrestore(&ehci->lock, flags);
147 * Here we have to do Port Reset at most twice for
148 * Port Enable bit to be set.
150 for (i = 0; i < 2; i++) {
151 temp = ehci_readl(ehci, portsc_reg);
153 ehci_writel(ehci, temp, portsc_reg);
156 ehci_writel(ehci, temp, portsc_reg);
162 * Up to this point, Port Enable bit is
163 * expected to be set after 2 ms waiting.
164 * USB1 usually takes extra 45 ms, for safety,
165 * we take 100 ms as timeout.
167 temp = ehci_readl(ehci, portsc_reg);
168 } while (!(temp & PORT_PE) && tries--);
176 * Clear Connect Status Change bit if it's set.
177 * We can't clear PORT_PEC. It will also cause PORT_PE to be cleared.
180 ehci_writel(ehci, PORT_CSC, portsc_reg);
183 * Write to clear any interrupt status bits that might be set
186 temp = ehci_readl(ehci, &ehci->regs->status);
187 ehci_writel(ehci, temp, &ehci->regs->status);
189 /* restore original interrupt enable bits */
190 ehci_writel(ehci, saved_usbintr, &ehci->regs->intr_enable);
194 static int tegra_ehci_hub_control(
203 struct ehci_hcd *ehci = hcd_to_ehci(hcd);
204 struct tegra_ehci_hcd *tegra = (struct tegra_ehci_hcd *)ehci->priv;
205 u32 __iomem *status_reg;
210 status_reg = &ehci->regs->port_status[(wIndex & 0xff) - 1];
212 spin_lock_irqsave(&ehci->lock, flags);
214 if (typeReq == GetPortStatus) {
215 temp = ehci_readl(ehci, status_reg);
216 if (tegra->port_resuming && !(temp & PORT_SUSPEND)) {
217 /* Resume completed, re-enable disconnect detection */
218 tegra->port_resuming = 0;
219 tegra_usb_phy_postresume(hcd->usb_phy);
223 else if (typeReq == SetPortFeature && wValue == USB_PORT_FEAT_SUSPEND) {
224 temp = ehci_readl(ehci, status_reg);
225 if ((temp & PORT_PE) == 0 || (temp & PORT_RESET) != 0) {
230 temp &= ~(PORT_RWC_BITS | PORT_WKCONN_E);
231 temp |= PORT_WKDISC_E | PORT_WKOC_E;
232 ehci_writel(ehci, temp | PORT_SUSPEND, status_reg);
235 * If a transaction is in progress, there may be a delay in
236 * suspending the port. Poll until the port is suspended.
238 if (ehci_handshake(ehci, status_reg, PORT_SUSPEND,
240 pr_err("%s: timeout waiting for SUSPEND\n", __func__);
242 set_bit((wIndex & 0xff) - 1, &ehci->suspended_ports);
246 /* For USB1 port we need to issue Port Reset twice internally */
247 if (tegra->needs_double_reset &&
248 (typeReq == SetPortFeature && wValue == USB_PORT_FEAT_RESET)) {
249 spin_unlock_irqrestore(&ehci->lock, flags);
250 return tegra_ehci_internal_port_reset(ehci, status_reg);
254 * Tegra host controller will time the resume operation to clear the bit
255 * when the port control state switches to HS or FS Idle. This behavior
256 * is different from EHCI where the host controller driver is required
257 * to set this bit to a zero after the resume duration is timed in the
260 else if (typeReq == ClearPortFeature &&
261 wValue == USB_PORT_FEAT_SUSPEND) {
262 temp = ehci_readl(ehci, status_reg);
263 if ((temp & PORT_RESET) || !(temp & PORT_PE)) {
268 if (!(temp & PORT_SUSPEND))
271 /* Disable disconnect detection during port resume */
272 tegra_usb_phy_preresume(hcd->usb_phy);
274 ehci->reset_done[wIndex-1] = jiffies + msecs_to_jiffies(25);
276 temp &= ~(PORT_RWC_BITS | PORT_WAKE_BITS);
277 /* start resume signalling */
278 ehci_writel(ehci, temp | PORT_RESUME, status_reg);
279 set_bit(wIndex-1, &ehci->resuming_ports);
281 spin_unlock_irqrestore(&ehci->lock, flags);
283 spin_lock_irqsave(&ehci->lock, flags);
285 /* Poll until the controller clears RESUME and SUSPEND */
286 if (ehci_handshake(ehci, status_reg, PORT_RESUME, 0, 2000))
287 pr_err("%s: timeout waiting for RESUME\n", __func__);
288 if (ehci_handshake(ehci, status_reg, PORT_SUSPEND, 0, 2000))
289 pr_err("%s: timeout waiting for SUSPEND\n", __func__);
291 ehci->reset_done[wIndex-1] = 0;
292 clear_bit(wIndex-1, &ehci->resuming_ports);
294 tegra->port_resuming = 1;
298 spin_unlock_irqrestore(&ehci->lock, flags);
300 /* Handle the hub control events here */
301 return ehci_hub_control(hcd, typeReq, wValue, wIndex, buf, wLength);
304 spin_unlock_irqrestore(&ehci->lock, flags);
308 struct dma_aligned_buffer {
310 void *old_xfer_buffer;
314 static void free_dma_aligned_buffer(struct urb *urb)
316 struct dma_aligned_buffer *temp;
319 if (!(urb->transfer_flags & URB_ALIGNED_TEMP_BUFFER))
322 temp = container_of(urb->transfer_buffer,
323 struct dma_aligned_buffer, data);
325 if (usb_urb_dir_in(urb)) {
326 if (usb_pipeisoc(urb->pipe))
327 length = urb->transfer_buffer_length;
329 length = urb->actual_length;
331 memcpy(temp->old_xfer_buffer, temp->data, length);
333 urb->transfer_buffer = temp->old_xfer_buffer;
334 kfree(temp->kmalloc_ptr);
336 urb->transfer_flags &= ~URB_ALIGNED_TEMP_BUFFER;
339 static int alloc_dma_aligned_buffer(struct urb *urb, gfp_t mem_flags)
341 struct dma_aligned_buffer *temp, *kmalloc_ptr;
344 if (urb->num_sgs || urb->sg ||
345 urb->transfer_buffer_length == 0 ||
346 !((uintptr_t)urb->transfer_buffer & (TEGRA_USB_DMA_ALIGN - 1)))
349 /* Allocate a buffer with enough padding for alignment */
350 kmalloc_size = urb->transfer_buffer_length +
351 sizeof(struct dma_aligned_buffer) + TEGRA_USB_DMA_ALIGN - 1;
353 kmalloc_ptr = kmalloc(kmalloc_size, mem_flags);
357 /* Position our struct dma_aligned_buffer such that data is aligned */
358 temp = PTR_ALIGN(kmalloc_ptr + 1, TEGRA_USB_DMA_ALIGN) - 1;
359 temp->kmalloc_ptr = kmalloc_ptr;
360 temp->old_xfer_buffer = urb->transfer_buffer;
361 if (usb_urb_dir_out(urb))
362 memcpy(temp->data, urb->transfer_buffer,
363 urb->transfer_buffer_length);
364 urb->transfer_buffer = temp->data;
366 urb->transfer_flags |= URB_ALIGNED_TEMP_BUFFER;
371 static int tegra_ehci_map_urb_for_dma(struct usb_hcd *hcd, struct urb *urb,
376 ret = alloc_dma_aligned_buffer(urb, mem_flags);
380 ret = usb_hcd_map_urb_for_dma(hcd, urb, mem_flags);
382 free_dma_aligned_buffer(urb);
387 static void tegra_ehci_unmap_urb_for_dma(struct usb_hcd *hcd, struct urb *urb)
389 usb_hcd_unmap_urb_for_dma(hcd, urb);
390 free_dma_aligned_buffer(urb);
393 static const struct tegra_ehci_soc_config tegra30_soc_config = {
397 static const struct tegra_ehci_soc_config tegra20_soc_config = {
401 static const struct of_device_id tegra_ehci_of_match[] = {
402 { .compatible = "nvidia,tegra30-ehci", .data = &tegra30_soc_config },
403 { .compatible = "nvidia,tegra20-ehci", .data = &tegra20_soc_config },
407 static int tegra_ehci_probe(struct platform_device *pdev)
409 const struct of_device_id *match;
410 const struct tegra_ehci_soc_config *soc_config;
411 struct resource *res;
413 struct ehci_hcd *ehci;
414 struct tegra_ehci_hcd *tegra;
417 struct usb_phy *u_phy;
419 match = of_match_device(tegra_ehci_of_match, &pdev->dev);
421 dev_err(&pdev->dev, "Error: No device match found\n");
424 soc_config = match->data;
426 /* Right now device-tree probed devices don't get dma_mask set.
427 * Since shared usb code relies on it, set it here for now.
428 * Once we have dma capability bindings this can go away.
430 err = dma_coerce_mask_and_coherent(&pdev->dev, DMA_BIT_MASK(32));
434 hcd = usb_create_hcd(&tegra_ehci_hc_driver, &pdev->dev,
435 dev_name(&pdev->dev));
437 dev_err(&pdev->dev, "Unable to create HCD\n");
440 platform_set_drvdata(pdev, hcd);
441 ehci = hcd_to_ehci(hcd);
442 tegra = (struct tegra_ehci_hcd *)ehci->priv;
446 tegra->clk = devm_clk_get(&pdev->dev, NULL);
447 if (IS_ERR(tegra->clk)) {
448 dev_err(&pdev->dev, "Can't get ehci clock\n");
449 err = PTR_ERR(tegra->clk);
450 goto cleanup_hcd_create;
453 tegra->rst = devm_reset_control_get(&pdev->dev, "usb");
454 if (IS_ERR(tegra->rst)) {
455 dev_err(&pdev->dev, "Can't get ehci reset\n");
456 err = PTR_ERR(tegra->rst);
457 goto cleanup_hcd_create;
460 err = clk_prepare_enable(tegra->clk);
462 goto cleanup_hcd_create;
464 err = tegra_reset_usb_controller(pdev);
468 u_phy = devm_usb_get_phy_by_phandle(&pdev->dev, "nvidia,phy", 0);
473 hcd->usb_phy = u_phy;
475 tegra->needs_double_reset = of_property_read_bool(pdev->dev.of_node,
476 "nvidia,needs-double-reset");
478 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
479 hcd->regs = devm_ioremap_resource(&pdev->dev, res);
480 if (IS_ERR(hcd->regs)) {
481 err = PTR_ERR(hcd->regs);
484 hcd->rsrc_start = res->start;
485 hcd->rsrc_len = resource_size(res);
487 ehci->caps = hcd->regs + 0x100;
488 ehci->has_hostpc = soc_config->has_hostpc;
490 err = usb_phy_init(hcd->usb_phy);
492 dev_err(&pdev->dev, "Failed to initialize phy\n");
496 u_phy->otg = devm_kzalloc(&pdev->dev, sizeof(struct usb_otg),
502 u_phy->otg->host = hcd_to_bus(hcd);
504 err = usb_phy_set_suspend(hcd->usb_phy, 0);
506 dev_err(&pdev->dev, "Failed to power on the phy\n");
510 irq = platform_get_irq(pdev, 0);
512 dev_err(&pdev->dev, "Failed to get IRQ\n");
517 otg_set_host(u_phy->otg, &hcd->self);
519 err = usb_add_hcd(hcd, irq, IRQF_SHARED);
521 dev_err(&pdev->dev, "Failed to add USB HCD\n");
522 goto cleanup_otg_set_host;
524 device_wakeup_enable(hcd->self.controller);
528 cleanup_otg_set_host:
529 otg_set_host(u_phy->otg, NULL);
531 usb_phy_shutdown(hcd->usb_phy);
533 clk_disable_unprepare(tegra->clk);
539 static int tegra_ehci_remove(struct platform_device *pdev)
541 struct usb_hcd *hcd = platform_get_drvdata(pdev);
542 struct tegra_ehci_hcd *tegra =
543 (struct tegra_ehci_hcd *)hcd_to_ehci(hcd)->priv;
545 otg_set_host(hcd->usb_phy->otg, NULL);
547 usb_phy_shutdown(hcd->usb_phy);
550 clk_disable_unprepare(tegra->clk);
557 static void tegra_ehci_hcd_shutdown(struct platform_device *pdev)
559 struct usb_hcd *hcd = platform_get_drvdata(pdev);
561 if (hcd->driver->shutdown)
562 hcd->driver->shutdown(hcd);
565 static struct platform_driver tegra_ehci_driver = {
566 .probe = tegra_ehci_probe,
567 .remove = tegra_ehci_remove,
568 .shutdown = tegra_ehci_hcd_shutdown,
571 .of_match_table = tegra_ehci_of_match,
575 static int tegra_ehci_reset(struct usb_hcd *hcd)
577 struct ehci_hcd *ehci = hcd_to_ehci(hcd);
581 retval = ehci_setup(hcd);
586 * We should really pull this value out of tegra_ehci_soc_config, but
587 * to avoid needing access to it, make use of the fact that Tegra20 is
588 * the only one so far that needs a value of 10, and Tegra20 is the
589 * only one which doesn't set has_hostpc.
591 txfifothresh = ehci->has_hostpc ? 0x10 : 10;
592 ehci_writel(ehci, txfifothresh << 16, &ehci->regs->txfill_tuning);
597 static const struct ehci_driver_overrides tegra_overrides __initconst = {
598 .extra_priv_size = sizeof(struct tegra_ehci_hcd),
599 .reset = tegra_ehci_reset,
602 static int __init ehci_tegra_init(void)
607 pr_info(DRV_NAME ": " DRIVER_DESC "\n");
609 ehci_init_driver(&tegra_ehci_hc_driver, &tegra_overrides);
612 * The Tegra HW has some unusual quirks, which require Tegra-specific
613 * workarounds. We override certain hc_driver functions here to
614 * achieve that. We explicitly do not enhance ehci_driver_overrides to
615 * allow this more easily, since this is an unusual case, and we don't
616 * want to encourage others to override these functions by making it
620 tegra_ehci_hc_driver.map_urb_for_dma = tegra_ehci_map_urb_for_dma;
621 tegra_ehci_hc_driver.unmap_urb_for_dma = tegra_ehci_unmap_urb_for_dma;
622 tegra_ehci_hc_driver.hub_control = tegra_ehci_hub_control;
624 return platform_driver_register(&tegra_ehci_driver);
626 module_init(ehci_tegra_init);
628 static void __exit ehci_tegra_cleanup(void)
630 platform_driver_unregister(&tegra_ehci_driver);
632 module_exit(ehci_tegra_cleanup);
634 MODULE_DESCRIPTION(DRIVER_DESC);
635 MODULE_LICENSE("GPL");
636 MODULE_ALIAS("platform:" DRV_NAME);
637 MODULE_DEVICE_TABLE(of, tegra_ehci_of_match);