844c3be16ffc4f8109879af012db796c3a9b4091
[platform/kernel/u-boot.git] / drivers / usb / gadget / Kconfig
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"
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.
36
37 if USB_GADGET
38
39 config USB_GADGET_MANUFACTURER
40         string "Vendor name of the USB device"
41         default "Allwinner Technology" if ARCH_SUNXI
42         default "Rockchip" if ARCH_ROCKCHIP
43         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
48 config USB_GADGET_VENDOR_NUM
49         hex "Vendor ID of the USB device"
50         default 0x1f3a if ARCH_SUNXI
51         default 0x2207 if ARCH_ROCKCHIP
52         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
58 config USB_GADGET_PRODUCT_NUM
59         hex "Product ID of the USB device"
60         default 0x1010 if ARCH_SUNXI
61         default 0x0
62         help
63           Product ID of the USB device emulated, reported to the host device.
64
65 config USB_GADGET_ATMEL_USBA
66         bool "Atmel USBA"
67         select USB_GADGET_DUALSPEED
68         help
69           USBA is the integrated high-speed USB Device controller on
70           the AT32AP700x, some AT91SAM9 and AT91CAP9 processors from Atmel.
71
72 config USB_GADGET_BCM_UDC_OTG_PHY
73         bool "Broadcom UDC OTG PHY"
74         help
75           Enable the Broadcom UDC OTG physical device interface.
76
77 config USB_GADGET_DWC2_OTG
78         bool "DesignWare USB2.0 HS OTG controller (gadget mode)"
79         select USB_GADGET_DUALSPEED
80         help
81           The Designware USB2.0 high-speed gadget controller
82           integrated into many SoCs. Select this option if you want the
83           driver to operate in Peripheral mode. This option requires
84           USB_GADGET to be enabled.
85
86 if USB_GADGET_DWC2_OTG
87
88 config USB_GADGET_DWC2_OTG_PHY_BUS_WIDTH_8
89         bool "DesignWare USB2.0 HS OTG controller 8-bit PHY bus width"
90         help
91           Set the Designware USB2.0 high-speed OTG controller
92           PHY interface width to 8 bits, rather than the default (16 bits).
93
94 endif # USB_GADGET_DWC2_OTG
95
96 config CI_UDC
97         bool "ChipIdea device controller"
98         select USB_GADGET_DUALSPEED
99         help
100           Say Y here to enable device controller functionality of the
101           ChipIdea driver.
102
103 config USB_GADGET_VBUS_DRAW
104         int "Maximum VBUS Power usage (2-500 mA)"
105         range 2 500
106         default 2
107         help
108            Some devices need to draw power from USB when they are
109            configured, perhaps to operate circuitry or to recharge
110            batteries.  This is in addition to any local power supply,
111            such as an AC adapter or batteries.
112
113            Enter the maximum power your device draws through USB, in
114            milliAmperes.  The permitted range of values is 2 - 500 mA;
115            0 mA would be legal, but can make some hosts misbehave.
116
117            This value will be used except for system-specific gadget
118            drivers that have more specific information.
119
120 # Selected by UDC drivers that support high-speed operation.
121 config USB_GADGET_DUALSPEED
122         bool
123
124 config USB_GADGET_DOWNLOAD
125         bool "Enable USB download gadget"
126         help
127           Composite USB download gadget support (g_dnl) for download functions.
128           This code works on top of composite gadget.
129
130 if USB_GADGET_DOWNLOAD
131
132 config USB_FUNCTION_MASS_STORAGE
133         bool "Enable USB mass storage gadget"
134         help
135           Enable mass storage protocol support in U-Boot. It allows exporting
136           the eMMC/SD card content to HOST PC so it can be mounted.
137
138 config USB_FUNCTION_ROCKUSB
139         bool "Enable USB rockusb gadget"
140         help
141           Rockusb protocol is widely used by Rockchip SoC based devices. It can
142           read/write info, image to/from devices. This enables the USB part of
143           the rockusb gadget.for more detail about Rockusb protocol, please see
144           doc/README.rockusb
145
146 config USB_FUNCTION_SDP
147         bool "Enable USB SDP (Serial Download Protocol)"
148         help
149           Enable Serial Download Protocol (SDP) device support in U-Boot. This
150           allows to download images into memory and execute (jump to) them
151           using the same protocol as implemented by the i.MX family's boot ROM.
152
153 config USB_FUNCTION_THOR
154         bool "Enable USB THOR gadget"
155         help
156           Enable Tizen's THOR download protocol support in U-Boot. It
157           allows downloading images into memory and flash them to target device.
158
159 endif # USB_GADGET_DOWNLOAD
160
161 config USB_ETHER
162         bool "USB Ethernet Gadget"
163         depends on NET
164         default y if ARCH_SUNXI && USB_MUSB_GADGET
165         help
166           Creates an Ethernet network device through a USB peripheral
167           controller. This will create a network interface on both the device
168           (U-Boot) and the host (remote device) that can be used just like any
169           other nework interface.
170           It will bind on the peripheral USB controller, ignoring the USB hosts
171           controllers in the system.
172
173 if USB_ETHER
174
175 choice
176         prompt "USB Ethernet Gadget Model"
177         default USB_ETH_RNDIS
178         help
179           There is several models (protocols) to implement Ethernet over USB
180           devices. The main ones are Microsoft's RNDIS and USB's CDC-Ethernet
181           (also called CDC-ECM). RNDIS is obviously compatible with Windows,
182           while CDC-ECM is not. Most other operating systems support both, so
183           if inter-operability is a concern, RNDIS is to be preferred.
184
185 config USB_ETH_CDC
186         bool "CDC-ECM Protocol"
187         help
188           CDC (Communications Device Class) is the standard for Ethernet over
189           USB devices. While there's several alternatives, the most widely used
190           protocol is ECM (Ethernet Control Model). However, compatibility with
191           Windows is not that great.
192
193 config USB_ETH_RNDIS
194         bool "RNDIS Protocol"
195         help
196           The RNDIS (Remote Network Driver Interface Specification) is a
197           Microsoft proprietary protocol to create an Ethernet device over USB.
198           Windows obviously supports it, as well as all the major operating
199           systems, so it's the best option for compatibility.
200
201 endchoice
202
203 config USBNET_DEVADDR
204         string "USB Gadget Ethernet device mac address"
205         default "de:ad:be:ef:00:01"
206         help
207           Ethernet MAC address of the device-side (ie. local board's) MAC
208           address of the usb_ether interface
209
210 config USBNET_HOST_ADDR
211         string "USB Gadget Ethernet host mac address"
212         default "de:ad:be:ef:00:00"
213         help
214           Ethernet MAC address of the host-side (ie. remote device's) MAC
215           address of the usb_ether interface
216
217 endif # USB_ETHER
218
219 endif # USB_GADGET