1 // SPDX-License-Identifier: GPL-2.0
3 * USB device quirk handling logic and table
5 * Copyright (c) 2007 Oliver Neukum
9 #include <linux/moduleparam.h>
10 #include <linux/usb.h>
11 #include <linux/usb/quirks.h>
12 #include <linux/usb/hcd.h>
21 static DEFINE_MUTEX(quirk_mutex);
23 static struct quirk_entry *quirk_list;
24 static unsigned int quirk_count;
26 static char quirks_param[128];
28 static int quirks_param_set(const char *val, const struct kernel_param *kp)
36 err = param_set_copystring(val, kp);
40 mutex_lock(&quirk_mutex);
49 for (quirk_count = 1, i = 0; val[i]; i++)
58 quirk_list = kcalloc(quirk_count, sizeof(struct quirk_entry),
62 mutex_unlock(&quirk_mutex);
66 for (i = 0, p = (char *)val; p && *p;) {
67 /* Each entry consists of VID:PID:flags */
68 field = strsep(&p, ":");
72 if (kstrtou16(field, 16, &vid))
75 field = strsep(&p, ":");
79 if (kstrtou16(field, 16, &pid))
82 field = strsep(&p, ",");
83 if (!field || !*field)
86 /* Collect the flags */
87 for (flags = 0; *field; field++) {
90 flags |= USB_QUIRK_STRING_FETCH_255;
93 flags |= USB_QUIRK_RESET_RESUME;
96 flags |= USB_QUIRK_NO_SET_INTF;
99 flags |= USB_QUIRK_CONFIG_INTF_STRINGS;
102 flags |= USB_QUIRK_RESET;
105 flags |= USB_QUIRK_HONOR_BNUMINTERFACES;
108 flags |= USB_QUIRK_DELAY_INIT;
111 flags |= USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL;
114 flags |= USB_QUIRK_DEVICE_QUALIFIER;
117 flags |= USB_QUIRK_IGNORE_REMOTE_WAKEUP;
120 flags |= USB_QUIRK_NO_LPM;
123 flags |= USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL;
126 flags |= USB_QUIRK_DISCONNECT_SUSPEND;
129 flags |= USB_QUIRK_DELAY_CTRL_MSG;
132 flags |= USB_QUIRK_HUB_SLOW_RESET;
134 /* Ignore unrecognized flag characters */
138 quirk_list[i++] = (struct quirk_entry)
139 { .vid = vid, .pid = pid, .flags = flags };
146 mutex_unlock(&quirk_mutex);
151 static const struct kernel_param_ops quirks_param_ops = {
152 .set = quirks_param_set,
153 .get = param_get_string,
156 static struct kparam_string quirks_param_string = {
157 .maxlen = sizeof(quirks_param),
158 .string = quirks_param,
161 device_param_cb(quirks, &quirks_param_ops, &quirks_param_string, 0644);
162 MODULE_PARM_DESC(quirks, "Add/modify USB quirks by specifying quirks=vendorID:productID:quirks");
164 /* Lists of quirky USB devices, split in device quirks and interface quirks.
165 * Device quirks are applied at the very beginning of the enumeration process,
166 * right after reading the device descriptor. They can thus only match on device
169 * Interface quirks are applied after reading all the configuration descriptors.
170 * They can match on both device and interface information.
172 * Note that the DELAY_INIT and HONOR_BNUMINTERFACES quirks do not make sense as
173 * interface quirks, as they only influence the enumeration process which is run
174 * before processing the interface quirks.
176 * Please keep the lists ordered by:
181 static const struct usb_device_id usb_quirk_list[] = {
182 /* CBM - Flash disk */
183 { USB_DEVICE(0x0204, 0x6025), .driver_info = USB_QUIRK_RESET_RESUME },
185 /* WORLDE Controller KS49 or Prodipe MIDI 49C USB controller */
186 { USB_DEVICE(0x0218, 0x0201), .driver_info =
187 USB_QUIRK_CONFIG_INTF_STRINGS },
189 /* WORLDE easy key (easykey.25) MIDI controller */
190 { USB_DEVICE(0x0218, 0x0401), .driver_info =
191 USB_QUIRK_CONFIG_INTF_STRINGS },
193 /* HP 5300/5370C scanner */
194 { USB_DEVICE(0x03f0, 0x0701), .driver_info =
195 USB_QUIRK_STRING_FETCH_255 },
197 /* HP v222w 16GB Mini USB Drive */
198 { USB_DEVICE(0x03f0, 0x3f40), .driver_info = USB_QUIRK_DELAY_INIT },
200 /* Creative SB Audigy 2 NX */
201 { USB_DEVICE(0x041e, 0x3020), .driver_info = USB_QUIRK_RESET_RESUME },
204 { USB_DEVICE(0x0424, 0x3503), .driver_info = USB_QUIRK_RESET_RESUME },
206 /* Microsoft Wireless Laser Mouse 6000 Receiver */
207 { USB_DEVICE(0x045e, 0x00e1), .driver_info = USB_QUIRK_RESET_RESUME },
209 /* Microsoft LifeCam-VX700 v2.0 */
210 { USB_DEVICE(0x045e, 0x0770), .driver_info = USB_QUIRK_RESET_RESUME },
212 /* Microsoft Surface Dock Ethernet (RTL8153 GigE) */
213 { USB_DEVICE(0x045e, 0x07c6), .driver_info = USB_QUIRK_NO_LPM },
215 /* Cherry Stream G230 2.0 (G85-231) and 3.0 (G85-232) */
216 { USB_DEVICE(0x046a, 0x0023), .driver_info = USB_QUIRK_RESET_RESUME },
218 /* Logitech HD Webcam C270 */
219 { USB_DEVICE(0x046d, 0x0825), .driver_info = USB_QUIRK_RESET_RESUME },
221 /* Logitech HD Pro Webcams C920, C920-C, C925e and C930e */
222 { USB_DEVICE(0x046d, 0x082d), .driver_info = USB_QUIRK_DELAY_INIT },
223 { USB_DEVICE(0x046d, 0x0841), .driver_info = USB_QUIRK_DELAY_INIT },
224 { USB_DEVICE(0x046d, 0x0843), .driver_info = USB_QUIRK_DELAY_INIT },
225 { USB_DEVICE(0x046d, 0x085b), .driver_info = USB_QUIRK_DELAY_INIT },
227 /* Logitech ConferenceCam CC3000e */
228 { USB_DEVICE(0x046d, 0x0847), .driver_info = USB_QUIRK_DELAY_INIT },
229 { USB_DEVICE(0x046d, 0x0848), .driver_info = USB_QUIRK_DELAY_INIT },
231 /* Logitech PTZ Pro Camera */
232 { USB_DEVICE(0x046d, 0x0853), .driver_info = USB_QUIRK_DELAY_INIT },
234 /* Logitech Screen Share */
235 { USB_DEVICE(0x046d, 0x086c), .driver_info = USB_QUIRK_NO_LPM },
237 /* Logitech Quickcam Fusion */
238 { USB_DEVICE(0x046d, 0x08c1), .driver_info = USB_QUIRK_RESET_RESUME },
240 /* Logitech Quickcam Orbit MP */
241 { USB_DEVICE(0x046d, 0x08c2), .driver_info = USB_QUIRK_RESET_RESUME },
243 /* Logitech Quickcam Pro for Notebook */
244 { USB_DEVICE(0x046d, 0x08c3), .driver_info = USB_QUIRK_RESET_RESUME },
246 /* Logitech Quickcam Pro 5000 */
247 { USB_DEVICE(0x046d, 0x08c5), .driver_info = USB_QUIRK_RESET_RESUME },
249 /* Logitech Quickcam OEM Dell Notebook */
250 { USB_DEVICE(0x046d, 0x08c6), .driver_info = USB_QUIRK_RESET_RESUME },
252 /* Logitech Quickcam OEM Cisco VT Camera II */
253 { USB_DEVICE(0x046d, 0x08c7), .driver_info = USB_QUIRK_RESET_RESUME },
255 /* Logitech Harmony 700-series */
256 { USB_DEVICE(0x046d, 0xc122), .driver_info = USB_QUIRK_DELAY_INIT },
258 /* Philips PSC805 audio device */
259 { USB_DEVICE(0x0471, 0x0155), .driver_info = USB_QUIRK_RESET_RESUME },
261 /* Plantronic Audio 655 DSP */
262 { USB_DEVICE(0x047f, 0xc008), .driver_info = USB_QUIRK_RESET_RESUME },
264 /* Plantronic Audio 648 USB */
265 { USB_DEVICE(0x047f, 0xc013), .driver_info = USB_QUIRK_RESET_RESUME },
267 /* Artisman Watchdog Dongle */
268 { USB_DEVICE(0x04b4, 0x0526), .driver_info =
269 USB_QUIRK_CONFIG_INTF_STRINGS },
271 /* Microchip Joss Optical infrared touchboard device */
272 { USB_DEVICE(0x04d8, 0x000c), .driver_info =
273 USB_QUIRK_CONFIG_INTF_STRINGS },
275 /* CarrolTouch 4000U */
276 { USB_DEVICE(0x04e7, 0x0009), .driver_info = USB_QUIRK_RESET_RESUME },
278 /* CarrolTouch 4500U */
279 { USB_DEVICE(0x04e7, 0x0030), .driver_info = USB_QUIRK_RESET_RESUME },
281 /* Samsung Android phone modem - ID conflict with SPH-I500 */
282 { USB_DEVICE(0x04e8, 0x6601), .driver_info =
283 USB_QUIRK_CONFIG_INTF_STRINGS },
285 /* Elan Touchscreen */
286 { USB_DEVICE(0x04f3, 0x0089), .driver_info =
287 USB_QUIRK_DEVICE_QUALIFIER },
289 { USB_DEVICE(0x04f3, 0x009b), .driver_info =
290 USB_QUIRK_DEVICE_QUALIFIER },
292 { USB_DEVICE(0x04f3, 0x010c), .driver_info =
293 USB_QUIRK_DEVICE_QUALIFIER },
295 { USB_DEVICE(0x04f3, 0x0125), .driver_info =
296 USB_QUIRK_DEVICE_QUALIFIER },
298 { USB_DEVICE(0x04f3, 0x016f), .driver_info =
299 USB_QUIRK_DEVICE_QUALIFIER },
301 { USB_DEVICE(0x04f3, 0x0381), .driver_info =
304 { USB_DEVICE(0x04f3, 0x21b8), .driver_info =
305 USB_QUIRK_DEVICE_QUALIFIER },
308 { USB_DEVICE(0x0582, 0x0007), .driver_info = USB_QUIRK_RESET_RESUME },
311 { USB_DEVICE(0x0582, 0x0027), .driver_info = USB_QUIRK_RESET_RESUME },
313 /* Alcor Micro Corp. Hub */
314 { USB_DEVICE(0x058f, 0x9254), .driver_info = USB_QUIRK_RESET_RESUME },
317 { USB_DEVICE(0x05ac, 0x021a), .driver_info = USB_QUIRK_RESET_RESUME },
319 /* Genesys Logic hub, internally used by KY-688 USB 3.1 Type-C Hub */
320 { USB_DEVICE(0x05e3, 0x0612), .driver_info = USB_QUIRK_NO_LPM },
322 /* ELSA MicroLink 56K */
323 { USB_DEVICE(0x05cc, 0x2267), .driver_info = USB_QUIRK_RESET_RESUME },
325 /* Genesys Logic hub, internally used by Moshi USB to Ethernet Adapter */
326 { USB_DEVICE(0x05e3, 0x0616), .driver_info = USB_QUIRK_NO_LPM },
329 { USB_DEVICE(0x0638, 0x0a13), .driver_info =
330 USB_QUIRK_STRING_FETCH_255 },
332 /* Saitek Cyborg Gold Joystick */
333 { USB_DEVICE(0x06a3, 0x0006), .driver_info =
334 USB_QUIRK_CONFIG_INTF_STRINGS },
336 /* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
337 { USB_DEVICE(0x06f8, 0x0804), .driver_info = USB_QUIRK_RESET_RESUME },
339 /* Guillemot Webcam Hercules Dualpix Exchange*/
340 { USB_DEVICE(0x06f8, 0x3005), .driver_info = USB_QUIRK_RESET_RESUME },
342 /* Midiman M-Audio Keystation 88es */
343 { USB_DEVICE(0x0763, 0x0192), .driver_info = USB_QUIRK_RESET_RESUME },
345 /* SanDisk Ultra Fit and Ultra Flair */
346 { USB_DEVICE(0x0781, 0x5583), .driver_info = USB_QUIRK_NO_LPM },
347 { USB_DEVICE(0x0781, 0x5591), .driver_info = USB_QUIRK_NO_LPM },
349 /* M-Systems Flash Disk Pioneers */
350 { USB_DEVICE(0x08ec, 0x1000), .driver_info = USB_QUIRK_RESET_RESUME },
352 /* Baum Vario Ultra */
353 { USB_DEVICE(0x0904, 0x6101), .driver_info =
354 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
355 { USB_DEVICE(0x0904, 0x6102), .driver_info =
356 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
357 { USB_DEVICE(0x0904, 0x6103), .driver_info =
358 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL },
360 /* Sound Devices USBPre2 */
361 { USB_DEVICE(0x0926, 0x0202), .driver_info =
362 USB_QUIRK_ENDPOINT_BLACKLIST },
364 /* Keytouch QWERTY Panel keyboard */
365 { USB_DEVICE(0x0926, 0x3333), .driver_info =
366 USB_QUIRK_CONFIG_INTF_STRINGS },
368 /* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
369 { USB_DEVICE(0x0971, 0x2000), .driver_info = USB_QUIRK_NO_SET_INTF },
371 /* Broadcom BCM92035DGROM BT dongle */
372 { USB_DEVICE(0x0a5c, 0x2021), .driver_info = USB_QUIRK_RESET_RESUME },
374 /* MAYA44USB sound device */
375 { USB_DEVICE(0x0a92, 0x0091), .driver_info = USB_QUIRK_RESET_RESUME },
377 /* ASUS Base Station(T100) */
378 { USB_DEVICE(0x0b05, 0x17e0), .driver_info =
379 USB_QUIRK_IGNORE_REMOTE_WAKEUP },
381 /* Realtek hub in Dell WD19 (Type-C) */
382 { USB_DEVICE(0x0bda, 0x0487), .driver_info = USB_QUIRK_NO_LPM },
384 /* Generic RTL8153 based ethernet adapters */
385 { USB_DEVICE(0x0bda, 0x8153), .driver_info = USB_QUIRK_NO_LPM },
387 /* Action Semiconductor flash disk */
388 { USB_DEVICE(0x10d6, 0x2200), .driver_info =
389 USB_QUIRK_STRING_FETCH_255 },
391 /* Huawei 4G LTE module */
392 { USB_DEVICE(0x12d1, 0x15bb), .driver_info =
393 USB_QUIRK_DISCONNECT_SUSPEND },
394 { USB_DEVICE(0x12d1, 0x15c3), .driver_info =
395 USB_QUIRK_DISCONNECT_SUSPEND },
397 /* SKYMEDI USB_DRIVE */
398 { USB_DEVICE(0x1516, 0x8628), .driver_info = USB_QUIRK_RESET_RESUME },
400 /* Razer - Razer Blade Keyboard */
401 { USB_DEVICE(0x1532, 0x0116), .driver_info =
402 USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
404 /* BUILDWIN Photo Frame */
405 { USB_DEVICE(0x1908, 0x1315), .driver_info =
406 USB_QUIRK_HONOR_BNUMINTERFACES },
408 /* Protocol and OTG Electrical Test Device */
409 { USB_DEVICE(0x1a0a, 0x0200), .driver_info =
410 USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL },
412 /* Terminus Technology Inc. Hub */
413 { USB_DEVICE(0x1a40, 0x0101), .driver_info = USB_QUIRK_HUB_SLOW_RESET },
415 /* Corsair K70 RGB */
416 { USB_DEVICE(0x1b1c, 0x1b13), .driver_info = USB_QUIRK_DELAY_INIT |
417 USB_QUIRK_DELAY_CTRL_MSG },
420 { USB_DEVICE(0x1b1c, 0x1b15), .driver_info = USB_QUIRK_DELAY_INIT |
421 USB_QUIRK_DELAY_CTRL_MSG },
423 /* Corsair Strafe RGB */
424 { USB_DEVICE(0x1b1c, 0x1b20), .driver_info = USB_QUIRK_DELAY_INIT |
425 USB_QUIRK_DELAY_CTRL_MSG },
427 /* Corsair K70 LUX RGB */
428 { USB_DEVICE(0x1b1c, 0x1b33), .driver_info = USB_QUIRK_DELAY_INIT },
430 /* Corsair K70 LUX */
431 { USB_DEVICE(0x1b1c, 0x1b36), .driver_info = USB_QUIRK_DELAY_INIT },
433 /* Corsair K70 RGB RAPDIFIRE */
434 { USB_DEVICE(0x1b1c, 0x1b38), .driver_info = USB_QUIRK_DELAY_INIT |
435 USB_QUIRK_DELAY_CTRL_MSG },
437 /* MIDI keyboard WORLDE MINI */
438 { USB_DEVICE(0x1c75, 0x0204), .driver_info =
439 USB_QUIRK_CONFIG_INTF_STRINGS },
441 /* Acer C120 LED Projector */
442 { USB_DEVICE(0x1de1, 0xc102), .driver_info = USB_QUIRK_NO_LPM },
444 /* Blackmagic Design Intensity Shuttle */
445 { USB_DEVICE(0x1edb, 0xbd3b), .driver_info = USB_QUIRK_NO_LPM },
447 /* Blackmagic Design UltraStudio SDI */
448 { USB_DEVICE(0x1edb, 0xbd4f), .driver_info = USB_QUIRK_NO_LPM },
450 /* Hauppauge HVR-950q */
451 { USB_DEVICE(0x2040, 0x7200), .driver_info =
452 USB_QUIRK_CONFIG_INTF_STRINGS },
454 /* Raydium Touchscreen */
455 { USB_DEVICE(0x2386, 0x3114), .driver_info = USB_QUIRK_NO_LPM },
457 { USB_DEVICE(0x2386, 0x3119), .driver_info = USB_QUIRK_NO_LPM },
460 { USB_DEVICE(0x2ca3, 0x0031), .driver_info = USB_QUIRK_NO_LPM },
462 /* INTEL VALUE SSD */
463 { USB_DEVICE(0x8086, 0xf1a5), .driver_info = USB_QUIRK_RESET_RESUME },
465 /* novation SoundControl XL */
466 { USB_DEVICE(0x1235, 0x0061), .driver_info = USB_QUIRK_RESET_RESUME },
468 { } /* terminating entry must be last */
471 static const struct usb_device_id usb_interface_quirk_list[] = {
472 /* Logitech UVC Cameras */
473 { USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO, 1, 0),
474 .driver_info = USB_QUIRK_RESET_RESUME },
476 { } /* terminating entry must be last */
479 static const struct usb_device_id usb_amd_resume_quirk_list[] = {
480 /* Lenovo Mouse with Pixart controller */
481 { USB_DEVICE(0x17ef, 0x602e), .driver_info = USB_QUIRK_RESET_RESUME },
484 { USB_DEVICE(0x093a, 0x2500), .driver_info = USB_QUIRK_RESET_RESUME },
485 { USB_DEVICE(0x093a, 0x2510), .driver_info = USB_QUIRK_RESET_RESUME },
486 { USB_DEVICE(0x093a, 0x2521), .driver_info = USB_QUIRK_RESET_RESUME },
487 { USB_DEVICE(0x03f0, 0x2b4a), .driver_info = USB_QUIRK_RESET_RESUME },
489 /* Logitech Optical Mouse M90/M100 */
490 { USB_DEVICE(0x046d, 0xc05a), .driver_info = USB_QUIRK_RESET_RESUME },
492 { } /* terminating entry must be last */
496 * Entries for blacklisted endpoints that should be ignored when parsing
497 * configuration descriptors.
499 * Matched for devices with USB_QUIRK_ENDPOINT_BLACKLIST.
501 static const struct usb_device_id usb_endpoint_blacklist[] = {
502 { USB_DEVICE_INTERFACE_NUMBER(0x0926, 0x0202, 1), .driver_info = 0x85 },
506 bool usb_endpoint_is_blacklisted(struct usb_device *udev,
507 struct usb_host_interface *intf,
508 struct usb_endpoint_descriptor *epd)
510 const struct usb_device_id *id;
511 unsigned int address;
513 for (id = usb_endpoint_blacklist; id->match_flags; ++id) {
514 if (!usb_match_device(udev, id))
517 if (!usb_match_one_id_intf(udev, intf, id))
520 address = id->driver_info;
521 if (address == epd->bEndpointAddress)
528 static bool usb_match_any_interface(struct usb_device *udev,
529 const struct usb_device_id *id)
533 for (i = 0; i < udev->descriptor.bNumConfigurations; ++i) {
534 struct usb_host_config *cfg = &udev->config[i];
537 for (j = 0; j < cfg->desc.bNumInterfaces; ++j) {
538 struct usb_interface_cache *cache;
539 struct usb_host_interface *intf;
541 cache = cfg->intf_cache[j];
542 if (cache->num_altsetting == 0)
545 intf = &cache->altsetting[0];
546 if (usb_match_one_id_intf(udev, intf, id))
554 static int usb_amd_resume_quirk(struct usb_device *udev)
558 hcd = bus_to_hcd(udev->bus);
559 /* The device should be attached directly to root hub */
560 if (udev->level == 1 && hcd->amd_resume_bug == 1)
566 static u32 usb_detect_static_quirks(struct usb_device *udev,
567 const struct usb_device_id *id)
571 for (; id->match_flags; id++) {
572 if (!usb_match_device(udev, id))
575 if ((id->match_flags & USB_DEVICE_ID_MATCH_INT_INFO) &&
576 !usb_match_any_interface(udev, id))
579 quirks |= (u32)(id->driver_info);
585 static u32 usb_detect_dynamic_quirks(struct usb_device *udev)
587 u16 vid = le16_to_cpu(udev->descriptor.idVendor);
588 u16 pid = le16_to_cpu(udev->descriptor.idProduct);
591 mutex_lock(&quirk_mutex);
593 for (i = 0; i < quirk_count; i++) {
594 if (vid == quirk_list[i].vid && pid == quirk_list[i].pid) {
595 flags = quirk_list[i].flags;
600 mutex_unlock(&quirk_mutex);
606 * Detect any quirks the device has, and do any housekeeping for it if needed.
608 void usb_detect_quirks(struct usb_device *udev)
610 udev->quirks = usb_detect_static_quirks(udev, usb_quirk_list);
613 * Pixart-based mice would trigger remote wakeup issue on AMD
614 * Yangtze chipset, so set them as RESET_RESUME flag.
616 if (usb_amd_resume_quirk(udev))
617 udev->quirks |= usb_detect_static_quirks(udev,
618 usb_amd_resume_quirk_list);
620 udev->quirks ^= usb_detect_dynamic_quirks(udev);
623 dev_dbg(&udev->dev, "USB quirks for this device: %x\n",
626 #ifdef CONFIG_USB_DEFAULT_PERSIST
627 if (!(udev->quirks & USB_QUIRK_RESET))
628 udev->persist_enabled = 1;
630 /* Hubs are automatically enabled for USB-PERSIST */
631 if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
632 udev->persist_enabled = 1;
633 #endif /* CONFIG_USB_DEFAULT_PERSIST */
636 void usb_detect_interface_quirks(struct usb_device *udev)
640 quirks = usb_detect_static_quirks(udev, usb_interface_quirk_list);
644 dev_dbg(&udev->dev, "USB interface quirks for this device: %x\n",
646 udev->quirks |= quirks;
649 void usb_release_quirk_list(void)
651 mutex_lock(&quirk_mutex);
654 mutex_unlock(&quirk_mutex);