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);
70 static void start_hnp(struct ohci_hcd *ohci)
72 struct usb_hcd *hcd = ohci_to_hcd(ohci);
73 const unsigned port = hcd->self.otg_port - 1;
77 otg_start_hnp(hcd->usb_phy->otg);
79 local_irq_save(flags);
80 hcd->usb_phy->otg->state = OTG_STATE_A_SUSPEND;
81 writel (RH_PS_PSS, &ohci->regs->roothub.portstatus [port]);
82 l = omap_readl(OTG_CTRL);
84 omap_writel(l, OTG_CTRL);
85 local_irq_restore(flags);
88 /*-------------------------------------------------------------------------*/
90 static int ohci_omap_reset(struct usb_hcd *hcd)
92 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
93 struct omap_usb_config *config = dev_get_platdata(hcd->self.controller);
94 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
95 int need_transceiver = (config->otg != 0);
98 dev_dbg(hcd->self.controller, "starting USB Controller\n");
101 hcd->self.otg_port = config->otg;
102 /* default/minimum OTG power budget: 8 mA */
103 hcd->power_budget = 8;
106 /* XXX OMAP16xx only */
107 if (config->ocpi_enable)
108 config->ocpi_enable();
110 if (IS_ENABLED(CONFIG_USB_OTG) && need_transceiver) {
111 hcd->usb_phy = usb_get_phy(USB_PHY_TYPE_USB2);
112 if (!IS_ERR_OR_NULL(hcd->usb_phy)) {
113 int status = otg_set_host(hcd->usb_phy->otg,
114 &ohci_to_hcd(ohci)->self);
115 dev_dbg(hcd->self.controller, "init %s phy, status %d\n",
116 hcd->usb_phy->label, status);
118 usb_put_phy(hcd->usb_phy);
122 return -EPROBE_DEFER;
124 hcd->skip_phy_initialization = 1;
125 ohci->start_hnp = start_hnp;
128 omap_ohci_clock_power(priv, 1);
130 if (config->lb_reset)
133 ret = ohci_setup(hcd);
137 if (config->otg || config->rwc) {
138 ohci->hc_control = OHCI_CTRL_RWC;
139 writel(OHCI_CTRL_RWC, &ohci->regs->control);
142 /* board-specific power switching and overcurrent support */
143 if (machine_is_omap_osk()) {
144 u32 rh = roothub_a (ohci);
146 /* power switching (ganged by default) */
149 /* TPS2045 switch for internal transceiver (port 1) */
150 if (machine_is_omap_osk()) {
151 ohci_to_hcd(ohci)->power_budget = 250;
155 /* gpio9 for overcurrent detction */
156 omap_cfg_reg(W8_1610_GPIO9);
158 /* for paranoia's sake: disable USB.PUEN */
159 omap_cfg_reg(W4_USB_HIGHZ);
161 ohci_writel(ohci, rh, &ohci->regs->roothub.a);
162 ohci->flags &= ~OHCI_QUIRK_HUB_POWER;
163 } else if (machine_is_nokia770()) {
164 /* We require a self-powered hub, which should have
165 * plenty of power. */
166 ohci_to_hcd(ohci)->power_budget = 0;
169 /* FIXME hub_wq hub requests should manage power switching */
170 if (config->transceiver_power)
171 return config->transceiver_power(1);
174 gpiod_set_value_cansleep(priv->power, 0);
176 /* board init will have already handled HMC and mux setup.
177 * any external transceiver should already be initialized
178 * too, so all configured ports use the right signaling now.
184 /*-------------------------------------------------------------------------*/
187 * ohci_hcd_omap_probe - initialize OMAP-based HCDs
188 * @pdev: USB controller to probe
190 * Context: task context, might sleep
192 * Allocates basic resources for this USB host controller, and
193 * then invokes the start() method for the HCD associated with it
194 * through the hotplug entry's driver_data.
196 static int ohci_hcd_omap_probe(struct platform_device *pdev)
199 struct usb_hcd *hcd = 0;
200 struct ohci_omap_priv *priv;
202 if (pdev->num_resources != 2) {
203 dev_err(&pdev->dev, "invalid num_resources: %i\n",
204 pdev->num_resources);
208 if (pdev->resource[0].flags != IORESOURCE_MEM
209 || pdev->resource[1].flags != IORESOURCE_IRQ) {
210 dev_err(&pdev->dev, "invalid resource type\n");
214 hcd = usb_create_hcd(&ohci_omap_hc_driver, &pdev->dev,
215 dev_name(&pdev->dev));
219 hcd->rsrc_start = pdev->resource[0].start;
220 hcd->rsrc_len = pdev->resource[0].end - pdev->resource[0].start + 1;
221 priv = hcd_to_ohci_omap_priv(hcd);
223 /* Obtain two optional GPIO lines */
224 priv->power = devm_gpiod_get_optional(&pdev->dev, "power", GPIOD_ASIS);
225 if (IS_ERR(priv->power)) {
226 retval = PTR_ERR(priv->power);
230 gpiod_set_consumer_name(priv->power, "OHCI power");
233 * This "overcurrent" GPIO line isn't really used in the code,
234 * but has a designated hardware function.
235 * TODO: implement proper overcurrent handling.
237 priv->overcurrent = devm_gpiod_get_optional(&pdev->dev, "overcurrent",
239 if (IS_ERR(priv->overcurrent)) {
240 retval = PTR_ERR(priv->overcurrent);
243 if (priv->overcurrent)
244 gpiod_set_consumer_name(priv->overcurrent, "OHCI overcurrent");
246 priv->usb_host_ck = clk_get(&pdev->dev, "usb_hhc_ck");
247 if (IS_ERR(priv->usb_host_ck)) {
248 retval = PTR_ERR(priv->usb_host_ck);
252 retval = clk_prepare(priv->usb_host_ck);
254 goto err_put_host_ck;
256 if (!cpu_is_omap15xx())
257 priv->usb_dc_ck = clk_get(&pdev->dev, "usb_dc_ck");
259 priv->usb_dc_ck = clk_get(&pdev->dev, "lb_ck");
261 if (IS_ERR(priv->usb_dc_ck)) {
262 retval = PTR_ERR(priv->usb_dc_ck);
263 goto err_unprepare_host_ck;
266 retval = clk_prepare(priv->usb_dc_ck);
270 if (!request_mem_region(hcd->rsrc_start, hcd->rsrc_len, hcd_name)) {
271 dev_dbg(&pdev->dev, "request_mem_region failed\n");
273 goto err_unprepare_dc_ck;
276 hcd->regs = ioremap(hcd->rsrc_start, hcd->rsrc_len);
278 dev_err(&pdev->dev, "can't ioremap OHCI HCD\n");
283 irq = platform_get_irq(pdev, 0);
288 retval = usb_add_hcd(hcd, irq, 0);
292 device_wakeup_enable(hcd->self.controller);
297 release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
299 clk_unprepare(priv->usb_dc_ck);
301 clk_put(priv->usb_dc_ck);
302 err_unprepare_host_ck:
303 clk_unprepare(priv->usb_host_ck);
305 clk_put(priv->usb_host_ck);
312 /* may be called with controller, bus, and devices active */
315 * ohci_hcd_omap_remove - shutdown processing for OMAP-based HCDs
316 * @pdev: USB Host Controller being removed
318 * Context: task context, might sleep
320 * Reverses the effect of ohci_hcd_omap_probe(), first invoking
321 * the HCD's stop() method. It is always called from a thread
322 * context, normally "rmmod", "apmd", or something similar.
324 static void ohci_hcd_omap_remove(struct platform_device *pdev)
326 struct usb_hcd *hcd = platform_get_drvdata(pdev);
327 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
329 dev_dbg(hcd->self.controller, "stopping USB Controller\n");
331 omap_ohci_clock_power(priv, 0);
332 if (!IS_ERR_OR_NULL(hcd->usb_phy)) {
333 (void) otg_set_host(hcd->usb_phy->otg, 0);
334 usb_put_phy(hcd->usb_phy);
337 release_mem_region(hcd->rsrc_start, hcd->rsrc_len);
338 clk_unprepare(priv->usb_dc_ck);
339 clk_put(priv->usb_dc_ck);
340 clk_unprepare(priv->usb_host_ck);
341 clk_put(priv->usb_host_ck);
345 /*-------------------------------------------------------------------------*/
349 static int ohci_omap_suspend(struct platform_device *pdev, pm_message_t message)
351 struct usb_hcd *hcd = platform_get_drvdata(pdev);
352 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
353 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
354 bool do_wakeup = device_may_wakeup(&pdev->dev);
357 if (time_before(jiffies, ohci->next_statechange))
359 ohci->next_statechange = jiffies;
361 ret = ohci_suspend(hcd, do_wakeup);
365 omap_ohci_clock_power(priv, 0);
369 static int ohci_omap_resume(struct platform_device *dev)
371 struct usb_hcd *hcd = platform_get_drvdata(dev);
372 struct ohci_hcd *ohci = hcd_to_ohci(hcd);
373 struct ohci_omap_priv *priv = hcd_to_ohci_omap_priv(hcd);
375 if (time_before(jiffies, ohci->next_statechange))
377 ohci->next_statechange = jiffies;
379 omap_ohci_clock_power(priv, 1);
380 ohci_resume(hcd, false);
386 /*-------------------------------------------------------------------------*/
389 * Driver definition to register with the OMAP bus
391 static struct platform_driver ohci_hcd_omap_driver = {
392 .probe = ohci_hcd_omap_probe,
393 .remove_new = ohci_hcd_omap_remove,
394 .shutdown = usb_hcd_platform_shutdown,
396 .suspend = ohci_omap_suspend,
397 .resume = ohci_omap_resume,
404 static const struct ohci_driver_overrides omap_overrides __initconst = {
405 .product_desc = "OMAP OHCI",
406 .reset = ohci_omap_reset,
407 .extra_priv_size = sizeof(struct ohci_omap_priv),
410 static int __init ohci_omap_init(void)
415 ohci_init_driver(&ohci_omap_hc_driver, &omap_overrides);
416 return platform_driver_register(&ohci_hcd_omap_driver);
418 module_init(ohci_omap_init);
420 static void __exit ohci_omap_cleanup(void)
422 platform_driver_unregister(&ohci_hcd_omap_driver);
424 module_exit(ohci_omap_cleanup);
426 MODULE_DESCRIPTION(DRIVER_DESC);
427 MODULE_ALIAS("platform:ohci");
428 MODULE_LICENSE("GPL");