]> Git Repo - linux.git/blob - drivers/usb/core/quirks.c
Merge tag 'devicetree-for-4.18' of git://git.kernel.org/pub/scm/linux/kernel/git...
[linux.git] / drivers / usb / core / quirks.c
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * USB device quirk handling logic and table
4  *
5  * Copyright (c) 2007 Oliver Neukum
6  * Copyright (c) 2007 Greg Kroah-Hartman <[email protected]>
7  */
8
9 #include <linux/moduleparam.h>
10 #include <linux/usb.h>
11 #include <linux/usb/quirks.h>
12 #include <linux/usb/hcd.h>
13 #include "usb.h"
14
15 struct quirk_entry {
16         u16 vid;
17         u16 pid;
18         u32 flags;
19 };
20
21 static DEFINE_MUTEX(quirk_mutex);
22
23 static struct quirk_entry *quirk_list;
24 static unsigned int quirk_count;
25
26 static char quirks_param[128];
27
28 static int quirks_param_set(const char *val, const struct kernel_param *kp)
29 {
30         char *p, *field;
31         u16 vid, pid;
32         u32 flags;
33         size_t i;
34         int err;
35
36         err = param_set_copystring(val, kp);
37         if (err)
38                 return err;
39
40         mutex_lock(&quirk_mutex);
41
42         if (!*val) {
43                 quirk_count = 0;
44                 kfree(quirk_list);
45                 quirk_list = NULL;
46                 goto unlock;
47         }
48
49         for (quirk_count = 1, i = 0; val[i]; i++)
50                 if (val[i] == ',')
51                         quirk_count++;
52
53         if (quirk_list) {
54                 kfree(quirk_list);
55                 quirk_list = NULL;
56         }
57
58         quirk_list = kcalloc(quirk_count, sizeof(struct quirk_entry),
59                              GFP_KERNEL);
60         if (!quirk_list) {
61                 mutex_unlock(&quirk_mutex);
62                 return -ENOMEM;
63         }
64
65         for (i = 0, p = (char *)val; p && *p;) {
66                 /* Each entry consists of VID:PID:flags */
67                 field = strsep(&p, ":");
68                 if (!field)
69                         break;
70
71                 if (kstrtou16(field, 16, &vid))
72                         break;
73
74                 field = strsep(&p, ":");
75                 if (!field)
76                         break;
77
78                 if (kstrtou16(field, 16, &pid))
79                         break;
80
81                 field = strsep(&p, ",");
82                 if (!field || !*field)
83                         break;
84
85                 /* Collect the flags */
86                 for (flags = 0; *field; field++) {
87                         switch (*field) {
88                         case 'a':
89                                 flags |= USB_QUIRK_STRING_FETCH_255;
90                                 break;
91                         case 'b':
92                                 flags |= USB_QUIRK_RESET_RESUME;
93                                 break;
94                         case 'c':
95                                 flags |= USB_QUIRK_NO_SET_INTF;
96                                 break;
97                         case 'd':
98                                 flags |= USB_QUIRK_CONFIG_INTF_STRINGS;
99                                 break;
100                         case 'e':
101                                 flags |= USB_QUIRK_RESET;
102                                 break;
103                         case 'f':
104                                 flags |= USB_QUIRK_HONOR_BNUMINTERFACES;
105                                 break;
106                         case 'g':
107                                 flags |= USB_QUIRK_DELAY_INIT;
108                                 break;
109                         case 'h':
110                                 flags |= USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL;
111                                 break;
112                         case 'i':
113                                 flags |= USB_QUIRK_DEVICE_QUALIFIER;
114                                 break;
115                         case 'j':
116                                 flags |= USB_QUIRK_IGNORE_REMOTE_WAKEUP;
117                                 break;
118                         case 'k':
119                                 flags |= USB_QUIRK_NO_LPM;
120                                 break;
121                         case 'l':
122                                 flags |= USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL;
123                                 break;
124                         case 'm':
125                                 flags |= USB_QUIRK_DISCONNECT_SUSPEND;
126                                 break;
127                         case 'n':
128                                 flags |= USB_QUIRK_DELAY_CTRL_MSG;
129                                 break;
130                         /* Ignore unrecognized flag characters */
131                         }
132                 }
133
134                 quirk_list[i++] = (struct quirk_entry)
135                         { .vid = vid, .pid = pid, .flags = flags };
136         }
137
138         if (i < quirk_count)
139                 quirk_count = i;
140
141 unlock:
142         mutex_unlock(&quirk_mutex);
143
144         return 0;
145 }
146
147 static const struct kernel_param_ops quirks_param_ops = {
148         .set = quirks_param_set,
149         .get = param_get_string,
150 };
151
152 static struct kparam_string quirks_param_string = {
153         .maxlen = sizeof(quirks_param),
154         .string = quirks_param,
155 };
156
157 module_param_cb(quirks, &quirks_param_ops, &quirks_param_string, 0644);
158 MODULE_PARM_DESC(quirks, "Add/modify USB quirks by specifying quirks=vendorID:productID:quirks");
159
160 /* Lists of quirky USB devices, split in device quirks and interface quirks.
161  * Device quirks are applied at the very beginning of the enumeration process,
162  * right after reading the device descriptor. They can thus only match on device
163  * information.
164  *
165  * Interface quirks are applied after reading all the configuration descriptors.
166  * They can match on both device and interface information.
167  *
168  * Note that the DELAY_INIT and HONOR_BNUMINTERFACES quirks do not make sense as
169  * interface quirks, as they only influence the enumeration process which is run
170  * before processing the interface quirks.
171  *
172  * Please keep the lists ordered by:
173  *      1) Vendor ID
174  *      2) Product ID
175  *      3) Class ID
176  */
177 static const struct usb_device_id usb_quirk_list[] = {
178         /* CBM - Flash disk */
179         { USB_DEVICE(0x0204, 0x6025), .driver_info = USB_QUIRK_RESET_RESUME },
180
181         /* WORLDE easy key (easykey.25) MIDI controller  */
182         { USB_DEVICE(0x0218, 0x0401), .driver_info =
183                         USB_QUIRK_CONFIG_INTF_STRINGS },
184
185         /* HP 5300/5370C scanner */
186         { USB_DEVICE(0x03f0, 0x0701), .driver_info =
187                         USB_QUIRK_STRING_FETCH_255 },
188
189         /* HP v222w 16GB Mini USB Drive */
190         { USB_DEVICE(0x03f0, 0x3f40), .driver_info = USB_QUIRK_DELAY_INIT },
191
192         /* Creative SB Audigy 2 NX */
193         { USB_DEVICE(0x041e, 0x3020), .driver_info = USB_QUIRK_RESET_RESUME },
194
195         /* USB3503 */
196         { USB_DEVICE(0x0424, 0x3503), .driver_info = USB_QUIRK_RESET_RESUME },
197
198         /* Microsoft Wireless Laser Mouse 6000 Receiver */
199         { USB_DEVICE(0x045e, 0x00e1), .driver_info = USB_QUIRK_RESET_RESUME },
200
201         /* Microsoft LifeCam-VX700 v2.0 */
202         { USB_DEVICE(0x045e, 0x0770), .driver_info = USB_QUIRK_RESET_RESUME },
203
204         /* Logitech HD Pro Webcams C920, C920-C, C925e and C930e */
205         { USB_DEVICE(0x046d, 0x082d), .driver_info = USB_QUIRK_DELAY_INIT },
206         { USB_DEVICE(0x046d, 0x0841), .driver_info = USB_QUIRK_DELAY_INIT },
207         { USB_DEVICE(0x046d, 0x0843), .driver_info = USB_QUIRK_DELAY_INIT },
208         { USB_DEVICE(0x046d, 0x085b), .driver_info = USB_QUIRK_DELAY_INIT },
209
210         /* Logitech ConferenceCam CC3000e */
211         { USB_DEVICE(0x046d, 0x0847), .driver_info = USB_QUIRK_DELAY_INIT },
212         { USB_DEVICE(0x046d, 0x0848), .driver_info = USB_QUIRK_DELAY_INIT },
213
214         /* Logitech PTZ Pro Camera */
215         { USB_DEVICE(0x046d, 0x0853), .driver_info = USB_QUIRK_DELAY_INIT },
216
217         /* Logitech Quickcam Fusion */
218         { USB_DEVICE(0x046d, 0x08c1), .driver_info = USB_QUIRK_RESET_RESUME },
219
220         /* Logitech Quickcam Orbit MP */
221         { USB_DEVICE(0x046d, 0x08c2), .driver_info = USB_QUIRK_RESET_RESUME },
222
223         /* Logitech Quickcam Pro for Notebook */
224         { USB_DEVICE(0x046d, 0x08c3), .driver_info = USB_QUIRK_RESET_RESUME },
225
226         /* Logitech Quickcam Pro 5000 */
227         { USB_DEVICE(0x046d, 0x08c5), .driver_info = USB_QUIRK_RESET_RESUME },
228
229         /* Logitech Quickcam OEM Dell Notebook */
230         { USB_DEVICE(0x046d, 0x08c6), .driver_info = USB_QUIRK_RESET_RESUME },
231
232         /* Logitech Quickcam OEM Cisco VT Camera II */
233         { USB_DEVICE(0x046d, 0x08c7), .driver_info = USB_QUIRK_RESET_RESUME },
234
235         /* Logitech Harmony 700-series */
236         { USB_DEVICE(0x046d, 0xc122), .driver_info = USB_QUIRK_DELAY_INIT },
237
238         /* Philips PSC805 audio device */
239         { USB_DEVICE(0x0471, 0x0155), .driver_info = USB_QUIRK_RESET_RESUME },
240
241         /* Plantronic Audio 655 DSP */
242         { USB_DEVICE(0x047f, 0xc008), .driver_info = USB_QUIRK_RESET_RESUME },
243
244         /* Plantronic Audio 648 USB */
245         { USB_DEVICE(0x047f, 0xc013), .driver_info = USB_QUIRK_RESET_RESUME },
246
247         /* Artisman Watchdog Dongle */
248         { USB_DEVICE(0x04b4, 0x0526), .driver_info =
249                         USB_QUIRK_CONFIG_INTF_STRINGS },
250
251         /* Microchip Joss Optical infrared touchboard device */
252         { USB_DEVICE(0x04d8, 0x000c), .driver_info =
253                         USB_QUIRK_CONFIG_INTF_STRINGS },
254
255         /* CarrolTouch 4000U */
256         { USB_DEVICE(0x04e7, 0x0009), .driver_info = USB_QUIRK_RESET_RESUME },
257
258         /* CarrolTouch 4500U */
259         { USB_DEVICE(0x04e7, 0x0030), .driver_info = USB_QUIRK_RESET_RESUME },
260
261         /* Samsung Android phone modem - ID conflict with SPH-I500 */
262         { USB_DEVICE(0x04e8, 0x6601), .driver_info =
263                         USB_QUIRK_CONFIG_INTF_STRINGS },
264
265         /* Elan Touchscreen */
266         { USB_DEVICE(0x04f3, 0x0089), .driver_info =
267                         USB_QUIRK_DEVICE_QUALIFIER },
268
269         { USB_DEVICE(0x04f3, 0x009b), .driver_info =
270                         USB_QUIRK_DEVICE_QUALIFIER },
271
272         { USB_DEVICE(0x04f3, 0x010c), .driver_info =
273                         USB_QUIRK_DEVICE_QUALIFIER },
274
275         { USB_DEVICE(0x04f3, 0x0125), .driver_info =
276                         USB_QUIRK_DEVICE_QUALIFIER },
277
278         { USB_DEVICE(0x04f3, 0x016f), .driver_info =
279                         USB_QUIRK_DEVICE_QUALIFIER },
280
281         { USB_DEVICE(0x04f3, 0x0381), .driver_info =
282                         USB_QUIRK_NO_LPM },
283
284         { USB_DEVICE(0x04f3, 0x21b8), .driver_info =
285                         USB_QUIRK_DEVICE_QUALIFIER },
286
287         /* Roland SC-8820 */
288         { USB_DEVICE(0x0582, 0x0007), .driver_info = USB_QUIRK_RESET_RESUME },
289
290         /* Edirol SD-20 */
291         { USB_DEVICE(0x0582, 0x0027), .driver_info = USB_QUIRK_RESET_RESUME },
292
293         /* Alcor Micro Corp. Hub */
294         { USB_DEVICE(0x058f, 0x9254), .driver_info = USB_QUIRK_RESET_RESUME },
295
296         /* appletouch */
297         { USB_DEVICE(0x05ac, 0x021a), .driver_info = USB_QUIRK_RESET_RESUME },
298
299         /* Genesys Logic hub, internally used by KY-688 USB 3.1 Type-C Hub */
300         { USB_DEVICE(0x05e3, 0x0612), .driver_info = USB_QUIRK_NO_LPM },
301
302         /* ELSA MicroLink 56K */
303         { USB_DEVICE(0x05cc, 0x2267), .driver_info = USB_QUIRK_RESET_RESUME },
304
305         /* Genesys Logic hub, internally used by Moshi USB to Ethernet Adapter */
306         { USB_DEVICE(0x05e3, 0x0616), .driver_info = USB_QUIRK_NO_LPM },
307
308         /* Avision AV600U */
309         { USB_DEVICE(0x0638, 0x0a13), .driver_info =
310           USB_QUIRK_STRING_FETCH_255 },
311
312         /* Saitek Cyborg Gold Joystick */
313         { USB_DEVICE(0x06a3, 0x0006), .driver_info =
314                         USB_QUIRK_CONFIG_INTF_STRINGS },
315
316         /* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
317         { USB_DEVICE(0x06f8, 0x0804), .driver_info = USB_QUIRK_RESET_RESUME },
318
319         /* Guillemot Webcam Hercules Dualpix Exchange*/
320         { USB_DEVICE(0x06f8, 0x3005), .driver_info = USB_QUIRK_RESET_RESUME },
321
322         /* Midiman M-Audio Keystation 88es */
323         { USB_DEVICE(0x0763, 0x0192), .driver_info = USB_QUIRK_RESET_RESUME },
324
325         /* M-Systems Flash Disk Pioneers */
326         { USB_DEVICE(0x08ec, 0x1000), .driver_info = USB_QUIRK_RESET_RESUME },
327
328         /* Baum Vario Ultra */
329         { USB_DEVICE(0x0904, 0x6101), .driver_info =
330                         USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
331         { USB_DEVICE(0x0904, 0x6102), .driver_info =
332                         USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
333         { USB_DEVICE(0x0904, 0x6103), .driver_info =
334                         USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
335
336         /* Keytouch QWERTY Panel keyboard */
337         { USB_DEVICE(0x0926, 0x3333), .driver_info =
338                         USB_QUIRK_CONFIG_INTF_STRINGS },
339
340         /* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
341         { USB_DEVICE(0x0971, 0x2000), .driver_info = USB_QUIRK_NO_SET_INTF },
342
343         /* Broadcom BCM92035DGROM BT dongle */
344         { USB_DEVICE(0x0a5c, 0x2021), .driver_info = USB_QUIRK_RESET_RESUME },
345
346         /* MAYA44USB sound device */
347         { USB_DEVICE(0x0a92, 0x0091), .driver_info = USB_QUIRK_RESET_RESUME },
348
349         /* ASUS Base Station(T100) */
350         { USB_DEVICE(0x0b05, 0x17e0), .driver_info =
351                         USB_QUIRK_IGNORE_REMOTE_WAKEUP },
352
353         /* Action Semiconductor flash disk */
354         { USB_DEVICE(0x10d6, 0x2200), .driver_info =
355                         USB_QUIRK_STRING_FETCH_255 },
356
357         /* Huawei 4G LTE module */
358         { USB_DEVICE(0x12d1, 0x15bb), .driver_info =
359                         USB_QUIRK_DISCONNECT_SUSPEND },
360         { USB_DEVICE(0x12d1, 0x15c3), .driver_info =
361                         USB_QUIRK_DISCONNECT_SUSPEND },
362
363         /* SKYMEDI USB_DRIVE */
364         { USB_DEVICE(0x1516, 0x8628), .driver_info = USB_QUIRK_RESET_RESUME },
365
366         /* Razer - Razer Blade Keyboard */
367         { USB_DEVICE(0x1532, 0x0116), .driver_info =
368                         USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
369
370         /* BUILDWIN Photo Frame */
371         { USB_DEVICE(0x1908, 0x1315), .driver_info =
372                         USB_QUIRK_HONOR_BNUMINTERFACES },
373
374         /* Protocol and OTG Electrical Test Device */
375         { USB_DEVICE(0x1a0a, 0x0200), .driver_info =
376                         USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
377
378         /* Corsair K70 RGB */
379         { USB_DEVICE(0x1b1c, 0x1b13), .driver_info = USB_QUIRK_DELAY_INIT },
380
381         /* Corsair Strafe RGB */
382         { USB_DEVICE(0x1b1c, 0x1b20), .driver_info = USB_QUIRK_DELAY_INIT |
383           USB_QUIRK_DELAY_CTRL_MSG },
384
385         /* Corsair K70 LUX */
386         { USB_DEVICE(0x1b1c, 0x1b36), .driver_info = USB_QUIRK_DELAY_INIT },
387
388         /* MIDI keyboard WORLDE MINI */
389         { USB_DEVICE(0x1c75, 0x0204), .driver_info =
390                         USB_QUIRK_CONFIG_INTF_STRINGS },
391
392         /* Acer C120 LED Projector */
393         { USB_DEVICE(0x1de1, 0xc102), .driver_info = USB_QUIRK_NO_LPM },
394
395         /* Blackmagic Design Intensity Shuttle */
396         { USB_DEVICE(0x1edb, 0xbd3b), .driver_info = USB_QUIRK_NO_LPM },
397
398         /* Blackmagic Design UltraStudio SDI */
399         { USB_DEVICE(0x1edb, 0xbd4f), .driver_info = USB_QUIRK_NO_LPM },
400
401         /* Hauppauge HVR-950q */
402         { USB_DEVICE(0x2040, 0x7200), .driver_info =
403                         USB_QUIRK_CONFIG_INTF_STRINGS },
404
405         /* INTEL VALUE SSD */
406         { USB_DEVICE(0x8086, 0xf1a5), .driver_info = USB_QUIRK_RESET_RESUME },
407
408         { }  /* terminating entry must be last */
409 };
410
411 static const struct usb_device_id usb_interface_quirk_list[] = {
412         /* Logitech UVC Cameras */
413         { USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO, 1, 0),
414           .driver_info = USB_QUIRK_RESET_RESUME },
415
416         { }  /* terminating entry must be last */
417 };
418
419 static const struct usb_device_id usb_amd_resume_quirk_list[] = {
420         /* Lenovo Mouse with Pixart controller */
421         { USB_DEVICE(0x17ef, 0x602e), .driver_info = USB_QUIRK_RESET_RESUME },
422
423         /* Pixart Mouse */
424         { USB_DEVICE(0x093a, 0x2500), .driver_info = USB_QUIRK_RESET_RESUME },
425         { USB_DEVICE(0x093a, 0x2510), .driver_info = USB_QUIRK_RESET_RESUME },
426         { USB_DEVICE(0x093a, 0x2521), .driver_info = USB_QUIRK_RESET_RESUME },
427         { USB_DEVICE(0x03f0, 0x2b4a), .driver_info = USB_QUIRK_RESET_RESUME },
428
429         /* Logitech Optical Mouse M90/M100 */
430         { USB_DEVICE(0x046d, 0xc05a), .driver_info = USB_QUIRK_RESET_RESUME },
431
432         { }  /* terminating entry must be last */
433 };
434
435 static bool usb_match_any_interface(struct usb_device *udev,
436                                     const struct usb_device_id *id)
437 {
438         unsigned int i;
439
440         for (i = 0; i < udev->descriptor.bNumConfigurations; ++i) {
441                 struct usb_host_config *cfg = &udev->config[i];
442                 unsigned int j;
443
444                 for (j = 0; j < cfg->desc.bNumInterfaces; ++j) {
445                         struct usb_interface_cache *cache;
446                         struct usb_host_interface *intf;
447
448                         cache = cfg->intf_cache[j];
449                         if (cache->num_altsetting == 0)
450                                 continue;
451
452                         intf = &cache->altsetting[0];
453                         if (usb_match_one_id_intf(udev, intf, id))
454                                 return true;
455                 }
456         }
457
458         return false;
459 }
460
461 static int usb_amd_resume_quirk(struct usb_device *udev)
462 {
463         struct usb_hcd *hcd;
464
465         hcd = bus_to_hcd(udev->bus);
466         /* The device should be attached directly to root hub */
467         if (udev->level == 1 && hcd->amd_resume_bug == 1)
468                 return 1;
469
470         return 0;
471 }
472
473 static u32 usb_detect_static_quirks(struct usb_device *udev,
474                                     const struct usb_device_id *id)
475 {
476         u32 quirks = 0;
477
478         for (; id->match_flags; id++) {
479                 if (!usb_match_device(udev, id))
480                         continue;
481
482                 if ((id->match_flags & USB_DEVICE_ID_MATCH_INT_INFO) &&
483                     !usb_match_any_interface(udev, id))
484                         continue;
485
486                 quirks |= (u32)(id->driver_info);
487         }
488
489         return quirks;
490 }
491
492 static u32 usb_detect_dynamic_quirks(struct usb_device *udev)
493 {
494         u16 vid = le16_to_cpu(udev->descriptor.idVendor);
495         u16 pid = le16_to_cpu(udev->descriptor.idProduct);
496         int i, flags = 0;
497
498         mutex_lock(&quirk_mutex);
499
500         for (i = 0; i < quirk_count; i++) {
501                 if (vid == quirk_list[i].vid && pid == quirk_list[i].pid) {
502                         flags = quirk_list[i].flags;
503                         break;
504                 }
505         }
506
507         mutex_unlock(&quirk_mutex);
508
509         return flags;
510 }
511
512 /*
513  * Detect any quirks the device has, and do any housekeeping for it if needed.
514  */
515 void usb_detect_quirks(struct usb_device *udev)
516 {
517         udev->quirks = usb_detect_static_quirks(udev, usb_quirk_list);
518
519         /*
520          * Pixart-based mice would trigger remote wakeup issue on AMD
521          * Yangtze chipset, so set them as RESET_RESUME flag.
522          */
523         if (usb_amd_resume_quirk(udev))
524                 udev->quirks |= usb_detect_static_quirks(udev,
525                                 usb_amd_resume_quirk_list);
526
527         udev->quirks ^= usb_detect_dynamic_quirks(udev);
528
529         if (udev->quirks)
530                 dev_dbg(&udev->dev, "USB quirks for this device: %x\n",
531                         udev->quirks);
532
533 #ifdef CONFIG_USB_DEFAULT_PERSIST
534         if (!(udev->quirks & USB_QUIRK_RESET))
535                 udev->persist_enabled = 1;
536 #else
537         /* Hubs are automatically enabled for USB-PERSIST */
538         if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
539                 udev->persist_enabled = 1;
540 #endif  /* CONFIG_USB_DEFAULT_PERSIST */
541 }
542
543 void usb_detect_interface_quirks(struct usb_device *udev)
544 {
545         u32 quirks;
546
547         quirks = usb_detect_static_quirks(udev, usb_interface_quirk_list);
548         if (quirks == 0)
549                 return;
550
551         dev_dbg(&udev->dev, "USB interface quirks for this device: %x\n",
552                 quirks);
553         udev->quirks |= quirks;
554 }
555
556 void usb_release_quirk_list(void)
557 {
558         mutex_lock(&quirk_mutex);
559         kfree(quirk_list);
560         quirk_list = NULL;
561         mutex_unlock(&quirk_mutex);
562 }
This page took 0.077076 seconds and 4 git commands to generate.