2 * MUSB OTG driver peripheral support
4 * Copyright 2005 Mentor Graphics Corporation
5 * Copyright (C) 2005-2006 by Texas Instruments
6 * Copyright (C) 2006-2007 Nokia Corporation
7 * Copyright (C) 2009 MontaVista Software, Inc. <source@mvista.com>
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * version 2 as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
23 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
24 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
25 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
26 * NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
28 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
29 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
30 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 #include <linux/kernel.h>
37 #include <linux/list.h>
38 #include <linux/timer.h>
39 #include <linux/module.h>
40 #include <linux/smp.h>
41 #include <linux/spinlock.h>
42 #include <linux/delay.h>
43 #include <linux/moduleparam.h>
44 #include <linux/stat.h>
45 #include <linux/dma-mapping.h>
47 #include "musb_core.h"
50 /* MUSB PERIPHERAL status 3-mar-2006:
52 * - EP0 seems solid. It passes both USBCV and usbtest control cases.
55 * + remote wakeup to Linux hosts work, but saw USBCV failures;
56 * in one test run (operator error?)
57 * + endpoint halt tests -- in both usbtest and usbcv -- seem
58 * to break when dma is enabled ... is something wrongly
61 * - Mass storage behaved ok when last tested. Network traffic patterns
62 * (with lots of short transfers etc) need retesting; they turn up the
63 * worst cases of the DMA, since short packets are typical but are not
67 * + both pio and dma behave in with network and g_zero tests
68 * + no cppi throughput issues other than no-hw-queueing
69 * + failed with FLAT_REG (DaVinci)
70 * + seems to behave with double buffering, PIO -and- CPPI
71 * + with gadgetfs + AIO, requests got lost?
74 * + both pio and dma behave in with network and g_zero tests
75 * + dma is slow in typical case (short_not_ok is clear)
76 * + double buffering ok with PIO
77 * + double buffering *FAILS* with CPPI, wrong data bytes sometimes
78 * + request lossage observed with gadgetfs
80 * - ISO not tested ... might work, but only weakly isochronous
82 * - Gadget driver disabling of softconnect during bind() is ignored; so
83 * drivers can't hold off host requests until userspace is ready.
84 * (Workaround: they can turn it off later.)
86 * - PORTABILITY (assumes PIO works):
87 * + DaVinci, basically works with cppi dma
88 * + OMAP 2430, ditto with mentor dma
89 * + TUSB 6010, platform-specific dma in the works
92 /* ----------------------------------------------------------------------- */
95 * Immediately complete a request.
97 * @param request the request to complete
98 * @param status the status to complete the request with
99 * Context: controller locked, IRQs blocked.
101 void musb_g_giveback(
103 struct usb_request *request,
105 __releases(ep->musb->lock)
106 __acquires(ep->musb->lock)
108 struct musb_request *req;
112 req = to_musb_request(request);
114 list_del(&request->list);
115 if (req->request.status == -EINPROGRESS)
116 req->request.status = status;
120 spin_unlock(&musb->lock);
121 if (is_dma_capable()) {
123 dma_unmap_single(musb->controller,
129 req->request.dma = DMA_ADDR_INVALID;
131 } else if (req->request.dma != DMA_ADDR_INVALID)
132 dma_sync_single_for_cpu(musb->controller,
139 if (request->status == 0)
140 DBG(5, "%s done request %p, %d/%d\n",
141 ep->end_point.name, request,
142 req->request.actual, req->request.length);
144 DBG(2, "%s request %p, %d/%d fault %d\n",
145 ep->end_point.name, request,
146 req->request.actual, req->request.length,
148 req->request.complete(&req->ep->end_point, &req->request);
149 spin_lock(&musb->lock);
153 /* ----------------------------------------------------------------------- */
156 * Abort requests queued to an endpoint using the status. Synchronous.
157 * caller locked controller and blocked irqs, and selected this ep.
159 static void nuke(struct musb_ep *ep, const int status)
161 struct musb_request *req = NULL;
162 void __iomem *epio = ep->musb->endpoints[ep->current_epnum].regs;
166 if (is_dma_capable() && ep->dma) {
167 struct dma_controller *c = ep->musb->dma_controller;
172 * The programming guide says that we must not clear
173 * the DMAMODE bit before DMAENAB, so we only
174 * clear it in the second write...
176 musb_writew(epio, MUSB_TXCSR,
177 MUSB_TXCSR_DMAMODE | MUSB_TXCSR_FLUSHFIFO);
178 musb_writew(epio, MUSB_TXCSR,
179 0 | MUSB_TXCSR_FLUSHFIFO);
181 musb_writew(epio, MUSB_RXCSR,
182 0 | MUSB_RXCSR_FLUSHFIFO);
183 musb_writew(epio, MUSB_RXCSR,
184 0 | MUSB_RXCSR_FLUSHFIFO);
187 value = c->channel_abort(ep->dma);
188 DBG(value ? 1 : 6, "%s: abort DMA --> %d\n", ep->name, value);
189 c->channel_release(ep->dma);
193 while (!list_empty(&(ep->req_list))) {
194 req = container_of(ep->req_list.next, struct musb_request,
196 musb_g_giveback(ep, &req->request, status);
200 /* ----------------------------------------------------------------------- */
202 /* Data transfers - pure PIO, pure DMA, or mixed mode */
205 * This assumes the separate CPPI engine is responding to DMA requests
206 * from the usb core ... sequenced a bit differently from mentor dma.
209 static inline int max_ep_writesize(struct musb *musb, struct musb_ep *ep)
211 if (can_bulk_split(musb, ep->type))
212 return ep->hw_ep->max_packet_sz_tx;
214 return ep->packet_sz;
218 #ifdef CONFIG_USB_INVENTRA_DMA
220 /* Peripheral tx (IN) using Mentor DMA works as follows:
221 Only mode 0 is used for transfers <= wPktSize,
222 mode 1 is used for larger transfers,
224 One of the following happens:
225 - Host sends IN token which causes an endpoint interrupt
227 -> if DMA is currently busy, exit.
228 -> if queue is non-empty, txstate().
230 - Request is queued by the gadget driver.
231 -> if queue was previously empty, txstate()
236 | (data is transferred to the FIFO, then sent out when
237 | IN token(s) are recd from Host.
238 | -> DMA interrupt on completion
240 | -> stop DMA, ~DMAENAB,
241 | -> set TxPktRdy for last short pkt or zlp
242 | -> Complete Request
243 | -> Continue next request (call txstate)
244 |___________________________________|
246 * Non-Mentor DMA engines can of course work differently, such as by
247 * upleveling from irq-per-packet to irq-per-buffer.
253 * An endpoint is transmitting data. This can be called either from
254 * the IRQ routine or from ep.queue() to kickstart a request on an
257 * Context: controller locked, IRQs blocked, endpoint selected
259 static void txstate(struct musb *musb, struct musb_request *req)
261 u8 epnum = req->epnum;
262 struct musb_ep *musb_ep;
263 void __iomem *epio = musb->endpoints[epnum].regs;
264 struct usb_request *request;
265 u16 fifo_count = 0, csr;
270 /* we shouldn't get here while DMA is active ... but we do ... */
271 if (dma_channel_status(musb_ep->dma) == MUSB_DMA_STATUS_BUSY) {
272 DBG(4, "dma pending...\n");
276 /* read TXCSR before */
277 csr = musb_readw(epio, MUSB_TXCSR);
279 request = &req->request;
280 fifo_count = min(max_ep_writesize(musb, musb_ep),
281 (int)(request->length - request->actual));
283 if (csr & MUSB_TXCSR_TXPKTRDY) {
284 DBG(5, "%s old packet still ready , txcsr %03x\n",
285 musb_ep->end_point.name, csr);
289 if (csr & MUSB_TXCSR_P_SENDSTALL) {
290 DBG(5, "%s stalling, txcsr %03x\n",
291 musb_ep->end_point.name, csr);
295 DBG(4, "hw_ep%d, maxpacket %d, fifo count %d, txcsr %03x\n",
296 epnum, musb_ep->packet_sz, fifo_count,
299 #ifndef CONFIG_MUSB_PIO_ONLY
300 if (is_dma_capable() && musb_ep->dma) {
301 struct dma_controller *c = musb->dma_controller;
303 use_dma = (request->dma != DMA_ADDR_INVALID);
305 /* MUSB_TXCSR_P_ISO is still set correctly */
307 #ifdef CONFIG_USB_INVENTRA_DMA
311 /* setup DMA, then program endpoint CSR */
312 request_size = min(request->length,
313 musb_ep->dma->max_len);
314 if (request_size < musb_ep->packet_sz)
315 musb_ep->dma->desired_mode = 0;
317 musb_ep->dma->desired_mode = 1;
319 use_dma = use_dma && c->channel_program(
320 musb_ep->dma, musb_ep->packet_sz,
321 musb_ep->dma->desired_mode,
322 request->dma, request_size);
324 if (musb_ep->dma->desired_mode == 0) {
326 * We must not clear the DMAMODE bit
327 * before the DMAENAB bit -- and the
328 * latter doesn't always get cleared
329 * before we get here...
331 csr &= ~(MUSB_TXCSR_AUTOSET
332 | MUSB_TXCSR_DMAENAB);
333 musb_writew(epio, MUSB_TXCSR, csr
334 | MUSB_TXCSR_P_WZC_BITS);
335 csr &= ~MUSB_TXCSR_DMAMODE;
336 csr |= (MUSB_TXCSR_DMAENAB |
338 /* against programming guide */
340 csr |= (MUSB_TXCSR_AUTOSET
345 csr &= ~MUSB_TXCSR_P_UNDERRUN;
346 musb_writew(epio, MUSB_TXCSR, csr);
350 #elif defined(CONFIG_USB_TI_CPPI_DMA)
351 /* program endpoint CSR first, then setup DMA */
352 csr &= ~(MUSB_TXCSR_P_UNDERRUN | MUSB_TXCSR_TXPKTRDY);
353 csr |= MUSB_TXCSR_DMAENAB | MUSB_TXCSR_DMAMODE |
355 musb_writew(epio, MUSB_TXCSR,
356 (MUSB_TXCSR_P_WZC_BITS & ~MUSB_TXCSR_P_UNDERRUN)
359 /* ensure writebuffer is empty */
360 csr = musb_readw(epio, MUSB_TXCSR);
362 /* NOTE host side sets DMAENAB later than this; both are
363 * OK since the transfer dma glue (between CPPI and Mentor
364 * fifos) just tells CPPI it could start. Data only moves
365 * to the USB TX fifo when both fifos are ready.
368 /* "mode" is irrelevant here; handle terminating ZLPs like
369 * PIO does, since the hardware RNDIS mode seems unreliable
370 * except for the last-packet-is-already-short case.
372 use_dma = use_dma && c->channel_program(
373 musb_ep->dma, musb_ep->packet_sz,
378 c->channel_release(musb_ep->dma);
380 csr &= ~MUSB_TXCSR_DMAENAB;
381 musb_writew(epio, MUSB_TXCSR, csr);
382 /* invariant: prequest->buf is non-null */
384 #elif defined(CONFIG_USB_TUSB_OMAP_DMA)
385 use_dma = use_dma && c->channel_program(
386 musb_ep->dma, musb_ep->packet_sz,
395 musb_write_fifo(musb_ep->hw_ep, fifo_count,
396 (u8 *) (request->buf + request->actual));
397 request->actual += fifo_count;
398 csr |= MUSB_TXCSR_TXPKTRDY;
399 csr &= ~MUSB_TXCSR_P_UNDERRUN;
400 musb_writew(epio, MUSB_TXCSR, csr);
403 /* host may already have the data when this message shows... */
404 DBG(3, "%s TX/IN %s len %d/%d, txcsr %04x, fifo %d/%d\n",
405 musb_ep->end_point.name, use_dma ? "dma" : "pio",
406 request->actual, request->length,
407 musb_readw(epio, MUSB_TXCSR),
409 musb_readw(epio, MUSB_TXMAXP));
413 * FIFO state update (e.g. data ready).
414 * Called from IRQ, with controller locked.
416 void musb_g_tx(struct musb *musb, u8 epnum)
419 struct usb_request *request;
420 u8 __iomem *mbase = musb->mregs;
421 struct musb_ep *musb_ep = &musb->endpoints[epnum].ep_in;
422 void __iomem *epio = musb->endpoints[epnum].regs;
423 struct dma_channel *dma;
425 musb_ep_select(mbase, epnum);
426 request = next_request(musb_ep);
428 csr = musb_readw(epio, MUSB_TXCSR);
429 DBG(4, "<== %s, txcsr %04x\n", musb_ep->end_point.name, csr);
431 dma = is_dma_capable() ? musb_ep->dma : NULL;
434 * REVISIT: for high bandwidth, MUSB_TXCSR_P_INCOMPTX
435 * probably rates reporting as a host error.
437 if (csr & MUSB_TXCSR_P_SENTSTALL) {
438 csr |= MUSB_TXCSR_P_WZC_BITS;
439 csr &= ~MUSB_TXCSR_P_SENTSTALL;
440 musb_writew(epio, MUSB_TXCSR, csr);
444 if (csr & MUSB_TXCSR_P_UNDERRUN) {
445 /* We NAKed, no big deal... little reason to care. */
446 csr |= MUSB_TXCSR_P_WZC_BITS;
447 csr &= ~(MUSB_TXCSR_P_UNDERRUN | MUSB_TXCSR_TXPKTRDY);
448 musb_writew(epio, MUSB_TXCSR, csr);
449 DBG(20, "underrun on ep%d, req %p\n", epnum, request);
452 if (dma_channel_status(dma) == MUSB_DMA_STATUS_BUSY) {
454 * SHOULD NOT HAPPEN... has with CPPI though, after
455 * changing SENDSTALL (and other cases); harmless?
457 DBG(5, "%s dma still busy?\n", musb_ep->end_point.name);
464 if (dma && (csr & MUSB_TXCSR_DMAENAB)) {
466 csr |= MUSB_TXCSR_P_WZC_BITS;
467 csr &= ~(MUSB_TXCSR_DMAENAB | MUSB_TXCSR_P_UNDERRUN |
468 MUSB_TXCSR_TXPKTRDY);
469 musb_writew(epio, MUSB_TXCSR, csr);
470 /* Ensure writebuffer is empty. */
471 csr = musb_readw(epio, MUSB_TXCSR);
472 request->actual += musb_ep->dma->actual_len;
473 DBG(4, "TXCSR%d %04x, DMA off, len %zu, req %p\n",
474 epnum, csr, musb_ep->dma->actual_len, request);
477 if (is_dma || request->actual == request->length) {
479 * First, maybe a terminating short packet. Some DMA
480 * engines might handle this by themselves.
482 if ((request->zero && request->length
483 && request->length % musb_ep->packet_sz == 0)
484 #ifdef CONFIG_USB_INVENTRA_DMA
485 || (is_dma && (!dma->desired_mode ||
487 (musb_ep->packet_sz - 1))))
491 * On DMA completion, FIFO may not be
494 if (csr & MUSB_TXCSR_TXPKTRDY)
497 DBG(4, "sending zero pkt\n");
498 musb_writew(epio, MUSB_TXCSR, MUSB_TXCSR_MODE
499 | MUSB_TXCSR_TXPKTRDY);
503 /* ... or if not, then complete it. */
504 musb_g_giveback(musb_ep, request, 0);
507 * Kickstart next transfer if appropriate;
508 * the packet that just completed might not
509 * be transmitted for hours or days.
510 * REVISIT for double buffering...
511 * FIXME revisit for stalls too...
513 musb_ep_select(mbase, epnum);
514 csr = musb_readw(epio, MUSB_TXCSR);
515 if (csr & MUSB_TXCSR_FIFONOTEMPTY)
518 if (!musb_ep->desc) {
519 DBG(4, "%s idle now\n",
520 musb_ep->end_point.name);
523 request = next_request(musb_ep);
526 txstate(musb, to_musb_request(request));
530 /* ------------------------------------------------------------ */
532 #ifdef CONFIG_USB_INVENTRA_DMA
534 /* Peripheral rx (OUT) using Mentor DMA works as follows:
535 - Only mode 0 is used.
537 - Request is queued by the gadget class driver.
538 -> if queue was previously empty, rxstate()
540 - Host sends OUT token which causes an endpoint interrupt
542 | -> if request queued, call rxstate
544 | | -> DMA interrupt on completion
548 | | -> if data recd = max expected
549 | | by the request, or host
550 | | sent a short packet,
551 | | complete the request,
552 | | and start the next one.
553 | |_____________________________________|
554 | else just wait for the host
555 | to send the next OUT token.
556 |__________________________________________________|
558 * Non-Mentor DMA engines can of course work differently.
564 * Context: controller locked, IRQs blocked, endpoint selected
566 static void rxstate(struct musb *musb, struct musb_request *req)
568 const u8 epnum = req->epnum;
569 struct usb_request *request = &req->request;
570 struct musb_ep *musb_ep = &musb->endpoints[epnum].ep_out;
571 void __iomem *epio = musb->endpoints[epnum].regs;
572 unsigned fifo_count = 0;
573 u16 len = musb_ep->packet_sz;
574 u16 csr = musb_readw(epio, MUSB_RXCSR);
576 /* We shouldn't get here while DMA is active, but we do... */
577 if (dma_channel_status(musb_ep->dma) == MUSB_DMA_STATUS_BUSY) {
578 DBG(4, "DMA pending...\n");
582 if (csr & MUSB_RXCSR_P_SENDSTALL) {
583 DBG(5, "%s stalling, RXCSR %04x\n",
584 musb_ep->end_point.name, csr);
588 if (is_cppi_enabled() && musb_ep->dma) {
589 struct dma_controller *c = musb->dma_controller;
590 struct dma_channel *channel = musb_ep->dma;
592 /* NOTE: CPPI won't actually stop advancing the DMA
593 * queue after short packet transfers, so this is almost
594 * always going to run as IRQ-per-packet DMA so that
595 * faults will be handled correctly.
597 if (c->channel_program(channel,
599 !request->short_not_ok,
600 request->dma + request->actual,
601 request->length - request->actual)) {
603 /* make sure that if an rxpkt arrived after the irq,
604 * the cppi engine will be ready to take it as soon
607 csr &= ~(MUSB_RXCSR_AUTOCLEAR
608 | MUSB_RXCSR_DMAMODE);
609 csr |= MUSB_RXCSR_DMAENAB | MUSB_RXCSR_P_WZC_BITS;
610 musb_writew(epio, MUSB_RXCSR, csr);
615 if (csr & MUSB_RXCSR_RXPKTRDY) {
616 len = musb_readw(epio, MUSB_RXCOUNT);
617 if (request->actual < request->length) {
618 #ifdef CONFIG_USB_INVENTRA_DMA
619 if (is_dma_capable() && musb_ep->dma) {
620 struct dma_controller *c;
621 struct dma_channel *channel;
624 c = musb->dma_controller;
625 channel = musb_ep->dma;
627 /* We use DMA Req mode 0 in rx_csr, and DMA controller operates in
628 * mode 0 only. So we do not get endpoint interrupts due to DMA
629 * completion. We only get interrupts from DMA controller.
631 * We could operate in DMA mode 1 if we knew the size of the tranfer
632 * in advance. For mass storage class, request->length = what the host
633 * sends, so that'd work. But for pretty much everything else,
634 * request->length is routinely more than what the host sends. For
635 * most these gadgets, end of is signified either by a short packet,
636 * or filling the last byte of the buffer. (Sending extra data in
637 * that last pckate should trigger an overflow fault.) But in mode 1,
638 * we don't get DMA completion interrrupt for short packets.
640 * Theoretically, we could enable DMAReq irq (MUSB_RXCSR_DMAMODE = 1),
641 * to get endpoint interrupt on every DMA req, but that didn't seem
644 * REVISIT an updated g_file_storage can set req->short_not_ok, which
645 * then becomes usable as a runtime "use mode 1" hint...
648 csr |= MUSB_RXCSR_DMAENAB;
650 csr |= MUSB_RXCSR_AUTOCLEAR;
651 /* csr |= MUSB_RXCSR_DMAMODE; */
653 /* this special sequence (enabling and then
654 * disabling MUSB_RXCSR_DMAMODE) is required
655 * to get DMAReq to activate
657 musb_writew(epio, MUSB_RXCSR,
658 csr | MUSB_RXCSR_DMAMODE);
660 musb_writew(epio, MUSB_RXCSR, csr);
662 if (request->actual < request->length) {
663 int transfer_size = 0;
665 transfer_size = min(request->length,
670 if (transfer_size <= musb_ep->packet_sz)
671 musb_ep->dma->desired_mode = 0;
673 musb_ep->dma->desired_mode = 1;
675 use_dma = c->channel_program(
678 channel->desired_mode,
687 #endif /* Mentor's DMA */
689 fifo_count = request->length - request->actual;
690 DBG(3, "%s OUT/RX pio fifo %d/%d, maxpacket %d\n",
691 musb_ep->end_point.name,
695 fifo_count = min_t(unsigned, len, fifo_count);
697 #ifdef CONFIG_USB_TUSB_OMAP_DMA
698 if (tusb_dma_omap() && musb_ep->dma) {
699 struct dma_controller *c = musb->dma_controller;
700 struct dma_channel *channel = musb_ep->dma;
701 u32 dma_addr = request->dma + request->actual;
704 ret = c->channel_program(channel,
706 channel->desired_mode,
714 musb_read_fifo(musb_ep->hw_ep, fifo_count, (u8 *)
715 (request->buf + request->actual));
716 request->actual += fifo_count;
718 /* REVISIT if we left anything in the fifo, flush
719 * it and report -EOVERFLOW
723 csr |= MUSB_RXCSR_P_WZC_BITS;
724 csr &= ~MUSB_RXCSR_RXPKTRDY;
725 musb_writew(epio, MUSB_RXCSR, csr);
729 /* reach the end or short packet detected */
730 if (request->actual == request->length || len < musb_ep->packet_sz)
731 musb_g_giveback(musb_ep, request, 0);
735 * Data ready for a request; called from IRQ
737 void musb_g_rx(struct musb *musb, u8 epnum)
740 struct usb_request *request;
741 void __iomem *mbase = musb->mregs;
742 struct musb_ep *musb_ep = &musb->endpoints[epnum].ep_out;
743 void __iomem *epio = musb->endpoints[epnum].regs;
744 struct dma_channel *dma;
746 musb_ep_select(mbase, epnum);
748 request = next_request(musb_ep);
750 csr = musb_readw(epio, MUSB_RXCSR);
751 dma = is_dma_capable() ? musb_ep->dma : NULL;
753 DBG(4, "<== %s, rxcsr %04x%s %p\n", musb_ep->end_point.name,
754 csr, dma ? " (dma)" : "", request);
756 if (csr & MUSB_RXCSR_P_SENTSTALL) {
757 csr |= MUSB_RXCSR_P_WZC_BITS;
758 csr &= ~MUSB_RXCSR_P_SENTSTALL;
759 musb_writew(epio, MUSB_RXCSR, csr);
763 if (csr & MUSB_RXCSR_P_OVERRUN) {
764 /* csr |= MUSB_RXCSR_P_WZC_BITS; */
765 csr &= ~MUSB_RXCSR_P_OVERRUN;
766 musb_writew(epio, MUSB_RXCSR, csr);
768 DBG(3, "%s iso overrun on %p\n", musb_ep->name, request);
769 if (request && request->status == -EINPROGRESS)
770 request->status = -EOVERFLOW;
772 if (csr & MUSB_RXCSR_INCOMPRX) {
773 /* REVISIT not necessarily an error */
774 DBG(4, "%s, incomprx\n", musb_ep->end_point.name);
777 if (dma_channel_status(dma) == MUSB_DMA_STATUS_BUSY) {
778 /* "should not happen"; likely RXPKTRDY pending for DMA */
779 DBG((csr & MUSB_RXCSR_DMAENAB) ? 4 : 1,
780 "%s busy, csr %04x\n",
781 musb_ep->end_point.name, csr);
785 if (dma && (csr & MUSB_RXCSR_DMAENAB)) {
786 csr &= ~(MUSB_RXCSR_AUTOCLEAR
788 | MUSB_RXCSR_DMAMODE);
789 musb_writew(epio, MUSB_RXCSR,
790 MUSB_RXCSR_P_WZC_BITS | csr);
792 request->actual += musb_ep->dma->actual_len;
794 DBG(4, "RXCSR%d %04x, dma off, %04x, len %zu, req %p\n",
796 musb_readw(epio, MUSB_RXCSR),
797 musb_ep->dma->actual_len, request);
799 #if defined(CONFIG_USB_INVENTRA_DMA) || defined(CONFIG_USB_TUSB_OMAP_DMA)
800 /* Autoclear doesn't clear RxPktRdy for short packets */
801 if ((dma->desired_mode == 0)
803 & (musb_ep->packet_sz - 1))) {
805 csr &= ~MUSB_RXCSR_RXPKTRDY;
806 musb_writew(epio, MUSB_RXCSR, csr);
809 /* incomplete, and not short? wait for next IN packet */
810 if ((request->actual < request->length)
811 && (musb_ep->dma->actual_len
812 == musb_ep->packet_sz))
815 musb_g_giveback(musb_ep, request, 0);
817 request = next_request(musb_ep);
822 /* analyze request if the ep is hot */
824 rxstate(musb, to_musb_request(request));
826 DBG(3, "packet waiting for %s%s request\n",
827 musb_ep->desc ? "" : "inactive ",
828 musb_ep->end_point.name);
832 /* ------------------------------------------------------------ */
834 static int musb_gadget_enable(struct usb_ep *ep,
835 const struct usb_endpoint_descriptor *desc)
838 struct musb_ep *musb_ep;
839 struct musb_hw_ep *hw_ep;
846 int status = -EINVAL;
851 musb_ep = to_musb_ep(ep);
852 hw_ep = musb_ep->hw_ep;
854 musb = musb_ep->musb;
856 epnum = musb_ep->current_epnum;
858 spin_lock_irqsave(&musb->lock, flags);
864 musb_ep->type = usb_endpoint_type(desc);
866 /* check direction and (later) maxpacket size against endpoint */
867 if (usb_endpoint_num(desc) != epnum)
870 /* REVISIT this rules out high bandwidth periodic transfers */
871 tmp = le16_to_cpu(desc->wMaxPacketSize);
874 musb_ep->packet_sz = tmp;
876 /* enable the interrupts for the endpoint, set the endpoint
877 * packet size (or fail), set the mode, clear the fifo
879 musb_ep_select(mbase, epnum);
880 if (usb_endpoint_dir_in(desc)) {
881 u16 int_txe = musb_readw(mbase, MUSB_INTRTXE);
883 if (hw_ep->is_shared_fifo)
887 if (tmp > hw_ep->max_packet_sz_tx)
890 int_txe |= (1 << epnum);
891 musb_writew(mbase, MUSB_INTRTXE, int_txe);
893 /* REVISIT if can_bulk_split(), use by updating "tmp";
894 * likewise high bandwidth periodic tx
896 musb_writew(regs, MUSB_TXMAXP, tmp);
898 csr = MUSB_TXCSR_MODE | MUSB_TXCSR_CLRDATATOG;
899 if (musb_readw(regs, MUSB_TXCSR)
900 & MUSB_TXCSR_FIFONOTEMPTY)
901 csr |= MUSB_TXCSR_FLUSHFIFO;
902 if (musb_ep->type == USB_ENDPOINT_XFER_ISOC)
903 csr |= MUSB_TXCSR_P_ISO;
905 /* set twice in case of double buffering */
906 musb_writew(regs, MUSB_TXCSR, csr);
907 /* REVISIT may be inappropriate w/o FIFONOTEMPTY ... */
908 musb_writew(regs, MUSB_TXCSR, csr);
911 u16 int_rxe = musb_readw(mbase, MUSB_INTRRXE);
913 if (hw_ep->is_shared_fifo)
917 if (tmp > hw_ep->max_packet_sz_rx)
920 int_rxe |= (1 << epnum);
921 musb_writew(mbase, MUSB_INTRRXE, int_rxe);
923 /* REVISIT if can_bulk_combine() use by updating "tmp"
924 * likewise high bandwidth periodic rx
926 musb_writew(regs, MUSB_RXMAXP, tmp);
928 /* force shared fifo to OUT-only mode */
929 if (hw_ep->is_shared_fifo) {
930 csr = musb_readw(regs, MUSB_TXCSR);
931 csr &= ~(MUSB_TXCSR_MODE | MUSB_TXCSR_TXPKTRDY);
932 musb_writew(regs, MUSB_TXCSR, csr);
935 csr = MUSB_RXCSR_FLUSHFIFO | MUSB_RXCSR_CLRDATATOG;
936 if (musb_ep->type == USB_ENDPOINT_XFER_ISOC)
937 csr |= MUSB_RXCSR_P_ISO;
938 else if (musb_ep->type == USB_ENDPOINT_XFER_INT)
939 csr |= MUSB_RXCSR_DISNYET;
941 /* set twice in case of double buffering */
942 musb_writew(regs, MUSB_RXCSR, csr);
943 musb_writew(regs, MUSB_RXCSR, csr);
946 /* NOTE: all the I/O code _should_ work fine without DMA, in case
947 * for some reason you run out of channels here.
949 if (is_dma_capable() && musb->dma_controller) {
950 struct dma_controller *c = musb->dma_controller;
952 musb_ep->dma = c->channel_alloc(c, hw_ep,
953 (desc->bEndpointAddress & USB_DIR_IN));
957 musb_ep->desc = desc;
962 pr_debug("%s periph: enabled %s for %s %s, %smaxpacket %d\n",
963 musb_driver_name, musb_ep->end_point.name,
964 ({ char *s; switch (musb_ep->type) {
965 case USB_ENDPOINT_XFER_BULK: s = "bulk"; break;
966 case USB_ENDPOINT_XFER_INT: s = "int"; break;
967 default: s = "iso"; break;
969 musb_ep->is_in ? "IN" : "OUT",
970 musb_ep->dma ? "dma, " : "",
973 schedule_work(&musb->irq_work);
976 spin_unlock_irqrestore(&musb->lock, flags);
981 * Disable an endpoint flushing all requests queued.
983 static int musb_gadget_disable(struct usb_ep *ep)
988 struct musb_ep *musb_ep;
992 musb_ep = to_musb_ep(ep);
993 musb = musb_ep->musb;
994 epnum = musb_ep->current_epnum;
995 epio = musb->endpoints[epnum].regs;
997 spin_lock_irqsave(&musb->lock, flags);
998 musb_ep_select(musb->mregs, epnum);
1000 /* zero the endpoint sizes */
1001 if (musb_ep->is_in) {
1002 u16 int_txe = musb_readw(musb->mregs, MUSB_INTRTXE);
1003 int_txe &= ~(1 << epnum);
1004 musb_writew(musb->mregs, MUSB_INTRTXE, int_txe);
1005 musb_writew(epio, MUSB_TXMAXP, 0);
1007 u16 int_rxe = musb_readw(musb->mregs, MUSB_INTRRXE);
1008 int_rxe &= ~(1 << epnum);
1009 musb_writew(musb->mregs, MUSB_INTRRXE, int_rxe);
1010 musb_writew(epio, MUSB_RXMAXP, 0);
1013 musb_ep->desc = NULL;
1015 /* abort all pending DMA and requests */
1016 nuke(musb_ep, -ESHUTDOWN);
1018 schedule_work(&musb->irq_work);
1020 spin_unlock_irqrestore(&(musb->lock), flags);
1022 DBG(2, "%s\n", musb_ep->end_point.name);
1028 * Allocate a request for an endpoint.
1029 * Reused by ep0 code.
1031 struct usb_request *musb_alloc_request(struct usb_ep *ep, gfp_t gfp_flags)
1033 struct musb_ep *musb_ep = to_musb_ep(ep);
1034 struct musb_request *request = NULL;
1036 request = kzalloc(sizeof *request, gfp_flags);
1038 INIT_LIST_HEAD(&request->request.list);
1039 request->request.dma = DMA_ADDR_INVALID;
1040 request->epnum = musb_ep->current_epnum;
1041 request->ep = musb_ep;
1044 return &request->request;
1049 * Reused by ep0 code.
1051 void musb_free_request(struct usb_ep *ep, struct usb_request *req)
1053 kfree(to_musb_request(req));
1056 static LIST_HEAD(buffers);
1058 struct free_record {
1059 struct list_head list;
1066 * Context: controller locked, IRQs blocked.
1068 static void musb_ep_restart(struct musb *musb, struct musb_request *req)
1070 DBG(3, "<== %s request %p len %u on hw_ep%d\n",
1071 req->tx ? "TX/IN" : "RX/OUT",
1072 &req->request, req->request.length, req->epnum);
1074 musb_ep_select(musb->mregs, req->epnum);
1081 static int musb_gadget_queue(struct usb_ep *ep, struct usb_request *req,
1084 struct musb_ep *musb_ep;
1085 struct musb_request *request;
1088 unsigned long lockflags;
1095 musb_ep = to_musb_ep(ep);
1096 musb = musb_ep->musb;
1098 request = to_musb_request(req);
1099 request->musb = musb;
1101 if (request->ep != musb_ep)
1104 DBG(4, "<== to %s request=%p\n", ep->name, req);
1106 /* request is mine now... */
1107 request->request.actual = 0;
1108 request->request.status = -EINPROGRESS;
1109 request->epnum = musb_ep->current_epnum;
1110 request->tx = musb_ep->is_in;
1112 if (is_dma_capable() && musb_ep->dma) {
1113 if (request->request.dma == DMA_ADDR_INVALID) {
1114 request->request.dma = dma_map_single(
1116 request->request.buf,
1117 request->request.length,
1121 request->mapped = 1;
1123 dma_sync_single_for_device(musb->controller,
1124 request->request.dma,
1125 request->request.length,
1129 request->mapped = 0;
1131 } else if (!req->buf) {
1134 request->mapped = 0;
1136 spin_lock_irqsave(&musb->lock, lockflags);
1138 /* don't queue if the ep is down */
1139 if (!musb_ep->desc) {
1140 DBG(4, "req %p queued to %s while ep %s\n",
1141 req, ep->name, "disabled");
1142 status = -ESHUTDOWN;
1146 /* add request to the list */
1147 list_add_tail(&(request->request.list), &(musb_ep->req_list));
1149 /* it this is the head of the queue, start i/o ... */
1150 if (!musb_ep->busy && &request->request.list == musb_ep->req_list.next)
1151 musb_ep_restart(musb, request);
1154 spin_unlock_irqrestore(&musb->lock, lockflags);
1158 static int musb_gadget_dequeue(struct usb_ep *ep, struct usb_request *request)
1160 struct musb_ep *musb_ep = to_musb_ep(ep);
1161 struct usb_request *r;
1162 unsigned long flags;
1164 struct musb *musb = musb_ep->musb;
1166 if (!ep || !request || to_musb_request(request)->ep != musb_ep)
1169 spin_lock_irqsave(&musb->lock, flags);
1171 list_for_each_entry(r, &musb_ep->req_list, list) {
1176 DBG(3, "request %p not queued to %s\n", request, ep->name);
1181 /* if the hardware doesn't have the request, easy ... */
1182 if (musb_ep->req_list.next != &request->list || musb_ep->busy)
1183 musb_g_giveback(musb_ep, request, -ECONNRESET);
1185 /* ... else abort the dma transfer ... */
1186 else if (is_dma_capable() && musb_ep->dma) {
1187 struct dma_controller *c = musb->dma_controller;
1189 musb_ep_select(musb->mregs, musb_ep->current_epnum);
1190 if (c->channel_abort)
1191 status = c->channel_abort(musb_ep->dma);
1195 musb_g_giveback(musb_ep, request, -ECONNRESET);
1197 /* NOTE: by sticking to easily tested hardware/driver states,
1198 * we leave counting of in-flight packets imprecise.
1200 musb_g_giveback(musb_ep, request, -ECONNRESET);
1204 spin_unlock_irqrestore(&musb->lock, flags);
1209 * Set or clear the halt bit of an endpoint. A halted enpoint won't tx/rx any
1210 * data but will queue requests.
1212 * exported to ep0 code
1214 static int musb_gadget_set_halt(struct usb_ep *ep, int value)
1216 struct musb_ep *musb_ep = to_musb_ep(ep);
1217 u8 epnum = musb_ep->current_epnum;
1218 struct musb *musb = musb_ep->musb;
1219 void __iomem *epio = musb->endpoints[epnum].regs;
1220 void __iomem *mbase;
1221 unsigned long flags;
1223 struct musb_request *request;
1228 mbase = musb->mregs;
1230 spin_lock_irqsave(&musb->lock, flags);
1232 if ((USB_ENDPOINT_XFER_ISOC == musb_ep->type)) {
1237 musb_ep_select(mbase, epnum);
1239 request = to_musb_request(next_request(musb_ep));
1242 DBG(3, "request in progress, cannot halt %s\n",
1247 /* Cannot portably stall with non-empty FIFO */
1248 if (musb_ep->is_in) {
1249 csr = musb_readw(epio, MUSB_TXCSR);
1250 if (csr & MUSB_TXCSR_FIFONOTEMPTY) {
1251 DBG(3, "FIFO busy, cannot halt %s\n", ep->name);
1257 musb_ep->wedged = 0;
1259 /* set/clear the stall and toggle bits */
1260 DBG(2, "%s: %s stall\n", ep->name, value ? "set" : "clear");
1261 if (musb_ep->is_in) {
1262 csr = musb_readw(epio, MUSB_TXCSR);
1263 csr |= MUSB_TXCSR_P_WZC_BITS
1264 | MUSB_TXCSR_CLRDATATOG;
1266 csr |= MUSB_TXCSR_P_SENDSTALL;
1268 csr &= ~(MUSB_TXCSR_P_SENDSTALL
1269 | MUSB_TXCSR_P_SENTSTALL);
1270 csr &= ~MUSB_TXCSR_TXPKTRDY;
1271 musb_writew(epio, MUSB_TXCSR, csr);
1273 csr = musb_readw(epio, MUSB_RXCSR);
1274 csr |= MUSB_RXCSR_P_WZC_BITS
1275 | MUSB_RXCSR_FLUSHFIFO
1276 | MUSB_RXCSR_CLRDATATOG;
1278 csr |= MUSB_RXCSR_P_SENDSTALL;
1280 csr &= ~(MUSB_RXCSR_P_SENDSTALL
1281 | MUSB_RXCSR_P_SENTSTALL);
1282 musb_writew(epio, MUSB_RXCSR, csr);
1285 /* maybe start the first request in the queue */
1286 if (!musb_ep->busy && !value && request) {
1287 DBG(3, "restarting the request\n");
1288 musb_ep_restart(musb, request);
1292 spin_unlock_irqrestore(&musb->lock, flags);
1297 * Sets the halt feature with the clear requests ignored
1299 static int musb_gadget_set_wedge(struct usb_ep *ep)
1301 struct musb_ep *musb_ep = to_musb_ep(ep);
1306 musb_ep->wedged = 1;
1308 return usb_ep_set_halt(ep);
1311 static int musb_gadget_fifo_status(struct usb_ep *ep)
1313 struct musb_ep *musb_ep = to_musb_ep(ep);
1314 void __iomem *epio = musb_ep->hw_ep->regs;
1315 int retval = -EINVAL;
1317 if (musb_ep->desc && !musb_ep->is_in) {
1318 struct musb *musb = musb_ep->musb;
1319 int epnum = musb_ep->current_epnum;
1320 void __iomem *mbase = musb->mregs;
1321 unsigned long flags;
1323 spin_lock_irqsave(&musb->lock, flags);
1325 musb_ep_select(mbase, epnum);
1326 /* FIXME return zero unless RXPKTRDY is set */
1327 retval = musb_readw(epio, MUSB_RXCOUNT);
1329 spin_unlock_irqrestore(&musb->lock, flags);
1334 static void musb_gadget_fifo_flush(struct usb_ep *ep)
1336 struct musb_ep *musb_ep = to_musb_ep(ep);
1337 struct musb *musb = musb_ep->musb;
1338 u8 epnum = musb_ep->current_epnum;
1339 void __iomem *epio = musb->endpoints[epnum].regs;
1340 void __iomem *mbase;
1341 unsigned long flags;
1344 mbase = musb->mregs;
1346 spin_lock_irqsave(&musb->lock, flags);
1347 musb_ep_select(mbase, (u8) epnum);
1349 /* disable interrupts */
1350 int_txe = musb_readw(mbase, MUSB_INTRTXE);
1351 musb_writew(mbase, MUSB_INTRTXE, int_txe & ~(1 << epnum));
1353 if (musb_ep->is_in) {
1354 csr = musb_readw(epio, MUSB_TXCSR);
1355 if (csr & MUSB_TXCSR_FIFONOTEMPTY) {
1356 csr |= MUSB_TXCSR_FLUSHFIFO | MUSB_TXCSR_P_WZC_BITS;
1357 musb_writew(epio, MUSB_TXCSR, csr);
1358 /* REVISIT may be inappropriate w/o FIFONOTEMPTY ... */
1359 musb_writew(epio, MUSB_TXCSR, csr);
1362 csr = musb_readw(epio, MUSB_RXCSR);
1363 csr |= MUSB_RXCSR_FLUSHFIFO | MUSB_RXCSR_P_WZC_BITS;
1364 musb_writew(epio, MUSB_RXCSR, csr);
1365 musb_writew(epio, MUSB_RXCSR, csr);
1368 /* re-enable interrupt */
1369 musb_writew(mbase, MUSB_INTRTXE, int_txe);
1370 spin_unlock_irqrestore(&musb->lock, flags);
1373 static const struct usb_ep_ops musb_ep_ops = {
1374 .enable = musb_gadget_enable,
1375 .disable = musb_gadget_disable,
1376 .alloc_request = musb_alloc_request,
1377 .free_request = musb_free_request,
1378 .queue = musb_gadget_queue,
1379 .dequeue = musb_gadget_dequeue,
1380 .set_halt = musb_gadget_set_halt,
1381 .set_wedge = musb_gadget_set_wedge,
1382 .fifo_status = musb_gadget_fifo_status,
1383 .fifo_flush = musb_gadget_fifo_flush
1386 /* ----------------------------------------------------------------------- */
1388 static int musb_gadget_get_frame(struct usb_gadget *gadget)
1390 struct musb *musb = gadget_to_musb(gadget);
1392 return (int)musb_readw(musb->mregs, MUSB_FRAME);
1395 static int musb_gadget_wakeup(struct usb_gadget *gadget)
1397 struct musb *musb = gadget_to_musb(gadget);
1398 void __iomem *mregs = musb->mregs;
1399 unsigned long flags;
1400 int status = -EINVAL;
1404 spin_lock_irqsave(&musb->lock, flags);
1406 switch (musb->xceiv->state) {
1407 case OTG_STATE_B_PERIPHERAL:
1408 /* NOTE: OTG state machine doesn't include B_SUSPENDED;
1409 * that's part of the standard usb 1.1 state machine, and
1410 * doesn't affect OTG transitions.
1412 if (musb->may_wakeup && musb->is_suspended)
1415 case OTG_STATE_B_IDLE:
1416 /* Start SRP ... OTG not required. */
1417 devctl = musb_readb(mregs, MUSB_DEVCTL);
1418 DBG(2, "Sending SRP: devctl: %02x\n", devctl);
1419 devctl |= MUSB_DEVCTL_SESSION;
1420 musb_writeb(mregs, MUSB_DEVCTL, devctl);
1421 devctl = musb_readb(mregs, MUSB_DEVCTL);
1423 while (!(devctl & MUSB_DEVCTL_SESSION)) {
1424 devctl = musb_readb(mregs, MUSB_DEVCTL);
1429 while (devctl & MUSB_DEVCTL_SESSION) {
1430 devctl = musb_readb(mregs, MUSB_DEVCTL);
1435 /* Block idling for at least 1s */
1436 musb_platform_try_idle(musb,
1437 jiffies + msecs_to_jiffies(1 * HZ));
1442 DBG(2, "Unhandled wake: %s\n", otg_state_string(musb));
1448 power = musb_readb(mregs, MUSB_POWER);
1449 power |= MUSB_POWER_RESUME;
1450 musb_writeb(mregs, MUSB_POWER, power);
1451 DBG(2, "issue wakeup\n");
1453 /* FIXME do this next chunk in a timer callback, no udelay */
1456 power = musb_readb(mregs, MUSB_POWER);
1457 power &= ~MUSB_POWER_RESUME;
1458 musb_writeb(mregs, MUSB_POWER, power);
1460 spin_unlock_irqrestore(&musb->lock, flags);
1465 musb_gadget_set_self_powered(struct usb_gadget *gadget, int is_selfpowered)
1467 struct musb *musb = gadget_to_musb(gadget);
1469 musb->is_self_powered = !!is_selfpowered;
1473 static void musb_pullup(struct musb *musb, int is_on)
1477 power = musb_readb(musb->mregs, MUSB_POWER);
1479 power |= MUSB_POWER_SOFTCONN;
1481 power &= ~MUSB_POWER_SOFTCONN;
1483 /* FIXME if on, HdrcStart; if off, HdrcStop */
1485 DBG(3, "gadget %s D+ pullup %s\n",
1486 musb->gadget_driver->function, is_on ? "on" : "off");
1487 musb_writeb(musb->mregs, MUSB_POWER, power);
1491 static int musb_gadget_vbus_session(struct usb_gadget *gadget, int is_active)
1493 DBG(2, "<= %s =>\n", __func__);
1496 * FIXME iff driver's softconnect flag is set (as it is during probe,
1497 * though that can clear it), just musb_pullup().
1504 static int musb_gadget_vbus_draw(struct usb_gadget *gadget, unsigned mA)
1506 struct musb *musb = gadget_to_musb(gadget);
1508 if (!musb->xceiv->set_power)
1510 return otg_set_power(musb->xceiv, mA);
1513 static int musb_gadget_pullup(struct usb_gadget *gadget, int is_on)
1515 struct musb *musb = gadget_to_musb(gadget);
1516 unsigned long flags;
1520 /* NOTE: this assumes we are sensing vbus; we'd rather
1521 * not pullup unless the B-session is active.
1523 spin_lock_irqsave(&musb->lock, flags);
1524 if (is_on != musb->softconnect) {
1525 musb->softconnect = is_on;
1526 musb_pullup(musb, is_on);
1528 spin_unlock_irqrestore(&musb->lock, flags);
1532 static const struct usb_gadget_ops musb_gadget_operations = {
1533 .get_frame = musb_gadget_get_frame,
1534 .wakeup = musb_gadget_wakeup,
1535 .set_selfpowered = musb_gadget_set_self_powered,
1536 /* .vbus_session = musb_gadget_vbus_session, */
1537 .vbus_draw = musb_gadget_vbus_draw,
1538 .pullup = musb_gadget_pullup,
1541 /* ----------------------------------------------------------------------- */
1545 /* Only this registration code "knows" the rule (from USB standards)
1546 * about there being only one external upstream port. It assumes
1547 * all peripheral ports are external...
1549 static struct musb *the_gadget;
1551 static void musb_gadget_release(struct device *dev)
1553 /* kref_put(WHAT) */
1554 dev_dbg(dev, "%s\n", __func__);
1559 init_peripheral_ep(struct musb *musb, struct musb_ep *ep, u8 epnum, int is_in)
1561 struct musb_hw_ep *hw_ep = musb->endpoints + epnum;
1563 memset(ep, 0, sizeof *ep);
1565 ep->current_epnum = epnum;
1570 INIT_LIST_HEAD(&ep->req_list);
1572 sprintf(ep->name, "ep%d%s", epnum,
1573 (!epnum || hw_ep->is_shared_fifo) ? "" : (
1574 is_in ? "in" : "out"));
1575 ep->end_point.name = ep->name;
1576 INIT_LIST_HEAD(&ep->end_point.ep_list);
1578 ep->end_point.maxpacket = 64;
1579 ep->end_point.ops = &musb_g_ep0_ops;
1580 musb->g.ep0 = &ep->end_point;
1583 ep->end_point.maxpacket = hw_ep->max_packet_sz_tx;
1585 ep->end_point.maxpacket = hw_ep->max_packet_sz_rx;
1586 ep->end_point.ops = &musb_ep_ops;
1587 list_add_tail(&ep->end_point.ep_list, &musb->g.ep_list);
1592 * Initialize the endpoints exposed to peripheral drivers, with backlinks
1593 * to the rest of the driver state.
1595 static inline void __init musb_g_init_endpoints(struct musb *musb)
1598 struct musb_hw_ep *hw_ep;
1601 /* intialize endpoint list just once */
1602 INIT_LIST_HEAD(&(musb->g.ep_list));
1604 for (epnum = 0, hw_ep = musb->endpoints;
1605 epnum < musb->nr_endpoints;
1607 if (hw_ep->is_shared_fifo /* || !epnum */) {
1608 init_peripheral_ep(musb, &hw_ep->ep_in, epnum, 0);
1611 if (hw_ep->max_packet_sz_tx) {
1612 init_peripheral_ep(musb, &hw_ep->ep_in,
1616 if (hw_ep->max_packet_sz_rx) {
1617 init_peripheral_ep(musb, &hw_ep->ep_out,
1625 /* called once during driver setup to initialize and link into
1626 * the driver model; memory is zeroed.
1628 int __init musb_gadget_setup(struct musb *musb)
1632 /* REVISIT minor race: if (erroneously) setting up two
1633 * musb peripherals at the same time, only the bus lock
1640 musb->g.ops = &musb_gadget_operations;
1641 musb->g.is_dualspeed = 1;
1642 musb->g.speed = USB_SPEED_UNKNOWN;
1644 /* this "gadget" abstracts/virtualizes the controller */
1645 dev_set_name(&musb->g.dev, "gadget");
1646 musb->g.dev.parent = musb->controller;
1647 musb->g.dev.dma_mask = musb->controller->dma_mask;
1648 musb->g.dev.release = musb_gadget_release;
1649 musb->g.name = musb_driver_name;
1651 if (is_otg_enabled(musb))
1654 musb_g_init_endpoints(musb);
1656 musb->is_active = 0;
1657 musb_platform_try_idle(musb, 0);
1659 status = device_register(&musb->g.dev);
1665 void musb_gadget_cleanup(struct musb *musb)
1667 if (musb != the_gadget)
1670 device_unregister(&musb->g.dev);
1675 * Register the gadget driver. Used by gadget drivers when
1676 * registering themselves with the controller.
1678 * -EINVAL something went wrong (not driver)
1679 * -EBUSY another gadget is already using the controller
1680 * -ENOMEM no memeory to perform the operation
1682 * @param driver the gadget driver
1683 * @return <0 if error, 0 if everything is fine
1685 int usb_gadget_register_driver(struct usb_gadget_driver *driver)
1688 unsigned long flags;
1689 struct musb *musb = the_gadget;
1692 || driver->speed != USB_SPEED_HIGH
1697 /* driver must be initialized to support peripheral mode */
1698 if (!musb || !(musb->board_mode == MUSB_OTG
1699 || musb->board_mode != MUSB_OTG)) {
1700 DBG(1, "%s, no dev??\n", __func__);
1704 DBG(3, "registering driver %s\n", driver->function);
1705 spin_lock_irqsave(&musb->lock, flags);
1707 if (musb->gadget_driver) {
1708 DBG(1, "%s is already bound to %s\n",
1710 musb->gadget_driver->driver.name);
1713 musb->gadget_driver = driver;
1714 musb->g.dev.driver = &driver->driver;
1715 driver->driver.bus = NULL;
1716 musb->softconnect = 1;
1720 spin_unlock_irqrestore(&musb->lock, flags);
1723 retval = driver->bind(&musb->g);
1725 DBG(3, "bind to driver %s failed --> %d\n",
1726 driver->driver.name, retval);
1727 musb->gadget_driver = NULL;
1728 musb->g.dev.driver = NULL;
1731 spin_lock_irqsave(&musb->lock, flags);
1733 otg_set_peripheral(musb->xceiv, &musb->g);
1734 musb->is_active = 1;
1736 /* FIXME this ignores the softconnect flag. Drivers are
1737 * allowed hold the peripheral inactive until for example
1738 * userspace hooks up printer hardware or DSP codecs, so
1739 * hosts only see fully functional devices.
1742 if (!is_otg_enabled(musb))
1745 otg_set_peripheral(musb->xceiv, &musb->g);
1747 spin_unlock_irqrestore(&musb->lock, flags);
1749 if (is_otg_enabled(musb)) {
1750 DBG(3, "OTG startup...\n");
1752 /* REVISIT: funcall to other code, which also
1753 * handles power budgeting ... this way also
1754 * ensures HdrcStart is indirectly called.
1756 retval = usb_add_hcd(musb_to_hcd(musb), -1, 0);
1758 DBG(1, "add_hcd failed, %d\n", retval);
1759 spin_lock_irqsave(&musb->lock, flags);
1760 otg_set_peripheral(musb->xceiv, NULL);
1761 musb->gadget_driver = NULL;
1762 musb->g.dev.driver = NULL;
1763 spin_unlock_irqrestore(&musb->lock, flags);
1770 EXPORT_SYMBOL(usb_gadget_register_driver);
1772 static void stop_activity(struct musb *musb, struct usb_gadget_driver *driver)
1775 struct musb_hw_ep *hw_ep;
1777 /* don't disconnect if it's not connected */
1778 if (musb->g.speed == USB_SPEED_UNKNOWN)
1781 musb->g.speed = USB_SPEED_UNKNOWN;
1783 /* deactivate the hardware */
1784 if (musb->softconnect) {
1785 musb->softconnect = 0;
1786 musb_pullup(musb, 0);
1790 /* killing any outstanding requests will quiesce the driver;
1791 * then report disconnect
1794 for (i = 0, hw_ep = musb->endpoints;
1795 i < musb->nr_endpoints;
1797 musb_ep_select(musb->mregs, i);
1798 if (hw_ep->is_shared_fifo /* || !epnum */) {
1799 nuke(&hw_ep->ep_in, -ESHUTDOWN);
1801 if (hw_ep->max_packet_sz_tx)
1802 nuke(&hw_ep->ep_in, -ESHUTDOWN);
1803 if (hw_ep->max_packet_sz_rx)
1804 nuke(&hw_ep->ep_out, -ESHUTDOWN);
1808 spin_unlock(&musb->lock);
1809 driver->disconnect(&musb->g);
1810 spin_lock(&musb->lock);
1815 * Unregister the gadget driver. Used by gadget drivers when
1816 * unregistering themselves from the controller.
1818 * @param driver the gadget driver to unregister
1820 int usb_gadget_unregister_driver(struct usb_gadget_driver *driver)
1822 unsigned long flags;
1824 struct musb *musb = the_gadget;
1826 if (!driver || !driver->unbind || !musb)
1829 /* REVISIT always use otg_set_peripheral() here too;
1830 * this needs to shut down the OTG engine.
1833 spin_lock_irqsave(&musb->lock, flags);
1835 #ifdef CONFIG_USB_MUSB_OTG
1836 musb_hnp_stop(musb);
1839 if (musb->gadget_driver == driver) {
1841 (void) musb_gadget_vbus_draw(&musb->g, 0);
1843 musb->xceiv->state = OTG_STATE_UNDEFINED;
1844 stop_activity(musb, driver);
1845 otg_set_peripheral(musb->xceiv, NULL);
1847 DBG(3, "unregistering driver %s\n", driver->function);
1848 spin_unlock_irqrestore(&musb->lock, flags);
1849 driver->unbind(&musb->g);
1850 spin_lock_irqsave(&musb->lock, flags);
1852 musb->gadget_driver = NULL;
1853 musb->g.dev.driver = NULL;
1855 musb->is_active = 0;
1856 musb_platform_try_idle(musb, 0);
1859 spin_unlock_irqrestore(&musb->lock, flags);
1861 if (is_otg_enabled(musb) && retval == 0) {
1862 usb_remove_hcd(musb_to_hcd(musb));
1863 /* FIXME we need to be able to register another
1864 * gadget driver here and have everything work;
1865 * that currently misbehaves.
1871 EXPORT_SYMBOL(usb_gadget_unregister_driver);
1874 /* ----------------------------------------------------------------------- */
1876 /* lifecycle operations called through plat_uds.c */
1878 void musb_g_resume(struct musb *musb)
1880 musb->is_suspended = 0;
1881 switch (musb->xceiv->state) {
1882 case OTG_STATE_B_IDLE:
1884 case OTG_STATE_B_WAIT_ACON:
1885 case OTG_STATE_B_PERIPHERAL:
1886 musb->is_active = 1;
1887 if (musb->gadget_driver && musb->gadget_driver->resume) {
1888 spin_unlock(&musb->lock);
1889 musb->gadget_driver->resume(&musb->g);
1890 spin_lock(&musb->lock);
1894 WARNING("unhandled RESUME transition (%s)\n",
1895 otg_state_string(musb));
1899 /* called when SOF packets stop for 3+ msec */
1900 void musb_g_suspend(struct musb *musb)
1904 devctl = musb_readb(musb->mregs, MUSB_DEVCTL);
1905 DBG(3, "devctl %02x\n", devctl);
1907 switch (musb->xceiv->state) {
1908 case OTG_STATE_B_IDLE:
1909 if ((devctl & MUSB_DEVCTL_VBUS) == MUSB_DEVCTL_VBUS)
1910 musb->xceiv->state = OTG_STATE_B_PERIPHERAL;
1912 case OTG_STATE_B_PERIPHERAL:
1913 musb->is_suspended = 1;
1914 if (musb->gadget_driver && musb->gadget_driver->suspend) {
1915 spin_unlock(&musb->lock);
1916 musb->gadget_driver->suspend(&musb->g);
1917 spin_lock(&musb->lock);
1921 /* REVISIT if B_HOST, clear DEVCTL.HOSTREQ;
1922 * A_PERIPHERAL may need care too
1924 WARNING("unhandled SUSPEND transition (%s)\n",
1925 otg_state_string(musb));
1929 /* Called during SRP */
1930 void musb_g_wakeup(struct musb *musb)
1932 musb_gadget_wakeup(&musb->g);
1935 /* called when VBUS drops below session threshold, and in other cases */
1936 void musb_g_disconnect(struct musb *musb)
1938 void __iomem *mregs = musb->mregs;
1939 u8 devctl = musb_readb(mregs, MUSB_DEVCTL);
1941 DBG(3, "devctl %02x\n", devctl);
1944 musb_writeb(mregs, MUSB_DEVCTL, devctl & MUSB_DEVCTL_SESSION);
1946 /* don't draw vbus until new b-default session */
1947 (void) musb_gadget_vbus_draw(&musb->g, 0);
1949 musb->g.speed = USB_SPEED_UNKNOWN;
1950 if (musb->gadget_driver && musb->gadget_driver->disconnect) {
1951 spin_unlock(&musb->lock);
1952 musb->gadget_driver->disconnect(&musb->g);
1953 spin_lock(&musb->lock);
1956 switch (musb->xceiv->state) {
1958 #ifdef CONFIG_USB_MUSB_OTG
1959 DBG(2, "Unhandled disconnect %s, setting a_idle\n",
1960 otg_state_string(musb));
1961 musb->xceiv->state = OTG_STATE_A_IDLE;
1962 MUSB_HST_MODE(musb);
1964 case OTG_STATE_A_PERIPHERAL:
1965 musb->xceiv->state = OTG_STATE_A_WAIT_BCON;
1966 MUSB_HST_MODE(musb);
1968 case OTG_STATE_B_WAIT_ACON:
1969 case OTG_STATE_B_HOST:
1971 case OTG_STATE_B_PERIPHERAL:
1972 case OTG_STATE_B_IDLE:
1973 musb->xceiv->state = OTG_STATE_B_IDLE;
1975 case OTG_STATE_B_SRP_INIT:
1979 musb->is_active = 0;
1982 void musb_g_reset(struct musb *musb)
1983 __releases(musb->lock)
1984 __acquires(musb->lock)
1986 void __iomem *mbase = musb->mregs;
1987 u8 devctl = musb_readb(mbase, MUSB_DEVCTL);
1990 DBG(3, "<== %s addr=%x driver '%s'\n",
1991 (devctl & MUSB_DEVCTL_BDEVICE)
1992 ? "B-Device" : "A-Device",
1993 musb_readb(mbase, MUSB_FADDR),
1995 ? musb->gadget_driver->driver.name
1999 /* report disconnect, if we didn't already (flushing EP state) */
2000 if (musb->g.speed != USB_SPEED_UNKNOWN)
2001 musb_g_disconnect(musb);
2004 else if (devctl & MUSB_DEVCTL_HR)
2005 musb_writeb(mbase, MUSB_DEVCTL, MUSB_DEVCTL_SESSION);
2008 /* what speed did we negotiate? */
2009 power = musb_readb(mbase, MUSB_POWER);
2010 musb->g.speed = (power & MUSB_POWER_HSMODE)
2011 ? USB_SPEED_HIGH : USB_SPEED_FULL;
2013 /* start in USB_STATE_DEFAULT */
2014 musb->is_active = 1;
2015 musb->is_suspended = 0;
2016 MUSB_DEV_MODE(musb);
2018 musb->ep0_state = MUSB_EP0_STAGE_SETUP;
2020 musb->may_wakeup = 0;
2021 musb->g.b_hnp_enable = 0;
2022 musb->g.a_alt_hnp_support = 0;
2023 musb->g.a_hnp_support = 0;
2025 /* Normal reset, as B-Device;
2026 * or else after HNP, as A-Device
2028 if (devctl & MUSB_DEVCTL_BDEVICE) {
2029 musb->xceiv->state = OTG_STATE_B_PERIPHERAL;
2030 musb->g.is_a_peripheral = 0;
2031 } else if (is_otg_enabled(musb)) {
2032 musb->xceiv->state = OTG_STATE_A_PERIPHERAL;
2033 musb->g.is_a_peripheral = 1;
2037 /* start with default limits on VBUS power draw */
2038 (void) musb_gadget_vbus_draw(&musb->g,
2039 is_otg_enabled(musb) ? 8 : 100);