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         select NLS
  19         help
  20            USB is a master/slave protocol, organized with one master
  21            host (such as a PC) controlling up to 127 peripheral devices.
  22            The USB hardware is asymmetric, which makes it easier to set up:
  23            you can't connect a "to-the-host" connector to a peripheral.
  24
  25            Linux can run in the host, or in the peripheral.  In both cases
  26            you need a low level bus controller driver, and some software
  27            talking to it.  Peripheral controllers are often discrete silicon,
  28            or are integrated with the CPU in a microcontroller.  The more
  29            familiar host side controllers have names like "EHCI", "OHCI",
  30            or "UHCI", and are usually integrated into southbridges on PC
  31            motherboards.
  32
  33            Enable this configuration option if you want to run Linux inside
  34            a USB peripheral device.  Configure one hardware driver for your
  35            peripheral/device side bus controller, and a "gadget driver" for
  36            your peripheral protocol.  (If you use modular gadget drivers,
  37            you may configure more than one.)
  38
  39            If in doubt, say "N" and don't enable these drivers; most people
  40            don't have this kind of hardware (except maybe inside Linux PDAs).
  41
  42            For more information, see <http://www.linux-usb.org/gadget> and
  43            the kernel DocBook documentation for this API.
  44
  45 if USB_GADGET
  46
  47 config USB_GADGET_DEBUG
  48         boolean "Debugging messages (DEVELOPMENT)"
  49         depends on DEBUG_KERNEL
  50         help
  51            Many controller and gadget drivers will print some debugging
  52            messages if you use this option to ask for those messages.
  53
  54            Avoid enabling these messages, even if you're actively
  55            debugging such a driver.  Many drivers will emit so many
  56            messages that the driver timings are affected, which will
  57            either create new failure modes or remove the one you're
  58            trying to track down.  Never enable these messages for a
  59            production build.
  60
  61 config USB_GADGET_DEBUG_FILES
  62         boolean "Debugging information files (DEVELOPMENT)"
  63         depends on PROC_FS
  64         help
  65            Some of the drivers in the "gadget" framework can expose
  66            debugging information in files such as /proc/driver/udc
  67            (for a peripheral controller).  The information in these
  68            files may help when you're troubleshooting or bringing up a
  69            driver on a new board.   Enable these files by choosing "Y"
  70            here.  If in doubt, or to conserve kernel memory, say "N".
  71
  72 config USB_GADGET_DEBUG_FS
  73         boolean "Debugging information files in debugfs (DEVELOPMENT)"
  74         depends on DEBUG_FS
  75         help
  76            Some of the drivers in the "gadget" framework can expose
  77            debugging information in files under /sys/kernel/debug/.
  78            The information in these files may help when you're
  79            troubleshooting or bringing up a driver on a new board.
  80            Enable these files by choosing "Y" here.  If in doubt, or
  81            to conserve kernel memory, say "N".
  82
  83 config USB_GADGET_VBUS_DRAW
  84         int "Maximum VBUS Power usage (2-500 mA)"
  85         range 2 500
  86         default 2
  87         help
  88            Some devices need to draw power from USB when they are
  89            configured, perhaps to operate circuitry or to recharge
  90            batteries.  This is in addition to any local power supply,
  91            such as an AC adapter or batteries.
  92
  93            Enter the maximum power your device draws through USB, in
  94            milliAmperes.  The permitted range of values is 2 - 500 mA;
  95            0 mA would be legal, but can make some hosts misbehave.
  96
  97            This value will be used except for system-specific gadget
  98            drivers that have more specific information.
  99
 100 config USB_GADGET_STORAGE_NUM_BUFFERS
 101         int "Number of storage pipeline buffers"
 102         range 2 4
 103         default 2
 104         help
 105            Usually 2 buffers are enough to establish a good buffering
 106            pipeline. The number may be increased in order to compensate
 107            for a bursty VFS behaviour. For instance there may be CPU wake up
 108            latencies that makes the VFS to appear bursty in a system with
 109            an CPU on-demand governor. Especially if DMA is doing IO to
 110            offload the CPU. In this case the CPU will go into power
 111            save often and spin up occasionally to move data within VFS.
 112            If selecting USB_GADGET_DEBUG_FILES this value may be set by
 113            a module parameter as well.
 114            If unsure, say 2.
 115
 116 #
 117 # USB Peripheral Controller Support
 118 #
 119 # The order here is alphabetical, except that integrated controllers go
 120 # before discrete ones so they will be the initial/default value:
 121 #   - integrated/SOC controllers first
 122 #   - licensed IP used in both SOC and discrete versions
 123 #   - discrete ones (including all PCI-only controllers)
 124 #   - debug/dummy gadget+hcd is last.
 125 #
 126 choice
 127         prompt "USB Peripheral Controller"
 128         help
 129            A USB device uses a controller to talk to its host.
 130            Systems should have only one such upstream link.
 131            Many controller drivers are platform-specific; these
 132            often need board-specific hooks.
 133
 134 #
 135 # Integrated controllers
 136 #
 137
 138 config USB_AT91
 139         tristate "Atmel AT91 USB Device Port"
 140         depends on ARCH_AT91 && !ARCH_AT91SAM9RL && !ARCH_AT91CAP9 && !ARCH_AT91SAM9G45
 141         help
 142            Many Atmel AT91 processors (such as the AT91RM2000) have a
 143            full speed USB Device Port with support for five configurable
 144            endpoints (plus endpoint zero).
 145
 146            Say "y" to link the driver statically, or "m" to build a
 147            dynamically linked module called "at91_udc" and force all
 148            gadget drivers to also be dynamically linked.
 149
 150 config USB_ATMEL_USBA
 151         tristate "Atmel USBA"
 152         select USB_GADGET_DUALSPEED
 153         depends on AVR32 || ARCH_AT91CAP9 || ARCH_AT91SAM9RL || ARCH_AT91SAM9G45
 154         help
 155           USBA is the integrated high-speed USB Device controller on
 156           the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
 157
 158 config USB_FSL_USB2
 159         tristate "Freescale Highspeed USB DR Peripheral Controller"
 160         depends on FSL_SOC || ARCH_MXC
 161         select USB_GADGET_DUALSPEED
 162         select USB_FSL_MPH_DR_OF if OF
 163         help
 164            Some of Freescale PowerPC processors have a High Speed
 165            Dual-Role(DR) USB controller, which supports device mode.
 166
 167            The number of programmable endpoints is different through
 168            SOC revisions.
 169
 170            Say "y" to link the driver statically, or "m" to build a
 171            dynamically linked module called "fsl_usb2_udc" and force
 172            all gadget drivers to also be dynamically linked.
 173
 174 config USB_FUSB300
 175         tristate "Faraday FUSB300 USB Peripheral Controller"
 176         depends on !PHYS_ADDR_T_64BIT
 177         select USB_GADGET_DUALSPEED
 178         help
 179            Faraday usb device controller FUSB300 driver
 180
 181 config USB_OMAP
 182         tristate "OMAP USB Device Controller"
 183         depends on ARCH_OMAP
 184         select ISP1301_OMAP if MACH_OMAP_H2 || MACH_OMAP_H3 || MACH_OMAP_H4_OTG
 185         select USB_OTG_UTILS if ARCH_OMAP
 186         help
 187            Many Texas Instruments OMAP processors have flexible full
 188            speed USB device controllers, with support for up to 30
 189            endpoints (plus endpoint zero).  This driver supports the
 190            controller in the OMAP 1611, and should work with controllers
 191            in other OMAP processors too, given minor tweaks.
 192
 193            Say "y" to link the driver statically, or "m" to build a
 194            dynamically linked module called "omap_udc" and force all
 195            gadget drivers to also be dynamically linked.
 196
 197 config USB_PXA25X
 198         tristate "PXA 25x or IXP 4xx"
 199         depends on (ARCH_PXA && PXA25x) || ARCH_IXP4XX
 200         select USB_OTG_UTILS
 201         help
 202            Intel's PXA 25x series XScale ARM-5TE processors include
 203            an integrated full speed USB 1.1 device controller.  The
 204            controller in the IXP 4xx series is register-compatible.
 205
 206            It has fifteen fixed-function endpoints, as well as endpoint
 207            zero (for control transfers).
 208
 209            Say "y" to link the driver statically, or "m" to build a
 210            dynamically linked module called "pxa25x_udc" and force all
 211            gadget drivers to also be dynamically linked.
 212
 213 # if there's only one gadget driver, using only two bulk endpoints,
 214 # don't waste memory for the other endpoints
 215 config USB_PXA25X_SMALL
 216         depends on USB_PXA25X
 217         bool
 218         default n if USB_ETH_RNDIS
 219         default y if USB_ZERO
 220         default y if USB_ETH
 221         default y if USB_G_SERIAL
 222
 223 config USB_R8A66597
 224         tristate "Renesas R8A66597 USB Peripheral Controller"
 225         select USB_GADGET_DUALSPEED
 226         help
 227            R8A66597 is a discrete USB host and peripheral controller chip that
 228            supports both full and high speed USB 2.0 data transfers.
 229            It has nine configurable endpoints, and endpoint zero.
 230
 231            Say "y" to link the driver statically, or "m" to build a
 232            dynamically linked module called "r8a66597_udc" and force all
 233            gadget drivers to also be dynamically linked.
 234
 235 config USB_RENESAS_USBHS_UDC
 236         tristate 'Renesas USBHS controller'
 237         depends on USB_RENESAS_USBHS
 238         select USB_GADGET_DUALSPEED
 239         help
 240            Renesas USBHS is a discrete USB host and peripheral controller chip
 241            that supports both full and high speed USB 2.0 data transfers.
 242            It has nine or more configurable endpoints, and endpoint zero.
 243
 244            Say "y" to link the driver statically, or "m" to build a
 245            dynamically linked module called "renesas_usbhs" and force all
 246            gadget drivers to also be dynamically linked.
 247
 248 config USB_PXA27X
 249         tristate "PXA 27x"
 250         depends on ARCH_PXA && (PXA27x || PXA3xx)
 251         select USB_OTG_UTILS
 252         help
 253            Intel's PXA 27x series XScale ARM v5TE processors include
 254            an integrated full speed USB 1.1 device controller.
 255
 256            It has up to 23 endpoints, as well as endpoint zero (for
 257            control transfers).
 258
 259            Say "y" to link the driver statically, or "m" to build a
 260            dynamically linked module called "pxa27x_udc" and force all
 261            gadget drivers to also be dynamically linked.
 262
 263 config USB_S3C_HSOTG
 264         tristate "S3C HS/OtG USB Device controller"
 265         depends on S3C_DEV_USB_HSOTG
 266         select USB_GADGET_S3C_HSOTG_PIO
 267         select USB_GADGET_DUALSPEED
 268         help
 269           The Samsung S3C64XX USB2.0 high-speed gadget controller
 270           integrated into the S3C64XX series SoC.
 271
 272 config USB_IMX
 273         tristate "Freescale i.MX1 USB Peripheral Controller"
 274         depends on ARCH_MXC
 275         help
 276            Freescale's i.MX1 includes an integrated full speed
 277            USB 1.1 device controller.
 278
 279            It has Six fixed-function endpoints, as well as endpoint
 280            zero (for control transfers).
 281
 282            Say "y" to link the driver statically, or "m" to build a
 283            dynamically linked module called "imx_udc" and force all
 284            gadget drivers to also be dynamically linked.
 285
 286 config USB_S3C2410
 287         tristate "S3C2410 USB Device Controller"
 288         depends on ARCH_S3C2410
 289         help
 290           Samsung's S3C2410 is an ARM-4 processor with an integrated
 291           full speed USB 1.1 device controller.  It has 4 configurable
 292           endpoints, as well as endpoint zero (for control transfers).
 293
 294           This driver has been tested on the S3C2410, S3C2412, and
 295           S3C2440 processors.
 296
 297 config USB_S3C2410_DEBUG
 298         boolean "S3C2410 udc debug messages"
 299         depends on USB_S3C2410
 300
 301 config USB_S3C_HSUDC
 302         tristate "S3C2416, S3C2443 and S3C2450 USB Device Controller"
 303         depends on ARCH_S3C2410
 304         select USB_GADGET_DUALSPEED
 305         help
 306           Samsung's S3C2416, S3C2443 and S3C2450 is an ARM9 based SoC
 307           integrated with dual speed USB 2.0 device controller. It has
 308           8 endpoints, as well as endpoint zero.
 309
 310           This driver has been tested on S3C2416 and S3C2450 processors.
 311
 312 config USB_MV_UDC
 313         tristate "Marvell USB2.0 Device Controller"
 314         select USB_GADGET_DUALSPEED
 315         help
 316           Marvell Socs (including PXA and MMP series) include a high speed
 317           USB2.0 OTG controller, which can be configured as high speed or
 318           full speed USB peripheral.
 319
 320 #
 321 # Controllers available in both integrated and discrete versions
 322 #
 323
 324 # musb builds in ../musb along with host support
 325 config USB_GADGET_MUSB_HDRC
 326         tristate "Inventra HDRC USB Peripheral (TI, ADI, ...)"
 327         depends on USB_MUSB_HDRC
 328         select USB_GADGET_DUALSPEED
 329         help
 330           This OTG-capable silicon IP is used in dual designs including
 331           the TI DaVinci, OMAP 243x, OMAP 343x, TUSB 6010, and ADI Blackfin
 332
 333 config USB_M66592
 334         tristate "Renesas M66592 USB Peripheral Controller"
 335         select USB_GADGET_DUALSPEED
 336         help
 337            M66592 is a discrete USB peripheral controller chip that
 338            supports both full and high speed USB 2.0 data transfers.
 339            It has seven configurable endpoints, and endpoint zero.
 340
 341            Say "y" to link the driver statically, or "m" to build a
 342            dynamically linked module called "m66592_udc" and force all
 343            gadget drivers to also be dynamically linked.
 344
 345 #
 346 # Controllers available only in discrete form (and all PCI controllers)
 347 #
 348
 349 config USB_AMD5536UDC
 350         tristate "AMD5536 UDC"
 351         depends on PCI
 352         select USB_GADGET_DUALSPEED
 353         help
 354            The AMD5536 UDC is part of the AMD Geode CS5536, an x86 southbridge.
 355            It is a USB Highspeed DMA capable USB device controller. Beside ep0
 356            it provides 4 IN and 4 OUT endpoints (bulk or interrupt type).
 357            The UDC port supports OTG operation, and may be used as a host port
 358            if it's not being used to implement peripheral or OTG roles.
 359
 360            Say "y" to link the driver statically, or "m" to build a
 361            dynamically linked module called "amd5536udc" and force all
 362            gadget drivers to also be dynamically linked.
 363
 364 config USB_FSL_QE
 365         tristate "Freescale QE/CPM USB Device Controller"
 366         depends on FSL_SOC && (QUICC_ENGINE || CPM)
 367         help
 368            Some of Freescale PowerPC processors have a Full Speed
 369            QE/CPM2 USB controller, which support device mode with 4
 370            programmable endpoints. This driver supports the
 371            controller in the MPC8360 and MPC8272, and should work with
 372            controllers having QE or CPM2, given minor tweaks.
 373
 374            Set CONFIG_USB_GADGET to "m" to build this driver as a
 375            dynamically linked module called "fsl_qe_udc".
 376
 377 config USB_CI13XXX_PCI
 378         tristate "MIPS USB CI13xxx PCI UDC"
 379         depends on PCI
 380         select USB_GADGET_DUALSPEED
 381         help
 382           MIPS USB IP core family device controller
 383           Currently it only supports IP part number CI13412
 384
 385           Say "y" to link the driver statically, or "m" to build a
 386           dynamically linked module called "ci13xxx_udc" and force all
 387           gadget drivers to also be dynamically linked.
 388
 389 config USB_NET2272
 390         tristate "PLX NET2272"
 391         select USB_GADGET_DUALSPEED
 392         help
 393           PLX NET2272 is a USB peripheral controller which supports
 394           both full and high speed USB 2.0 data transfers.
 395
 396           It has three configurable endpoints, as well as endpoint zero
 397           (for control transfer).
 398           Say "y" to link the driver statically, or "m" to build a
 399           dynamically linked module called "net2272" and force all
 400           gadget drivers to also be dynamically linked.
 401
 402 config USB_NET2272_DMA
 403         boolean "Support external DMA controller"
 404         depends on USB_NET2272
 405         help
 406           The NET2272 part can optionally support an external DMA
 407           controller, but your board has to have support in the
 408           driver itself.
 409
 410           If unsure, say "N" here.  The driver works fine in PIO mode.
 411
 412 config USB_NET2280
 413         tristate "NetChip 228x"
 414         depends on PCI
 415         select USB_GADGET_DUALSPEED
 416         help
 417            NetChip 2280 / 2282 is a PCI based USB peripheral controller which
 418            supports both full and high speed USB 2.0 data transfers.
 419
 420            It has six configurable endpoints, as well as endpoint zero
 421            (for control transfers) and several endpoints with dedicated
 422            functions.
 423
 424            Say "y" to link the driver statically, or "m" to build a
 425            dynamically linked module called "net2280" and force all
 426            gadget drivers to also be dynamically linked.
 427
 428 config USB_GOKU
 429         tristate "Toshiba TC86C001 'Goku-S'"
 430         depends on PCI
 431         help
 432            The Toshiba TC86C001 is a PCI device which includes controllers
 433            for full speed USB devices, IDE, I2C, SIO, plus a USB host (OHCI).
 434
 435            The device controller has three configurable (bulk or interrupt)
 436            endpoints, plus endpoint zero (for control transfers).
 437
 438            Say "y" to link the driver statically, or "m" to build a
 439            dynamically linked module called "goku_udc" and to force all
 440            gadget drivers to also be dynamically linked.
 441
 442 config USB_LANGWELL
 443         tristate "Intel Langwell USB Device Controller"
 444         depends on PCI
 445         depends on !PHYS_ADDR_T_64BIT
 446         select USB_GADGET_DUALSPEED
 447         help
 448            Intel Langwell USB Device Controller is a High-Speed USB
 449            On-The-Go device controller.
 450
 451            The number of programmable endpoints is different through
 452            controller revision.
 453
 454            Say "y" to link the driver statically, or "m" to build a
 455            dynamically linked module called "langwell_udc" and force all
 456            gadget drivers to also be dynamically linked.
 457
 458 config USB_EG20T
 459         tristate "Intel EG20T PCH/LAPIS Semiconductor IOH(ML7213/ML7831) UDC"
 460         depends on PCI
 461         select USB_GADGET_DUALSPEED
 462         help
 463           This is a USB device driver for EG20T PCH.
 464           EG20T PCH is the platform controller hub that is used in Intel's
 465           general embedded platform. EG20T PCH has USB device interface.
 466           Using this interface, it is able to access system devices connected
 467           to USB device.
 468           This driver enables USB device function.
 469           USB device is a USB peripheral controller which
 470           supports both full and high speed USB 2.0 data transfers.
 471           This driver supports both control transfer and bulk transfer modes.
 472           This driver dose not support interrupt transfer or isochronous
 473           transfer modes.
 474
 475           This driver also can be used for LAPIS Semiconductor's ML7213 which is
 476           for IVI(In-Vehicle Infotainment) use.
 477           ML7831 is for general purpose use.
 478           ML7213/ML7831 is companion chip for Intel Atom E6xx series.
 479           ML7213/ML7831 is completely compatible for Intel EG20T PCH.
 480
 481 config USB_CI13XXX_MSM
 482         tristate "MIPS USB CI13xxx for MSM"
 483         depends on ARCH_MSM
 484         select USB_GADGET_DUALSPEED
 485         select USB_MSM_OTG
 486         help
 487           MSM SoC has chipidea USB controller.  This driver uses
 488           ci13xxx_udc core.
 489           This driver depends on OTG driver for PHY initialization,
 490           clock management, powering up VBUS, and power management.
 491           This driver is not supported on boards like trout which
 492           has an external PHY.
 493
 494           Say "y" to link the driver statically, or "m" to build a
 495           dynamically linked module called "ci13xxx_msm" and force all
 496           gadget drivers to also be dynamically linked.
 497
 498 #
 499 # LAST -- dummy/emulated controller
 500 #
 501
 502 config USB_DUMMY_HCD
 503         tristate "Dummy HCD (DEVELOPMENT)"
 504         depends on USB=y || (USB=m && USB_GADGET=m)
 505         select USB_GADGET_DUALSPEED
 506         select USB_GADGET_SUPERSPEED
 507         help
 508           This host controller driver emulates USB, looping all data transfer
 509           requests back to a USB "gadget driver" in the same host.  The host
 510           side is the master; the gadget side is the slave.  Gadget drivers
 511           can be high, full, or low speed; and they have access to endpoints
 512           like those from NET2280, PXA2xx, or SA1100 hardware.
 513
 514           This may help in some stages of creating a driver to embed in a
 515           Linux device, since it lets you debug several parts of the gadget
 516           driver without its hardware or drivers being involved.
 517
 518           Since such a gadget side driver needs to interoperate with a host
 519           side Linux-USB device driver, this may help to debug both sides
 520           of a USB protocol stack.
 521
 522           Say "y" to link the driver statically, or "m" to build a
 523           dynamically linked module called "dummy_hcd" and force all
 524           gadget drivers to also be dynamically linked.
 525
 526 # NOTE:  Please keep dummy_hcd LAST so that "real hardware" appears
 527 # first and will be selected by default.
 528
 529 endchoice
 530
 531 # Selected by UDC drivers that support high-speed operation.
 532 config USB_GADGET_DUALSPEED
 533         bool
 534
 535 # Selected by UDC drivers that support super-speed opperation
 536 config USB_GADGET_SUPERSPEED
 537         bool
 538         depends on USB_GADGET_DUALSPEED
 539
 540 #
 541 # USB Gadget Drivers
 542 #
 543 choice
 544         tristate "USB Gadget Drivers"
 545         default USB_ETH
 546         help
 547           A Linux "Gadget Driver" talks to the USB Peripheral Controller
 548           driver through the abstract "gadget" API.  Some other operating
 549           systems call these "client" drivers, of which "class drivers"
 550           are a subset (implementing a USB device class specification).
 551           A gadget driver implements one or more USB functions using
 552           the peripheral hardware.
 553
 554           Gadget drivers are hardware-neutral, or "platform independent",
 555           except that they sometimes must understand quirks or limitations
 556           of the particular controllers they work with.  For example, when
 557           a controller doesn't support alternate configurations or provide
 558           enough of the right types of endpoints, the gadget driver might
 559           not be able work with that controller, or might need to implement
 560           a less common variant of a device class protocol.
 561
 562 # this first set of drivers all depend on bulk-capable hardware.
 563
 564 config USB_ZERO
 565         tristate "Gadget Zero (DEVELOPMENT)"
 566         help
 567           Gadget Zero is a two-configuration device.  It either sinks and
 568           sources bulk data; or it loops back a configurable number of
 569           transfers.  It also implements control requests, for "chapter 9"
 570           conformance.  The driver needs only two bulk-capable endpoints, so
 571           it can work on top of most device-side usb controllers.  It's
 572           useful for testing, and is also a working example showing how
 573           USB "gadget drivers" can be written.
 574
 575           Make this be the first driver you try using on top of any new
 576           USB peripheral controller driver.  Then you can use host-side
 577           test software, like the "usbtest" driver, to put your hardware
 578           and its driver through a basic set of functional tests.
 579
 580           Gadget Zero also works with the host-side "usb-skeleton" driver,
 581           and with many kinds of host-side test software.  You may need
 582           to tweak product and vendor IDs before host software knows about
 583           this device, and arrange to select an appropriate configuration.
 584
 585           Say "y" to link the driver statically, or "m" to build a
 586           dynamically linked module called "g_zero".
 587
 588 config USB_ZERO_HNPTEST
 589         boolean "HNP Test Device"
 590         depends on USB_ZERO && USB_OTG
 591         help
 592           You can configure this device to enumerate using the device
 593           identifiers of the USB-OTG test device.  That means that when
 594           this gadget connects to another OTG device, with this one using
 595           the "B-Peripheral" role, that device will use HNP to let this
 596           one serve as the USB host instead (in the "B-Host" role).
 597
 598 config USB_AUDIO
 599         tristate "Audio Gadget (EXPERIMENTAL)"
 600         depends on SND
 601         select SND_PCM
 602         help
 603           Gadget Audio is compatible with USB Audio Class specification 1.0.
 604           It will include at least one AudioControl interface, zero or more
 605           AudioStream interface and zero or more MIDIStream interface.
 606
 607           Gadget Audio will use on-board ALSA (CONFIG_SND) audio card to
 608           playback or capture audio stream.
 609
 610           Say "y" to link the driver statically, or "m" to build a
 611           dynamically linked module called "g_audio".
 612
 613 config USB_ETH
 614         tristate "Ethernet Gadget (with CDC Ethernet support)"
 615         depends on NET
 616         select CRC32
 617         help
 618           This driver implements Ethernet style communication, in one of
 619           several ways:
 620
 621            - The "Communication Device Class" (CDC) Ethernet Control Model.
 622              That protocol is often avoided with pure Ethernet adapters, in
 623              favor of simpler vendor-specific hardware, but is widely
 624              supported by firmware for smart network devices.
 625
 626            - On hardware can't implement that protocol, a simple CDC subset
 627              is used, placing fewer demands on USB.
 628
 629            - CDC Ethernet Emulation Model (EEM) is a newer standard that has
 630              a simpler interface that can be used by more USB hardware.
 631
 632           RNDIS support is an additional option, more demanding than than
 633           subset.
 634
 635           Within the USB device, this gadget driver exposes a network device
 636           "usbX", where X depends on what other networking devices you have.
 637           Treat it like a two-node Ethernet link:  host, and gadget.
 638
 639           The Linux-USB host-side "usbnet" driver interoperates with this
 640           driver, so that deep I/O queues can be supported.  On 2.4 kernels,
 641           use "CDCEther" instead, if you're using the CDC option. That CDC
 642           mode should also interoperate with standard CDC Ethernet class
 643           drivers on other host operating systems.
 644
 645           Say "y" to link the driver statically, or "m" to build a
 646           dynamically linked module called "g_ether".
 647
 648 config USB_ETH_RNDIS
 649         bool "RNDIS support"
 650         depends on USB_ETH
 651         default y
 652         help
 653            Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
 654            and Microsoft provides redistributable binary RNDIS drivers for
 655            older versions of Windows.
 656
 657            If you say "y" here, the Ethernet gadget driver will try to provide
 658            a second device configuration, supporting RNDIS to talk to such
 659            Microsoft USB hosts.
 660
 661            To make MS-Windows work with this, use Documentation/usb/linux.inf
 662            as the "driver info file".  For versions of MS-Windows older than
 663            XP, you'll need to download drivers from Microsoft's website; a URL
 664            is given in comments found in that info file.
 665
 666 config USB_ETH_EEM
 667        bool "Ethernet Emulation Model (EEM) support"
 668        depends on USB_ETH
 669        default n
 670        help
 671          CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
 672          and therefore can be supported by more hardware.  Technically ECM and
 673          EEM are designed for different applications.  The ECM model extends
 674          the network interface to the target (e.g. a USB cable modem), and the
 675          EEM model is for mobile devices to communicate with hosts using
 676          ethernet over USB.  For Linux gadgets, however, the interface with
 677          the host is the same (a usbX device), so the differences are minimal.
 678
 679          If you say "y" here, the Ethernet gadget driver will use the EEM
 680          protocol rather than ECM.  If unsure, say "n".
 681
 682 config USB_G_NCM
 683         tristate "Network Control Model (NCM) support"
 684         depends on NET
 685         select CRC32
 686         help
 687           This driver implements USB CDC NCM subclass standard. NCM is
 688           an advanced protocol for Ethernet encapsulation, allows grouping
 689           of several ethernet frames into one USB transfer and diffferent
 690           alignment possibilities.
 691
 692           Say "y" to link the driver statically, or "m" to build a
 693           dynamically linked module called "g_ncm".
 694
 695 config USB_GADGETFS
 696         tristate "Gadget Filesystem (EXPERIMENTAL)"
 697         depends on EXPERIMENTAL
 698         help
 699           This driver provides a filesystem based API that lets user mode
 700           programs implement a single-configuration USB device, including
 701           endpoint I/O and control requests that don't relate to enumeration.
 702           All endpoints, transfer speeds, and transfer types supported by
 703           the hardware are available, through read() and write() calls.
 704
 705           Currently, this option is still labelled as EXPERIMENTAL because
 706           of existing race conditions in the underlying in-kernel AIO core.
 707
 708           Say "y" to link the driver statically, or "m" to build a
 709           dynamically linked module called "gadgetfs".
 710
 711 config USB_FUNCTIONFS
 712         tristate "Function Filesystem (EXPERIMENTAL)"
 713         depends on EXPERIMENTAL
 714         select USB_FUNCTIONFS_GENERIC if !(USB_FUNCTIONFS_ETH || USB_FUNCTIONFS_RNDIS)
 715         help
 716           The Function Filesystem (FunctionFS) lets one create USB
 717           composite functions in user space in the same way GadgetFS
 718           lets one create USB gadgets in user space.  This allows creation
 719           of composite gadgets such that some of the functions are
 720           implemented in kernel space (for instance Ethernet, serial or
 721           mass storage) and other are implemented in user space.
 722
 723           If you say "y" or "m" here you will be able what kind of
 724           configurations the gadget will provide.
 725
 726           Say "y" to link the driver statically, or "m" to build
 727           a dynamically linked module called "g_ffs".
 728
 729 config USB_FUNCTIONFS_ETH
 730         bool "Include configuration with CDC ECM (Ethernet)"
 731         depends on USB_FUNCTIONFS && NET
 732         help
 733           Include a configuration with CDC ECM function (Ethernet) and the
 734           Function Filesystem.
 735
 736 config USB_FUNCTIONFS_RNDIS
 737         bool "Include configuration with RNDIS (Ethernet)"
 738         depends on USB_FUNCTIONFS && NET
 739         help
 740           Include a configuration with RNDIS function (Ethernet) and the Filesystem.
 741
 742 config USB_FUNCTIONFS_GENERIC
 743         bool "Include 'pure' configuration"
 744         depends on USB_FUNCTIONFS
 745         help
 746           Include a configuration with the Function Filesystem alone with
 747           no Ethernet interface.
 748
 749 config USB_FILE_STORAGE
 750         tristate "File-backed Storage Gadget (DEPRECATED)"
 751         depends on BLOCK
 752         help
 753           The File-backed Storage Gadget acts as a USB Mass Storage
 754           disk drive.  As its storage repository it can use a regular
 755           file or a block device (in much the same way as the "loop"
 756           device driver), specified as a module parameter.
 757
 758           Say "y" to link the driver statically, or "m" to build a
 759           dynamically linked module called "g_file_storage".
 760
 761           NOTE: This driver is deprecated.  Its replacement is the
 762           Mass Storage Gadget.
 763
 764 config USB_FILE_STORAGE_TEST
 765         bool "File-backed Storage Gadget testing version"
 766         depends on USB_FILE_STORAGE
 767         default n
 768         help
 769           Say "y" to generate the larger testing version of the
 770           File-backed Storage Gadget, useful for probing the
 771           behavior of USB Mass Storage hosts.  Not needed for
 772           normal operation.
 773
 774 config USB_MASS_STORAGE
 775         tristate "Mass Storage Gadget"
 776         depends on BLOCK
 777         help
 778           The Mass Storage Gadget acts as a USB Mass Storage disk drive.
 779           As its storage repository it can use a regular file or a block
 780           device (in much the same way as the "loop" device driver),
 781           specified as a module parameter or sysfs option.
 782
 783           This driver is an updated replacement for the deprecated
 784           File-backed Storage Gadget (g_file_storage).
 785
 786           Say "y" to link the driver statically, or "m" to build
 787           a dynamically linked module called "g_mass_storage".
 788
 789 config USB_G_SERIAL
 790         tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
 791         help
 792           The Serial Gadget talks to the Linux-USB generic serial driver.
 793           This driver supports a CDC-ACM module option, which can be used
 794           to interoperate with MS-Windows hosts or with the Linux-USB
 795           "cdc-acm" driver.
 796
 797           This driver also supports a CDC-OBEX option.  You will need a
 798           user space OBEX server talking to /dev/ttyGS*, since the kernel
 799           itself doesn't implement the OBEX protocol.
 800
 801           Say "y" to link the driver statically, or "m" to build a
 802           dynamically linked module called "g_serial".
 803
 804           For more information, see Documentation/usb/gadget_serial.txt
 805           which includes instructions and a "driver info file" needed to
 806           make MS-Windows work with CDC ACM.
 807
 808 config USB_MIDI_GADGET
 809         tristate "MIDI Gadget (EXPERIMENTAL)"
 810         depends on SND && EXPERIMENTAL
 811         select SND_RAWMIDI
 812         help
 813           The MIDI Gadget acts as a USB Audio device, with one MIDI
 814           input and one MIDI output. These MIDI jacks appear as
 815           a sound "card" in the ALSA sound system. Other MIDI
 816           connections can then be made on the gadget system, using
 817           ALSA's aconnect utility etc.
 818
 819           Say "y" to link the driver statically, or "m" to build a
 820           dynamically linked module called "g_midi".
 821
 822 config USB_G_PRINTER
 823         tristate "Printer Gadget"
 824         help
 825           The Printer Gadget channels data between the USB host and a
 826           userspace program driving the print engine. The user space
 827           program reads and writes the device file /dev/g_printer to
 828           receive or send printer data. It can use ioctl calls to
 829           the device file to get or set printer status.
 830
 831           Say "y" to link the driver statically, or "m" to build a
 832           dynamically linked module called "g_printer".
 833
 834           For more information, see Documentation/usb/gadget_printer.txt
 835           which includes sample code for accessing the device file.
 836
 837 config USB_CDC_COMPOSITE
 838         tristate "CDC Composite Device (Ethernet and ACM)"
 839         depends on NET
 840         help
 841           This driver provides two functions in one configuration:
 842           a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
 843
 844           This driver requires four bulk and two interrupt endpoints,
 845           plus the ability to handle altsettings.  Not all peripheral
 846           controllers are that capable.
 847
 848           Say "y" to link the driver statically, or "m" to build a
 849           dynamically linked module.
 850
 851 config USB_G_NOKIA
 852         tristate "Nokia composite gadget"
 853         depends on PHONET
 854         help
 855           The Nokia composite gadget provides support for acm, obex
 856           and phonet in only one composite gadget driver.
 857
 858           It's only really useful for N900 hardware. If you're building
 859           a kernel for N900, say Y or M here. If unsure, say N.
 860
 861 config USB_G_ACM_MS
 862         tristate "CDC Composite Device (ACM and mass storage)"
 863         depends on BLOCK
 864         help
 865           This driver provides two functions in one configuration:
 866           a mass storage, and a CDC ACM (serial port) link.
 867
 868           Say "y" to link the driver statically, or "m" to build a
 869           dynamically linked module called "g_acm_ms".
 870
 871 config USB_G_MULTI
 872         tristate "Multifunction Composite Gadget (EXPERIMENTAL)"
 873         depends on BLOCK && NET
 874         select USB_G_MULTI_CDC if !USB_G_MULTI_RNDIS
 875         help
 876           The Multifunction Composite Gadget provides Ethernet (RNDIS
 877           and/or CDC Ethernet), mass storage and ACM serial link
 878           interfaces.
 879
 880           You will be asked to choose which of the two configurations is
 881           to be available in the gadget.  At least one configuration must
 882           be chosen to make the gadget usable.  Selecting more than one
 883           configuration will prevent Windows from automatically detecting
 884           the gadget as a composite gadget, so an INF file will be needed to
 885           use the gadget.
 886
 887           Say "y" to link the driver statically, or "m" to build a
 888           dynamically linked module called "g_multi".
 889
 890 config USB_G_MULTI_RNDIS
 891         bool "RNDIS + CDC Serial + Storage configuration"
 892         depends on USB_G_MULTI
 893         default y
 894         help
 895           This option enables a configuration with RNDIS, CDC Serial and
 896           Mass Storage functions available in the Multifunction Composite
 897           Gadget.  This is the configuration dedicated for Windows since RNDIS
 898           is Microsoft's protocol.
 899
 900           If unsure, say "y".
 901
 902 config USB_G_MULTI_CDC
 903         bool "CDC Ethernet + CDC Serial + Storage configuration"
 904         depends on USB_G_MULTI
 905         default n
 906         help
 907           This option enables a configuration with CDC Ethernet (ECM), CDC
 908           Serial and Mass Storage functions available in the Multifunction
 909           Composite Gadget.
 910
 911           If unsure, say "y".
 912
 913 config USB_G_HID
 914         tristate "HID Gadget"
 915         help
 916           The HID gadget driver provides generic emulation of USB
 917           Human Interface Devices (HID).
 918
 919           For more information, see Documentation/usb/gadget_hid.txt which
 920           includes sample code for accessing the device files.
 921
 922           Say "y" to link the driver statically, or "m" to build a
 923           dynamically linked module called "g_hid".
 924
 925 config USB_G_DBGP
 926         tristate "EHCI Debug Device Gadget"
 927         help
 928           This gadget emulates an EHCI Debug device. This is useful when you want
 929           to interact with an EHCI Debug Port.
 930
 931           Say "y" to link the driver statically, or "m" to build a
 932           dynamically linked module called "g_dbgp".
 933
 934 if USB_G_DBGP
 935 choice
 936         prompt "EHCI Debug Device mode"
 937         default USB_G_DBGP_SERIAL
 938
 939 config USB_G_DBGP_PRINTK
 940         depends on USB_G_DBGP
 941         bool "printk"
 942         help
 943           Directly printk() received data. No interaction.
 944
 945 config USB_G_DBGP_SERIAL
 946         depends on USB_G_DBGP
 947         bool "serial"
 948         help
 949           Userland can interact using /dev/ttyGSxxx.
 950 endchoice
 951 endif
 952
 953 # put drivers that need isochronous transfer support (for audio
 954 # or video class gadget drivers), or specific hardware, here.
 955 config USB_G_WEBCAM
 956         tristate "USB Webcam Gadget"
 957         depends on VIDEO_DEV
 958         help
 959           The Webcam Gadget acts as a composite USB Audio and Video Class
 960           device. It provides a userspace API to process UVC control requests
 961           and stream video data to the host.
 962
 963           Say "y" to link the driver statically, or "m" to build a
 964           dynamically linked module called "g_webcam".
 965
 966 endchoice
 967
 968 endif # USB_GADGET