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