Linux Audio

Check our new training course

Loading...
v6.8
  1# SPDX-License-Identifier: GPL-2.0
  2#
  3# USB Gadget support on a system involves
  4#    (a) a peripheral controller, and
  5#    (b) the gadget driver using it.
  6#
  7# NOTE:  Gadget support ** DOES NOT ** depend on host-side CONFIG_USB !!
  8#
  9#  - Host systems (like PCs) need CONFIG_USB (with "A" jacks).
 10#  - Peripherals (like PDAs) need CONFIG_USB_GADGET (with "B" jacks).
 11#  - Some systems have both kinds of controllers.
 12#
 13# With help from a special transceiver and a "Mini-AB" jack, systems with
 14# both kinds of controller can also support "USB On-the-Go" (CONFIG_USB_OTG).
 15#
 16
 17menuconfig USB_GADGET
 18	tristate "USB Gadget Support"
 19	select USB_COMMON
 20	select NLS
 21	help
 22	   USB is a host/device protocol, organized with one host (such as a
 23	   PC) controlling up to 127 peripheral devices.
 24	   The USB hardware is asymmetric, which makes it easier to set up:
 25	   you can't connect a "to-the-host" connector to a peripheral.
 26
 27	   Linux can run in the host, or in the peripheral.  In both cases
 28	   you need a low level bus controller driver, and some software
 29	   talking to it.  Peripheral controllers are often discrete silicon,
 30	   or are integrated with the CPU in a microcontroller.  The more
 31	   familiar host side controllers have names like "EHCI", "OHCI",
 32	   or "UHCI", and are usually integrated into southbridges on PC
 33	   motherboards.
 34
 35	   Enable this configuration option if you want to run Linux inside
 36	   a USB peripheral device.  Configure one hardware driver for your
 37	   peripheral/device side bus controller, and a "gadget driver" for
 38	   your peripheral protocol.  (If you use modular gadget drivers,
 39	   you may configure more than one.)
 40
 41	   If in doubt, say "N" and don't enable these drivers; most people
 42	   don't have this kind of hardware (except maybe inside Linux PDAs).
 43
 44	   For more information, see <http://www.linux-usb.org/gadget> and
 45	   the kernel documentation for this API.
 46
 47if USB_GADGET
 48
 49config USB_GADGET_DEBUG
 50	bool "Debugging messages (DEVELOPMENT)"
 51	depends on DEBUG_KERNEL
 52	help
 53	   Many controller and gadget drivers will print some debugging
 54	   messages if you use this option to ask for those messages.
 55
 56	   Avoid enabling these messages, even if you're actively
 57	   debugging such a driver.  Many drivers will emit so many
 58	   messages that the driver timings are affected, which will
 59	   either create new failure modes or remove the one you're
 60	   trying to track down.  Never enable these messages for a
 61	   production build.
 62
 63config USB_GADGET_VERBOSE
 64	bool "Verbose debugging Messages (DEVELOPMENT)"
 65	depends on USB_GADGET_DEBUG
 66	help
 67	   Many controller and gadget drivers will print verbose debugging
 68	   messages if you use this option to ask for those messages.
 69
 70	   Avoid enabling these messages, even if you're actively
 71	   debugging such a driver.  Many drivers will emit so many
 72	   messages that the driver timings are affected, which will
 73	   either create new failure modes or remove the one you're
 74	   trying to track down.  Never enable these messages for a
 75	   production build.
 76
 77config USB_GADGET_DEBUG_FILES
 78	bool "Debugging information files (DEVELOPMENT)"
 79	depends on PROC_FS
 80	help
 81	   Some of the drivers in the "gadget" framework can expose
 82	   debugging information in files such as /proc/driver/udc
 83	   (for a peripheral controller).  The information in these
 84	   files may help when you're troubleshooting or bringing up a
 85	   driver on a new board.   Enable these files by choosing "Y"
 86	   here.  If in doubt, or to conserve kernel memory, say "N".
 87
 88config USB_GADGET_DEBUG_FS
 89	bool "Debugging information files in debugfs (DEVELOPMENT)"
 90	depends on DEBUG_FS
 91	help
 92	   Some of the drivers in the "gadget" framework can expose
 93	   debugging information in files under /sys/kernel/debug/.
 94	   The information in these files may help when you're
 95	   troubleshooting or bringing up a driver on a new board.
 96	   Enable these files by choosing "Y" here.  If in doubt, or
 97	   to conserve kernel memory, say "N".
 98
 99config USB_GADGET_VBUS_DRAW
