| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | # | 
					
						
							|  |  |  | # USB Core configuration | 
					
						
							|  |  |  | # | 
					
						
							|  |  |  | config USB_DEBUG | 
					
						
							|  |  |  | 	bool "USB verbose debug messages" | 
					
						
							|  |  |  | 	depends on USB | 
					
						
							|  |  |  | 	help | 
					
						
							|  |  |  | 	  Say Y here if you want the USB core & hub drivers to produce a bunch | 
					
						
							|  |  |  | 	  of debug messages to the system log. Select this if you are having a | 
					
						
							|  |  |  | 	  problem with USB support and want to see more of what is going on. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-11-26 22:11:55 -08:00
										 |  |  | config USB_ANNOUNCE_NEW_DEVICES | 
					
						
							|  |  |  | 	bool "USB announce new devices" | 
					
						
							|  |  |  | 	depends on USB | 
					
						
							|  |  |  | 	default N | 
					
						
							|  |  |  | 	help | 
					
						
							|  |  |  | 	  Say Y here if you want the USB core to always announce the | 
					
						
							|  |  |  | 	  idVendor, idProduct, Manufacturer, Product, and SerialNumber | 
					
						
							|  |  |  | 	  strings for every new USB device to the syslog.  This option is | 
					
						
							|  |  |  | 	  usually used by distro vendors to help with debugging and to | 
					
						
							|  |  |  | 	  let users know what specific device was added to the machine | 
					
						
							|  |  |  | 	  in what location. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  If you do not want this kind of information sent to the system | 
					
						
							|  |  |  | 	  log, or have any doubts about this, say N here. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | comment "Miscellaneous USB options" | 
					
						
							|  |  |  | 	depends on USB | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | config USB_DEVICEFS | 
					
						
							| 
									
										
										
										
											2009-07-09 21:35:49 -07:00
										 |  |  | 	bool "USB device filesystem (DEPRECATED)" | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	depends on USB | 
					
						
							|  |  |  | 	---help--- | 
					
						
							|  |  |  | 	  If you say Y here (and to "/proc file system support" in the "File | 
					
						
							|  |  |  | 	  systems" section, above), you will get a file /proc/bus/usb/devices | 
					
						
							|  |  |  | 	  which lists the devices currently connected to your USB bus or | 
					
						
							|  |  |  | 	  busses, and for every connected device a file named | 
					
						
							|  |  |  | 	  "/proc/bus/usb/xxx/yyy", where xxx is the bus number and yyy the | 
					
						
							|  |  |  | 	  device number; the latter files can be used by user space programs | 
					
						
							|  |  |  | 	  to talk directly to the device. These files are "virtual", meaning | 
					
						
							|  |  |  | 	  they are generated on the fly and not stored on the hard drive. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  You may need to mount the usbfs file system to see the files, use | 
					
						
							|  |  |  | 	  mount -t usbfs none /proc/bus/usb | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  For the format of the various /proc/bus/usb/ files, please read | 
					
						
							|  |  |  | 	  <file:Documentation/usb/proc_usb_info.txt>. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-04-21 17:21:40 +01:00
										 |  |  | 	  Modern Linux systems do not use this. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  Usbfs entries are files and not character devices; usbfs can't | 
					
						
							|  |  |  | 	  handle Access Control Lists (ACL) which are the default way to | 
					
						
							|  |  |  | 	  grant access to USB devices for untrusted users of a desktop | 
					
						
							|  |  |  | 	  system. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  The usbfs functionality is replaced by real device-nodes managed by | 
					
						
							|  |  |  | 	  udev.  These nodes lived in /dev/bus/usb and are used by libusb. | 
					
						
							| 
									
										
										
										
											2007-03-13 15:59:31 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | config USB_DEVICE_CLASS | 
					
						
							|  |  |  | 	bool "USB device class-devices (DEPRECATED)" | 
					
						
							|  |  |  | 	depends on USB | 
					
						
							| 
									
										
										
										
											2007-05-27 17:04:58 +02:00
										 |  |  | 	default y | 
					
						
							| 
									
										
										
										
											2007-03-13 15:59:31 +01:00
										 |  |  | 	---help--- | 
					
						
							|  |  |  | 	  Userspace access to USB devices is granted by device-nodes exported | 
					
						
							|  |  |  | 	  directly from the usbdev in sysfs. Old versions of the driver | 
					
						
							|  |  |  | 	  core and udev needed additional class devices to export device nodes. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  These additional devices are difficult to handle in userspace, if | 
					
						
							| 
									
										
										
										
											2007-05-27 17:04:58 +02:00
										 |  |  | 	  information about USB interfaces must be available. One device | 
					
						
							|  |  |  | 	  contains the device node, the other device contains the interface | 
					
						
							|  |  |  | 	  data. Both devices are at the same level in sysfs (siblings) and one | 
					
						
							|  |  |  | 	  can't access the other. The device node created directly by the | 
					
						
							|  |  |  | 	  usb device is the parent device of the interface and therefore | 
					
						
							|  |  |  | 	  easily accessible from the interface event. | 
					
						
							| 
									
										
										
										
											2007-03-13 15:59:31 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-05-27 17:04:58 +02:00
										 |  |  | 	  This option provides backward compatibility for libusb device | 
					
						
							|  |  |  | 	  nodes (lsusb) when usbfs is not used, and the following udev rule | 
					
						
							|  |  |  | 	  doesn't exist: | 
					
						
							|  |  |  | 	    SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \ | 
					
						
							|  |  |  | 	    NAME="bus/usb/$env{BUSNUM}/$env{DEVNUM}", MODE="0644" | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | config USB_DYNAMIC_MINORS | 
					
						
							| 
									
										
										
										
											2008-03-08 03:12:44 -05:00
										 |  |  | 	bool "Dynamic USB minor allocation" | 
					
						
							|  |  |  | 	depends on USB | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	help | 
					
						
							|  |  |  | 	  If you say Y here, the USB subsystem will use dynamic minor | 
					
						
							|  |  |  | 	  allocation for any device that uses the USB major number. | 
					
						
							|  |  |  | 	  This means that you can have more than 16 of a single type | 
					
						
							|  |  |  | 	  of device (like USB printers). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  If you are unsure about this, say N here. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | config USB_SUSPEND | 
					
						
							| 
									
										
										
										
											2010-09-24 11:41:46 -04:00
										 |  |  | 	bool "USB runtime power management (autosuspend) and wakeup" | 
					
						
							| 
									
										
										
										
											2010-01-08 12:57:28 -05:00
										 |  |  | 	depends on USB && PM_RUNTIME | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	help | 
					
						
							|  |  |  | 	  If you say Y here, you can use driver calls or the sysfs | 
					
						
							| 
									
										
										
										
											2010-09-24 11:41:46 -04:00
										 |  |  | 	  "power/control" file to enable or disable autosuspend for | 
					
						
							|  |  |  | 	  individual USB peripherals (see | 
					
						
							| 
									
										
										
										
											2008-02-25 11:43:32 -05:00
										 |  |  | 	  Documentation/usb/power-management.txt for more details). | 
					
						
							| 
									
										
											  
											
												[PATCH] root hub updates (greater half)
This patch associates hub suspend and resume logic (including for root hubs)
with CONFIG_PM -- instead of CONFIG_USB_SUSPEND as before -- thereby unifying
two troublesome versions of suspend logic into just one.  It'll be easier to
keep things right from now on.
  - Now usbcore _always_ calls hcd->hub_suspend as needed, instead of
    only when USB_SUSPEND is enabled:
     * Those root hub methods are now called from hub suspend/resume;
       no more skipping between layers during device suspend/resume;
     * It now handles cases allowed by sysfs or autosuspended root hubs,
       by forcing the hub interface to resume too.
  - All devices, including virtual root hubs, now get the same treatment
    on their resume paths ... including re-activating all their interfaces.
Plus it gets rid of those stub copies of usb_{suspend,resume}_device(), and
updates the Kconfig to match the new definition of USB_SUSPEND:  it provides
(a) selective suspend, downstream from hubs; and (b) remote wakeup, upstream
from any device configuration which supports it.
This calls for minor followup patches for most HCDs (and their PCI glue).
Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
 drivers/usb/core/Kconfig |   11 ++-
 drivers/usb/core/hub.c   |  163 +++++++++++++++++++++++++----------------------
 2 files changed, 97 insertions(+), 77 deletions(-)
											
										 
											2005-09-22 22:37:29 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | 	  Also, USB "remote wakeup" signaling is supported, whereby some | 
					
						
							|  |  |  | 	  USB devices (like keyboards and network adapters) can wake up | 
					
						
							|  |  |  | 	  their parent hub.  That wakeup cascades up the USB tree, and | 
					
						
							|  |  |  | 	  could wake the system from states like suspend-to-RAM. | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | 	  If you are unsure about this, say N here. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | config USB_OTG | 
					
						
							| 
									
										
										
										
											2010-12-16 14:32:24 +05:30
										 |  |  | 	bool "OTG support" | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	depends on USB && EXPERIMENTAL | 
					
						
							| 
									
										
										
										
											2010-03-29 16:54:51 +05:30
										 |  |  | 	depends on USB_SUSPEND | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	default n | 
					
						
							| 
									
										
										
										
											2010-12-16 14:32:24 +05:30
										 |  |  | 	help | 
					
						
							|  |  |  | 	  The most notable feature of USB OTG is support for a | 
					
						
							|  |  |  | 	  "Dual-Role" device, which can act as either a device | 
					
						
							|  |  |  | 	  or a host. The initial role is decided by the type of | 
					
						
							|  |  |  | 	  plug inserted and can be changed later when two dual | 
					
						
							|  |  |  | 	  role devices talk to each other. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 	  Select this only if your board has Mini-AB/Micro-AB | 
					
						
							|  |  |  | 	  connector. | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | config USB_OTG_WHITELIST | 
					
						
							|  |  |  | 	bool "Rely on OTG Targeted Peripherals List" | 
					
						
							| 
									
										
										
										
											2011-01-20 14:44:16 -08:00
										 |  |  | 	depends on USB_OTG || EXPERT | 
					
						
							| 
									
										
										
										
											2008-03-05 23:17:38 -08:00
										 |  |  | 	default y if USB_OTG | 
					
						
							| 
									
										
										
										
											2011-01-20 14:44:16 -08:00
										 |  |  | 	default n if EXPERT | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 	help | 
					
						
							|  |  |  | 	  If you say Y here, the "otg_whitelist.h" file will be used as a | 
					
						
							|  |  |  | 	  product whitelist, so USB peripherals not listed there will be | 
					
						
							|  |  |  | 	  rejected during enumeration.  This behavior is required by the | 
					
						
							|  |  |  | 	  USB OTG specification for all devices not on your product's | 
					
						
							| 
									
										
										
										
											2008-03-05 23:17:38 -08:00
										 |  |  | 	  "Targeted Peripherals List".  "Embedded Hosts" are likewise | 
					
						
							|  |  |  | 	  allowed to support only a limited number of peripherals. | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | 	  Otherwise, peripherals not listed there will only generate a | 
					
						
							|  |  |  | 	  warning and enumeration will continue.  That's more like what | 
					
						
							|  |  |  | 	  normal Linux-USB hosts do (other than the warning), and is | 
					
						
							|  |  |  | 	  convenient for many stages of product development. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-04-02 10:18:09 -08:00
										 |  |  | config USB_OTG_BLACKLIST_HUB | 
					
						
							|  |  |  | 	bool "Disable external hubs" | 
					
						
							| 
									
										
										
										
											2011-01-20 14:44:16 -08:00
										 |  |  | 	depends on USB_OTG || EXPERT | 
					
						
							| 
									
										
										
										
											2006-04-02 10:18:09 -08:00
										 |  |  | 	help | 
					
						
							|  |  |  | 	  If you say Y here, then Linux will refuse to enumerate | 
					
						
							|  |  |  | 	  external hubs.  OTG hosts are allowed to reduce hardware | 
					
						
							| 
									
										
										
										
											2008-03-05 23:17:38 -08:00
										 |  |  | 	  and software costs by not supporting external hubs.  So | 
					
						
							| 
									
										
										
										
											2008-09-08 10:14:47 +02:00
										 |  |  | 	  are "Embedded Hosts" that don't offer OTG support. | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | 
 |