blob: e1759d17ac5d17ca9cafeea4d67094954af07462 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#
2# USB Core configuration
3#
4config USB_DEBUG
5 bool "USB verbose debug messages"
6 depends on USB
7 help
8 Say Y here if you want the USB core & hub drivers to produce a bunch
9 of debug messages to the system log. Select this if you are having a
10 problem with USB support and want to see more of what is going on.
11
Greg Kroah-Hartmanf2a383e2007-11-26 22:11:55 -080012config USB_ANNOUNCE_NEW_DEVICES
13 bool "USB announce new devices"
14 depends on USB
15 default N
16 help
17 Say Y here if you want the USB core to always announce the
18 idVendor, idProduct, Manufacturer, Product, and SerialNumber
19 strings for every new USB device to the syslog. This option is
20 usually used by distro vendors to help with debugging and to
21 let users know what specific device was added to the machine
22 in what location.
23
24 If you do not want this kind of information sent to the system
25 log, or have any doubts about this, say N here.
26
Linus Torvalds1da177e2005-04-16 15:20:36 -070027comment "Miscellaneous USB options"
28 depends on USB
29
30config USB_DEVICEFS
31 bool "USB device filesystem"
32 depends on USB
33 ---help---
34 If you say Y here (and to "/proc file system support" in the "File
35 systems" section, above), you will get a file /proc/bus/usb/devices
36 which lists the devices currently connected to your USB bus or
37 busses, and for every connected device a file named
38 "/proc/bus/usb/xxx/yyy", where xxx is the bus number and yyy the
39 device number; the latter files can be used by user space programs
40 to talk directly to the device. These files are "virtual", meaning
41 they are generated on the fly and not stored on the hard drive.
42
43 You may need to mount the usbfs file system to see the files, use
44 mount -t usbfs none /proc/bus/usb
45
46 For the format of the various /proc/bus/usb/ files, please read
47 <file:Documentation/usb/proc_usb_info.txt>.
48
Kay Sievers9f8b17e2007-03-13 15:59:31 +010049 Usbfs files can't handle Access Control Lists (ACL), which are the
50 default way to grant access to USB devices for untrusted users of a
51 desktop system. The usbfs functionality is replaced by real
52 device-nodes managed by udev. These nodes live in /dev/bus/usb and
53 are used by libusb.
54
55config USB_DEVICE_CLASS
56 bool "USB device class-devices (DEPRECATED)"
57 depends on USB
Kay Sieversdda034b2007-05-27 17:04:58 +020058 default y
Kay Sievers9f8b17e2007-03-13 15:59:31 +010059 ---help---
60 Userspace access to USB devices is granted by device-nodes exported
61 directly from the usbdev in sysfs. Old versions of the driver
62 core and udev needed additional class devices to export device nodes.
63
64 These additional devices are difficult to handle in userspace, if
Kay Sieversdda034b2007-05-27 17:04:58 +020065 information about USB interfaces must be available. One device
66 contains the device node, the other device contains the interface
67 data. Both devices are at the same level in sysfs (siblings) and one
68 can't access the other. The device node created directly by the
69 usb device is the parent device of the interface and therefore
70 easily accessible from the interface event.
Kay Sievers9f8b17e2007-03-13 15:59:31 +010071
Kay Sieversdda034b2007-05-27 17:04:58 +020072 This option provides backward compatibility for libusb device
73 nodes (lsusb) when usbfs is not used, and the following udev rule
74 doesn't exist:
75 SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
76 NAME="bus/usb/$env{BUSNUM}/$env{DEVNUM}", MODE="0644"
Linus Torvalds1da177e2005-04-16 15:20:36 -070077
Linus Torvalds1da177e2005-04-16 15:20:36 -070078config USB_DYNAMIC_MINORS
Robert P. J. Dayb6719992008-03-08 03:12:44 -050079 bool "Dynamic USB minor allocation"
80 depends on USB
Linus Torvalds1da177e2005-04-16 15:20:36 -070081 help
82 If you say Y here, the USB subsystem will use dynamic minor
83 allocation for any device that uses the USB major number.
84 This means that you can have more than 16 of a single type
85 of device (like USB printers).
86
87 If you are unsure about this, say N here.
88
89config USB_SUSPEND
Alan Sternc2c8d1f2008-02-25 11:43:32 -050090 bool "USB selective suspend/resume and wakeup"
91 depends on USB && PM
Linus Torvalds1da177e2005-04-16 15:20:36 -070092 help
93 If you say Y here, you can use driver calls or the sysfs
Alan Sternc2c8d1f2008-02-25 11:43:32 -050094 "power/level" file to suspend or resume individual USB
95 peripherals and to enable or disable autosuspend (see
96 Documentation/usb/power-management.txt for more details).
David Brownellf3f32532005-09-22 22:37:29 -070097
98 Also, USB "remote wakeup" signaling is supported, whereby some
99 USB devices (like keyboards and network adapters) can wake up
100 their parent hub. That wakeup cascades up the USB tree, and
101 could wake the system from states like suspend-to-RAM.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102
103 If you are unsure about this, say N here.
104
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105config USB_OTG
106 bool
107 depends on USB && EXPERIMENTAL
108 select USB_SUSPEND
109 default n
110
111
112config USB_OTG_WHITELIST
113 bool "Rely on OTG Targeted Peripherals List"
Robin Getz22552b22008-03-05 23:17:38 -0800114 depends on USB_OTG || EMBEDDED
115 default y if USB_OTG
116 default n if EMBEDDED
Linus Torvalds1da177e2005-04-16 15:20:36 -0700117 help
118 If you say Y here, the "otg_whitelist.h" file will be used as a
119 product whitelist, so USB peripherals not listed there will be
120 rejected during enumeration. This behavior is required by the
121 USB OTG specification for all devices not on your product's
Robin Getz22552b22008-03-05 23:17:38 -0800122 "Targeted Peripherals List". "Embedded Hosts" are likewise
123 allowed to support only a limited number of peripherals.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124
125 Otherwise, peripherals not listed there will only generate a
126 warning and enumeration will continue. That's more like what
127 normal Linux-USB hosts do (other than the warning), and is
128 convenient for many stages of product development.
129
David Brownell89ccbdc2006-04-02 10:18:09 -0800130config USB_OTG_BLACKLIST_HUB
131 bool "Disable external hubs"
Robin Getz22552b22008-03-05 23:17:38 -0800132 depends on USB_OTG || EMBEDDED
David Brownell89ccbdc2006-04-02 10:18:09 -0800133 help
134 If you say Y here, then Linux will refuse to enumerate
135 external hubs. OTG hosts are allowed to reduce hardware
Robin Getz22552b22008-03-05 23:17:38 -0800136 and software costs by not supporting external hubs. So
Peter Korsgaardbc45df92008-09-08 10:14:47 +0200137 are "Embedded Hosts" that don't offer OTG support.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700138