blob: 6825e6b5434f4b7e844f5b804c5e24a893dd1d2e [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
Maxime Riparda95aee62017-09-07 08:58:08 +020042 default "U-Boot"
43 help
44 Vendor name of the USB device emulated, reported to the host device.
45 This is usually either the manufacturer of the device or the SoC.
46
47config USB_GADGET_VENDOR_NUM
48 hex "Vendor ID of the USB device"
Maxime Riparde02687b2017-09-12 19:41:15 +020049 default 0x1f3a if ARCH_SUNXI
Maxime Riparda95aee62017-09-07 08:58:08 +020050 default 0x0
51 help
52 Vendor ID of the USB device emulated, reported to the host device.
53 This is usually the board or SoC vendor's, unless you've registered
54 for one.
55
56config USB_GADGET_PRODUCT_NUM
57 hex "Product ID of the USB device"
Maxime Riparde02687b2017-09-12 19:41:15 +020058 default 0x1010 if ARCH_SUNXI
Maxime Riparda95aee62017-09-07 08:58:08 +020059 default 0x0
60 help
61 Product ID of the USB device emulated, reported to the host device.
62
Sam Protsenko3457bba2016-04-13 14:20:25 +030063config USB_GADGET_ATMEL_USBA
64 bool "Atmel USBA"
65 select USB_GADGET_DUALSPEED
66 help
67 USBA is the integrated high-speed USB Device controller on
68 the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
69
Steve Raee016f0b2016-08-15 17:26:26 -070070config USB_GADGET_BCM_UDC_OTG_PHY
71 bool "Broadcom UDC OTG PHY"
72 help
73 Enable the Broadcom UDC OTG physical device interface.
74
Sam Protsenko3457bba2016-04-13 14:20:25 +030075config USB_GADGET_DWC2_OTG
76 bool "DesignWare USB2.0 HS OTG controller (gadget mode)"
77 select USB_GADGET_DUALSPEED
78 help
79 The Designware USB2.0 high-speed gadget controller
80 integrated into many SoCs. Select this option if you want the
81 driver to operate in Peripheral mode. This option requires
82 USB_GADGET to be enabled.
83
Steve Raef221db02016-06-07 15:35:21 -070084if USB_GADGET_DWC2_OTG
85
86config USB_GADGET_DWC2_OTG_PHY_BUS_WIDTH_8
87 bool "DesignWare USB2.0 HS OTG controller 8-bit PHY bus width"
88 help
89 Set the Designware USB2.0 high-speed OTG controller
90 PHY interface width to 8 bits, rather than the default (16 bits).
91
92endif # USB_GADGET_DWC2_OTG
93
Sam Protsenko3457bba2016-04-13 14:20:25 +030094config CI_UDC
95 bool "ChipIdea device controller"
96 select USB_GADGET_DUALSPEED
97 help
98 Say Y here to enable device controller functionality of the
99 ChipIdea driver.
100
Sam Protsenkoa59a77f2016-04-13 14:20:24 +0300101config USB_GADGET_VBUS_DRAW
102 int "Maximum VBUS Power usage (2-500 mA)"
103 range 2 500
104 default 2
105 help
106 Some devices need to draw power from USB when they are
107 configured, perhaps to operate circuitry or to recharge
108 batteries. This is in addition to any local power supply,
109 such as an AC adapter or batteries.
110
111 Enter the maximum power your device draws through USB, in
112 milliAmperes. The permitted range of values is 2 - 500 mA;
113 0 mA would be legal, but can make some hosts misbehave.
114
115 This value will be used except for system-specific gadget
116 drivers that have more specific information.
117
Sam Protsenko3457bba2016-04-13 14:20:25 +0300118# Selected by UDC drivers that support high-speed operation.
119config USB_GADGET_DUALSPEED
120 bool
121
Sam Protsenkoaaa4a9e2016-04-13 14:20:26 +0300122config USB_GADGET_DOWNLOAD
123 bool "Enable USB download gadget"
124 help
125 Composite USB download gadget support (g_dnl) for download functions.
126 This code works on top of composite gadget.
127
Sam Protsenkoe6c0bc02016-04-13 14:20:30 +0300128if USB_GADGET_DOWNLOAD
129
Lukasz Majewski4f60e5d2018-01-29 19:25:54 +0100130config USB_FUNCTION_MASS_STORAGE
131 bool "Enable USB mass storage gadget"
132 help
133 Enable mass storage protocol support in U-Boot. It allows exporting
134 the eMMC/SD card content to HOST PC so it can be mounted.
135
Eddie Caibf2b72b2017-12-15 08:17:10 +0800136config USB_FUNCTION_ROCKUSB
137 bool "Enable USB rockusb gadget"
138 help
139 Rockusb protocol is widely used by Rockchip SoC based devices. It can
140 read/write info, image to/from devices. This enables the USB part of
141 the rockusb gadget.for more detail about Rockusb protocol, please see
142 doc/README.rockusb
143
Lukasz Majewskib7696592018-01-29 19:21:39 +0100144config USB_FUNCTION_SDP
145 bool "Enable USB SDP (Serial Download Protocol)"
146 help
147 Enable Serial Download Protocol (SDP) device support in U-Boot. This
148 allows to download images into memory and execute (jump to) them
149 using the same protocol as implemented by the i.MX family's boot ROM.
150
Lukasz Majewskic6c1ca12018-01-29 19:30:18 +0100151config USB_FUNCTION_THOR
152 bool "Enable USB THOR gadget"
153 help
154 Enable Tizen's THOR download protocol support in U-Boot. It
155 allows downloading images into memory and flash them to target device.
156
Maxime Ripard5506ff12017-09-06 22:54:52 +0200157endif # USB_GADGET_DOWNLOAD
158
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200159config USB_ETHER
160 bool "USB Ethernet Gadget"
Maxime Ripard3c989f32017-09-22 09:51:37 +0200161 default y if ARCH_SUNXI && USB_MUSB_GADGET
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200162 help
163 Creates an Ethernet network device through a USB peripheral
164 controller. This will create a network interface on both the device
165 (U-Boot) and the host (remote device) that can be used just like any
166 other nework interface.
167 It will bind on the peripheral USB controller, ignoring the USB hosts
168 controllers in the system.
169
170if USB_ETHER
171
Maxime Ripardd2f0f4a2017-09-07 08:46:14 +0200172choice
173 prompt "USB Ethernet Gadget Model"
174 default USB_ETH_RNDIS
175 help
176 There is several models (protocols) to implement Ethernet over USB
177 devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet
178 (also called CDC-ECM). RNDIS is obviously compatible with Windows,
179 while CDC-ECM is not. Most other operating systems support both, so
180 if inter-operability is a concern, RNDIS is to be preferred.
181
182config USB_ETH_CDC
183 bool "CDC-ECM Protocol"
184 help
185 CDC (Communications Device Class) is the standard for Ethernet over
186 USB devices. While there's several alternatives, the most widely used
187 protocol is ECM (Ethernet Control Model). However, compatibility with
188 Windows is not that great.
189
190config USB_ETH_RNDIS
191 bool "RNDIS Protocol"
192 help
193 The RNDIS (Remote Network Driver Interface Specification) is a
194 Microsoft proprietary protocol to create an Ethernet device over USB.
195 Windows obviously supports it, as well as all the major operating
196 systems, so it's the best option for compatibility.
197
198endchoice
199
Mugunthan V Nd4a37552016-11-18 11:09:15 +0530200config USBNET_DEVADDR
201 string "USB Gadget Ethernet device mac address"
202 default "de:ad:be:ef:00:01"
Maxime Ripard74e79972017-09-12 18:32:45 +0200203 help
204 Ethernet MAC address of the device-side (ie. local board's) MAC
205 address of the usb_ether interface
Mugunthan V Nd4a37552016-11-18 11:09:15 +0530206
Maxime Ripardc1636682017-09-06 22:53:43 +0200207config USBNET_HOST_ADDR
208 string "USB Gadget Ethernet host mac address"
209 default "de:ad:be:ef:00:00"
210 help
211 Ethernet MAC address of the host-side (ie. remote device's) MAC
212 address of the usb_ether interface
213
Maxime Ripard3f33d3c2017-09-06 23:23:21 +0200214endif # USB_ETHER
215
Sam Protsenkoa59a77f2016-04-13 14:20:24 +0300216endif # USB_GADGET