xref: /linux/drivers/usb/core/quirks.c (revision 4246b92cf9fb32da8d8b060c92d8302797c6fbea)
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 <linux/usb/hcd.h>
17 #include "usb.h"
18 
19 /* Lists of quirky USB devices, split in device quirks and interface quirks.
20  * Device quirks are applied at the very beginning of the enumeration process,
21  * right after reading the device descriptor. They can thus only match on device
22  * information.
23  *
24  * Interface quirks are applied after reading all the configuration descriptors.
25  * They can match on both device and interface information.
26  *
27  * Note that the DELAY_INIT and HONOR_BNUMINTERFACES quirks do not make sense as
28  * interface quirks, as they only influence the enumeration process which is run
29  * before processing the interface quirks.
30  *
31  * Please keep the lists ordered by:
32  * 	1) Vendor ID
33  * 	2) Product ID
34  * 	3) Class ID
35  */
36 static const struct usb_device_id usb_quirk_list[] = {
37 	/* CBM - Flash disk */
38 	{ USB_DEVICE(0x0204, 0x6025), .driver_info = USB_QUIRK_RESET_RESUME },
39 
40 	/* WORLDE easy key (easykey.25) MIDI controller  */
41 	{ USB_DEVICE(0x0218, 0x0401), .driver_info =
42 			USB_QUIRK_CONFIG_INTF_STRINGS },
43 
44 	/* HP 5300/5370C scanner */
45 	{ USB_DEVICE(0x03f0, 0x0701), .driver_info =
46 			USB_QUIRK_STRING_FETCH_255 },
47 
48 	/* Creative SB Audigy 2 NX */
49 	{ USB_DEVICE(0x041e, 0x3020), .driver_info = USB_QUIRK_RESET_RESUME },
50 
51 	/* USB3503 */
52 	{ USB_DEVICE(0x0424, 0x3503), .driver_info = USB_QUIRK_RESET_RESUME },
53 
54 	/* Microsoft Wireless Laser Mouse 6000 Receiver */
55 	{ USB_DEVICE(0x045e, 0x00e1), .driver_info = USB_QUIRK_RESET_RESUME },
56 
57 	/* Microsoft LifeCam-VX700 v2.0 */
58 	{ USB_DEVICE(0x045e, 0x0770), .driver_info = USB_QUIRK_RESET_RESUME },
59 
60 	/* Logitech HD Pro Webcams C920, C920-C and C930e */
61 	{ USB_DEVICE(0x046d, 0x082d), .driver_info = USB_QUIRK_DELAY_INIT },
62 	{ USB_DEVICE(0x046d, 0x0841), .driver_info = USB_QUIRK_DELAY_INIT },
63 	{ USB_DEVICE(0x046d, 0x0843), .driver_info = USB_QUIRK_DELAY_INIT },
64 
65 	/* Logitech ConferenceCam CC3000e */
66 	{ USB_DEVICE(0x046d, 0x0847), .driver_info = USB_QUIRK_DELAY_INIT },
67 	{ USB_DEVICE(0x046d, 0x0848), .driver_info = USB_QUIRK_DELAY_INIT },
68 
69 	/* Logitech PTZ Pro Camera */
70 	{ USB_DEVICE(0x046d, 0x0853), .driver_info = USB_QUIRK_DELAY_INIT },
71 
72 	/* Logitech Quickcam Fusion */
73 	{ USB_DEVICE(0x046d, 0x08c1), .driver_info = USB_QUIRK_RESET_RESUME },
74 
75 	/* Logitech Quickcam Orbit MP */
76 	{ USB_DEVICE(0x046d, 0x08c2), .driver_info = USB_QUIRK_RESET_RESUME },
77 
78 	/* Logitech Quickcam Pro for Notebook */
79 	{ USB_DEVICE(0x046d, 0x08c3), .driver_info = USB_QUIRK_RESET_RESUME },
80 
81 	/* Logitech Quickcam Pro 5000 */
82 	{ USB_DEVICE(0x046d, 0x08c5), .driver_info = USB_QUIRK_RESET_RESUME },
83 
84 	/* Logitech Quickcam OEM Dell Notebook */
85 	{ USB_DEVICE(0x046d, 0x08c6), .driver_info = USB_QUIRK_RESET_RESUME },
86 
87 	/* Logitech Quickcam OEM Cisco VT Camera II */
88 	{ USB_DEVICE(0x046d, 0x08c7), .driver_info = USB_QUIRK_RESET_RESUME },
89 
90 	/* Logitech Harmony 700-series */
91 	{ USB_DEVICE(0x046d, 0xc122), .driver_info = USB_QUIRK_DELAY_INIT },
92 
93 	/* Philips PSC805 audio device */
94 	{ USB_DEVICE(0x0471, 0x0155), .driver_info = USB_QUIRK_RESET_RESUME },
95 
96 	/* Plantronic Audio 655 DSP */
97 	{ USB_DEVICE(0x047f, 0xc008), .driver_info = USB_QUIRK_RESET_RESUME },
98 
99 	/* Plantronic Audio 648 USB */
100 	{ USB_DEVICE(0x047f, 0xc013), .driver_info = USB_QUIRK_RESET_RESUME },
101 
102 	/* Artisman Watchdog Dongle */
103 	{ USB_DEVICE(0x04b4, 0x0526), .driver_info =
104 			USB_QUIRK_CONFIG_INTF_STRINGS },
105 
106 	/* Microchip Joss Optical infrared touchboard device */
107 	{ USB_DEVICE(0x04d8, 0x000c), .driver_info =
108 			USB_QUIRK_CONFIG_INTF_STRINGS },
109 
110 	/* CarrolTouch 4000U */
111 	{ USB_DEVICE(0x04e7, 0x0009), .driver_info = USB_QUIRK_RESET_RESUME },
112 
113 	/* CarrolTouch 4500U */
114 	{ USB_DEVICE(0x04e7, 0x0030), .driver_info = USB_QUIRK_RESET_RESUME },
115 
116 	/* Samsung Android phone modem - ID conflict with SPH-I500 */
117 	{ USB_DEVICE(0x04e8, 0x6601), .driver_info =
118 			USB_QUIRK_CONFIG_INTF_STRINGS },
119 
120 	/* Elan Touchscreen */
121 	{ USB_DEVICE(0x04f3, 0x0089), .driver_info =
122 			USB_QUIRK_DEVICE_QUALIFIER },
123 
124 	{ USB_DEVICE(0x04f3, 0x009b), .driver_info =
125 			USB_QUIRK_DEVICE_QUALIFIER },
126 
127 	{ USB_DEVICE(0x04f3, 0x010c), .driver_info =
128 			USB_QUIRK_DEVICE_QUALIFIER },
129 
130 	{ USB_DEVICE(0x04f3, 0x0125), .driver_info =
131 			USB_QUIRK_DEVICE_QUALIFIER },
132 
133 	{ USB_DEVICE(0x04f3, 0x016f), .driver_info =
134 			USB_QUIRK_DEVICE_QUALIFIER },
135 
136 	{ USB_DEVICE(0x04f3, 0x0381), .driver_info =
137 			USB_QUIRK_NO_LPM },
138 
139 	{ USB_DEVICE(0x04f3, 0x21b8), .driver_info =
140 			USB_QUIRK_DEVICE_QUALIFIER },
141 
142 	/* Roland SC-8820 */
143 	{ USB_DEVICE(0x0582, 0x0007), .driver_info = USB_QUIRK_RESET_RESUME },
144 
145 	/* Edirol SD-20 */
146 	{ USB_DEVICE(0x0582, 0x0027), .driver_info = USB_QUIRK_RESET_RESUME },
147 
148 	/* Alcor Micro Corp. Hub */
149 	{ USB_DEVICE(0x058f, 0x9254), .driver_info = USB_QUIRK_RESET_RESUME },
150 
151 	/* appletouch */
152 	{ USB_DEVICE(0x05ac, 0x021a), .driver_info = USB_QUIRK_RESET_RESUME },
153 
154 	/* Genesys Logic hub, internally used by Moshi USB to Ethernet Adapter */
155 	{ USB_DEVICE(0x05e3, 0x0616), .driver_info = USB_QUIRK_NO_LPM },
156 
157 	/* Avision AV600U */
158 	{ USB_DEVICE(0x0638, 0x0a13), .driver_info =
159 	  USB_QUIRK_STRING_FETCH_255 },
160 
161 	/* Saitek Cyborg Gold Joystick */
162 	{ USB_DEVICE(0x06a3, 0x0006), .driver_info =
163 			USB_QUIRK_CONFIG_INTF_STRINGS },
164 
165 	/* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
166 	{ USB_DEVICE(0x06f8, 0x0804), .driver_info = USB_QUIRK_RESET_RESUME },
167 
168 	/* Guillemot Webcam Hercules Dualpix Exchange*/
169 	{ USB_DEVICE(0x06f8, 0x3005), .driver_info = USB_QUIRK_RESET_RESUME },
170 
171 	/* Midiman M-Audio Keystation 88es */
172 	{ USB_DEVICE(0x0763, 0x0192), .driver_info = USB_QUIRK_RESET_RESUME },
173 
174 	/* M-Systems Flash Disk Pioneers */
175 	{ USB_DEVICE(0x08ec, 0x1000), .driver_info = USB_QUIRK_RESET_RESUME },
176 
177 	/* Baum Vario Ultra */
178 	{ USB_DEVICE(0x0904, 0x6101), .driver_info =
179 			USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
180 	{ USB_DEVICE(0x0904, 0x6102), .driver_info =
181 			USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
182 	{ USB_DEVICE(0x0904, 0x6103), .driver_info =
183 			USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
184 
185 	/* Keytouch QWERTY Panel keyboard */
186 	{ USB_DEVICE(0x0926, 0x3333), .driver_info =
187 			USB_QUIRK_CONFIG_INTF_STRINGS },
188 
189 	/* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
190 	{ USB_DEVICE(0x0971, 0x2000), .driver_info = USB_QUIRK_NO_SET_INTF },
191 
192 	/* Broadcom BCM92035DGROM BT dongle */
193 	{ USB_DEVICE(0x0a5c, 0x2021), .driver_info = USB_QUIRK_RESET_RESUME },
194 
195 	/* MAYA44USB sound device */
196 	{ USB_DEVICE(0x0a92, 0x0091), .driver_info = USB_QUIRK_RESET_RESUME },
197 
198 	/* ASUS Base Station(T100) */
199 	{ USB_DEVICE(0x0b05, 0x17e0), .driver_info =
200 			USB_QUIRK_IGNORE_REMOTE_WAKEUP },
201 
202 	/* Action Semiconductor flash disk */
203 	{ USB_DEVICE(0x10d6, 0x2200), .driver_info =
204 			USB_QUIRK_STRING_FETCH_255 },
205 
206 	/* SKYMEDI USB_DRIVE */
207 	{ USB_DEVICE(0x1516, 0x8628), .driver_info = USB_QUIRK_RESET_RESUME },
208 
209 	/* Razer - Razer Blade Keyboard */
210 	{ USB_DEVICE(0x1532, 0x0116), .driver_info =
211 			USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
212 
213 	/* BUILDWIN Photo Frame */
214 	{ USB_DEVICE(0x1908, 0x1315), .driver_info =
215 			USB_QUIRK_HONOR_BNUMINTERFACES },
216 
217 	/* Protocol and OTG Electrical Test Device */
218 	{ USB_DEVICE(0x1a0a, 0x0200), .driver_info =
219 			USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
220 
221 	/* Corsair Strafe RGB */
222 	{ USB_DEVICE(0x1b1c, 0x1b20), .driver_info = USB_QUIRK_DELAY_INIT },
223 
224 	/* MIDI keyboard WORLDE MINI */
225 	{ USB_DEVICE(0x1c75, 0x0204), .driver_info =
226 			USB_QUIRK_CONFIG_INTF_STRINGS },
227 
228 	/* Acer C120 LED Projector */
229 	{ USB_DEVICE(0x1de1, 0xc102), .driver_info = USB_QUIRK_NO_LPM },
230 
231 	/* Blackmagic Design Intensity Shuttle */
232 	{ USB_DEVICE(0x1edb, 0xbd3b), .driver_info = USB_QUIRK_NO_LPM },
233 
234 	/* Blackmagic Design UltraStudio SDI */
235 	{ USB_DEVICE(0x1edb, 0xbd4f), .driver_info = USB_QUIRK_NO_LPM },
236 
237 	/* Hauppauge HVR-950q */
238 	{ USB_DEVICE(0x2040, 0x7200), .driver_info =
239 			USB_QUIRK_CONFIG_INTF_STRINGS },
240 
241 	/* INTEL VALUE SSD */
242 	{ USB_DEVICE(0x8086, 0xf1a5), .driver_info = USB_QUIRK_RESET_RESUME },
243 
244 	{ }  /* terminating entry must be last */
245 };
246 
247 static const struct usb_device_id usb_interface_quirk_list[] = {
248 	/* Logitech UVC Cameras */
249 	{ USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO, 1, 0),
250 	  .driver_info = USB_QUIRK_RESET_RESUME },
251 
252 	{ }  /* terminating entry must be last */
253 };
254 
255 static const struct usb_device_id usb_amd_resume_quirk_list[] = {
256 	/* Lenovo Mouse with Pixart controller */
257 	{ USB_DEVICE(0x17ef, 0x602e), .driver_info = USB_QUIRK_RESET_RESUME },
258 
259 	/* Pixart Mouse */
260 	{ USB_DEVICE(0x093a, 0x2500), .driver_info = USB_QUIRK_RESET_RESUME },
261 	{ USB_DEVICE(0x093a, 0x2510), .driver_info = USB_QUIRK_RESET_RESUME },
262 	{ USB_DEVICE(0x093a, 0x2521), .driver_info = USB_QUIRK_RESET_RESUME },
263 	{ USB_DEVICE(0x03f0, 0x2b4a), .driver_info = USB_QUIRK_RESET_RESUME },
264 
265 	/* Logitech Optical Mouse M90/M100 */
266 	{ USB_DEVICE(0x046d, 0xc05a), .driver_info = USB_QUIRK_RESET_RESUME },
267 
268 	{ }  /* terminating entry must be last */
269 };
270 
271 static bool usb_match_any_interface(struct usb_device *udev,
272 				    const struct usb_device_id *id)
273 {
274 	unsigned int i;
275 
276 	for (i = 0; i < udev->descriptor.bNumConfigurations; ++i) {
277 		struct usb_host_config *cfg = &udev->config[i];
278 		unsigned int j;
279 
280 		for (j = 0; j < cfg->desc.bNumInterfaces; ++j) {
281 			struct usb_interface_cache *cache;
282 			struct usb_host_interface *intf;
283 
284 			cache = cfg->intf_cache[j];
285 			if (cache->num_altsetting == 0)
286 				continue;
287 
288 			intf = &cache->altsetting[0];
289 			if (usb_match_one_id_intf(udev, intf, id))
290 				return true;
291 		}
292 	}
293 
294 	return false;
295 }
296 
297 static int usb_amd_resume_quirk(struct usb_device *udev)
298 {
299 	struct usb_hcd *hcd;
300 
301 	hcd = bus_to_hcd(udev->bus);
302 	/* The device should be attached directly to root hub */
303 	if (udev->level == 1 && hcd->amd_resume_bug == 1)
304 		return 1;
305 
306 	return 0;
307 }
308 
309 static u32 __usb_detect_quirks(struct usb_device *udev,
310 			       const struct usb_device_id *id)
311 {
312 	u32 quirks = 0;
313 
314 	for (; id->match_flags; id++) {
315 		if (!usb_match_device(udev, id))
316 			continue;
317 
318 		if ((id->match_flags & USB_DEVICE_ID_MATCH_INT_INFO) &&
319 		    !usb_match_any_interface(udev, id))
320 			continue;
321 
322 		quirks |= (u32)(id->driver_info);
323 	}
324 
325 	return quirks;
326 }
327 
328 /*
329  * Detect any quirks the device has, and do any housekeeping for it if needed.
330  */
331 void usb_detect_quirks(struct usb_device *udev)
332 {
333 	udev->quirks = __usb_detect_quirks(udev, usb_quirk_list);
334 
335 	/*
336 	 * Pixart-based mice would trigger remote wakeup issue on AMD
337 	 * Yangtze chipset, so set them as RESET_RESUME flag.
338 	 */
339 	if (usb_amd_resume_quirk(udev))
340 		udev->quirks |= __usb_detect_quirks(udev,
341 				usb_amd_resume_quirk_list);
342 
343 	if (udev->quirks)
344 		dev_dbg(&udev->dev, "USB quirks for this device: %x\n",
345 			udev->quirks);
346 
347 #ifdef CONFIG_USB_DEFAULT_PERSIST
348 	if (!(udev->quirks & USB_QUIRK_RESET))
349 		udev->persist_enabled = 1;
350 #else
351 	/* Hubs are automatically enabled for USB-PERSIST */
352 	if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
353 		udev->persist_enabled = 1;
354 #endif	/* CONFIG_USB_DEFAULT_PERSIST */
355 }
356 
357 void usb_detect_interface_quirks(struct usb_device *udev)
358 {
359 	u32 quirks;
360 
361 	quirks = __usb_detect_quirks(udev, usb_interface_quirk_list);
362 	if (quirks == 0)
363 		return;
364 
365 	dev_dbg(&udev->dev, "USB interface quirks for this device: %x\n",
366 		quirks);
367 	udev->quirks |= quirks;
368 }
369