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
 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
 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         help
 162            Some of Freescale PowerPC processors have a High Speed
 163            Dual-Role(DR) USB controller, which supports device mode.
 164
 165            The number of programmable endpoints is different through
 166            SOC revisions.
 167
 168            Say "y" to link the driver statically, or "m" to build a
 169            dynamically linked module called "fsl_usb2_udc" and force
 170            all gadget drivers to also be dynamically linked.
 171
 172 config USB_FSL_USB2
 173         tristate
 174         depends on USB_GADGET_FSL_USB2
 175         default USB_GADGET
 176         select USB_GADGET_SELECTED
 177
 178 config USB_GADGET_LH7A40X
 179         boolean "LH7A40X"
 180         depends on ARCH_LH7A40X
 181         help
 182            This driver provides USB Device Controller driver for LH7A40x
 183
 184 config USB_LH7A40X
 185         tristate
 186         depends on USB_GADGET_LH7A40X
 187         default USB_GADGET
 188         select USB_GADGET_SELECTED
 189
 190 config USB_GADGET_OMAP
 191         boolean "OMAP USB Device Controller"
 192         depends on ARCH_OMAP
 193         select ISP1301_OMAP if MACH_OMAP_H2 || MACH_OMAP_H3 || MACH_OMAP_H4_OTG
 194         select USB_OTG_UTILS if ARCH_OMAP
 195         help
 196            Many Texas Instruments OMAP processors have flexible full
 197            speed USB device controllers, with support for up to 30
 198            endpoints (plus endpoint zero).  This driver supports the
 199            controller in the OMAP 1611, and should work with controllers
 200            in other OMAP processors too, given minor tweaks.
 201
 202            Say "y" to link the driver statically, or "m" to build a
 203            dynamically linked module called "omap_udc" and force all
 204            gadget drivers to also be dynamically linked.
 205
 206 config USB_OMAP
 207         tristate
 208         depends on USB_GADGET_OMAP
 209         default USB_GADGET
 210         select USB_GADGET_SELECTED
 211
 212 config USB_OTG
 213         boolean "OTG Support"
 214         depends on USB_GADGET_OMAP && ARCH_OMAP_OTG && USB_OHCI_HCD
 215         help
 216            The most notable feature of USB OTG is support for a
 217            "Dual-Role" device, which can act as either a device
 218            or a host.  The initial role choice can be changed
 219            later, when two dual-role devices talk to each other.
 220
 221            Select this only if your OMAP board has a Mini-AB connector.
 222
 223 config USB_GADGET_PXA25X
 224         boolean "PXA 25x or IXP 4xx"
 225         depends on (ARCH_PXA && PXA25x) || ARCH_IXP4XX
 226         help
 227            Intel's PXA 25x series XScale ARM-5TE processors include
 228            an integrated full speed USB 1.1 device controller.  The
 229            controller in the IXP 4xx series is register-compatible.
 230
 231            It has fifteen fixed-function endpoints, as well as endpoint
 232            zero (for control transfers).
 233
 234            Say "y" to link the driver statically, or "m" to build a
 235            dynamically linked module called "pxa25x_udc" and force all
 236            gadget drivers to also be dynamically linked.
 237
 238 config USB_PXA25X
 239         tristate
 240         depends on USB_GADGET_PXA25X
 241         default USB_GADGET
 242         select USB_GADGET_SELECTED
 243
 244 # if there's only one gadget driver, using only two bulk endpoints,
 245 # don't waste memory for the other endpoints
 246 config USB_PXA25X_SMALL
 247         depends on USB_GADGET_PXA25X
 248         bool
 249         default n if USB_ETH_RNDIS
 250         default y if USB_ZERO
 251         default y if USB_ETH
 252         default y if USB_G_SERIAL
 253
 254 config USB_GADGET_R8A66597
 255         boolean "Renesas R8A66597 USB Peripheral Controller"
 256         select USB_GADGET_DUALSPEED
 257         help
 258            R8A66597 is a discrete USB host and peripheral controller chip that
 259            supports both full and high speed USB 2.0 data transfers.
 260            It has nine configurable endpoints, and endpoint zero.
 261
 262            Say "y" to link the driver statically, or "m" to build a
 263            dynamically linked module called "r8a66597_udc" and force all
 264            gadget drivers to also be dynamically linked.
 265
 266 config USB_R8A66597
 267         tristate
 268         depends on USB_GADGET_R8A66597
 269         default USB_GADGET
 270         select USB_GADGET_SELECTED
 271
 272 config USB_GADGET_PXA27X
 273         boolean "PXA 27x"
 274         depends on ARCH_PXA && (PXA27x || PXA3xx)
 275         select USB_OTG_UTILS
 276         help
 277            Intel's PXA 27x series XScale ARM v5TE processors include
 278            an integrated full speed USB 1.1 device controller.
 279
 280            It has up to 23 endpoints, as well as endpoint zero (for
 281            control transfers).
 282
 283            Say "y" to link the driver statically, or "m" to build a
 284            dynamically linked module called "pxa27x_udc" and force all
 285            gadget drivers to also be dynamically linked.
 286
 287 config USB_PXA27X
 288         tristate
 289         depends on USB_GADGET_PXA27X
 290         default USB_GADGET
 291         select USB_GADGET_SELECTED
 292
 293 config USB_GADGET_S3C_HSOTG
 294         boolean "S3C HS/OtG USB Device controller"
 295         depends on S3C_DEV_USB_HSOTG
 296         select USB_GADGET_S3C_HSOTG_PIO
 297         help
 298           The Samsung S3C64XX USB2.0 high-speed gadget controller
 299           integrated into the S3C64XX series SoC.
 300
 301 config USB_S3C_HSOTG
 302         tristate
 303         depends on USB_GADGET_S3C_HSOTG
 304         default USB_GADGET
 305         select USB_GADGET_SELECTED
 306
 307 config USB_GADGET_IMX
 308         boolean "Freescale IMX USB Peripheral Controller"
 309         depends on ARCH_MX1
 310         help
 311            Freescale's IMX series include an integrated full speed
 312            USB 1.1 device controller.  The controller in the IMX series
 313            is register-compatible.
 314
 315            It has Six fixed-function endpoints, as well as endpoint
 316            zero (for control transfers).
 317
 318            Say "y" to link the driver statically, or "m" to build a
 319            dynamically linked module called "imx_udc" and force all
 320            gadget drivers to also be dynamically linked.
 321
 322 config USB_IMX
 323         tristate
 324         depends on USB_GADGET_IMX
 325         default USB_GADGET
 326         select USB_GADGET_SELECTED
 327
 328 config USB_GADGET_S3C2410
 329         boolean "S3C2410 USB Device Controller"
 330         depends on ARCH_S3C2410
 331         help
 332           Samsung's S3C2410 is an ARM-4 processor with an integrated
 333           full speed USB 1.1 device controller.  It has 4 configurable
 334           endpoints, as well as endpoint zero (for control transfers).
 335
 336           This driver has been tested on the S3C2410, S3C2412, and
 337           S3C2440 processors.
 338
 339 config USB_S3C2410
 340         tristate
 341         depends on USB_GADGET_S3C2410
 342         default USB_GADGET
 343         select USB_GADGET_SELECTED
 344
 345 config USB_S3C2410_DEBUG
 346         boolean "S3C2410 udc debug messages"
 347         depends on USB_GADGET_S3C2410
 348
 349 #
 350 # Controllers available in both integrated and discrete versions
 351 #
 352
 353 # musb builds in ../musb along with host support
 354 config USB_GADGET_MUSB_HDRC
 355         boolean "Inventra HDRC USB Peripheral (TI, ADI, ...)"
 356         depends on USB_MUSB_HDRC && (USB_MUSB_PERIPHERAL || USB_MUSB_OTG)
 357         select USB_GADGET_DUALSPEED
 358         select USB_GADGET_SELECTED
 359         help
 360           This OTG-capable silicon IP is used in dual designs including
 361           the TI DaVinci, OMAP 243x, OMAP 343x, TUSB 6010, and ADI Blackfin
 362
 363 config USB_GADGET_M66592
 364         boolean "Renesas M66592 USB Peripheral Controller"
 365         select USB_GADGET_DUALSPEED
 366         help
 367            M66592 is a discrete USB peripheral controller chip that
 368            supports both full and high speed USB 2.0 data transfers.
 369            It has seven configurable endpoints, and endpoint zero.
 370
 371            Say "y" to link the driver statically, or "m" to build a
 372            dynamically linked module called "m66592_udc" and force all
 373            gadget drivers to also be dynamically linked.
 374
 375 config USB_M66592
 376         tristate
 377         depends on USB_GADGET_M66592
 378         default USB_GADGET
 379         select USB_GADGET_SELECTED
 380
 381 #
 382 # Controllers available only in discrete form (and all PCI controllers)
 383 #
 384
 385 config USB_GADGET_AMD5536UDC
 386         boolean "AMD5536 UDC"
 387         depends on PCI
 388         select USB_GADGET_DUALSPEED
 389         help
 390            The AMD5536 UDC is part of the AMD Geode CS5536, an x86 southbridge.
 391            It is a USB Highspeed DMA capable USB device controller. Beside ep0
 392            it provides 4 IN and 4 OUT endpoints (bulk or interrupt type).
 393            The UDC port supports OTG operation, and may be used as a host port
 394            if it's not being used to implement peripheral or OTG roles.
 395
 396            Say "y" to link the driver statically, or "m" to build a
 397            dynamically linked module called "amd5536udc" and force all
 398            gadget drivers to also be dynamically linked.
 399
 400 config USB_AMD5536UDC
 401         tristate
 402         depends on USB_GADGET_AMD5536UDC
 403         default USB_GADGET
 404         select USB_GADGET_SELECTED
 405
 406 config USB_GADGET_FSL_QE
 407         boolean "Freescale QE/CPM USB Device Controller"
 408         depends on FSL_SOC && (QUICC_ENGINE || CPM)
 409         help
 410            Some of Freescale PowerPC processors have a Full Speed
 411            QE/CPM2 USB controller, which support device mode with 4
 412            programmable endpoints. This driver supports the
 413            controller in the MPC8360 and MPC8272, and should work with
 414            controllers having QE or CPM2, given minor tweaks.
 415
 416            Set CONFIG_USB_GADGET to "m" to build this driver as a
 417            dynamically linked module called "fsl_qe_udc".
 418
 419 config USB_FSL_QE
 420         tristate
 421         depends on USB_GADGET_FSL_QE
 422         default USB_GADGET
 423         select USB_GADGET_SELECTED
 424
 425 config USB_GADGET_CI13XXX
 426         boolean "MIPS USB CI13xxx"
 427         depends on PCI
 428         select USB_GADGET_DUALSPEED
 429         help
 430           MIPS USB IP core family device controller
 431           Currently it only supports IP part number CI13412
 432
 433           Say "y" to link the driver statically, or "m" to build a
 434           dynamically linked module called "ci13xxx_udc" and force all
 435           gadget drivers to also be dynamically linked.
 436
 437 config USB_CI13XXX
 438         tristate
 439         depends on USB_GADGET_CI13XXX
 440         default USB_GADGET
 441         select USB_GADGET_SELECTED
 442
 443 config USB_GADGET_NET2280
 444         boolean "NetChip 228x"
 445         depends on PCI
 446         select USB_GADGET_DUALSPEED
 447         help
 448            NetChip 2280 / 2282 is a PCI based USB peripheral controller which
 449            supports both full and high speed USB 2.0 data transfers.
 450
 451            It has six configurable endpoints, as well as endpoint zero
 452            (for control transfers) and several endpoints with dedicated
 453            functions.
 454
 455            Say "y" to link the driver statically, or "m" to build a
 456            dynamically linked module called "net2280" and force all
 457            gadget drivers to also be dynamically linked.
 458
 459 config USB_NET2280
 460         tristate
 461         depends on USB_GADGET_NET2280
 462         default USB_GADGET
 463         select USB_GADGET_SELECTED
 464
 465 config USB_GADGET_GOKU
 466         boolean "Toshiba TC86C001 'Goku-S'"
 467         depends on PCI
 468         help
 469            The Toshiba TC86C001 is a PCI device which includes controllers
 470            for full speed USB devices, IDE, I2C, SIO, plus a USB host (OHCI).
 471
 472            The device controller has three configurable (bulk or interrupt)
 473            endpoints, plus endpoint zero (for control transfers).
 474
 475            Say "y" to link the driver statically, or "m" to build a
 476            dynamically linked module called "goku_udc" and to force all
 477            gadget drivers to also be dynamically linked.
 478
 479 config USB_GOKU
 480         tristate
 481         depends on USB_GADGET_GOKU
 482         default USB_GADGET
 483         select USB_GADGET_SELECTED
 484
 485 config USB_GADGET_LANGWELL
 486         boolean "Intel Langwell USB Device Controller"
 487         depends on PCI
 488         select USB_GADGET_DUALSPEED
 489         help
 490            Intel Langwell USB Device Controller is a High-Speed USB
 491            On-The-Go device controller.
 492
 493            The number of programmable endpoints is different through
 494            controller revision.
 495
 496            Say "y" to link the driver statically, or "m" to build a
 497            dynamically linked module called "langwell_udc" and force all
 498            gadget drivers to also be dynamically linked.
 499
 500 config USB_LANGWELL
 501         tristate
 502         depends on USB_GADGET_LANGWELL
 503         default USB_GADGET
 504         select USB_GADGET_SELECTED
 505
 506
 507 #
 508 # LAST -- dummy/emulated controller
 509 #
 510
 511 config USB_GADGET_DUMMY_HCD
 512         boolean "Dummy HCD (DEVELOPMENT)"
 513         depends on USB=y || (USB=m && USB_GADGET=m)
 514         select USB_GADGET_DUALSPEED
 515         help
 516           This host controller driver emulates USB, looping all data transfer
 517           requests back to a USB "gadget driver" in the same host.  The host
 518           side is the master; the gadget side is the slave.  Gadget drivers
 519           can be high, full, or low speed; and they have access to endpoints
 520           like those from NET2280, PXA2xx, or SA1100 hardware.
 521
 522           This may help in some stages of creating a driver to embed in a
 523           Linux device, since it lets you debug several parts of the gadget
 524           driver without its hardware or drivers being involved.
 525
 526           Since such a gadget side driver needs to interoperate with a host
 527           side Linux-USB device driver, this may help to debug both sides
 528           of a USB protocol stack.
 529
 530           Say "y" to link the driver statically, or "m" to build a
 531           dynamically linked module called "dummy_hcd" and force all
 532           gadget drivers to also be dynamically linked.
 533
 534 config USB_DUMMY_HCD
 535         tristate
 536         depends on USB_GADGET_DUMMY_HCD
 537         default USB_GADGET
 538         select USB_GADGET_SELECTED
 539
 540 # NOTE:  Please keep dummy_hcd LAST so that "real hardware" appears
 541 # first and will be selected by default.
 542
 543 endchoice
 544
 545 config USB_GADGET_DUALSPEED
 546         bool
 547         depends on USB_GADGET
 548         default n
 549         help
 550           Means that gadget drivers should include extra descriptors
 551           and code to handle dual-speed controllers.
 552
 553 #
 554 # USB Gadget Drivers
 555 #
 556 choice
 557         tristate "USB Gadget Drivers"
 558         depends on USB_GADGET && USB_GADGET_SELECTED
 559         default USB_ETH
 560         help
 561           A Linux "Gadget Driver" talks to the USB Peripheral Controller
 562           driver through the abstract "gadget" API.  Some other operating
 563           systems call these "client" drivers, of which "class drivers"
 564           are a subset (implementing a USB device class specification).
 565           A gadget driver implements one or more USB functions using
 566           the peripheral hardware.
 567
 568           Gadget drivers are hardware-neutral, or "platform independent",
 569           except that they sometimes must understand quirks or limitations
 570           of the particular controllers they work with.  For example, when
 571           a controller doesn't support alternate configurations or provide
 572           enough of the right types of endpoints, the gadget driver might
 573           not be able work with that controller, or might need to implement
 574           a less common variant of a device class protocol.
 575
 576 # this first set of drivers all depend on bulk-capable hardware.
 577
 578 config USB_ZERO
 579         tristate "Gadget Zero (DEVELOPMENT)"
 580         help
 581           Gadget Zero is a two-configuration device.  It either sinks and
 582           sources bulk data; or it loops back a configurable number of
 583           transfers.  It also implements control requests, for "chapter 9"
 584           conformance.  The driver needs only two bulk-capable endpoints, so
 585           it can work on top of most device-side usb controllers.  It's
 586           useful for testing, and is also a working example showing how
 587           USB "gadget drivers" can be written.
 588
 589           Make this be the first driver you try using on top of any new
 590           USB peripheral controller driver.  Then you can use host-side
 591           test software, like the "usbtest" driver, to put your hardware
 592           and its driver through a basic set of functional tests.
 593
 594           Gadget Zero also works with the host-side "usb-skeleton" driver,
 595           and with many kinds of host-side test software.  You may need
 596           to tweak product and vendor IDs before host software knows about
 597           this device, and arrange to select an appropriate configuration.
 598
 599           Say "y" to link the driver statically, or "m" to build a
 600           dynamically linked module called "g_zero".
 601
 602 config USB_ZERO_HNPTEST
 603         boolean "HNP Test Device"
 604         depends on USB_ZERO && USB_OTG
 605         help
 606           You can configure this device to enumerate using the device
 607           identifiers of the USB-OTG test device.  That means that when
 608           this gadget connects to another OTG device, with this one using
 609           the "B-Peripheral" role, that device will use HNP to let this
 610           one serve as the USB host instead (in the "B-Host" role).
 611
 612 config USB_AUDIO
 613         tristate "Audio Gadget (EXPERIMENTAL)"
 614         depends on SND
 615         select SND_PCM
 616         help
 617           Gadget Audio is compatible with USB Audio Class specification 1.0.
 618           It will include at least one AudioControl interface, zero or more
 619           AudioStream interface and zero or more MIDIStream interface.
 620
 621           Gadget Audio will use on-board ALSA (CONFIG_SND) audio card to
 622           playback or capture audio stream.
 623
 624           Say "y" to link the driver statically, or "m" to build a
 625           dynamically linked module called "g_audio".
 626
 627 config USB_ETH
 628         tristate "Ethernet Gadget (with CDC Ethernet support)"
 629         depends on NET
 630         help
 631           This driver implements Ethernet style communication, in either
 632           of two ways:
 633
 634            - The "Communication Device Class" (CDC) Ethernet Control Model.
 635              That protocol is often avoided with pure Ethernet adapters, in
 636              favor of simpler vendor-specific hardware, but is widely
 637              supported by firmware for smart network devices.
 638
 639            - On hardware can't implement that protocol, a simple CDC subset
 640              is used, placing fewer demands on USB.
 641
 642           RNDIS support is a third option, more demanding than that subset.
 643
 644           Within the USB device, this gadget driver exposes a network device
 645           "usbX", where X depends on what other networking devices you have.
 646           Treat it like a two-node Ethernet link:  host, and gadget.
 647
 648           The Linux-USB host-side "usbnet" driver interoperates with this
 649           driver, so that deep I/O queues can be supported.  On 2.4 kernels,
 650           use "CDCEther" instead, if you're using the CDC option. That CDC
 651           mode should also interoperate with standard CDC Ethernet class
 652           drivers on other host operating systems.
 653
 654           Say "y" to link the driver statically, or "m" to build a
 655           dynamically linked module called "g_ether".
 656
 657 config USB_ETH_RNDIS
 658         bool "RNDIS support"
 659         depends on USB_ETH
 660         default y
 661         help
 662            Microsoft Windows XP bundles the "Remote NDIS" (RNDIS) protocol,
 663            and Microsoft provides redistributable binary RNDIS drivers for
 664            older versions of Windows.
 665
 666            If you say "y" here, the Ethernet gadget driver will try to provide
 667            a second device configuration, supporting RNDIS to talk to such
 668            Microsoft USB hosts.
 669
 670            To make MS-Windows work with this, use Documentation/usb/linux.inf
 671            as the "driver info file".  For versions of MS-Windows older than
 672            XP, you'll need to download drivers from Microsoft's website; a URL
 673            is given in comments found in that info file.
 674
 675 config USB_GADGETFS
 676         tristate "Gadget Filesystem (EXPERIMENTAL)"
 677         depends on EXPERIMENTAL
 678         help
 679           This driver provides a filesystem based API that lets user mode
 680           programs implement a single-configuration USB device, including
 681           endpoint I/O and control requests that don't relate to enumeration.
 682           All endpoints, transfer speeds, and transfer types supported by
 683           the hardware are available, through read() and write() calls.
 684
 685           Currently, this option is still labelled as EXPERIMENTAL because
 686           of existing race conditions in the underlying in-kernel AIO core.
 687
 688           Say "y" to link the driver statically, or "m" to build a
 689           dynamically linked module called "gadgetfs".
 690
 691 config USB_FILE_STORAGE
 692         tristate "File-backed Storage Gadget"
 693         depends on BLOCK
 694         help
 695           The File-backed Storage Gadget acts as a USB Mass Storage
 696           disk drive.  As its storage repository it can use a regular
 697           file or a block device (in much the same way as the "loop"
 698           device driver), specified as a module parameter.
 699
 700           Say "y" to link the driver statically, or "m" to build a
 701           dynamically linked module called "g_file_storage".
 702
 703 config USB_FILE_STORAGE_TEST
 704         bool "File-backed Storage Gadget testing version"
 705         depends on USB_FILE_STORAGE
 706         default n
 707         help
 708           Say "y" to generate the larger testing version of the
 709           File-backed Storage Gadget, useful for probing the
 710           behavior of USB Mass Storage hosts.  Not needed for
 711           normal operation.
 712
 713 config USB_G_SERIAL
 714         tristate "Serial Gadget (with CDC ACM and CDC OBEX support)"
 715         help
 716           The Serial Gadget talks to the Linux-USB generic serial driver.
 717           This driver supports a CDC-ACM module option, which can be used
 718           to interoperate with MS-Windows hosts or with the Linux-USB
 719           "cdc-acm" driver.
 720
 721           This driver also supports a CDC-OBEX option.  You will need a
 722           user space OBEX server talking to /dev/ttyGS*, since the kernel
 723           itself doesn't implement the OBEX protocol.
 724
 725           Say "y" to link the driver statically, or "m" to build a
 726           dynamically linked module called "g_serial".
 727
 728           For more information, see Documentation/usb/gadget_serial.txt
 729           which includes instructions and a "driver info file" needed to
 730           make MS-Windows work with CDC ACM.
 731
 732 config USB_MIDI_GADGET
 733         tristate "MIDI Gadget (EXPERIMENTAL)"
 734         depends on SND && EXPERIMENTAL
 735         select SND_RAWMIDI
 736         help
 737           The MIDI Gadget acts as a USB Audio device, with one MIDI
 738           input and one MIDI output. These MIDI jacks appear as
 739           a sound "card" in the ALSA sound system. Other MIDI
 740           connections can then be made on the gadget system, using
 741           ALSA's aconnect utility etc.
 742
 743           Say "y" to link the driver statically, or "m" to build a
 744           dynamically linked module called "g_midi".
 745
 746 config USB_G_PRINTER
 747         tristate "Printer Gadget"
 748         help
 749           The Printer Gadget channels data between the USB host and a
 750           userspace program driving the print engine. The user space
 751           program reads and writes the device file /dev/g_printer to
 752           receive or send printer data. It can use ioctl calls to
 753           the device file to get or set printer status.
 754
 755           Say "y" to link the driver statically, or "m" to build a
 756           dynamically linked module called "g_printer".
 757
 758           For more information, see Documentation/usb/gadget_printer.txt
 759           which includes sample code for accessing the device file.
 760
 761 config USB_CDC_COMPOSITE
 762         tristate "CDC Composite Device (Ethernet and ACM)"
 763         depends on NET
 764         help
 765           This driver provides two functions in one configuration:
 766           a CDC Ethernet (ECM) link, and a CDC ACM (serial port) link.
 767
 768           This driver requires four bulk and two interrupt endpoints,
 769           plus the ability to handle altsettings.  Not all peripheral
 770           controllers are that capable.
 771
 772           Say "y" to link the driver statically, or "m" to build a
 773           dynamically linked module.
 774
 775 # put drivers that need isochronous transfer support (for audio
 776 # or video class gadget drivers), or specific hardware, here.
 777
 778 # - none yet
 779
 780 endchoice
 781
 782 endif # USB_GADGET