1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16config USB_ZERO
17 tristate "Gadget Zero (DEVELOPMENT)"
18 select USB_LIBCOMPOSITE
19 select USB_F_SS_LB
20 help
21 Gadget Zero is a two-configuration device. It either sinks and
22 sources bulk data; or it loops back a configurable number of
23 transfers. It also implements control requests, for "chapter 9"
24 conformance. The driver needs only two bulk-capable endpoints, so
25 it can work on top of most device-side usb controllers. It's
26 useful for testing, and is also a working example showing how
27 USB "gadget drivers" can be written.
28
29 Make this be the first driver you try using on top of any new
30 USB peripheral controller driver. Then you can use host-side
31 test software, like the "usbtest" driver, to put your hardware
32 and its driver through a basic set of functional tests.
33
34 Gadget Zero also works with the host-side "usb-skeleton" driver,
35 and with many kinds of host-side test software. You may need
36 to tweak product and vendor IDs before host software knows about
37 this device, and arrange to select an appropriate configuration.
38
39 Say "y" to link the driver statically, or "m" to build a
40 dynamically linked module called "g_zero".
41
42config USB_ZERO_HNPTEST
43 bool "HNP Test Device"
44 depends on USB_ZERO && USB_OTG
45 help
46 You can configure this device to enumerate using the device
47 identifiers of the USB-OTG test device. That means that when
48 this gadget connects to another OTG device, with this one using
49 the "B-Peripheral" role, that device will use HNP to let this
50 one serve as the USB host instead (in the "B-Host" role).
51
52config USB_AUDIO
53 tristate "Audio Gadget"
54 depends on SND
55 select USB_LIBCOMPOSITE
56 select SND_PCM
57 select USB_F_UAC1 if (GADGET_UAC1 && !GADGET_UAC1_LEGACY)
58 select USB_F_UAC1_LEGACY if (GADGET_UAC1 && GADGET_UAC1_LEGACY)
59 select USB_F_UAC2 if !GADGET_UAC1
60 select USB_U_AUDIO if (USB_F_UAC2 || USB_F_UAC1)
61 help
62 This Gadget Audio driver is compatible with USB Audio Class
63 specification 2.0. It implements 1 AudioControl interface,
64 1 AudioStreaming Interface each for USB-OUT and USB-IN.
65 Number of channels, sample rate and sample size can be
66 specified as module parameters.
67 This driver doesn't expect any real Audio codec to be present
68 on the device - the audio streams are simply sinked to and
69 sourced from a virtual ALSA sound card created. The user-space
70 application may choose to do whatever it wants with the data
71 received from the USB Host and choose to provide whatever it
72 wants as audio data to the USB Host.
73
74 Say "y" to link the driver statically, or "m" to build a
75 dynamically linked module called "g_audio".
76
77config GADGET_UAC1
78 bool "UAC 1.0"
79 depends on USB_AUDIO
80 help
81 If you instead want older USB Audio Class specification 1.0 support
82 with similar driver capabilities.
83
84config GADGET_UAC1_LEGACY
85 bool "UAC 1.0 (Legacy)"
86 depends on GADGET_UAC1
87 help
88 If you instead want legacy UAC Spec-1.0 driver that also has audio
89 paths hardwired to the Audio codec chip on-board and doesn't work
90 without one.
91
92config USB_ETH
93 tristate "Ethernet Gadget (with CDC Ethernet support)"
94 depends on NET
95 select USB_LIBCOMPOSITE
96 select USB_U_ETHER
97 select USB_F_ECM
98 select USB_F_SUBSET
99 select CRC32
100 help
101 This driver implements Ethernet style communication, in one of
102 several ways:
103
104 - The "Communication Device Class" (CDC) Ethernet Control Model.
105 That protocol is often avoided with pure Ethernet adapters, in
106 favor of simpler vendor-specific hardware, but is widely
107 supported by firmware for smart network devices.
108
109 - On hardware can't implement that protocol, a simple CDC subset
110 is used, placing fewer demands on USB.
111
112 - CDC Ethernet Emulation Model (EEM) is a newer standard that has
113 a simpler interface that can be used by more USB hardware.
114
115 RNDIS support is an additional option, more demanding than subset.
116
117 Within the USB device, this gadget driver exposes a network device
118 "usbX", where X depends on what other networking devices you have.
119 Treat it like a two-node Ethernet link: host, and gadget.
120
121 The Linux-USB host-side "usbnet" driver interoperates with this
122 driver, so that deep I/O queues can be supported. On 2.4 kernels,
123 use "CDCEther" instead, if you're using the CDC option. That CDC
124 mode should also interoperate with standard CDC Ethernet class
125 drivers on other host operating systems.
126
127 Say "y" to link the driver statically, or "m" to build a
128 dynamically linked module called "g_ether".
129
130config USB_ETH_RNDIS
131 bool "RNDIS support"
132 depends on USB_ETH
133 select USB_LIBCOMPOSITE
134 select USB_F_RNDIS
135 default y
136 help
137 Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
138 and Microsoft provides redistributable binary RNDIS drivers for
139 older versions of Windows.
140
141 If you say "y" here, the Ethernet gadget driver will try to provide
142 a second device configuration, supporting RNDIS to talk to such
143 Microsoft USB hosts.
144
145 To make MS-Windows work with this, use Documentation/usb/linux.inf
146 as the "driver info file". For versions of MS-Windows older than
147 XP, you'll need to download drivers from Microsoft's website; a URL
148 is given in comments found in that info file.
149
150config USB_ETH_EEM
151 bool "Ethernet Emulation Model (EEM) support"
152 depends on USB_ETH
153 select USB_LIBCOMPOSITE
154 select USB_F_EEM
155 default n
156 help
157 CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
158 and therefore can be supported by more hardware. Technically ECM and
159 EEM are designed for different applications. The ECM model extends
160 the network interface to the target (e.g. a USB cable modem), and the
161 EEM model is for mobile devices to communicate with hosts using
162 ethernet over USB. For Linux gadgets, however, the interface with
163 the host is the same (a usbX device), so the differences are minimal.
164
165 If you say "y" here, the Ethernet gadget driver will use the EEM
166 protocol rather than ECM. If unsure, say "n".
167
168config USB_G_NCM
169 tristate "Network Control Model (NCM) support"
170 depends on NET
171 select USB_LIBCOMPOSITE
172 select USB_U_ETHER
173 select USB_F_NCM
174 select CRC32
175 help
176 This driver implements USB CDC NCM subclass standard. NCM is
177 an advanced protocol for Ethernet encapsulation, allows grouping
178 of several ethernet frames into one USB transfer and different
179 alignment possibilities.
180
181 Say "y" to link the driver statically, or "m" to build a
182 dynamically linked module called "g_ncm".
183
184config USB_GADGETFS
185 tristate "Gadget Filesystem"
186 help
187 This driver provides a filesystem based API that lets user mode
188 programs implement a single-configuration USB device, including
189 endpoint I/O and control requests that don't relate to enumeration.
190 All endpoints, transfer speeds, and transfer types supported by
191 the hardware are available, through read() and write() calls.
192
193 Say "y" to link the driver statically, or "m" to build a
194 dynamically linked module called "gadgetfs".
195
196config USB_FUNCTIONFS
197 tristate "Function Filesystem"
198 select USB_LIBCOMPOSITE
199 select USB_F_FS
200 select USB_FUNCTIONFS_GENERIC if !(USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
201 help
202 The Function Filesystem (FunctionFS) lets one create USB
203 composite functions in user space in the same way GadgetFS
204 lets one create USB gadgets in user space. This allows creation
205 of composite gadgets such that some of the functions are
206 implemented in kernel space (for instance Ethernet, serial or
207 mass storage) and other are implemented in user space.
208
209 If you say "y" or "m" here you will be able what kind of
210 configurations the gadget will provide.
211
212 Say "y" to link the driver statically, or "m" to build
213 a dynamically linked module called "g_ffs".
214
215config USB_FUNCTIONFS_ETH
216 bool "Include configuration with CDC ECM (Ethernet)"
217 depends on USB_FUNCTIONFS && NET
218 select USB_U_ETHER
219 select USB_F_ECM
220 select USB_F_SUBSET
221 help
222 Include a configuration with CDC ECM function (Ethernet) and the
223 Function Filesystem.
224
225config USB_FUNCTIONFS_RNDIS
226 bool "Include configuration with RNDIS (Ethernet)"
227 depends on USB_FUNCTIONFS && NET
228 select USB_U_ETHER
229 select USB_F_RNDIS
230 help
231 Include a configuration with RNDIS function (Ethernet) and the Filesystem.
232
233config USB_FUNCTIONFS_GENERIC
234 bool "Include 'pure' configuration"
235 depends on USB_FUNCTIONFS
236 help
237 Include a configuration with the Function Filesystem alone with
238 no Ethernet interface.
239
240config USB_MASS_STORAGE
241 tristate "Mass Storage Gadget"
242 depends on BLOCK
243 select USB_LIBCOMPOSITE
244 select USB_F_MASS_STORAGE
245 help
246 The Mass Storage Gadget acts as a USB Mass Storage disk drive.
247 As its storage repository it can use a regular file or a block
248 device (in much the same way as the "loop" device driver),
249 specified as a module parameter or sysfs option.
250
251 This driver is a replacement for now removed File-backed
252 Storage Gadget (g_file_storage).
253
254 Say "y" to link the driver statically, or "m" to build
255 a dynamically linked module called "g_mass_storage".
256
257config USB_GADGET_TARGET
258 tristate "USB Gadget Target Fabric Module"
259 depends on TARGET_CORE
260 select USB_LIBCOMPOSITE
261 select USB_F_TCM
262 help
263 This fabric is an USB gadget. Two USB protocols are supported that is
264 BBB or BOT (Bulk Only Transport) and UAS (USB Attached SCSI). BOT is
265 advertised on alternative interface 0 (primary) and UAS is on
266 alternative interface 1. Both protocols can work on USB2.0 and USB3.0.
267 UAS utilizes the USB 3.0 feature called streams support.
268
269config USB_G_SERIAL
270 tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
271 depends on TTY
272 select USB_U_SERIAL
273 select USB_F_ACM
274 select USB_F_SERIAL
275 select USB_F_OBEX
276 select USB_LIBCOMPOSITE
277 help
278 The Serial Gadget talks to the Linux-USB generic serial driver.
279 This driver supports a CDC-ACM module option, which can be used
280 to interoperate with MS-Windows hosts or with the Linux-USB
281 "cdc-acm" driver.
282
283 This driver also supports a CDC-OBEX option. You will need a
284 user space OBEX server talking to /dev/ttyGS*, since the kernel
285 itself doesn't implement the OBEX protocol.
286
287 Say "y" to link the driver statically, or "m" to build a
288 dynamically linked module called "g_serial".
289
290 For more information, see Documentation/usb/gadget_serial.txt
291 which includes instructions and a "driver info file" needed to
292 make MS-Windows work with CDC ACM.
293
294config USB_MIDI_GADGET
295 tristate "MIDI Gadget"
296 depends on SND
297 select USB_LIBCOMPOSITE
298 select SND_RAWMIDI
299 select USB_F_MIDI
300 help
301 The MIDI Gadget acts as a USB Audio device, with one MIDI
302 input and one MIDI output. These MIDI jacks appear as
303 a sound "card" in the ALSA sound system. Other MIDI
304 connections can then be made on the gadget system, using
305 ALSA's aconnect utility etc.
306
307 Say "y" to link the driver statically, or "m" to build a
308 dynamically linked module called "g_midi".
309
310config USB_G_PRINTER
311 tristate "Printer Gadget"
312 select USB_LIBCOMPOSITE
313 select USB_F_PRINTER
314 help
315 The Printer Gadget channels data between the USB host and a
316 userspace program driving the print engine. The user space
317 program reads and writes the device file /dev/g_printer to
318 receive or send printer data. It can use ioctl calls to
319 the device file to get or set printer status.
320
321 Say "y" to link the driver statically, or "m" to build a
322 dynamically linked module called "g_printer".
323
324 For more information, see Documentation/usb/gadget_printer.txt
325 which includes sample code for accessing the device file.
326
327if TTY
328
329config USB_CDC_COMPOSITE
330 tristate "CDC Composite Device (Ethernet and ACM)"
331 depends on NET
332 select USB_LIBCOMPOSITE
333 select USB_U_SERIAL
334 select USB_U_ETHER
335 select USB_F_ACM
336 select USB_F_ECM
337 help
338 This driver provides two functions in one configuration:
339 a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
340
341 This driver requires four bulk and two interrupt endpoints,
342 plus the ability to handle altsettings. Not all peripheral
343 controllers are that capable.
344
345 Say "y" to link the driver statically, or "m" to build a
346 dynamically linked module.
347
348config USB_G_NOKIA
349 tristate "Nokia composite gadget"
350 depends on PHONET
351 depends on BLOCK
352 select USB_LIBCOMPOSITE
353 select USB_U_SERIAL
354 select USB_U_ETHER
355 select USB_F_ACM
356 select USB_F_OBEX
357 select USB_F_PHONET
358 select USB_F_ECM
359 select USB_F_MASS_STORAGE
360 help
361 The Nokia composite gadget provides support for acm, obex
362 and phonet in only one composite gadget driver.
363
364 It's only really useful for N900 hardware. If you're building
365 a kernel for N900, say Y or M here. If unsure, say N.
366
367config USB_G_ACM_MS
368 tristate "CDC Composite Device (ACM and mass storage)"
369 depends on BLOCK
370 select USB_LIBCOMPOSITE
371 select USB_U_SERIAL
372 select USB_F_ACM
373 select USB_F_MASS_STORAGE
374 help
375 This driver provides two functions in one configuration:
376 a mass storage, and a CDC ACM (serial port) link.
377
378 Say "y" to link the driver statically, or "m" to build a
379 dynamically linked module called "g_acm_ms".
380
381config USB_G_MULTI
382 tristate "Multifunction Composite Gadget"
383 depends on BLOCK && NET
384 select USB_G_MULTI_CDC if !USB_G_MULTI_RNDIS
385 select USB_LIBCOMPOSITE
386 select USB_U_SERIAL
387 select USB_U_ETHER
388 select USB_F_ACM
389 select USB_F_MASS_STORAGE
390 help
391 The Multifunction Composite Gadget provides Ethernet (RNDIS
392 and/or CDC Ethernet), mass storage and ACM serial link
393 interfaces.
394
395 You will be asked to choose which of the two configurations is
396 to be available in the gadget. At least one configuration must
397 be chosen to make the gadget usable. Selecting more than one
398 configuration will prevent Windows from automatically detecting
399 the gadget as a composite gadget, so an INF file will be needed to
400 use the gadget.
401
402 Say "y" to link the driver statically, or "m" to build a
403 dynamically linked module called "g_multi".
404
405config USB_G_MULTI_RNDIS
406 bool "RNDIS + CDC Serial + Storage configuration"
407 depends on USB_G_MULTI
408 select USB_F_RNDIS
409 default y
410 help
411 This option enables a configuration with RNDIS, CDC Serial and
412 Mass Storage functions available in the Multifunction Composite
413 Gadget. This is the configuration dedicated for Windows since RNDIS
414 is Microsoft's protocol.
415
416 If unsure, say "y".
417
418config USB_G_MULTI_CDC
419 bool "CDC Ethernet + CDC Serial + Storage configuration"
420 depends on USB_G_MULTI
421 default n
422 select USB_F_ECM
423 help
424 This option enables a configuration with CDC Ethernet (ECM), CDC
425 Serial and Mass Storage functions available in the Multifunction
426 Composite Gadget.
427
428 If unsure, say "y".
429
430endif
431
432config USB_G_HID
433 tristate "HID Gadget"
434 select USB_LIBCOMPOSITE
435 select USB_F_HID
436 help
437 The HID gadget driver provides generic emulation of USB
438 Human Interface Devices (HID).
439
440 For more information, see Documentation/usb/gadget_hid.txt which
441 includes sample code for accessing the device files.
442
443 Say "y" to link the driver statically, or "m" to build a
444 dynamically linked module called "g_hid".
445
446
447config USB_G_DBGP
448 tristate "EHCI Debug Device Gadget"
449 depends on TTY
450 select USB_LIBCOMPOSITE
451 help
452 This gadget emulates an EHCI Debug device. This is useful when you want
453 to interact with an EHCI Debug Port.
454
455 Say "y" to link the driver statically, or "m" to build a
456 dynamically linked module called "g_dbgp".
457
458if USB_G_DBGP
459choice
460 prompt "EHCI Debug Device mode"
461 default USB_G_DBGP_SERIAL
462
463config USB_G_DBGP_PRINTK
464 depends on USB_G_DBGP
465 bool "printk"
466 help
467 Directly printk() received data. No interaction.
468
469config USB_G_DBGP_SERIAL
470 depends on USB_G_DBGP
471 select USB_U_SERIAL
472 bool "serial"
473 help
474 Userland can interact using /dev/ttyGSxxx.
475endchoice
476endif
477
478
479
480config USB_G_WEBCAM
481 tristate "USB Webcam Gadget"
482 depends on VIDEO_DEV
483 select USB_LIBCOMPOSITE
484 select VIDEOBUF2_VMALLOC
485 select USB_F_UVC
486 help
487 The Webcam Gadget acts as a composite USB Audio and Video Class
488 device. It provides a userspace API to process UVC control requests
489 and stream video data to the host.
490
491 Say "y" to link the driver statically, or "m" to build a
492 dynamically linked module called "g_webcam".
493