100	int "Maximum VBUS Power usage (2-500 mA)"
101	range 2 500
102	default 2
103	help
104	   Some devices need to draw power from USB when they are
105	   configured, perhaps to operate circuitry or to recharge
106	   batteries.  This is in addition to any local power supply,
107	   such as an AC adapter or batteries.
108
109	   Enter the maximum power your device draws through USB, in
110	   milliAmperes.  The permitted range of values is 2 - 500 mA;
111	   0 mA would be legal, but can make some hosts misbehave.
112
113	   This value will be used except for system-specific gadget
114	   drivers that have more specific information.
115
116config USB_GADGET_STORAGE_NUM_BUFFERS
117	int "Number of storage pipeline buffers"
118	range 2 256
119	default 2
120	help
121	   Usually 2 buffers are enough to establish a good buffering
122	   pipeline. The number may be increased in order to compensate
123	   for a bursty VFS behaviour. For instance there may be CPU wake up
124	   latencies that makes the VFS to appear bursty in a system with
125	   an CPU on-demand governor. Especially if DMA is doing IO to
126	   offload the CPU. In this case the CPU will go into power
127	   save often and spin up occasionally to move data within VFS.
128	   If selecting USB_GADGET_DEBUG_FILES this value may be set by
129	   a module parameter as well.
130	   If unsure, say 2.
131
132config U_SERIAL_CONSOLE
133	bool "Serial gadget console support"
134	depends on USB_U_SERIAL
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
135	help
136	   It supports the serial gadget can be used as a console.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
137
138source "drivers/usb/gadget/udc/Kconfig"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
139
140#
141# USB Gadget Drivers
142#
143
144# composite based drivers
145config USB_LIBCOMPOSITE
146	tristate
147	select CONFIGFS_FS
148	depends on USB_GADGET
149
150config USB_F_ACM
151	tristate
152
153config USB_F_SS_LB
154	tristate
155
156config USB_U_SERIAL
157	tristate
158
159config USB_U_ETHER
160	tristate
161
162config USB_U_AUDIO
163	tristate
164
165config USB_F_SERIAL
166	tristate
167
168config USB_F_OBEX
169	tristate
170
171config USB_F_NCM
172	tristate
173
174config USB_F_ECM
175	tristate
176
177config USB_F_PHONET
178	tristate
179
180config USB_F_EEM
181	tristate
182
183config USB_F_SUBSET
184	tristate
185
186config USB_F_RNDIS
187	tristate
188
189config USB_F_MASS_STORAGE
190	tristate
191
192config USB_F_FS
193	tristate
194
195config USB_F_UAC1
196	tristate
197
198config USB_F_UAC1_LEGACY
199	tristate
200
201config USB_F_UAC2
202	tristate
203
204config USB_F_UVC
205	tristate
206	select UVC_COMMON
207
208config USB_F_MIDI
209	tristate
210
211config USB_F_MIDI2
212	tristate
213
214config USB_F_HID
215	tristate
216
217config USB_F_PRINTER
218	tristate
219
220config USB_F_TCM
221	tristate
222
223# this first set of drivers all depend on bulk-capable hardware.
224
225config USB_CONFIGFS
226	tristate "USB Gadget functions configurable through configfs"
227	select USB_LIBCOMPOSITE
228	help
229	  A Linux USB "gadget" can be set up through configfs.
230	  If this is the case, the USB functions (which from the host's
231	  perspective are seen as interfaces) and configurations are
232	  specified simply by creating appropriate directories in configfs.
233	  Associating functions with configurations is done by creating
234	  appropriate symbolic links.
235	  For more information see Documentation/usb/gadget_configfs.rst.
236
237config USB_CONFIGFS_SERIAL
238	bool "Generic serial bulk in/out"
239	depends on USB_CONFIGFS
240	depends on TTY
241	select USB_U_SERIAL
242	select USB_F_SERIAL
243	help
244	  The function talks to the Linux-USB generic serial driver.
245
246config USB_CONFIGFS_ACM
247	bool "Abstract Control Model (CDC ACM)"
248	depends on USB_CONFIGFS
249	depends on TTY
250	select USB_U_SERIAL
251	select USB_F_ACM
252	help
253	  ACM serial link.  This function can be used to interoperate with
254	  MS-Windows hosts or with the Linux-USB "cdc-acm" driver.
255
256config USB_CONFIGFS_OBEX
257	bool "Object Exchange Model (CDC OBEX)"
258	depends on USB_CONFIGFS
259	depends on TTY
260	select USB_U_SERIAL
261	select USB_F_OBEX
262	help
263	  You will need a user space OBEX server talking to /dev/ttyGS*,
264	  since the kernel itself doesn't implement the OBEX protocol.
265
266config USB_CONFIGFS_NCM
267	bool "Network Control Model (CDC NCM)"
268	depends on USB_CONFIGFS
269	depends on NET
270	select USB_U_ETHER
271	select USB_F_NCM
272	select CRC32
273	help
274	  NCM is an advanced protocol for Ethernet encapsulation, allows
275	  grouping of several ethernet frames into one USB transfer and
276	  different alignment possibilities.
277
278config USB_CONFIGFS_ECM
279	bool "Ethernet Control Model (CDC ECM)"
280	depends on USB_CONFIGFS
281	depends on NET
282	select USB_U_ETHER
283	select USB_F_ECM
284	help
285	  The "Communication Device Class" (CDC) Ethernet Control Model.
286	  That protocol is often avoided with pure Ethernet adapters, in
287	  favor of simpler vendor-specific hardware, but is widely
288	  supported by firmware for smart network devices.
289
290config USB_CONFIGFS_ECM_SUBSET
291	bool "Ethernet Control Model (CDC ECM) subset"
292	depends on USB_CONFIGFS
293	depends on NET
294	select USB_U_ETHER
295	select USB_F_SUBSET
296	help
297	  On hardware that can't implement the full protocol,
298	  a simple CDC subset is used, placing fewer demands on USB.
299
300config USB_CONFIGFS_RNDIS
301	bool "RNDIS"
302	depends on USB_CONFIGFS
303	depends on NET
304	select USB_U_ETHER
305	select USB_F_RNDIS
306	help
307	   Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
308	   and Microsoft provides redistributable binary RNDIS drivers for
309	   older versions of Windows.
310
311	   To make MS-Windows work with this, use Documentation/usb/linux.inf
312	   as the "driver info file".  For versions of MS-Windows older than
313	   XP, you'll need to download drivers from Microsoft's website; a URL
314	   is given in comments found in that info file.
315
316config USB_CONFIGFS_EEM
317	bool "Ethernet Emulation Model (EEM)"
318	depends on USB_CONFIGFS
319	depends on NET
320	select USB_U_ETHER
321	select USB_F_EEM
322	select CRC32
323	help
324	  CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
325	  and therefore can be supported by more hardware.  Technically ECM and
326	  EEM are designed for different applications.  The ECM model extends
327	  the network interface to the target (e.g. a USB cable modem), and the
328	  EEM model is for mobile devices to communicate with hosts using
329	  ethernet over USB.  For Linux gadgets, however, the interface with
330	  the host is the same (a usbX device), so the differences are minimal.
331
332config USB_CONFIGFS_PHONET
333	bool "Phonet protocol"
334	depends on USB_CONFIGFS
335	depends on NET
336	depends on PHONET
337	select USB_U_ETHER
338	select USB_F_PHONET
339	help
340	  The Phonet protocol implementation for USB device.
341
342config USB_CONFIGFS_MASS_STORAGE
343	bool "Mass storage"
344	depends on USB_CONFIGFS
345	depends on BLOCK
346	select USB_F_MASS_STORAGE
347	help
348	  The Mass Storage Gadget acts as a USB Mass Storage disk drive.
349	  As its storage repository it can use a regular file or a block
350	  device (in much the same way as the "loop" device driver),
351	  specified as a module parameter or sysfs option.
352
353config USB_CONFIGFS_F_LB_SS
354	bool "Loopback and sourcesink function (for testing)"
355	depends on USB_CONFIGFS
356	select USB_F_SS_LB
357	help
358	  Loopback function loops back a configurable number of transfers.
359	  Sourcesink function either sinks and sources bulk data.
360	  It also implements control requests, for "chapter 9" conformance.
361	  Make this be the first driver you try using on top of any new
362	  USB peripheral controller driver.  Then you can use host-side
363	  test software, like the "usbtest" driver, to put your hardware
364	  and its driver through a basic set of functional tests.
365
366config USB_CONFIGFS_F_FS
367	bool "Function filesystem (FunctionFS)"
368	depends on USB_CONFIGFS
369	select USB_F_FS
370	help
371	  The Function Filesystem (FunctionFS) lets one create USB
372	  composite functions in user space in the same way GadgetFS
373	  lets one create USB gadgets in user space.  This allows creation
374	  of composite gadgets such that some of the functions are
375	  implemented in kernel space (for instance Ethernet, serial or
376	  mass storage) and other are implemented in user space.
377
378config USB_CONFIGFS_F_UAC1
379	bool "Audio Class 1.0"
380	depends on USB_CONFIGFS
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
381	depends on SND
382	select USB_LIBCOMPOSITE
383	select SND_PCM
384	select USB_U_AUDIO
385	select USB_F_UAC1
386	help
387	  This Audio function implements 1 AudioControl interface,
 
388	  1 AudioStreaming Interface each for USB-OUT and USB-IN.
 
 
389	  This driver doesn't expect any real Audio codec to be present
390	  on the device - the audio streams are simply sinked to and
391	  sourced from a virtual ALSA sound card created. The user-space
392	  application may choose to do whatever it wants with the data
393	  received from the USB Host and choose to provide whatever it
394	  wants as audio data to the USB Host.
395
396config USB_CONFIGFS_F_UAC1_LEGACY
397	bool "Audio Class 1.0 (legacy implementation)"
398	depends on USB_CONFIGFS
399	depends on SND
 
 
 
 
 
 
 
 
 
 
400	select USB_LIBCOMPOSITE
401	select SND_PCM
402	select USB_F_UAC1_LEGACY
 
 
403	help
404	  This Audio function implements 1 AudioControl interface,
405	  1 AudioStreaming Interface each for USB-OUT and USB-IN.
406	  This is a legacy driver and requires a real Audio codec
407	  to be present on the device.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
408
409config USB_CONFIGFS_F_UAC2
410	bool "Audio Class 2.0"
411	depends on USB_CONFIGFS
412	depends on SND
 
 
 
 
 
 
 
 
413	select USB_LIBCOMPOSITE
414	select SND_PCM
415	select USB_U_AUDIO
416	select USB_F_UAC2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
417	help
418	  This Audio function is compatible with USB Audio Class
419	  specification 2.0. It implements 1 AudioControl interface,
420	  1 AudioStreaming Interface each for USB-OUT and USB-IN.
421	  This driver doesn't expect any real Audio codec to be present
422	  on the device - the audio streams are simply sinked to and
423	  sourced from a virtual ALSA sound card created. The user-space
424	  application may choose to do whatever it wants with the data
425	  received from the USB Host and choose to provide whatever it
426	  wants as audio data to the USB Host.
 
 
 
 
 
 
 
427
428config USB_CONFIGFS_F_MIDI
429	bool "MIDI function"
430	depends on USB_CONFIGFS
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
431	depends on SND
432	select USB_LIBCOMPOSITE
433	select SND_RAWMIDI
434	select USB_F_MIDI
435	help
436	  The MIDI Function acts as a USB Audio device, with one MIDI
437	  input and one MIDI output. These MIDI jacks appear as
438	  a sound "card" in the ALSA sound system. Other MIDI
439	  connections can then be made on the gadget system, using
440	  ALSA's aconnect utility etc.
441
442config USB_CONFIGFS_F_MIDI2
443	bool "MIDI 2.0 function"
444	depends on USB_CONFIGFS
445	depends on SND
 
