2 * ep0.c - DesignWare USB3 DRD Controller Endpoint 0 Handling
4 * Copyright (C) 2010-2011 Texas Instruments Incorporated - http://www.ti.com
6 * Authors: Felipe Balbi <balbi@ti.com>,
7 * Sebastian Andrzej Siewior <bigeasy@linutronix.de>
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions, and the following disclaimer,
14 * without modification.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. The names of the above-listed copyright holders may not be used
19 * to endorse or promote products derived from this software without
20 * specific prior written permission.
22 * ALTERNATIVELY, this software may be distributed under the terms of the
23 * GNU General Public License ("GPL") version 2, as published by the Free
24 * Software Foundation.
26 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
27 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
28 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
30 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
31 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
32 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
33 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
34 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
35 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
36 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 #include <linux/kernel.h>
40 #include <linux/slab.h>
41 #include <linux/spinlock.h>
42 #include <linux/platform_device.h>
43 #include <linux/pm_runtime.h>
44 #include <linux/interrupt.h>
46 #include <linux/list.h>
47 #include <linux/dma-mapping.h>
49 #include <linux/usb/ch9.h>
50 #include <linux/usb/gadget.h>
56 static void dwc3_ep0_inspect_setup(struct dwc3 *dwc,
57 const struct dwc3_event_depevt *event);
59 static const char *dwc3_ep0_state_string(enum dwc3_ep0_state state)
68 case EP0_STATUS_PHASE:
69 return "Status Phase";
75 static int dwc3_ep0_start_trans(struct dwc3 *dwc, u8 epnum, dma_addr_t buf_dma,
78 struct dwc3_gadget_ep_cmd_params params;
79 struct dwc3_trb_hw *trb_hw;
85 dep = dwc->eps[epnum];
86 if (dep->flags & DWC3_EP_BUSY) {
87 dev_vdbg(dwc->dev, "%s: still busy\n", dep->name);
91 trb_hw = dwc->ep0_trb;
92 memset(&trb, 0, sizeof(trb));
103 dwc3_trb_to_hw(&trb, trb_hw);
105 memset(¶ms, 0, sizeof(params));
106 params.param0 = upper_32_bits(dwc->ep0_trb_addr);
107 params.param1 = lower_32_bits(dwc->ep0_trb_addr);
109 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number,
110 DWC3_DEPCMD_STARTTRANSFER, ¶ms);
112 dev_dbg(dwc->dev, "failed to send STARTTRANSFER command\n");
116 dep->flags |= DWC3_EP_BUSY;
117 dep->res_trans_idx = dwc3_gadget_ep_get_transfer_index(dwc,
120 dwc->ep0_next_event = DWC3_EP0_COMPLETE;
125 static int __dwc3_gadget_ep0_queue(struct dwc3_ep *dep,
126 struct dwc3_request *req)
130 req->request.actual = 0;
131 req->request.status = -EINPROGRESS;
132 req->epnum = dep->number;
134 list_add_tail(&req->list, &dep->request_list);
137 * Gadget driver might not be quick enough to queue a request
138 * before we get a Transfer Not Ready event on this endpoint.
140 * In that case, we will set DWC3_EP_PENDING_REQUEST. When that
141 * flag is set, it's telling us that as soon as Gadget queues the
142 * required request, we should kick the transfer here because the
143 * IRQ we were waiting for is long gone.
145 if (dep->flags & DWC3_EP_PENDING_REQUEST) {
146 struct dwc3 *dwc = dep->dwc;
150 direction = !!(dep->flags & DWC3_EP0_DIR_IN);
152 if (dwc->ep0state != EP0_DATA_PHASE) {
153 dev_WARN(dwc->dev, "Unexpected pending request\n");
157 ret = dwc3_ep0_start_trans(dwc, direction,
158 req->request.dma, req->request.length,
159 DWC3_TRBCTL_CONTROL_DATA);
160 dep->flags &= ~(DWC3_EP_PENDING_REQUEST |
167 int dwc3_gadget_ep0_queue(struct usb_ep *ep, struct usb_request *request,
170 struct dwc3_request *req = to_dwc3_request(request);
171 struct dwc3_ep *dep = to_dwc3_ep(ep);
172 struct dwc3 *dwc = dep->dwc;
178 spin_lock_irqsave(&dwc->lock, flags);
180 dev_dbg(dwc->dev, "trying to queue request %p to disabled %s\n",
186 /* we share one TRB for ep0/1 */
187 if (!list_empty(&dwc->eps[0]->request_list) ||
188 !list_empty(&dwc->eps[1]->request_list) ||
189 dwc->ep0_status_pending) {
194 dev_vdbg(dwc->dev, "queueing request %p to %s length %d, state '%s'\n",
195 request, dep->name, request->length,
196 dwc3_ep0_state_string(dwc->ep0state));
198 ret = __dwc3_gadget_ep0_queue(dep, req);
201 spin_unlock_irqrestore(&dwc->lock, flags);
206 static void dwc3_ep0_stall_and_restart(struct dwc3 *dwc)
208 struct dwc3_ep *dep = dwc->eps[0];
210 /* stall is always issued on EP0 */
211 __dwc3_gadget_ep_set_halt(dwc->eps[0], 1);
212 dwc->eps[0]->flags = DWC3_EP_ENABLED;
214 if (!list_empty(&dep->request_list)) {
215 struct dwc3_request *req;
217 req = next_request(&dep->request_list);
218 dwc3_gadget_giveback(dep, req, -ECONNRESET);
221 dwc->ep0state = EP0_SETUP_PHASE;
222 dwc3_ep0_out_start(dwc);
225 void dwc3_ep0_out_start(struct dwc3 *dwc)
229 ret = dwc3_ep0_start_trans(dwc, 0, dwc->ctrl_req_addr, 8,
230 DWC3_TRBCTL_CONTROL_SETUP);
234 static struct dwc3_ep *dwc3_wIndex_to_dep(struct dwc3 *dwc, __le16 wIndex_le)
237 u32 windex = le16_to_cpu(wIndex_le);
240 epnum = (windex & USB_ENDPOINT_NUMBER_MASK) << 1;
241 if ((windex & USB_ENDPOINT_DIR_MASK) == USB_DIR_IN)
244 dep = dwc->eps[epnum];
245 if (dep->flags & DWC3_EP_ENABLED)
251 static void dwc3_ep0_send_status_response(struct dwc3 *dwc)
253 dwc3_ep0_start_trans(dwc, 1, dwc->setup_buf_addr,
254 dwc->ep0_usb_req.length,
255 DWC3_TRBCTL_CONTROL_DATA);
261 static int dwc3_ep0_handle_status(struct dwc3 *dwc, struct usb_ctrlrequest *ctrl)
266 __le16 *response_pkt;
268 recip = ctrl->bRequestType & USB_RECIP_MASK;
270 case USB_RECIP_DEVICE:
272 * We are self-powered. U1/U2/LTM will be set later
273 * once we handle this states. RemoteWakeup is 0 on SS
275 usb_status |= dwc->is_selfpowered << USB_DEVICE_SELF_POWERED;
278 case USB_RECIP_INTERFACE:
280 * Function Remote Wake Capable D0
281 * Function Remote Wakeup D1
285 case USB_RECIP_ENDPOINT:
286 dep = dwc3_wIndex_to_dep(dwc, ctrl->wIndex);
290 if (dep->flags & DWC3_EP_STALL)
291 usb_status = 1 << USB_ENDPOINT_HALT;
297 response_pkt = (__le16 *) dwc->setup_buf;
298 *response_pkt = cpu_to_le16(usb_status);
299 dwc->ep0_usb_req.length = sizeof(*response_pkt);
300 dwc->ep0_status_pending = 1;
305 static int dwc3_ep0_handle_feature(struct dwc3 *dwc,
306 struct usb_ctrlrequest *ctrl, int set)
316 wValue = le16_to_cpu(ctrl->wValue);
317 wIndex = le16_to_cpu(ctrl->wIndex);
318 recip = ctrl->bRequestType & USB_RECIP_MASK;
320 case USB_RECIP_DEVICE:
323 * 9.4.1 says only only for SS, in AddressState only for
324 * default control pipe
327 case USB_DEVICE_U1_ENABLE:
328 case USB_DEVICE_U2_ENABLE:
329 case USB_DEVICE_LTM_ENABLE:
330 if (dwc->dev_state != DWC3_CONFIGURED_STATE)
332 if (dwc->speed != DWC3_DSTS_SUPERSPEED)
336 /* XXX add U[12] & LTM */
338 case USB_DEVICE_REMOTE_WAKEUP:
340 case USB_DEVICE_U1_ENABLE:
342 case USB_DEVICE_U2_ENABLE:
344 case USB_DEVICE_LTM_ENABLE:
347 case USB_DEVICE_TEST_MODE:
348 if ((wIndex & 0xff) != 0)
354 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
355 reg &= ~DWC3_DCTL_TSTCTRL_MASK;
368 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
375 case USB_RECIP_INTERFACE:
377 case USB_INTRF_FUNC_SUSPEND:
378 if (wIndex & USB_INTRF_FUNC_SUSPEND_LP)
379 /* XXX enable Low power suspend */
381 if (wIndex & USB_INTRF_FUNC_SUSPEND_RW)
382 /* XXX enable remote wakeup */
390 case USB_RECIP_ENDPOINT:
392 case USB_ENDPOINT_HALT:
394 dep = dwc3_wIndex_to_dep(dwc, ctrl->wIndex);
397 if (set == 0 && (dep->flags & DWC3_EP_WEDGE))
399 ret = __dwc3_gadget_ep_set_halt(dep, set);
415 static int dwc3_ep0_set_address(struct dwc3 *dwc, struct usb_ctrlrequest *ctrl)
420 addr = le16_to_cpu(ctrl->wValue);
424 reg = dwc3_readl(dwc->regs, DWC3_DCFG);
425 reg &= ~(DWC3_DCFG_DEVADDR_MASK);
426 reg |= DWC3_DCFG_DEVADDR(addr);
427 dwc3_writel(dwc->regs, DWC3_DCFG, reg);
430 dwc->dev_state = DWC3_ADDRESS_STATE;
432 dwc->dev_state = DWC3_DEFAULT_STATE;
437 static int dwc3_ep0_delegate_req(struct dwc3 *dwc, struct usb_ctrlrequest *ctrl)
441 spin_unlock(&dwc->lock);
442 ret = dwc->gadget_driver->setup(&dwc->gadget, ctrl);
443 spin_lock(&dwc->lock);
447 static int dwc3_ep0_set_config(struct dwc3 *dwc, struct usb_ctrlrequest *ctrl)
452 dwc->start_config_issued = false;
453 cfg = le16_to_cpu(ctrl->wValue);
455 switch (dwc->dev_state) {
456 case DWC3_DEFAULT_STATE:
460 case DWC3_ADDRESS_STATE:
461 ret = dwc3_ep0_delegate_req(dwc, ctrl);
462 /* if the cfg matches and the cfg is non zero */
464 dwc->dev_state = DWC3_CONFIGURED_STATE;
467 case DWC3_CONFIGURED_STATE:
468 ret = dwc3_ep0_delegate_req(dwc, ctrl);
470 dwc->dev_state = DWC3_ADDRESS_STATE;
476 static int dwc3_ep0_std_request(struct dwc3 *dwc, struct usb_ctrlrequest *ctrl)
480 switch (ctrl->bRequest) {
481 case USB_REQ_GET_STATUS:
482 dev_vdbg(dwc->dev, "USB_REQ_GET_STATUS\n");
483 ret = dwc3_ep0_handle_status(dwc, ctrl);
485 case USB_REQ_CLEAR_FEATURE:
486 dev_vdbg(dwc->dev, "USB_REQ_CLEAR_FEATURE\n");
487 ret = dwc3_ep0_handle_feature(dwc, ctrl, 0);
489 case USB_REQ_SET_FEATURE:
490 dev_vdbg(dwc->dev, "USB_REQ_SET_FEATURE\n");
491 ret = dwc3_ep0_handle_feature(dwc, ctrl, 1);
493 case USB_REQ_SET_ADDRESS:
494 dev_vdbg(dwc->dev, "USB_REQ_SET_ADDRESS\n");
495 ret = dwc3_ep0_set_address(dwc, ctrl);
497 case USB_REQ_SET_CONFIGURATION:
498 dev_vdbg(dwc->dev, "USB_REQ_SET_CONFIGURATION\n");
499 ret = dwc3_ep0_set_config(dwc, ctrl);
501 case USB_REQ_SET_INTERFACE:
502 dev_vdbg(dwc->dev ,"USB_REQ_SET_INTERFACE");
503 dwc->start_config_issued = false;
506 dev_vdbg(dwc->dev, "Forwarding to gadget driver\n");
507 ret = dwc3_ep0_delegate_req(dwc, ctrl);
514 static void dwc3_ep0_inspect_setup(struct dwc3 *dwc,
515 const struct dwc3_event_depevt *event)
517 struct usb_ctrlrequest *ctrl = dwc->ctrl_req;
521 if (!dwc->gadget_driver)
524 len = le16_to_cpu(ctrl->wLength);
526 dwc->three_stage_setup = false;
527 dwc->ep0_expect_in = false;
528 dwc->ep0_next_event = DWC3_EP0_NRDY_STATUS;
530 dwc->three_stage_setup = true;
531 dwc->ep0_expect_in = !!(ctrl->bRequestType & USB_DIR_IN);
532 dwc->ep0_next_event = DWC3_EP0_NRDY_DATA;
535 if ((ctrl->bRequestType & USB_TYPE_MASK) == USB_TYPE_STANDARD)
536 ret = dwc3_ep0_std_request(dwc, ctrl);
538 ret = dwc3_ep0_delegate_req(dwc, ctrl);
544 dwc3_ep0_stall_and_restart(dwc);
547 static void dwc3_ep0_complete_data(struct dwc3 *dwc,
548 const struct dwc3_event_depevt *event)
550 struct dwc3_request *r = NULL;
551 struct usb_request *ur;
557 epnum = event->endpoint_number;
558 dep = dwc->eps[epnum];
560 dwc->ep0_next_event = DWC3_EP0_NRDY_STATUS;
562 if (!dwc->ep0_status_pending) {
563 r = next_request(&dwc->eps[0]->request_list);
566 ur = &dwc->ep0_usb_req;
567 dwc->ep0_status_pending = 0;
570 dwc3_trb_to_nat(dwc->ep0_trb, &trb);
572 if (dwc->ep0_bounced) {
573 struct dwc3_ep *ep0 = dwc->eps[0];
575 transferred = min_t(u32, ur->length,
576 ep0->endpoint.maxpacket - trb.length);
577 memcpy(ur->buf, dwc->ep0_bounce, transferred);
578 dwc->ep0_bounced = false;
580 transferred = ur->length - trb.length;
583 ur->actual += transferred;
585 if ((epnum & 1) && ur->actual < ur->length) {
586 /* for some reason we did not get everything out */
588 dwc3_ep0_stall_and_restart(dwc);
591 * handle the case where we have to send a zero packet. This
592 * seems to be case when req.length > maxpacket. Could it be?
595 dwc3_gadget_giveback(dep, r, 0);
599 static void dwc3_ep0_complete_req(struct dwc3 *dwc,
600 const struct dwc3_event_depevt *event)
602 struct dwc3_request *r;
607 if (!list_empty(&dep->request_list)) {
608 r = next_request(&dep->request_list);
610 dwc3_gadget_giveback(dep, r, 0);
613 dwc->ep0state = EP0_SETUP_PHASE;
614 dwc3_ep0_out_start(dwc);
617 static void dwc3_ep0_xfer_complete(struct dwc3 *dwc,
618 const struct dwc3_event_depevt *event)
620 struct dwc3_ep *dep = dwc->eps[event->endpoint_number];
622 dep->flags &= ~DWC3_EP_BUSY;
624 switch (dwc->ep0state) {
625 case EP0_SETUP_PHASE:
626 dev_vdbg(dwc->dev, "Inspecting Setup Bytes\n");
627 dwc3_ep0_inspect_setup(dwc, event);
631 dev_vdbg(dwc->dev, "Data Phase\n");
632 dwc3_ep0_complete_data(dwc, event);
635 case EP0_STATUS_PHASE:
636 dev_vdbg(dwc->dev, "Status Phase\n");
637 dwc3_ep0_complete_req(dwc, event);
640 WARN(true, "UNKNOWN ep0state %d\n", dwc->ep0state);
644 static void dwc3_ep0_do_control_setup(struct dwc3 *dwc,
645 const struct dwc3_event_depevt *event)
647 dwc->ep0state = EP0_SETUP_PHASE;
648 dwc3_ep0_out_start(dwc);
651 static void dwc3_ep0_do_control_data(struct dwc3 *dwc,
652 const struct dwc3_event_depevt *event)
655 struct dwc3_request *req;
659 dwc->ep0state = EP0_DATA_PHASE;
661 if (dwc->ep0_status_pending) {
662 dwc3_ep0_send_status_response(dwc);
666 if (list_empty(&dep->request_list)) {
667 dev_vdbg(dwc->dev, "pending request for EP0 Data phase\n");
668 dep->flags |= DWC3_EP_PENDING_REQUEST;
670 if (event->endpoint_number)
671 dep->flags |= DWC3_EP0_DIR_IN;
675 req = next_request(&dep->request_list);
676 req->direction = !!event->endpoint_number;
678 dwc->ep0state = EP0_DATA_PHASE;
679 if (req->request.length == 0) {
680 ret = dwc3_ep0_start_trans(dwc, event->endpoint_number,
681 dwc->ctrl_req_addr, 0,
682 DWC3_TRBCTL_CONTROL_DATA);
683 } else if ((req->request.length % dep->endpoint.maxpacket)
684 && (event->endpoint_number == 0)) {
685 dwc3_map_buffer_to_dma(req);
687 WARN_ON(req->request.length > dep->endpoint.maxpacket);
689 dwc->ep0_bounced = true;
692 * REVISIT in case request length is bigger than EP0
693 * wMaxPacketSize, we will need two chained TRBs to handle
696 ret = dwc3_ep0_start_trans(dwc, event->endpoint_number,
697 dwc->ep0_bounce_addr, dep->endpoint.maxpacket,
698 DWC3_TRBCTL_CONTROL_DATA);
700 dwc3_map_buffer_to_dma(req);
702 ret = dwc3_ep0_start_trans(dwc, event->endpoint_number,
703 req->request.dma, req->request.length,
704 DWC3_TRBCTL_CONTROL_DATA);
710 static void dwc3_ep0_do_control_status(struct dwc3 *dwc,
711 const struct dwc3_event_depevt *event)
716 dwc->ep0state = EP0_STATUS_PHASE;
718 type = dwc->three_stage_setup ? DWC3_TRBCTL_CONTROL_STATUS3
719 : DWC3_TRBCTL_CONTROL_STATUS2;
721 ret = dwc3_ep0_start_trans(dwc, event->endpoint_number,
722 dwc->ctrl_req_addr, 0, type);
727 static void dwc3_ep0_xfernotready(struct dwc3 *dwc,
728 const struct dwc3_event_depevt *event)
730 switch (event->status) {
731 case DEPEVT_STATUS_CONTROL_SETUP:
732 dev_vdbg(dwc->dev, "Control Setup\n");
733 dwc3_ep0_do_control_setup(dwc, event);
736 case DEPEVT_STATUS_CONTROL_DATA:
737 dev_vdbg(dwc->dev, "Control Data\n");
739 if (dwc->ep0_next_event != DWC3_EP0_NRDY_DATA) {
740 dev_vdbg(dwc->dev, "Expected %d got %d\n",
744 dwc3_ep0_stall_and_restart(dwc);
749 * One of the possible error cases is when Host _does_
750 * request for Data Phase, but it does so on the wrong
753 * Here, we already know ep0_next_event is DATA (see above),
754 * so we only need to check for direction.
756 if (dwc->ep0_expect_in != event->endpoint_number) {
757 dev_vdbg(dwc->dev, "Wrong direction for Data phase\n");
758 dwc3_ep0_stall_and_restart(dwc);
762 dwc3_ep0_do_control_data(dwc, event);
765 case DEPEVT_STATUS_CONTROL_STATUS:
766 dev_vdbg(dwc->dev, "Control Status\n");
768 if (dwc->ep0_next_event != DWC3_EP0_NRDY_STATUS) {
769 dev_vdbg(dwc->dev, "Expected %d got %d\n",
771 DWC3_EP0_NRDY_STATUS);
773 dwc3_ep0_stall_and_restart(dwc);
776 dwc3_ep0_do_control_status(dwc, event);
780 void dwc3_ep0_interrupt(struct dwc3 *dwc,
781 const const struct dwc3_event_depevt *event)
783 u8 epnum = event->endpoint_number;
785 dev_dbg(dwc->dev, "%s while ep%d%s in state '%s'\n",
786 dwc3_ep_event_string(event->endpoint_event),
787 epnum >> 1, (epnum & 1) ? "in" : "out",
788 dwc3_ep0_state_string(dwc->ep0state));
790 switch (event->endpoint_event) {
791 case DWC3_DEPEVT_XFERCOMPLETE:
792 dwc3_ep0_xfer_complete(dwc, event);
795 case DWC3_DEPEVT_XFERNOTREADY:
796 dwc3_ep0_xfernotready(dwc, event);
799 case DWC3_DEPEVT_XFERINPROGRESS:
800 case DWC3_DEPEVT_RXTXFIFOEVT:
801 case DWC3_DEPEVT_STREAMEVT:
802 case DWC3_DEPEVT_EPCMDCMPLT: