1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Generic platform ehci driver
4 *
5 * Copyright 2007 Steven Brown <sbrown@cortland.com>
6 * Copyright 2010-2012 Hauke Mehrtens <hauke@hauke-m.de>
7 * Copyright 2014 Hans de Goede <hdegoede@redhat.com>
8 *
9 * Derived from the ohci-ssb driver
10 * Copyright 2007 Michael Buesch <m@bues.ch>
11 *
12 * Derived from the EHCI-PCI driver
13 * Copyright (c) 2000-2004 by David Brownell
14 *
15 * Derived from the ohci-pci driver
16 * Copyright 1999 Roman Weissgaerber
17 * Copyright 2000-2002 David Brownell
18 * Copyright 1999 Linus Torvalds
19 * Copyright 1999 Gregory P. Smith
20 */
21 #include <linux/acpi.h>
22 #include <linux/clk.h>
23 #include <linux/dma-mapping.h>
24 #include <linux/err.h>
25 #include <linux/kernel.h>
26 #include <linux/hrtimer.h>
27 #include <linux/io.h>
28 #include <linux/module.h>
29 #include <linux/of.h>
30 #include <linux/platform_device.h>
31 #include <linux/reset.h>
32 #include <linux/sys_soc.h>
33 #include <linux/timer.h>
34 #include <linux/usb.h>
35 #include <linux/usb/hcd.h>
36 #include <linux/usb/ehci_pdriver.h>
37 #include <linux/usb/of.h>
38
39 #include "ehci.h"
40
41 #define DRIVER_DESC "EHCI generic platform driver"
42 #define EHCI_MAX_CLKS 4
43 #define hcd_to_ehci_priv(h) ((struct ehci_platform_priv *)hcd_to_ehci(h)->priv)
44
45 #define BCM_USB_FIFO_THRESHOLD 0x00800040
46
47 struct ehci_platform_priv {
48 struct clk *clks[EHCI_MAX_CLKS];
49 struct reset_control *rsts;
50 bool reset_on_resume;
51 bool quirk_poll;
52 struct timer_list poll_timer;
53 struct delayed_work poll_work;
54 };
55
56 static const char hcd_name[] = "ehci-platform";
57
ehci_platform_reset(struct usb_hcd * hcd)58 static int ehci_platform_reset(struct usb_hcd *hcd)
59 {
60 struct platform_device *pdev = to_platform_device(hcd->self.controller);
61 struct usb_ehci_pdata *pdata = dev_get_platdata(&pdev->dev);
62 struct ehci_hcd *ehci = hcd_to_ehci(hcd);
63 int retval;
64
65 ehci->has_synopsys_hc_bug = pdata->has_synopsys_hc_bug;
66
67 if (pdata->pre_setup) {
68 retval = pdata->pre_setup(hcd);
69 if (retval < 0)
70 return retval;
71 }
72
73 ehci->caps = hcd->regs + pdata->caps_offset;
74 retval = ehci_setup(hcd);
75 if (retval)
76 return retval;
77
78 if (pdata->no_io_watchdog)
79 ehci->need_io_watchdog = 0;
80
81 if (of_device_is_compatible(pdev->dev.of_node, "brcm,xgs-iproc-ehci"))
82 ehci_writel(ehci, BCM_USB_FIFO_THRESHOLD,
83 &ehci->regs->brcm_insnreg[1]);
84
85 return 0;
86 }
87
ehci_platform_power_on(struct platform_device * dev)88 static int ehci_platform_power_on(struct platform_device *dev)
89 {
90 struct usb_hcd *hcd = platform_get_drvdata(dev);
91 struct ehci_platform_priv *priv = hcd_to_ehci_priv(hcd);
92 int clk, ret;
93
94 for (clk = 0; clk < EHCI_MAX_CLKS && priv->clks[clk]; clk++) {
95 ret = clk_prepare_enable(priv->clks[clk]);
96 if (ret)
97 goto err_disable_clks;
98 }
99
100 return 0;
101
102 err_disable_clks:
103 while (--clk >= 0)
104 clk_disable_unprepare(priv->clks[clk]);
105
106 return ret;
107 }
108
ehci_platform_power_off(struct platform_device * dev)109 static void ehci_platform_power_off(struct platform_device *dev)
110 {
111 struct usb_hcd *hcd = platform_get_drvdata(dev);
112 struct ehci_platform_priv *priv = hcd_to_ehci_priv(hcd);
113 int clk;
114
115 for (clk = EHCI_MAX_CLKS - 1; clk >= 0; clk--)
116 if (priv->clks[clk])
117 clk_disable_unprepare(priv->clks[clk]);
118 }
119
120 static struct hc_driver __read_mostly ehci_platform_hc_driver;
121
122 static const struct ehci_driver_overrides platform_overrides __initconst = {
123 .reset = ehci_platform_reset,
124 .extra_priv_size = sizeof(struct ehci_platform_priv),
125 };
126
127 static struct usb_ehci_pdata ehci_platform_defaults = {
128 .power_on = ehci_platform_power_on,
129 .power_suspend = ehci_platform_power_off,
130 .power_off = ehci_platform_power_off,
131 };
132
133 /**
134 * quirk_poll_check_port_status - Poll port_status if the device sticks
135 * @ehci: the ehci hcd pointer
136 *
137 * Since EHCI/OHCI controllers on R-Car Gen3 SoCs are possible to be getting
138 * stuck very rarely after a full/low usb device was disconnected. To
139 * detect such a situation, the controllers require a special way which poll
140 * the EHCI PORTSC register.
141 *
142 * Return: true if the controller's port_status indicated getting stuck
143 */
quirk_poll_check_port_status(struct ehci_hcd * ehci)144 static bool quirk_poll_check_port_status(struct ehci_hcd *ehci)
145 {
146 u32 port_status = ehci_readl(ehci, &ehci->regs->port_status[0]);
147
148 if (!(port_status & PORT_OWNER) &&
149 (port_status & PORT_POWER) &&
150 !(port_status & PORT_CONNECT) &&
151 (port_status & PORT_LS_MASK))
152 return true;
153
154 return false;
155 }
156
157 /**
158 * quirk_poll_rebind_companion - rebind comanion device to recover
159 * @ehci: the ehci hcd pointer
160 *
161 * Since EHCI/OHCI controllers on R-Car Gen3 SoCs are possible to be getting
162 * stuck very rarely after a full/low usb device was disconnected. To
163 * recover from such a situation, the controllers require changing the OHCI
164 * functional state.
165 */
quirk_poll_rebind_companion(struct ehci_hcd * ehci)166 static void quirk_poll_rebind_companion(struct ehci_hcd *ehci)
167 {
168 struct device *companion_dev;
169 struct usb_hcd *hcd = ehci_to_hcd(ehci);
170
171 companion_dev = usb_of_get_companion_dev(hcd->self.controller);
172 if (!companion_dev)
173 return;
174
175 device_release_driver(companion_dev);
176 if (device_attach(companion_dev) < 0)
177 ehci_err(ehci, "%s: failed\n", __func__);
178
179 put_device(companion_dev);
180 }
181
quirk_poll_work(struct work_struct * work)182 static void quirk_poll_work(struct work_struct *work)
183 {
184 struct ehci_platform_priv *priv =
185 container_of(to_delayed_work(work), struct ehci_platform_priv,
186 poll_work);
187 struct ehci_hcd *ehci = container_of((void *)priv, struct ehci_hcd,
188 priv);
189
190 /* check the status twice to reduce misdetection rate */
191 if (!quirk_poll_check_port_status(ehci))
192 return;
193 udelay(10);
194 if (!quirk_poll_check_port_status(ehci))
195 return;
196
197 ehci_dbg(ehci, "%s: detected getting stuck. rebind now!\n", __func__);
198 quirk_poll_rebind_companion(ehci);
199 }
200
quirk_poll_timer(struct timer_list * t)201 static void quirk_poll_timer(struct timer_list *t)
202 {
203 struct ehci_platform_priv *priv = from_timer(priv, t, poll_timer);
204 struct ehci_hcd *ehci = container_of((void *)priv, struct ehci_hcd,
205 priv);
206
207 if (quirk_poll_check_port_status(ehci)) {
208 /*
209 * Now scheduling the work for testing the port more. Note that
210 * updating the status is possible to be delayed when
211 * reconnection. So, this uses delayed work with 5 ms delay
212 * to avoid misdetection.
213 */
214 schedule_delayed_work(&priv->poll_work, msecs_to_jiffies(5));
215 }
216
217 mod_timer(&priv->poll_timer, jiffies + HZ);
218 }
219
quirk_poll_init(struct ehci_platform_priv * priv)220 static void quirk_poll_init(struct ehci_platform_priv *priv)
221 {
222 INIT_DELAYED_WORK(&priv->poll_work, quirk_poll_work);
223 timer_setup(&priv->poll_timer, quirk_poll_timer, 0);
224 mod_timer(&priv->poll_timer, jiffies + HZ);
225 }
226
quirk_poll_end(struct ehci_platform_priv * priv)227 static void quirk_poll_end(struct ehci_platform_priv *priv)
228 {
229 del_timer_sync(&priv->poll_timer);
230 cancel_delayed_work(&priv->poll_work);
231 }
232
233 static const struct soc_device_attribute quirk_poll_match[] = {
234 { .family = "R-Car Gen3" },
235 { /* sentinel*/ }
236 };
237
ehci_platform_probe(struct platform_device * dev)238 static int ehci_platform_probe(struct platform_device *dev)
239 {
240 struct usb_hcd *hcd;
241 struct resource *res_mem;
242 struct usb_ehci_pdata *pdata = dev_get_platdata(&dev->dev);
243 struct ehci_platform_priv *priv;
244 struct ehci_hcd *ehci;
245 int err, irq, clk = 0;
246
247 if (usb_disabled())
248 return -ENODEV;
249
250 /*
251 * Use reasonable defaults so platforms don't have to provide these
252 * with DT probing on ARM.
253 */
254 if (!pdata)
255 pdata = &ehci_platform_defaults;
256
257 err = dma_coerce_mask_and_coherent(&dev->dev,
258 pdata->dma_mask_64 ? DMA_BIT_MASK(64) : DMA_BIT_MASK(32));
259 if (err) {
260 dev_err(&dev->dev, "Error: DMA mask configuration failed\n");
261 return err;
262 }
263
264 irq = platform_get_irq(dev, 0);
265 if (irq < 0)
266 return irq;
267
268 hcd = usb_create_hcd(&ehci_platform_hc_driver, &dev->dev,
269 dev_name(&dev->dev));
270 if (!hcd)
271 return -ENOMEM;
272
273 platform_set_drvdata(dev, hcd);
274 dev->dev.platform_data = pdata;
275 priv = hcd_to_ehci_priv(hcd);
276 ehci = hcd_to_ehci(hcd);
277
278 if (pdata == &ehci_platform_defaults && dev->dev.of_node) {
279 if (of_property_read_bool(dev->dev.of_node, "big-endian-regs"))
280 ehci->big_endian_mmio = 1;
281
282 if (of_property_read_bool(dev->dev.of_node, "big-endian-desc"))
283 ehci->big_endian_desc = 1;
284
285 if (of_property_read_bool(dev->dev.of_node, "big-endian"))
286 ehci->big_endian_mmio = ehci->big_endian_desc = 1;
287
288 if (of_property_read_bool(dev->dev.of_node, "spurious-oc"))
289 ehci->spurious_oc = 1;
290
291 if (of_property_read_bool(dev->dev.of_node,
292 "needs-reset-on-resume"))
293 priv->reset_on_resume = true;
294
295 if (of_property_read_bool(dev->dev.of_node,
296 "has-transaction-translator"))
297 hcd->has_tt = 1;
298
299 if (of_device_is_compatible(dev->dev.of_node,
300 "aspeed,ast2500-ehci") ||
301 of_device_is_compatible(dev->dev.of_node,
302 "aspeed,ast2600-ehci"))
303 ehci->is_aspeed = 1;
304
305 if (soc_device_match(quirk_poll_match))
306 priv->quirk_poll = true;
307
308 for (clk = 0; clk < EHCI_MAX_CLKS; clk++) {
309 priv->clks[clk] = of_clk_get(dev->dev.of_node, clk);
310 if (IS_ERR(priv->clks[clk])) {
311 err = PTR_ERR(priv->clks[clk]);
312 if (err == -EPROBE_DEFER)
313 goto err_put_clks;
314 priv->clks[clk] = NULL;
315 break;
316 }
317 }
318 }
319
320 priv->rsts = devm_reset_control_array_get_optional_shared(&dev->dev);
321 if (IS_ERR(priv->rsts)) {
322 err = PTR_ERR(priv->rsts);
323 goto err_put_clks;
324 }
325
326 err = reset_control_deassert(priv->rsts);
327 if (err)
328 goto err_put_clks;
329
330 if (pdata->big_endian_desc)
331 ehci->big_endian_desc = 1;
332 if (pdata->big_endian_mmio)
333 ehci->big_endian_mmio = 1;
334 if (pdata->has_tt)
335 hcd->has_tt = 1;
336 if (pdata->reset_on_resume)
337 priv->reset_on_resume = true;
338 if (pdata->spurious_oc)
339 ehci->spurious_oc = 1;
340
341 #ifndef CONFIG_USB_EHCI_BIG_ENDIAN_MMIO
342 if (ehci->big_endian_mmio) {
343 dev_err(&dev->dev,
344 "Error: CONFIG_USB_EHCI_BIG_ENDIAN_MMIO not set\n");
345 err = -EINVAL;
346 goto err_reset;
347 }
348 #endif
349 #ifndef CONFIG_USB_EHCI_BIG_ENDIAN_DESC
350 if (ehci->big_endian_desc) {
351 dev_err(&dev->dev,
352 "Error: CONFIG_USB_EHCI_BIG_ENDIAN_DESC not set\n");
353 err = -EINVAL;
354 goto err_reset;
355 }
356 #endif
357
358 if (pdata->power_on) {
359 err = pdata->power_on(dev);
360 if (err < 0)
361 goto err_reset;
362 }
363
364 res_mem = platform_get_resource(dev, IORESOURCE_MEM, 0);
365 hcd->regs = devm_ioremap_resource(&dev->dev, res_mem);
366 if (IS_ERR(hcd->regs)) {
367 err = PTR_ERR(hcd->regs);
368 goto err_power;
369 }
370 hcd->rsrc_start = res_mem->start;
371 hcd->rsrc_len = resource_size(res_mem);
372
373 err = usb_add_hcd(hcd, irq, IRQF_SHARED);
374 if (err)
375 goto err_power;
376
377 device_wakeup_enable(hcd->self.controller);
378 device_enable_async_suspend(hcd->self.controller);
379 platform_set_drvdata(dev, hcd);
380
381 if (priv->quirk_poll)
382 quirk_poll_init(priv);
383
384 return err;
385
386 err_power:
387 if (pdata->power_off)
388 pdata->power_off(dev);
389 err_reset:
390 reset_control_assert(priv->rsts);
391 err_put_clks:
392 while (--clk >= 0)
393 clk_put(priv->clks[clk]);
394
395 if (pdata == &ehci_platform_defaults)
396 dev->dev.platform_data = NULL;
397
398 usb_put_hcd(hcd);
399
400 return err;
401 }
402
ehci_platform_remove(struct platform_device * dev)403 static int ehci_platform_remove(struct platform_device *dev)
404 {
405 struct usb_hcd *hcd = platform_get_drvdata(dev);
406 struct usb_ehci_pdata *pdata = dev_get_platdata(&dev->dev);
407 struct ehci_platform_priv *priv = hcd_to_ehci_priv(hcd);
408 int clk;
409
410 if (priv->quirk_poll)
411 quirk_poll_end(priv);
412
413 usb_remove_hcd(hcd);
414
415 if (pdata->power_off)
416 pdata->power_off(dev);
417
418 reset_control_assert(priv->rsts);
419
420 for (clk = 0; clk < EHCI_MAX_CLKS && priv->clks[clk]; clk++)
421 clk_put(priv->clks[clk]);
422
423 usb_put_hcd(hcd);
424
425 if (pdata == &ehci_platform_defaults)
426 dev->dev.platform_data = NULL;
427
428 return 0;
429 }
430
ehci_platform_suspend(struct device * dev)431 static int __maybe_unused ehci_platform_suspend(struct device *dev)
432 {
433 struct usb_hcd *hcd = dev_get_drvdata(dev);
434 struct usb_ehci_pdata *pdata = dev_get_platdata(dev);
435 struct platform_device *pdev = to_platform_device(dev);
436 struct ehci_platform_priv *priv = hcd_to_ehci_priv(hcd);
437 bool do_wakeup = device_may_wakeup(dev);
438 int ret;
439
440 if (priv->quirk_poll)
441 quirk_poll_end(priv);
442
443 ret = ehci_suspend(hcd, do_wakeup);
444 if (ret)
445 return ret;
446
447 if (pdata->power_suspend)
448 pdata->power_suspend(pdev);
449
450 return ret;
451 }
452
ehci_platform_resume(struct device * dev)453 static int __maybe_unused ehci_platform_resume(struct device *dev)
454 {
455 struct usb_hcd *hcd = dev_get_drvdata(dev);
456 struct usb_ehci_pdata *pdata = dev_get_platdata(dev);
457 struct platform_device *pdev = to_platform_device(dev);
458 struct ehci_platform_priv *priv = hcd_to_ehci_priv(hcd);
459 struct device *companion_dev;
460
461 if (pdata->power_on) {
462 int err = pdata->power_on(pdev);
463 if (err < 0)
464 return err;
465 }
466
467 companion_dev = usb_of_get_companion_dev(hcd->self.controller);
468 if (companion_dev) {
469 device_pm_wait_for_dev(hcd->self.controller, companion_dev);
470 put_device(companion_dev);
471 }
472
473 ehci_resume(hcd, priv->reset_on_resume);
474
475 pm_runtime_disable(dev);
476 pm_runtime_set_active(dev);
477 pm_runtime_enable(dev);
478
479 if (priv->quirk_poll)
480 quirk_poll_init(priv);
481
482 return 0;
483 }
484
485 static const struct of_device_id vt8500_ehci_ids[] = {
486 { .compatible = "via,vt8500-ehci", },
487 { .compatible = "wm,prizm-ehci", },
488 { .compatible = "generic-ehci", },
489 { .compatible = "cavium,octeon-6335-ehci", },
490 {}
491 };
492 MODULE_DEVICE_TABLE(of, vt8500_ehci_ids);
493
494 #ifdef CONFIG_ACPI
495 static const struct acpi_device_id ehci_acpi_match[] = {
496 { "PNP0D20", 0 }, /* EHCI controller without debug */
497 { }
498 };
499 MODULE_DEVICE_TABLE(acpi, ehci_acpi_match);
500 #endif
501
502 static const struct platform_device_id ehci_platform_table[] = {
503 { "ehci-platform", 0 },
504 { }
505 };
506 MODULE_DEVICE_TABLE(platform, ehci_platform_table);
507
508 static SIMPLE_DEV_PM_OPS(ehci_platform_pm_ops, ehci_platform_suspend,
509 ehci_platform_resume);
510
511 static struct platform_driver ehci_platform_driver = {
512 .id_table = ehci_platform_table,
513 .probe = ehci_platform_probe,
514 .remove = ehci_platform_remove,
515 .shutdown = usb_hcd_platform_shutdown,
516 .driver = {
517 .name = "ehci-platform",
518 .pm = pm_ptr(&ehci_platform_pm_ops),
519 .of_match_table = vt8500_ehci_ids,
520 .acpi_match_table = ACPI_PTR(ehci_acpi_match),
521 .probe_type = PROBE_PREFER_ASYNCHRONOUS,
522 }
523 };
524
ehci_platform_init(void)525 static int __init ehci_platform_init(void)
526 {
527 if (usb_disabled())
528 return -ENODEV;
529
530 pr_info("%s: " DRIVER_DESC "\n", hcd_name);
531
532 ehci_init_driver(&ehci_platform_hc_driver, &platform_overrides);
533 return platform_driver_register(&ehci_platform_driver);
534 }
535 module_init(ehci_platform_init);
536
ehci_platform_cleanup(void)537 static void __exit ehci_platform_cleanup(void)
538 {
539 platform_driver_unregister(&ehci_platform_driver);
540 }
541 module_exit(ehci_platform_cleanup);
542
543 MODULE_DESCRIPTION(DRIVER_DESC);
544 MODULE_AUTHOR("Hauke Mehrtens");
545 MODULE_AUTHOR("Alan Stern");
546 MODULE_LICENSE("GPL");
547