Sam Protsenko | b084b0c | 2016-03-25 16:39:47 +0200 | [diff] [blame] | 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 | bool "USB Gadget Support" |
| 18 | help |
| 19 | USB is a master/slave protocol, organized with one master |
| 20 | host (such as a PC) controlling up to 127 peripheral devices. |
| 21 | The USB hardware is asymmetric, which makes it easier to set up: |
| 22 | you can't connect a "to-the-host" connector to a peripheral. |
| 23 | |
| 24 | U-Boot can run in the host, or in the peripheral. In both cases |
| 25 | you need a low level bus controller driver, and some software |
| 26 | talking to it. Peripheral controllers are often discrete silicon, |
| 27 | or are integrated with the CPU in a microcontroller. The more |
| 28 | familiar host side controllers have names like "EHCI", "OHCI", |
| 29 | or "UHCI", and are usually integrated into southbridges on PC |
| 30 | motherboards. |
| 31 | |
| 32 | Enable this configuration option if you want to run U-Boot inside |
| 33 | a USB peripheral device. Configure one hardware driver for your |
| 34 | peripheral/device side bus controller, and a "gadget driver" for |
| 35 | your peripheral protocol. |
Sam Protsenko | fb115b1 | 2016-04-13 14:20:24 +0300 | [diff] [blame] | 36 | |
| 37 | if USB_GADGET |
| 38 | |
Maxime Ripard | 7f78b9d | 2017-09-07 08:58:08 +0200 | [diff] [blame] | 39 | config USB_GADGET_MANUFACTURER |
| 40 | string "Vendor name of the USB device" |
Maxime Ripard | 6375bd8 | 2017-09-12 19:41:15 +0200 | [diff] [blame] | 41 | default "Allwinner Technology" if ARCH_SUNXI |
Jagan Teki | c115389 | 2019-11-19 13:56:14 +0530 | [diff] [blame] | 42 | default "Rockchip" if ARCH_ROCKCHIP |
Maxime Ripard | 7f78b9d | 2017-09-07 08:58:08 +0200 | [diff] [blame] | 43 | default "U-Boot" |
| 44 | help |
| 45 | Vendor name of the USB device emulated, reported to the host device. |
| 46 | This is usually either the manufacturer of the device or the SoC. |
| 47 | |
| 48 | config USB_GADGET_VENDOR_NUM |
| 49 | hex "Vendor ID of the USB device" |
Maxime Ripard | 6375bd8 | 2017-09-12 19:41:15 +0200 | [diff] [blame] | 50 | default 0x1f3a if ARCH_SUNXI |
Jagan Teki | ac6fb30 | 2019-11-19 13:56:15 +0530 | [diff] [blame] | 51 | default 0x2207 if ARCH_ROCKCHIP |
Maxime Ripard | 7f78b9d | 2017-09-07 08:58:08 +0200 | [diff] [blame] | 52 | default 0x0 |
| 53 | help |
| 54 | Vendor ID of the USB device emulated, reported to the host device. |
| 55 | This is usually the board or SoC vendor's, unless you've registered |
| 56 | for one. |
| 57 | |
| 58 | config USB_GADGET_PRODUCT_NUM |
| 59 | hex "Product ID of the USB device" |
Maxime Ripard | 6375bd8 | 2017-09-12 19:41:15 +0200 | [diff] [blame] | 60 | default 0x1010 if ARCH_SUNXI |
Jagan Teki | 1de44f0 | 2019-11-19 13:56:16 +0530 | [diff] [blame^] | 61 | default 0x310a if ROCKCHIP_RK3036 |
| 62 | default 0x320a if ROCKCHIP_RK3229 || ROCKCHIP_RK3288 |
| 63 | default 0x330a if ROCKCHIP_RK3328 |
Maxime Ripard | 7f78b9d | 2017-09-07 08:58:08 +0200 | [diff] [blame] | 64 | default 0x0 |
| 65 | help |
| 66 | Product ID of the USB device emulated, reported to the host device. |
| 67 | |
Sam Protsenko | b4a0bf7 | 2016-04-13 14:20:25 +0300 | [diff] [blame] | 68 | config USB_GADGET_ATMEL_USBA |
| 69 | bool "Atmel USBA" |
| 70 | select USB_GADGET_DUALSPEED |
| 71 | help |
| 72 | USBA is the integrated high-speed USB Device controller on |
| 73 | the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel. |
| 74 | |
Steve Rae | 437689f | 2016-08-15 17:26:26 -0700 | [diff] [blame] | 75 | config USB_GADGET_BCM_UDC_OTG_PHY |
| 76 | bool "Broadcom UDC OTG PHY" |
| 77 | help |
| 78 | Enable the Broadcom UDC OTG physical device interface. |
| 79 | |
Sam Protsenko | b4a0bf7 | 2016-04-13 14:20:25 +0300 | [diff] [blame] | 80 | config USB_GADGET_DWC2_OTG |
| 81 | bool "DesignWare USB2.0 HS OTG controller (gadget mode)" |
| 82 | select USB_GADGET_DUALSPEED |
| 83 | help |
| 84 | The Designware USB2.0 high-speed gadget controller |
| 85 | integrated into many SoCs. Select this option if you want the |
| 86 | driver to operate in Peripheral mode. This option requires |
| 87 | USB_GADGET to be enabled. |
| 88 | |
Steve Rae | d7198f3 | 2016-06-07 15:35:21 -0700 | [diff] [blame] | 89 | if USB_GADGET_DWC2_OTG |
| 90 | |
| 91 | config USB_GADGET_DWC2_OTG_PHY_BUS_WIDTH_8 |
| 92 | bool "DesignWare USB2.0 HS OTG controller 8-bit PHY bus width" |
| 93 | help |
| 94 | Set the Designware USB2.0 high-speed OTG controller |
| 95 | PHY interface width to 8 bits, rather than the default (16 bits). |
| 96 | |
| 97 | endif # USB_GADGET_DWC2_OTG |
| 98 | |
Sam Protsenko | b4a0bf7 | 2016-04-13 14:20:25 +0300 | [diff] [blame] | 99 | config CI_UDC |
| 100 | bool "ChipIdea device controller" |
| 101 | select USB_GADGET_DUALSPEED |
| 102 | help |
| 103 | Say Y here to enable device controller functionality of the |
| 104 | ChipIdea driver. |
| 105 | |
Sam Protsenko | fb115b1 | 2016-04-13 14:20:24 +0300 | [diff] [blame] | 106 | config USB_GADGET_VBUS_DRAW |
| 107 | int "Maximum VBUS Power usage (2-500 mA)" |
| 108 | range 2 500 |
| 109 | default 2 |
| 110 | help |
| 111 | Some devices need to draw power from USB when they are |
| 112 | configured, perhaps to operate circuitry or to recharge |
| 113 | batteries. This is in addition to any local power supply, |
| 114 | such as an AC adapter or batteries. |
| 115 | |
| 116 | Enter the maximum power your device draws through USB, in |
| 117 | milliAmperes. The permitted range of values is 2 - 500 mA; |
| 118 | 0 mA would be legal, but can make some hosts misbehave. |
| 119 | |
| 120 | This value will be used except for system-specific gadget |
| 121 | drivers that have more specific information. |
| 122 | |
Sam Protsenko | b4a0bf7 | 2016-04-13 14:20:25 +0300 | [diff] [blame] | 123 | # Selected by UDC drivers that support high-speed operation. |
| 124 | config USB_GADGET_DUALSPEED |
| 125 | bool |
| 126 | |
Sam Protsenko | 4d2439d | 2016-04-13 14:20:26 +0300 | [diff] [blame] | 127 | config USB_GADGET_DOWNLOAD |
| 128 | bool "Enable USB download gadget" |
| 129 | help |
| 130 | Composite USB download gadget support (g_dnl) for download functions. |
| 131 | This code works on top of composite gadget. |
| 132 | |
Sam Protsenko | b706ffd | 2016-04-13 14:20:30 +0300 | [diff] [blame] | 133 | if USB_GADGET_DOWNLOAD |
| 134 | |
Lukasz Majewski | e364e4b | 2018-01-29 19:25:54 +0100 | [diff] [blame] | 135 | config USB_FUNCTION_MASS_STORAGE |
| 136 | bool "Enable USB mass storage gadget" |
| 137 | help |
| 138 | Enable mass storage protocol support in U-Boot. It allows exporting |
| 139 | the eMMC/SD card content to HOST PC so it can be mounted. |
| 140 | |
Eddie Cai | f646092 | 2017-12-15 08:17:10 +0800 | [diff] [blame] | 141 | config USB_FUNCTION_ROCKUSB |
| 142 | bool "Enable USB rockusb gadget" |
| 143 | help |
| 144 | Rockusb protocol is widely used by Rockchip SoC based devices. It can |
| 145 | read/write info, image to/from devices. This enables the USB part of |
| 146 | the rockusb gadget.for more detail about Rockusb protocol, please see |
| 147 | doc/README.rockusb |
| 148 | |
Lukasz Majewski | b886ed9 | 2018-01-29 19:21:39 +0100 | [diff] [blame] | 149 | config USB_FUNCTION_SDP |
| 150 | bool "Enable USB SDP (Serial Download Protocol)" |
| 151 | help |
| 152 | Enable Serial Download Protocol (SDP) device support in U-Boot. This |
| 153 | allows to download images into memory and execute (jump to) them |
| 154 | using the same protocol as implemented by the i.MX family's boot ROM. |
| 155 | |
Lukasz Majewski | 3c32b42 | 2018-01-29 19:30:18 +0100 | [diff] [blame] | 156 | config USB_FUNCTION_THOR |
| 157 | bool "Enable USB THOR gadget" |
| 158 | help |
| 159 | Enable Tizen's THOR download protocol support in U-Boot. It |
| 160 | allows downloading images into memory and flash them to target device. |
| 161 | |
Maxime Ripard | a8ad636 | 2017-09-06 22:54:52 +0200 | [diff] [blame] | 162 | endif # USB_GADGET_DOWNLOAD |
| 163 | |
Maxime Ripard | 6584977 | 2017-09-06 23:23:21 +0200 | [diff] [blame] | 164 | config USB_ETHER |
| 165 | bool "USB Ethernet Gadget" |
Alex Kiernan | cc92df4 | 2018-04-01 09:22:36 +0000 | [diff] [blame] | 166 | depends on NET |
Maxime Ripard | 4a553ca | 2017-09-22 09:51:37 +0200 | [diff] [blame] | 167 | default y if ARCH_SUNXI && USB_MUSB_GADGET |
Maxime Ripard | 6584977 | 2017-09-06 23:23:21 +0200 | [diff] [blame] | 168 | help |
| 169 | Creates an Ethernet network device through a USB peripheral |
| 170 | controller. This will create a network interface on both the device |
| 171 | (U-Boot) and the host (remote device) that can be used just like any |
| 172 | other nework interface. |
| 173 | It will bind on the peripheral USB controller, ignoring the USB hosts |
| 174 | controllers in the system. |
| 175 | |
| 176 | if USB_ETHER |
| 177 | |
Maxime Ripard | 7285f48 | 2017-09-07 08:46:14 +0200 | [diff] [blame] | 178 | choice |
| 179 | prompt "USB Ethernet Gadget Model" |
| 180 | default USB_ETH_RNDIS |
| 181 | help |
| 182 | There is several models (protocols) to implement Ethernet over USB |
| 183 | devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet |
| 184 | (also called CDC-ECM). RNDIS is obviously compatible with Windows, |
| 185 | while CDC-ECM is not. Most other operating systems support both, so |
| 186 | if inter-operability is a concern, RNDIS is to be preferred. |
| 187 | |
| 188 | config USB_ETH_CDC |
| 189 | bool "CDC-ECM Protocol" |
| 190 | help |
| 191 | CDC (Communications Device Class) is the standard for Ethernet over |
| 192 | USB devices. While there's several alternatives, the most widely used |
| 193 | protocol is ECM (Ethernet Control Model). However, compatibility with |
| 194 | Windows is not that great. |
| 195 | |
| 196 | config USB_ETH_RNDIS |
| 197 | bool "RNDIS Protocol" |
| 198 | help |
| 199 | The RNDIS (Remote Network Driver Interface Specification) is a |
| 200 | Microsoft proprietary protocol to create an Ethernet device over USB. |
| 201 | Windows obviously supports it, as well as all the major operating |
| 202 | systems, so it's the best option for compatibility. |
| 203 | |
| 204 | endchoice |
| 205 | |
Mugunthan V N | 095b761 | 2016-11-18 11:09:15 +0530 | [diff] [blame] | 206 | config USBNET_DEVADDR |
| 207 | string "USB Gadget Ethernet device mac address" |
| 208 | default "de:ad:be:ef:00:01" |
Maxime Ripard | d4ff531 | 2017-09-12 18:32:45 +0200 | [diff] [blame] | 209 | help |
| 210 | Ethernet MAC address of the device-side (ie. local board's) MAC |
| 211 | address of the usb_ether interface |
Mugunthan V N | 095b761 | 2016-11-18 11:09:15 +0530 | [diff] [blame] | 212 | |
Maxime Ripard | 764bf28 | 2017-09-06 22:53:43 +0200 | [diff] [blame] | 213 | config USBNET_HOST_ADDR |
| 214 | string "USB Gadget Ethernet host mac address" |
| 215 | default "de:ad:be:ef:00:00" |
| 216 | help |
| 217 | Ethernet MAC address of the host-side (ie. remote device's) MAC |
| 218 | address of the usb_ether interface |
| 219 | |
Maxime Ripard | 6584977 | 2017-09-06 23:23:21 +0200 | [diff] [blame] | 220 | endif # USB_ETHER |
| 221 | |
Sam Protsenko | fb115b1 | 2016-04-13 14:20:24 +0300 | [diff] [blame] | 222 | endif # USB_GADGET |