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