hc
2023-12-11 d2ccde1c8e90d38cee87a1b0309ad2827f3fd30d
kernel/drivers/usb/gadget/legacy/Kconfig
....@@ -13,32 +13,28 @@
1313 # With help from a special transceiver and a "Mini-AB" jack, systems with
1414 # both kinds of controller can also support "USB On-the-Go" (CONFIG_USB_OTG).
1515 #
16
+# A Linux "Gadget Driver" talks to the USB Peripheral Controller
17
+# driver through the abstract "gadget" API. Some other operating
18
+# systems call these "client" drivers, of which "class drivers"
19
+# are a subset (implementing a USB device class specification).
20
+# A gadget driver implements one or more USB functions using
21
+# the peripheral hardware.
22
+#
23
+# Gadget drivers are hardware-neutral, or "platform independent",
24
+# except that they sometimes must understand quirks or limitations
25
+# of the particular controllers they work with. For example, when
26
+# a controller doesn't support alternate configurations or provide
27
+# enough of the right types of endpoints, the gadget driver might
28
+# not be able work with that controller, or might need to implement
29
+# a less common variant of a device class protocol.
30
+#
31
+# The available choices each represent a single precomposed USB
32
+# gadget configuration. In the device model, each option contains
33
+# both the device instantiation as a child for a USB gadget
34
+# controller, and the relevant drivers for each function declared
35
+# by the device.
1636
17
-choice
18
- tristate "USB Gadget precomposed configurations"
19
- default USB_ETH
20
- optional
21
- help
22
- A Linux "Gadget Driver" talks to the USB Peripheral Controller
23
- driver through the abstract "gadget" API. Some other operating
24
- systems call these "client" drivers, of which "class drivers"
25
- are a subset (implementing a USB device class specification).
26
- A gadget driver implements one or more USB functions using
27
- the peripheral hardware.
28
-
29
- Gadget drivers are hardware-neutral, or "platform independent",
30
- except that they sometimes must understand quirks or limitations
31
- of the particular controllers they work with. For example, when
32
- a controller doesn't support alternate configurations or provide
33
- enough of the right types of endpoints, the gadget driver might
34
- not be able work with that controller, or might need to implement
35
- a less common variant of a device class protocol.
36
-
37
- The available choices each represent a single precomposed USB
38
- gadget configuration. In the device model, each option contains
39
- both the device instantiation as a child for a USB gadget
40
- controller, and the relevant drivers for each function declared
41
- by the device.
37
+menu "USB Gadget precomposed configurations"
4238
4339 config USB_ZERO
4440 tristate "Gadget Zero (DEVELOPMENT)"
....@@ -175,22 +171,21 @@
175171 is given in comments found in that info file.
176172
177173 config USB_ETH_EEM
178
- bool "Ethernet Emulation Model (EEM) support"
179
- depends on USB_ETH
174
+ bool "Ethernet Emulation Model (EEM) support"
175
+ depends on USB_ETH
180176 select USB_LIBCOMPOSITE
181177 select USB_F_EEM
182
- default n
183
- help
184
- CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
185
- and therefore can be supported by more hardware. Technically ECM and
186
- EEM are designed for different applications. The ECM model extends
187
- the network interface to the target (e.g. a USB cable modem), and the
188
- EEM model is for mobile devices to communicate with hosts using
189
- ethernet over USB. For Linux gadgets, however, the interface with
190
- the host is the same (a usbX device), so the differences are minimal.
178
+ help
179
+ CDC EEM is a newer USB standard that is somewhat simpler than CDC ECM
180
+ and therefore can be supported by more hardware. Technically ECM and
181
+ EEM are designed for different applications. The ECM model extends
182
+ the network interface to the target (e.g. a USB cable modem), and the
183
+ EEM model is for mobile devices to communicate with hosts using
184
+ ethernet over USB. For Linux gadgets, however, the interface with
185
+ the host is the same (a usbX device), so the differences are minimal.
191186
192
- If you say "y" here, the Ethernet gadget driver will use the EEM
193
- protocol rather than ECM. If unsure, say "n".
187
+ If you say "y" here, the Ethernet gadget driver will use the EEM
188
+ protocol rather than ECM. If unsure, say "n".
194189
195190 config USB_G_NCM
196191 tristate "Network Control Model (NCM) support"
....@@ -314,7 +309,7 @@
314309 Say "y" to link the driver statically, or "m" to build a
315310 dynamically linked module called "g_serial".
316311
317
- For more information, see Documentation/usb/gadget_serial.txt
312
+ For more information, see Documentation/usb/gadget_serial.rst
318313 which includes instructions and a "driver info file" needed to
319314 make MS-Windows work with CDC ACM.
320315
....@@ -348,7 +343,7 @@
348343 Say "y" to link the driver statically, or "m" to build a
349344 dynamically linked module called "g_printer".
350345
351
- For more information, see Documentation/usb/gadget_printer.txt
346
+ For more information, see Documentation/usb/gadget_printer.rst
352347 which includes sample code for accessing the device file.
353348
354349 if TTY
....@@ -445,7 +440,6 @@
445440 config USB_G_MULTI_CDC
446441 bool "CDC Ethernet + CDC Serial + Storage configuration"
447442 depends on USB_G_MULTI
448
- default n
449443 select USB_F_ECM
450444 help
451445 This option enables a configuration with CDC Ethernet (ECM), CDC
....@@ -464,7 +458,7 @@
464458 The HID gadget driver provides generic emulation of USB
465459 Human Interface Devices (HID).
466460
467
- For more information, see Documentation/usb/gadget_hid.txt which
461
+ For more information, see Documentation/usb/gadget_hid.rst which
468462 includes sample code for accessing the device files.
469463
470464 Say "y" to link the driver statically, or "m" to build a
....@@ -529,4 +523,4 @@
529523 Say "y" to link the driver statically, or "m" to build a
530524 dynamically linked module called "raw_gadget".
531525
532
-endchoice
526
+endmenu