1 // SPDX-License-Identifier: GPL-1.0+
2 /*
3 * OHCI HCD (Host Controller Driver) for USB.
4 *
5 * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at>
6 * (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net>
7 * (C) Copyright 2002 Hewlett-Packard Company
8 *
9 * USB Bus Glue for Samsung S3C2410
10 *
11 * Written by Christopher Hoover <ch@hpl.hp.com>
12 * Based on fragments of previous driver by Russell King et al.
13 *
14 * Modified for S3C2410 from ohci-sa1111.c, ohci-omap.c and ohci-lh7a40.c
15 * by Ben Dooks, <ben@simtec.co.uk>
16 * Copyright (C) 2004 Simtec Electronics
17 *
18 * Thanks to basprog@mail.ru for updates to newer kernels
19 *
20 * This file is licenced under the GPL.
21 */
22
23 #include <linux/clk.h>
24 #include <linux/io.h>
25 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/platform_device.h>
28 #include <linux/platform_data/usb-ohci-s3c2410.h>
29 #include <linux/usb.h>
30 #include <linux/usb/hcd.h>
31
32 #include "ohci.h"
33
34
35 #define valid_port(idx) ((idx) == 1 || (idx) == 2)
36
37 /* clock device associated with the hcd */
38
39
40 #define DRIVER_DESC "OHCI S3C2410 driver"
41
42 static const char hcd_name[] = "ohci-s3c2410";
43
44 static struct clk *clk;
45 static struct clk *usb_clk;
46
47 static struct hc_driver __read_mostly ohci_s3c2410_hc_driver;
48
49 /* forward definitions */
50
51 static void s3c2410_hcd_oc(struct s3c2410_hcd_info *info, int port_oc);
52
53 /* conversion functions */
54
to_s3c2410_info(struct usb_hcd * hcd)55 static struct s3c2410_hcd_info *to_s3c2410_info(struct usb_hcd *hcd)
56 {
57 return dev_get_platdata(hcd->self.controller);
58 }
59
s3c2410_start_hc(struct platform_device * dev,struct usb_hcd * hcd)60 static void s3c2410_start_hc(struct platform_device *dev, struct usb_hcd *hcd)
61 {
62 struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
63
64 dev_dbg(&dev->dev, "s3c2410_start_hc:\n");
65
66 clk_prepare_enable(usb_clk);
67 mdelay(2); /* let the bus clock stabilise */
68
69 clk_prepare_enable(clk);
70
71 if (info != NULL) {
72 info->hcd = hcd;
73 info->report_oc = s3c2410_hcd_oc;
74
75 if (info->enable_oc != NULL)
76 (info->enable_oc)(info, 1);
77 }
78 }
79
s3c2410_stop_hc(struct platform_device * dev)80 static void s3c2410_stop_hc(struct platform_device *dev)
81 {
82 struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
83
84 dev_dbg(&dev->dev, "s3c2410_stop_hc:\n");
85
86 if (info != NULL) {
87 info->report_oc = NULL;
88 info->hcd = NULL;
89
90 if (info->enable_oc != NULL)
91 (info->enable_oc)(info, 0);
92 }
93
94 clk_disable_unprepare(clk);
95 clk_disable_unprepare(usb_clk);
96 }
97
98 /* ohci_s3c2410_hub_status_data
99 *
100 * update the status data from the hub with anything that
101 * has been detected by our system
102 */
103
104 static int
ohci_s3c2410_hub_status_data(struct usb_hcd * hcd,char * buf)105 ohci_s3c2410_hub_status_data(struct usb_hcd *hcd, char *buf)
106 {
107 struct s3c2410_hcd_info *info = to_s3c2410_info(hcd);
108 struct s3c2410_hcd_port *port;
109 int orig;
110 int portno;
111
112 orig = ohci_hub_status_data(hcd, buf);
113
114 if (info == NULL)
115 return orig;
116
117 port = &info->port[0];
118
119 /* mark any changed port as changed */
120
121 for (portno = 0; portno < 2; port++, portno++) {
122 if (port->oc_changed == 1 &&
123 port->flags & S3C_HCDFLG_USED) {
124 dev_dbg(hcd->self.controller,
125 "oc change on port %d\n", portno);
126
127 if (orig < 1)
128 orig = 1;
129
130 buf[0] |= 1<<(portno+1);
131 }
132 }
133
134 return orig;
135 }
136
137 /* s3c2410_usb_set_power
138 *
139 * configure the power on a port, by calling the platform device
140 * routine registered with the platform device
141 */
142
s3c2410_usb_set_power(struct s3c2410_hcd_info * info,int port,int to)143 static void s3c2410_usb_set_power(struct s3c2410_hcd_info *info,
144 int port, int to)
145 {
146 if (info == NULL)
147 return;
148
149 if (info->power_control != NULL) {
150 info->port[port-1].power = to;
151 (info->power_control)(port-1, to);
152 }
153 }
154
155 /* ohci_s3c2410_hub_control
156 *
157 * look at control requests to the hub, and see if we need
158 * to take any action or over-ride the results from the
159 * request.
160 */
161
ohci_s3c2410_hub_control(struct usb_hcd * hcd,u16 typeReq,u16 wValue,u16 wIndex,char * buf,u16 wLength)162 static int ohci_s3c2410_hub_control(
163 struct usb_hcd *hcd,
164 u16 typeReq,
165 u16 wValue,
166 u16 wIndex,
167 char *buf,
168 u16 wLength)
169 {
170 struct s3c2410_hcd_info *info = to_s3c2410_info(hcd);
171 struct usb_hub_descriptor *desc;
172 int ret = -EINVAL;
173 u32 *data = (u32 *)buf;
174
175 dev_dbg(hcd->self.controller,
176 "s3c2410_hub_control(%p,0x%04x,0x%04x,0x%04x,%p,%04x)\n",
177 hcd, typeReq, wValue, wIndex, buf, wLength);
178
179 /* if we are only an humble host without any special capabilities
180 * process the request straight away and exit */
181
182 if (info == NULL) {
183 ret = ohci_hub_control(hcd, typeReq, wValue,
184 wIndex, buf, wLength);
185 goto out;
186 }
187
188 /* check the request to see if it needs handling */
189
190 switch (typeReq) {
191 case SetPortFeature:
192 if (wValue == USB_PORT_FEAT_POWER) {
193 dev_dbg(hcd->self.controller, "SetPortFeat: POWER\n");
194 s3c2410_usb_set_power(info, wIndex, 1);
195 goto out;
196 }
197 break;
198
199 case ClearPortFeature:
200 switch (wValue) {
201 case USB_PORT_FEAT_C_OVER_CURRENT:
202 dev_dbg(hcd->self.controller,
203 "ClearPortFeature: C_OVER_CURRENT\n");
204
205 if (valid_port(wIndex)) {
206 info->port[wIndex-1].oc_changed = 0;
207 info->port[wIndex-1].oc_status = 0;
208 }
209
210 goto out;
211
212 case USB_PORT_FEAT_OVER_CURRENT:
213 dev_dbg(hcd->self.controller,
214 "ClearPortFeature: OVER_CURRENT\n");
215
216 if (valid_port(wIndex))
217 info->port[wIndex-1].oc_status = 0;
218
219 goto out;
220
221 case USB_PORT_FEAT_POWER:
222 dev_dbg(hcd->self.controller,
223 "ClearPortFeature: POWER\n");
224
225 if (valid_port(wIndex)) {
226 s3c2410_usb_set_power(info, wIndex, 0);
227 return 0;
228 }
229 }
230 break;
231 }
232
233 ret = ohci_hub_control(hcd, typeReq, wValue, wIndex, buf, wLength);
234 if (ret)
235 goto out;
236
237 switch (typeReq) {
238 case GetHubDescriptor:
239
240 /* update the hub's descriptor */
241
242 desc = (struct usb_hub_descriptor *)buf;
243
244 if (info->power_control == NULL)
245 return ret;
246
247 dev_dbg(hcd->self.controller, "wHubCharacteristics 0x%04x\n",
248 desc->wHubCharacteristics);
249
250 /* remove the old configurations for power-switching, and
251 * over-current protection, and insert our new configuration
252 */
253
254 desc->wHubCharacteristics &= ~cpu_to_le16(HUB_CHAR_LPSM);
255 desc->wHubCharacteristics |= cpu_to_le16(
256 HUB_CHAR_INDV_PORT_LPSM);
257
258 if (info->enable_oc) {
259 desc->wHubCharacteristics &= ~cpu_to_le16(
260 HUB_CHAR_OCPM);
261 desc->wHubCharacteristics |= cpu_to_le16(
262 HUB_CHAR_INDV_PORT_OCPM);
263 }
264
265 dev_dbg(hcd->self.controller, "wHubCharacteristics after 0x%04x\n",
266 desc->wHubCharacteristics);
267
268 return ret;
269
270 case GetPortStatus:
271 /* check port status */
272
273 dev_dbg(hcd->self.controller, "GetPortStatus(%d)\n", wIndex);
274
275 if (valid_port(wIndex)) {
276 if (info->port[wIndex-1].oc_changed)
277 *data |= cpu_to_le32(RH_PS_OCIC);
278
279 if (info->port[wIndex-1].oc_status)
280 *data |= cpu_to_le32(RH_PS_POCI);
281 }
282 }
283
284 out:
285 return ret;
286 }
287
288 /* s3c2410_hcd_oc
289 *
290 * handle an over-current report
291 */
292
s3c2410_hcd_oc(struct s3c2410_hcd_info * info,int port_oc)293 static void s3c2410_hcd_oc(struct s3c2410_hcd_info *info, int port_oc)
294 {
295 struct s3c2410_hcd_port *port;
296 unsigned long flags;
297 int portno;
298
299 if (info == NULL)
300 return;
301
302 port = &info->port[0];
303
304 local_irq_save(flags);
305
306 for (portno = 0; portno < 2; port++, portno++) {
307 if (port_oc & (1<<portno) &&
308 port->flags & S3C_HCDFLG_USED) {
309 port->oc_status = 1;
310 port->oc_changed = 1;
311
312 /* ok, once over-current is detected,
313 the port needs to be powered down */
314 s3c2410_usb_set_power(info, portno+1, 0);
315 }
316 }
317
318 local_irq_restore(flags);
319 }
320
321 /* may be called without controller electrically present */
322 /* may be called with controller, bus, and devices active */
323
324 /*
325 * ohci_hcd_s3c2410_remove - shutdown processing for HCD
326 * @dev: USB Host Controller being removed
327 *
328 * Context: task context, might sleep
329 *
330 * Reverses the effect of ohci_hcd_3c2410_probe(), first invoking
331 * the HCD's stop() method. It is always called from a thread
332 * context, normally "rmmod", "apmd", or something similar.
333 */
334 static int
ohci_hcd_s3c2410_remove(struct platform_device * dev)335 ohci_hcd_s3c2410_remove(struct platform_device *dev)
336 {
337 struct usb_hcd *hcd = platform_get_drvdata(dev);
338
339 usb_remove_hcd(hcd);
340 s3c2410_stop_hc(dev);
341 usb_put_hcd(hcd);
342 return 0;
343 }
344
345 /*
346 * ohci_hcd_s3c2410_probe - initialize S3C2410-based HCDs
347 * @dev: USB Host Controller to be probed
348 *
349 * Context: task context, might sleep
350 *
351 * Allocates basic resources for this USB host controller, and
352 * then invokes the start() method for the HCD associated with it
353 * through the hotplug entry's driver_data.
354 */
ohci_hcd_s3c2410_probe(struct platform_device * dev)355 static int ohci_hcd_s3c2410_probe(struct platform_device *dev)
356 {
357 struct usb_hcd *hcd = NULL;
358 struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
359 int retval;
360
361 s3c2410_usb_set_power(info, 1, 1);
362 s3c2410_usb_set_power(info, 2, 1);
363
364 hcd = usb_create_hcd(&ohci_s3c2410_hc_driver, &dev->dev, "s3c24xx");
365 if (hcd == NULL)
366 return -ENOMEM;
367
368 hcd->rsrc_start = dev->resource[0].start;
369 hcd->rsrc_len = resource_size(&dev->resource[0]);
370
371 hcd->regs = devm_ioremap_resource(&dev->dev, &dev->resource[0]);
372 if (IS_ERR(hcd->regs)) {
373 retval = PTR_ERR(hcd->regs);
374 goto err_put;
375 }
376
377 clk = devm_clk_get(&dev->dev, "usb-host");
378 if (IS_ERR(clk)) {
379 dev_err(&dev->dev, "cannot get usb-host clock\n");
380 retval = PTR_ERR(clk);
381 goto err_put;
382 }
383
384 usb_clk = devm_clk_get(&dev->dev, "usb-bus-host");
385 if (IS_ERR(usb_clk)) {
386 dev_err(&dev->dev, "cannot get usb-bus-host clock\n");
387 retval = PTR_ERR(usb_clk);
388 goto err_put;
389 }
390
391 s3c2410_start_hc(dev, hcd);
392
393 retval = usb_add_hcd(hcd, dev->resource[1].start, 0);
394 if (retval != 0)
395 goto err_ioremap;
396
397 device_wakeup_enable(hcd->self.controller);
398 return 0;
399
400 err_ioremap:
401 s3c2410_stop_hc(dev);
402
403 err_put:
404 usb_put_hcd(hcd);
405 return retval;
406 }
407
408 /*-------------------------------------------------------------------------*/
409
410 #ifdef CONFIG_PM
ohci_hcd_s3c2410_drv_suspend(struct device * dev)411 static int ohci_hcd_s3c2410_drv_suspend(struct device *dev)
412 {
413 struct usb_hcd *hcd = dev_get_drvdata(dev);
414 struct platform_device *pdev = to_platform_device(dev);
415 bool do_wakeup = device_may_wakeup(dev);
416 int rc = 0;
417
418 rc = ohci_suspend(hcd, do_wakeup);
419 if (rc)
420 return rc;
421
422 s3c2410_stop_hc(pdev);
423
424 return rc;
425 }
426
ohci_hcd_s3c2410_drv_resume(struct device * dev)427 static int ohci_hcd_s3c2410_drv_resume(struct device *dev)
428 {
429 struct usb_hcd *hcd = dev_get_drvdata(dev);
430 struct platform_device *pdev = to_platform_device(dev);
431
432 s3c2410_start_hc(pdev, hcd);
433
434 ohci_resume(hcd, false);
435
436 return 0;
437 }
438 #else
439 #define ohci_hcd_s3c2410_drv_suspend NULL
440 #define ohci_hcd_s3c2410_drv_resume NULL
441 #endif
442
443 static const struct dev_pm_ops ohci_hcd_s3c2410_pm_ops = {
444 .suspend = ohci_hcd_s3c2410_drv_suspend,
445 .resume = ohci_hcd_s3c2410_drv_resume,
446 };
447
448 static const struct of_device_id ohci_hcd_s3c2410_dt_ids[] = {
449 { .compatible = "samsung,s3c2410-ohci" },
450 { /* sentinel */ }
451 };
452
453 MODULE_DEVICE_TABLE(of, ohci_hcd_s3c2410_dt_ids);
454
455 static struct platform_driver ohci_hcd_s3c2410_driver = {
456 .probe = ohci_hcd_s3c2410_probe,
457 .remove = ohci_hcd_s3c2410_remove,
458 .shutdown = usb_hcd_platform_shutdown,
459 .driver = {
460 .name = "s3c2410-ohci",
461 .pm = &ohci_hcd_s3c2410_pm_ops,
462 .of_match_table = ohci_hcd_s3c2410_dt_ids,
463 },
464 };
465
ohci_s3c2410_init(void)466 static int __init ohci_s3c2410_init(void)
467 {
468 if (usb_disabled())
469 return -ENODEV;
470
471 pr_info("%s: " DRIVER_DESC "\n", hcd_name);
472 ohci_init_driver(&ohci_s3c2410_hc_driver, NULL);
473
474 /*
475 * The Samsung HW has some unusual quirks, which require
476 * Sumsung-specific workarounds. We override certain hc_driver
477 * functions here to achieve that. We explicitly do not enhance
478 * ohci_driver_overrides to allow this more easily, since this
479 * is an unusual case, and we don't want to encourage others to
480 * override these functions by making it too easy.
481 */
482
483 ohci_s3c2410_hc_driver.hub_status_data = ohci_s3c2410_hub_status_data;
484 ohci_s3c2410_hc_driver.hub_control = ohci_s3c2410_hub_control;
485
486 return platform_driver_register(&ohci_hcd_s3c2410_driver);
487 }
488 module_init(ohci_s3c2410_init);
489
ohci_s3c2410_cleanup(void)490 static void __exit ohci_s3c2410_cleanup(void)
491 {
492 platform_driver_unregister(&ohci_hcd_s3c2410_driver);
493 }
494 module_exit(ohci_s3c2410_cleanup);
495
496 MODULE_DESCRIPTION(DRIVER_DESC);
497 MODULE_LICENSE("GPL");
498 MODULE_ALIAS("platform:s3c2410-ohci");
499