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