]> bbs.cooldavid.org Git - net-next-2.6.git/blame - drivers/usb/gadget/Kconfig
Merge git://git.kernel.org/pub/scm/linux/kernel/git/rusty/linux-2.6-for-linus
[net-next-2.6.git] / drivers / usb / gadget / Kconfig
CommitLineData
1da177e4
LT
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).
cab00891 10# - Some systems have both kinds of controllers.
1da177e4
LT
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#
1da177e4 15
b75be4ab
DC
16menuconfig USB_GADGET
17 tristate "USB Gadget Support"
1da177e4
LT
18 help
19 USB is a master/slave protocol, organized with one master
20 host (such as a PC) controlling up to 127 peripheral devices.
21 The USB hardware is asymmetric, which makes it easier to set up:
22 you can't connect a "to-the-host" connector to a peripheral.
23
24 Linux can run in the host, or in the peripheral. In both cases
25 you need a low level bus controller driver, and some software
26 talking to it. Peripheral controllers are often discrete silicon,
27 or are integrated with the CPU in a microcontroller. The more
e113f29c 28 familiar host side controllers have names like "EHCI", "OHCI",
1da177e4
LT
29 or "UHCI", and are usually integrated into southbridges on PC
30 motherboards.
31
32 Enable this configuration option if you want to run Linux inside
33 a USB peripheral device. Configure one hardware driver for your
34 peripheral/device side bus controller, and a "gadget driver" for
35 your peripheral protocol. (If you use modular gadget drivers,
36 you may configure more than one.)
37
38 If in doubt, say "N" and don't enable these drivers; most people
39 don't have this kind of hardware (except maybe inside Linux PDAs).
40
41 For more information, see <http://www.linux-usb.org/gadget> and
42 the kernel DocBook documentation for this API.
43
b75be4ab
DC
44if USB_GADGET
45
70790f63 46config USB_GADGET_DEBUG
afd0e0f2 47 boolean "Debugging messages (DEVELOPMENT)"
36e893d2 48 depends on DEBUG_KERNEL
70790f63
DB
49 help
50 Many controller and gadget drivers will print some debugging
51 messages if you use this option to ask for those messages.
52
53 Avoid enabling these messages, even if you're actively
54 debugging such a driver. Many drivers will emit so many
55 messages that the driver timings are affected, which will
56 either create new failure modes or remove the one you're
57 trying to track down. Never enable these messages for a
58 production build.
59
1da177e4 60config USB_GADGET_DEBUG_FILES
afd0e0f2 61 boolean "Debugging information files (DEVELOPMENT)"
36e893d2 62 depends on PROC_FS
1da177e4
LT
63 help
64 Some of the drivers in the "gadget" framework can expose
65 debugging information in files such as /proc/driver/udc
66 (for a peripheral controller). The information in these
67 files may help when you're troubleshooting or bringing up a
68 driver on a new board. Enable these files by choosing "Y"
69 here. If in doubt, or to conserve kernel memory, say "N".
70
914a3f3b 71config USB_GADGET_DEBUG_FS
afd0e0f2 72 boolean "Debugging information files in debugfs (DEVELOPMENT)"
36e893d2 73 depends on DEBUG_FS
914a3f3b
HS
74 help
75 Some of the drivers in the "gadget" framework can expose
76 debugging information in files under /sys/kernel/debug/.
77 The information in these files may help when you're
78 troubleshooting or bringing up a driver on a new board.
79 Enable these files by choosing "Y" here. If in doubt, or
80 to conserve kernel memory, say "N".
81
36e893d2
DB
82config USB_GADGET_VBUS_DRAW
83 int "Maximum VBUS Power usage (2-500 mA)"
84 range 2 500
85 default 2
86 help
87 Some devices need to draw power from USB when they are
88 configured, perhaps to operate circuitry or to recharge
89 batteries. This is in addition to any local power supply,
90 such as an AC adapter or batteries.
91
92 Enter the maximum power your device draws through USB, in
93 milliAmperes. The permitted range of values is 2 - 500 mA;
94 0 mA would be legal, but can make some hosts misbehave.
95
96 This value will be used except for system-specific gadget
97 drivers that have more specific information.
98
028b271b
DB
99config USB_GADGET_SELECTED
100 boolean
101
1da177e4
LT
102#
103# USB Peripheral Controller Support
104#
a7a19fac
DB
105# The order here is alphabetical, except that integrated controllers go
106# before discrete ones so they will be the initial/default value:
107# - integrated/SOC controllers first
108# - licensed IP used in both SOC and discrete versions
109# - discrete ones (including all PCI-only controllers)
110# - debug/dummy gadget+hcd is last.
111#
1da177e4
LT
112choice
113 prompt "USB Peripheral Controller"
114 depends on USB_GADGET
115 help
116 A USB device uses a controller to talk to its host.
117 Systems should have only one such upstream link.
118 Many controller drivers are platform-specific; these
119 often need board-specific hooks.
120
a7a19fac
DB
121#
122# Integrated controllers
123#
124
125config USB_GADGET_AT91
126 boolean "Atmel AT91 USB Device Port"
aa781af0 127 depends on ARCH_AT91 && !ARCH_AT91SAM9RL && !ARCH_AT91CAP9 && !ARCH_AT91SAM9G45
a7a19fac 128 select USB_GADGET_SELECTED
55d402d8 129 help
a7a19fac
DB
130 Many Atmel AT91 processors (such as the AT91RM2000) have a
131 full speed USB Device Port with support for five configurable
132 endpoints (plus endpoint zero).
55d402d8
TD
133
134 Say "y" to link the driver statically, or "m" to build a
a7a19fac 135 dynamically linked module called "at91_udc" and force all
55d402d8
TD
136 gadget drivers to also be dynamically linked.
137
a7a19fac 138config USB_AT91
55d402d8 139 tristate
a7a19fac 140 depends on USB_GADGET_AT91
55d402d8 141 default USB_GADGET
55d402d8 142
914a3f3b
HS
143config USB_GADGET_ATMEL_USBA
144 boolean "Atmel USBA"
145 select USB_GADGET_DUALSPEED
aa781af0 146 depends on AVR32 || ARCH_AT91CAP9 || ARCH_AT91SAM9RL || ARCH_AT91SAM9G45
914a3f3b
HS
147 help
148 USBA is the integrated high-speed USB Device controller on
ba45ca43 149 the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
914a3f3b
HS
150
151config USB_ATMEL_USBA
152 tristate
153 depends on USB_GADGET_ATMEL_USBA
154 default USB_GADGET
155 select USB_GADGET_SELECTED
156
b504882d
LY
157config USB_GADGET_FSL_USB2
158 boolean "Freescale Highspeed USB DR Peripheral Controller"
54e4026b 159 depends on FSL_SOC || ARCH_MXC
b504882d
LY
160 select USB_GADGET_DUALSPEED
161 help
162 Some of Freescale PowerPC processors have a High Speed
163 Dual-Role(DR) USB controller, which supports device mode.
164
165 The number of programmable endpoints is different through
166 SOC revisions.
167
168 Say "y" to link the driver statically, or "m" to build a
169 dynamically linked module called "fsl_usb2_udc" and force
170 all gadget drivers to also be dynamically linked.
171
172config USB_FSL_USB2
173 tristate
174 depends on USB_GADGET_FSL_USB2
175 default USB_GADGET
176 select USB_GADGET_SELECTED
177
a7a19fac
DB
178config USB_GADGET_LH7A40X
179 boolean "LH7A40X"
180 depends on ARCH_LH7A40X
1da177e4 181 help
a7a19fac
DB
182 This driver provides USB Device Controller driver for LH7A40x
183
184config USB_LH7A40X
185 tristate
186 depends on USB_GADGET_LH7A40X
187 default USB_GADGET
188 select USB_GADGET_SELECTED
189
190config USB_GADGET_OMAP
191 boolean "OMAP USB Device Controller"
192 depends on ARCH_OMAP
f1c9e151 193 select ISP1301_OMAP if MACH_OMAP_H2 || MACH_OMAP_H3 || MACH_OMAP_H4_OTG
54b9ed35 194 select USB_OTG_UTILS if ARCH_OMAP
a7a19fac
DB
195 help
196 Many Texas Instruments OMAP processors have flexible full
197 speed USB device controllers, with support for up to 30
198 endpoints (plus endpoint zero). This driver supports the
199 controller in the OMAP 1611, and should work with controllers
200 in other OMAP processors too, given minor tweaks.
1da177e4
LT
201
202 Say "y" to link the driver statically, or "m" to build a
a7a19fac 203 dynamically linked module called "omap_udc" and force all
1da177e4
LT
204 gadget drivers to also be dynamically linked.
205
a7a19fac 206config USB_OMAP
1da177e4 207 tristate
a7a19fac 208 depends on USB_GADGET_OMAP
1da177e4 209 default USB_GADGET
028b271b 210 select USB_GADGET_SELECTED
1da177e4 211
a7a19fac
DB
212config USB_OTG
213 boolean "OTG Support"
214 depends on USB_GADGET_OMAP && ARCH_OMAP_OTG && USB_OHCI_HCD
215 help
216 The most notable feature of USB OTG is support for a
217 "Dual-Role" device, which can act as either a device
218 or a host. The initial role choice can be changed
219 later, when two dual-role devices talk to each other.
220
221 Select this only if your OMAP board has a Mini-AB connector.
222
7a857620 223config USB_GADGET_PXA25X
1da177e4
LT
224 boolean "PXA 25x or IXP 4xx"
225 depends on (ARCH_PXA && PXA25x) || ARCH_IXP4XX
09963911 226 select USB_OTG_UTILS
1da177e4
LT
227 help
228 Intel's PXA 25x series XScale ARM-5TE processors include
229 an integrated full speed USB 1.1 device controller. The
230 controller in the IXP 4xx series is register-compatible.
231
232 It has fifteen fixed-function endpoints, as well as endpoint
233 zero (for control transfers).
234
235 Say "y" to link the driver statically, or "m" to build a
7a857620 236 dynamically linked module called "pxa25x_udc" and force all
1da177e4
LT
237 gadget drivers to also be dynamically linked.
238
7a857620 239config USB_PXA25X
1da177e4 240 tristate
7a857620 241 depends on USB_GADGET_PXA25X
1da177e4 242 default USB_GADGET
028b271b 243 select USB_GADGET_SELECTED
1da177e4
LT
244
245# if there's only one gadget driver, using only two bulk endpoints,
246# don't waste memory for the other endpoints
7a857620
PZ
247config USB_PXA25X_SMALL
248 depends on USB_GADGET_PXA25X
1da177e4
LT
249 bool
250 default n if USB_ETH_RNDIS
251 default y if USB_ZERO
252 default y if USB_ETH
253 default y if USB_G_SERIAL
254
c4144247
YS
255config USB_GADGET_R8A66597
256 boolean "Renesas R8A66597 USB Peripheral Controller"
257 select USB_GADGET_DUALSPEED
258 help
259 R8A66597 is a discrete USB host and peripheral controller chip that
260 supports both full and high speed USB 2.0 data transfers.
261 It has nine configurable endpoints, and endpoint zero.
262
263 Say "y" to link the driver statically, or "m" to build a
264 dynamically linked module called "r8a66597_udc" and force all
265 gadget drivers to also be dynamically linked.
266
267config USB_R8A66597
268 tristate
269 depends on USB_GADGET_R8A66597
270 default USB_GADGET
271 select USB_GADGET_SELECTED
272
d75379a5
RJ
273config USB_GADGET_PXA27X
274 boolean "PXA 27x"
9f5351b7 275 depends on ARCH_PXA && (PXA27x || PXA3xx)
7fec3c25 276 select USB_OTG_UTILS
d75379a5
RJ
277 help
278 Intel's PXA 27x series XScale ARM v5TE processors include
279 an integrated full speed USB 1.1 device controller.
280
281 It has up to 23 endpoints, as well as endpoint zero (for
282 control transfers).
283
284 Say "y" to link the driver statically, or "m" to build a
285 dynamically linked module called "pxa27x_udc" and force all
286 gadget drivers to also be dynamically linked.
287
288config USB_PXA27X
289 tristate
290 depends on USB_GADGET_PXA27X
291 default USB_GADGET
292 select USB_GADGET_SELECTED
293
5b7d70c6
BD
294config USB_GADGET_S3C_HSOTG
295 boolean "S3C HS/OtG USB Device controller"
296 depends on S3C_DEV_USB_HSOTG
297 select USB_GADGET_S3C_HSOTG_PIO
0287e43d 298 select USB_GADGET_DUALSPEED
5b7d70c6
BD
299 help
300 The Samsung S3C64XX USB2.0 high-speed gadget controller
301 integrated into the S3C64XX series SoC.
302
303config USB_S3C_HSOTG
304 tristate
305 depends on USB_GADGET_S3C_HSOTG
306 default USB_GADGET
307 select USB_GADGET_SELECTED
308
c03e7d4b
PZ
309config USB_GADGET_IMX
310 boolean "Freescale IMX USB Peripheral Controller"
311 depends on ARCH_MX1
312 help
313 Freescale's IMX series include an integrated full speed
314 USB 1.1 device controller. The controller in the IMX series
315 is register-compatible.
316
317 It has Six fixed-function endpoints, as well as endpoint
318 zero (for control transfers).
319
320 Say "y" to link the driver statically, or "m" to build a
321 dynamically linked module called "imx_udc" and force all
322 gadget drivers to also be dynamically linked.
323
324config USB_IMX
325 tristate
326 depends on USB_GADGET_IMX
327 default USB_GADGET
328 select USB_GADGET_SELECTED
329
a7a19fac
DB
330config USB_GADGET_S3C2410
331 boolean "S3C2410 USB Device Controller"
332 depends on ARCH_S3C2410
1da177e4 333 help
a7a19fac
DB
334 Samsung's S3C2410 is an ARM-4 processor with an integrated
335 full speed USB 1.1 device controller. It has 4 configurable
336 endpoints, as well as endpoint zero (for control transfers).
1da177e4 337
a7a19fac
DB
338 This driver has been tested on the S3C2410, S3C2412, and
339 S3C2440 processors.
1da177e4 340
a7a19fac 341config USB_S3C2410
1da177e4 342 tristate
a7a19fac 343 depends on USB_GADGET_S3C2410
1da177e4 344 default USB_GADGET
028b271b 345 select USB_GADGET_SELECTED
1da177e4 346
a7a19fac
DB
347config USB_S3C2410_DEBUG
348 boolean "S3C2410 udc debug messages"
349 depends on USB_GADGET_S3C2410
1da177e4 350
a7a19fac
DB
351#
352# Controllers available in both integrated and discrete versions
353#
1da177e4 354
a7a19fac 355# musb builds in ../musb along with host support
550a7375 356config USB_GADGET_MUSB_HDRC
085ad406 357 boolean "Inventra HDRC USB Peripheral (TI, ADI, ...)"
550a7375
FB
358 depends on USB_MUSB_HDRC && (USB_MUSB_PERIPHERAL || USB_MUSB_OTG)
359 select USB_GADGET_DUALSPEED
360 select USB_GADGET_SELECTED
361 help
362 This OTG-capable silicon IP is used in dual designs including
085ad406 363 the TI DaVinci, OMAP 243x, OMAP 343x, TUSB 6010, and ADI Blackfin
550a7375 364
a7a19fac
DB
365config USB_GADGET_M66592
366 boolean "Renesas M66592 USB Peripheral Controller"
367 select USB_GADGET_DUALSPEED
1da177e4 368 help
a7a19fac
DB
369 M66592 is a discrete USB peripheral controller chip that
370 supports both full and high speed USB 2.0 data transfers.
371 It has seven configurable endpoints, and endpoint zero.
1da177e4
LT
372
373 Say "y" to link the driver statically, or "m" to build a
a7a19fac 374 dynamically linked module called "m66592_udc" and force all
1da177e4
LT
375 gadget drivers to also be dynamically linked.
376
a7a19fac 377config USB_M66592
1da177e4 378 tristate
a7a19fac 379 depends on USB_GADGET_M66592
1da177e4 380 default USB_GADGET
028b271b 381 select USB_GADGET_SELECTED
1da177e4 382
a7a19fac
DB
383#
384# Controllers available only in discrete form (and all PCI controllers)
385#
386
387config USB_GADGET_AMD5536UDC
388 boolean "AMD5536 UDC"
389 depends on PCI
390 select USB_GADGET_DUALSPEED
3fc154b6 391 help
a7a19fac
DB
392 The AMD5536 UDC is part of the AMD Geode CS5536, an x86 southbridge.
393 It is a USB Highspeed DMA capable USB device controller. Beside ep0
394 it provides 4 IN and 4 OUT endpoints (bulk or interrupt type).
395 The UDC port supports OTG operation, and may be used as a host port
396 if it's not being used to implement peripheral or OTG roles.
3fc154b6 397
a7a19fac
DB
398 Say "y" to link the driver statically, or "m" to build a
399 dynamically linked module called "amd5536udc" and force all
400 gadget drivers to also be dynamically linked.
3fc154b6 401
a7a19fac 402config USB_AMD5536UDC
3fc154b6 403 tristate
a7a19fac 404 depends on USB_GADGET_AMD5536UDC
3fc154b6
AP
405 default USB_GADGET
406 select USB_GADGET_SELECTED
407
3948f0e0
LY
408config USB_GADGET_FSL_QE
409 boolean "Freescale QE/CPM USB Device Controller"
410 depends on FSL_SOC && (QUICC_ENGINE || CPM)
411 help
412 Some of Freescale PowerPC processors have a Full Speed
413 QE/CPM2 USB controller, which support device mode with 4
414 programmable endpoints. This driver supports the
415 controller in the MPC8360 and MPC8272, and should work with
416 controllers having QE or CPM2, given minor tweaks.
417
418 Set CONFIG_USB_GADGET to "m" to build this driver as a
692105b8 419 dynamically linked module called "fsl_qe_udc".
3948f0e0
LY
420
421config USB_FSL_QE
422 tristate
423 depends on USB_GADGET_FSL_QE
424 default USB_GADGET
425 select USB_GADGET_SELECTED
426
aa69a809
DL
427config USB_GADGET_CI13XXX
428 boolean "MIPS USB CI13xxx"
429 depends on PCI
430 select USB_GADGET_DUALSPEED
431 help
432 MIPS USB IP core family device controller
433 Currently it only supports IP part number CI13412
434
435 Say "y" to link the driver statically, or "m" to build a
436 dynamically linked module called "ci13xxx_udc" and force all
437 gadget drivers to also be dynamically linked.
438
439config USB_CI13XXX
440 tristate
441 depends on USB_GADGET_CI13XXX
442 default USB_GADGET
443 select USB_GADGET_SELECTED
444
a7a19fac
DB
445config USB_GADGET_NET2280
446 boolean "NetChip 228x"
447 depends on PCI
448 select USB_GADGET_DUALSPEED
449 help
450 NetChip 2280 / 2282 is a PCI based USB peripheral controller which
451 supports both full and high speed USB 2.0 data transfers.
3fc154b6 452
a7a19fac
DB
453 It has six configurable endpoints, as well as endpoint zero
454 (for control transfers) and several endpoints with dedicated
455 functions.
456
457 Say "y" to link the driver statically, or "m" to build a
458 dynamically linked module called "net2280" and force all
459 gadget drivers to also be dynamically linked.
460
461config USB_NET2280
462 tristate
463 depends on USB_GADGET_NET2280
464 default USB_GADGET
bae4bd84 465 select USB_GADGET_SELECTED
a7a19fac
DB
466
467config USB_GADGET_GOKU
468 boolean "Toshiba TC86C001 'Goku-S'"
469 depends on PCI
bae4bd84 470 help
a7a19fac
DB
471 The Toshiba TC86C001 is a PCI device which includes controllers
472 for full speed USB devices, IDE, I2C, SIO, plus a USB host (OHCI).
473
474 The device controller has three configurable (bulk or interrupt)
475 endpoints, plus endpoint zero (for control transfers).
bae4bd84
DB
476
477 Say "y" to link the driver statically, or "m" to build a
a7a19fac 478 dynamically linked module called "goku_udc" and to force all
bae4bd84
DB
479 gadget drivers to also be dynamically linked.
480
a7a19fac 481config USB_GOKU
bae4bd84 482 tristate
a7a19fac 483 depends on USB_GADGET_GOKU
bae4bd84 484 default USB_GADGET
a7a19fac
DB
485 select USB_GADGET_SELECTED
486
5be19a9d
XS
487config USB_GADGET_LANGWELL
488 boolean "Intel Langwell USB Device Controller"
489 depends on PCI
490 select USB_GADGET_DUALSPEED
491 help
492 Intel Langwell USB Device Controller is a High-Speed USB
493 On-The-Go device controller.
494
495 The number of programmable endpoints is different through
496 controller revision.
497
498 Say "y" to link the driver statically, or "m" to build a
499 dynamically linked module called "langwell_udc" and force all
500 gadget drivers to also be dynamically linked.
501
502config USB_LANGWELL
503 tristate
504 depends on USB_GADGET_LANGWELL
505 default USB_GADGET
506 select USB_GADGET_SELECTED
507
a7a19fac
DB
508
509#
510# LAST -- dummy/emulated controller
511#
1da177e4
LT
512
513config USB_GADGET_DUMMY_HCD
514 boolean "Dummy HCD (DEVELOPMENT)"
afd0e0f2 515 depends on USB=y || (USB=m && USB_GADGET=m)
1da177e4
LT
516 select USB_GADGET_DUALSPEED
517 help
518 This host controller driver emulates USB, looping all data transfer
519 requests back to a USB "gadget driver" in the same host. The host
520 side is the master; the gadget side is the slave. Gadget drivers
521 can be high, full, or low speed; and they have access to endpoints
522 like those from NET2280, PXA2xx, or SA1100 hardware.
523
524 This may help in some stages of creating a driver to embed in a
525 Linux device, since it lets you debug several parts of the gadget
526 driver without its hardware or drivers being involved.
527
528 Since such a gadget side driver needs to interoperate with a host
529 side Linux-USB device driver, this may help to debug both sides
530 of a USB protocol stack.
531
532 Say "y" to link the driver statically, or "m" to build a
533 dynamically linked module called "dummy_hcd" and force all
534 gadget drivers to also be dynamically linked.
535
536config USB_DUMMY_HCD
537 tristate
538 depends on USB_GADGET_DUMMY_HCD
539 default USB_GADGET
028b271b 540 select USB_GADGET_SELECTED
1da177e4
LT
541
542# NOTE: Please keep dummy_hcd LAST so that "real hardware" appears
543# first and will be selected by default.
544
545endchoice
546
547config USB_GADGET_DUALSPEED
548 bool
549 depends on USB_GADGET
550 default n
551 help
552 Means that gadget drivers should include extra descriptors
553 and code to handle dual-speed controllers.
554
555#
556# USB Gadget Drivers
557#
558choice
559 tristate "USB Gadget Drivers"
028b271b 560 depends on USB_GADGET && USB_GADGET_SELECTED
1da177e4
LT
561 default USB_ETH
562 help
563 A Linux "Gadget Driver" talks to the USB Peripheral Controller
564 driver through the abstract "gadget" API. Some other operating
565 systems call these "client" drivers, of which "class drivers"
566 are a subset (implementing a USB device class specification).
567 A gadget driver implements one or more USB functions using
568 the peripheral hardware.
569
570 Gadget drivers are hardware-neutral, or "platform independent",
571 except that they sometimes must understand quirks or limitations
572 of the particular controllers they work with. For example, when
573 a controller doesn't support alternate configurations or provide
574 enough of the right types of endpoints, the gadget driver might
575 not be able work with that controller, or might need to implement
576 a less common variant of a device class protocol.
577
578# this first set of drivers all depend on bulk-capable hardware.
579
580config USB_ZERO
581 tristate "Gadget Zero (DEVELOPMENT)"
1da177e4
LT
582 help
583 Gadget Zero is a two-configuration device. It either sinks and
584 sources bulk data; or it loops back a configurable number of
585 transfers. It also implements control requests, for "chapter 9"
586 conformance. The driver needs only two bulk-capable endpoints, so
587 it can work on top of most device-side usb controllers. It's
588 useful for testing, and is also a working example showing how
589 USB "gadget drivers" can be written.
590
591 Make this be the first driver you try using on top of any new
592 USB peripheral controller driver. Then you can use host-side
593 test software, like the "usbtest" driver, to put your hardware
594 and its driver through a basic set of functional tests.
595
596 Gadget Zero also works with the host-side "usb-skeleton" driver,
597 and with many kinds of host-side test software. You may need
598 to tweak product and vendor IDs before host software knows about
599 this device, and arrange to select an appropriate configuration.
600
601 Say "y" to link the driver statically, or "m" to build a
602 dynamically linked module called "g_zero".
603
604config USB_ZERO_HNPTEST
605 boolean "HNP Test Device"
606 depends on USB_ZERO && USB_OTG
607 help
608 You can configure this device to enumerate using the device
609 identifiers of the USB-OTG test device. That means that when
610 this gadget connects to another OTG device, with this one using
611 the "B-Peripheral" role, that device will use HNP to let this
612 one serve as the USB host instead (in the "B-Host" role).
613
c6994e6f
BW
614config USB_AUDIO
615 tristate "Audio Gadget (EXPERIMENTAL)"
616 depends on SND
04950737 617 select SND_PCM
c6994e6f
BW
618 help
619 Gadget Audio is compatible with USB Audio Class specification 1.0.
620 It will include at least one AudioControl interface, zero or more
621 AudioStream interface and zero or more MIDIStream interface.
622
623 Gadget Audio will use on-board ALSA (CONFIG_SND) audio card to
624 playback or capture audio stream.
625
626 Say "y" to link the driver statically, or "m" to build a
627 dynamically linked module called "g_audio".
628
1da177e4
LT
629config USB_ETH
630 tristate "Ethernet Gadget (with CDC Ethernet support)"
631 depends on NET
9e221be8 632 select CRC32
1da177e4 633 help
9b39e9dd
BN
634 This driver implements Ethernet style communication, in one of
635 several ways:
1da177e4
LT
636
637 - The "Communication Device Class" (CDC) Ethernet Control Model.
638 That protocol is often avoided with pure Ethernet adapters, in
639 favor of simpler vendor-specific hardware, but is widely
640 supported by firmware for smart network devices.
641
642 - On hardware can't implement that protocol, a simple CDC subset
643 is used, placing fewer demands on USB.
644
9b39e9dd
BN
645 - CDC Ethernet Emulation Model (EEM) is a newer standard that has
646 a simpler interface that can be used by more USB hardware.
647
648 RNDIS support is an additional option, more demanding than than
649 subset.
1da177e4
LT
650
651 Within the USB device, this gadget driver exposes a network device
652 "usbX", where X depends on what other networking devices you have.
653 Treat it like a two-node Ethernet link: host, and gadget.
654
655 The Linux-USB host-side "usbnet" driver interoperates with this
656 driver, so that deep I/O queues can be supported. On 2.4 kernels,
657 use "CDCEther" instead, if you're using the CDC option. That CDC
658 mode should also interoperate with standard CDC Ethernet class
659 drivers on other host operating systems.
660
661 Say "y" to link the driver statically, or "m" to build a
662 dynamically linked module called "g_ether".
663
664config USB_ETH_RNDIS
afd0e0f2
RD
665 bool "RNDIS support"
666 depends on USB_ETH
1da177e4
LT
667 default y
668 help
669 Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
670 and Microsoft provides redistributable binary RNDIS drivers for
671 older versions of Windows.
672
673 If you say "y" here, the Ethernet gadget driver will try to provide
674 a second device configuration, supporting RNDIS to talk to such
675 Microsoft USB hosts.
676
677 To make MS-Windows work with this, use Documentation/usb/linux.inf
678 as the "driver info file". For versions of MS-Windows older than
679 XP, you'll need to download drivers from Microsoft's website; a URL
680 is given in comments found in that info file.
681
9b39e9dd
BN
682config USB_ETH_EEM
683 bool "Ethernet Emulation Model (EEM) support"
684 depends on USB_ETH
685 default n
686 help
687 CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
688 and therefore can be supported by more hardware. Technically ECM and
689 EEM are designed for different applications. The ECM model extends
690 the network interface to the target (e.g. a USB cable modem), and the
691 EEM model is for mobile devices to communicate with hosts using
692 ethernet over USB. For Linux gadgets, however, the interface with
693 the host is the same (a usbX device), so the differences are minimal.
694
695 If you say "y" here, the Ethernet gadget driver will use the EEM
696 protocol rather than ECM. If unsure, say "n".
697
1da177e4
LT
698config USB_GADGETFS
699 tristate "Gadget Filesystem (EXPERIMENTAL)"
700 depends on EXPERIMENTAL
701 help
702 This driver provides a filesystem based API that lets user mode
703 programs implement a single-configuration USB device, including
704 endpoint I/O and control requests that don't relate to enumeration.
705 All endpoints, transfer speeds, and transfer types supported by
706 the hardware are available, through read() and write() calls.
707
afd0e0f2
RD
708 Currently, this option is still labelled as EXPERIMENTAL because
709 of existing race conditions in the underlying in-kernel AIO core.
710
1da177e4
LT
711 Say "y" to link the driver statically, or "m" to build a
712 dynamically linked module called "gadgetfs".
713
c6c56008
MN
714config USB_FUNCTIONFS
715 tristate "Function Filesystem (EXPERIMENTAL)"
716 depends on EXPERIMENTAL
717 help
718 The Function Filesystem (FunctioFS) lets one create USB
719 composite functions in user space in the same way as GadgetFS
720 lets one create USB gadgets in user space. This allows creation
721 of composite gadgets such that some of the functions are
722 implemented in kernel space (for instance Ethernet, serial or
723 mass storage) and other are implemented in user space.
724
725 Say "y" to link the driver statically, or "m" to build
726 a dynamically linked module called "g_ffs".
727
728config USB_FUNCTIONFS_ETH
729 bool "Include CDC ECM (Ethernet) function"
17b2765e 730 depends on USB_FUNCTIONFS && NET
c6c56008
MN
731 help
732 Include an CDC ECM (Ethernet) funcion in the CDC ECM (Funcion)
733 Filesystem. If you also say "y" to the RNDIS query below the
734 gadget will have two configurations.
735
736config USB_FUNCTIONFS_RNDIS
737 bool "Include RNDIS (Ethernet) function"
17b2765e 738 depends on USB_FUNCTIONFS && NET
c6c56008
MN
739 help
740 Include an RNDIS (Ethernet) funcion in the Funcion Filesystem.
741 If you also say "y" to the CDC ECM query above the gadget will
742 have two configurations.
743
744config USB_FUNCTIONFS_GENERIC
745 bool "Include 'pure' configuration"
746 depends on USB_FUNCTIONFS && (USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
747 help
748 Include a configuration with FunctionFS and no Ethernet
749 configuration.
750
1da177e4
LT
751config USB_FILE_STORAGE
752 tristate "File-backed Storage Gadget"
87840289 753 depends on BLOCK
1da177e4
LT
754 help
755 The File-backed Storage Gadget acts as a USB Mass Storage
756 disk drive. As its storage repository it can use a regular
757 file or a block device (in much the same way as the "loop"
758 device driver), specified as a module parameter.
759
760 Say "y" to link the driver statically, or "m" to build a
761 dynamically linked module called "g_file_storage".
762
763config USB_FILE_STORAGE_TEST
764 bool "File-backed Storage Gadget testing version"
765 depends on USB_FILE_STORAGE
766 default n
767 help
768 Say "y" to generate the larger testing version of the
769 File-backed Storage Gadget, useful for probing the
770 behavior of USB Mass Storage hosts. Not needed for
771 normal operation.
772
d23b0f08
MN
773config USB_MASS_STORAGE
774 tristate "Mass Storage Gadget"
775 depends on BLOCK
776 help
777 The Mass Storage Gadget acts as a USB Mass Storage disk drive.
778 As its storage repository it can use a regular file or a block
779 device (in much the same way as the "loop" device driver),
780 specified as a module parameter or sysfs option.
781
782 This is heavily based on File-backed Storage Gadget and in most
783 cases you will want to use FSG instead. This gadget is mostly
784 here to test the functionality of the Mass Storage Function
785 which may be used with composite framework.
786
787 Say "y" to link the driver statically, or "m" to build
11b10d99 788 a dynamically linked module called "g_mass_storage". If unsure,
d23b0f08
MN
789 consider File-backed Storage Gadget.
790
1da177e4 791config USB_G_SERIAL
3086775a 792 tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
1da177e4
LT
793 help
794 The Serial Gadget talks to the Linux-USB generic serial driver.
795 This driver supports a CDC-ACM module option, which can be used
796 to interoperate with MS-Windows hosts or with the Linux-USB
797 "cdc-acm" driver.
798
3086775a
FB
799 This driver also supports a CDC-OBEX option. You will need a
800 user space OBEX server talking to /dev/ttyGS*, since the kernel
801 itself doesn't implement the OBEX protocol.
802
1da177e4
LT
803 Say "y" to link the driver statically, or "m" to build a
804 dynamically linked module called "g_serial".
805
806 For more information, see Documentation/usb/gadget_serial.txt
807 which includes instructions and a "driver info file" needed to
3086775a 808 make MS-Windows work with CDC ACM.
1da177e4 809
f2ebf92c
BW
810config USB_MIDI_GADGET
811 tristate "MIDI Gadget (EXPERIMENTAL)"
812 depends on SND && EXPERIMENTAL
813 select SND_RAWMIDI
814 help
815 The MIDI Gadget acts as a USB Audio device, with one MIDI
816 input and one MIDI output. These MIDI jacks appear as
817 a sound "card" in the ALSA sound system. Other MIDI
818 connections can then be made on the gadget system, using
819 ALSA's aconnect utility etc.
820
821 Say "y" to link the driver statically, or "m" to build a
822 dynamically linked module called "g_midi".
823
25a010c8
CN
824config USB_G_PRINTER
825 tristate "Printer Gadget"
826 help
827 The Printer Gadget channels data between the USB host and a
828 userspace program driving the print engine. The user space
829 program reads and writes the device file /dev/g_printer to
830 receive or send printer data. It can use ioctl calls to
831 the device file to get or set printer status.
832
833 Say "y" to link the driver statically, or "m" to build a
834 dynamically linked module called "g_printer".
835
836 For more information, see Documentation/usb/gadget_printer.txt
837 which includes sample code for accessing the device file.
1da177e4 838
19e20680
DB
839config USB_CDC_COMPOSITE
840 tristate "CDC Composite Device (Ethernet and ACM)"
4ddd9ec1 841 depends on NET
19e20680
DB
842 help
843 This driver provides two functions in one configuration:
844 a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
845
846 This driver requires four bulk and two interrupt endpoints,
847 plus the ability to handle altsettings. Not all peripheral
848 controllers are that capable.
849
850 Say "y" to link the driver statically, or "m" to build a
851 dynamically linked module.
852
f358f5b4
FB
853config USB_G_NOKIA
854 tristate "Nokia composite gadget"
855 depends on PHONET
856 help
857 The Nokia composite gadget provides support for acm, obex
858 and phonet in only one composite gadget driver.
859
860 It's only really useful for N900 hardware. If you're building
861 a kernel for N900, say Y or M here. If unsure, say N.
862
f176a5d8
MN
863config USB_G_MULTI
864 tristate "Multifunction Composite Gadget (EXPERIMENTAL)"
5791e103 865 depends on BLOCK && NET
f176a5d8
MN
866 help
867 The Multifunction Composite Gadget provides Ethernet (RNDIS
868 and/or CDC Ethernet), mass storage and ACM serial link
869 interfaces.
870
5791e103 871 You will be asked to choose which of the two configurations is
f176a5d8 872 to be available in the gadget. At least one configuration must
5791e103 873 be chosen to make the gadget usable. Selecting more than one
f176a5d8 874 configuration will prevent Windows from automatically detecting
5791e103 875 the gadget as a composite gadget, so an INF file will be needed to
f176a5d8
MN
876 use the gadget.
877
878 Say "y" to link the driver statically, or "m" to build a
879 dynamically linked module called "g_multi".
880
881config USB_G_MULTI_RNDIS
882 bool "RNDIS + CDC Serial + Storage configuration"
883 depends on USB_G_MULTI
884 default y
885 help
886 This option enables a configuration with RNDIS, CDC Serial and
887 Mass Storage functions available in the Multifunction Composite
5791e103
RD
888 Gadget. This is the configuration dedicated for Windows since RNDIS
889 is Microsoft's protocol.
f176a5d8
MN
890
891 If unsure, say "y".
892
893config USB_G_MULTI_CDC
894 bool "CDC Ethernet + CDC Serial + Storage configuration"
895 depends on USB_G_MULTI
896 default n
897 help
898 This option enables a configuration with CDC Ethernet (ECM), CDC
899 Serial and Mass Storage functions available in the Multifunction
5791e103 900 Composite Gadget.
f176a5d8
MN
901
902 If unsure, say "y".
903
71adf118
FC
904config USB_G_HID
905 tristate "HID Gadget"
906 help
907 The HID gadget driver provides generic emulation of USB
908 Human Interface Devices (HID).
909
910 For more information, see Documentation/usb/gadget_hid.txt which
911 includes sample code for accessing the device files.
912
913 Say "y" to link the driver statically, or "m" to build a
914 dynamically linked module called "g_hid".
f176a5d8 915
1da177e4
LT
916# put drivers that need isochronous transfer support (for audio
917# or video class gadget drivers), or specific hardware, here.
a9914127
LP
918config USB_G_WEBCAM
919 tristate "USB Webcam Gadget"
24337c13 920 depends on VIDEO_DEV
a9914127
LP
921 help
922 The Webcam Gadget acts as a composite USB Audio and Video Class
923 device. It provides a userspace API to process UVC control requests
924 and stream video data to the host.
1da177e4 925
a9914127
LP
926 Say "y" to link the driver statically, or "m" to build a
927 dynamically linked module called "g_webcam".
1da177e4
LT
928
929endchoice
930
b75be4ab 931endif # USB_GADGET