[linux.git] / Documentation / usb / dwc3.txt


 TODO
~~~~~~
Please pick something while reading :)

- Convert interrupt handler to per-ep-thread-irq

  As it turns out some DWC3-commands ~1ms to complete. Currently we spin
  until the command completes which is bad.

  Implementation idea:
  - dwc core implements a demultiplexing irq chip for interrupts per
    endpoint. The interrupt numbers are allocated during probe and belong
    to the device. If MSI provides per-endpoint interrupt this dummy
    interrupt chip can be replaced with "real" interrupts.
  - interrupts are requested / allocated on usb_ep_enable() and removed on
    usb_ep_disable(). Worst case are 32 interrupts, the lower limit is two
    for ep0/1.
  - dwc3_send_gadget_ep_cmd() will sleep in wait_for_completion_timeout()
    until the command completes.
  - the interrupt handler is split into the following pieces:
    - primary handler of the device
      goes through every event and calls generic_handle_irq() for event
      it. On return from generic_handle_irq() in acknowledges the event
      counter so interrupt goes away (eventually).

    - threaded handler of the device
      none

    - primary handler of the EP-interrupt
      reads the event and tries to process it. Everything that requires
      sleeping is handed over to the Thread. The event is saved in an
      per-endpoint data-structure.
      We probably have to pay attention not to process events once we
      handed something to thread so we don't process event X prio Y
      where X > Y.

    - threaded handler of the EP-interrupt
      handles the remaining EP work which might sleep such as waiting
      for command completion.

  Latency:
   There should be no increase in latency since the interrupt-thread has a
   high priority and will be run before an average task in user land
   (except the user changed priorities).
Commit	Line	Data
72246da4 FB	1
	2	TODO
	3	~~~~~~
	4	Please pick something while reading :)
	5
72246da4 FB	6	- Convert interrupt handler to per-ep-thread-irq
	7
	8	As it turns out some DWC3-commands ~1ms to complete. Currently we spin
	9	until the command completes which is bad.
	10
	11	Implementation idea:
	12	- dwc core implements a demultiplexing irq chip for interrupts per
	13	endpoint. The interrupt numbers are allocated during probe and belong
	14	to the device. If MSI provides per-endpoint interrupt this dummy
	15	interrupt chip can be replaced with "real" interrupts.
	16	- interrupts are requested / allocated on usb_ep_enable() and removed on
	17	usb_ep_disable(). Worst case are 32 interrupts, the lower limit is two
	18	for ep0/1.
	19	- dwc3_send_gadget_ep_cmd() will sleep in wait_for_completion_timeout()
	20	until the command completes.
	21	- the interrupt handler is split into the following pieces:
	22	- primary handler of the device
	23	goes through every event and calls generic_handle_irq() for event
	24	it. On return from generic_handle_irq() in acknowledges the event
	25	counter so interrupt goes away (eventually).
	26
	27	- threaded handler of the device
	28	none
	29
	30	- primary handler of the EP-interrupt
5edfe7d8	31	reads the event and tries to process it. Everything that requires
72246da4 FB	32	sleeping is handed over to the Thread. The event is saved in an
	33	per-endpoint data-structure.
	34	We probably have to pay attention not to process events once we
	35	handed something to thread so we don't process event X prio Y
	36	where X > Y.
	37
	38	- threaded handler of the EP-interrupt
	39	handles the remaining EP work which might sleep such as waiting
	40	for command completion.
	41
	42	Latency:
	43	There should be no increase in latency since the interrupt-thread has a
	44	high priority and will be run before an average task in user land
	45	(except the user changed priorities).