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