2 * drivers/usb/gadget/s3c_udc_otg.c
3 * Samsung S3C on-chip full/high speed USB OTG 2.0 device controllers
5 * Copyright (C) 2008 for Samsung Electronics
7 * BSP Support for Samsung's UDC driver
9 * git://git.kernel.org/pub/scm/linux/kernel/git/kki_ap/linux-2.6-samsung.git
11 * State machine bugfixes:
12 * Marek Szyprowski <m.szyprowski@samsung.com>
15 * Marek Szyprowski <m.szyprowski@samsung.com>
16 * Lukasz Majewski <l.majewski@samsumg.com>
18 * SPDX-License-Identifier: GPL-2.0+
22 #include <asm/errno.h>
23 #include <linux/list.h>
26 #include <linux/usb/ch9.h>
27 #include <linux/usb/gadget.h>
29 #include <asm/byteorder.h>
30 #include <asm/unaligned.h>
33 #include <asm/mach-types.h>
36 #include <usb/lin_gadget_compat.h>
38 /***********************************************************/
40 #define OTG_DMA_MODE 1
45 #define DEBUG_OUT_EP 0
48 #include <usb/s3c_udc.h>
53 static char *state_names[] = {
56 "DATA_STATE_NEED_ZLP",
57 "WAIT_FOR_OUT_STATUS",
60 "WAIT_FOR_OUT_COMPLETE",
61 "WAIT_FOR_IN_COMPLETE",
62 "WAIT_FOR_NULL_COMPLETE",
65 #define DRIVER_DESC "S3C HS USB OTG Device Driver, (c) Samsung Electronics"
66 #define DRIVER_VERSION "15 March 2009"
68 struct s3c_udc *the_controller;
70 static const char driver_name[] = "s3c-udc";
71 static const char driver_desc[] = DRIVER_DESC;
72 static const char ep0name[] = "ep0-control";
75 static unsigned int ep0_fifo_size = 64;
76 static unsigned int ep_fifo_size = 512;
77 static unsigned int ep_fifo_size2 = 1024;
78 static int reset_available = 1;
80 static struct usb_ctrlrequest *usb_ctrl;
81 static dma_addr_t usb_ctrl_dma_addr;
86 static int s3c_ep_enable(struct usb_ep *ep,
87 const struct usb_endpoint_descriptor *);
88 static int s3c_ep_disable(struct usb_ep *ep);
89 static struct usb_request *s3c_alloc_request(struct usb_ep *ep,
91 static void s3c_free_request(struct usb_ep *ep, struct usb_request *);
93 static int s3c_queue(struct usb_ep *ep, struct usb_request *, gfp_t gfp_flags);
94 static int s3c_dequeue(struct usb_ep *ep, struct usb_request *);
95 static int s3c_fifo_status(struct usb_ep *ep);
96 static void s3c_fifo_flush(struct usb_ep *ep);
97 static void s3c_ep0_read(struct s3c_udc *dev);
98 static void s3c_ep0_kick(struct s3c_udc *dev, struct s3c_ep *ep);
99 static void s3c_handle_ep0(struct s3c_udc *dev);
100 static int s3c_ep0_write(struct s3c_udc *dev);
101 static int write_fifo_ep0(struct s3c_ep *ep, struct s3c_request *req);
102 static void done(struct s3c_ep *ep, struct s3c_request *req, int status);
103 static void stop_activity(struct s3c_udc *dev,
104 struct usb_gadget_driver *driver);
105 static int udc_enable(struct s3c_udc *dev);
106 static void udc_set_address(struct s3c_udc *dev, unsigned char address);
107 static void reconfig_usbd(struct s3c_udc *dev);
108 static void set_max_pktsize(struct s3c_udc *dev, enum usb_device_speed speed);
109 static void nuke(struct s3c_ep *ep, int status);
110 static int s3c_udc_set_halt(struct usb_ep *_ep, int value);
111 static void s3c_udc_set_nak(struct s3c_ep *ep);
113 void set_udc_gadget_private_data(void *p)
115 debug_cond(DEBUG_SETUP != 0,
116 "%s: the_controller: 0x%p, p: 0x%p\n", __func__,
118 the_controller->gadget.dev.device_data = p;
121 void *get_udc_gadget_private_data(struct usb_gadget *gadget)
123 return gadget->dev.device_data;
126 static struct usb_ep_ops s3c_ep_ops = {
127 .enable = s3c_ep_enable,
128 .disable = s3c_ep_disable,
130 .alloc_request = s3c_alloc_request,
131 .free_request = s3c_free_request,
134 .dequeue = s3c_dequeue,
136 .set_halt = s3c_udc_set_halt,
137 .fifo_status = s3c_fifo_status,
138 .fifo_flush = s3c_fifo_flush,
141 #define create_proc_files() do {} while (0)
142 #define remove_proc_files() do {} while (0)
144 /***********************************************************/
146 void __iomem *regs_otg;
147 struct s3c_usbotg_reg *reg;
149 bool dfu_usb_get_reset(void)
151 return !!(readl(®->gintsts) & INT_RESET);
154 __weak void otg_phy_init(struct s3c_udc *dev) {}
155 __weak void otg_phy_off(struct s3c_udc *dev) {}
157 /***********************************************************/
159 #include "s3c_udc_otg_xfer_dma.c"
162 * udc_disable - disable USB device controller
164 static void udc_disable(struct s3c_udc *dev)
166 debug_cond(DEBUG_SETUP != 0, "%s: %p\n", __func__, dev);
168 udc_set_address(dev, 0);
170 dev->ep0state = WAIT_FOR_SETUP;
171 dev->gadget.speed = USB_SPEED_UNKNOWN;
172 dev->usb_address = 0;
178 * udc_reinit - initialize software state
180 static void udc_reinit(struct s3c_udc *dev)
184 debug_cond(DEBUG_SETUP != 0, "%s: %p\n", __func__, dev);
186 /* device/ep0 records init */
187 INIT_LIST_HEAD(&dev->gadget.ep_list);
188 INIT_LIST_HEAD(&dev->gadget.ep0->ep_list);
189 dev->ep0state = WAIT_FOR_SETUP;
191 /* basic endpoint records init */
192 for (i = 0; i < S3C_MAX_ENDPOINTS; i++) {
193 struct s3c_ep *ep = &dev->ep[i];
196 list_add_tail(&ep->ep.ep_list, &dev->gadget.ep_list);
200 INIT_LIST_HEAD(&ep->queue);
204 /* the rest was statically initialized, and is read-only */
207 #define BYTES2MAXP(x) (x / 8)
208 #define MAXP2BYTES(x) (x * 8)
210 /* until it's enabled, this UDC should be completely invisible
213 static int udc_enable(struct s3c_udc *dev)
215 debug_cond(DEBUG_SETUP != 0, "%s: %p\n", __func__, dev);
220 debug_cond(DEBUG_SETUP != 0,
221 "S3C USB 2.0 OTG Controller Core Initialized : 0x%x\n",
222 readl(®->gintmsk));
224 dev->gadget.speed = USB_SPEED_UNKNOWN;
230 Register entry point for the peripheral controller driver.
232 int usb_gadget_register_driver(struct usb_gadget_driver *driver)
234 struct s3c_udc *dev = the_controller;
236 unsigned long flags = 0;
238 debug_cond(DEBUG_SETUP != 0, "%s: %s\n", __func__, "no name");
241 || (driver->speed != USB_SPEED_FULL
242 && driver->speed != USB_SPEED_HIGH)
243 || !driver->bind || !driver->disconnect || !driver->setup)
250 spin_lock_irqsave(&dev->lock, flags);
251 /* first hook up the driver ... */
252 dev->driver = driver;
253 spin_unlock_irqrestore(&dev->lock, flags);
255 if (retval) { /* TODO */
256 printf("target device_add failed, error %d\n", retval);
260 retval = driver->bind(&dev->gadget);
262 debug_cond(DEBUG_SETUP != 0,
263 "%s: bind to driver --> error %d\n",
264 dev->gadget.name, retval);
271 debug_cond(DEBUG_SETUP != 0,
272 "Registered gadget driver %s\n", dev->gadget.name);
279 * Unregister entry point for the peripheral controller driver.
281 int usb_gadget_unregister_driver(struct usb_gadget_driver *driver)
283 struct s3c_udc *dev = the_controller;
284 unsigned long flags = 0;
288 if (!driver || driver != dev->driver)
291 spin_lock_irqsave(&dev->lock, flags);
293 stop_activity(dev, driver);
294 spin_unlock_irqrestore(&dev->lock, flags);
296 driver->unbind(&dev->gadget);
298 disable_irq(IRQ_OTG);
305 * done - retire a request; caller blocked irqs
307 static void done(struct s3c_ep *ep, struct s3c_request *req, int status)
309 unsigned int stopped = ep->stopped;
311 debug("%s: %s %p, req = %p, stopped = %d\n",
312 __func__, ep->ep.name, ep, &req->req, stopped);
314 list_del_init(&req->queue);
316 if (likely(req->req.status == -EINPROGRESS))
317 req->req.status = status;
319 status = req->req.status;
321 if (status && status != -ESHUTDOWN) {
322 debug("complete %s req %p stat %d len %u/%u\n",
323 ep->ep.name, &req->req, status,
324 req->req.actual, req->req.length);
327 /* don't modify queue heads during completion callback */
331 printf("calling complete callback\n");
333 int i, len = req->req.length;
335 printf("pkt[%d] = ", req->req.length);
338 for (i = 0; i < len; i++) {
339 printf("%02x", ((u8 *)req->req.buf)[i]);
346 spin_unlock(&ep->dev->lock);
347 req->req.complete(&ep->ep, &req->req);
348 spin_lock(&ep->dev->lock);
350 debug("callback completed\n");
352 ep->stopped = stopped;
356 * nuke - dequeue ALL requests
358 static void nuke(struct s3c_ep *ep, int status)
360 struct s3c_request *req;
362 debug("%s: %s %p\n", __func__, ep->ep.name, ep);
364 /* called with irqs blocked */
365 while (!list_empty(&ep->queue)) {
366 req = list_entry(ep->queue.next, struct s3c_request, queue);
367 done(ep, req, status);
371 static void stop_activity(struct s3c_udc *dev,
372 struct usb_gadget_driver *driver)
376 /* don't disconnect drivers more than once */
377 if (dev->gadget.speed == USB_SPEED_UNKNOWN)
379 dev->gadget.speed = USB_SPEED_UNKNOWN;
381 /* prevent new request submissions, kill any outstanding requests */
382 for (i = 0; i < S3C_MAX_ENDPOINTS; i++) {
383 struct s3c_ep *ep = &dev->ep[i];
385 nuke(ep, -ESHUTDOWN);
388 /* report disconnect; the driver is already quiesced */
390 spin_unlock(&dev->lock);
391 driver->disconnect(&dev->gadget);
392 spin_lock(&dev->lock);
395 /* re-init driver-visible data structures */
399 static void reconfig_usbd(struct s3c_udc *dev)
401 /* 2. Soft-reset OTG Core and then unreset again. */
403 unsigned int uTemp = writel(CORE_SOFT_RESET, ®->grstctl);
404 uint32_t dflt_gusbcfg;
406 debug("Reseting OTG controller\n");
409 0<<15 /* PHY Low Power Clock sel*/
410 |1<<14 /* Non-Periodic TxFIFO Rewind Enable*/
411 |0x5<<10 /* Turnaround time*/
412 |0<<9 | 0<<8 /* [0:HNP disable,1:HNP enable][ 0:SRP disable*/
413 /* 1:SRP enable] H1= 1,1*/
414 |0<<7 /* Ulpi DDR sel*/
415 |0<<6 /* 0: high speed utmi+, 1: full speed serial*/
416 |0<<4 /* 0: utmi+, 1:ulpi*/
417 |1<<3 /* phy i/f 0:8bit, 1:16bit*/
418 |0x7<<0; /* HS/FS Timeout**/
420 if (dev->pdata->usb_gusbcfg)
421 dflt_gusbcfg = dev->pdata->usb_gusbcfg;
423 writel(dflt_gusbcfg, ®->gusbcfg);
425 /* 3. Put the OTG device core in the disconnected state.*/
426 uTemp = readl(®->dctl);
427 uTemp |= SOFT_DISCONNECT;
428 writel(uTemp, ®->dctl);
432 /* 4. Make the OTG device core exit from the disconnected state.*/
433 uTemp = readl(®->dctl);
434 uTemp = uTemp & ~SOFT_DISCONNECT;
435 writel(uTemp, ®->dctl);
437 /* 5. Configure OTG Core to initial settings of device mode.*/
438 /* [][1: full speed(30Mhz) 0:high speed]*/
439 writel(EP_MISS_CNT(1) | DEV_SPEED_HIGH_SPEED_20, ®->dcfg);
443 /* 6. Unmask the core interrupts*/
444 writel(GINTMSK_INIT, ®->gintmsk);
446 /* 7. Set NAK bit of EP0, EP1, EP2*/
447 writel(DEPCTL_EPDIS|DEPCTL_SNAK, ®->out_endp[EP0_CON].doepctl);
448 writel(DEPCTL_EPDIS|DEPCTL_SNAK, ®->in_endp[EP0_CON].diepctl);
450 for (i = 1; i < S3C_MAX_ENDPOINTS; i++) {
451 writel(DEPCTL_EPDIS|DEPCTL_SNAK, ®->out_endp[i].doepctl);
452 writel(DEPCTL_EPDIS|DEPCTL_SNAK, ®->in_endp[i].diepctl);
455 /* 8. Unmask EPO interrupts*/
456 writel(((1 << EP0_CON) << DAINT_OUT_BIT)
457 | (1 << EP0_CON), ®->daintmsk);
459 /* 9. Unmask device OUT EP common interrupts*/
460 writel(DOEPMSK_INIT, ®->doepmsk);
462 /* 10. Unmask device IN EP common interrupts*/
463 writel(DIEPMSK_INIT, ®->diepmsk);
465 /* 11. Set Rx FIFO Size (in 32-bit words) */
466 writel(RX_FIFO_SIZE >> 2, ®->grxfsiz);
468 /* 12. Set Non Periodic Tx FIFO Size */
469 writel((NPTX_FIFO_SIZE >> 2) << 16 | ((RX_FIFO_SIZE >> 2)) << 0,
472 for (i = 1; i < S3C_MAX_HW_ENDPOINTS; i++)
473 writel((PTX_FIFO_SIZE >> 2) << 16 |
474 ((RX_FIFO_SIZE + NPTX_FIFO_SIZE +
475 PTX_FIFO_SIZE*(i-1)) >> 2) << 0,
478 /* Flush the RX FIFO */
479 writel(RX_FIFO_FLUSH, ®->grstctl);
480 while (readl(®->grstctl) & RX_FIFO_FLUSH)
481 debug("%s: waiting for S3C_UDC_OTG_GRSTCTL\n", __func__);
483 /* Flush all the Tx FIFO's */
484 writel(TX_FIFO_FLUSH_ALL, ®->grstctl);
485 writel(TX_FIFO_FLUSH_ALL | TX_FIFO_FLUSH, ®->grstctl);
486 while (readl(®->grstctl) & TX_FIFO_FLUSH)
487 debug("%s: waiting for S3C_UDC_OTG_GRSTCTL\n", __func__);
489 /* 13. Clear NAK bit of EP0, EP1, EP2*/
491 /* EP0: Control OUT */
492 writel(DEPCTL_EPDIS | DEPCTL_CNAK,
493 ®->out_endp[EP0_CON].doepctl);
495 /* 14. Initialize OTG Link Core.*/
496 writel(GAHBCFG_INIT, ®->gahbcfg);
499 static void set_max_pktsize(struct s3c_udc *dev, enum usb_device_speed speed)
501 unsigned int ep_ctrl;
504 if (speed == USB_SPEED_HIGH) {
507 ep_fifo_size2 = 1024;
508 dev->gadget.speed = USB_SPEED_HIGH;
513 dev->gadget.speed = USB_SPEED_FULL;
516 dev->ep[0].ep.maxpacket = ep0_fifo_size;
517 for (i = 1; i < S3C_MAX_ENDPOINTS; i++)
518 dev->ep[i].ep.maxpacket = ep_fifo_size;
520 /* EP0 - Control IN (64 bytes)*/
521 ep_ctrl = readl(®->in_endp[EP0_CON].diepctl);
522 writel(ep_ctrl|(0<<0), ®->in_endp[EP0_CON].diepctl);
524 /* EP0 - Control OUT (64 bytes)*/
525 ep_ctrl = readl(®->out_endp[EP0_CON].doepctl);
526 writel(ep_ctrl|(0<<0), ®->out_endp[EP0_CON].doepctl);
529 static int s3c_ep_enable(struct usb_ep *_ep,
530 const struct usb_endpoint_descriptor *desc)
534 unsigned long flags = 0;
536 debug("%s: %p\n", __func__, _ep);
538 ep = container_of(_ep, struct s3c_ep, ep);
539 if (!_ep || !desc || ep->desc || _ep->name == ep0name
540 || desc->bDescriptorType != USB_DT_ENDPOINT
541 || ep->bEndpointAddress != desc->bEndpointAddress
542 || ep_maxpacket(ep) <
543 le16_to_cpu(get_unaligned(&desc->wMaxPacketSize))) {
545 debug("%s: bad ep or descriptor\n", __func__);
549 /* xfer types must match, except that interrupt ~= bulk */
550 if (ep->bmAttributes != desc->bmAttributes
551 && ep->bmAttributes != USB_ENDPOINT_XFER_BULK
552 && desc->bmAttributes != USB_ENDPOINT_XFER_INT) {
554 debug("%s: %s type mismatch\n", __func__, _ep->name);
558 /* hardware _could_ do smaller, but driver doesn't */
559 if ((desc->bmAttributes == USB_ENDPOINT_XFER_BULK
560 && le16_to_cpu(get_unaligned(&desc->wMaxPacketSize)) !=
561 ep_maxpacket(ep)) || !get_unaligned(&desc->wMaxPacketSize)) {
563 debug("%s: bad %s maxpacket\n", __func__, _ep->name);
568 if (!dev->driver || dev->gadget.speed == USB_SPEED_UNKNOWN) {
570 debug("%s: bogus device state\n", __func__);
577 ep->ep.maxpacket = le16_to_cpu(get_unaligned(&desc->wMaxPacketSize));
579 /* Reset halt state */
581 s3c_udc_set_halt(_ep, 0);
583 spin_lock_irqsave(&ep->dev->lock, flags);
584 s3c_udc_ep_activate(ep);
585 spin_unlock_irqrestore(&ep->dev->lock, flags);
587 debug("%s: enabled %s, stopped = %d, maxpacket = %d\n",
588 __func__, _ep->name, ep->stopped, ep->ep.maxpacket);
595 static int s3c_ep_disable(struct usb_ep *_ep)
598 unsigned long flags = 0;
600 debug("%s: %p\n", __func__, _ep);
602 ep = container_of(_ep, struct s3c_ep, ep);
603 if (!_ep || !ep->desc) {
604 debug("%s: %s not enabled\n", __func__,
605 _ep ? ep->ep.name : NULL);
609 spin_lock_irqsave(&ep->dev->lock, flags);
611 /* Nuke all pending requests */
612 nuke(ep, -ESHUTDOWN);
617 spin_unlock_irqrestore(&ep->dev->lock, flags);
619 debug("%s: disabled %s\n", __func__, _ep->name);
623 static struct usb_request *s3c_alloc_request(struct usb_ep *ep,
626 struct s3c_request *req;
628 debug("%s: %s %p\n", __func__, ep->name, ep);
630 req = memalign(CONFIG_SYS_CACHELINE_SIZE, sizeof(*req));
634 memset(req, 0, sizeof *req);
635 INIT_LIST_HEAD(&req->queue);
640 static void s3c_free_request(struct usb_ep *ep, struct usb_request *_req)
642 struct s3c_request *req;
644 debug("%s: %p\n", __func__, ep);
646 req = container_of(_req, struct s3c_request, req);
647 WARN_ON(!list_empty(&req->queue));
651 /* dequeue JUST ONE request */
652 static int s3c_dequeue(struct usb_ep *_ep, struct usb_request *_req)
655 struct s3c_request *req;
656 unsigned long flags = 0;
658 debug("%s: %p\n", __func__, _ep);
660 ep = container_of(_ep, struct s3c_ep, ep);
661 if (!_ep || ep->ep.name == ep0name)
664 spin_lock_irqsave(&ep->dev->lock, flags);
666 /* make sure it's actually queued on this endpoint */
667 list_for_each_entry(req, &ep->queue, queue) {
668 if (&req->req == _req)
671 if (&req->req != _req) {
672 spin_unlock_irqrestore(&ep->dev->lock, flags);
676 done(ep, req, -ECONNRESET);
678 spin_unlock_irqrestore(&ep->dev->lock, flags);
683 * Return bytes in EP FIFO
685 static int s3c_fifo_status(struct usb_ep *_ep)
690 ep = container_of(_ep, struct s3c_ep, ep);
692 debug("%s: bad ep\n", __func__);
696 debug("%s: %d\n", __func__, ep_index(ep));
698 /* LPD can't report unclaimed bytes from IN fifos */
708 static void s3c_fifo_flush(struct usb_ep *_ep)
712 ep = container_of(_ep, struct s3c_ep, ep);
713 if (unlikely(!_ep || (!ep->desc && ep->ep.name != ep0name))) {
714 debug("%s: bad ep\n", __func__);
718 debug("%s: %d\n", __func__, ep_index(ep));
721 static const struct usb_gadget_ops s3c_udc_ops = {
722 /* current versions must always be self-powered */
725 static struct s3c_udc memory = {
729 .ep0 = &memory.ep[0].ep,
733 /* control endpoint */
738 .maxpacket = EP0_FIFO_SIZE,
742 .bEndpointAddress = 0,
745 .ep_type = ep_control,
748 /* first group of endpoints */
751 .name = "ep1in-bulk",
753 .maxpacket = EP_FIFO_SIZE,
757 .bEndpointAddress = USB_DIR_IN | 1,
758 .bmAttributes = USB_ENDPOINT_XFER_BULK,
760 .ep_type = ep_bulk_out,
766 .name = "ep2out-bulk",
768 .maxpacket = EP_FIFO_SIZE,
772 .bEndpointAddress = USB_DIR_OUT | 2,
773 .bmAttributes = USB_ENDPOINT_XFER_BULK,
775 .ep_type = ep_bulk_in,
783 .maxpacket = EP_FIFO_SIZE,
787 .bEndpointAddress = USB_DIR_IN | 3,
788 .bmAttributes = USB_ENDPOINT_XFER_INT,
790 .ep_type = ep_interrupt,
796 * probe - binds to the platform device
799 int s3c_udc_probe(struct s3c_plat_otg_data *pdata)
801 struct s3c_udc *dev = &memory;
804 debug("%s: %p\n", __func__, pdata);
808 reg = (struct s3c_usbotg_reg *)pdata->regs_otg;
810 /* regs_otg = (void *)pdata->regs_otg; */
812 dev->gadget.is_dualspeed = 1; /* Hack only*/
813 dev->gadget.is_otg = 0;
814 dev->gadget.is_a_peripheral = 0;
815 dev->gadget.b_hnp_enable = 0;
816 dev->gadget.a_hnp_support = 0;
817 dev->gadget.a_alt_hnp_support = 0;
819 the_controller = dev;
821 usb_ctrl = memalign(CONFIG_SYS_CACHELINE_SIZE,
822 ROUND(sizeof(struct usb_ctrlrequest),
823 CONFIG_SYS_CACHELINE_SIZE));
825 error("No memory available for UDC!\n");
829 usb_ctrl_dma_addr = (dma_addr_t) usb_ctrl;
836 int usb_gadget_handle_interrupts()
838 u32 intr_status = readl(®->gintsts);
839 u32 gintmsk = readl(®->gintmsk);
841 if (intr_status & gintmsk)
842 return s3c_udc_irq(1, (void *)the_controller);