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