blob: 350036f2083c476f9f513041fc9e7df2c1391481 [file] [log] [blame]
Sam Protsenkob084b0c2016-03-25 16:39:47 +02001#
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
16menuconfig USB_GADGET
17 bool "USB Gadget Support"
Tom Rini5b9e6162021-07-09 10:11:56 -040018 depends on DM
19 select DM_USB
Sam Protsenkob084b0c2016-03-25 16:39:47 +020020 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 Protsenkofb115b12016-04-13 14:20:24 +030038
39if USB_GADGET
40
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020041config USB_GADGET_MANUFACTURER
42 string "Vendor name of the USB device"
Maxime Ripard6375bd82017-09-12 19:41:15 +020043 default "Allwinner Technology" if ARCH_SUNXI
Jagan Tekic1153892019-11-19 13:56:14 +053044 default "Rockchip" if ARCH_ROCKCHIP
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020045 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
50config USB_GADGET_VENDOR_NUM
51 hex "Vendor ID of the USB device"
Maxime Ripard6375bd82017-09-12 19:41:15 +020052 default 0x1f3a if ARCH_SUNXI
Jagan Tekiac6fb302019-11-19 13:56:15 +053053 default 0x2207 if ARCH_ROCKCHIP
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020054 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
60config USB_GADGET_PRODUCT_NUM
61 hex "Product ID of the USB device"
Maxime Ripard6375bd82017-09-12 19:41:15 +020062 default 0x1010 if ARCH_SUNXI
Jagan Teki1de44f02019-11-19 13:56:16 +053063 default 0x310a if ROCKCHIP_RK3036
Jagan Teki668c56f2019-11-19 13:56:17 +053064 default 0x310c if ROCKCHIP_RK3128
Jagan Teki1de44f02019-11-19 13:56:16 +053065 default 0x320a if ROCKCHIP_RK3229 || ROCKCHIP_RK3288
66 default 0x330a if ROCKCHIP_RK3328
Jagan Teki5c8e27b2019-11-19 13:56:21 +053067 default 0x330c if ROCKCHIP_RK3399
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020068 default 0x0
69 help
70 Product ID of the USB device emulated, reported to the host device.
71
Sam Protsenkob4a0bf72016-04-13 14:20:25 +030072config USB_GADGET_ATMEL_USBA
73 bool "Atmel USBA"
74 select USB_GADGET_DUALSPEED
75 help
76 USBA is the integrated high-speed USB Device controller on
77 the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
78
Steve Rae437689f2016-08-15 17:26:26 -070079config USB_GADGET_BCM_UDC_OTG_PHY
80 bool "Broadcom UDC OTG PHY"
81 help
82 Enable the Broadcom UDC OTG physical device interface.
83
Sam Protsenkob4a0bf72016-04-13 14:20:25 +030084config USB_GADGET_DWC2_OTG
85 bool "DesignWare USB2.0 HS OTG controller (gadget mode)"
86 select USB_GADGET_DUALSPEED
87 help
88 The Designware USB2.0 high-speed gadget controller
89 integrated into many SoCs. Select this option if you want the
90 driver to operate in Peripheral mode. This option requires
91 USB_GADGET to be enabled.
92
Steve Raed7198f32016-06-07 15:35:21 -070093if USB_GADGET_DWC2_OTG
94
Tom Rinifb9d4062022-06-15 12:03:52 -040095config USB_GADGET_DWC2_OTG_PHY
96 bool "DesignWare USB2.0 HS OTG PHY"
97 help
98 Enable the DesignWare USB2.0 HS OTG physical device interface.
99
Steve Raed7198f32016-06-07 15:35:21 -0700100config USB_GADGET_DWC2_OTG_PHY_BUS_WIDTH_8
101 bool "DesignWare USB2.0 HS OTG controller 8-bit PHY bus width"
102 help
103 Set the Designware USB2.0 high-speed OTG controller
104 PHY interface width to 8 bits, rather than the default (16 bits).
105
106endif # USB_GADGET_DWC2_OTG
107
Peng Fana3669d22021-01-25 21:43:48 +0800108config USB_GADGET_OS_DESCRIPTORS
109 bool "USB OS Feature Descriptors support"
110 help
111 This is a porting patch from linux kernel: 37a3a533429e
112 ("usb: gadget: OS Feature Descriptors support"), the original commit
113 log see below:
114 There is a custom (non-USB IF) extension to the USB standard:
115 http://msdn.microsoft.com/library/windows/hardware/gg463182
116
Sam Protsenkob4a0bf72016-04-13 14:20:25 +0300117config CI_UDC
118 bool "ChipIdea device controller"
119 select USB_GADGET_DUALSPEED
120 help
121 Say Y here to enable device controller functionality of the
122 ChipIdea driver.
123
Jassi Brar9c5cb7f2020-07-29 20:51:27 -0500124config USB_GADGET_MAX3420
125 bool "MAX3420 USB Over SPI"
126 depends on DM_SPI
127 help
128 MAX3420, from MAXIM, implements USB-over-SPI Full-Speed device controller.
129
Sam Protsenkofb115b12016-04-13 14:20:24 +0300130config USB_GADGET_VBUS_DRAW
131 int "Maximum VBUS Power usage (2-500 mA)"
132 range 2 500
133 default 2
134 help
135 Some devices need to draw power from USB when they are
136 configured, perhaps to operate circuitry or to recharge
137 batteries. This is in addition to any local power supply,
138 such as an AC adapter or batteries.
139
140 Enter the maximum power your device draws through USB, in
141 milliAmperes. The permitted range of values is 2 - 500 mA;
142 0 mA would be legal, but can make some hosts misbehave.
143
144 This value will be used except for system-specific gadget
145 drivers that have more specific information.
146
Frank Lic2bdb582020-04-29 10:35:11 +0800147config SDP_LOADADDR
148 hex "Default load address at SDP_WRITE and SDP_JUMP"
149 default 0
150
Sam Protsenkob4a0bf72016-04-13 14:20:25 +0300151# Selected by UDC drivers that support high-speed operation.
152config USB_GADGET_DUALSPEED
153 bool
154
Sam Protsenko4d2439d2016-04-13 14:20:26 +0300155config USB_GADGET_DOWNLOAD
156 bool "Enable USB download gadget"
157 help
158 Composite USB download gadget support (g_dnl) for download functions.
159 This code works on top of composite gadget.
160
Sam Protsenkob706ffd2016-04-13 14:20:30 +0300161if USB_GADGET_DOWNLOAD
162
Lukasz Majewskie364e4b2018-01-29 19:25:54 +0100163config USB_FUNCTION_MASS_STORAGE
164 bool "Enable USB mass storage gadget"
165 help
166 Enable mass storage protocol support in U-Boot. It allows exporting
167 the eMMC/SD card content to HOST PC so it can be mounted.
168
Eddie Caif6460922017-12-15 08:17:10 +0800169config USB_FUNCTION_ROCKUSB
170 bool "Enable USB rockusb gadget"
171 help
172 Rockusb protocol is widely used by Rockchip SoC based devices. It can
173 read/write info, image to/from devices. This enables the USB part of
174 the rockusb gadget.for more detail about Rockusb protocol, please see
175 doc/README.rockusb
176
Lukasz Majewskib886ed92018-01-29 19:21:39 +0100177config USB_FUNCTION_SDP
178 bool "Enable USB SDP (Serial Download Protocol)"
179 help
180 Enable Serial Download Protocol (SDP) device support in U-Boot. This
181 allows to download images into memory and execute (jump to) them
182 using the same protocol as implemented by the i.MX family's boot ROM.
183
Lukasz Majewski3c32b422018-01-29 19:30:18 +0100184config USB_FUNCTION_THOR
185 bool "Enable USB THOR gadget"
186 help
187 Enable Tizen's THOR download protocol support in U-Boot. It
188 allows downloading images into memory and flash them to target device.
189
Loic Poulaineb78f832021-11-25 18:16:15 +0100190config USB_FUNCTION_ACM
191 bool "Enable CDC ACM gadget"
192 select SYS_STDIO_DEREGISTER
193 select CIRCBUF
194 help
195 ACM serial link. This function can be used to create a stdio device to
196 interoperate with MS-Windows hosts or with the Linux-USB "cdc-acm"
197 driver.
198
Maxime Riparda8ad6362017-09-06 22:54:52 +0200199endif # USB_GADGET_DOWNLOAD
200
Maxime Ripard65849772017-09-06 23:23:21 +0200201config USB_ETHER
202 bool "USB Ethernet Gadget"
Alex Kiernancc92df42018-04-01 09:22:36 +0000203 depends on NET
Maxime Ripard4a553ca2017-09-22 09:51:37 +0200204 default y if ARCH_SUNXI && USB_MUSB_GADGET
Maxime Ripard65849772017-09-06 23:23:21 +0200205 help
206 Creates an Ethernet network device through a USB peripheral
207 controller. This will create a network interface on both the device
208 (U-Boot) and the host (remote device) that can be used just like any
209 other nework interface.
210 It will bind on the peripheral USB controller, ignoring the USB hosts
211 controllers in the system.
212
213if USB_ETHER
214
Maxime Ripard7285f482017-09-07 08:46:14 +0200215choice
216 prompt "USB Ethernet Gadget Model"
217 default USB_ETH_RNDIS
218 help
219 There is several models (protocols) to implement Ethernet over USB
220 devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet
221 (also called CDC-ECM). RNDIS is obviously compatible with Windows,
222 while CDC-ECM is not. Most other operating systems support both, so
223 if inter-operability is a concern, RNDIS is to be preferred.
224
225config USB_ETH_CDC
226 bool "CDC-ECM Protocol"
227 help
228 CDC (Communications Device Class) is the standard for Ethernet over
229 USB devices. While there's several alternatives, the most widely used
230 protocol is ECM (Ethernet Control Model). However, compatibility with
231 Windows is not that great.
232
233config USB_ETH_RNDIS
234 bool "RNDIS Protocol"
235 help
236 The RNDIS (Remote Network Driver Interface Specification) is a
237 Microsoft proprietary protocol to create an Ethernet device over USB.
238 Windows obviously supports it, as well as all the major operating
239 systems, so it's the best option for compatibility.
240
241endchoice
242
Mugunthan V N095b7612016-11-18 11:09:15 +0530243config USBNET_DEVADDR
244 string "USB Gadget Ethernet device mac address"
245 default "de:ad:be:ef:00:01"
Maxime Ripardd4ff5312017-09-12 18:32:45 +0200246 help
247 Ethernet MAC address of the device-side (ie. local board's) MAC
248 address of the usb_ether interface
Mugunthan V N095b7612016-11-18 11:09:15 +0530249
Maxime Ripard764bf282017-09-06 22:53:43 +0200250config USBNET_HOST_ADDR
251 string "USB Gadget Ethernet host mac address"
252 default "de:ad:be:ef:00:00"
253 help
254 Ethernet MAC address of the host-side (ie. remote device's) MAC
255 address of the usb_ether interface
256
Maxime Ripard65849772017-09-06 23:23:21 +0200257endif # USB_ETHER
258
Sam Protsenkofb115b12016-04-13 14:20:24 +0300259endif # USB_GADGET