usb: renesas_usbhs: Add Renesas USBHS common code
[GitHub/mt8127/android_kernel_alcatel_ttab.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_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
409a15da
PK
430config USB_GADGET_CI13XXX_PCI
431 boolean "MIPS USB CI13xxx PCI UDC"
aa69a809
DL
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
409a15da 442config USB_CI13XXX_PCI
aa69a809 443 tristate
409a15da 444 depends on USB_GADGET_CI13XXX_PCI
aa69a809
DL
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 511config USB_GADGET_EG20T
06f1b971 512 boolean "Intel EG20T PCH/OKI SEMICONDUCTOR ML7213 IOH UDC"
f646cf94
TO
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
06f1b971
TM
528 This driver also can be used for OKI SEMICONDUCTOR's ML7213 which is
529 for IVI(In-Vehicle Infotainment) use.
530 ML7213 is companion chip for Intel Atom E6xx series.
531 ML7213 is completely compatible for Intel EG20T PCH.
532
f646cf94
TO
533config USB_EG20T
534 tristate
535 depends on USB_GADGET_EG20T
536 default USB_GADGET
537 select USB_GADGET_SELECTED
a7a19fac 538
33f82f38
PK
539config USB_GADGET_CI13XXX_MSM
540 boolean "MIPS USB CI13xxx for MSM"
541 depends on ARCH_MSM
542 select USB_GADGET_DUALSPEED
dfb2130c 543 select USB_MSM_OTG
33f82f38
PK
544 help
545 MSM SoC has chipidea USB controller. This driver uses
546 ci13xxx_udc core.
547 This driver depends on OTG driver for PHY initialization,
548 clock management, powering up VBUS, and power management.
8cf28f1f
PK
549 This driver is not supported on boards like trout which
550 has an external PHY.
33f82f38
PK
551
552 Say "y" to link the driver statically, or "m" to build a
553 dynamically linked module called "ci13xxx_msm" and force all
554 gadget drivers to also be dynamically linked.
555
556config USB_CI13XXX_MSM
557 tristate
558 depends on USB_GADGET_CI13XXX_MSM
559 default USB_GADGET
560 select USB_GADGET_SELECTED
a7a19fac
DB
561
562#
563# LAST -- dummy/emulated controller
564#
1da177e4
LT
565
566config USB_GADGET_DUMMY_HCD
567 boolean "Dummy HCD (DEVELOPMENT)"
afd0e0f2 568 depends on USB=y || (USB=m && USB_GADGET=m)
1da177e4
LT
569 select USB_GADGET_DUALSPEED
570 help
571 This host controller driver emulates USB, looping all data transfer
572 requests back to a USB "gadget driver" in the same host. The host
573 side is the master; the gadget side is the slave. Gadget drivers
574 can be high, full, or low speed; and they have access to endpoints
575 like those from NET2280, PXA2xx, or SA1100 hardware.
576
577 This may help in some stages of creating a driver to embed in a
578 Linux device, since it lets you debug several parts of the gadget
579 driver without its hardware or drivers being involved.
580
581 Since such a gadget side driver needs to interoperate with a host
582 side Linux-USB device driver, this may help to debug both sides
583 of a USB protocol stack.
584
585 Say "y" to link the driver statically, or "m" to build a
586 dynamically linked module called "dummy_hcd" and force all
587 gadget drivers to also be dynamically linked.
588
589config USB_DUMMY_HCD
590 tristate
591 depends on USB_GADGET_DUMMY_HCD
592 default USB_GADGET
028b271b 593 select USB_GADGET_SELECTED
1da177e4
LT
594
595# NOTE: Please keep dummy_hcd LAST so that "real hardware" appears
596# first and will be selected by default.
597
598endchoice
599
600config USB_GADGET_DUALSPEED
601 bool
602 depends on USB_GADGET
603 default n
604 help
605 Means that gadget drivers should include extra descriptors
606 and code to handle dual-speed controllers.
607
608#
609# USB Gadget Drivers
610#
611choice
612 tristate "USB Gadget Drivers"
028b271b 613 depends on USB_GADGET && USB_GADGET_SELECTED
1da177e4
LT
614 default USB_ETH
615 help
616 A Linux "Gadget Driver" talks to the USB Peripheral Controller
617 driver through the abstract "gadget" API. Some other operating
618 systems call these "client" drivers, of which "class drivers"
619 are a subset (implementing a USB device class specification).
620 A gadget driver implements one or more USB functions using
621 the peripheral hardware.
622
623 Gadget drivers are hardware-neutral, or "platform independent",
624 except that they sometimes must understand quirks or limitations
625 of the particular controllers they work with. For example, when
626 a controller doesn't support alternate configurations or provide
627 enough of the right types of endpoints, the gadget driver might
628 not be able work with that controller, or might need to implement
629 a less common variant of a device class protocol.
630
631# this first set of drivers all depend on bulk-capable hardware.
632
633config USB_ZERO
634 tristate "Gadget Zero (DEVELOPMENT)"
1da177e4
LT
635 help
636 Gadget Zero is a two-configuration device. It either sinks and
637 sources bulk data; or it loops back a configurable number of
638 transfers. It also implements control requests, for "chapter 9"
639 conformance. The driver needs only two bulk-capable endpoints, so
640 it can work on top of most device-side usb controllers. It's
641 useful for testing, and is also a working example showing how
642 USB "gadget drivers" can be written.
643
644 Make this be the first driver you try using on top of any new
645 USB peripheral controller driver. Then you can use host-side
646 test software, like the "usbtest" driver, to put your hardware
647 and its driver through a basic set of functional tests.
648
649 Gadget Zero also works with the host-side "usb-skeleton" driver,
650 and with many kinds of host-side test software. You may need
651 to tweak product and vendor IDs before host software knows about
652 this device, and arrange to select an appropriate configuration.
653
654 Say "y" to link the driver statically, or "m" to build a
655 dynamically linked module called "g_zero".
656
657config USB_ZERO_HNPTEST
658 boolean "HNP Test Device"
659 depends on USB_ZERO && USB_OTG
660 help
661 You can configure this device to enumerate using the device
662 identifiers of the USB-OTG test device. That means that when
663 this gadget connects to another OTG device, with this one using
664 the "B-Peripheral" role, that device will use HNP to let this
665 one serve as the USB host instead (in the "B-Host" role).
666
c6994e6f
BW
667config USB_AUDIO
668 tristate "Audio Gadget (EXPERIMENTAL)"
669 depends on SND
04950737 670 select SND_PCM
c6994e6f
BW
671 help
672 Gadget Audio is compatible with USB Audio Class specification 1.0.
673 It will include at least one AudioControl interface, zero or more
674 AudioStream interface and zero or more MIDIStream interface.
675
676 Gadget Audio will use on-board ALSA (CONFIG_SND) audio card to
677 playback or capture audio stream.
678
679 Say "y" to link the driver statically, or "m" to build a
680 dynamically linked module called "g_audio".
681
1da177e4
LT
682config USB_ETH
683 tristate "Ethernet Gadget (with CDC Ethernet support)"
684 depends on NET
9e221be8 685 select CRC32
1da177e4 686 help
9b39e9dd
BN
687 This driver implements Ethernet style communication, in one of
688 several ways:
1da177e4
LT
689
690 - The "Communication Device Class" (CDC) Ethernet Control Model.
691 That protocol is often avoided with pure Ethernet adapters, in
692 favor of simpler vendor-specific hardware, but is widely
693 supported by firmware for smart network devices.
694
695 - On hardware can't implement that protocol, a simple CDC subset
696 is used, placing fewer demands on USB.
697
9b39e9dd
BN
698 - CDC Ethernet Emulation Model (EEM) is a newer standard that has
699 a simpler interface that can be used by more USB hardware.
700
701 RNDIS support is an additional option, more demanding than than
702 subset.
1da177e4
LT
703
704 Within the USB device, this gadget driver exposes a network device
705 "usbX", where X depends on what other networking devices you have.
706 Treat it like a two-node Ethernet link: host, and gadget.
707
708 The Linux-USB host-side "usbnet" driver interoperates with this
709 driver, so that deep I/O queues can be supported. On 2.4 kernels,
710 use "CDCEther" instead, if you're using the CDC option. That CDC
711 mode should also interoperate with standard CDC Ethernet class
712 drivers on other host operating systems.
713
714 Say "y" to link the driver statically, or "m" to build a
715 dynamically linked module called "g_ether".
716
717config USB_ETH_RNDIS
afd0e0f2
RD
718 bool "RNDIS support"
719 depends on USB_ETH
1da177e4
LT
720 default y
721 help
722 Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
723 and Microsoft provides redistributable binary RNDIS drivers for
724 older versions of Windows.
725
726 If you say "y" here, the Ethernet gadget driver will try to provide
727 a second device configuration, supporting RNDIS to talk to such
728 Microsoft USB hosts.
729
730 To make MS-Windows work with this, use Documentation/usb/linux.inf
731 as the "driver info file". For versions of MS-Windows older than
732 XP, you'll need to download drivers from Microsoft's website; a URL
733 is given in comments found in that info file.
734
9b39e9dd
BN
735config USB_ETH_EEM
736 bool "Ethernet Emulation Model (EEM) support"
737 depends on USB_ETH
738 default n
739 help
740 CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
741 and therefore can be supported by more hardware. Technically ECM and
742 EEM are designed for different applications. The ECM model extends
743 the network interface to the target (e.g. a USB cable modem), and the
744 EEM model is for mobile devices to communicate with hosts using
745 ethernet over USB. For Linux gadgets, however, the interface with
746 the host is the same (a usbX device), so the differences are minimal.
747
748 If you say "y" here, the Ethernet gadget driver will use the EEM
749 protocol rather than ECM. If unsure, say "n".
750
6c34d288
YK
751config USB_G_NCM
752 tristate "Network Control Model (NCM) support"
753 depends on NET
754 select CRC32
755 help
756 This driver implements USB CDC NCM subclass standard. NCM is
757 an advanced protocol for Ethernet encapsulation, allows grouping
758 of several ethernet frames into one USB transfer and diffferent
759 alignment possibilities.
760
761 Say "y" to link the driver statically, or "m" to build a
762 dynamically linked module called "g_ncm".
763
1da177e4
LT
764config USB_GADGETFS
765 tristate "Gadget Filesystem (EXPERIMENTAL)"
766 depends on EXPERIMENTAL
767 help
768 This driver provides a filesystem based API that lets user mode
769 programs implement a single-configuration USB device, including
770 endpoint I/O and control requests that don't relate to enumeration.
771 All endpoints, transfer speeds, and transfer types supported by
772 the hardware are available, through read() and write() calls.
773
afd0e0f2
RD
774 Currently, this option is still labelled as EXPERIMENTAL because
775 of existing race conditions in the underlying in-kernel AIO core.
776
1da177e4
LT
777 Say "y" to link the driver statically, or "m" to build a
778 dynamically linked module called "gadgetfs".
779
c6c56008
MN
780config USB_FUNCTIONFS
781 tristate "Function Filesystem (EXPERIMENTAL)"
782 depends on EXPERIMENTAL
f8dae531 783 select USB_FUNCTIONFS_GENERIC if !(USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
c6c56008 784 help
eabf0f5f
MP
785 The Function Filesystem (FunctionFS) lets one create USB
786 composite functions in user space in the same way GadgetFS
c6c56008
MN
787 lets one create USB gadgets in user space. This allows creation
788 of composite gadgets such that some of the functions are
789 implemented in kernel space (for instance Ethernet, serial or
790 mass storage) and other are implemented in user space.
791
f8dae531
MN
792 If you say "y" or "m" here you will be able what kind of
793 configurations the gadget will provide.
794
c6c56008
MN
795 Say "y" to link the driver statically, or "m" to build
796 a dynamically linked module called "g_ffs".
797
798config USB_FUNCTIONFS_ETH
f8dae531 799 bool "Include configuration with CDC ECM (Ethernet)"
17b2765e 800 depends on USB_FUNCTIONFS && NET
c6c56008 801 help
eabf0f5f
MP
802 Include a configuration with CDC ECM function (Ethernet) and the
803 Function Filesystem.
c6c56008
MN
804
805config USB_FUNCTIONFS_RNDIS
f8dae531 806 bool "Include configuration with RNDIS (Ethernet)"
17b2765e 807 depends on USB_FUNCTIONFS && NET
c6c56008 808 help
eabf0f5f 809 Include a configuration with RNDIS function (Ethernet) and the Filesystem.
c6c56008
MN
810
811config USB_FUNCTIONFS_GENERIC
812 bool "Include 'pure' configuration"
f8dae531 813 depends on USB_FUNCTIONFS
c6c56008 814 help
f8dae531
MN
815 Include a configuration with the Function Filesystem alone with
816 no Ethernet interface.
c6c56008 817
1da177e4
LT
818config USB_FILE_STORAGE
819 tristate "File-backed Storage Gadget"
87840289 820 depends on BLOCK
1da177e4
LT
821 help
822 The File-backed Storage Gadget acts as a USB Mass Storage
823 disk drive. As its storage repository it can use a regular
824 file or a block device (in much the same way as the "loop"
825 device driver), specified as a module parameter.
826
827 Say "y" to link the driver statically, or "m" to build a
828 dynamically linked module called "g_file_storage".
829
830config USB_FILE_STORAGE_TEST
831 bool "File-backed Storage Gadget testing version"
832 depends on USB_FILE_STORAGE
833 default n
834 help
835 Say "y" to generate the larger testing version of the
836 File-backed Storage Gadget, useful for probing the
837 behavior of USB Mass Storage hosts. Not needed for
838 normal operation.
839
d23b0f08
MN
840config USB_MASS_STORAGE
841 tristate "Mass Storage Gadget"
842 depends on BLOCK
843 help
844 The Mass Storage Gadget acts as a USB Mass Storage disk drive.
845 As its storage repository it can use a regular file or a block
846 device (in much the same way as the "loop" device driver),
847 specified as a module parameter or sysfs option.
848
849 This is heavily based on File-backed Storage Gadget and in most
850 cases you will want to use FSG instead. This gadget is mostly
851 here to test the functionality of the Mass Storage Function
852 which may be used with composite framework.
853
854 Say "y" to link the driver statically, or "m" to build
11b10d99 855 a dynamically linked module called "g_mass_storage". If unsure,
d23b0f08
MN
856 consider File-backed Storage Gadget.
857
1da177e4 858config USB_G_SERIAL
3086775a 859 tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
1da177e4
LT
860 help
861 The Serial Gadget talks to the Linux-USB generic serial driver.
862 This driver supports a CDC-ACM module option, which can be used
863 to interoperate with MS-Windows hosts or with the Linux-USB
864 "cdc-acm" driver.
865
3086775a
FB
866 This driver also supports a CDC-OBEX option. You will need a
867 user space OBEX server talking to /dev/ttyGS*, since the kernel
868 itself doesn't implement the OBEX protocol.
869
1da177e4
LT
870 Say "y" to link the driver statically, or "m" to build a
871 dynamically linked module called "g_serial".
872
873 For more information, see Documentation/usb/gadget_serial.txt
874 which includes instructions and a "driver info file" needed to
3086775a 875 make MS-Windows work with CDC ACM.
1da177e4 876
f2ebf92c
BW
877config USB_MIDI_GADGET
878 tristate "MIDI Gadget (EXPERIMENTAL)"
879 depends on SND && EXPERIMENTAL
880 select SND_RAWMIDI
881 help
882 The MIDI Gadget acts as a USB Audio device, with one MIDI
883 input and one MIDI output. These MIDI jacks appear as
884 a sound "card" in the ALSA sound system. Other MIDI
885 connections can then be made on the gadget system, using
886 ALSA's aconnect utility etc.
887
888 Say "y" to link the driver statically, or "m" to build a
889 dynamically linked module called "g_midi".
890
25a010c8
CN
891config USB_G_PRINTER
892 tristate "Printer Gadget"
893 help
894 The Printer Gadget channels data between the USB host and a
895 userspace program driving the print engine. The user space
896 program reads and writes the device file /dev/g_printer to
897 receive or send printer data. It can use ioctl calls to
898 the device file to get or set printer status.
899
900 Say "y" to link the driver statically, or "m" to build a
901 dynamically linked module called "g_printer".
902
903 For more information, see Documentation/usb/gadget_printer.txt
904 which includes sample code for accessing the device file.
1da177e4 905
19e20680
DB
906config USB_CDC_COMPOSITE
907 tristate "CDC Composite Device (Ethernet and ACM)"
4ddd9ec1 908 depends on NET
19e20680
DB
909 help
910 This driver provides two functions in one configuration:
911 a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
912
913 This driver requires four bulk and two interrupt endpoints,
914 plus the ability to handle altsettings. Not all peripheral
915 controllers are that capable.
916
917 Say "y" to link the driver statically, or "m" to build a
918 dynamically linked module.
919
f358f5b4
FB
920config USB_G_NOKIA
921 tristate "Nokia composite gadget"
922 depends on PHONET
923 help
924 The Nokia composite gadget provides support for acm, obex
925 and phonet in only one composite gadget driver.
926
927 It's only really useful for N900 hardware. If you're building
928 a kernel for N900, say Y or M here. If unsure, say N.
929
f176a5d8
MN
930config USB_G_MULTI
931 tristate "Multifunction Composite Gadget (EXPERIMENTAL)"
5791e103 932 depends on BLOCK && NET
279cc49a 933 select USB_G_MULTI_CDC if !USB_G_MULTI_RNDIS
f176a5d8
MN
934 help
935 The Multifunction Composite Gadget provides Ethernet (RNDIS
936 and/or CDC Ethernet), mass storage and ACM serial link
937 interfaces.
938
5791e103 939 You will be asked to choose which of the two configurations is
f176a5d8 940 to be available in the gadget. At least one configuration must
5791e103 941 be chosen to make the gadget usable. Selecting more than one
f176a5d8 942 configuration will prevent Windows from automatically detecting
5791e103 943 the gadget as a composite gadget, so an INF file will be needed to
f176a5d8
MN
944 use the gadget.
945
946 Say "y" to link the driver statically, or "m" to build a
947 dynamically linked module called "g_multi".
948
949config USB_G_MULTI_RNDIS
950 bool "RNDIS + CDC Serial + Storage configuration"
951 depends on USB_G_MULTI
952 default y
953 help
954 This option enables a configuration with RNDIS, CDC Serial and
955 Mass Storage functions available in the Multifunction Composite
5791e103
RD
956 Gadget. This is the configuration dedicated for Windows since RNDIS
957 is Microsoft's protocol.
f176a5d8
MN
958
959 If unsure, say "y".
960
961config USB_G_MULTI_CDC
962 bool "CDC Ethernet + CDC Serial + Storage configuration"
963 depends on USB_G_MULTI
964 default n
965 help
966 This option enables a configuration with CDC Ethernet (ECM), CDC
967 Serial and Mass Storage functions available in the Multifunction
5791e103 968 Composite Gadget.
f176a5d8
MN
969
970 If unsure, say "y".
971
71adf118
FC
972config USB_G_HID
973 tristate "HID Gadget"
974 help
975 The HID gadget driver provides generic emulation of USB
976 Human Interface Devices (HID).
977
978 For more information, see Documentation/usb/gadget_hid.txt which
979 includes sample code for accessing the device files.
980
981 Say "y" to link the driver statically, or "m" to build a
982 dynamically linked module called "g_hid".
f176a5d8 983
f6c826a9 984config USB_G_DBGP
985 tristate "EHCI Debug Device Gadget"
986 help
987 This gadget emulates an EHCI Debug device. This is useful when you want
988 to interact with an EHCI Debug Port.
989
990 Say "y" to link the driver statically, or "m" to build a
991 dynamically linked module called "g_dbgp".
992
993if USB_G_DBGP
994choice
995 prompt "EHCI Debug Device mode"
996 default USB_G_DBGP_SERIAL
997
998config USB_G_DBGP_PRINTK
999 depends on USB_G_DBGP
1000 bool "printk"
1001 help
1002 Directly printk() received data. No interaction.
1003
1004config USB_G_DBGP_SERIAL
1005 depends on USB_G_DBGP
1006 bool "serial"
1007 help
1008 Userland can interact using /dev/ttyGSxxx.
1009endchoice
1010endif
1011
1da177e4
LT
1012# put drivers that need isochronous transfer support (for audio
1013# or video class gadget drivers), or specific hardware, here.
a9914127
LP
1014config USB_G_WEBCAM
1015 tristate "USB Webcam Gadget"
24337c13 1016 depends on VIDEO_DEV
a9914127
LP
1017 help
1018 The Webcam Gadget acts as a composite USB Audio and Video Class
1019 device. It provides a userspace API to process UVC control requests
1020 and stream video data to the host.
1da177e4 1021
a9914127
LP
1022 Say "y" to link the driver statically, or "m" to build a
1023 dynamically linked module called "g_webcam".
1da177e4
LT
1024
1025endchoice
1026
b75be4ab 1027endif # USB_GADGET