blob: 97a819c23ef365a8d52dd63c13d7c94891d5f54d [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
Greg Kroah-Hartmane12df022009-07-09 21:35:49 -070031 bool "USB device filesystem (DEPRECATED)"
Linus Torvalds1da177e2005-04-16 15:20:36 -070032 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
Scott James Remnantcc713292009-04-21 17:21:40 +010049 Modern Linux systems do not use this.
50
51 Usbfs entries are files and not character devices; usbfs can't
52 handle Access Control Lists (ACL) which are the default way to
53 grant access to USB devices for untrusted users of a desktop
54 system.
55
56 The usbfs functionality is replaced by real device-nodes managed by
57 udev. These nodes lived in /dev/bus/usb and are used by libusb.
Kay Sievers9f8b17e2007-03-13 15:59:31 +010058
59config USB_DEVICE_CLASS
60 bool "USB device class-devices (DEPRECATED)"
61 depends on USB
Kay Sieversdda034b2007-05-27 17:04:58 +020062 default y
Kay Sievers9f8b17e2007-03-13 15:59:31 +010063 ---help---
64 Userspace access to USB devices is granted by device-nodes exported
65 directly from the usbdev in sysfs. Old versions of the driver
66 core and udev needed additional class devices to export device nodes.
67
68 These additional devices are difficult to handle in userspace, if
Kay Sieversdda034b2007-05-27 17:04:58 +020069 information about USB interfaces must be available. One device
70 contains the device node, the other device contains the interface
71 data. Both devices are at the same level in sysfs (siblings) and one
72 can't access the other. The device node created directly by the
73 usb device is the parent device of the interface and therefore
74 easily accessible from the interface event.
Kay Sievers9f8b17e2007-03-13 15:59:31 +010075
Kay Sieversdda034b2007-05-27 17:04:58 +020076 This option provides backward compatibility for libusb device
77 nodes (lsusb) when usbfs is not used, and the following udev rule
78 doesn't exist:
79 SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
80 NAME="bus/usb/$env{BUSNUM}/$env{DEVNUM}", MODE="0644"
Linus Torvalds1da177e2005-04-16 15:20:36 -070081
Linus Torvalds1da177e2005-04-16 15:20:36 -070082config USB_DYNAMIC_MINORS
Robert P. J. Dayb6719992008-03-08 03:12:44 -050083 bool "Dynamic USB minor allocation"
84 depends on USB
Linus Torvalds1da177e2005-04-16 15:20:36 -070085 help
86 If you say Y here, the USB subsystem will use dynamic minor
87 allocation for any device that uses the USB major number.
88 This means that you can have more than 16 of a single type
89 of device (like USB printers).
90
91 If you are unsure about this, say N here.
92
93config USB_SUSPEND
Alan Stern9bbdf1e2010-01-08 12:57:28 -050094 bool "USB runtime power management (suspend/resume and wakeup)"
95 depends on USB && PM_RUNTIME
Linus Torvalds1da177e2005-04-16 15:20:36 -070096 help
97 If you say Y here, you can use driver calls or the sysfs
Alan Sternc2c8d1f2008-02-25 11:43:32 -050098 "power/level" file to suspend or resume individual USB
99 peripherals and to enable or disable autosuspend (see
100 Documentation/usb/power-management.txt for more details).
David Brownellf3f32532005-09-22 22:37:29 -0700101
102 Also, USB "remote wakeup" signaling is supported, whereby some
103 USB devices (like keyboards and network adapters) can wake up
104 their parent hub. That wakeup cascades up the USB tree, and
105 could wake the system from states like suspend-to-RAM.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106
107 If you are unsure about this, say N here.
108
Linus Torvalds1da177e2005-04-16 15:20:36 -0700109config USB_OTG
110 bool
111 depends on USB && EXPERIMENTAL
112 select USB_SUSPEND
113 default n
114
115
116config USB_OTG_WHITELIST
117 bool "Rely on OTG Targeted Peripherals List"
Robin Getz22552b22008-03-05 23:17:38 -0800118 depends on USB_OTG || EMBEDDED
119 default y if USB_OTG
120 default n if EMBEDDED
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121 help
122 If you say Y here, the "otg_whitelist.h" file will be used as a
123 product whitelist, so USB peripherals not listed there will be
124 rejected during enumeration. This behavior is required by the
125 USB OTG specification for all devices not on your product's
Robin Getz22552b22008-03-05 23:17:38 -0800126 "Targeted Peripherals List". "Embedded Hosts" are likewise
127 allowed to support only a limited number of peripherals.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128
129 Otherwise, peripherals not listed there will only generate a
130 warning and enumeration will continue. That's more like what
131 normal Linux-USB hosts do (other than the warning), and is
132 convenient for many stages of product development.
133
David Brownell89ccbdc2006-04-02 10:18:09 -0800134config USB_OTG_BLACKLIST_HUB
135 bool "Disable external hubs"
Robin Getz22552b22008-03-05 23:17:38 -0800136 depends on USB_OTG || EMBEDDED
David Brownell89ccbdc2006-04-02 10:18:09 -0800137 help
138 If you say Y here, then Linux will refuse to enumerate
139 external hubs. OTG hosts are allowed to reduce hardware
Robin Getz22552b22008-03-05 23:17:38 -0800140 and software costs by not supporting external hubs. So
Peter Korsgaardbc45df92008-09-08 10:14:47 +0200141 are "Embedded Hosts" that don't offer OTG support.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142