drivers/usb/gadget/Kconfig

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