446	select USB_LIBCOMPOSITE
447	select SND_UMP
448	select SND_UMP_LEGACY_RAWMIDI
449	select USB_F_MIDI2
450	help
451	  The MIDI 2.0 function driver provides the generic emulated
452	  USB MIDI 2.0 interface, looped back to ALSA UMP rawmidi
453	  device on the gadget host. It supports UMP 1.1 spec and
454	  responds UMP Stream messages for UMP Endpoint and Function
455	  Block information / configuration.
456
457config USB_CONFIGFS_F_HID
458	bool "HID function"
459	depends on USB_CONFIGFS
460	select USB_F_HID
 
 
 
 
 
 
 
 
 
 
 
 
461	help
462	  The HID function driver provides generic emulation of USB
463	  Human Interface Devices (HID).
464
465	  For more information, see Documentation/usb/gadget_hid.rst.
 
 
466
467config USB_CONFIGFS_F_UVC
468	bool "USB Webcam function"
469	depends on USB_CONFIGFS
470	depends on VIDEO_DEV
471	depends on VIDEO_DEV
472	select VIDEOBUF2_DMA_SG
473	select VIDEOBUF2_VMALLOC
474	select USB_F_UVC
 
 
 
 
 
475	help
476	  The Webcam function acts as a composite USB Audio and Video Class
477	  device. It provides a userspace API to process UVC control requests
478	  and stream video data to the host.
479
480config USB_CONFIGFS_F_PRINTER
481	bool "Printer function"
482	select USB_F_PRINTER
483	depends on USB_CONFIGFS
 
 
 
 
 
 
484	help
485	  The Printer function channels data between the USB host and a
486	  userspace program driving the print engine. The user space
487	  program reads and writes the device file /dev/g_printer<X> to
488	  receive or send printer data. It can use ioctl calls to
489	  the device file to get or set printer status.
490
491	  For more information, see Documentation/usb/gadget_printer.rst
492	  which includes sample code for accessing the device file.
493
494config USB_CONFIGFS_F_TCM
495	bool "USB Gadget Target Fabric"
496	depends on TARGET_CORE
497	depends on USB_CONFIGFS
498	select USB_LIBCOMPOSITE
499	select USB_F_TCM
 
 
 
