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