xref: /openbmc/linux/drivers/usb/core/quirks.c (revision f7777dcc)
1 /*
2  * USB device quirk handling logic and table
3  *
4  * Copyright (c) 2007 Oliver Neukum
5  * Copyright (c) 2007 Greg Kroah-Hartman <gregkh@suse.de>
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by the Free
9  * Software Foundation, version 2.
10  *
11  *
12  */
13 
14 #include <linux/usb.h>
15 #include <linux/usb/quirks.h>
16 #include "usb.h"
17 
18 /* Lists of quirky USB devices, split in device quirks and interface quirks.
19  * Device quirks are applied at the very beginning of the enumeration process,
20  * right after reading the device descriptor. They can thus only match on device
21  * information.
22  *
23  * Interface quirks are applied after reading all the configuration descriptors.
24  * They can match on both device and interface information.
25  *
26  * Note that the DELAY_INIT and HONOR_BNUMINTERFACES quirks do not make sense as
27  * interface quirks, as they only influence the enumeration process which is run
28  * before processing the interface quirks.
29  *
30  * Please keep the lists ordered by:
31  * 	1) Vendor ID
32  * 	2) Product ID
33  * 	3) Class ID
34  */
35 static const struct usb_device_id usb_quirk_list[] = {
36 	/* CBM - Flash disk */
37 	{ USB_DEVICE(0x0204, 0x6025), .driver_info = USB_QUIRK_RESET_RESUME },
38 
39 	/* HP 5300/5370C scanner */
40 	{ USB_DEVICE(0x03f0, 0x0701), .driver_info =
41 			USB_QUIRK_STRING_FETCH_255 },
42 
43 	/* Creative SB Audigy 2 NX */
44 	{ USB_DEVICE(0x041e, 0x3020), .driver_info = USB_QUIRK_RESET_RESUME },
45 
46 	/* Microsoft LifeCam-VX700 v2.0 */
47 	{ USB_DEVICE(0x045e, 0x0770), .driver_info = USB_QUIRK_RESET_RESUME },
48 
49 	/* Logitech Quickcam Fusion */
50 	{ USB_DEVICE(0x046d, 0x08c1), .driver_info = USB_QUIRK_RESET_RESUME },
51 
52 	/* Logitech Quickcam Orbit MP */
53 	{ USB_DEVICE(0x046d, 0x08c2), .driver_info = USB_QUIRK_RESET_RESUME },
54 
55 	/* Logitech Quickcam Pro for Notebook */
56 	{ USB_DEVICE(0x046d, 0x08c3), .driver_info = USB_QUIRK_RESET_RESUME },
57 
58 	/* Logitech Quickcam Pro 5000 */
59 	{ USB_DEVICE(0x046d, 0x08c5), .driver_info = USB_QUIRK_RESET_RESUME },
60 
61 	/* Logitech Quickcam OEM Dell Notebook */
62 	{ USB_DEVICE(0x046d, 0x08c6), .driver_info = USB_QUIRK_RESET_RESUME },
63 
64 	/* Logitech Quickcam OEM Cisco VT Camera II */
65 	{ USB_DEVICE(0x046d, 0x08c7), .driver_info = USB_QUIRK_RESET_RESUME },
66 
67 	/* Logitech Harmony 700-series */
68 	{ USB_DEVICE(0x046d, 0xc122), .driver_info = USB_QUIRK_DELAY_INIT },
69 
70 	/* Philips PSC805 audio device */
71 	{ USB_DEVICE(0x0471, 0x0155), .driver_info = USB_QUIRK_RESET_RESUME },
72 
73 	/* Artisman Watchdog Dongle */
74 	{ USB_DEVICE(0x04b4, 0x0526), .driver_info =
75 			USB_QUIRK_CONFIG_INTF_STRINGS },
76 
77 	/* Microchip Joss Optical infrared touchboard device */
78 	{ USB_DEVICE(0x04d8, 0x000c), .driver_info =
79 			USB_QUIRK_CONFIG_INTF_STRINGS },
80 
81 	/* CarrolTouch 4000U */
82 	{ USB_DEVICE(0x04e7, 0x0009), .driver_info = USB_QUIRK_RESET_RESUME },
83 
84 	/* CarrolTouch 4500U */
85 	{ USB_DEVICE(0x04e7, 0x0030), .driver_info = USB_QUIRK_RESET_RESUME },
86 
87 	/* Samsung Android phone modem - ID conflict with SPH-I500 */
88 	{ USB_DEVICE(0x04e8, 0x6601), .driver_info =
89 			USB_QUIRK_CONFIG_INTF_STRINGS },
90 
91 	/* Roland SC-8820 */
92 	{ USB_DEVICE(0x0582, 0x0007), .driver_info = USB_QUIRK_RESET_RESUME },
93 
94 	/* Edirol SD-20 */
95 	{ USB_DEVICE(0x0582, 0x0027), .driver_info = USB_QUIRK_RESET_RESUME },
96 
97 	/* Alcor Micro Corp. Hub */
98 	{ USB_DEVICE(0x058f, 0x9254), .driver_info = USB_QUIRK_RESET_RESUME },
99 
100 	/* MicroTouch Systems touchscreen */
101 	{ USB_DEVICE(0x0596, 0x051e), .driver_info = USB_QUIRK_RESET_RESUME },
102 
103 	/* appletouch */
104 	{ USB_DEVICE(0x05ac, 0x021a), .driver_info = USB_QUIRK_RESET_RESUME },
105 
106 	/* Avision AV600U */
107 	{ USB_DEVICE(0x0638, 0x0a13), .driver_info =
108 	  USB_QUIRK_STRING_FETCH_255 },
109 
110 	/* Saitek Cyborg Gold Joystick */
111 	{ USB_DEVICE(0x06a3, 0x0006), .driver_info =
112 			USB_QUIRK_CONFIG_INTF_STRINGS },
113 
114 	/* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
115 	{ USB_DEVICE(0x06f8, 0x0804), .driver_info = USB_QUIRK_RESET_RESUME },
116 
117 	/* Guillemot Webcam Hercules Dualpix Exchange*/
118 	{ USB_DEVICE(0x06f8, 0x3005), .driver_info = USB_QUIRK_RESET_RESUME },
119 
120 	/* Midiman M-Audio Keystation 88es */
121 	{ USB_DEVICE(0x0763, 0x0192), .driver_info = USB_QUIRK_RESET_RESUME },
122 
123 	/* M-Systems Flash Disk Pioneers */
124 	{ USB_DEVICE(0x08ec, 0x1000), .driver_info = USB_QUIRK_RESET_RESUME },
125 
126 	/* Keytouch QWERTY Panel keyboard */
127 	{ USB_DEVICE(0x0926, 0x3333), .driver_info =
128 			USB_QUIRK_CONFIG_INTF_STRINGS },
129 
130 	/* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
131 	{ USB_DEVICE(0x0971, 0x2000), .driver_info = USB_QUIRK_NO_SET_INTF },
132 
133 	/* Broadcom BCM92035DGROM BT dongle */
134 	{ USB_DEVICE(0x0a5c, 0x2021), .driver_info = USB_QUIRK_RESET_RESUME },
135 
136 	/* MAYA44USB sound device */
137 	{ USB_DEVICE(0x0a92, 0x0091), .driver_info = USB_QUIRK_RESET_RESUME },
138 
139 	/* Action Semiconductor flash disk */
140 	{ USB_DEVICE(0x10d6, 0x2200), .driver_info =
141 			USB_QUIRK_STRING_FETCH_255 },
142 
143 	/* SKYMEDI USB_DRIVE */
144 	{ USB_DEVICE(0x1516, 0x8628), .driver_info = USB_QUIRK_RESET_RESUME },
145 
146 	/* BUILDWIN Photo Frame */
147 	{ USB_DEVICE(0x1908, 0x1315), .driver_info =
148 			USB_QUIRK_HONOR_BNUMINTERFACES },
149 
150 	/* INTEL VALUE SSD */
151 	{ USB_DEVICE(0x8086, 0xf1a5), .driver_info = USB_QUIRK_RESET_RESUME },
152 
153 	{ }  /* terminating entry must be last */
154 };
155 
156 static const struct usb_device_id usb_interface_quirk_list[] = {
157 	/* Logitech UVC Cameras */
158 	{ USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO, 1, 0),
159 	  .driver_info = USB_QUIRK_RESET_RESUME },
160 
161 	{ }  /* terminating entry must be last */
162 };
163 
164 static bool usb_match_any_interface(struct usb_device *udev,
165 				    const struct usb_device_id *id)
166 {
167 	unsigned int i;
168 
169 	for (i = 0; i < udev->descriptor.bNumConfigurations; ++i) {
170 		struct usb_host_config *cfg = &udev->config[i];
171 		unsigned int j;
172 
173 		for (j = 0; j < cfg->desc.bNumInterfaces; ++j) {
174 			struct usb_interface_cache *cache;
175 			struct usb_host_interface *intf;
176 
177 			cache = cfg->intf_cache[j];
178 			if (cache->num_altsetting == 0)
179 				continue;
180 
181 			intf = &cache->altsetting[0];
182 			if (usb_match_one_id_intf(udev, intf, id))
183 				return true;
184 		}
185 	}
186 
187 	return false;
188 }
189 
190 static u32 __usb_detect_quirks(struct usb_device *udev,
191 			       const struct usb_device_id *id)
192 {
193 	u32 quirks = 0;
194 
195 	for (; id->match_flags; id++) {
196 		if (!usb_match_device(udev, id))
197 			continue;
198 
199 		if ((id->match_flags & USB_DEVICE_ID_MATCH_INT_INFO) &&
200 		    !usb_match_any_interface(udev, id))
201 			continue;
202 
203 		quirks |= (u32)(id->driver_info);
204 	}
205 
206 	return quirks;
207 }
208 
209 /*
210  * Detect any quirks the device has, and do any housekeeping for it if needed.
211  */
212 void usb_detect_quirks(struct usb_device *udev)
213 {
214 	udev->quirks = __usb_detect_quirks(udev, usb_quirk_list);
215 	if (udev->quirks)
216 		dev_dbg(&udev->dev, "USB quirks for this device: %x\n",
217 			udev->quirks);
218 
219 #ifdef CONFIG_USB_DEFAULT_PERSIST
220 	if (!(udev->quirks & USB_QUIRK_RESET))
221 		udev->persist_enabled = 1;
222 #else
223 	/* Hubs are automatically enabled for USB-PERSIST */
224 	if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
225 		udev->persist_enabled = 1;
226 #endif	/* CONFIG_USB_DEFAULT_PERSIST */
227 }
228 
229 void usb_detect_interface_quirks(struct usb_device *udev)
230 {
231 	u32 quirks;
232 
233 	quirks = __usb_detect_quirks(udev, usb_interface_quirk_list);
234 	if (quirks == 0)
235 		return;
236 
237 	dev_dbg(&udev->dev, "USB interface quirks for this device: %x\n",
238 		quirks);
239 	udev->quirks |= quirks;
240 }
241