blob: 7c0df5c264de016aa09592152979fa635371a45a [file] [log] [blame]
Sam Protsenkof9d0fd82016-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"
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 Protsenkoa59a77f2016-04-13 14:20:24 +030036
37if USB_GADGET
38
Maxime Riparda95aee62017-09-07 08:58:08 +020039config USB_GADGET_MANUFACTURER
40 string "Vendor name of the USB device"
Maxime Riparde02687b2017-09-12 19:41:15 +020041 default "Allwinner Technology" if ARCH_SUNXI
Jagan Teki89e311d2019-11-19 13:56:14 +053042 default "Rockchip" if ARCH_ROCKCHIP
Maxime Riparda95aee62017-09-07 08:58:08 +020043 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
48config USB_GADGET_VENDOR_NUM
49 hex "Vendor ID of the USB device"
Maxime Riparde02687b2017-09-12 19:41:15 +020050 default 0x1f3a if ARCH_SUNXI
Jagan Teki89cbceb2019-11-19 13:56:15 +053051 default 0x2207 if ARCH_ROCKCHIP
Maxime Riparda95aee62017-09-07 08:58:08 +020052 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
58config USB_GADGET_PRODUCT_NUM
59 hex "Product ID of the USB device"
Maxime Riparde02687b2017-09-12 19:41:15 +020060 default 0x1010 if ARCH_SUNXI
Jagan Teki132b0122019-11-19 13:56:16 +053061 default 0x310a if ROCKCHIP_RK3036
Jagan Tekib0320612019-11-19 13:56:17 +053062 default 0x310c if ROCKCHIP_RK3128
Jagan Teki132b0122019-11-19 13:56:16 +053063 default 0x320a if ROCKCHIP_RK3229 || ROCKCHIP_RK3288
64 default 0x330a if ROCKCHIP_RK3328
Jagan Teki3d3b83a2019-11-19 13:56:21 +053065 default 0x330c if ROCKCHIP_RK3399
Maxime Riparda95aee62017-09-07 08:58:08 +020066 default 0x0
67 help
68 Product ID of the USB device emulated, reported to the host device.
69
Sam Protsenko3457bba2016-04-13 14:20:25 +030070config 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 Raee016f0b2016-08-15 17:26:26 -070077config 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 Protsenko3457bba2016-04-13 14:20:25 +030082config 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 Raef221db02016-06-07 15:35:21 -070091if USB_GADGET_DWC2_OTG
92
93config 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
99endif # USB_GADGET_DWC2_OTG
100
Sam Protsenko3457bba2016-04-13 14:20:25 +0300101config 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
Jassi Brar7ed4eac2020-07-29 20:51:27 -0500108config USB_GADGET_MAX3420
109 bool "MAX3420 USB Over SPI"
110 depends on DM_SPI
111 help
112 MAX3420, from MAXIM, implements USB-over-SPI Full-Speed device controller.
113
Sam Protsenkoa59a77f2016-04-13 14:20:24 +0300114config USB_GADGET_VBUS_DRAW
115 int "Maximum VBUS Power usage (2-500 mA)"
116 range 2 500
117 default 2
118 help
119 Some devices need to draw power from USB when they are
120 configured, perhaps to operate circuitry or to recharge
121 batteries. This is in addition to any local power supply,
122 such as an AC adapter or batteries.
123
124 Enter the maximum power your device draws through USB, in
125 milliAmperes. The permitted range of values is 2 - 500 mA;
126 0 mA would be legal, but can make some hosts misbehave.
127
128 This value will be used except for system-specific gadget
129 drivers that have more specific information.
130
Frank Li8f95c012020-04-29 10:35:11 +0800131config SDP_LOADADDR
132 hex "Default load address at SDP_WRITE and SDP_JUMP"
133 default 0
134
Sam Protsenko3457bba2016-04-13 14:20:25 +0300135# Selected by UDC drivers that support high-speed operation.
136config USB_GADGET_DUALSPEED
137 bool
138
Sam Protsenkoaaa4a9e2016-04-13 14:20:26 +0300139config USB_GADGET_DOWNLOAD
140 bool "Enable USB download gadget"
141 help
142 Composite USB download gadget support (g_dnl) for download functions.
143 This code works on top of composite gadget.
144
Sam Protsenkoe6c0bc02016-04-13 14:20:30 +0300145if USB_GADGET_DOWNLOAD
146
Lukasz Majewski4f60e5d2018-01-29 19:25:54 +0100147config USB_FUNCTION_MASS_STORAGE
148 bool "Enable USB mass storage gadget"
149 help
150 Enable mass storage protocol support in U-Boot. It allows exporting
151 the eMMC/SD card content to HOST PC so it can be mounted.
152
Eddie Caibf2b72b2017-12-15 08:17:10 +0800153config USB_FUNCTION_ROCKUSB
154 bool "Enable USB rockusb gadget"
155 help
156 Rockusb protocol is widely used by Rockchip SoC based devices. It can
157 read/write info, image to/from devices. This enables the USB part of
158 the rockusb gadget.for more detail about Rockusb protocol, please see
159 doc/README.rockusb
160
Lukasz Majewskib7696592018-01-29 19:21:39 +0100161config USB_FUNCTION_SDP
162 bool "Enable USB SDP (Serial Download Protocol)"
163 help
164 Enable Serial Download Protocol (SDP) device support in U-Boot. This
165 allows to download images into memory and execute (jump to) them
166 using the same protocol as implemented by the i.MX family's boot ROM.
167
Lukasz Majewskic6c1ca12018-01-29 19:30:18 +0100168config USB_FUNCTION_THOR
169 bool "Enable USB THOR gadget"
170 help
171 Enable Tizen's THOR download protocol support in U-Boot. It
172 allows downloading images into memory and flash them to target device.
173
Maxime Ripard5506ff12017-09-06 22:54:52 +0200174endif # USB_GADGET_DOWNLOAD
175
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200176config USB_ETHER
177 bool "USB Ethernet Gadget"
Alex Kiernana18d1062018-04-01 09:22:36 +0000178 depends on NET
Maxime Ripard3c989f32017-09-22 09:51:37 +0200179 default y if ARCH_SUNXI && USB_MUSB_GADGET
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200180 help
181 Creates an Ethernet network device through a USB peripheral
182 controller. This will create a network interface on both the device
183 (U-Boot) and the host (remote device) that can be used just like any
184 other nework interface.
185 It will bind on the peripheral USB controller, ignoring the USB hosts
186 controllers in the system.
187
188if USB_ETHER
189
Maxime Ripardd2f0f4a2017-09-07 08:46:14 +0200190choice
191 prompt "USB Ethernet Gadget Model"
192 default USB_ETH_RNDIS
193 help
194 There is several models (protocols) to implement Ethernet over USB
195 devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet
196 (also called CDC-ECM). RNDIS is obviously compatible with Windows,
197 while CDC-ECM is not. Most other operating systems support both, so
198 if inter-operability is a concern, RNDIS is to be preferred.
199
200config USB_ETH_CDC
201 bool "CDC-ECM Protocol"
202 help
203 CDC (Communications Device Class) is the standard for Ethernet over
204 USB devices. While there's several alternatives, the most widely used
205 protocol is ECM (Ethernet Control Model). However, compatibility with
206 Windows is not that great.
207
208config USB_ETH_RNDIS
209 bool "RNDIS Protocol"
210 help
211 The RNDIS (Remote Network Driver Interface Specification) is a
212 Microsoft proprietary protocol to create an Ethernet device over USB.
213 Windows obviously supports it, as well as all the major operating
214 systems, so it's the best option for compatibility.
215
216endchoice
217
Mugunthan V Nd4a37552016-11-18 11:09:15 +0530218config USBNET_DEVADDR
219 string "USB Gadget Ethernet device mac address"
220 default "de:ad:be:ef:00:01"
Maxime Ripard74e79972017-09-12 18:32:45 +0200221 help
222 Ethernet MAC address of the device-side (ie. local board's) MAC
223 address of the usb_ether interface
Mugunthan V Nd4a37552016-11-18 11:09:15 +0530224
Maxime Ripardc1636682017-09-06 22:53:43 +0200225config USBNET_HOST_ADDR
226 string "USB Gadget Ethernet host mac address"
227 default "de:ad:be:ef:00:00"
228 help
229 Ethernet MAC address of the host-side (ie. remote device's) MAC
230 address of the usb_ether interface
231
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200232endif # USB_ETHER
233
Sam Protsenkoa59a77f2016-04-13 14:20:24 +0300234endif # USB_GADGET