Bluetooth: hci_uart: Use generic functionality from Broadcom module
[linux/fpc-iii.git] / drivers / usb / dwc3 / gadget.c
bloba03a485205c787c74812f14337096b2831223cbc
1 /**
2 * gadget.c - DesignWare USB3 DRD Controller Gadget Framework Link
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 * This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 of
11 * the License as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
19 #include <linux/kernel.h>
20 #include <linux/delay.h>
21 #include <linux/slab.h>
22 #include <linux/spinlock.h>
23 #include <linux/platform_device.h>
24 #include <linux/pm_runtime.h>
25 #include <linux/interrupt.h>
26 #include <linux/io.h>
27 #include <linux/list.h>
28 #include <linux/dma-mapping.h>
30 #include <linux/usb/ch9.h>
31 #include <linux/usb/gadget.h>
33 #include "debug.h"
34 #include "core.h"
35 #include "gadget.h"
36 #include "io.h"
38 /**
39 * dwc3_gadget_set_test_mode - Enables USB2 Test Modes
40 * @dwc: pointer to our context structure
41 * @mode: the mode to set (J, K SE0 NAK, Force Enable)
43 * Caller should take care of locking. This function will
44 * return 0 on success or -EINVAL if wrong Test Selector
45 * is passed
47 int dwc3_gadget_set_test_mode(struct dwc3 *dwc, int mode)
49 u32 reg;
51 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
52 reg &= ~DWC3_DCTL_TSTCTRL_MASK;
54 switch (mode) {
55 case TEST_J:
56 case TEST_K:
57 case TEST_SE0_NAK:
58 case TEST_PACKET:
59 case TEST_FORCE_EN:
60 reg |= mode << 1;
61 break;
62 default:
63 return -EINVAL;
66 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
68 return 0;
71 /**
72 * dwc3_gadget_get_link_state - Gets current state of USB Link
73 * @dwc: pointer to our context structure
75 * Caller should take care of locking. This function will
76 * return the link state on success (>= 0) or -ETIMEDOUT.
78 int dwc3_gadget_get_link_state(struct dwc3 *dwc)
80 u32 reg;
82 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
84 return DWC3_DSTS_USBLNKST(reg);
87 /**
88 * dwc3_gadget_set_link_state - Sets USB Link to a particular State
89 * @dwc: pointer to our context structure
90 * @state: the state to put link into
92 * Caller should take care of locking. This function will
93 * return 0 on success or -ETIMEDOUT.
95 int dwc3_gadget_set_link_state(struct dwc3 *dwc, enum dwc3_link_state state)
97 int retries = 10000;
98 u32 reg;
101 * Wait until device controller is ready. Only applies to 1.94a and
102 * later RTL.
104 if (dwc->revision >= DWC3_REVISION_194A) {
105 while (--retries) {
106 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
107 if (reg & DWC3_DSTS_DCNRD)
108 udelay(5);
109 else
110 break;
113 if (retries <= 0)
114 return -ETIMEDOUT;
117 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
118 reg &= ~DWC3_DCTL_ULSTCHNGREQ_MASK;
120 /* set requested state */
121 reg |= DWC3_DCTL_ULSTCHNGREQ(state);
122 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
125 * The following code is racy when called from dwc3_gadget_wakeup,
126 * and is not needed, at least on newer versions
128 if (dwc->revision >= DWC3_REVISION_194A)
129 return 0;
131 /* wait for a change in DSTS */
132 retries = 10000;
133 while (--retries) {
134 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
136 if (DWC3_DSTS_USBLNKST(reg) == state)
137 return 0;
139 udelay(5);
142 dwc3_trace(trace_dwc3_gadget,
143 "link state change request timed out");
145 return -ETIMEDOUT;
149 * dwc3_gadget_resize_tx_fifos - reallocate fifo spaces for current use-case
150 * @dwc: pointer to our context structure
152 * This function will a best effort FIFO allocation in order
153 * to improve FIFO usage and throughput, while still allowing
154 * us to enable as many endpoints as possible.
156 * Keep in mind that this operation will be highly dependent
157 * on the configured size for RAM1 - which contains TxFifo -,
158 * the amount of endpoints enabled on coreConsultant tool, and
159 * the width of the Master Bus.
161 * In the ideal world, we would always be able to satisfy the
162 * following equation:
164 * ((512 + 2 * MDWIDTH-Bytes) + (Number of IN Endpoints - 1) * \
165 * (3 * (1024 + MDWIDTH-Bytes) + MDWIDTH-Bytes)) / MDWIDTH-Bytes
167 * Unfortunately, due to many variables that's not always the case.
169 int dwc3_gadget_resize_tx_fifos(struct dwc3 *dwc)
171 int last_fifo_depth = 0;
172 int ram1_depth;
173 int fifo_size;
174 int mdwidth;
175 int num;
177 if (!dwc->needs_fifo_resize)
178 return 0;
180 ram1_depth = DWC3_RAM1_DEPTH(dwc->hwparams.hwparams7);
181 mdwidth = DWC3_MDWIDTH(dwc->hwparams.hwparams0);
183 /* MDWIDTH is represented in bits, we need it in bytes */
184 mdwidth >>= 3;
187 * FIXME For now we will only allocate 1 wMaxPacketSize space
188 * for each enabled endpoint, later patches will come to
189 * improve this algorithm so that we better use the internal
190 * FIFO space
192 for (num = 0; num < dwc->num_in_eps; num++) {
193 /* bit0 indicates direction; 1 means IN ep */
194 struct dwc3_ep *dep = dwc->eps[(num << 1) | 1];
195 int mult = 1;
196 int tmp;
198 if (!(dep->flags & DWC3_EP_ENABLED))
199 continue;
201 if (usb_endpoint_xfer_bulk(dep->endpoint.desc)
202 || usb_endpoint_xfer_isoc(dep->endpoint.desc))
203 mult = 3;
206 * REVISIT: the following assumes we will always have enough
207 * space available on the FIFO RAM for all possible use cases.
208 * Make sure that's true somehow and change FIFO allocation
209 * accordingly.
211 * If we have Bulk or Isochronous endpoints, we want
212 * them to be able to be very, very fast. So we're giving
213 * those endpoints a fifo_size which is enough for 3 full
214 * packets
216 tmp = mult * (dep->endpoint.maxpacket + mdwidth);
217 tmp += mdwidth;
219 fifo_size = DIV_ROUND_UP(tmp, mdwidth);
221 fifo_size |= (last_fifo_depth << 16);
223 dwc3_trace(trace_dwc3_gadget, "%s: Fifo Addr %04x Size %d",
224 dep->name, last_fifo_depth, fifo_size & 0xffff);
226 dwc3_writel(dwc->regs, DWC3_GTXFIFOSIZ(num), fifo_size);
228 last_fifo_depth += (fifo_size & 0xffff);
231 return 0;
234 void dwc3_gadget_giveback(struct dwc3_ep *dep, struct dwc3_request *req,
235 int status)
237 struct dwc3 *dwc = dep->dwc;
238 int i;
240 if (req->queued) {
241 i = 0;
242 do {
243 dep->busy_slot++;
245 * Skip LINK TRB. We can't use req->trb and check for
246 * DWC3_TRBCTL_LINK_TRB because it points the TRB we
247 * just completed (not the LINK TRB).
249 if (((dep->busy_slot & DWC3_TRB_MASK) ==
250 DWC3_TRB_NUM- 1) &&
251 usb_endpoint_xfer_isoc(dep->endpoint.desc))
252 dep->busy_slot++;
253 } while(++i < req->request.num_mapped_sgs);
254 req->queued = false;
256 list_del(&req->list);
257 req->trb = NULL;
259 if (req->request.status == -EINPROGRESS)
260 req->request.status = status;
262 if (dwc->ep0_bounced && dep->number == 0)
263 dwc->ep0_bounced = false;
264 else
265 usb_gadget_unmap_request(&dwc->gadget, &req->request,
266 req->direction);
268 dev_dbg(dwc->dev, "request %p from %s completed %d/%d ===> %d\n",
269 req, dep->name, req->request.actual,
270 req->request.length, status);
271 trace_dwc3_gadget_giveback(req);
273 spin_unlock(&dwc->lock);
274 usb_gadget_giveback_request(&dep->endpoint, &req->request);
275 spin_lock(&dwc->lock);
278 int dwc3_send_gadget_generic_command(struct dwc3 *dwc, unsigned cmd, u32 param)
280 u32 timeout = 500;
281 u32 reg;
283 trace_dwc3_gadget_generic_cmd(cmd, param);
285 dwc3_writel(dwc->regs, DWC3_DGCMDPAR, param);
286 dwc3_writel(dwc->regs, DWC3_DGCMD, cmd | DWC3_DGCMD_CMDACT);
288 do {
289 reg = dwc3_readl(dwc->regs, DWC3_DGCMD);
290 if (!(reg & DWC3_DGCMD_CMDACT)) {
291 dwc3_trace(trace_dwc3_gadget,
292 "Command Complete --> %d",
293 DWC3_DGCMD_STATUS(reg));
294 return 0;
298 * We can't sleep here, because it's also called from
299 * interrupt context.
301 timeout--;
302 if (!timeout) {
303 dwc3_trace(trace_dwc3_gadget,
304 "Command Timed Out");
305 return -ETIMEDOUT;
307 udelay(1);
308 } while (1);
311 int dwc3_send_gadget_ep_cmd(struct dwc3 *dwc, unsigned ep,
312 unsigned cmd, struct dwc3_gadget_ep_cmd_params *params)
314 struct dwc3_ep *dep = dwc->eps[ep];
315 u32 timeout = 500;
316 u32 reg;
318 trace_dwc3_gadget_ep_cmd(dep, cmd, params);
320 dwc3_writel(dwc->regs, DWC3_DEPCMDPAR0(ep), params->param0);
321 dwc3_writel(dwc->regs, DWC3_DEPCMDPAR1(ep), params->param1);
322 dwc3_writel(dwc->regs, DWC3_DEPCMDPAR2(ep), params->param2);
324 dwc3_writel(dwc->regs, DWC3_DEPCMD(ep), cmd | DWC3_DEPCMD_CMDACT);
325 do {
326 reg = dwc3_readl(dwc->regs, DWC3_DEPCMD(ep));
327 if (!(reg & DWC3_DEPCMD_CMDACT)) {
328 dwc3_trace(trace_dwc3_gadget,
329 "Command Complete --> %d",
330 DWC3_DEPCMD_STATUS(reg));
331 return 0;
335 * We can't sleep here, because it is also called from
336 * interrupt context.
338 timeout--;
339 if (!timeout) {
340 dwc3_trace(trace_dwc3_gadget,
341 "Command Timed Out");
342 return -ETIMEDOUT;
345 udelay(1);
346 } while (1);
349 static dma_addr_t dwc3_trb_dma_offset(struct dwc3_ep *dep,
350 struct dwc3_trb *trb)
352 u32 offset = (char *) trb - (char *) dep->trb_pool;
354 return dep->trb_pool_dma + offset;
357 static int dwc3_alloc_trb_pool(struct dwc3_ep *dep)
359 struct dwc3 *dwc = dep->dwc;
361 if (dep->trb_pool)
362 return 0;
364 dep->trb_pool = dma_alloc_coherent(dwc->dev,
365 sizeof(struct dwc3_trb) * DWC3_TRB_NUM,
366 &dep->trb_pool_dma, GFP_KERNEL);
367 if (!dep->trb_pool) {
368 dev_err(dep->dwc->dev, "failed to allocate trb pool for %s\n",
369 dep->name);
370 return -ENOMEM;
373 return 0;
376 static void dwc3_free_trb_pool(struct dwc3_ep *dep)
378 struct dwc3 *dwc = dep->dwc;
380 dma_free_coherent(dwc->dev, sizeof(struct dwc3_trb) * DWC3_TRB_NUM,
381 dep->trb_pool, dep->trb_pool_dma);
383 dep->trb_pool = NULL;
384 dep->trb_pool_dma = 0;
387 static int dwc3_gadget_start_config(struct dwc3 *dwc, struct dwc3_ep *dep)
389 struct dwc3_gadget_ep_cmd_params params;
390 u32 cmd;
392 memset(&params, 0x00, sizeof(params));
394 if (dep->number != 1) {
395 cmd = DWC3_DEPCMD_DEPSTARTCFG;
396 /* XferRscIdx == 0 for ep0 and 2 for the remaining */
397 if (dep->number > 1) {
398 if (dwc->start_config_issued)
399 return 0;
400 dwc->start_config_issued = true;
401 cmd |= DWC3_DEPCMD_PARAM(2);
404 return dwc3_send_gadget_ep_cmd(dwc, 0, cmd, &params);
407 return 0;
410 static int dwc3_gadget_set_ep_config(struct dwc3 *dwc, struct dwc3_ep *dep,
411 const struct usb_endpoint_descriptor *desc,
412 const struct usb_ss_ep_comp_descriptor *comp_desc,
413 bool ignore, bool restore)
415 struct dwc3_gadget_ep_cmd_params params;
417 memset(&params, 0x00, sizeof(params));
419 params.param0 = DWC3_DEPCFG_EP_TYPE(usb_endpoint_type(desc))
420 | DWC3_DEPCFG_MAX_PACKET_SIZE(usb_endpoint_maxp(desc));
422 /* Burst size is only needed in SuperSpeed mode */
423 if (dwc->gadget.speed == USB_SPEED_SUPER) {
424 u32 burst = dep->endpoint.maxburst - 1;
426 params.param0 |= DWC3_DEPCFG_BURST_SIZE(burst);
429 if (ignore)
430 params.param0 |= DWC3_DEPCFG_IGN_SEQ_NUM;
432 if (restore) {
433 params.param0 |= DWC3_DEPCFG_ACTION_RESTORE;
434 params.param2 |= dep->saved_state;
437 params.param1 = DWC3_DEPCFG_XFER_COMPLETE_EN
438 | DWC3_DEPCFG_XFER_NOT_READY_EN;
440 if (usb_ss_max_streams(comp_desc) && usb_endpoint_xfer_bulk(desc)) {
441 params.param1 |= DWC3_DEPCFG_STREAM_CAPABLE
442 | DWC3_DEPCFG_STREAM_EVENT_EN;
443 dep->stream_capable = true;
446 if (!usb_endpoint_xfer_control(desc))
447 params.param1 |= DWC3_DEPCFG_XFER_IN_PROGRESS_EN;
450 * We are doing 1:1 mapping for endpoints, meaning
451 * Physical Endpoints 2 maps to Logical Endpoint 2 and
452 * so on. We consider the direction bit as part of the physical
453 * endpoint number. So USB endpoint 0x81 is 0x03.
455 params.param1 |= DWC3_DEPCFG_EP_NUMBER(dep->number);
458 * We must use the lower 16 TX FIFOs even though
459 * HW might have more
461 if (dep->direction)
462 params.param0 |= DWC3_DEPCFG_FIFO_NUMBER(dep->number >> 1);
464 if (desc->bInterval) {
465 params.param1 |= DWC3_DEPCFG_BINTERVAL_M1(desc->bInterval - 1);
466 dep->interval = 1 << (desc->bInterval - 1);
469 return dwc3_send_gadget_ep_cmd(dwc, dep->number,
470 DWC3_DEPCMD_SETEPCONFIG, &params);
473 static int dwc3_gadget_set_xfer_resource(struct dwc3 *dwc, struct dwc3_ep *dep)
475 struct dwc3_gadget_ep_cmd_params params;
477 memset(&params, 0x00, sizeof(params));
479 params.param0 = DWC3_DEPXFERCFG_NUM_XFER_RES(1);
481 return dwc3_send_gadget_ep_cmd(dwc, dep->number,
482 DWC3_DEPCMD_SETTRANSFRESOURCE, &params);
486 * __dwc3_gadget_ep_enable - Initializes a HW endpoint
487 * @dep: endpoint to be initialized
488 * @desc: USB Endpoint Descriptor
490 * Caller should take care of locking
492 static int __dwc3_gadget_ep_enable(struct dwc3_ep *dep,
493 const struct usb_endpoint_descriptor *desc,
494 const struct usb_ss_ep_comp_descriptor *comp_desc,
495 bool ignore, bool restore)
497 struct dwc3 *dwc = dep->dwc;
498 u32 reg;
499 int ret;
501 dwc3_trace(trace_dwc3_gadget, "Enabling %s", dep->name);
503 if (!(dep->flags & DWC3_EP_ENABLED)) {
504 ret = dwc3_gadget_start_config(dwc, dep);
505 if (ret)
506 return ret;
509 ret = dwc3_gadget_set_ep_config(dwc, dep, desc, comp_desc, ignore,
510 restore);
511 if (ret)
512 return ret;
514 if (!(dep->flags & DWC3_EP_ENABLED)) {
515 struct dwc3_trb *trb_st_hw;
516 struct dwc3_trb *trb_link;
518 ret = dwc3_gadget_set_xfer_resource(dwc, dep);
519 if (ret)
520 return ret;
522 dep->endpoint.desc = desc;
523 dep->comp_desc = comp_desc;
524 dep->type = usb_endpoint_type(desc);
525 dep->flags |= DWC3_EP_ENABLED;
527 reg = dwc3_readl(dwc->regs, DWC3_DALEPENA);
528 reg |= DWC3_DALEPENA_EP(dep->number);
529 dwc3_writel(dwc->regs, DWC3_DALEPENA, reg);
531 if (!usb_endpoint_xfer_isoc(desc))
532 return 0;
534 /* Link TRB for ISOC. The HWO bit is never reset */
535 trb_st_hw = &dep->trb_pool[0];
537 trb_link = &dep->trb_pool[DWC3_TRB_NUM - 1];
538 memset(trb_link, 0, sizeof(*trb_link));
540 trb_link->bpl = lower_32_bits(dwc3_trb_dma_offset(dep, trb_st_hw));
541 trb_link->bph = upper_32_bits(dwc3_trb_dma_offset(dep, trb_st_hw));
542 trb_link->ctrl |= DWC3_TRBCTL_LINK_TRB;
543 trb_link->ctrl |= DWC3_TRB_CTRL_HWO;
546 return 0;
549 static void dwc3_stop_active_transfer(struct dwc3 *dwc, u32 epnum, bool force);
550 static void dwc3_remove_requests(struct dwc3 *dwc, struct dwc3_ep *dep)
552 struct dwc3_request *req;
554 if (!list_empty(&dep->req_queued)) {
555 dwc3_stop_active_transfer(dwc, dep->number, true);
557 /* - giveback all requests to gadget driver */
558 while (!list_empty(&dep->req_queued)) {
559 req = next_request(&dep->req_queued);
561 dwc3_gadget_giveback(dep, req, -ESHUTDOWN);
565 while (!list_empty(&dep->request_list)) {
566 req = next_request(&dep->request_list);
568 dwc3_gadget_giveback(dep, req, -ESHUTDOWN);
573 * __dwc3_gadget_ep_disable - Disables a HW endpoint
574 * @dep: the endpoint to disable
576 * This function also removes requests which are currently processed ny the
577 * hardware and those which are not yet scheduled.
578 * Caller should take care of locking.
580 static int __dwc3_gadget_ep_disable(struct dwc3_ep *dep)
582 struct dwc3 *dwc = dep->dwc;
583 u32 reg;
585 dwc3_remove_requests(dwc, dep);
587 /* make sure HW endpoint isn't stalled */
588 if (dep->flags & DWC3_EP_STALL)
589 __dwc3_gadget_ep_set_halt(dep, 0, false);
591 reg = dwc3_readl(dwc->regs, DWC3_DALEPENA);
592 reg &= ~DWC3_DALEPENA_EP(dep->number);
593 dwc3_writel(dwc->regs, DWC3_DALEPENA, reg);
595 dep->stream_capable = false;
596 dep->endpoint.desc = NULL;
597 dep->comp_desc = NULL;
598 dep->type = 0;
599 dep->flags = 0;
601 return 0;
604 /* -------------------------------------------------------------------------- */
606 static int dwc3_gadget_ep0_enable(struct usb_ep *ep,
607 const struct usb_endpoint_descriptor *desc)
609 return -EINVAL;
612 static int dwc3_gadget_ep0_disable(struct usb_ep *ep)
614 return -EINVAL;
617 /* -------------------------------------------------------------------------- */
619 static int dwc3_gadget_ep_enable(struct usb_ep *ep,
620 const struct usb_endpoint_descriptor *desc)
622 struct dwc3_ep *dep;
623 struct dwc3 *dwc;
624 unsigned long flags;
625 int ret;
627 if (!ep || !desc || desc->bDescriptorType != USB_DT_ENDPOINT) {
628 pr_debug("dwc3: invalid parameters\n");
629 return -EINVAL;
632 if (!desc->wMaxPacketSize) {
633 pr_debug("dwc3: missing wMaxPacketSize\n");
634 return -EINVAL;
637 dep = to_dwc3_ep(ep);
638 dwc = dep->dwc;
640 if (dep->flags & DWC3_EP_ENABLED) {
641 dev_WARN_ONCE(dwc->dev, true, "%s is already enabled\n",
642 dep->name);
643 return 0;
646 switch (usb_endpoint_type(desc)) {
647 case USB_ENDPOINT_XFER_CONTROL:
648 strlcat(dep->name, "-control", sizeof(dep->name));
649 break;
650 case USB_ENDPOINT_XFER_ISOC:
651 strlcat(dep->name, "-isoc", sizeof(dep->name));
652 break;
653 case USB_ENDPOINT_XFER_BULK:
654 strlcat(dep->name, "-bulk", sizeof(dep->name));
655 break;
656 case USB_ENDPOINT_XFER_INT:
657 strlcat(dep->name, "-int", sizeof(dep->name));
658 break;
659 default:
660 dev_err(dwc->dev, "invalid endpoint transfer type\n");
663 spin_lock_irqsave(&dwc->lock, flags);
664 ret = __dwc3_gadget_ep_enable(dep, desc, ep->comp_desc, false, false);
665 spin_unlock_irqrestore(&dwc->lock, flags);
667 return ret;
670 static int dwc3_gadget_ep_disable(struct usb_ep *ep)
672 struct dwc3_ep *dep;
673 struct dwc3 *dwc;
674 unsigned long flags;
675 int ret;
677 if (!ep) {
678 pr_debug("dwc3: invalid parameters\n");
679 return -EINVAL;
682 dep = to_dwc3_ep(ep);
683 dwc = dep->dwc;
685 if (!(dep->flags & DWC3_EP_ENABLED)) {
686 dev_WARN_ONCE(dwc->dev, true, "%s is already disabled\n",
687 dep->name);
688 return 0;
691 snprintf(dep->name, sizeof(dep->name), "ep%d%s",
692 dep->number >> 1,
693 (dep->number & 1) ? "in" : "out");
695 spin_lock_irqsave(&dwc->lock, flags);
696 ret = __dwc3_gadget_ep_disable(dep);
697 spin_unlock_irqrestore(&dwc->lock, flags);
699 return ret;
702 static struct usb_request *dwc3_gadget_ep_alloc_request(struct usb_ep *ep,
703 gfp_t gfp_flags)
705 struct dwc3_request *req;
706 struct dwc3_ep *dep = to_dwc3_ep(ep);
708 req = kzalloc(sizeof(*req), gfp_flags);
709 if (!req)
710 return NULL;
712 req->epnum = dep->number;
713 req->dep = dep;
715 trace_dwc3_alloc_request(req);
717 return &req->request;
720 static void dwc3_gadget_ep_free_request(struct usb_ep *ep,
721 struct usb_request *request)
723 struct dwc3_request *req = to_dwc3_request(request);
725 trace_dwc3_free_request(req);
726 kfree(req);
730 * dwc3_prepare_one_trb - setup one TRB from one request
731 * @dep: endpoint for which this request is prepared
732 * @req: dwc3_request pointer
734 static void dwc3_prepare_one_trb(struct dwc3_ep *dep,
735 struct dwc3_request *req, dma_addr_t dma,
736 unsigned length, unsigned last, unsigned chain, unsigned node)
738 struct dwc3_trb *trb;
740 dwc3_trace(trace_dwc3_gadget, "%s: req %p dma %08llx length %d%s%s",
741 dep->name, req, (unsigned long long) dma,
742 length, last ? " last" : "",
743 chain ? " chain" : "");
746 trb = &dep->trb_pool[dep->free_slot & DWC3_TRB_MASK];
748 if (!req->trb) {
749 dwc3_gadget_move_request_queued(req);
750 req->trb = trb;
751 req->trb_dma = dwc3_trb_dma_offset(dep, trb);
752 req->start_slot = dep->free_slot & DWC3_TRB_MASK;
755 dep->free_slot++;
756 /* Skip the LINK-TRB on ISOC */
757 if (((dep->free_slot & DWC3_TRB_MASK) == DWC3_TRB_NUM - 1) &&
758 usb_endpoint_xfer_isoc(dep->endpoint.desc))
759 dep->free_slot++;
761 trb->size = DWC3_TRB_SIZE_LENGTH(length);
762 trb->bpl = lower_32_bits(dma);
763 trb->bph = upper_32_bits(dma);
765 switch (usb_endpoint_type(dep->endpoint.desc)) {
766 case USB_ENDPOINT_XFER_CONTROL:
767 trb->ctrl = DWC3_TRBCTL_CONTROL_SETUP;
768 break;
770 case USB_ENDPOINT_XFER_ISOC:
771 if (!node)
772 trb->ctrl = DWC3_TRBCTL_ISOCHRONOUS_FIRST;
773 else
774 trb->ctrl = DWC3_TRBCTL_ISOCHRONOUS;
775 break;
777 case USB_ENDPOINT_XFER_BULK:
778 case USB_ENDPOINT_XFER_INT:
779 trb->ctrl = DWC3_TRBCTL_NORMAL;
780 break;
781 default:
783 * This is only possible with faulty memory because we
784 * checked it already :)
786 BUG();
789 if (!req->request.no_interrupt && !chain)
790 trb->ctrl |= DWC3_TRB_CTRL_IOC;
792 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
793 trb->ctrl |= DWC3_TRB_CTRL_ISP_IMI;
794 trb->ctrl |= DWC3_TRB_CTRL_CSP;
795 } else if (last) {
796 trb->ctrl |= DWC3_TRB_CTRL_LST;
799 if (chain)
800 trb->ctrl |= DWC3_TRB_CTRL_CHN;
802 if (usb_endpoint_xfer_bulk(dep->endpoint.desc) && dep->stream_capable)
803 trb->ctrl |= DWC3_TRB_CTRL_SID_SOFN(req->request.stream_id);
805 trb->ctrl |= DWC3_TRB_CTRL_HWO;
807 trace_dwc3_prepare_trb(dep, trb);
811 * dwc3_prepare_trbs - setup TRBs from requests
812 * @dep: endpoint for which requests are being prepared
813 * @starting: true if the endpoint is idle and no requests are queued.
815 * The function goes through the requests list and sets up TRBs for the
816 * transfers. The function returns once there are no more TRBs available or
817 * it runs out of requests.
819 static void dwc3_prepare_trbs(struct dwc3_ep *dep, bool starting)
821 struct dwc3_request *req, *n;
822 u32 trbs_left;
823 u32 max;
824 unsigned int last_one = 0;
826 BUILD_BUG_ON_NOT_POWER_OF_2(DWC3_TRB_NUM);
828 /* the first request must not be queued */
829 trbs_left = (dep->busy_slot - dep->free_slot) & DWC3_TRB_MASK;
831 /* Can't wrap around on a non-isoc EP since there's no link TRB */
832 if (!usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
833 max = DWC3_TRB_NUM - (dep->free_slot & DWC3_TRB_MASK);
834 if (trbs_left > max)
835 trbs_left = max;
839 * If busy & slot are equal than it is either full or empty. If we are
840 * starting to process requests then we are empty. Otherwise we are
841 * full and don't do anything
843 if (!trbs_left) {
844 if (!starting)
845 return;
846 trbs_left = DWC3_TRB_NUM;
848 * In case we start from scratch, we queue the ISOC requests
849 * starting from slot 1. This is done because we use ring
850 * buffer and have no LST bit to stop us. Instead, we place
851 * IOC bit every TRB_NUM/4. We try to avoid having an interrupt
852 * after the first request so we start at slot 1 and have
853 * 7 requests proceed before we hit the first IOC.
854 * Other transfer types don't use the ring buffer and are
855 * processed from the first TRB until the last one. Since we
856 * don't wrap around we have to start at the beginning.
858 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
859 dep->busy_slot = 1;
860 dep->free_slot = 1;
861 } else {
862 dep->busy_slot = 0;
863 dep->free_slot = 0;
867 /* The last TRB is a link TRB, not used for xfer */
868 if ((trbs_left <= 1) && usb_endpoint_xfer_isoc(dep->endpoint.desc))
869 return;
871 list_for_each_entry_safe(req, n, &dep->request_list, list) {
872 unsigned length;
873 dma_addr_t dma;
874 last_one = false;
876 if (req->request.num_mapped_sgs > 0) {
877 struct usb_request *request = &req->request;
878 struct scatterlist *sg = request->sg;
879 struct scatterlist *s;
880 int i;
882 for_each_sg(sg, s, request->num_mapped_sgs, i) {
883 unsigned chain = true;
885 length = sg_dma_len(s);
886 dma = sg_dma_address(s);
888 if (i == (request->num_mapped_sgs - 1) ||
889 sg_is_last(s)) {
890 if (list_empty(&dep->request_list))
891 last_one = true;
892 chain = false;
895 trbs_left--;
896 if (!trbs_left)
897 last_one = true;
899 if (last_one)
900 chain = false;
902 dwc3_prepare_one_trb(dep, req, dma, length,
903 last_one, chain, i);
905 if (last_one)
906 break;
909 if (last_one)
910 break;
911 } else {
912 dma = req->request.dma;
913 length = req->request.length;
914 trbs_left--;
916 if (!trbs_left)
917 last_one = 1;
919 /* Is this the last request? */
920 if (list_is_last(&req->list, &dep->request_list))
921 last_one = 1;
923 dwc3_prepare_one_trb(dep, req, dma, length,
924 last_one, false, 0);
926 if (last_one)
927 break;
932 static int __dwc3_gadget_kick_transfer(struct dwc3_ep *dep, u16 cmd_param,
933 int start_new)
935 struct dwc3_gadget_ep_cmd_params params;
936 struct dwc3_request *req;
937 struct dwc3 *dwc = dep->dwc;
938 int ret;
939 u32 cmd;
941 if (start_new && (dep->flags & DWC3_EP_BUSY)) {
942 dwc3_trace(trace_dwc3_gadget, "%s: endpoint busy", dep->name);
943 return -EBUSY;
945 dep->flags &= ~DWC3_EP_PENDING_REQUEST;
948 * If we are getting here after a short-out-packet we don't enqueue any
949 * new requests as we try to set the IOC bit only on the last request.
951 if (start_new) {
952 if (list_empty(&dep->req_queued))
953 dwc3_prepare_trbs(dep, start_new);
955 /* req points to the first request which will be sent */
956 req = next_request(&dep->req_queued);
957 } else {
958 dwc3_prepare_trbs(dep, start_new);
961 * req points to the first request where HWO changed from 0 to 1
963 req = next_request(&dep->req_queued);
965 if (!req) {
966 dep->flags |= DWC3_EP_PENDING_REQUEST;
967 return 0;
970 memset(&params, 0, sizeof(params));
972 if (start_new) {
973 params.param0 = upper_32_bits(req->trb_dma);
974 params.param1 = lower_32_bits(req->trb_dma);
975 cmd = DWC3_DEPCMD_STARTTRANSFER;
976 } else {
977 cmd = DWC3_DEPCMD_UPDATETRANSFER;
980 cmd |= DWC3_DEPCMD_PARAM(cmd_param);
981 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number, cmd, &params);
982 if (ret < 0) {
983 dev_dbg(dwc->dev, "failed to send STARTTRANSFER command\n");
986 * FIXME we need to iterate over the list of requests
987 * here and stop, unmap, free and del each of the linked
988 * requests instead of what we do now.
990 usb_gadget_unmap_request(&dwc->gadget, &req->request,
991 req->direction);
992 list_del(&req->list);
993 return ret;
996 dep->flags |= DWC3_EP_BUSY;
998 if (start_new) {
999 dep->resource_index = dwc3_gadget_ep_get_transfer_index(dwc,
1000 dep->number);
1001 WARN_ON_ONCE(!dep->resource_index);
1004 return 0;
1007 static void __dwc3_gadget_start_isoc(struct dwc3 *dwc,
1008 struct dwc3_ep *dep, u32 cur_uf)
1010 u32 uf;
1012 if (list_empty(&dep->request_list)) {
1013 dwc3_trace(trace_dwc3_gadget,
1014 "ISOC ep %s run out for requests",
1015 dep->name);
1016 dep->flags |= DWC3_EP_PENDING_REQUEST;
1017 return;
1020 /* 4 micro frames in the future */
1021 uf = cur_uf + dep->interval * 4;
1023 __dwc3_gadget_kick_transfer(dep, uf, 1);
1026 static void dwc3_gadget_start_isoc(struct dwc3 *dwc,
1027 struct dwc3_ep *dep, const struct dwc3_event_depevt *event)
1029 u32 cur_uf, mask;
1031 mask = ~(dep->interval - 1);
1032 cur_uf = event->parameters & mask;
1034 __dwc3_gadget_start_isoc(dwc, dep, cur_uf);
1037 static int __dwc3_gadget_ep_queue(struct dwc3_ep *dep, struct dwc3_request *req)
1039 struct dwc3 *dwc = dep->dwc;
1040 int ret;
1042 req->request.actual = 0;
1043 req->request.status = -EINPROGRESS;
1044 req->direction = dep->direction;
1045 req->epnum = dep->number;
1048 * We only add to our list of requests now and
1049 * start consuming the list once we get XferNotReady
1050 * IRQ.
1052 * That way, we avoid doing anything that we don't need
1053 * to do now and defer it until the point we receive a
1054 * particular token from the Host side.
1056 * This will also avoid Host cancelling URBs due to too
1057 * many NAKs.
1059 ret = usb_gadget_map_request(&dwc->gadget, &req->request,
1060 dep->direction);
1061 if (ret)
1062 return ret;
1064 list_add_tail(&req->list, &dep->request_list);
1067 * There are a few special cases:
1069 * 1. XferNotReady with empty list of requests. We need to kick the
1070 * transfer here in that situation, otherwise we will be NAKing
1071 * forever. If we get XferNotReady before gadget driver has a
1072 * chance to queue a request, we will ACK the IRQ but won't be
1073 * able to receive the data until the next request is queued.
1074 * The following code is handling exactly that.
1077 if (dep->flags & DWC3_EP_PENDING_REQUEST) {
1079 * If xfernotready is already elapsed and it is a case
1080 * of isoc transfer, then issue END TRANSFER, so that
1081 * you can receive xfernotready again and can have
1082 * notion of current microframe.
1084 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
1085 if (list_empty(&dep->req_queued)) {
1086 dwc3_stop_active_transfer(dwc, dep->number, true);
1087 dep->flags = DWC3_EP_ENABLED;
1089 return 0;
1092 ret = __dwc3_gadget_kick_transfer(dep, 0, true);
1093 if (ret && ret != -EBUSY)
1094 dev_dbg(dwc->dev, "%s: failed to kick transfers\n",
1095 dep->name);
1096 return ret;
1100 * 2. XferInProgress on Isoc EP with an active transfer. We need to
1101 * kick the transfer here after queuing a request, otherwise the
1102 * core may not see the modified TRB(s).
1104 if (usb_endpoint_xfer_isoc(dep->endpoint.desc) &&
1105 (dep->flags & DWC3_EP_BUSY) &&
1106 !(dep->flags & DWC3_EP_MISSED_ISOC)) {
1107 WARN_ON_ONCE(!dep->resource_index);
1108 ret = __dwc3_gadget_kick_transfer(dep, dep->resource_index,
1109 false);
1110 if (ret && ret != -EBUSY)
1111 dev_dbg(dwc->dev, "%s: failed to kick transfers\n",
1112 dep->name);
1113 return ret;
1117 * 4. Stream Capable Bulk Endpoints. We need to start the transfer
1118 * right away, otherwise host will not know we have streams to be
1119 * handled.
1121 if (dep->stream_capable) {
1122 ret = __dwc3_gadget_kick_transfer(dep, 0, true);
1123 if (ret && ret != -EBUSY)
1124 dev_dbg(dwc->dev, "%s: failed to kick transfers\n",
1125 dep->name);
1128 return 0;
1131 static int dwc3_gadget_ep_queue(struct usb_ep *ep, struct usb_request *request,
1132 gfp_t gfp_flags)
1134 struct dwc3_request *req = to_dwc3_request(request);
1135 struct dwc3_ep *dep = to_dwc3_ep(ep);
1136 struct dwc3 *dwc = dep->dwc;
1138 unsigned long flags;
1140 int ret;
1142 spin_lock_irqsave(&dwc->lock, flags);
1143 if (!dep->endpoint.desc) {
1144 dev_dbg(dwc->dev, "trying to queue request %p to disabled %s\n",
1145 request, ep->name);
1146 ret = -ESHUTDOWN;
1147 goto out;
1150 if (WARN(req->dep != dep, "request %p belongs to '%s'\n",
1151 request, req->dep->name)) {
1152 ret = -EINVAL;
1153 goto out;
1156 trace_dwc3_ep_queue(req);
1158 ret = __dwc3_gadget_ep_queue(dep, req);
1160 out:
1161 spin_unlock_irqrestore(&dwc->lock, flags);
1163 return ret;
1166 static int dwc3_gadget_ep_dequeue(struct usb_ep *ep,
1167 struct usb_request *request)
1169 struct dwc3_request *req = to_dwc3_request(request);
1170 struct dwc3_request *r = NULL;
1172 struct dwc3_ep *dep = to_dwc3_ep(ep);
1173 struct dwc3 *dwc = dep->dwc;
1175 unsigned long flags;
1176 int ret = 0;
1178 trace_dwc3_ep_dequeue(req);
1180 spin_lock_irqsave(&dwc->lock, flags);
1182 list_for_each_entry(r, &dep->request_list, list) {
1183 if (r == req)
1184 break;
1187 if (r != req) {
1188 list_for_each_entry(r, &dep->req_queued, list) {
1189 if (r == req)
1190 break;
1192 if (r == req) {
1193 /* wait until it is processed */
1194 dwc3_stop_active_transfer(dwc, dep->number, true);
1195 goto out1;
1197 dev_err(dwc->dev, "request %p was not queued to %s\n",
1198 request, ep->name);
1199 ret = -EINVAL;
1200 goto out0;
1203 out1:
1204 /* giveback the request */
1205 dwc3_gadget_giveback(dep, req, -ECONNRESET);
1207 out0:
1208 spin_unlock_irqrestore(&dwc->lock, flags);
1210 return ret;
1213 int __dwc3_gadget_ep_set_halt(struct dwc3_ep *dep, int value, int protocol)
1215 struct dwc3_gadget_ep_cmd_params params;
1216 struct dwc3 *dwc = dep->dwc;
1217 int ret;
1219 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
1220 dev_err(dwc->dev, "%s is of Isochronous type\n", dep->name);
1221 return -EINVAL;
1224 memset(&params, 0x00, sizeof(params));
1226 if (value) {
1227 if (!protocol && ((dep->direction && dep->flags & DWC3_EP_BUSY) ||
1228 (!list_empty(&dep->req_queued) ||
1229 !list_empty(&dep->request_list)))) {
1230 dev_dbg(dwc->dev, "%s: pending request, cannot halt\n",
1231 dep->name);
1232 return -EAGAIN;
1235 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number,
1236 DWC3_DEPCMD_SETSTALL, &params);
1237 if (ret)
1238 dev_err(dwc->dev, "failed to set STALL on %s\n",
1239 dep->name);
1240 else
1241 dep->flags |= DWC3_EP_STALL;
1242 } else {
1243 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number,
1244 DWC3_DEPCMD_CLEARSTALL, &params);
1245 if (ret)
1246 dev_err(dwc->dev, "failed to clear STALL on %s\n",
1247 dep->name);
1248 else
1249 dep->flags &= ~(DWC3_EP_STALL | DWC3_EP_WEDGE);
1252 return ret;
1255 static int dwc3_gadget_ep_set_halt(struct usb_ep *ep, int value)
1257 struct dwc3_ep *dep = to_dwc3_ep(ep);
1258 struct dwc3 *dwc = dep->dwc;
1260 unsigned long flags;
1262 int ret;
1264 spin_lock_irqsave(&dwc->lock, flags);
1265 ret = __dwc3_gadget_ep_set_halt(dep, value, false);
1266 spin_unlock_irqrestore(&dwc->lock, flags);
1268 return ret;
1271 static int dwc3_gadget_ep_set_wedge(struct usb_ep *ep)
1273 struct dwc3_ep *dep = to_dwc3_ep(ep);
1274 struct dwc3 *dwc = dep->dwc;
1275 unsigned long flags;
1276 int ret;
1278 spin_lock_irqsave(&dwc->lock, flags);
1279 dep->flags |= DWC3_EP_WEDGE;
1281 if (dep->number == 0 || dep->number == 1)
1282 ret = __dwc3_gadget_ep0_set_halt(ep, 1);
1283 else
1284 ret = __dwc3_gadget_ep_set_halt(dep, 1, false);
1285 spin_unlock_irqrestore(&dwc->lock, flags);
1287 return ret;
1290 /* -------------------------------------------------------------------------- */
1292 static struct usb_endpoint_descriptor dwc3_gadget_ep0_desc = {
1293 .bLength = USB_DT_ENDPOINT_SIZE,
1294 .bDescriptorType = USB_DT_ENDPOINT,
1295 .bmAttributes = USB_ENDPOINT_XFER_CONTROL,
1298 static const struct usb_ep_ops dwc3_gadget_ep0_ops = {
1299 .enable = dwc3_gadget_ep0_enable,
1300 .disable = dwc3_gadget_ep0_disable,
1301 .alloc_request = dwc3_gadget_ep_alloc_request,
1302 .free_request = dwc3_gadget_ep_free_request,
1303 .queue = dwc3_gadget_ep0_queue,
1304 .dequeue = dwc3_gadget_ep_dequeue,
1305 .set_halt = dwc3_gadget_ep0_set_halt,
1306 .set_wedge = dwc3_gadget_ep_set_wedge,
1309 static const struct usb_ep_ops dwc3_gadget_ep_ops = {
1310 .enable = dwc3_gadget_ep_enable,
1311 .disable = dwc3_gadget_ep_disable,
1312 .alloc_request = dwc3_gadget_ep_alloc_request,
1313 .free_request = dwc3_gadget_ep_free_request,
1314 .queue = dwc3_gadget_ep_queue,
1315 .dequeue = dwc3_gadget_ep_dequeue,
1316 .set_halt = dwc3_gadget_ep_set_halt,
1317 .set_wedge = dwc3_gadget_ep_set_wedge,
1320 /* -------------------------------------------------------------------------- */
1322 static int dwc3_gadget_get_frame(struct usb_gadget *g)
1324 struct dwc3 *dwc = gadget_to_dwc(g);
1325 u32 reg;
1327 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
1328 return DWC3_DSTS_SOFFN(reg);
1331 static int dwc3_gadget_wakeup(struct usb_gadget *g)
1333 struct dwc3 *dwc = gadget_to_dwc(g);
1335 unsigned long timeout;
1336 unsigned long flags;
1338 u32 reg;
1340 int ret = 0;
1342 u8 link_state;
1343 u8 speed;
1345 spin_lock_irqsave(&dwc->lock, flags);
1348 * According to the Databook Remote wakeup request should
1349 * be issued only when the device is in early suspend state.
1351 * We can check that via USB Link State bits in DSTS register.
1353 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
1355 speed = reg & DWC3_DSTS_CONNECTSPD;
1356 if (speed == DWC3_DSTS_SUPERSPEED) {
1357 dev_dbg(dwc->dev, "no wakeup on SuperSpeed\n");
1358 ret = -EINVAL;
1359 goto out;
1362 link_state = DWC3_DSTS_USBLNKST(reg);
1364 switch (link_state) {
1365 case DWC3_LINK_STATE_RX_DET: /* in HS, means Early Suspend */
1366 case DWC3_LINK_STATE_U3: /* in HS, means SUSPEND */
1367 break;
1368 default:
1369 dev_dbg(dwc->dev, "can't wakeup from link state %d\n",
1370 link_state);
1371 ret = -EINVAL;
1372 goto out;
1375 ret = dwc3_gadget_set_link_state(dwc, DWC3_LINK_STATE_RECOV);
1376 if (ret < 0) {
1377 dev_err(dwc->dev, "failed to put link in Recovery\n");
1378 goto out;
1381 /* Recent versions do this automatically */
1382 if (dwc->revision < DWC3_REVISION_194A) {
1383 /* write zeroes to Link Change Request */
1384 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
1385 reg &= ~DWC3_DCTL_ULSTCHNGREQ_MASK;
1386 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
1389 /* poll until Link State changes to ON */
1390 timeout = jiffies + msecs_to_jiffies(100);
1392 while (!time_after(jiffies, timeout)) {
1393 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
1395 /* in HS, means ON */
1396 if (DWC3_DSTS_USBLNKST(reg) == DWC3_LINK_STATE_U0)
1397 break;
1400 if (DWC3_DSTS_USBLNKST(reg) != DWC3_LINK_STATE_U0) {
1401 dev_err(dwc->dev, "failed to send remote wakeup\n");
1402 ret = -EINVAL;
1405 out:
1406 spin_unlock_irqrestore(&dwc->lock, flags);
1408 return ret;
1411 static int dwc3_gadget_set_selfpowered(struct usb_gadget *g,
1412 int is_selfpowered)
1414 struct dwc3 *dwc = gadget_to_dwc(g);
1415 unsigned long flags;
1417 spin_lock_irqsave(&dwc->lock, flags);
1418 g->is_selfpowered = !!is_selfpowered;
1419 spin_unlock_irqrestore(&dwc->lock, flags);
1421 return 0;
1424 static int dwc3_gadget_run_stop(struct dwc3 *dwc, int is_on, int suspend)
1426 u32 reg;
1427 u32 timeout = 500;
1429 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
1430 if (is_on) {
1431 if (dwc->revision <= DWC3_REVISION_187A) {
1432 reg &= ~DWC3_DCTL_TRGTULST_MASK;
1433 reg |= DWC3_DCTL_TRGTULST_RX_DET;
1436 if (dwc->revision >= DWC3_REVISION_194A)
1437 reg &= ~DWC3_DCTL_KEEP_CONNECT;
1438 reg |= DWC3_DCTL_RUN_STOP;
1440 if (dwc->has_hibernation)
1441 reg |= DWC3_DCTL_KEEP_CONNECT;
1443 dwc->pullups_connected = true;
1444 } else {
1445 reg &= ~DWC3_DCTL_RUN_STOP;
1447 if (dwc->has_hibernation && !suspend)
1448 reg &= ~DWC3_DCTL_KEEP_CONNECT;
1450 dwc->pullups_connected = false;
1453 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
1455 do {
1456 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
1457 if (is_on) {
1458 if (!(reg & DWC3_DSTS_DEVCTRLHLT))
1459 break;
1460 } else {
1461 if (reg & DWC3_DSTS_DEVCTRLHLT)
1462 break;
1464 timeout--;
1465 if (!timeout)
1466 return -ETIMEDOUT;
1467 udelay(1);
1468 } while (1);
1470 dwc3_trace(trace_dwc3_gadget, "gadget %s data soft-%s",
1471 dwc->gadget_driver
1472 ? dwc->gadget_driver->function : "no-function",
1473 is_on ? "connect" : "disconnect");
1475 return 0;
1478 static int dwc3_gadget_pullup(struct usb_gadget *g, int is_on)
1480 struct dwc3 *dwc = gadget_to_dwc(g);
1481 unsigned long flags;
1482 int ret;
1484 is_on = !!is_on;
1486 spin_lock_irqsave(&dwc->lock, flags);
1487 ret = dwc3_gadget_run_stop(dwc, is_on, false);
1488 spin_unlock_irqrestore(&dwc->lock, flags);
1490 return ret;
1493 static void dwc3_gadget_enable_irq(struct dwc3 *dwc)
1495 u32 reg;
1497 /* Enable all but Start and End of Frame IRQs */
1498 reg = (DWC3_DEVTEN_VNDRDEVTSTRCVEDEN |
1499 DWC3_DEVTEN_EVNTOVERFLOWEN |
1500 DWC3_DEVTEN_CMDCMPLTEN |
1501 DWC3_DEVTEN_ERRTICERREN |
1502 DWC3_DEVTEN_WKUPEVTEN |
1503 DWC3_DEVTEN_ULSTCNGEN |
1504 DWC3_DEVTEN_CONNECTDONEEN |
1505 DWC3_DEVTEN_USBRSTEN |
1506 DWC3_DEVTEN_DISCONNEVTEN);
1508 dwc3_writel(dwc->regs, DWC3_DEVTEN, reg);
1511 static void dwc3_gadget_disable_irq(struct dwc3 *dwc)
1513 /* mask all interrupts */
1514 dwc3_writel(dwc->regs, DWC3_DEVTEN, 0x00);
1517 static irqreturn_t dwc3_interrupt(int irq, void *_dwc);
1518 static irqreturn_t dwc3_thread_interrupt(int irq, void *_dwc);
1520 static int dwc3_gadget_start(struct usb_gadget *g,
1521 struct usb_gadget_driver *driver)
1523 struct dwc3 *dwc = gadget_to_dwc(g);
1524 struct dwc3_ep *dep;
1525 unsigned long flags;
1526 int ret = 0;
1527 int irq;
1528 u32 reg;
1530 irq = platform_get_irq(to_platform_device(dwc->dev), 0);
1531 ret = request_threaded_irq(irq, dwc3_interrupt, dwc3_thread_interrupt,
1532 IRQF_SHARED, "dwc3", dwc);
1533 if (ret) {
1534 dev_err(dwc->dev, "failed to request irq #%d --> %d\n",
1535 irq, ret);
1536 goto err0;
1539 spin_lock_irqsave(&dwc->lock, flags);
1541 if (dwc->gadget_driver) {
1542 dev_err(dwc->dev, "%s is already bound to %s\n",
1543 dwc->gadget.name,
1544 dwc->gadget_driver->driver.name);
1545 ret = -EBUSY;
1546 goto err1;
1549 dwc->gadget_driver = driver;
1551 reg = dwc3_readl(dwc->regs, DWC3_DCFG);
1552 reg &= ~(DWC3_DCFG_SPEED_MASK);
1555 * WORKAROUND: DWC3 revision < 2.20a have an issue
1556 * which would cause metastability state on Run/Stop
1557 * bit if we try to force the IP to USB2-only mode.
1559 * Because of that, we cannot configure the IP to any
1560 * speed other than the SuperSpeed
1562 * Refers to:
1564 * STAR#9000525659: Clock Domain Crossing on DCTL in
1565 * USB 2.0 Mode
1567 if (dwc->revision < DWC3_REVISION_220A) {
1568 reg |= DWC3_DCFG_SUPERSPEED;
1569 } else {
1570 switch (dwc->maximum_speed) {
1571 case USB_SPEED_LOW:
1572 reg |= DWC3_DSTS_LOWSPEED;
1573 break;
1574 case USB_SPEED_FULL:
1575 reg |= DWC3_DSTS_FULLSPEED1;
1576 break;
1577 case USB_SPEED_HIGH:
1578 reg |= DWC3_DSTS_HIGHSPEED;
1579 break;
1580 case USB_SPEED_SUPER: /* FALLTHROUGH */
1581 case USB_SPEED_UNKNOWN: /* FALTHROUGH */
1582 default:
1583 reg |= DWC3_DSTS_SUPERSPEED;
1586 dwc3_writel(dwc->regs, DWC3_DCFG, reg);
1588 dwc->start_config_issued = false;
1590 /* Start with SuperSpeed Default */
1591 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(512);
1593 dep = dwc->eps[0];
1594 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, false,
1595 false);
1596 if (ret) {
1597 dev_err(dwc->dev, "failed to enable %s\n", dep->name);
1598 goto err2;
1601 dep = dwc->eps[1];
1602 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, false,
1603 false);
1604 if (ret) {
1605 dev_err(dwc->dev, "failed to enable %s\n", dep->name);
1606 goto err3;
1609 /* begin to receive SETUP packets */
1610 dwc->ep0state = EP0_SETUP_PHASE;
1611 dwc3_ep0_out_start(dwc);
1613 dwc3_gadget_enable_irq(dwc);
1615 spin_unlock_irqrestore(&dwc->lock, flags);
1617 return 0;
1619 err3:
1620 __dwc3_gadget_ep_disable(dwc->eps[0]);
1622 err2:
1623 dwc->gadget_driver = NULL;
1625 err1:
1626 spin_unlock_irqrestore(&dwc->lock, flags);
1628 free_irq(irq, dwc);
1630 err0:
1631 return ret;
1634 static int dwc3_gadget_stop(struct usb_gadget *g)
1636 struct dwc3 *dwc = gadget_to_dwc(g);
1637 unsigned long flags;
1638 int irq;
1640 spin_lock_irqsave(&dwc->lock, flags);
1642 dwc3_gadget_disable_irq(dwc);
1643 __dwc3_gadget_ep_disable(dwc->eps[0]);
1644 __dwc3_gadget_ep_disable(dwc->eps[1]);
1646 dwc->gadget_driver = NULL;
1648 spin_unlock_irqrestore(&dwc->lock, flags);
1650 irq = platform_get_irq(to_platform_device(dwc->dev), 0);
1651 free_irq(irq, dwc);
1653 return 0;
1656 static const struct usb_gadget_ops dwc3_gadget_ops = {
1657 .get_frame = dwc3_gadget_get_frame,
1658 .wakeup = dwc3_gadget_wakeup,
1659 .set_selfpowered = dwc3_gadget_set_selfpowered,
1660 .pullup = dwc3_gadget_pullup,
1661 .udc_start = dwc3_gadget_start,
1662 .udc_stop = dwc3_gadget_stop,
1665 /* -------------------------------------------------------------------------- */
1667 static int dwc3_gadget_init_hw_endpoints(struct dwc3 *dwc,
1668 u8 num, u32 direction)
1670 struct dwc3_ep *dep;
1671 u8 i;
1673 for (i = 0; i < num; i++) {
1674 u8 epnum = (i << 1) | (!!direction);
1676 dep = kzalloc(sizeof(*dep), GFP_KERNEL);
1677 if (!dep)
1678 return -ENOMEM;
1680 dep->dwc = dwc;
1681 dep->number = epnum;
1682 dep->direction = !!direction;
1683 dwc->eps[epnum] = dep;
1685 snprintf(dep->name, sizeof(dep->name), "ep%d%s", epnum >> 1,
1686 (epnum & 1) ? "in" : "out");
1688 dep->endpoint.name = dep->name;
1690 dwc3_trace(trace_dwc3_gadget, "initializing %s", dep->name);
1692 if (epnum == 0 || epnum == 1) {
1693 usb_ep_set_maxpacket_limit(&dep->endpoint, 512);
1694 dep->endpoint.maxburst = 1;
1695 dep->endpoint.ops = &dwc3_gadget_ep0_ops;
1696 if (!epnum)
1697 dwc->gadget.ep0 = &dep->endpoint;
1698 } else {
1699 int ret;
1701 usb_ep_set_maxpacket_limit(&dep->endpoint, 1024);
1702 dep->endpoint.max_streams = 15;
1703 dep->endpoint.ops = &dwc3_gadget_ep_ops;
1704 list_add_tail(&dep->endpoint.ep_list,
1705 &dwc->gadget.ep_list);
1707 ret = dwc3_alloc_trb_pool(dep);
1708 if (ret)
1709 return ret;
1712 INIT_LIST_HEAD(&dep->request_list);
1713 INIT_LIST_HEAD(&dep->req_queued);
1716 return 0;
1719 static int dwc3_gadget_init_endpoints(struct dwc3 *dwc)
1721 int ret;
1723 INIT_LIST_HEAD(&dwc->gadget.ep_list);
1725 ret = dwc3_gadget_init_hw_endpoints(dwc, dwc->num_out_eps, 0);
1726 if (ret < 0) {
1727 dwc3_trace(trace_dwc3_gadget,
1728 "failed to allocate OUT endpoints");
1729 return ret;
1732 ret = dwc3_gadget_init_hw_endpoints(dwc, dwc->num_in_eps, 1);
1733 if (ret < 0) {
1734 dwc3_trace(trace_dwc3_gadget,
1735 "failed to allocate IN endpoints");
1736 return ret;
1739 return 0;
1742 static void dwc3_gadget_free_endpoints(struct dwc3 *dwc)
1744 struct dwc3_ep *dep;
1745 u8 epnum;
1747 for (epnum = 0; epnum < DWC3_ENDPOINTS_NUM; epnum++) {
1748 dep = dwc->eps[epnum];
1749 if (!dep)
1750 continue;
1752 * Physical endpoints 0 and 1 are special; they form the
1753 * bi-directional USB endpoint 0.
1755 * For those two physical endpoints, we don't allocate a TRB
1756 * pool nor do we add them the endpoints list. Due to that, we
1757 * shouldn't do these two operations otherwise we would end up
1758 * with all sorts of bugs when removing dwc3.ko.
1760 if (epnum != 0 && epnum != 1) {
1761 dwc3_free_trb_pool(dep);
1762 list_del(&dep->endpoint.ep_list);
1765 kfree(dep);
1769 /* -------------------------------------------------------------------------- */
1771 static int __dwc3_cleanup_done_trbs(struct dwc3 *dwc, struct dwc3_ep *dep,
1772 struct dwc3_request *req, struct dwc3_trb *trb,
1773 const struct dwc3_event_depevt *event, int status)
1775 unsigned int count;
1776 unsigned int s_pkt = 0;
1777 unsigned int trb_status;
1779 trace_dwc3_complete_trb(dep, trb);
1781 if ((trb->ctrl & DWC3_TRB_CTRL_HWO) && status != -ESHUTDOWN)
1783 * We continue despite the error. There is not much we
1784 * can do. If we don't clean it up we loop forever. If
1785 * we skip the TRB then it gets overwritten after a
1786 * while since we use them in a ring buffer. A BUG()
1787 * would help. Lets hope that if this occurs, someone
1788 * fixes the root cause instead of looking away :)
1790 dev_err(dwc->dev, "%s's TRB (%p) still owned by HW\n",
1791 dep->name, trb);
1792 count = trb->size & DWC3_TRB_SIZE_MASK;
1794 if (dep->direction) {
1795 if (count) {
1796 trb_status = DWC3_TRB_SIZE_TRBSTS(trb->size);
1797 if (trb_status == DWC3_TRBSTS_MISSED_ISOC) {
1798 dev_dbg(dwc->dev, "incomplete IN transfer %s\n",
1799 dep->name);
1801 * If missed isoc occurred and there is
1802 * no request queued then issue END
1803 * TRANSFER, so that core generates
1804 * next xfernotready and we will issue
1805 * a fresh START TRANSFER.
1806 * If there are still queued request
1807 * then wait, do not issue either END
1808 * or UPDATE TRANSFER, just attach next
1809 * request in request_list during
1810 * giveback.If any future queued request
1811 * is successfully transferred then we
1812 * will issue UPDATE TRANSFER for all
1813 * request in the request_list.
1815 dep->flags |= DWC3_EP_MISSED_ISOC;
1816 } else {
1817 dev_err(dwc->dev, "incomplete IN transfer %s\n",
1818 dep->name);
1819 status = -ECONNRESET;
1821 } else {
1822 dep->flags &= ~DWC3_EP_MISSED_ISOC;
1824 } else {
1825 if (count && (event->status & DEPEVT_STATUS_SHORT))
1826 s_pkt = 1;
1830 * We assume here we will always receive the entire data block
1831 * which we should receive. Meaning, if we program RX to
1832 * receive 4K but we receive only 2K, we assume that's all we
1833 * should receive and we simply bounce the request back to the
1834 * gadget driver for further processing.
1836 req->request.actual += req->request.length - count;
1837 if (s_pkt)
1838 return 1;
1839 if ((event->status & DEPEVT_STATUS_LST) &&
1840 (trb->ctrl & (DWC3_TRB_CTRL_LST |
1841 DWC3_TRB_CTRL_HWO)))
1842 return 1;
1843 if ((event->status & DEPEVT_STATUS_IOC) &&
1844 (trb->ctrl & DWC3_TRB_CTRL_IOC))
1845 return 1;
1846 return 0;
1849 static int dwc3_cleanup_done_reqs(struct dwc3 *dwc, struct dwc3_ep *dep,
1850 const struct dwc3_event_depevt *event, int status)
1852 struct dwc3_request *req;
1853 struct dwc3_trb *trb;
1854 unsigned int slot;
1855 unsigned int i;
1856 int ret;
1858 do {
1859 req = next_request(&dep->req_queued);
1860 if (!req) {
1861 WARN_ON_ONCE(1);
1862 return 1;
1864 i = 0;
1865 do {
1866 slot = req->start_slot + i;
1867 if ((slot == DWC3_TRB_NUM - 1) &&
1868 usb_endpoint_xfer_isoc(dep->endpoint.desc))
1869 slot++;
1870 slot %= DWC3_TRB_NUM;
1871 trb = &dep->trb_pool[slot];
1873 ret = __dwc3_cleanup_done_trbs(dwc, dep, req, trb,
1874 event, status);
1875 if (ret)
1876 break;
1877 }while (++i < req->request.num_mapped_sgs);
1879 dwc3_gadget_giveback(dep, req, status);
1881 if (ret)
1882 break;
1883 } while (1);
1885 if (usb_endpoint_xfer_isoc(dep->endpoint.desc) &&
1886 list_empty(&dep->req_queued)) {
1887 if (list_empty(&dep->request_list)) {
1889 * If there is no entry in request list then do
1890 * not issue END TRANSFER now. Just set PENDING
1891 * flag, so that END TRANSFER is issued when an
1892 * entry is added into request list.
1894 dep->flags = DWC3_EP_PENDING_REQUEST;
1895 } else {
1896 dwc3_stop_active_transfer(dwc, dep->number, true);
1897 dep->flags = DWC3_EP_ENABLED;
1899 return 1;
1902 return 1;
1905 static void dwc3_endpoint_transfer_complete(struct dwc3 *dwc,
1906 struct dwc3_ep *dep, const struct dwc3_event_depevt *event)
1908 unsigned status = 0;
1909 int clean_busy;
1911 if (event->status & DEPEVT_STATUS_BUSERR)
1912 status = -ECONNRESET;
1914 clean_busy = dwc3_cleanup_done_reqs(dwc, dep, event, status);
1915 if (clean_busy)
1916 dep->flags &= ~DWC3_EP_BUSY;
1919 * WORKAROUND: This is the 2nd half of U1/U2 -> U0 workaround.
1920 * See dwc3_gadget_linksts_change_interrupt() for 1st half.
1922 if (dwc->revision < DWC3_REVISION_183A) {
1923 u32 reg;
1924 int i;
1926 for (i = 0; i < DWC3_ENDPOINTS_NUM; i++) {
1927 dep = dwc->eps[i];
1929 if (!(dep->flags & DWC3_EP_ENABLED))
1930 continue;
1932 if (!list_empty(&dep->req_queued))
1933 return;
1936 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
1937 reg |= dwc->u1u2;
1938 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
1940 dwc->u1u2 = 0;
1944 static void dwc3_endpoint_interrupt(struct dwc3 *dwc,
1945 const struct dwc3_event_depevt *event)
1947 struct dwc3_ep *dep;
1948 u8 epnum = event->endpoint_number;
1950 dep = dwc->eps[epnum];
1952 if (!(dep->flags & DWC3_EP_ENABLED))
1953 return;
1955 if (epnum == 0 || epnum == 1) {
1956 dwc3_ep0_interrupt(dwc, event);
1957 return;
1960 switch (event->endpoint_event) {
1961 case DWC3_DEPEVT_XFERCOMPLETE:
1962 dep->resource_index = 0;
1964 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
1965 dev_dbg(dwc->dev, "%s is an Isochronous endpoint\n",
1966 dep->name);
1967 return;
1970 dwc3_endpoint_transfer_complete(dwc, dep, event);
1971 break;
1972 case DWC3_DEPEVT_XFERINPROGRESS:
1973 dwc3_endpoint_transfer_complete(dwc, dep, event);
1974 break;
1975 case DWC3_DEPEVT_XFERNOTREADY:
1976 if (usb_endpoint_xfer_isoc(dep->endpoint.desc)) {
1977 dwc3_gadget_start_isoc(dwc, dep, event);
1978 } else {
1979 int ret;
1981 dwc3_trace(trace_dwc3_gadget, "%s: reason %s",
1982 dep->name, event->status &
1983 DEPEVT_STATUS_TRANSFER_ACTIVE
1984 ? "Transfer Active"
1985 : "Transfer Not Active");
1987 ret = __dwc3_gadget_kick_transfer(dep, 0, 1);
1988 if (!ret || ret == -EBUSY)
1989 return;
1991 dev_dbg(dwc->dev, "%s: failed to kick transfers\n",
1992 dep->name);
1995 break;
1996 case DWC3_DEPEVT_STREAMEVT:
1997 if (!usb_endpoint_xfer_bulk(dep->endpoint.desc)) {
1998 dev_err(dwc->dev, "Stream event for non-Bulk %s\n",
1999 dep->name);
2000 return;
2003 switch (event->status) {
2004 case DEPEVT_STREAMEVT_FOUND:
2005 dwc3_trace(trace_dwc3_gadget,
2006 "Stream %d found and started",
2007 event->parameters);
2009 break;
2010 case DEPEVT_STREAMEVT_NOTFOUND:
2011 /* FALLTHROUGH */
2012 default:
2013 dev_dbg(dwc->dev, "Couldn't find suitable stream\n");
2015 break;
2016 case DWC3_DEPEVT_RXTXFIFOEVT:
2017 dev_dbg(dwc->dev, "%s FIFO Overrun\n", dep->name);
2018 break;
2019 case DWC3_DEPEVT_EPCMDCMPLT:
2020 dwc3_trace(trace_dwc3_gadget, "Endpoint Command Complete");
2021 break;
2025 static void dwc3_disconnect_gadget(struct dwc3 *dwc)
2027 if (dwc->gadget_driver && dwc->gadget_driver->disconnect) {
2028 spin_unlock(&dwc->lock);
2029 dwc->gadget_driver->disconnect(&dwc->gadget);
2030 spin_lock(&dwc->lock);
2034 static void dwc3_suspend_gadget(struct dwc3 *dwc)
2036 if (dwc->gadget_driver && dwc->gadget_driver->suspend) {
2037 spin_unlock(&dwc->lock);
2038 dwc->gadget_driver->suspend(&dwc->gadget);
2039 spin_lock(&dwc->lock);
2043 static void dwc3_resume_gadget(struct dwc3 *dwc)
2045 if (dwc->gadget_driver && dwc->gadget_driver->resume) {
2046 spin_unlock(&dwc->lock);
2047 dwc->gadget_driver->resume(&dwc->gadget);
2048 spin_lock(&dwc->lock);
2052 static void dwc3_reset_gadget(struct dwc3 *dwc)
2054 if (!dwc->gadget_driver)
2055 return;
2057 if (dwc->gadget.speed != USB_SPEED_UNKNOWN) {
2058 spin_unlock(&dwc->lock);
2059 usb_gadget_udc_reset(&dwc->gadget, dwc->gadget_driver);
2060 spin_lock(&dwc->lock);
2064 static void dwc3_stop_active_transfer(struct dwc3 *dwc, u32 epnum, bool force)
2066 struct dwc3_ep *dep;
2067 struct dwc3_gadget_ep_cmd_params params;
2068 u32 cmd;
2069 int ret;
2071 dep = dwc->eps[epnum];
2073 if (!dep->resource_index)
2074 return;
2077 * NOTICE: We are violating what the Databook says about the
2078 * EndTransfer command. Ideally we would _always_ wait for the
2079 * EndTransfer Command Completion IRQ, but that's causing too
2080 * much trouble synchronizing between us and gadget driver.
2082 * We have discussed this with the IP Provider and it was
2083 * suggested to giveback all requests here, but give HW some
2084 * extra time to synchronize with the interconnect. We're using
2085 * an arbitrary 100us delay for that.
2087 * Note also that a similar handling was tested by Synopsys
2088 * (thanks a lot Paul) and nothing bad has come out of it.
2089 * In short, what we're doing is:
2091 * - Issue EndTransfer WITH CMDIOC bit set
2092 * - Wait 100us
2095 cmd = DWC3_DEPCMD_ENDTRANSFER;
2096 cmd |= force ? DWC3_DEPCMD_HIPRI_FORCERM : 0;
2097 cmd |= DWC3_DEPCMD_CMDIOC;
2098 cmd |= DWC3_DEPCMD_PARAM(dep->resource_index);
2099 memset(&params, 0, sizeof(params));
2100 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number, cmd, &params);
2101 WARN_ON_ONCE(ret);
2102 dep->resource_index = 0;
2103 dep->flags &= ~DWC3_EP_BUSY;
2104 udelay(100);
2107 static void dwc3_stop_active_transfers(struct dwc3 *dwc)
2109 u32 epnum;
2111 for (epnum = 2; epnum < DWC3_ENDPOINTS_NUM; epnum++) {
2112 struct dwc3_ep *dep;
2114 dep = dwc->eps[epnum];
2115 if (!dep)
2116 continue;
2118 if (!(dep->flags & DWC3_EP_ENABLED))
2119 continue;
2121 dwc3_remove_requests(dwc, dep);
2125 static void dwc3_clear_stall_all_ep(struct dwc3 *dwc)
2127 u32 epnum;
2129 for (epnum = 1; epnum < DWC3_ENDPOINTS_NUM; epnum++) {
2130 struct dwc3_ep *dep;
2131 struct dwc3_gadget_ep_cmd_params params;
2132 int ret;
2134 dep = dwc->eps[epnum];
2135 if (!dep)
2136 continue;
2138 if (!(dep->flags & DWC3_EP_STALL))
2139 continue;
2141 dep->flags &= ~DWC3_EP_STALL;
2143 memset(&params, 0, sizeof(params));
2144 ret = dwc3_send_gadget_ep_cmd(dwc, dep->number,
2145 DWC3_DEPCMD_CLEARSTALL, &params);
2146 WARN_ON_ONCE(ret);
2150 static void dwc3_gadget_disconnect_interrupt(struct dwc3 *dwc)
2152 int reg;
2154 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
2155 reg &= ~DWC3_DCTL_INITU1ENA;
2156 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2158 reg &= ~DWC3_DCTL_INITU2ENA;
2159 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2161 dwc3_disconnect_gadget(dwc);
2162 dwc->start_config_issued = false;
2164 dwc->gadget.speed = USB_SPEED_UNKNOWN;
2165 dwc->setup_packet_pending = false;
2166 usb_gadget_set_state(&dwc->gadget, USB_STATE_NOTATTACHED);
2169 static void dwc3_gadget_reset_interrupt(struct dwc3 *dwc)
2171 u32 reg;
2174 * WORKAROUND: DWC3 revisions <1.88a have an issue which
2175 * would cause a missing Disconnect Event if there's a
2176 * pending Setup Packet in the FIFO.
2178 * There's no suggested workaround on the official Bug
2179 * report, which states that "unless the driver/application
2180 * is doing any special handling of a disconnect event,
2181 * there is no functional issue".
2183 * Unfortunately, it turns out that we _do_ some special
2184 * handling of a disconnect event, namely complete all
2185 * pending transfers, notify gadget driver of the
2186 * disconnection, and so on.
2188 * Our suggested workaround is to follow the Disconnect
2189 * Event steps here, instead, based on a setup_packet_pending
2190 * flag. Such flag gets set whenever we have a XferNotReady
2191 * event on EP0 and gets cleared on XferComplete for the
2192 * same endpoint.
2194 * Refers to:
2196 * STAR#9000466709: RTL: Device : Disconnect event not
2197 * generated if setup packet pending in FIFO
2199 if (dwc->revision < DWC3_REVISION_188A) {
2200 if (dwc->setup_packet_pending)
2201 dwc3_gadget_disconnect_interrupt(dwc);
2204 dwc3_reset_gadget(dwc);
2206 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
2207 reg &= ~DWC3_DCTL_TSTCTRL_MASK;
2208 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2209 dwc->test_mode = false;
2211 dwc3_stop_active_transfers(dwc);
2212 dwc3_clear_stall_all_ep(dwc);
2213 dwc->start_config_issued = false;
2215 /* Reset device address to zero */
2216 reg = dwc3_readl(dwc->regs, DWC3_DCFG);
2217 reg &= ~(DWC3_DCFG_DEVADDR_MASK);
2218 dwc3_writel(dwc->regs, DWC3_DCFG, reg);
2221 static void dwc3_update_ram_clk_sel(struct dwc3 *dwc, u32 speed)
2223 u32 reg;
2224 u32 usb30_clock = DWC3_GCTL_CLK_BUS;
2227 * We change the clock only at SS but I dunno why I would want to do
2228 * this. Maybe it becomes part of the power saving plan.
2231 if (speed != DWC3_DSTS_SUPERSPEED)
2232 return;
2235 * RAMClkSel is reset to 0 after USB reset, so it must be reprogrammed
2236 * each time on Connect Done.
2238 if (!usb30_clock)
2239 return;
2241 reg = dwc3_readl(dwc->regs, DWC3_GCTL);
2242 reg |= DWC3_GCTL_RAMCLKSEL(usb30_clock);
2243 dwc3_writel(dwc->regs, DWC3_GCTL, reg);
2246 static void dwc3_gadget_conndone_interrupt(struct dwc3 *dwc)
2248 struct dwc3_ep *dep;
2249 int ret;
2250 u32 reg;
2251 u8 speed;
2253 reg = dwc3_readl(dwc->regs, DWC3_DSTS);
2254 speed = reg & DWC3_DSTS_CONNECTSPD;
2255 dwc->speed = speed;
2257 dwc3_update_ram_clk_sel(dwc, speed);
2259 switch (speed) {
2260 case DWC3_DCFG_SUPERSPEED:
2262 * WORKAROUND: DWC3 revisions <1.90a have an issue which
2263 * would cause a missing USB3 Reset event.
2265 * In such situations, we should force a USB3 Reset
2266 * event by calling our dwc3_gadget_reset_interrupt()
2267 * routine.
2269 * Refers to:
2271 * STAR#9000483510: RTL: SS : USB3 reset event may
2272 * not be generated always when the link enters poll
2274 if (dwc->revision < DWC3_REVISION_190A)
2275 dwc3_gadget_reset_interrupt(dwc);
2277 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(512);
2278 dwc->gadget.ep0->maxpacket = 512;
2279 dwc->gadget.speed = USB_SPEED_SUPER;
2280 break;
2281 case DWC3_DCFG_HIGHSPEED:
2282 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(64);
2283 dwc->gadget.ep0->maxpacket = 64;
2284 dwc->gadget.speed = USB_SPEED_HIGH;
2285 break;
2286 case DWC3_DCFG_FULLSPEED2:
2287 case DWC3_DCFG_FULLSPEED1:
2288 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(64);
2289 dwc->gadget.ep0->maxpacket = 64;
2290 dwc->gadget.speed = USB_SPEED_FULL;
2291 break;
2292 case DWC3_DCFG_LOWSPEED:
2293 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(8);
2294 dwc->gadget.ep0->maxpacket = 8;
2295 dwc->gadget.speed = USB_SPEED_LOW;
2296 break;
2299 /* Enable USB2 LPM Capability */
2301 if ((dwc->revision > DWC3_REVISION_194A)
2302 && (speed != DWC3_DCFG_SUPERSPEED)) {
2303 reg = dwc3_readl(dwc->regs, DWC3_DCFG);
2304 reg |= DWC3_DCFG_LPM_CAP;
2305 dwc3_writel(dwc->regs, DWC3_DCFG, reg);
2307 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
2308 reg &= ~(DWC3_DCTL_HIRD_THRES_MASK | DWC3_DCTL_L1_HIBER_EN);
2310 reg |= DWC3_DCTL_HIRD_THRES(dwc->hird_threshold);
2313 * When dwc3 revisions >= 2.40a, LPM Erratum is enabled and
2314 * DCFG.LPMCap is set, core responses with an ACK and the
2315 * BESL value in the LPM token is less than or equal to LPM
2316 * NYET threshold.
2318 WARN_ONCE(dwc->revision < DWC3_REVISION_240A
2319 && dwc->has_lpm_erratum,
2320 "LPM Erratum not available on dwc3 revisisions < 2.40a\n");
2322 if (dwc->has_lpm_erratum && dwc->revision >= DWC3_REVISION_240A)
2323 reg |= DWC3_DCTL_LPM_ERRATA(dwc->lpm_nyet_threshold);
2325 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2326 } else {
2327 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
2328 reg &= ~DWC3_DCTL_HIRD_THRES_MASK;
2329 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2332 dep = dwc->eps[0];
2333 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, true,
2334 false);
2335 if (ret) {
2336 dev_err(dwc->dev, "failed to enable %s\n", dep->name);
2337 return;
2340 dep = dwc->eps[1];
2341 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, true,
2342 false);
2343 if (ret) {
2344 dev_err(dwc->dev, "failed to enable %s\n", dep->name);
2345 return;
2349 * Configure PHY via GUSB3PIPECTLn if required.
2351 * Update GTXFIFOSIZn
2353 * In both cases reset values should be sufficient.
2357 static void dwc3_gadget_wakeup_interrupt(struct dwc3 *dwc)
2360 * TODO take core out of low power mode when that's
2361 * implemented.
2364 dwc->gadget_driver->resume(&dwc->gadget);
2367 static void dwc3_gadget_linksts_change_interrupt(struct dwc3 *dwc,
2368 unsigned int evtinfo)
2370 enum dwc3_link_state next = evtinfo & DWC3_LINK_STATE_MASK;
2371 unsigned int pwropt;
2374 * WORKAROUND: DWC3 < 2.50a have an issue when configured without
2375 * Hibernation mode enabled which would show up when device detects
2376 * host-initiated U3 exit.
2378 * In that case, device will generate a Link State Change Interrupt
2379 * from U3 to RESUME which is only necessary if Hibernation is
2380 * configured in.
2382 * There are no functional changes due to such spurious event and we
2383 * just need to ignore it.
2385 * Refers to:
2387 * STAR#9000570034 RTL: SS Resume event generated in non-Hibernation
2388 * operational mode
2390 pwropt = DWC3_GHWPARAMS1_EN_PWROPT(dwc->hwparams.hwparams1);
2391 if ((dwc->revision < DWC3_REVISION_250A) &&
2392 (pwropt != DWC3_GHWPARAMS1_EN_PWROPT_HIB)) {
2393 if ((dwc->link_state == DWC3_LINK_STATE_U3) &&
2394 (next == DWC3_LINK_STATE_RESUME)) {
2395 dwc3_trace(trace_dwc3_gadget,
2396 "ignoring transition U3 -> Resume");
2397 return;
2402 * WORKAROUND: DWC3 Revisions <1.83a have an issue which, depending
2403 * on the link partner, the USB session might do multiple entry/exit
2404 * of low power states before a transfer takes place.
2406 * Due to this problem, we might experience lower throughput. The
2407 * suggested workaround is to disable DCTL[12:9] bits if we're
2408 * transitioning from U1/U2 to U0 and enable those bits again
2409 * after a transfer completes and there are no pending transfers
2410 * on any of the enabled endpoints.
2412 * This is the first half of that workaround.
2414 * Refers to:
2416 * STAR#9000446952: RTL: Device SS : if U1/U2 ->U0 takes >128us
2417 * core send LGO_Ux entering U0
2419 if (dwc->revision < DWC3_REVISION_183A) {
2420 if (next == DWC3_LINK_STATE_U0) {
2421 u32 u1u2;
2422 u32 reg;
2424 switch (dwc->link_state) {
2425 case DWC3_LINK_STATE_U1:
2426 case DWC3_LINK_STATE_U2:
2427 reg = dwc3_readl(dwc->regs, DWC3_DCTL);
2428 u1u2 = reg & (DWC3_DCTL_INITU2ENA
2429 | DWC3_DCTL_ACCEPTU2ENA
2430 | DWC3_DCTL_INITU1ENA
2431 | DWC3_DCTL_ACCEPTU1ENA);
2433 if (!dwc->u1u2)
2434 dwc->u1u2 = reg & u1u2;
2436 reg &= ~u1u2;
2438 dwc3_writel(dwc->regs, DWC3_DCTL, reg);
2439 break;
2440 default:
2441 /* do nothing */
2442 break;
2447 switch (next) {
2448 case DWC3_LINK_STATE_U1:
2449 if (dwc->speed == USB_SPEED_SUPER)
2450 dwc3_suspend_gadget(dwc);
2451 break;
2452 case DWC3_LINK_STATE_U2:
2453 case DWC3_LINK_STATE_U3:
2454 dwc3_suspend_gadget(dwc);
2455 break;
2456 case DWC3_LINK_STATE_RESUME:
2457 dwc3_resume_gadget(dwc);
2458 break;
2459 default:
2460 /* do nothing */
2461 break;
2464 dwc->link_state = next;
2467 static void dwc3_gadget_hibernation_interrupt(struct dwc3 *dwc,
2468 unsigned int evtinfo)
2470 unsigned int is_ss = evtinfo & BIT(4);
2473 * WORKAROUND: DWC3 revison 2.20a with hibernation support
2474 * have a known issue which can cause USB CV TD.9.23 to fail
2475 * randomly.
2477 * Because of this issue, core could generate bogus hibernation
2478 * events which SW needs to ignore.
2480 * Refers to:
2482 * STAR#9000546576: Device Mode Hibernation: Issue in USB 2.0
2483 * Device Fallback from SuperSpeed
2485 if (is_ss ^ (dwc->speed == USB_SPEED_SUPER))
2486 return;
2488 /* enter hibernation here */
2491 static void dwc3_gadget_interrupt(struct dwc3 *dwc,
2492 const struct dwc3_event_devt *event)
2494 switch (event->type) {
2495 case DWC3_DEVICE_EVENT_DISCONNECT:
2496 dwc3_gadget_disconnect_interrupt(dwc);
2497 break;
2498 case DWC3_DEVICE_EVENT_RESET:
2499 dwc3_gadget_reset_interrupt(dwc);
2500 break;
2501 case DWC3_DEVICE_EVENT_CONNECT_DONE:
2502 dwc3_gadget_conndone_interrupt(dwc);
2503 break;
2504 case DWC3_DEVICE_EVENT_WAKEUP:
2505 dwc3_gadget_wakeup_interrupt(dwc);
2506 break;
2507 case DWC3_DEVICE_EVENT_HIBER_REQ:
2508 if (dev_WARN_ONCE(dwc->dev, !dwc->has_hibernation,
2509 "unexpected hibernation event\n"))
2510 break;
2512 dwc3_gadget_hibernation_interrupt(dwc, event->event_info);
2513 break;
2514 case DWC3_DEVICE_EVENT_LINK_STATUS_CHANGE:
2515 dwc3_gadget_linksts_change_interrupt(dwc, event->event_info);
2516 break;
2517 case DWC3_DEVICE_EVENT_EOPF:
2518 dwc3_trace(trace_dwc3_gadget, "End of Periodic Frame");
2519 break;
2520 case DWC3_DEVICE_EVENT_SOF:
2521 dwc3_trace(trace_dwc3_gadget, "Start of Periodic Frame");
2522 break;
2523 case DWC3_DEVICE_EVENT_ERRATIC_ERROR:
2524 dwc3_trace(trace_dwc3_gadget, "Erratic Error");
2525 break;
2526 case DWC3_DEVICE_EVENT_CMD_CMPL:
2527 dwc3_trace(trace_dwc3_gadget, "Command Complete");
2528 break;
2529 case DWC3_DEVICE_EVENT_OVERFLOW:
2530 dwc3_trace(trace_dwc3_gadget, "Overflow");
2531 break;
2532 default:
2533 dev_WARN(dwc->dev, "UNKNOWN IRQ %d\n", event->type);
2537 static void dwc3_process_event_entry(struct dwc3 *dwc,
2538 const union dwc3_event *event)
2540 trace_dwc3_event(event->raw);
2542 /* Endpoint IRQ, handle it and return early */
2543 if (event->type.is_devspec == 0) {
2544 /* depevt */
2545 return dwc3_endpoint_interrupt(dwc, &event->depevt);
2548 switch (event->type.type) {
2549 case DWC3_EVENT_TYPE_DEV:
2550 dwc3_gadget_interrupt(dwc, &event->devt);
2551 break;
2552 /* REVISIT what to do with Carkit and I2C events ? */
2553 default:
2554 dev_err(dwc->dev, "UNKNOWN IRQ type %d\n", event->raw);
2558 static irqreturn_t dwc3_process_event_buf(struct dwc3 *dwc, u32 buf)
2560 struct dwc3_event_buffer *evt;
2561 irqreturn_t ret = IRQ_NONE;
2562 int left;
2563 u32 reg;
2565 evt = dwc->ev_buffs[buf];
2566 left = evt->count;
2568 if (!(evt->flags & DWC3_EVENT_PENDING))
2569 return IRQ_NONE;
2571 while (left > 0) {
2572 union dwc3_event event;
2574 event.raw = *(u32 *) (evt->buf + evt->lpos);
2576 dwc3_process_event_entry(dwc, &event);
2579 * FIXME we wrap around correctly to the next entry as
2580 * almost all entries are 4 bytes in size. There is one
2581 * entry which has 12 bytes which is a regular entry
2582 * followed by 8 bytes data. ATM I don't know how
2583 * things are organized if we get next to the a
2584 * boundary so I worry about that once we try to handle
2585 * that.
2587 evt->lpos = (evt->lpos + 4) % DWC3_EVENT_BUFFERS_SIZE;
2588 left -= 4;
2590 dwc3_writel(dwc->regs, DWC3_GEVNTCOUNT(buf), 4);
2593 evt->count = 0;
2594 evt->flags &= ~DWC3_EVENT_PENDING;
2595 ret = IRQ_HANDLED;
2597 /* Unmask interrupt */
2598 reg = dwc3_readl(dwc->regs, DWC3_GEVNTSIZ(buf));
2599 reg &= ~DWC3_GEVNTSIZ_INTMASK;
2600 dwc3_writel(dwc->regs, DWC3_GEVNTSIZ(buf), reg);
2602 return ret;
2605 static irqreturn_t dwc3_thread_interrupt(int irq, void *_dwc)
2607 struct dwc3 *dwc = _dwc;
2608 unsigned long flags;
2609 irqreturn_t ret = IRQ_NONE;
2610 int i;
2612 spin_lock_irqsave(&dwc->lock, flags);
2614 for (i = 0; i < dwc->num_event_buffers; i++)
2615 ret |= dwc3_process_event_buf(dwc, i);
2617 spin_unlock_irqrestore(&dwc->lock, flags);
2619 return ret;
2622 static irqreturn_t dwc3_check_event_buf(struct dwc3 *dwc, u32 buf)
2624 struct dwc3_event_buffer *evt;
2625 u32 count;
2626 u32 reg;
2628 evt = dwc->ev_buffs[buf];
2630 count = dwc3_readl(dwc->regs, DWC3_GEVNTCOUNT(buf));
2631 count &= DWC3_GEVNTCOUNT_MASK;
2632 if (!count)
2633 return IRQ_NONE;
2635 evt->count = count;
2636 evt->flags |= DWC3_EVENT_PENDING;
2638 /* Mask interrupt */
2639 reg = dwc3_readl(dwc->regs, DWC3_GEVNTSIZ(buf));
2640 reg |= DWC3_GEVNTSIZ_INTMASK;
2641 dwc3_writel(dwc->regs, DWC3_GEVNTSIZ(buf), reg);
2643 return IRQ_WAKE_THREAD;
2646 static irqreturn_t dwc3_interrupt(int irq, void *_dwc)
2648 struct dwc3 *dwc = _dwc;
2649 int i;
2650 irqreturn_t ret = IRQ_NONE;
2652 spin_lock(&dwc->lock);
2654 for (i = 0; i < dwc->num_event_buffers; i++) {
2655 irqreturn_t status;
2657 status = dwc3_check_event_buf(dwc, i);
2658 if (status == IRQ_WAKE_THREAD)
2659 ret = status;
2662 spin_unlock(&dwc->lock);
2664 return ret;
2668 * dwc3_gadget_init - Initializes gadget related registers
2669 * @dwc: pointer to our controller context structure
2671 * Returns 0 on success otherwise negative errno.
2673 int dwc3_gadget_init(struct dwc3 *dwc)
2675 int ret;
2677 dwc->ctrl_req = dma_alloc_coherent(dwc->dev, sizeof(*dwc->ctrl_req),
2678 &dwc->ctrl_req_addr, GFP_KERNEL);
2679 if (!dwc->ctrl_req) {
2680 dev_err(dwc->dev, "failed to allocate ctrl request\n");
2681 ret = -ENOMEM;
2682 goto err0;
2685 dwc->ep0_trb = dma_alloc_coherent(dwc->dev, sizeof(*dwc->ep0_trb),
2686 &dwc->ep0_trb_addr, GFP_KERNEL);
2687 if (!dwc->ep0_trb) {
2688 dev_err(dwc->dev, "failed to allocate ep0 trb\n");
2689 ret = -ENOMEM;
2690 goto err1;
2693 dwc->setup_buf = kzalloc(DWC3_EP0_BOUNCE_SIZE, GFP_KERNEL);
2694 if (!dwc->setup_buf) {
2695 ret = -ENOMEM;
2696 goto err2;
2699 dwc->ep0_bounce = dma_alloc_coherent(dwc->dev,
2700 DWC3_EP0_BOUNCE_SIZE, &dwc->ep0_bounce_addr,
2701 GFP_KERNEL);
2702 if (!dwc->ep0_bounce) {
2703 dev_err(dwc->dev, "failed to allocate ep0 bounce buffer\n");
2704 ret = -ENOMEM;
2705 goto err3;
2708 dwc->gadget.ops = &dwc3_gadget_ops;
2709 dwc->gadget.max_speed = USB_SPEED_SUPER;
2710 dwc->gadget.speed = USB_SPEED_UNKNOWN;
2711 dwc->gadget.sg_supported = true;
2712 dwc->gadget.name = "dwc3-gadget";
2715 * Per databook, DWC3 needs buffer size to be aligned to MaxPacketSize
2716 * on ep out.
2718 dwc->gadget.quirk_ep_out_aligned_size = true;
2721 * REVISIT: Here we should clear all pending IRQs to be
2722 * sure we're starting from a well known location.
2725 ret = dwc3_gadget_init_endpoints(dwc);
2726 if (ret)
2727 goto err4;
2729 ret = usb_add_gadget_udc(dwc->dev, &dwc->gadget);
2730 if (ret) {
2731 dev_err(dwc->dev, "failed to register udc\n");
2732 goto err4;
2735 return 0;
2737 err4:
2738 dwc3_gadget_free_endpoints(dwc);
2739 dma_free_coherent(dwc->dev, DWC3_EP0_BOUNCE_SIZE,
2740 dwc->ep0_bounce, dwc->ep0_bounce_addr);
2742 err3:
2743 kfree(dwc->setup_buf);
2745 err2:
2746 dma_free_coherent(dwc->dev, sizeof(*dwc->ep0_trb),
2747 dwc->ep0_trb, dwc->ep0_trb_addr);
2749 err1:
2750 dma_free_coherent(dwc->dev, sizeof(*dwc->ctrl_req),
2751 dwc->ctrl_req, dwc->ctrl_req_addr);
2753 err0:
2754 return ret;
2757 /* -------------------------------------------------------------------------- */
2759 void dwc3_gadget_exit(struct dwc3 *dwc)
2761 usb_del_gadget_udc(&dwc->gadget);
2763 dwc3_gadget_free_endpoints(dwc);
2765 dma_free_coherent(dwc->dev, DWC3_EP0_BOUNCE_SIZE,
2766 dwc->ep0_bounce, dwc->ep0_bounce_addr);
2768 kfree(dwc->setup_buf);
2770 dma_free_coherent(dwc->dev, sizeof(*dwc->ep0_trb),
2771 dwc->ep0_trb, dwc->ep0_trb_addr);
2773 dma_free_coherent(dwc->dev, sizeof(*dwc->ctrl_req),
2774 dwc->ctrl_req, dwc->ctrl_req_addr);
2777 int dwc3_gadget_suspend(struct dwc3 *dwc)
2779 if (dwc->pullups_connected) {
2780 dwc3_gadget_disable_irq(dwc);
2781 dwc3_gadget_run_stop(dwc, true, true);
2784 __dwc3_gadget_ep_disable(dwc->eps[0]);
2785 __dwc3_gadget_ep_disable(dwc->eps[1]);
2787 dwc->dcfg = dwc3_readl(dwc->regs, DWC3_DCFG);
2789 return 0;
2792 int dwc3_gadget_resume(struct dwc3 *dwc)
2794 struct dwc3_ep *dep;
2795 int ret;
2797 /* Start with SuperSpeed Default */
2798 dwc3_gadget_ep0_desc.wMaxPacketSize = cpu_to_le16(512);
2800 dep = dwc->eps[0];
2801 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, false,
2802 false);
2803 if (ret)
2804 goto err0;
2806 dep = dwc->eps[1];
2807 ret = __dwc3_gadget_ep_enable(dep, &dwc3_gadget_ep0_desc, NULL, false,
2808 false);
2809 if (ret)
2810 goto err1;
2812 /* begin to receive SETUP packets */
2813 dwc->ep0state = EP0_SETUP_PHASE;
2814 dwc3_ep0_out_start(dwc);
2816 dwc3_writel(dwc->regs, DWC3_DCFG, dwc->dcfg);
2818 if (dwc->pullups_connected) {
2819 dwc3_gadget_enable_irq(dwc);
2820 dwc3_gadget_run_stop(dwc, true, false);
2823 return 0;
2825 err1:
2826 __dwc3_gadget_ep_disable(dwc->eps[0]);
2828 err0:
2829 return ret;