blob: 1959a390f3fc365e05c34e84196b0fcbfdf1786d [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"
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 Protsenkofb115b12016-04-13 14:20:24 +030036
37if USB_GADGET
38
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020039config USB_GADGET_MANUFACTURER
40 string "Vendor name of the USB device"
Maxime Ripard6375bd82017-09-12 19:41:15 +020041 default "Allwinner Technology" if ARCH_SUNXI
Jagan Tekic1153892019-11-19 13:56:14 +053042 default "Rockchip" if ARCH_ROCKCHIP
Maxime Ripard7f78b9d2017-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 Ripard6375bd82017-09-12 19:41:15 +020050 default 0x1f3a if ARCH_SUNXI
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020051 default 0x0
52 help
53 Vendor ID of the USB device emulated, reported to the host device.
54 This is usually the board or SoC vendor's, unless you've registered
55 for one.
56
57config USB_GADGET_PRODUCT_NUM
58 hex "Product ID of the USB device"
Maxime Ripard6375bd82017-09-12 19:41:15 +020059 default 0x1010 if ARCH_SUNXI
Maxime Ripard7f78b9d2017-09-07 08:58:08 +020060 default 0x0
61 help
62 Product ID of the USB device emulated, reported to the host device.
63
Sam Protsenkob4a0bf72016-04-13 14:20:25 +030064config USB_GADGET_ATMEL_USBA
65 bool "Atmel USBA"
66 select USB_GADGET_DUALSPEED
67 help
68 USBA is the integrated high-speed USB Device controller on
69 the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
70
Steve Rae437689f2016-08-15 17:26:26 -070071config USB_GADGET_BCM_UDC_OTG_PHY
72 bool "Broadcom UDC OTG PHY"
73 help
74 Enable the Broadcom UDC OTG physical device interface.
75
Sam Protsenkob4a0bf72016-04-13 14:20:25 +030076config USB_GADGET_DWC2_OTG
77 bool "DesignWare USB2.0 HS OTG controller (gadget mode)"
78 select USB_GADGET_DUALSPEED
79 help
80 The Designware USB2.0 high-speed gadget controller
81 integrated into many SoCs. Select this option if you want the
82 driver to operate in Peripheral mode. This option requires
83 USB_GADGET to be enabled.
84
Steve Raed7198f32016-06-07 15:35:21 -070085if USB_GADGET_DWC2_OTG
86
87config USB_GADGET_DWC2_OTG_PHY_BUS_WIDTH_8
88 bool "DesignWare USB2.0 HS OTG controller 8-bit PHY bus width"
89 help
90 Set the Designware USB2.0 high-speed OTG controller
91 PHY interface width to 8 bits, rather than the default (16 bits).
92
93endif # USB_GADGET_DWC2_OTG
94
Sam Protsenkob4a0bf72016-04-13 14:20:25 +030095config CI_UDC
96 bool "ChipIdea device controller"
97 select USB_GADGET_DUALSPEED
98 help
99 Say Y here to enable device controller functionality of the
100 ChipIdea driver.
101
Sam Protsenkofb115b12016-04-13 14:20:24 +0300102config USB_GADGET_VBUS_DRAW
103 int "Maximum VBUS Power usage (2-500 mA)"
104 range 2 500
105 default 2
106 help
107 Some devices need to draw power from USB when they are
108 configured, perhaps to operate circuitry or to recharge
109 batteries. This is in addition to any local power supply,
110 such as an AC adapter or batteries.
111
112 Enter the maximum power your device draws through USB, in
113 milliAmperes. The permitted range of values is 2 - 500 mA;
114 0 mA would be legal, but can make some hosts misbehave.
115
116 This value will be used except for system-specific gadget
117 drivers that have more specific information.
118
Sam Protsenkob4a0bf72016-04-13 14:20:25 +0300119# Selected by UDC drivers that support high-speed operation.
120config USB_GADGET_DUALSPEED
121 bool
122
Sam Protsenko4d2439d2016-04-13 14:20:26 +0300123config USB_GADGET_DOWNLOAD
124 bool "Enable USB download gadget"
125 help
126 Composite USB download gadget support (g_dnl) for download functions.
127 This code works on top of composite gadget.
128
Sam Protsenkob706ffd2016-04-13 14:20:30 +0300129if USB_GADGET_DOWNLOAD
130
Lukasz Majewskie364e4b2018-01-29 19:25:54 +0100131config USB_FUNCTION_MASS_STORAGE
132 bool "Enable USB mass storage gadget"
133 help
134 Enable mass storage protocol support in U-Boot. It allows exporting
135 the eMMC/SD card content to HOST PC so it can be mounted.
136
Eddie Caif6460922017-12-15 08:17:10 +0800137config USB_FUNCTION_ROCKUSB
138 bool "Enable USB rockusb gadget"
139 help
140 Rockusb protocol is widely used by Rockchip SoC based devices. It can
141 read/write info, image to/from devices. This enables the USB part of
142 the rockusb gadget.for more detail about Rockusb protocol, please see
143 doc/README.rockusb
144
Lukasz Majewskib886ed92018-01-29 19:21:39 +0100145config USB_FUNCTION_SDP
146 bool "Enable USB SDP (Serial Download Protocol)"
147 help
148 Enable Serial Download Protocol (SDP) device support in U-Boot. This
149 allows to download images into memory and execute (jump to) them
150 using the same protocol as implemented by the i.MX family's boot ROM.
151
Lukasz Majewski3c32b422018-01-29 19:30:18 +0100152config USB_FUNCTION_THOR
153 bool "Enable USB THOR gadget"
154 help
155 Enable Tizen's THOR download protocol support in U-Boot. It
156 allows downloading images into memory and flash them to target device.
157
Maxime Riparda8ad6362017-09-06 22:54:52 +0200158endif # USB_GADGET_DOWNLOAD
159
Maxime Ripard65849772017-09-06 23:23:21 +0200160config USB_ETHER
161 bool "USB Ethernet Gadget"
Alex Kiernancc92df42018-04-01 09:22:36 +0000162 depends on NET
Maxime Ripard4a553ca2017-09-22 09:51:37 +0200163 default y if ARCH_SUNXI && USB_MUSB_GADGET
Maxime Ripard65849772017-09-06 23:23:21 +0200164 help
165 Creates an Ethernet network device through a USB peripheral
166 controller. This will create a network interface on both the device
167 (U-Boot) and the host (remote device) that can be used just like any
168 other nework interface.
169 It will bind on the peripheral USB controller, ignoring the USB hosts
170 controllers in the system.
171
172if USB_ETHER
173
Maxime Ripard7285f482017-09-07 08:46:14 +0200174choice
175 prompt "USB Ethernet Gadget Model"
176 default USB_ETH_RNDIS
177 help
178 There is several models (protocols) to implement Ethernet over USB
179 devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet
180 (also called CDC-ECM). RNDIS is obviously compatible with Windows,
181 while CDC-ECM is not. Most other operating systems support both, so
182 if inter-operability is a concern, RNDIS is to be preferred.
183
184config USB_ETH_CDC
185 bool "CDC-ECM Protocol"
186 help
187 CDC (Communications Device Class) is the standard for Ethernet over
188 USB devices. While there's several alternatives, the most widely used
189 protocol is ECM (Ethernet Control Model). However, compatibility with
190 Windows is not that great.
191
192config USB_ETH_RNDIS
193 bool "RNDIS Protocol"
194 help
195 The RNDIS (Remote Network Driver Interface Specification) is a
196 Microsoft proprietary protocol to create an Ethernet device over USB.
197 Windows obviously supports it, as well as all the major operating
198 systems, so it's the best option for compatibility.
199
200endchoice
201
Mugunthan V N095b7612016-11-18 11:09:15 +0530202config USBNET_DEVADDR
203 string "USB Gadget Ethernet device mac address"
204 default "de:ad:be:ef:00:01"
Maxime Ripardd4ff5312017-09-12 18:32:45 +0200205 help
206 Ethernet MAC address of the device-side (ie. local board's) MAC
207 address of the usb_ether interface
Mugunthan V N095b7612016-11-18 11:09:15 +0530208
Maxime Ripard764bf282017-09-06 22:53:43 +0200209config USBNET_HOST_ADDR
210 string "USB Gadget Ethernet host mac address"
211 default "de:ad:be:ef:00:00"
212 help
213 Ethernet MAC address of the host-side (ie. remote device's) MAC
214 address of the usb_ether interface
215
Maxime Ripard65849772017-09-06 23:23:21 +0200216endif # USB_ETHER
217
Sam Protsenkofb115b12016-04-13 14:20:24 +0300218endif # USB_GADGET