500	help
501	  This fabric is a USB gadget component. Two USB protocols are
502	  supported that is BBB or BOT (Bulk Only Transport) and UAS
503	  (USB Attached SCSI). BOT is advertised on alternative
504	  interface 0 (primary) and UAS is on alternative interface 1.
505	  Both protocols can work on USB2.0 and USB3.0.
506	  UAS utilizes the USB 3.0 feature called streams support.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
507
508source "drivers/usb/gadget/legacy/Kconfig"
509
510endif # USB_GADGET
v3.15
 
   1#
   2# USB Gadget support on a system involves
   3#    (a) a peripheral controller, and
   4#    (b) the gadget driver using it.
   5#
   6# NOTE:  Gadget support ** DOES NOT ** depend on host-side CONFIG_USB !!
   7#
   8#  - Host systems (like PCs) need CONFIG_USB (with "A" jacks).
   9#  - Peripherals (like PDAs) need CONFIG_USB_GADGET (with "B" jacks).
  10#  - Some systems have both kinds of controllers.
  11#
  12# With help from a special transceiver and a "Mini-AB" jack, systems with
  13# both kinds of controller can also support "USB On-the-Go" (CONFIG_USB_OTG).
  14#
  15
  16menuconfig USB_GADGET
  17	tristate "USB Gadget Support"
 
  18	select NLS
  19	help
  20	   USB is a master/slave protocol, organized with one master
  21	   host (such as a PC) controlling up to 127 peripheral devices.
  22	   The USB hardware is asymmetric, which makes it easier to set up:
  23	   you can't connect a "to-the-host" connector to a peripheral.
  24
  25	   Linux can run in the host, or in the peripheral.  In both cases
  26	   you need a low level bus controller driver, and some software
  27	   talking to it.  Peripheral controllers are often discrete silicon,
  28	   or are integrated with the CPU in a microcontroller.  The more
  29	   familiar host side controllers have names like "EHCI", "OHCI",
  30	   or "UHCI", and are usually integrated into southbridges on PC
  31	   motherboards.
  32
  33	   Enable this configuration option if you want to run Linux inside
  34	   a USB peripheral device.  Configure one hardware driver for your
  35	   peripheral/device side bus controller, and a "gadget driver" for
  36	   your peripheral protocol.  (If you use modular gadget drivers,
  37	   you may configure more than one.)
  38
  39	   If in doubt, say "N" and don't enable these drivers; most people
  40	   don't have this kind of hardware (except maybe inside Linux PDAs).
  41
  42	   For more information, see <http://www.linux-usb.org/gadget> and
  43	   the kernel DocBook documentation for this API.
  44
  45if USB_GADGET
  46
  47config USB_GADGET_DEBUG
  48	boolean "Debugging messages (DEVELOPMENT)"
  49	depends on DEBUG_KERNEL
  50	help
  51	   Many controller and gadget drivers will print some debugging
  52	   messages if you use this option to ask for those messages.
  53
  54	   Avoid enabling these messages, even if you're actively
  55	   debugging such a driver.  Many drivers will emit so many
  56	   messages that the driver timings are affected, which will
  57	   either create new failure modes or remove the one you're
  58	   trying to track down.  Never enable these messages for a
  59	   production build.
  60
  61config USB_GADGET_VERBOSE
  62	bool "Verbose debugging Messages (DEVELOPMENT)"
  63	depends on USB_GADGET_DEBUG
  64	help
  65	   Many controller and gadget drivers will print verbose debugging
  66	   messages if you use this option to ask for those messages.
  67
  68	   Avoid enabling these messages, even if you're actively
  69	   debugging such a driver.  Many drivers will emit so many
  70	   messages that the driver timings are affected, which will
  71	   either create new failure modes or remove the one you're
  72	   trying to track down.  Never enable these messages for a
  73	   production build.
  74
  75config USB_GADGET_DEBUG_FILES
  76	boolean "Debugging information files (DEVELOPMENT)"
  77	depends on PROC_FS
  78	help
  79	   Some of the drivers in the "gadget" framework can expose
  80	   debugging information in files such as /proc/driver/udc
  81	   (for a peripheral controller).  The information in these
  82	   files may help when you're troubleshooting or bringing up a
  83	   driver on a new board.   Enable these files by choosing "Y"
  84	   here.  If in doubt, or to conserve kernel memory, say "N".
  85
  86config USB_GADGET_DEBUG_FS
  87	boolean "Debugging information files in debugfs (DEVELOPMENT)"
  88	depends on DEBUG_FS
  89	help
  90	   Some of the drivers in the "gadget" framework can expose
  91	   debugging information in files under /sys/kernel/debug/.
  92	   The information in these files may help when you're
  93	   troubleshooting or bringing up a driver on a new board.
  94	   Enable these files by choosing "Y" here.  If in doubt, or
  95	   to conserve kernel memory, say "N".
  96
  97config USB_GADGET_VBUS_DRAW
  98	int "Maximum VBUS Power usage (2-500 mA)"
  99	range 2 500
 100	default 2
 101	help
 102	   Some devices need to draw power from USB when they are
 103	   configured, perhaps to operate circuitry or to recharge
 104	   batteries.  This is in addition to any local power supply,
 105	   such as an AC adapter or batteries.
 106
 107	   Enter the maximum power your device draws through USB, in
 108	   milliAmperes.  The permitted range of values is 2 - 500 mA;
 109	   0 mA would be legal, but can make some hosts misbehave.
 110
 111	   This value will be used except for system-specific gadget
 112	   drivers that have more specific information.
 113
 114config USB_GADGET_STORAGE_NUM_BUFFERS
 115	int "Number of storage pipeline buffers"
 116	range 2 4
 117	default 2
 118	help
 119	   Usually 2 buffers are enough to establish a good buffering
 120	   pipeline. The number may be increased in order to compensate
 121	   for a bursty VFS behaviour. For instance there may be CPU wake up
 122	   latencies that makes the VFS to appear bursty in a system with
 123	   an CPU on-demand governor. Especially if DMA is doing IO to
 124	   offload the CPU. In this case the CPU will go into power
 125	   save often and spin up occasionally to move data within VFS.
 126	   If selecting USB_GADGET_DEBUG_FILES this value may be set by
 127	   a module parameter as well.
 128	   If unsure, say 2.
 129
 130#
 131# USB Peripheral Controller Support
 132#
 133# The order here is alphabetical, except that integrated controllers go
 134# before discrete ones so they will be the initial/default value:
 135#   - integrated/SOC controllers first
 136#   - licensed IP used in both SOC and discrete versions
 137#   - discrete ones (including all PCI-only controllers)
 138#   - debug/dummy gadget+hcd is last.
 139#
 140menu "USB Peripheral Controller"
 141
 142#
 143# Integrated controllers
 144#
 145
 146config USB_AT91
 147	tristate "Atmel AT91 USB Device Port"
 148	depends on ARCH_AT91
 149	help
 150	   Many Atmel AT91 processors (such as the AT91RM2000) have a
 151	   full speed USB Device Port with support for five configurable
 152	   endpoints (plus endpoint zero).
 153
 154	   Say "y" to link the driver statically, or "m" to build a
 155	   dynamically linked module called "at91_udc" and force all
 156	   gadget drivers to also be dynamically linked.
 157
 158config USB_LPC32XX
 159	tristate "LPC32XX USB Peripheral Controller"
 160	depends on ARCH_LPC32XX
 161	select USB_ISP1301
 162	help
 163	   This option selects the USB device controller in the LPC32xx SoC.
 164
 165	   Say "y" to link the driver statically, or "m" to build a
 166	   dynamically linked module called "lpc32xx_udc" and force all
 167	   gadget drivers to also be dynamically linked.
 168
 169config USB_ATMEL_USBA
 170	tristate "Atmel USBA"
 171	depends on AVR32 || ARCH_AT91
 172	help
 173	  USBA is the integrated high-speed USB Device controller on
 174	  the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
 175
 176config USB_BCM63XX_UDC
 177	tristate "Broadcom BCM63xx Peripheral Controller"
 178	depends on BCM63XX
 179	help
 180	   Many Broadcom BCM63xx chipsets (such as the BCM6328) have a
 181	   high speed USB Device Port with support for four fixed endpoints
 182	   (plus endpoint zero).
 183
 184	   Say "y" to link the driver statically, or "m" to build a
 185	   dynamically linked module called "bcm63xx_udc".
 186
 187config USB_FSL_USB2
 188	tristate "Freescale Highspeed USB DR Peripheral Controller"
 189	depends on FSL_SOC || ARCH_MXC
 190	select USB_FSL_MPH_DR_OF if OF
 191	help
 192	   Some of Freescale PowerPC and i.MX processors have a High Speed
 193	   Dual-Role(DR) USB controller, which supports device mode.
 194
 195	   The number of programmable endpoints is different through
 196	   SOC revisions.
 197
 198	   Say "y" to link the driver statically, or "m" to build a
 199	   dynamically linked module called "fsl_usb2_udc" and force
 200	   all gadget drivers to also be dynamically linked.
 201
 202config USB_FUSB300
 203	tristate "Faraday FUSB300 USB Peripheral Controller"
 204	depends on !PHYS_ADDR_T_64BIT && HAS_DMA
 205	help
 206	   Faraday usb device controller FUSB300 driver
 207
 208config USB_FOTG210_UDC
 209	depends on HAS_DMA
 210	tristate "Faraday FOTG210 USB Peripheral Controller"
 211	help
 212	   Faraday USB2.0 OTG controller which can be configured as
 213	   high speed or full speed USB device. This driver supppors
 214	   Bulk Transfer so far.
 215
 216	   Say "y" to link the driver statically, or "m" to build a
 217	   dynamically linked module called "fotg210_udc".
 218
 219config USB_GR_UDC
 220       tristate "Aeroflex Gaisler GRUSBDC USB Peripheral Controller Driver"
 221       depends on HAS_DMA
 222       help
 223          Select this to support Aeroflex Gaisler GRUSBDC cores from the GRLIB
 224	  VHDL IP core library.
 225
 226config USB_OMAP
 227	tristate "OMAP USB Device Controller"
 228	depends on ARCH_OMAP1
 229	select ISP1301_OMAP if MACH_OMAP_H2 || MACH_OMAP_H3
 230	help
 231	   Many Texas Instruments OMAP processors have flexible full
 232	   speed USB device controllers, with support for up to 30
 233	   endpoints (plus endpoint zero).  This driver supports the
 234	   controller in the OMAP 1611, and should work with controllers
 235	   in other OMAP processors too, given minor tweaks.
 236
 237	   Say "y" to link the driver statically, or "m" to build a
 238	   dynamically linked module called "omap_udc" and force all
 239	   gadget drivers to also be dynamically linked.
 240
 241config USB_PXA25X
 242	tristate "PXA 25x or IXP 4xx"
 243	depends on (ARCH_PXA && PXA25x) || ARCH_IXP4XX
 244	help
 245	   Intel's PXA 25x series XScale ARM-5TE processors include
 246	   an integrated full speed USB 1.1 device controller.  The
 247	   controller in the IXP 4xx series is register-compatible.
 248
 249	   It has fifteen fixed-function endpoints, as well as endpoint
 250	   zero (for control transfers).
 251
 252	   Say "y" to link the driver statically, or "m" to build a
 253	   dynamically linked module called "pxa25x_udc" and force all
 254	   gadget drivers to also be dynamically linked.
 255
 256# if there's only one gadget driver, using only two bulk endpoints,
 257# don't waste memory for the other endpoints
 258config USB_PXA25X_SMALL
 259	depends on USB_PXA25X
 260	bool
 261	default n if USB_ETH_RNDIS
 262	default y if USB_ZERO
 263	default y if USB_ETH
 264	default y if USB_G_SERIAL
 265
 266config USB_R8A66597
 267	tristate "Renesas R8A66597 USB Peripheral Controller"
 268	depends on HAS_DMA
 269	help
 270	   R8A66597 is a discrete USB host and peripheral controller chip that
 271	   supports both full and high speed USB 2.0 data transfers.
 272	   It has nine configurable endpoints, and endpoint zero.
 273
 274	   Say "y" to link the driver statically, or "m" to build a
 275	   dynamically linked module called "r8a66597_udc" and force all
 276	   gadget drivers to also be dynamically linked.
 277
 278config USB_RENESAS_USBHS_UDC
 279	tristate 'Renesas USBHS controller'
 280	depends on USB_RENESAS_USBHS
 281	help
 282	   Renesas USBHS is a discrete USB host and peripheral controller chip
 283	   that supports both full and high speed USB 2.0 data transfers.
 284	   It has nine or more configurable endpoints, and endpoint zero.
 285
 286	   Say "y" to link the driver statically, or "m" to build a
 287	   dynamically linked module called "renesas_usbhs" and force all
 288	   gadget drivers to also be dynamically linked.
 289
 290config USB_PXA27X
 291	tristate "PXA 27x"
 292	help
 293	   Intel's PXA 27x series XScale ARM v5TE processors include
 294	   an integrated full speed USB 1.1 device controller.
 295
 296	   It has up to 23 endpoints, as well as endpoint zero (for
 297	   control transfers).
 298
 299	   Say "y" to link the driver statically, or "m" to build a
 300	   dynamically linked module called "pxa27x_udc" and force all
 301	   gadget drivers to also be dynamically linked.
 302
 303config USB_S3C_HSOTG
 304	tristate "Designware/S3C HS/OtG USB Device controller"
 305	help
 306	  The Designware USB2.0 high-speed gadget controller
 307	  integrated into many SoCs.
 308
 309config USB_S3C2410
 310	tristate "S3C2410 USB Device Controller"
 311	depends on ARCH_S3C24XX
 312	help
 313	  Samsung's S3C2410 is an ARM-4 processor with an integrated
 314	  full speed USB 1.1 device controller.  It has 4 configurable
 315	  endpoints, as well as endpoint zero (for control transfers).
 316
 317	  This driver has been tested on the S3C2410, S3C2412, and
 318	  S3C2440 processors.
 319
 320config USB_S3C2410_DEBUG
 321	boolean "S3C2410 udc debug messages"
 322	depends on USB_S3C2410
 323
 324config USB_S3C_HSUDC
 325	tristate "S3C2416, S3C2443 and S3C2450 USB Device Controller"
 326	depends on ARCH_S3C24XX
 327	help
 328	  Samsung's S3C2416, S3C2443 and S3C2450 is an ARM9 based SoC
 329	  integrated with dual speed USB 2.0 device controller. It has
 330	  8 endpoints, as well as endpoint zero.
 331
 332	  This driver has been tested on S3C2416 and S3C2450 processors.
 333
 334config USB_MV_UDC
 335	tristate "Marvell USB2.0 Device Controller"
 336	depends on HAS_DMA
 337	help
 338	  Marvell Socs (including PXA and MMP series) include a high speed
 339	  USB2.0 OTG controller, which can be configured as high speed or
 340	  full speed USB peripheral.
 341
 342config USB_MV_U3D
 343	depends on HAS_DMA
 344	tristate "MARVELL PXA2128 USB 3.0 controller"
 345	help
 346	  MARVELL PXA2128 Processor series include a super speed USB3.0 device
 347	  controller, which support super speed USB peripheral.
 348
 349#
 350# Controllers available in both integrated and discrete versions
 351#
 352
 353config USB_M66592
 354	tristate "Renesas M66592 USB Peripheral Controller"
 355	help
 356	   M66592 is a discrete USB peripheral controller chip that
 357	   supports both full and high speed USB 2.0 data transfers.
 358	   It has seven configurable endpoints, and endpoint zero.
 359
 360	   Say "y" to link the driver statically, or "m" to build a
 361	   dynamically linked module called "m66592_udc" and force all
 362	   gadget drivers to also be dynamically linked.
 363
 364#
 365# Controllers available only in discrete form (and all PCI controllers)
 366#
 367
 368config USB_AMD5536UDC
 369	tristate "AMD5536 UDC"
 370	depends on PCI
 371	help
 372	   The AMD5536 UDC is part of the AMD Geode CS5536, an x86 southbridge.
 373	   It is a USB Highspeed DMA capable USB device controller. Beside ep0
 374	   it provides 4 IN and 4 OUT endpoints (bulk or interrupt type).
 375	   The UDC port supports OTG operation, and may be used as a host port
 376	   if it's not being used to implement peripheral or OTG roles.
 377
 378	   Say "y" to link the driver statically, or "m" to build a
 379	   dynamically linked module called "amd5536udc" and force all
 380	   gadget drivers to also be dynamically linked.
 381
 382config USB_FSL_QE
 383	tristate "Freescale QE/CPM USB Device Controller"
 384	depends on FSL_SOC && (QUICC_ENGINE || CPM)
 385	help
 386	   Some of Freescale PowerPC processors have a Full Speed
 387	   QE/CPM2 USB controller, which support device mode with 4
 388	   programmable endpoints. This driver supports the
 389	   controller in the MPC8360 and MPC8272, and should work with
 390	   controllers having QE or CPM2, given minor tweaks.
 391
 392	   Set CONFIG_USB_GADGET to "m" to build this driver as a
 393	   dynamically linked module called "fsl_qe_udc".
 394
 395config USB_NET2272
 396	tristate "PLX NET2272"
 397	help
 398	  PLX NET2272 is a USB peripheral controller which supports
 399	  both full and high speed USB 2.0 data transfers.
 400
 401	  It has three configurable endpoints, as well as endpoint zero
 402	  (for control transfer).
 403	  Say "y" to link the driver statically, or "m" to build a
 404	  dynamically linked module called "net2272" and force all
 405	  gadget drivers to also be dynamically linked.
 406
 407config USB_NET2272_DMA
 408	boolean "Support external DMA controller"
 409	depends on USB_NET2272 && HAS_DMA
 410	help
 411	  The NET2272 part can optionally support an external DMA
 412	  controller, but your board has to have support in the
 413	  driver itself.
 414
 415	  If unsure, say "N" here.  The driver works fine in PIO mode.
 416
 417config USB_NET2280
 418	tristate "NetChip 228x"
 419	depends on PCI
 420	help
 421	   NetChip 2280 / 2282 is a PCI based USB peripheral controller which
 422	   supports both full and high speed USB 2.0 data transfers.
 423
 424	   It has six configurable endpoints, as well as endpoint zero
 425	   (for control transfers) and several endpoints with dedicated
 426	   functions.
 427
 428	   Say "y" to link the driver statically, or "m" to build a
 429	   dynamically linked module called "net2280" and force all
 430	   gadget drivers to also be dynamically linked.
 431
 432config USB_GOKU
 433	tristate "Toshiba TC86C001 'Goku-S'"
 434	depends on PCI
 435	help
 436	   The Toshiba TC86C001 is a PCI device which includes controllers
 437	   for full speed USB devices, IDE, I2C, SIO, plus a USB host (OHCI).
 438
 439	   The device controller has three configurable (bulk or interrupt)
 440	   endpoints, plus endpoint zero (for control transfers).
 441
 442	   Say "y" to link the driver statically, or "m" to build a
 443	   dynamically linked module called "goku_udc" and to force all
 444	   gadget drivers to also be dynamically linked.
 445
 446config USB_EG20T
 447	tristate "Intel EG20T PCH/LAPIS Semiconductor IOH(ML7213/ML7831) UDC"
 448	depends on PCI
 449	help
 450	  This is a USB device driver for EG20T PCH.
 451	  EG20T PCH is the platform controller hub that is used in Intel's
 452	  general embedded platform. EG20T PCH has USB device interface.
 453	  Using this interface, it is able to access system devices connected
 454	  to USB device.
 455	  This driver enables USB device function.
 456	  USB device is a USB peripheral controller which
 457	  supports both full and high speed USB 2.0 data transfers.
 458	  This driver supports both control transfer and bulk transfer modes.
 459	  This driver dose not support interrupt transfer or isochronous
 460	  transfer modes.
 461
 462	  This driver also can be used for LAPIS Semiconductor's ML7213 which is
 463	  for IVI(In-Vehicle Infotainment) use.
 464	  ML7831 is for general purpose use.
 465	  ML7213/ML7831 is companion chip for Intel Atom E6xx series.
 466	  ML7213/ML7831 is completely compatible for Intel EG20T PCH.
 467
 468#
 469# LAST -- dummy/emulated controller
 470#
 471
 472config USB_DUMMY_HCD
 473	tristate "Dummy HCD (DEVELOPMENT)"
 474	depends on USB=y || (USB=m && USB_GADGET=m)
 475	help
 476	  This host controller driver emulates USB, looping all data transfer
 477	  requests back to a USB "gadget driver" in the same host.  The host
 478	  side is the master; the gadget side is the slave.  Gadget drivers
 479	  can be high, full, or low speed; and they have access to endpoints
 480	  like those from NET2280, PXA2xx, or SA1100 hardware.
 481
 482	  This may help in some stages of creating a driver to embed in a
 483	  Linux device, since it lets you debug several parts of the gadget
 484	  driver without its hardware or drivers being involved.
 485
 486	  Since such a gadget side driver needs to interoperate with a host
 487	  side Linux-USB device driver, this may help to debug both sides
 488	  of a USB protocol stack.
 489
 490	  Say "y" to link the driver statically, or "m" to build a
 491	  dynamically linked module called "dummy_hcd" and force all
 492	  gadget drivers to also be dynamically linked.
 493
 494# NOTE:  Please keep dummy_hcd LAST so that "real hardware" appears
 495# first and will be selected by default.
 496
 497endmenu
 498
 499#
 500# USB Gadget Drivers
 501#
 502
 503# composite based drivers
 504config USB_LIBCOMPOSITE
 505	tristate
 506	select CONFIGFS_FS
 507	depends on USB_GADGET
 508
 509config USB_F_ACM
 510	tristate
 511
 512config USB_F_SS_LB
 513	tristate
 514
 515config USB_U_SERIAL
 516	tristate
 517
 518config USB_U_ETHER
 519	tristate
 520
 
 
 
 521config USB_F_SERIAL
 522	tristate
 523
 524config USB_F_OBEX
 525	tristate
 526
 527config USB_F_NCM
 528	tristate
 529
 530config USB_F_ECM
 531	tristate
 532
 533config USB_F_PHONET
 534	tristate
 535
 536config USB_F_EEM
 537	tristate
 538
 539config USB_F_SUBSET
 540	tristate
 541
 542config USB_F_RNDIS
 543	tristate
 544
 545config USB_F_MASS_STORAGE
 546	tristate
 547
 548config USB_F_FS
 549	tristate
 550
 551choice
 552	tristate "USB Gadget Drivers"
 553	default USB_ETH
 554	help
 555	  A Linux "Gadget Driver" talks to the USB Peripheral Controller
 556	  driver through the abstract "gadget" API.  Some other operating
 557	  systems call these "client" drivers, of which "class drivers"
 558	  are a subset (implementing a USB device class specification).
 559	  A gadget driver implements one or more USB functions using
 560	  the peripheral hardware.
 561
 562	  Gadget drivers are hardware-neutral, or "platform independent",
 563	  except that they sometimes must understand quirks or limitations
 564	  of the particular controllers they work with.  For example, when
 565	  a controller doesn't support alternate configurations or provide
 566	  enough of the right types of endpoints, the gadget driver might
 567	  not be able work with that controller, or might need to implement
 568	  a less common variant of a device class protocol.
 
 
 
 
 
 
 
 
 
 569
 570# this first set of drivers all depend on bulk-capable hardware.
 571
 572config USB_CONFIGFS
 573	tristate "USB functions configurable through configfs"
 574	select USB_LIBCOMPOSITE
 575	help
 576	  A Linux USB "gadget" can be set up through configfs.
 577	  If this is the case, the USB functions (which from the host's
 578	  perspective are seen as interfaces) and configurations are
 579	  specified simply by creating appropriate directories in configfs.
 580	  Associating functions with configurations is done by creating
 581	  appropriate symbolic links.
 582	  For more information see Documentation/usb/gadget_configfs.txt.
 583
 584config USB_CONFIGFS_SERIAL
 585	boolean "Generic serial bulk in/out"
 586	depends on USB_CONFIGFS
 587	depends on TTY
 588	select USB_U_SERIAL
 589	select USB_F_SERIAL
 590	help
 591	  The function talks to the Linux-USB generic serial driver.
 592
 593config USB_CONFIGFS_ACM
 594	boolean "Abstract Control Model (CDC ACM)"
 595	depends on USB_CONFIGFS
 596	depends on TTY
 597	select USB_U_SERIAL
 598	select USB_F_ACM
 599	help
 600	  ACM serial link.  This function can be used to interoperate with
 601	  MS-Windows hosts or with the Linux-USB "cdc-acm" driver.
 602
 603config USB_CONFIGFS_OBEX
 604	boolean "Object Exchange Model (CDC OBEX)"
 605	depends on USB_CONFIGFS
 606	depends on TTY
 607	select USB_U_SERIAL
 608	select USB_F_OBEX
 609	help
 610	  You will need a user space OBEX server talking to /dev/ttyGS*,
 611	  since the kernel itself doesn't implement the OBEX protocol.
 612
 613config USB_CONFIGFS_NCM
 614	boolean "Network Control Model (CDC NCM)"
 615	depends on USB_CONFIGFS
 616	depends on NET
 617	select USB_U_ETHER
 618	select USB_F_NCM
 
 619	help
 620	  NCM is an advanced protocol for Ethernet encapsulation, allows
 621	  grouping of several ethernet frames into one USB transfer and
 622	  different alignment possibilities.
 623
 624config USB_CONFIGFS_ECM
 625	boolean "Ethernet Control Model (CDC ECM)"
 626	depends on USB_CONFIGFS
 627	depends on NET
 628	select USB_U_ETHER
 629	select USB_F_ECM
 630	help
 631	  The "Communication Device Class" (CDC) Ethernet Control Model.
 632	  That protocol is often avoided with pure Ethernet adapters, in
 633	  favor of simpler vendor-specific hardware, but is widely
 634	  supported by firmware for smart network devices.
 635
 636config USB_CONFIGFS_ECM_SUBSET
 637	boolean "Ethernet Control Model (CDC ECM) subset"
 638	depends on USB_CONFIGFS
 639	depends on NET
 640	select USB_U_ETHER
 641	select USB_F_SUBSET
 642	help
 643	  On hardware that can't implement the full protocol,
 644	  a simple CDC subset is used, placing fewer demands on USB.
 645
 646config USB_CONFIGFS_RNDIS
 647	bool "RNDIS"
 648	depends on USB_CONFIGFS
 649	depends on NET
 650	select USB_U_ETHER
 651	select USB_F_RNDIS
 652	help
 653	   Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
 654	   and Microsoft provides redistributable binary RNDIS drivers for
 655	   older versions of Windows.
 656
 657	   To make MS-Windows work with this, use Documentation/usb/linux.inf
 658	   as the "driver info file".  For versions of MS-Windows older than
 659	   XP, you'll need to download drivers from Microsoft's website; a URL
 660	   is given in comments found in that info file.
 661
 662config USB_CONFIGFS_EEM
 663	bool "Ethernet Emulation Model (EEM)"
 664	depends on USB_CONFIGFS
 665	depends on NET
 666	select USB_U_ETHER
 667	select USB_F_EEM
 
 668	help
 669	  CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
 670	  and therefore can be supported by more hardware.  Technically ECM and
 671	  EEM are designed for different applications.  The ECM model extends
 672	  the network interface to the target (e.g. a USB cable modem), and the
 673	  EEM model is for mobile devices to communicate with hosts using
 674	  ethernet over USB.  For Linux gadgets, however, the interface with
 675	  the host is the same (a usbX device), so the differences are minimal.
 676
 677config USB_CONFIGFS_PHONET
 678	boolean "Phonet protocol"
 679	depends on USB_CONFIGFS
 680	depends on NET
 681	depends on PHONET
 682	select USB_U_ETHER
 683	select USB_F_PHONET
 684	help
 685	  The Phonet protocol implementation for USB device.
 686
 687config USB_CONFIGFS_MASS_STORAGE
 688	boolean "Mass storage"
 689	depends on USB_CONFIGFS
 690	depends on BLOCK
 691	select USB_F_MASS_STORAGE
 692	help
 693	  The Mass Storage Gadget acts as a USB Mass Storage disk drive.
 694	  As its storage repository it can use a regular file or a block
 695	  device (in much the same way as the "loop" device driver),
 696	  specified as a module parameter or sysfs option.
 697
 698config USB_CONFIGFS_F_LB_SS
 699	boolean "Loopback and sourcesink function (for testing)"
 700	depends on USB_CONFIGFS
 701	select USB_F_SS_LB
 702	help
 703	  Loopback function loops back a configurable number of transfers.
 704	  Sourcesink function either sinks and sources bulk data.
 705	  It also implements control requests, for "chapter 9" conformance.
 706	  Make this be the first driver you try using on top of any new
 707	  USB peripheral controller driver.  Then you can use host-side
 708	  test software, like the "usbtest" driver, to put your hardware
 709	  and its driver through a basic set of functional tests.
 710
 711config USB_CONFIGFS_F_FS
 712	boolean "Function filesystem (FunctionFS)"
 713	depends on USB_CONFIGFS
 714	select USB_F_FS
 715	help
 716	  The Function Filesystem (FunctionFS) lets one create USB
 717	  composite functions in user space in the same way GadgetFS
 718	  lets one create USB gadgets in user space.  This allows creation
 719	  of composite gadgets such that some of the functions are
 720	  implemented in kernel space (for instance Ethernet, serial or
 721	  mass storage) and other are implemented in user space.
 722
 723config USB_ZERO
 724	tristate "Gadget Zero (DEVELOPMENT)"
 725	select USB_LIBCOMPOSITE
 726	select USB_F_SS_LB
 727	help
 728	  Gadget Zero is a two-configuration device.  It either sinks and
 729	  sources bulk data; or it loops back a configurable number of
 730	  transfers.  It also implements control requests, for "chapter 9"
 731	  conformance.  The driver needs only two bulk-capable endpoints, so
 732	  it can work on top of most device-side usb controllers.  It's
 733	  useful for testing, and is also a working example showing how
 734	  USB "gadget drivers" can be written.
 735
 736	  Make this be the first driver you try using on top of any new
 737	  USB peripheral controller driver.  Then you can use host-side
 738	  test software, like the "usbtest" driver, to put your hardware
 739	  and its driver through a basic set of functional tests.
 740
 741	  Gadget Zero also works with the host-side "usb-skeleton" driver,
 742	  and with many kinds of host-side test software.  You may need
 743	  to tweak product and vendor IDs before host software knows about
 744	  this device, and arrange to select an appropriate configuration.
 745
 746	  Say "y" to link the driver statically, or "m" to build a
 747	  dynamically linked module called "g_zero".
 748
 749config USB_ZERO_HNPTEST
 750	boolean "HNP Test Device"
 751	depends on USB_ZERO && USB_OTG
 752	help
 753	  You can configure this device to enumerate using the device
 754	  identifiers of the USB-OTG test device.  That means that when
 755	  this gadget connects to another OTG device, with this one using
 756	  the "B-Peripheral" role, that device will use HNP to let this
 757	  one serve as the USB host instead (in the "B-Host" role).
 758
 759config USB_AUDIO
 760	tristate "Audio Gadget"
 761	depends on SND
 762	select USB_LIBCOMPOSITE
 763	select SND_PCM
 
 
 764	help
 765	  This Gadget Audio driver is compatible with USB Audio Class
 766	  specification 2.0. It implements 1 AudioControl interface,
 767	  1 AudioStreaming Interface each for USB-OUT and USB-IN.
 768	  Number of channels, sample rate and sample size can be
 769	  specified as module parameters.
 770	  This driver doesn't expect any real Audio codec to be present
 771	  on the device - the audio streams are simply sinked to and
 772	  sourced from a virtual ALSA sound card created. The user-space
 773	  application may choose to do whatever it wants with the data
 774	  received from the USB Host and choose to provide whatever it
 775	  wants as audio data to the USB Host.
 776
 777	  Say "y" to link the driver statically, or "m" to build a
 778	  dynamically linked module called "g_audio".
 779
 780config GADGET_UAC1
 781	bool "UAC 1.0 (Legacy)"
 782	depends on USB_AUDIO
 783	help
 784	  If you instead want older UAC Spec-1.0 driver that also has audio
 785	  paths hardwired to the Audio codec chip on-board and doesn't work
 786	  without one.
 787
 788config USB_ETH
 789	tristate "Ethernet Gadget (with CDC Ethernet support)"
 790	depends on NET
 791	select USB_LIBCOMPOSITE
 792	select USB_U_ETHER
 793	select USB_F_ECM
 794	select USB_F_SUBSET
 795	select CRC32
 796	help
 797	  This driver implements Ethernet style communication, in one of
 798	  several ways:
 799	  
 800	   - The "Communication Device Class" (CDC) Ethernet Control Model.
 801	     That protocol is often avoided with pure Ethernet adapters, in
 802	     favor of simpler vendor-specific hardware, but is widely
 803	     supported by firmware for smart network devices.
 804
 805	   - On hardware can't implement that protocol, a simple CDC subset
 806	     is used, placing fewer demands on USB.
 807
 808	   - CDC Ethernet Emulation Model (EEM) is a newer standard that has
 809	     a simpler interface that can be used by more USB hardware.
 810
 811	  RNDIS support is an additional option, more demanding than than
 812	  subset.
 813
 814	  Within the USB device, this gadget driver exposes a network device
 815	  "usbX", where X depends on what other networking devices you have.
 816	  Treat it like a two-node Ethernet link:  host, and gadget.
 817
 818	  The Linux-USB host-side "usbnet" driver interoperates with this
 819	  driver, so that deep I/O queues can be supported.  On 2.4 kernels,
 820	  use "CDCEther" instead, if you're using the CDC option. That CDC
 821	  mode should also interoperate with standard CDC Ethernet class
 822	  drivers on other host operating systems.
 823
 824	  Say "y" to link the driver statically, or "m" to build a
 825	  dynamically linked module called "g_ether".
 826
 827config USB_ETH_RNDIS
 828	bool "RNDIS support"
 829	depends on USB_ETH
 830	select USB_LIBCOMPOSITE
 831	select USB_F_RNDIS
 832	default y
 833	help
 834	   Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
 835	   and Microsoft provides redistributable binary RNDIS drivers for
 836	   older versions of Windows.
 837
 838	   If you say "y" here, the Ethernet gadget driver will try to provide
 839	   a second device configuration, supporting RNDIS to talk to such
 840	   Microsoft USB hosts.
 841	   
 842	   To make MS-Windows work with this, use Documentation/usb/linux.inf
 843	   as the "driver info file".  For versions of MS-Windows older than
 844	   XP, you'll need to download drivers from Microsoft's website; a URL
 845	   is given in comments found in that info file.
 846
 847config USB_ETH_EEM
 848       bool "Ethernet Emulation Model (EEM) support"
 849       depends on USB_ETH
 850	select USB_LIBCOMPOSITE
 851	select USB_F_EEM
 852       default n
 853       help
 854         CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
 855         and therefore can be supported by more hardware.  Technically ECM and
 856         EEM are designed for different applications.  The ECM model extends
 857         the network interface to the target (e.g. a USB cable modem), and the
 858         EEM model is for mobile devices to communicate with hosts using
 859         ethernet over USB.  For Linux gadgets, however, the interface with
 860         the host is the same (a usbX device), so the differences are minimal.
 861
 862         If you say "y" here, the Ethernet gadget driver will use the EEM
 863         protocol rather than ECM.  If unsure, say "n".
 864
 865config USB_G_NCM
 866	tristate "Network Control Model (NCM) support"
 867	depends on NET
 868	select USB_LIBCOMPOSITE
 869	select USB_U_ETHER
 870	select USB_F_NCM
 871	select CRC32
 872	help
 873	  This driver implements USB CDC NCM subclass standard. NCM is
 874	  an advanced protocol for Ethernet encapsulation, allows grouping
 875	  of several ethernet frames into one USB transfer and different
 876	  alignment possibilities.
 877
 878	  Say "y" to link the driver statically, or "m" to build a
 879	  dynamically linked module called "g_ncm".
 880
 881config USB_GADGETFS
 882	tristate "Gadget Filesystem"
 883	help
 884	  This driver provides a filesystem based API that lets user mode
 885	  programs implement a single-configuration USB device, including
 886	  endpoint I/O and control requests that don't relate to enumeration.
 887	  All endpoints, transfer speeds, and transfer types supported by
 888	  the hardware are available, through read() and write() calls.
 889
 890	  Say "y" to link the driver statically, or "m" to build a
 891	  dynamically linked module called "gadgetfs".
 892
 893config USB_FUNCTIONFS
 894	tristate "Function Filesystem"
 895	select USB_LIBCOMPOSITE
 896	select USB_F_FS
 897	select USB_FUNCTIONFS_GENERIC if !(USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
 898	help
 899	  The Function Filesystem (FunctionFS) lets one create USB
 900	  composite functions in user space in the same way GadgetFS
 901	  lets one create USB gadgets in user space.  This allows creation
 902	  of composite gadgets such that some of the functions are
 903	  implemented in kernel space (for instance Ethernet, serial or
 904	  mass storage) and other are implemented in user space.
 905
 906	  If you say "y" or "m" here you will be able what kind of
 907	  configurations the gadget will provide.
 908
 909	  Say "y" to link the driver statically, or "m" to build
 910	  a dynamically linked module called "g_ffs".
 911
 912config USB_FUNCTIONFS_ETH
 913	bool "Include configuration with CDC ECM (Ethernet)"
 914	depends on USB_FUNCTIONFS && NET
 915	select USB_U_ETHER
 916	select USB_F_ECM
 917	select USB_F_SUBSET
 918	help
 919	  Include a configuration with CDC ECM function (Ethernet) and the
 920	  Function Filesystem.
 921
 922config USB_FUNCTIONFS_RNDIS
 923	bool "Include configuration with RNDIS (Ethernet)"
 924	depends on USB_FUNCTIONFS && NET
 925	select USB_U_ETHER
 926	select USB_F_RNDIS
 927	help
 928	  Include a configuration with RNDIS function (Ethernet) and the Filesystem.
 929
 930config USB_FUNCTIONFS_GENERIC
 931	bool "Include 'pure' configuration"
 932	depends on USB_FUNCTIONFS
 933	help
 934	  Include a configuration with the Function Filesystem alone with
 935	  no Ethernet interface.
 936
 937config USB_MASS_STORAGE
 938	tristate "Mass Storage Gadget"
 939	depends on BLOCK
 940	select USB_LIBCOMPOSITE
 941	select USB_F_MASS_STORAGE
 942	help
 943	  The Mass Storage Gadget acts as a USB Mass Storage disk drive.
 944	  As its storage repository it can use a regular file or a block
 945	  device (in much the same way as the "loop" device driver),
 946	  specified as a module parameter or sysfs option.
 947
 948	  This driver is a replacement for now removed File-backed
 949	  Storage Gadget (g_file_storage).
 950
 951	  Say "y" to link the driver statically, or "m" to build
 952	  a dynamically linked module called "g_mass_storage".
 953
 954config USB_GADGET_TARGET
 955	tristate "USB Gadget Target Fabric Module"
 956	depends on TARGET_CORE
 957	select USB_LIBCOMPOSITE
 958	help
 959	  This fabric is an USB gadget. Two USB protocols are supported that is
 960	  BBB or BOT (Bulk Only Transport) and UAS (USB Attached SCSI). BOT is
 961	  advertised on alternative interface 0 (primary) and UAS is on
 962	  alternative interface 1. Both protocols can work on USB2.0 and USB3.0.
 963	  UAS utilizes the USB 3.0 feature called streams support.
 964
 965config USB_G_SERIAL
 966	tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
 967	depends on TTY
 968	select USB_U_SERIAL
 969	select USB_F_ACM
 970	select USB_F_SERIAL
 971	select USB_F_OBEX
 972	select USB_LIBCOMPOSITE
 973	help
 974	  The Serial Gadget talks to the Linux-USB generic serial driver.
 975	  This driver supports a CDC-ACM module option, which can be used
 976	  to interoperate with MS-Windows hosts or with the Linux-USB
 977	  "cdc-acm" driver.
 978
 979	  This driver also supports a CDC-OBEX option.  You will need a
 980	  user space OBEX server talking to /dev/ttyGS*, since the kernel
 981	  itself doesn't implement the OBEX protocol.
 982
 983	  Say "y" to link the driver statically, or "m" to build a
 984	  dynamically linked module called "g_serial".
 985
 986	  For more information, see Documentation/usb/gadget_serial.txt
 987	  which includes instructions and a "driver info file" needed to
 988	  make MS-Windows work with CDC ACM.
 989
 990config USB_MIDI_GADGET
 991	tristate "MIDI Gadget"
 992	depends on SND
 993	select USB_LIBCOMPOSITE
 994	select SND_RAWMIDI
 
 995	help
 996	  The MIDI Gadget acts as a USB Audio device, with one MIDI
 997	  input and one MIDI output. These MIDI jacks appear as
 998	  a sound "card" in the ALSA sound system. Other MIDI
 999	  connections can then be made on the gadget system, using
1000	  ALSA's aconnect utility etc.
1001
1002	  Say "y" to link the driver statically, or "m" to build a
1003	  dynamically linked module called "g_midi".
1004
1005config USB_G_PRINTER
1006	tristate "Printer Gadget"
1007	select USB_LIBCOMPOSITE
1008	help
1009	  The Printer Gadget channels data between the USB host and a
1010	  userspace program driving the print engine. The user space
1011	  program reads and writes the device file /dev/g_printer to
1012	  receive or send printer data. It can use ioctl calls to
1013	  the device file to get or set printer status.
 
 
 
1014
1015	  Say "y" to link the driver statically, or "m" to build a
1016	  dynamically linked module called "g_printer".
1017
1018	  For more information, see Documentation/usb/gadget_printer.txt
1019	  which includes sample code for accessing the device file.
1020
1021if TTY
1022
1023config USB_CDC_COMPOSITE
1024	tristate "CDC Composite Device (Ethernet and ACM)"
1025	depends on NET
1026	select USB_LIBCOMPOSITE
1027	select USB_U_SERIAL
1028	select USB_U_ETHER
1029	select USB_F_ACM
1030	select USB_F_ECM
1031	help
1032	  This driver provides two functions in one configuration:
1033	  a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
1034
1035	  This driver requires four bulk and two interrupt endpoints,
1036	  plus the ability to handle altsettings.  Not all peripheral
1037	  controllers are that capable.
1038
1039	  Say "y" to link the driver statically, or "m" to build a
1040	  dynamically linked module.
1041
1042config USB_G_NOKIA
1043	tristate "Nokia composite gadget"
1044	depends on PHONET
1045	select USB_LIBCOMPOSITE
1046	select USB_U_SERIAL
1047	select USB_U_ETHER
1048	select USB_F_ACM
1049	select USB_F_OBEX
1050	select USB_F_PHONET
1051	select USB_F_ECM
1052	help
1053	  The Nokia composite gadget provides support for acm, obex
1054	  and phonet in only one composite gadget driver.
 
1055
1056	  It's only really useful for N900 hardware. If you're building
1057	  a kernel for N900, say Y or M here. If unsure, say N.
1058
1059config USB_G_ACM_MS
1060	tristate "CDC Composite Device (ACM and mass storage)"
1061	depends on BLOCK
1062	select USB_LIBCOMPOSITE
1063	select USB_U_SERIAL
1064	select USB_F_ACM
1065	select USB_F_MASS_STORAGE
1066	help
1067	  This driver provides two functions in one configuration:
1068	  a mass storage, and a CDC ACM (serial port) link.
 
 
 
1069
1070	  Say "y" to link the driver statically, or "m" to build a
1071	  dynamically linked module called "g_acm_ms".
1072
1073config USB_G_MULTI
1074	tristate "Multifunction Composite Gadget"
1075	depends on BLOCK && NET
1076	select USB_G_MULTI_CDC if !USB_G_MULTI_RNDIS
1077	select USB_LIBCOMPOSITE
1078	select USB_U_SERIAL
1079	select USB_U_ETHER
1080	select USB_F_ACM
1081	select USB_F_MASS_STORAGE
1082	help
1083	  The Multifunction Composite Gadget provides Ethernet (RNDIS
1084	  and/or CDC Ethernet), mass storage and ACM serial link
1085	  interfaces.
1086
1087	  You will be asked to choose which of the two configurations is
1088	  to be available in the gadget.  At least one configuration must
1089	  be chosen to make the gadget usable.  Selecting more than one
1090	  configuration will prevent Windows from automatically detecting
1091	  the gadget as a composite gadget, so an INF file will be needed to
1092	  use the gadget.
1093
1094	  Say "y" to link the driver statically, or "m" to build a
1095	  dynamically linked module called "g_multi".
1096
1097config USB_G_MULTI_RNDIS
1098	bool "RNDIS + CDC Serial + Storage configuration"
1099	depends on USB_G_MULTI
1100	select USB_F_RNDIS
1101	default y
1102	help
1103	  This option enables a configuration with RNDIS, CDC Serial and
1104	  Mass Storage functions available in the Multifunction Composite
1105	  Gadget.  This is the configuration dedicated for Windows since RNDIS
1106	  is Microsoft's protocol.
1107
1108	  If unsure, say "y".
1109
1110config USB_G_MULTI_CDC
1111	bool "CDC Ethernet + CDC Serial + Storage configuration"
1112	depends on USB_G_MULTI
1113	default n
1114	select USB_F_ECM
1115	help
1116	  This option enables a configuration with CDC Ethernet (ECM), CDC
1117	  Serial and Mass Storage functions available in the Multifunction
1118	  Composite Gadget.
1119
1120	  If unsure, say "y".
1121
1122endif # TTY
1123
1124config USB_G_HID
1125	tristate "HID Gadget"
1126	select USB_LIBCOMPOSITE
1127	help
1128	  The HID gadget driver provides generic emulation of USB
1129	  Human Interface Devices (HID).
1130
1131	  For more information, see Documentation/usb/gadget_hid.txt which
1132	  includes sample code for accessing the device files.
1133
1134	  Say "y" to link the driver statically, or "m" to build a
1135	  dynamically linked module called "g_hid".
1136
1137# Standalone / single function gadgets
1138config USB_G_DBGP
1139	tristate "EHCI Debug Device Gadget"
1140	depends on TTY
1141	select USB_LIBCOMPOSITE
1142	help
1143	  This gadget emulates an EHCI Debug device. This is useful when you want
1144	  to interact with an EHCI Debug Port.
1145
1146	  Say "y" to link the driver statically, or "m" to build a
1147	  dynamically linked module called "g_dbgp".
1148
1149if USB_G_DBGP
1150choice
1151	prompt "EHCI Debug Device mode"
1152	default USB_G_DBGP_SERIAL
1153
1154config USB_G_DBGP_PRINTK
1155	depends on USB_G_DBGP
1156	bool "printk"
1157	help
1158	  Directly printk() received data. No interaction.
1159
1160config USB_G_DBGP_SERIAL
1161	depends on USB_G_DBGP
1162	select USB_U_SERIAL
1163	bool "serial"
1164	help
1165	  Userland can interact using /dev/ttyGSxxx.
1166endchoice
1167endif
1168
1169# put drivers that need isochronous transfer support (for audio
1170# or video class gadget drivers), or specific hardware, here.
1171config USB_G_WEBCAM
1172	tristate "USB Webcam Gadget"
1173	depends on VIDEO_DEV
1174	select USB_LIBCOMPOSITE
1175	select VIDEOBUF2_VMALLOC
1176	help
1177	  The Webcam Gadget acts as a composite USB Audio and Video Class
1178	  device. It provides a userspace API to process UVC control requests
1179	  and stream video data to the host.
1180
1181	  Say "y" to link the driver statically, or "m" to build a
1182	  dynamically linked module called "g_webcam".
1183
1184endchoice
1185
1186endif # USB_GADGET