usb/isp1760: Fix crash when unplugging bug
[deliverable/linux.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 160 select USB_GADGET_DUALSPEED
018b97d0 161 select USB_FSL_MPH_DR_OF if OF
b504882d
LY
162 help
163 Some of Freescale PowerPC processors have a High Speed
164 Dual-Role(DR) USB controller, which supports device mode.
165
166 The number of programmable endpoints is different through
167 SOC revisions.
168
169 Say "y" to link the driver statically, or "m" to build a
170 dynamically linked module called "fsl_usb2_udc" and force
171 all gadget drivers to also be dynamically linked.
172
173config USB_FSL_USB2
174 tristate
175 depends on USB_GADGET_FSL_USB2
176 default USB_GADGET
177 select USB_GADGET_SELECTED
178
0fe6f1d1
YHC
179config USB_GADGET_FUSB300
180 boolean "Faraday FUSB300 USB Peripheral Controller"
181 select USB_GADGET_DUALSPEED
182 help
183 Faraday usb device controller FUSB300 driver
184
185config USB_FUSB300
186 tristate
187 depends on USB_GADGET_FUSB300
188 default USB_GADGET
189 select USB_GADGET_SELECTED
190
a7a19fac
DB
191config USB_GADGET_LH7A40X
192 boolean "LH7A40X"
193 depends on ARCH_LH7A40X
1da177e4 194 help
a7a19fac
DB
195 This driver provides USB Device Controller driver for LH7A40x
196
197config USB_LH7A40X
198 tristate
199 depends on USB_GADGET_LH7A40X
200 default USB_GADGET
201 select USB_GADGET_SELECTED
202
203config USB_GADGET_OMAP
204 boolean "OMAP USB Device Controller"
205 depends on ARCH_OMAP
f1c9e151 206 select ISP1301_OMAP if MACH_OMAP_H2 || MACH_OMAP_H3 || MACH_OMAP_H4_OTG
54b9ed35 207 select USB_OTG_UTILS if ARCH_OMAP
a7a19fac
DB
208 help
209 Many Texas Instruments OMAP processors have flexible full
210 speed USB device controllers, with support for up to 30
211 endpoints (plus endpoint zero). This driver supports the
212 controller in the OMAP 1611, and should work with controllers
213 in other OMAP processors too, given minor tweaks.
1da177e4
LT
214
215 Say "y" to link the driver statically, or "m" to build a
a7a19fac 216 dynamically linked module called "omap_udc" and force all
1da177e4
LT
217 gadget drivers to also be dynamically linked.
218
a7a19fac 219config USB_OMAP
1da177e4 220 tristate
a7a19fac 221 depends on USB_GADGET_OMAP
1da177e4 222 default USB_GADGET
028b271b 223 select USB_GADGET_SELECTED
1da177e4 224
7a857620 225config USB_GADGET_PXA25X
1da177e4
LT
226 boolean "PXA 25x or IXP 4xx"
227 depends on (ARCH_PXA && PXA25x) || ARCH_IXP4XX
09963911 228 select USB_OTG_UTILS
1da177e4
LT
229 help
230 Intel's PXA 25x series XScale ARM-5TE processors include
231 an integrated full speed USB 1.1 device controller. The
232 controller in the IXP 4xx series is register-compatible.
233
234 It has fifteen fixed-function endpoints, as well as endpoint
235 zero (for control transfers).
236
237 Say "y" to link the driver statically, or "m" to build a
7a857620 238 dynamically linked module called "pxa25x_udc" and force all
1da177e4
LT
239 gadget drivers to also be dynamically linked.
240
7a857620 241config USB_PXA25X
1da177e4 242 tristate
7a857620 243 depends on USB_GADGET_PXA25X
1da177e4 244 default USB_GADGET
028b271b 245 select USB_GADGET_SELECTED
1da177e4
LT
246
247# if there's only one gadget driver, using only two bulk endpoints,
248# don't waste memory for the other endpoints
7a857620
PZ
249config USB_PXA25X_SMALL
250 depends on USB_GADGET_PXA25X
1da177e4
LT
251 bool
252 default n if USB_ETH_RNDIS
253 default y if USB_ZERO
254 default y if USB_ETH
255 default y if USB_G_SERIAL
256
c4144247
YS
257config USB_GADGET_R8A66597
258 boolean "Renesas R8A66597 USB Peripheral Controller"
259 select USB_GADGET_DUALSPEED
260 help
261 R8A66597 is a discrete USB host and peripheral controller chip that
262 supports both full and high speed USB 2.0 data transfers.
263 It has nine configurable endpoints, and endpoint zero.
264
265 Say "y" to link the driver statically, or "m" to build a
266 dynamically linked module called "r8a66597_udc" and force all
267 gadget drivers to also be dynamically linked.
268
269config USB_R8A66597
270 tristate
271 depends on USB_GADGET_R8A66597
272 default USB_GADGET
273 select USB_GADGET_SELECTED
274
d75379a5
RJ
275config USB_GADGET_PXA27X
276 boolean "PXA 27x"
9f5351b7 277 depends on ARCH_PXA && (PXA27x || PXA3xx)
7fec3c25 278 select USB_OTG_UTILS
d75379a5
RJ
279 help
280 Intel's PXA 27x series XScale ARM v5TE processors include
281 an integrated full speed USB 1.1 device controller.
282
283 It has up to 23 endpoints, as well as endpoint zero (for
284 control transfers).
285
286 Say "y" to link the driver statically, or "m" to build a
287 dynamically linked module called "pxa27x_udc" and force all
288 gadget drivers to also be dynamically linked.
289
290config USB_PXA27X
291 tristate
292 depends on USB_GADGET_PXA27X
293 default USB_GADGET
294 select USB_GADGET_SELECTED
295
5b7d70c6
BD
296config USB_GADGET_S3C_HSOTG
297 boolean "S3C HS/OtG USB Device controller"
298 depends on S3C_DEV_USB_HSOTG
299 select USB_GADGET_S3C_HSOTG_PIO
0287e43d 300 select USB_GADGET_DUALSPEED
5b7d70c6
BD
301 help
302 The Samsung S3C64XX USB2.0 high-speed gadget controller
303 integrated into the S3C64XX series SoC.
304
305config USB_S3C_HSOTG
306 tristate
307 depends on USB_GADGET_S3C_HSOTG
308 default USB_GADGET
309 select USB_GADGET_SELECTED
310
c03e7d4b
PZ
311config USB_GADGET_IMX
312 boolean "Freescale IMX USB Peripheral Controller"
313 depends on ARCH_MX1
314 help
315 Freescale's IMX series include an integrated full speed
316 USB 1.1 device controller. The controller in the IMX series
317 is register-compatible.
318
319 It has Six fixed-function endpoints, as well as endpoint
320 zero (for control transfers).
321
322 Say "y" to link the driver statically, or "m" to build a
323 dynamically linked module called "imx_udc" and force all
324 gadget drivers to also be dynamically linked.
325
326config USB_IMX
327 tristate
328 depends on USB_GADGET_IMX
329 default USB_GADGET
330 select USB_GADGET_SELECTED
331
a7a19fac
DB
332config USB_GADGET_S3C2410
333 boolean "S3C2410 USB Device Controller"
334 depends on ARCH_S3C2410
1da177e4 335 help
a7a19fac
DB
336 Samsung's S3C2410 is an ARM-4 processor with an integrated
337 full speed USB 1.1 device controller. It has 4 configurable
338 endpoints, as well as endpoint zero (for control transfers).
1da177e4 339
a7a19fac
DB
340 This driver has been tested on the S3C2410, S3C2412, and
341 S3C2440 processors.
1da177e4 342
a7a19fac 343config USB_S3C2410
1da177e4 344 tristate
a7a19fac 345 depends on USB_GADGET_S3C2410
1da177e4 346 default USB_GADGET
028b271b 347 select USB_GADGET_SELECTED
1da177e4 348
a7a19fac
DB
349config USB_S3C2410_DEBUG
350 boolean "S3C2410 udc debug messages"
351 depends on USB_GADGET_S3C2410
1da177e4 352
e7cddda4 353config USB_GADGET_PXA_U2O
354 boolean "PXA9xx Processor USB2.0 controller"
355 select USB_GADGET_DUALSPEED
356 help
357 PXA9xx Processor series include a high speed USB2.0 device
358 controller, which support high speed and full speed USB peripheral.
359
360config USB_PXA_U2O
361 tristate
362 depends on USB_GADGET_PXA_U2O
363 default USB_GADGET
364 select USB_GADGET_SELECTED
365
a7a19fac
DB
366#
367# Controllers available in both integrated and discrete versions
368#
1da177e4 369
a7a19fac 370# musb builds in ../musb along with host support
550a7375 371config USB_GADGET_MUSB_HDRC
085ad406 372 boolean "Inventra HDRC USB Peripheral (TI, ADI, ...)"
550a7375
FB
373 depends on USB_MUSB_HDRC && (USB_MUSB_PERIPHERAL || USB_MUSB_OTG)
374 select USB_GADGET_DUALSPEED
375 select USB_GADGET_SELECTED
376 help
377 This OTG-capable silicon IP is used in dual designs including
085ad406 378 the TI DaVinci, OMAP 243x, OMAP 343x, TUSB 6010, and ADI Blackfin
550a7375 379
a7a19fac
DB
380config USB_GADGET_M66592
381 boolean "Renesas M66592 USB Peripheral Controller"
382 select USB_GADGET_DUALSPEED
1da177e4 383 help
a7a19fac
DB
384 M66592 is a discrete USB peripheral controller chip that
385 supports both full and high speed USB 2.0 data transfers.
386 It has seven configurable endpoints, and endpoint zero.
1da177e4
LT
387
388 Say "y" to link the driver statically, or "m" to build a
a7a19fac 389 dynamically linked module called "m66592_udc" and force all
1da177e4
LT
390 gadget drivers to also be dynamically linked.
391
a7a19fac 392config USB_M66592
1da177e4 393 tristate
a7a19fac 394 depends on USB_GADGET_M66592
1da177e4 395 default USB_GADGET
028b271b 396 select USB_GADGET_SELECTED
1da177e4 397
a7a19fac
DB
398#
399# Controllers available only in discrete form (and all PCI controllers)
400#
401
402config USB_GADGET_AMD5536UDC
403 boolean "AMD5536 UDC"
404 depends on PCI
405 select USB_GADGET_DUALSPEED
3fc154b6 406 help
a7a19fac
DB
407 The AMD5536 UDC is part of the AMD Geode CS5536, an x86 southbridge.
408 It is a USB Highspeed DMA capable USB device controller. Beside ep0
409 it provides 4 IN and 4 OUT endpoints (bulk or interrupt type).
410 The UDC port supports OTG operation, and may be used as a host port
411 if it's not being used to implement peripheral or OTG roles.
3fc154b6 412
a7a19fac
DB
413 Say "y" to link the driver statically, or "m" to build a
414 dynamically linked module called "amd5536udc" and force all
415 gadget drivers to also be dynamically linked.
3fc154b6 416
a7a19fac 417config USB_AMD5536UDC
3fc154b6 418 tristate
a7a19fac 419 depends on USB_GADGET_AMD5536UDC
3fc154b6
AP
420 default USB_GADGET
421 select USB_GADGET_SELECTED
422
3948f0e0
LY
423config USB_GADGET_FSL_QE
424 boolean "Freescale QE/CPM USB Device Controller"
425 depends on FSL_SOC && (QUICC_ENGINE || CPM)
426 help
427 Some of Freescale PowerPC processors have a Full Speed
428 QE/CPM2 USB controller, which support device mode with 4
429 programmable endpoints. This driver supports the
430 controller in the MPC8360 and MPC8272, and should work with
431 controllers having QE or CPM2, given minor tweaks.
432
433 Set CONFIG_USB_GADGET to "m" to build this driver as a
692105b8 434 dynamically linked module called "fsl_qe_udc".
3948f0e0
LY
435
436config USB_FSL_QE
437 tristate
438 depends on USB_GADGET_FSL_QE
439 default USB_GADGET
440 select USB_GADGET_SELECTED
441
409a15da
PK
442config USB_GADGET_CI13XXX_PCI
443 boolean "MIPS USB CI13xxx PCI UDC"
aa69a809
DL
444 depends on PCI
445 select USB_GADGET_DUALSPEED
446 help
447 MIPS USB IP core family device controller
448 Currently it only supports IP part number CI13412
449
450 Say "y" to link the driver statically, or "m" to build a
451 dynamically linked module called "ci13xxx_udc" and force all
452 gadget drivers to also be dynamically linked.
453
409a15da 454config USB_CI13XXX_PCI
aa69a809 455 tristate
409a15da 456 depends on USB_GADGET_CI13XXX_PCI
aa69a809
DL
457 default USB_GADGET
458 select USB_GADGET_SELECTED
459
a7a19fac
DB
460config USB_GADGET_NET2280
461 boolean "NetChip 228x"
462 depends on PCI
463 select USB_GADGET_DUALSPEED
464 help
465 NetChip 2280 / 2282 is a PCI based USB peripheral controller which
466 supports both full and high speed USB 2.0 data transfers.
3fc154b6 467
a7a19fac
DB
468 It has six configurable endpoints, as well as endpoint zero
469 (for control transfers) and several endpoints with dedicated
470 functions.
471
472 Say "y" to link the driver statically, or "m" to build a
473 dynamically linked module called "net2280" and force all
474 gadget drivers to also be dynamically linked.
475
476config USB_NET2280
477 tristate
478 depends on USB_GADGET_NET2280
479 default USB_GADGET
bae4bd84 480 select USB_GADGET_SELECTED
a7a19fac
DB
481
482config USB_GADGET_GOKU
483 boolean "Toshiba TC86C001 'Goku-S'"
484 depends on PCI
bae4bd84 485 help
a7a19fac
DB
486 The Toshiba TC86C001 is a PCI device which includes controllers
487 for full speed USB devices, IDE, I2C, SIO, plus a USB host (OHCI).
488
489 The device controller has three configurable (bulk or interrupt)
490 endpoints, plus endpoint zero (for control transfers).
bae4bd84
DB
491
492 Say "y" to link the driver statically, or "m" to build a
a7a19fac 493 dynamically linked module called "goku_udc" and to force all
bae4bd84
DB
494 gadget drivers to also be dynamically linked.
495
a7a19fac 496config USB_GOKU
bae4bd84 497 tristate
a7a19fac 498 depends on USB_GADGET_GOKU
bae4bd84 499 default USB_GADGET
a7a19fac
DB
500 select USB_GADGET_SELECTED
501
5be19a9d
XS
502config USB_GADGET_LANGWELL
503 boolean "Intel Langwell USB Device Controller"
504 depends on PCI
505 select USB_GADGET_DUALSPEED
506 help
507 Intel Langwell USB Device Controller is a High-Speed USB
508 On-The-Go device controller.
509
510 The number of programmable endpoints is different through
511 controller revision.
512
513 Say "y" to link the driver statically, or "m" to build a
514 dynamically linked module called "langwell_udc" and force all
515 gadget drivers to also be dynamically linked.
516
517config USB_LANGWELL
518 tristate
519 depends on USB_GADGET_LANGWELL
520 default USB_GADGET
521 select USB_GADGET_SELECTED
522
f646cf94 523config USB_GADGET_EG20T
06f1b971 524 boolean "Intel EG20T PCH/OKI SEMICONDUCTOR ML7213 IOH UDC"
f646cf94
TO
525 depends on PCI
526 select USB_GADGET_DUALSPEED
527 help
528 This is a USB device driver for EG20T PCH.
529 EG20T PCH is the platform controller hub that is used in Intel's
530 general embedded platform. EG20T PCH has USB device interface.
531 Using this interface, it is able to access system devices connected
532 to USB device.
533 This driver enables USB device function.
534 USB device is a USB peripheral controller which
535 supports both full and high speed USB 2.0 data transfers.
536 This driver supports both control transfer and bulk transfer modes.
537 This driver dose not support interrupt transfer or isochronous
538 transfer modes.
539
06f1b971
TM
540 This driver also can be used for OKI SEMICONDUCTOR's ML7213 which is
541 for IVI(In-Vehicle Infotainment) use.
542 ML7213 is companion chip for Intel Atom E6xx series.
543 ML7213 is completely compatible for Intel EG20T PCH.
544
f646cf94
TO
545config USB_EG20T
546 tristate
547 depends on USB_GADGET_EG20T
548 default USB_GADGET
549 select USB_GADGET_SELECTED
a7a19fac 550
33f82f38
PK
551config USB_GADGET_CI13XXX_MSM
552 boolean "MIPS USB CI13xxx for MSM"
553 depends on ARCH_MSM
554 select USB_GADGET_DUALSPEED
555 select USB_MSM_OTG_72K
556 help
557 MSM SoC has chipidea USB controller. This driver uses
558 ci13xxx_udc core.
559 This driver depends on OTG driver for PHY initialization,
560 clock management, powering up VBUS, and power management.
8cf28f1f
PK
561 This driver is not supported on boards like trout which
562 has an external PHY.
33f82f38
PK
563
564 Say "y" to link the driver statically, or "m" to build a
565 dynamically linked module called "ci13xxx_msm" and force all
566 gadget drivers to also be dynamically linked.
567
568config USB_CI13XXX_MSM
569 tristate
570 depends on USB_GADGET_CI13XXX_MSM
571 default USB_GADGET
572 select USB_GADGET_SELECTED
a7a19fac
DB
573
574#
575# LAST -- dummy/emulated controller
576#
1da177e4
LT
577
578config USB_GADGET_DUMMY_HCD
579 boolean "Dummy HCD (DEVELOPMENT)"
afd0e0f2 580 depends on USB=y || (USB=m && USB_GADGET=m)
1da177e4
LT
581 select USB_GADGET_DUALSPEED
582 help
583 This host controller driver emulates USB, looping all data transfer
584 requests back to a USB "gadget driver" in the same host. The host
585 side is the master; the gadget side is the slave. Gadget drivers
586 can be high, full, or low speed; and they have access to endpoints
587 like those from NET2280, PXA2xx, or SA1100 hardware.
588
589 This may help in some stages of creating a driver to embed in a
590 Linux device, since it lets you debug several parts of the gadget
591 driver without its hardware or drivers being involved.
592
593 Since such a gadget side driver needs to interoperate with a host
594 side Linux-USB device driver, this may help to debug both sides
595 of a USB protocol stack.
596
597 Say "y" to link the driver statically, or "m" to build a
598 dynamically linked module called "dummy_hcd" and force all
599 gadget drivers to also be dynamically linked.
600
601config USB_DUMMY_HCD
602 tristate
603 depends on USB_GADGET_DUMMY_HCD
604 default USB_GADGET
028b271b 605 select USB_GADGET_SELECTED
1da177e4
LT
606
607# NOTE: Please keep dummy_hcd LAST so that "real hardware" appears
608# first and will be selected by default.
609
610endchoice
611
612config USB_GADGET_DUALSPEED
613 bool
614 depends on USB_GADGET
615 default n
616 help
617 Means that gadget drivers should include extra descriptors
618 and code to handle dual-speed controllers.
619
620#
621# USB Gadget Drivers
622#
623choice
624 tristate "USB Gadget Drivers"
028b271b 625 depends on USB_GADGET && USB_GADGET_SELECTED
1da177e4
LT
626 default USB_ETH
627 help
628 A Linux "Gadget Driver" talks to the USB Peripheral Controller
629 driver through the abstract "gadget" API. Some other operating
630 systems call these "client" drivers, of which "class drivers"
631 are a subset (implementing a USB device class specification).
632 A gadget driver implements one or more USB functions using
633 the peripheral hardware.
634
635 Gadget drivers are hardware-neutral, or "platform independent",
636 except that they sometimes must understand quirks or limitations
637 of the particular controllers they work with. For example, when
638 a controller doesn't support alternate configurations or provide
639 enough of the right types of endpoints, the gadget driver might
640 not be able work with that controller, or might need to implement
641 a less common variant of a device class protocol.
642
643# this first set of drivers all depend on bulk-capable hardware.
644
645config USB_ZERO
646 tristate "Gadget Zero (DEVELOPMENT)"
1da177e4
LT
647 help
648 Gadget Zero is a two-configuration device. It either sinks and
649 sources bulk data; or it loops back a configurable number of
650 transfers. It also implements control requests, for "chapter 9"
651 conformance. The driver needs only two bulk-capable endpoints, so
652 it can work on top of most device-side usb controllers. It's
653 useful for testing, and is also a working example showing how
654 USB "gadget drivers" can be written.
655
656 Make this be the first driver you try using on top of any new
657 USB peripheral controller driver. Then you can use host-side
658 test software, like the "usbtest" driver, to put your hardware
659 and its driver through a basic set of functional tests.
660
661 Gadget Zero also works with the host-side "usb-skeleton" driver,
662 and with many kinds of host-side test software. You may need
663 to tweak product and vendor IDs before host software knows about
664 this device, and arrange to select an appropriate configuration.
665
666 Say "y" to link the driver statically, or "m" to build a
667 dynamically linked module called "g_zero".
668
669config USB_ZERO_HNPTEST
670 boolean "HNP Test Device"
671 depends on USB_ZERO && USB_OTG
672 help
673 You can configure this device to enumerate using the device
674 identifiers of the USB-OTG test device. That means that when
675 this gadget connects to another OTG device, with this one using
676 the "B-Peripheral" role, that device will use HNP to let this
677 one serve as the USB host instead (in the "B-Host" role).
678
c6994e6f
BW
679config USB_AUDIO
680 tristate "Audio Gadget (EXPERIMENTAL)"
681 depends on SND
04950737 682 select SND_PCM
c6994e6f
BW
683 help
684 Gadget Audio is compatible with USB Audio Class specification 1.0.
685 It will include at least one AudioControl interface, zero or more
686 AudioStream interface and zero or more MIDIStream interface.
687
688 Gadget Audio will use on-board ALSA (CONFIG_SND) audio card to
689 playback or capture audio stream.
690
691 Say "y" to link the driver statically, or "m" to build a
692 dynamically linked module called "g_audio".
693
1da177e4
LT
694config USB_ETH
695 tristate "Ethernet Gadget (with CDC Ethernet support)"
696 depends on NET
9e221be8 697 select CRC32
1da177e4 698 help
9b39e9dd
BN
699 This driver implements Ethernet style communication, in one of
700 several ways:
1da177e4
LT
701
702 - The "Communication Device Class" (CDC) Ethernet Control Model.
703 That protocol is often avoided with pure Ethernet adapters, in
704 favor of simpler vendor-specific hardware, but is widely
705 supported by firmware for smart network devices.
706
707 - On hardware can't implement that protocol, a simple CDC subset
708 is used, placing fewer demands on USB.
709
9b39e9dd
BN
710 - CDC Ethernet Emulation Model (EEM) is a newer standard that has
711 a simpler interface that can be used by more USB hardware.
712
713 RNDIS support is an additional option, more demanding than than
714 subset.
1da177e4
LT
715
716 Within the USB device, this gadget driver exposes a network device
717 "usbX", where X depends on what other networking devices you have.
718 Treat it like a two-node Ethernet link: host, and gadget.
719
720 The Linux-USB host-side "usbnet" driver interoperates with this
721 driver, so that deep I/O queues can be supported. On 2.4 kernels,
722 use "CDCEther" instead, if you're using the CDC option. That CDC
723 mode should also interoperate with standard CDC Ethernet class
724 drivers on other host operating systems.
725
726 Say "y" to link the driver statically, or "m" to build a
727 dynamically linked module called "g_ether".
728
729config USB_ETH_RNDIS
afd0e0f2
RD
730 bool "RNDIS support"
731 depends on USB_ETH
1da177e4
LT
732 default y
733 help
734 Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
735 and Microsoft provides redistributable binary RNDIS drivers for
736 older versions of Windows.
737
738 If you say "y" here, the Ethernet gadget driver will try to provide
739 a second device configuration, supporting RNDIS to talk to such
740 Microsoft USB hosts.
741
742 To make MS-Windows work with this, use Documentation/usb/linux.inf
743 as the "driver info file". For versions of MS-Windows older than
744 XP, you'll need to download drivers from Microsoft's website; a URL
745 is given in comments found in that info file.
746
9b39e9dd
BN
747config USB_ETH_EEM
748 bool "Ethernet Emulation Model (EEM) support"
749 depends on USB_ETH
750 default n
751 help
752 CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
753 and therefore can be supported by more hardware. Technically ECM and
754 EEM are designed for different applications. The ECM model extends
755 the network interface to the target (e.g. a USB cable modem), and the
756 EEM model is for mobile devices to communicate with hosts using
757 ethernet over USB. For Linux gadgets, however, the interface with
758 the host is the same (a usbX device), so the differences are minimal.
759
760 If you say "y" here, the Ethernet gadget driver will use the EEM
761 protocol rather than ECM. If unsure, say "n".
762
6c34d288
YK
763config USB_G_NCM
764 tristate "Network Control Model (NCM) support"
765 depends on NET
766 select CRC32
767 help
768 This driver implements USB CDC NCM subclass standard. NCM is
769 an advanced protocol for Ethernet encapsulation, allows grouping
770 of several ethernet frames into one USB transfer and diffferent
771 alignment possibilities.
772
773 Say "y" to link the driver statically, or "m" to build a
774 dynamically linked module called "g_ncm".
775
1da177e4
LT
776config USB_GADGETFS
777 tristate "Gadget Filesystem (EXPERIMENTAL)"
778 depends on EXPERIMENTAL
779 help
780 This driver provides a filesystem based API that lets user mode
781 programs implement a single-configuration USB device, including
782 endpoint I/O and control requests that don't relate to enumeration.
783 All endpoints, transfer speeds, and transfer types supported by
784 the hardware are available, through read() and write() calls.
785
afd0e0f2
RD
786 Currently, this option is still labelled as EXPERIMENTAL because
787 of existing race conditions in the underlying in-kernel AIO core.
788
1da177e4
LT
789 Say "y" to link the driver statically, or "m" to build a
790 dynamically linked module called "gadgetfs".
791
c6c56008
MN
792config USB_FUNCTIONFS
793 tristate "Function Filesystem (EXPERIMENTAL)"
794 depends on EXPERIMENTAL
f8dae531 795 select USB_FUNCTIONFS_GENERIC if !(USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
c6c56008 796 help
eabf0f5f
MP
797 The Function Filesystem (FunctionFS) lets one create USB
798 composite functions in user space in the same way GadgetFS
c6c56008
MN
799 lets one create USB gadgets in user space. This allows creation
800 of composite gadgets such that some of the functions are
801 implemented in kernel space (for instance Ethernet, serial or
802 mass storage) and other are implemented in user space.
803
f8dae531
MN
804 If you say "y" or "m" here you will be able what kind of
805 configurations the gadget will provide.
806
c6c56008
MN
807 Say "y" to link the driver statically, or "m" to build
808 a dynamically linked module called "g_ffs".
809
810config USB_FUNCTIONFS_ETH
f8dae531 811 bool "Include configuration with CDC ECM (Ethernet)"
17b2765e 812 depends on USB_FUNCTIONFS && NET
c6c56008 813 help
eabf0f5f
MP
814 Include a configuration with CDC ECM function (Ethernet) and the
815 Function Filesystem.
c6c56008
MN
816
817config USB_FUNCTIONFS_RNDIS
f8dae531 818 bool "Include configuration with RNDIS (Ethernet)"
17b2765e 819 depends on USB_FUNCTIONFS && NET
c6c56008 820 help
eabf0f5f 821 Include a configuration with RNDIS function (Ethernet) and the Filesystem.
c6c56008
MN
822
823config USB_FUNCTIONFS_GENERIC
824 bool "Include 'pure' configuration"
f8dae531 825 depends on USB_FUNCTIONFS
c6c56008 826 help
f8dae531
MN
827 Include a configuration with the Function Filesystem alone with
828 no Ethernet interface.
c6c56008 829
1da177e4
LT
830config USB_FILE_STORAGE
831 tristate "File-backed Storage Gadget"
87840289 832 depends on BLOCK
1da177e4
LT
833 help
834 The File-backed Storage Gadget acts as a USB Mass Storage
835 disk drive. As its storage repository it can use a regular
836 file or a block device (in much the same way as the "loop"
837 device driver), specified as a module parameter.
838
839 Say "y" to link the driver statically, or "m" to build a
840 dynamically linked module called "g_file_storage".
841
842config USB_FILE_STORAGE_TEST
843 bool "File-backed Storage Gadget testing version"
844 depends on USB_FILE_STORAGE
845 default n
846 help
847 Say "y" to generate the larger testing version of the
848 File-backed Storage Gadget, useful for probing the
849 behavior of USB Mass Storage hosts. Not needed for
850 normal operation.
851
d23b0f08
MN
852config USB_MASS_STORAGE
853 tristate "Mass Storage Gadget"
854 depends on BLOCK
855 help
856 The Mass Storage Gadget acts as a USB Mass Storage disk drive.
857 As its storage repository it can use a regular file or a block
858 device (in much the same way as the "loop" device driver),
859 specified as a module parameter or sysfs option.
860
861 This is heavily based on File-backed Storage Gadget and in most
862 cases you will want to use FSG instead. This gadget is mostly
863 here to test the functionality of the Mass Storage Function
864 which may be used with composite framework.
865
866 Say "y" to link the driver statically, or "m" to build
11b10d99 867 a dynamically linked module called "g_mass_storage". If unsure,
d23b0f08
MN
868 consider File-backed Storage Gadget.
869
1da177e4 870config USB_G_SERIAL
3086775a 871 tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
1da177e4
LT
872 help
873 The Serial Gadget talks to the Linux-USB generic serial driver.
874 This driver supports a CDC-ACM module option, which can be used
875 to interoperate with MS-Windows hosts or with the Linux-USB
876 "cdc-acm" driver.
877
3086775a
FB
878 This driver also supports a CDC-OBEX option. You will need a
879 user space OBEX server talking to /dev/ttyGS*, since the kernel
880 itself doesn't implement the OBEX protocol.
881
1da177e4
LT
882 Say "y" to link the driver statically, or "m" to build a
883 dynamically linked module called "g_serial".
884
885 For more information, see Documentation/usb/gadget_serial.txt
886 which includes instructions and a "driver info file" needed to
3086775a 887 make MS-Windows work with CDC ACM.
1da177e4 888
f2ebf92c
BW
889config USB_MIDI_GADGET
890 tristate "MIDI Gadget (EXPERIMENTAL)"
891 depends on SND && EXPERIMENTAL
892 select SND_RAWMIDI
893 help
894 The MIDI Gadget acts as a USB Audio device, with one MIDI
895 input and one MIDI output. These MIDI jacks appear as
896 a sound "card" in the ALSA sound system. Other MIDI
897 connections can then be made on the gadget system, using
898 ALSA's aconnect utility etc.
899
900 Say "y" to link the driver statically, or "m" to build a
901 dynamically linked module called "g_midi".
902
25a010c8
CN
903config USB_G_PRINTER
904 tristate "Printer Gadget"
905 help
906 The Printer Gadget channels data between the USB host and a
907 userspace program driving the print engine. The user space
908 program reads and writes the device file /dev/g_printer to
909 receive or send printer data. It can use ioctl calls to
910 the device file to get or set printer status.
911
912 Say "y" to link the driver statically, or "m" to build a
913 dynamically linked module called "g_printer".
914
915 For more information, see Documentation/usb/gadget_printer.txt
916 which includes sample code for accessing the device file.
1da177e4 917
19e20680
DB
918config USB_CDC_COMPOSITE
919 tristate "CDC Composite Device (Ethernet and ACM)"
4ddd9ec1 920 depends on NET
19e20680
DB
921 help
922 This driver provides two functions in one configuration:
923 a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
924
925 This driver requires four bulk and two interrupt endpoints,
926 plus the ability to handle altsettings. Not all peripheral
927 controllers are that capable.
928
929 Say "y" to link the driver statically, or "m" to build a
930 dynamically linked module.
931
f358f5b4
FB
932config USB_G_NOKIA
933 tristate "Nokia composite gadget"
934 depends on PHONET
935 help
936 The Nokia composite gadget provides support for acm, obex
937 and phonet in only one composite gadget driver.
938
939 It's only really useful for N900 hardware. If you're building
940 a kernel for N900, say Y or M here. If unsure, say N.
941
f176a5d8
MN
942config USB_G_MULTI
943 tristate "Multifunction Composite Gadget (EXPERIMENTAL)"
5791e103 944 depends on BLOCK && NET
279cc49a 945 select USB_G_MULTI_CDC if !USB_G_MULTI_RNDIS
f176a5d8
MN
946 help
947 The Multifunction Composite Gadget provides Ethernet (RNDIS
948 and/or CDC Ethernet), mass storage and ACM serial link
949 interfaces.
950
5791e103 951 You will be asked to choose which of the two configurations is
f176a5d8 952 to be available in the gadget. At least one configuration must
5791e103 953 be chosen to make the gadget usable. Selecting more than one
f176a5d8 954 configuration will prevent Windows from automatically detecting
5791e103 955 the gadget as a composite gadget, so an INF file will be needed to
f176a5d8
MN
956 use the gadget.
957
958 Say "y" to link the driver statically, or "m" to build a
959 dynamically linked module called "g_multi".
960
961config USB_G_MULTI_RNDIS
962 bool "RNDIS + CDC Serial + Storage configuration"
963 depends on USB_G_MULTI
964 default y
965 help
966 This option enables a configuration with RNDIS, CDC Serial and
967 Mass Storage functions available in the Multifunction Composite
5791e103
RD
968 Gadget. This is the configuration dedicated for Windows since RNDIS
969 is Microsoft's protocol.
f176a5d8
MN
970
971 If unsure, say "y".
972
973config USB_G_MULTI_CDC
974 bool "CDC Ethernet + CDC Serial + Storage configuration"
975 depends on USB_G_MULTI
976 default n
977 help
978 This option enables a configuration with CDC Ethernet (ECM), CDC
979 Serial and Mass Storage functions available in the Multifunction
5791e103 980 Composite Gadget.
f176a5d8
MN
981
982 If unsure, say "y".
983
71adf118
FC
984config USB_G_HID
985 tristate "HID Gadget"
986 help
987 The HID gadget driver provides generic emulation of USB
988 Human Interface Devices (HID).
989
990 For more information, see Documentation/usb/gadget_hid.txt which
991 includes sample code for accessing the device files.
992
993 Say "y" to link the driver statically, or "m" to build a
994 dynamically linked module called "g_hid".
f176a5d8 995
f6c826a9 996config USB_G_DBGP
997 tristate "EHCI Debug Device Gadget"
998 help
999 This gadget emulates an EHCI Debug device. This is useful when you want
1000 to interact with an EHCI Debug Port.
1001
1002 Say "y" to link the driver statically, or "m" to build a
1003 dynamically linked module called "g_dbgp".
1004
1005if USB_G_DBGP
1006choice
1007 prompt "EHCI Debug Device mode"
1008 default USB_G_DBGP_SERIAL
1009
1010config USB_G_DBGP_PRINTK
1011 depends on USB_G_DBGP
1012 bool "printk"
1013 help
1014 Directly printk() received data. No interaction.
1015
1016config USB_G_DBGP_SERIAL
1017 depends on USB_G_DBGP
1018 bool "serial"
1019 help
1020 Userland can interact using /dev/ttyGSxxx.
1021endchoice
1022endif
1023
1da177e4
LT
1024# put drivers that need isochronous transfer support (for audio
1025# or video class gadget drivers), or specific hardware, here.
a9914127
LP
1026config USB_G_WEBCAM
1027 tristate "USB Webcam Gadget"
24337c13 1028 depends on VIDEO_DEV
a9914127
LP
1029 help
1030 The Webcam Gadget acts as a composite USB Audio and Video Class
1031 device. It provides a userspace API to process UVC control requests
1032 and stream video data to the host.
1da177e4 1033
a9914127
LP
1034 Say "y" to link the driver statically, or "m" to build a
1035 dynamically linked module called "g_webcam".
1da177e4
LT
1036
1037endchoice
1038
b75be4ab 1039endif # USB_GADGET
This page took 0.636803 seconds and 5 git commands to generate.