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