2655 lines · 76.8 KB · C
RawDownload
/* * (C) Copyright Linus Torvalds 1999 * (C) Copyright Johannes Erdfelt 1999-2001 * (C) Copyright Andreas Gal 1999 * (C) Copyright Gregory P. Smith 1999 * (C) Copyright Deti Fliegl 1999 * (C) Copyright Randy Dunlap 2000 * (C) Copyright David Brownell 2000-2002 *  * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the * Free Software Foundation; either version 2 of the License, or (at your * option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software Foundation, * Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #include <linux/module.h>#include <linux/version.h>#include <linux/kernel.h>#include <linux/slab.h>#include <linux/completion.h>#include <linux/utsname.h>#include <linux/mm.h>#include <asm/io.h>#include <linux/device.h>#include <linux/dma-mapping.h>#include <linux/mutex.h>#include <asm/irq.h>#include <asm/byteorder.h>#include <asm/unaligned.h>#include <linux/platform_device.h>#include <linux/workqueue.h> #include <linux/usb.h>#include <linux/usb/hcd.h> #include "usb.h"  /*-------------------------------------------------------------------------*/ /* * USB Host Controller Driver framework * * Plugs into usbcore (usb_bus) and lets HCDs share code, minimizing * HCD-specific behaviors/bugs. * * This does error checks, tracks devices and urbs, and delegates to a * "hc_driver" only for code (and data) that really needs to know about * hardware differences.  That includes root hub registers, i/o queues, * and so on ... but as little else as possible. * * Shared code includes most of the "root hub" code (these are emulated, * though each HC's hardware works differently) and PCI glue, plus request * tracking overhead.  The HCD code should only block on spinlocks or on * hardware handshaking; blocking on software events (such as other kernel * threads releasing resources, or completing actions) is all generic. * * Happens the USB 2.0 spec says this would be invisible inside the "USBD", * and includes mostly a "HCDI" (HCD Interface) along with some APIs used * only by the hub driver ... and that neither should be seen or used by * usb client device drivers. * * Contributors of ideas or unattributed patches include: David Brownell, * Roman Weissgaerber, Rory Bolt, Greg Kroah-Hartman, ... * * HISTORY: * 2002-02-21	Pull in most of the usb_bus support from usb.c; some *		associated cleanup.  "usb_hcd" still != "usb_bus". * 2001-12-12	Initial patch version for Linux 2.5.1 kernel. */ /*-------------------------------------------------------------------------*/ /* Keep track of which host controller drivers are loaded */unsigned long usb_hcds_loaded;EXPORT_SYMBOL_GPL(usb_hcds_loaded); /* host controllers we manage */LIST_HEAD (usb_bus_list);EXPORT_SYMBOL_GPL (usb_bus_list); /* used when allocating bus numbers */#define USB_MAXBUS		64struct usb_busmap {	unsigned long busmap [USB_MAXBUS / (8*sizeof (unsigned long))];};static struct usb_busmap busmap; /* used when updating list of hcds */DEFINE_MUTEX(usb_bus_list_lock);	/* exported only for usbfs */EXPORT_SYMBOL_GPL (usb_bus_list_lock); /* used for controlling access to virtual root hubs */static DEFINE_SPINLOCK(hcd_root_hub_lock); /* used when updating an endpoint's URB list */static DEFINE_SPINLOCK(hcd_urb_list_lock); /* used to protect against unlinking URBs after the device is gone */static DEFINE_SPINLOCK(hcd_urb_unlink_lock); /* wait queue for synchronous unlinks */DECLARE_WAIT_QUEUE_HEAD(usb_kill_urb_queue); static inline int is_root_hub(struct usb_device *udev){	return (udev->parent == NULL);} /*-------------------------------------------------------------------------*/ /* * Sharable chunks of root hub code. */ /*-------------------------------------------------------------------------*/ #define KERNEL_REL	((LINUX_VERSION_CODE >> 16) & 0x0ff)#define KERNEL_VER	((LINUX_VERSION_CODE >> 8) & 0x0ff) /* usb 3.0 root hub device descriptor */static const u8 usb3_rh_dev_descriptor[18] = {	0x12,       /*  __u8  bLength; */	0x01,       /*  __u8  bDescriptorType; Device */	0x00, 0x03, /*  __le16 bcdUSB; v3.0 */ 	0x09,	    /*  __u8  bDeviceClass; HUB_CLASSCODE */	0x00,	    /*  __u8  bDeviceSubClass; */	0x03,       /*  __u8  bDeviceProtocol; USB 3.0 hub */	0x09,       /*  __u8  bMaxPacketSize0; 2^9 = 512 Bytes */ 	0x6b, 0x1d, /*  __le16 idVendor; Linux Foundation 0x1d6b */	0x03, 0x00, /*  __le16 idProduct; device 0x0003 */	KERNEL_VER, KERNEL_REL, /*  __le16 bcdDevice */ 	0x03,       /*  __u8  iManufacturer; */	0x02,       /*  __u8  iProduct; */	0x01,       /*  __u8  iSerialNumber; */	0x01        /*  __u8  bNumConfigurations; */}; /* usb 2.0 root hub device descriptor */static const u8 usb2_rh_dev_descriptor [18] = {	0x12,       /*  __u8  bLength; */	0x01,       /*  __u8  bDescriptorType; Device */	0x00, 0x02, /*  __le16 bcdUSB; v2.0 */ 	0x09,	    /*  __u8  bDeviceClass; HUB_CLASSCODE */	0x00,	    /*  __u8  bDeviceSubClass; */	0x00,       /*  __u8  bDeviceProtocol; [ usb 2.0 no TT ] */	0x40,       /*  __u8  bMaxPacketSize0; 64 Bytes */ 	0x6b, 0x1d, /*  __le16 idVendor; Linux Foundation 0x1d6b */	0x02, 0x00, /*  __le16 idProduct; device 0x0002 */	KERNEL_VER, KERNEL_REL, /*  __le16 bcdDevice */ 	0x03,       /*  __u8  iManufacturer; */	0x02,       /*  __u8  iProduct; */	0x01,       /*  __u8  iSerialNumber; */	0x01        /*  __u8  bNumConfigurations; */}; /* no usb 2.0 root hub "device qualifier" descriptor: one speed only */ /* usb 1.1 root hub device descriptor */static const u8 usb11_rh_dev_descriptor [18] = {	0x12,       /*  __u8  bLength; */	0x01,       /*  __u8  bDescriptorType; Device */	0x10, 0x01, /*  __le16 bcdUSB; v1.1 */ 	0x09,	    /*  __u8  bDeviceClass; HUB_CLASSCODE */	0x00,	    /*  __u8  bDeviceSubClass; */	0x00,       /*  __u8  bDeviceProtocol; [ low/full speeds only ] */	0x40,       /*  __u8  bMaxPacketSize0; 64 Bytes */ 	0x6b, 0x1d, /*  __le16 idVendor; Linux Foundation 0x1d6b */	0x01, 0x00, /*  __le16 idProduct; device 0x0001 */	KERNEL_VER, KERNEL_REL, /*  __le16 bcdDevice */ 	0x03,       /*  __u8  iManufacturer; */	0x02,       /*  __u8  iProduct; */	0x01,       /*  __u8  iSerialNumber; */	0x01        /*  __u8  bNumConfigurations; */};  /*-------------------------------------------------------------------------*/ /* Configuration descriptors for our root hubs */ static const u8 fs_rh_config_descriptor [] = { 	/* one configuration */	0x09,       /*  __u8  bLength; */	0x02,       /*  __u8  bDescriptorType; Configuration */	0x19, 0x00, /*  __le16 wTotalLength; */	0x01,       /*  __u8  bNumInterfaces; (1) */	0x01,       /*  __u8  bConfigurationValue; */	0x00,       /*  __u8  iConfiguration; */	0xc0,       /*  __u8  bmAttributes; 				 Bit 7: must be set,				     6: Self-powered,				     5: Remote wakeup,				     4..0: resvd */	0x00,       /*  __u8  MaxPower; */      	/* USB 1.1:	 * USB 2.0, single TT organization (mandatory):	 *	one interface, protocol 0	 *	 * USB 2.0, multiple TT organization (optional):	 *	two interfaces, protocols 1 (like single TT)	 *	and 2 (multiple TT mode) ... config is	 *	sometimes settable	 *	NOT IMPLEMENTED	 */ 	/* one interface */	0x09,       /*  __u8  if_bLength; */	0x04,       /*  __u8  if_bDescriptorType; Interface */	0x00,       /*  __u8  if_bInterfaceNumber; */	0x00,       /*  __u8  if_bAlternateSetting; */	0x01,       /*  __u8  if_bNumEndpoints; */	0x09,       /*  __u8  if_bInterfaceClass; HUB_CLASSCODE */	0x00,       /*  __u8  if_bInterfaceSubClass; */	0x00,       /*  __u8  if_bInterfaceProtocol; [usb1.1 or single tt] */	0x00,       /*  __u8  if_iInterface; */     	/* one endpoint (status change endpoint) */	0x07,       /*  __u8  ep_bLength; */	0x05,       /*  __u8  ep_bDescriptorType; Endpoint */	0x81,       /*  __u8  ep_bEndpointAddress; IN Endpoint 1 */ 	0x03,       /*  __u8  ep_bmAttributes; Interrupt */ 	0x02, 0x00, /*  __le16 ep_wMaxPacketSize; 1 + (MAX_ROOT_PORTS / 8) */	0xff        /*  __u8  ep_bInterval; (255ms -- usb 2.0 spec) */}; static const u8 hs_rh_config_descriptor [] = { 	/* one configuration */	0x09,       /*  __u8  bLength; */	0x02,       /*  __u8  bDescriptorType; Configuration */	0x19, 0x00, /*  __le16 wTotalLength; */	0x01,       /*  __u8  bNumInterfaces; (1) */	0x01,       /*  __u8  bConfigurationValue; */	0x00,       /*  __u8  iConfiguration; */	0xc0,       /*  __u8  bmAttributes; 				 Bit 7: must be set,				     6: Self-powered,				     5: Remote wakeup,				     4..0: resvd */	0x00,       /*  __u8  MaxPower; */      	/* USB 1.1:	 * USB 2.0, single TT organization (mandatory):	 *	one interface, protocol 0	 *	 * USB 2.0, multiple TT organization (optional):	 *	two interfaces, protocols 1 (like single TT)	 *	and 2 (multiple TT mode) ... config is	 *	sometimes settable	 *	NOT IMPLEMENTED	 */ 	/* one interface */	0x09,       /*  __u8  if_bLength; */	0x04,       /*  __u8  if_bDescriptorType; Interface */	0x00,       /*  __u8  if_bInterfaceNumber; */	0x00,       /*  __u8  if_bAlternateSetting; */	0x01,       /*  __u8  if_bNumEndpoints; */	0x09,       /*  __u8  if_bInterfaceClass; HUB_CLASSCODE */	0x00,       /*  __u8  if_bInterfaceSubClass; */	0x00,       /*  __u8  if_bInterfaceProtocol; [usb1.1 or single tt] */	0x00,       /*  __u8  if_iInterface; */     	/* one endpoint (status change endpoint) */	0x07,       /*  __u8  ep_bLength; */	0x05,       /*  __u8  ep_bDescriptorType; Endpoint */	0x81,       /*  __u8  ep_bEndpointAddress; IN Endpoint 1 */ 	0x03,       /*  __u8  ep_bmAttributes; Interrupt */		    /* __le16 ep_wMaxPacketSize; 1 + (MAX_ROOT_PORTS / 8)		     * see hub.c:hub_configure() for details. */	(USB_MAXCHILDREN + 1 + 7) / 8, 0x00,	0x0c        /*  __u8  ep_bInterval; (256ms -- usb 2.0 spec) */}; static const u8 ss_rh_config_descriptor[] = {	/* one configuration */	0x09,       /*  __u8  bLength; */	0x02,       /*  __u8  bDescriptorType; Configuration */	0x1f, 0x00, /*  __le16 wTotalLength; */	0x01,       /*  __u8  bNumInterfaces; (1) */	0x01,       /*  __u8  bConfigurationValue; */	0x00,       /*  __u8  iConfiguration; */	0xc0,       /*  __u8  bmAttributes;				 Bit 7: must be set,				     6: Self-powered,				     5: Remote wakeup,				     4..0: resvd */	0x00,       /*  __u8  MaxPower; */ 	/* one interface */	0x09,       /*  __u8  if_bLength; */	0x04,       /*  __u8  if_bDescriptorType; Interface */	0x00,       /*  __u8  if_bInterfaceNumber; */	0x00,       /*  __u8  if_bAlternateSetting; */	0x01,       /*  __u8  if_bNumEndpoints; */	0x09,       /*  __u8  if_bInterfaceClass; HUB_CLASSCODE */	0x00,       /*  __u8  if_bInterfaceSubClass; */	0x00,       /*  __u8  if_bInterfaceProtocol; */	0x00,       /*  __u8  if_iInterface; */ 	/* one endpoint (status change endpoint) */	0x07,       /*  __u8  ep_bLength; */	0x05,       /*  __u8  ep_bDescriptorType; Endpoint */	0x81,       /*  __u8  ep_bEndpointAddress; IN Endpoint 1 */	0x03,       /*  __u8  ep_bmAttributes; Interrupt */		    /* __le16 ep_wMaxPacketSize; 1 + (MAX_ROOT_PORTS / 8)		     * see hub.c:hub_configure() for details. */	(USB_MAXCHILDREN + 1 + 7) / 8, 0x00,	0x0c,       /*  __u8  ep_bInterval; (256ms -- usb 2.0 spec) */ 	/* one SuperSpeed endpoint companion descriptor */	0x06,        /* __u8 ss_bLength */	0x30,        /* __u8 ss_bDescriptorType; SuperSpeed EP Companion */	0x00,        /* __u8 ss_bMaxBurst; allows 1 TX between ACKs */	0x00,        /* __u8 ss_bmAttributes; 1 packet per service interval */	0x02, 0x00   /* __le16 ss_wBytesPerInterval; 15 bits for max 15 ports */}; /* authorized_default behaviour: * -1 is authorized for all devices except wireless (old behaviour) * 0 is unauthorized for all devices * 1 is authorized for all devices */static int authorized_default = -1;module_param(authorized_default, int, S_IRUGO|S_IWUSR);MODULE_PARM_DESC(authorized_default,		"Default USB device authorization: 0 is not authorized, 1 is "		"authorized, -1 is authorized except for wireless USB (default, "		"old behaviour");/*-------------------------------------------------------------------------*/ /** * ascii2desc() - Helper routine for producing UTF-16LE string descriptors * @s: Null-terminated ASCII (actually ISO-8859-1) string * @buf: Buffer for USB string descriptor (header + UTF-16LE) * @len: Length (in bytes; may be odd) of descriptor buffer. * * The return value is the number of bytes filled in: 2 + 2*strlen(s) or * buflen, whichever is less. * * USB String descriptors can contain at most 126 characters; input * strings longer than that are truncated. */static unsignedascii2desc(char const *s, u8 *buf, unsigned len){	unsigned n, t = 2 + 2*strlen(s); 	if (t > 254)		t = 254;	/* Longest possible UTF string descriptor */	if (len > t)		len = t; 	t += USB_DT_STRING << 8;	/* Now t is first 16 bits to store */ 	n = len;	while (n--) {		*buf++ = t;		if (!n--)			break;		*buf++ = t >> 8;		t = (unsigned char)*s++;	}	return len;} /** * rh_string() - provides string descriptors for root hub * @id: the string ID number (0: langids, 1: serial #, 2: product, 3: vendor) * @hcd: the host controller for this root hub * @data: buffer for output packet * @len: length of the provided buffer * * Produces either a manufacturer, product or serial number string for the * virtual root hub device. * Returns the number of bytes filled in: the length of the descriptor or * of the provided buffer, whichever is less. */static unsignedrh_string(int id, struct usb_hcd const *hcd, u8 *data, unsigned len){	char buf[100];	char const *s;	static char const langids[4] = {4, USB_DT_STRING, 0x09, 0x04}; 	// language ids	switch (id) {	case 0:		/* Array of LANGID codes (0x0409 is MSFT-speak for "en-us") */		/* See http://www.usb.org/developers/docs/USB_LANGIDs.pdf */		if (len > 4)			len = 4;		memcpy(data, langids, len);		return len;	case 1:		/* Serial number */		s = hcd->self.bus_name;		break;	case 2:		/* Product name */		s = hcd->product_desc;		break;	case 3:		/* Manufacturer */		snprintf (buf, sizeof buf, "%s %s %s", init_utsname()->sysname,			init_utsname()->release, hcd->driver->description);		s = buf;		break;	default:		/* Can't happen; caller guarantees it */		return 0;	} 	return ascii2desc(s, data, len);}  /* Root hub control transfers execute synchronously */static int rh_call_control (struct usb_hcd *hcd, struct urb *urb){	struct usb_ctrlrequest *cmd; 	u16		typeReq, wValue, wIndex, wLength;	u8		*ubuf = urb->transfer_buffer;	/*	 * tbuf should be as big as the BOS descriptor and	 * the USB hub descriptor.	 */	u8		tbuf[USB_DT_BOS_SIZE + USB_DT_USB_SS_CAP_SIZE]		__attribute__((aligned(4)));	const u8	*bufp = tbuf;	unsigned	len = 0;	int		status;	u8		patch_wakeup = 0;	u8		patch_protocol = 0; 	might_sleep(); 	spin_lock_irq(&hcd_root_hub_lock);	status = usb_hcd_link_urb_to_ep(hcd, urb);	spin_unlock_irq(&hcd_root_hub_lock);	if (status)		return status;	urb->hcpriv = hcd;	/* Indicate it's queued */ 	cmd = (struct usb_ctrlrequest *) urb->setup_packet;	typeReq  = (cmd->bRequestType << 8) | cmd->bRequest;	wValue   = le16_to_cpu (cmd->wValue);	wIndex   = le16_to_cpu (cmd->wIndex);	wLength  = le16_to_cpu (cmd->wLength); 	if (wLength > urb->transfer_buffer_length)		goto error; 	urb->actual_length = 0;	switch (typeReq) { 	/* DEVICE REQUESTS */ 	/* The root hub's remote wakeup enable bit is implemented using	 * driver model wakeup flags.  If this system supports wakeup	 * through USB, userspace may change the default "allow wakeup"	 * policy through sysfs or these calls.	 *	 * Most root hubs support wakeup from downstream devices, for	 * runtime power management (disabling USB clocks and reducing	 * VBUS power usage).  However, not all of them do so; silicon,	 * board, and BIOS bugs here are not uncommon, so these can't	 * be treated quite like external hubs.	 *	 * Likewise, not all root hubs will pass wakeup events upstream,	 * to wake up the whole system.  So don't assume root hub and	 * controller capabilities are identical.	 */ 	case DeviceRequest | USB_REQ_GET_STATUS:		tbuf [0] = (device_may_wakeup(&hcd->self.root_hub->dev)					<< USB_DEVICE_REMOTE_WAKEUP)				| (1 << USB_DEVICE_SELF_POWERED);		tbuf [1] = 0;

Lines 1–500 of 2655.

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t