1 // SPDX-License-Identifier: GPL-1.0+
3 * OHCI HCD (Host Controller Driver) for USB.
5 * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at>
6 * (C) Copyright 2000-2005 David Brownell
7 * (C) Copyright 2002 Hewlett-Packard Company
11 * Modified for OMAP by Tony Lindgren <tony@atomide.com>
12 * Based on the 2.4 OMAP OHCI driver originally done by MontaVista Software Inc.
13 * and on ohci-sa1111.c by Christopher Hoover <ch@hpl.hp.com>
15 * This file is licenced under the GPL.
18 #include <linux/clk.h>
19 #include <linux/dma-mapping.h>
20 #include <linux/err.h>
21 #include <linux/gpio/consumer.h>
23 #include <linux/jiffies.h>
24 #include <linux/kernel.h>
25 #include <linux/module.h>
26 #include <linux/usb/otg.h>
27 #include <linux/platform_device.h>
28 #include <linux/platform_data/usb-omap1.h>
29 #include <linux/soc/ti/omap1-usb.h>
30 #include <linux/soc/ti/omap1-mux.h>
31 #include <linux/soc/ti/omap1-soc.h>
32 #include <linux/soc/ti/omap1-io.h>
33 #include <linux/signal.h>
34 #include <linux/usb.h>
35 #include <linux/usb/hcd.h>
40 #include <asm/mach-types.h>
42 #define DRIVER_DESC "OHCI OMAP driver"
44 struct ohci_omap_priv {
45 struct clk *usb_host_ck;
46 struct clk *usb_dc_ck;
47 struct gpio_desc *power;
48 struct gpio_desc *overcurrent;
51 static const char hcd_name[] = "ohci-omap";
52 static struct hc_driver __read_mostly ohci_omap_hc_driver;
54 #define hcd_to_ohci_omap_priv(h) \
55 ((struct ohci_omap_priv *)hcd_to_ohci(h)->priv)
57 static void omap_ohci_clock_power(struct ohci_omap_priv *priv, int on)
60 clk_enable(priv->usb_dc_ck);
61 clk_enable(priv->usb_host_ck);
62 /* guesstimate for T5 == 1x 32K clock + APLL lock time */
65 clk_disable(priv->usb_host_ck);
66 clk_disable(priv->usb_dc_ck);
72 static void start_hnp(struct ohci_hcd *ohci)
74 struct usb_hcd *hcd = ohci_to_hcd(ohci);
75 const unsigned port = hcd->self.otg_port - 1;
79 otg_start_hnp(hcd->usb_phy->otg);
81 local_irq_save(flags);
82 hcd->usb_phy->otg->state = OTG_STATE_A_SUSPEND;
83 writel (RH_PS_PSS, &ohci->regs->roothub.portstatus [port]);
84 l = omap_readl(OTG_CTRL);
86 omap_writel(l, OTG_CTRL);
87 local_irq_restore(flags);
92 /*-------------------------------------------------------------------------*/
94 static int ohci_omap_reset(struct usb_hcd *hcd)
96 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
97 struct omap_usb_config *config = dev_get_platdata(hcd->self.controller);
98 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
99 int need_transceiver = (config->otg != 0);
102 dev_dbg(hcd->self.controller, "starting USB Controller\n");
105 hcd->self.otg_port = config->otg;
106 /* default/minimum OTG power budget: 8 mA */
107 hcd->power_budget = 8;
110 /* boards can use OTG transceivers in non-OTG modes */
111 need_transceiver = need_transceiver
112 || machine_is_omap_h2() || machine_is_omap_h3();
114 /* XXX OMAP16xx only */
115 if (config->ocpi_enable)
116 config->ocpi_enable();
118 #ifdef CONFIG_USB_OTG
119 if (need_transceiver) {
120 hcd->usb_phy = usb_get_phy(USB_PHY_TYPE_USB2);
121 if (!IS_ERR_OR_NULL(hcd->usb_phy)) {
122 int status = otg_set_host(hcd->usb_phy->otg,
123 &ohci_to_hcd(ohci)->self);
124 dev_dbg(hcd->self.controller, "init %s phy, status %d\n",
125 hcd->usb_phy->label, status);
127 usb_put_phy(hcd->usb_phy);
131 return -EPROBE_DEFER;
133 hcd->skip_phy_initialization = 1;
134 ohci->start_hnp = start_hnp;
138 omap_ohci_clock_power(priv, 1);
140 if (config->lb_reset)
143 ret = ohci_setup(hcd);
147 if (config->otg || config->rwc) {
148 ohci->hc_control = OHCI_CTRL_RWC;
149 writel(OHCI_CTRL_RWC, &ohci->regs->control);
152 /* board-specific power switching and overcurrent support */
153 if (machine_is_omap_osk() || machine_is_omap_innovator()) {
154 u32 rh = roothub_a (ohci);
156 /* power switching (ganged by default) */
159 /* TPS2045 switch for internal transceiver (port 1) */
160 if (machine_is_omap_osk()) {
161 ohci_to_hcd(ohci)->power_budget = 250;
165 /* gpio9 for overcurrent detction */
166 omap_cfg_reg(W8_1610_GPIO9);
168 /* for paranoia's sake: disable USB.PUEN */
169 omap_cfg_reg(W4_USB_HIGHZ);
171 ohci_writel(ohci, rh, &ohci->regs->roothub.a);
172 ohci->flags &= ~OHCI_QUIRK_HUB_POWER;
173 } else if (machine_is_nokia770()) {
174 /* We require a self-powered hub, which should have
175 * plenty of power. */
176 ohci_to_hcd(ohci)->power_budget = 0;
179 /* FIXME hub_wq hub requests should manage power switching */
180 if (config->transceiver_power)
181 return config->transceiver_power(1);
184 gpiod_set_value_cansleep(priv->power, 0);
186 /* board init will have already handled HMC and mux setup.
187 * any external transceiver should already be initialized
188 * too, so all configured ports use the right signaling now.
194 /*-------------------------------------------------------------------------*/
197 * ohci_hcd_omap_probe - initialize OMAP-based HCDs
198 * @pdev: USB controller to probe
200 * Context: task context, might sleep
202 * Allocates basic resources for this USB host controller, and
203 * then invokes the start() method for the HCD associated with it
204 * through the hotplug entry's driver_data.
206 static int ohci_hcd_omap_probe(struct platform_device *pdev)
209 struct usb_hcd *hcd = 0;
210 struct ohci_omap_priv *priv;
212 if (pdev->num_resources != 2) {
213 dev_err(&pdev->dev, "invalid num_resources: %i\n",
214 pdev->num_resources);
218 if (pdev->resource[0].flags != IORESOURCE_MEM
219 || pdev->resource[1].flags != IORESOURCE_IRQ) {
220 dev_err(&pdev->dev, "invalid resource type\n");
224 hcd = usb_create_hcd(&ohci_omap_hc_driver, &pdev->dev,
225 dev_name(&pdev->dev));
229 hcd->rsrc_start = pdev->resource[0].start;
230 hcd->rsrc_len = pdev->resource[0].end - pdev->resource[0].start + 1;
231 priv = hcd_to_ohci_omap_priv(hcd);
233 /* Obtain two optional GPIO lines */
234 priv->power = devm_gpiod_get_optional(&pdev->dev, "power", GPIOD_ASIS);
235 if (IS_ERR(priv->power)) {
236 retval = PTR_ERR(priv->power);
240 gpiod_set_consumer_name(priv->power, "OHCI power");
243 * This "overcurrent" GPIO line isn't really used in the code,
244 * but has a designated hardware function.
245 * TODO: implement proper overcurrent handling.
247 priv->overcurrent = devm_gpiod_get_optional(&pdev->dev, "overcurrent",
249 if (IS_ERR(priv->overcurrent)) {
250 retval = PTR_ERR(priv->overcurrent);
253 if (priv->overcurrent)
254 gpiod_set_consumer_name(priv->overcurrent, "OHCI overcurrent");
256 priv->usb_host_ck = clk_get(&pdev->dev, "usb_hhc_ck");
257 if (IS_ERR(priv->usb_host_ck)) {
258 retval = PTR_ERR(priv->usb_host_ck);
262 retval = clk_prepare(priv->usb_host_ck);
264 goto err_put_host_ck;
266 if (!cpu_is_omap15xx())
267 priv->usb_dc_ck = clk_get(&pdev->dev, "usb_dc_ck");
269 priv->usb_dc_ck = clk_get(&pdev->dev, "lb_ck");
271 if (IS_ERR(priv->usb_dc_ck)) {
272 retval = PTR_ERR(priv->usb_dc_ck);
273 goto err_unprepare_host_ck;
276 retval = clk_prepare(priv->usb_dc_ck);
280 if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len, hcd_name)) {
281 dev_dbg(&pdev->dev, "request_mem_region failed\n");
283 goto err_unprepare_dc_ck;
286 hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);
288 dev_err(&pdev->dev, "can't ioremap OHCI HCD\n");
293 irq = platform_get_irq(pdev, 0);
298 retval = usb_add_hcd(hcd, irq, 0);
302 device_wakeup_enable(hcd->self.controller);
307 release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
309 clk_unprepare(priv->usb_dc_ck);
311 clk_put(priv->usb_dc_ck);
312 err_unprepare_host_ck:
313 clk_unprepare(priv->usb_host_ck);
315 clk_put(priv->usb_host_ck);
322 /* may be called with controller, bus, and devices active */
325 * ohci_hcd_omap_remove - shutdown processing for OMAP-based HCDs
326 * @pdev: USB Host Controller being removed
328 * Context: task context, might sleep
330 * Reverses the effect of ohci_hcd_omap_probe(), first invoking
331 * the HCD's stop() method. It is always called from a thread
332 * context, normally "rmmod", "apmd", or something similar.
334 static int ohci_hcd_omap_remove(struct platform_device *pdev)
336 struct usb_hcd *hcd = platform_get_drvdata(pdev);
337 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
339 dev_dbg(hcd->self.controller, "stopping USB Controller\n");
341 omap_ohci_clock_power(priv, 0);
342 if (!IS_ERR_OR_NULL(hcd->usb_phy)) {
343 (void) otg_set_host(hcd->usb_phy->otg, 0);
344 usb_put_phy(hcd->usb_phy);
347 release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
348 clk_unprepare(priv->usb_dc_ck);
349 clk_put(priv->usb_dc_ck);
350 clk_unprepare(priv->usb_host_ck);
351 clk_put(priv->usb_host_ck);
356 /*-------------------------------------------------------------------------*/
360 static int ohci_omap_suspend(struct platform_device *pdev, pm_message_t message)
362 struct usb_hcd *hcd = platform_get_drvdata(pdev);
363 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
364 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
365 bool do_wakeup = device_may_wakeup(&pdev->dev);
368 if (time_before(jiffies, ohci->next_statechange))
370 ohci->next_statechange = jiffies;
372 ret = ohci_suspend(hcd, do_wakeup);
376 omap_ohci_clock_power(priv, 0);
380 static int ohci_omap_resume(struct platform_device *dev)
382 struct usb_hcd *hcd = platform_get_drvdata(dev);
383 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
384 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
386 if (time_before(jiffies, ohci->next_statechange))
388 ohci->next_statechange = jiffies;
390 omap_ohci_clock_power(priv, 1);
391 ohci_resume(hcd, false);
397 /*-------------------------------------------------------------------------*/
400 * Driver definition to register with the OMAP bus
402 static struct platform_driver ohci_hcd_omap_driver = {
403 .probe = ohci_hcd_omap_probe,
404 .remove = ohci_hcd_omap_remove,
405 .shutdown = usb_hcd_platform_shutdown,
407 .suspend = ohci_omap_suspend,
408 .resume = ohci_omap_resume,
415 static const struct ohci_driver_overrides omap_overrides __initconst = {
416 .product_desc = "OMAP OHCI",
417 .reset = ohci_omap_reset,
418 .extra_priv_size = sizeof(struct ohci_omap_priv),
421 static int __init ohci_omap_init(void)
426 pr_info("%s: " DRIVER_DESC "\n", hcd_name);
428 ohci_init_driver(&ohci_omap_hc_driver, &omap_overrides);
429 return platform_driver_register(&ohci_hcd_omap_driver);
431 module_init(ohci_omap_init);
433 static void __exit ohci_omap_cleanup(void)
435 platform_driver_unregister(&ohci_hcd_omap_driver);
437 module_exit(ohci_omap_cleanup);
439 MODULE_DESCRIPTION(DRIVER_DESC);
440 MODULE_ALIAS("platform:ohci");
441 MODULE_LICENSE("GPL");