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