driver-api/usb/dwc3.rst

15 	1. Peripheral-only configuration
16 	2. Host-only configuration
17 	3. Dual-Role configuration
46 	   pipe - ep0)
49 	4. Scatter-list support
58 These features have all been exercised with many of the **in-tree**
67 for new-comers to read the code and understand how it behaves.
83 ---------------------------------
88 receive a Mass Storage *CBW* [#cbw]_, req->length must either be set
91 to a throw-away buffer for the remaining length. Without this, OUT
98 about DWC3 and *non-working transfers*.
101 -------------------------
120 	2. You can reproduce the error without any out-of-tree changes
128 ---------------------
137 .. code-block:: sh
139 		 # mkdir -p /d
140 		 # mkdir -p /t
141 		 # mount -t debugfs none /d
142 		 # mount -t tracefs none /t
150 .. code-block:: sh
156 and email it to `me`_ with `linux-usb`_ in Cc. If you want to be extra
182 applause :-)
191 Feel free to email `me`_ and Cc `linux-usb`_ if you need any help.
194 -------------
211 ``U2``, ``U3``, ``SS.Disabled``, ``RX.Detect``, ``SS.Inactive``,
221 File name is self-explanatory. When read, ``regdump`` will print out a
263 will print ``--``.
272 .. code-block:: sh
274 		buffer_addr,size,type,ioc,isp_imi,csp,chn,lst,hwo
534 -------------
555   TP_printk("addr %p value %08x", __entry->base + __entry->offset,
556   		__entry->value)
565   TP_printk("event (%08x): %s", __entry->event,
566   		dwc3_decode_event(__entry->event, __entry->ep0state))
574   TP_printk("%s", dwc3_decode_ctrl(__entry->bRequestType,
575   				__entry->bRequest, __entry->wValue,
576   				__entry->wIndex, __entry->wLength)
580 human-readable strings with their respective arguments. Class and
592   	__get_str(name), __entry->req, __entry->actual, __entry->length,
593   	__entry->zero ? "Z" : "z",
594   	__entry->short_not_ok ? "S" : "s",
595   	__entry->no_interrupt ? "i" : "I",
596   	__entry->status
605   TP_printk("cmd '%s' [%x] param %08x --> status: %s",
606   	dwc3_gadget_generic_cmd_string(__entry->cmd),
607   	__entry->cmd, __entry->param,
608   	dwc3_gadget_generic_cmd_status_string(__entry->status)
617   TP_printk("%s: cmd '%s' [%d] params %08x %08x %08x --> status: %s",
618   	__get_str(name), dwc3_gadget_ep_cmd_string(__entry->cmd),
619   	__entry->cmd, __entry->param0,
620   	__entry->param1, __entry->param2,
621   	dwc3_ep_cmd_status_string(__entry->cmd_status)
632   	__get_str(name), __entry->queued, __entry->allocated,
633   	__entry->trb, __entry->bph, __entry->bpl,
635   	int pcm = ((__entry->size >> 24) & 3) + 1;
636   	switch (__entry->type) {
653   	DWC3_TRB_SIZE_LENGTH(__entry->size), __entry->ctrl,
654   	__entry->ctrl & DWC3_TRB_CTRL_HWO ? 'H' : 'h',
655   	__entry->ctrl & DWC3_TRB_CTRL_LST ? 'L' : 'l',
656   	__entry->ctrl & DWC3_TRB_CTRL_CHN ? 'C' : 'c',
657   	__entry->ctrl & DWC3_TRB_CTRL_CSP ? 'S' : 's',
658   	__entry->ctrl & DWC3_TRB_CTRL_ISP_IMI ? 'S' : 's',
659   	__entry->ctrl & DWC3_TRB_CTRL_IOC ? 'C' : 'c',
660       dwc3_trb_type_string(DWC3_TRBCTL_TYPE(__entry->ctrl))
670   	__get_str(name), __entry->maxpacket,
671   	__entry->maxpacket_limit, __entry->max_streams,
672   	__entry->maxburst, __entry->trb_enqueue,
673   	__entry->trb_dequeue,
674   	__entry->flags & DWC3_EP_ENABLED ? 'E' : 'e',
675   	__entry->flags & DWC3_EP_STALL ? 'S' : 's',
676   	__entry->flags & DWC3_EP_WEDGE ? 'W' : 'w',
677   	__entry->flags & DWC3_EP_TRANSFER_STARTED ? 'B' : 'b',
678   	__entry->flags & DWC3_EP_PENDING_REQUEST ? 'P' : 'p',
679   	__entry->flags & DWC3_EP_END_TRANSFER_PENDING ? 'E' : 'e',
680   	__entry->direction ? '<' : '>'
687 .. kernel-doc:: drivers/usb/dwc3/core.h
691 .. kernel-doc:: drivers/usb/dwc3/gadget.h
692    :doc: gadget-only helpers
695 .. kernel-doc:: drivers/usb/dwc3/gadget.c
696    :doc: gadget-side implementation
699 .. kernel-doc:: drivers/usb/dwc3/core.c
711 .. _linux-usb: linux-usb@vger.kernel.org