1 // SPDX-License-Identifier: GPL-2.0
3 * USB device quirk handling logic and table
5 * Copyright (c) 2007 Oliver Neukum
6 * Copyright (c) 2007 Greg Kroah-Hartman <gregkh@suse.de>
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 Quickcam Fusion */
235 { USB_DEVICE(0x046d, 0x08c1), .driver_info
= USB_QUIRK_RESET_RESUME
},
237 /* Logitech Quickcam Orbit MP */
238 { USB_DEVICE(0x046d, 0x08c2), .driver_info
= USB_QUIRK_RESET_RESUME
},
240 /* Logitech Quickcam Pro for Notebook */
241 { USB_DEVICE(0x046d, 0x08c3), .driver_info
= USB_QUIRK_RESET_RESUME
},
243 /* Logitech Quickcam Pro 5000 */
244 { USB_DEVICE(0x046d, 0x08c5), .driver_info
= USB_QUIRK_RESET_RESUME
},
246 /* Logitech Quickcam OEM Dell Notebook */
247 { USB_DEVICE(0x046d, 0x08c6), .driver_info
= USB_QUIRK_RESET_RESUME
},
249 /* Logitech Quickcam OEM Cisco VT Camera II */
250 { USB_DEVICE(0x046d, 0x08c7), .driver_info
= USB_QUIRK_RESET_RESUME
},
252 /* Logitech Harmony 700-series */
253 { USB_DEVICE(0x046d, 0xc122), .driver_info
= USB_QUIRK_DELAY_INIT
},
255 /* Philips PSC805 audio device */
256 { USB_DEVICE(0x0471, 0x0155), .driver_info
= USB_QUIRK_RESET_RESUME
},
258 /* Plantronic Audio 655 DSP */
259 { USB_DEVICE(0x047f, 0xc008), .driver_info
= USB_QUIRK_RESET_RESUME
},
261 /* Plantronic Audio 648 USB */
262 { USB_DEVICE(0x047f, 0xc013), .driver_info
= USB_QUIRK_RESET_RESUME
},
264 /* Artisman Watchdog Dongle */
265 { USB_DEVICE(0x04b4, 0x0526), .driver_info
=
266 USB_QUIRK_CONFIG_INTF_STRINGS
},
268 /* Microchip Joss Optical infrared touchboard device */
269 { USB_DEVICE(0x04d8, 0x000c), .driver_info
=
270 USB_QUIRK_CONFIG_INTF_STRINGS
},
272 /* CarrolTouch 4000U */
273 { USB_DEVICE(0x04e7, 0x0009), .driver_info
= USB_QUIRK_RESET_RESUME
},
275 /* CarrolTouch 4500U */
276 { USB_DEVICE(0x04e7, 0x0030), .driver_info
= USB_QUIRK_RESET_RESUME
},
278 /* Samsung Android phone modem - ID conflict with SPH-I500 */
279 { USB_DEVICE(0x04e8, 0x6601), .driver_info
=
280 USB_QUIRK_CONFIG_INTF_STRINGS
},
282 /* Elan Touchscreen */
283 { USB_DEVICE(0x04f3, 0x0089), .driver_info
=
284 USB_QUIRK_DEVICE_QUALIFIER
},
286 { USB_DEVICE(0x04f3, 0x009b), .driver_info
=
287 USB_QUIRK_DEVICE_QUALIFIER
},
289 { USB_DEVICE(0x04f3, 0x010c), .driver_info
=
290 USB_QUIRK_DEVICE_QUALIFIER
},
292 { USB_DEVICE(0x04f3, 0x0125), .driver_info
=
293 USB_QUIRK_DEVICE_QUALIFIER
},
295 { USB_DEVICE(0x04f3, 0x016f), .driver_info
=
296 USB_QUIRK_DEVICE_QUALIFIER
},
298 { USB_DEVICE(0x04f3, 0x0381), .driver_info
=
301 { USB_DEVICE(0x04f3, 0x21b8), .driver_info
=
302 USB_QUIRK_DEVICE_QUALIFIER
},
305 { USB_DEVICE(0x0582, 0x0007), .driver_info
= USB_QUIRK_RESET_RESUME
},
308 { USB_DEVICE(0x0582, 0x0027), .driver_info
= USB_QUIRK_RESET_RESUME
},
310 /* Alcor Micro Corp. Hub */
311 { USB_DEVICE(0x058f, 0x9254), .driver_info
= USB_QUIRK_RESET_RESUME
},
314 { USB_DEVICE(0x05ac, 0x021a), .driver_info
= USB_QUIRK_RESET_RESUME
},
316 /* Genesys Logic hub, internally used by KY-688 USB 3.1 Type-C Hub */
317 { USB_DEVICE(0x05e3, 0x0612), .driver_info
= USB_QUIRK_NO_LPM
},
319 /* ELSA MicroLink 56K */
320 { USB_DEVICE(0x05cc, 0x2267), .driver_info
= USB_QUIRK_RESET_RESUME
},
322 /* Genesys Logic hub, internally used by Moshi USB to Ethernet Adapter */
323 { USB_DEVICE(0x05e3, 0x0616), .driver_info
= USB_QUIRK_NO_LPM
},
326 { USB_DEVICE(0x0638, 0x0a13), .driver_info
=
327 USB_QUIRK_STRING_FETCH_255
},
329 /* Saitek Cyborg Gold Joystick */
330 { USB_DEVICE(0x06a3, 0x0006), .driver_info
=
331 USB_QUIRK_CONFIG_INTF_STRINGS
},
333 /* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
334 { USB_DEVICE(0x06f8, 0x0804), .driver_info
= USB_QUIRK_RESET_RESUME
},
336 /* Guillemot Webcam Hercules Dualpix Exchange*/
337 { USB_DEVICE(0x06f8, 0x3005), .driver_info
= USB_QUIRK_RESET_RESUME
},
339 /* Midiman M-Audio Keystation 88es */
340 { USB_DEVICE(0x0763, 0x0192), .driver_info
= USB_QUIRK_RESET_RESUME
},
342 /* SanDisk Ultra Fit and Ultra Flair */
343 { USB_DEVICE(0x0781, 0x5583), .driver_info
= USB_QUIRK_NO_LPM
},
344 { USB_DEVICE(0x0781, 0x5591), .driver_info
= USB_QUIRK_NO_LPM
},
346 /* M-Systems Flash Disk Pioneers */
347 { USB_DEVICE(0x08ec, 0x1000), .driver_info
= USB_QUIRK_RESET_RESUME
},
349 /* Baum Vario Ultra */
350 { USB_DEVICE(0x0904, 0x6101), .driver_info
=
351 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL
},
352 { USB_DEVICE(0x0904, 0x6102), .driver_info
=
353 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL
},
354 { USB_DEVICE(0x0904, 0x6103), .driver_info
=
355 USB_QUIRK_LINEAR_FRAME_INTR_BINTERVAL
},
357 /* Keytouch QWERTY Panel keyboard */
358 { USB_DEVICE(0x0926, 0x3333), .driver_info
=
359 USB_QUIRK_CONFIG_INTF_STRINGS
},
361 /* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
362 { USB_DEVICE(0x0971, 0x2000), .driver_info
= USB_QUIRK_NO_SET_INTF
},
364 /* Broadcom BCM92035DGROM BT dongle */
365 { USB_DEVICE(0x0a5c, 0x2021), .driver_info
= USB_QUIRK_RESET_RESUME
},
367 /* MAYA44USB sound device */
368 { USB_DEVICE(0x0a92, 0x0091), .driver_info
= USB_QUIRK_RESET_RESUME
},
370 /* ASUS Base Station(T100) */
371 { USB_DEVICE(0x0b05, 0x17e0), .driver_info
=
372 USB_QUIRK_IGNORE_REMOTE_WAKEUP
},
374 /* Action Semiconductor flash disk */
375 { USB_DEVICE(0x10d6, 0x2200), .driver_info
=
376 USB_QUIRK_STRING_FETCH_255
},
378 /* Huawei 4G LTE module */
379 { USB_DEVICE(0x12d1, 0x15bb), .driver_info
=
380 USB_QUIRK_DISCONNECT_SUSPEND
},
381 { USB_DEVICE(0x12d1, 0x15c3), .driver_info
=
382 USB_QUIRK_DISCONNECT_SUSPEND
},
384 /* SKYMEDI USB_DRIVE */
385 { USB_DEVICE(0x1516, 0x8628), .driver_info
= USB_QUIRK_RESET_RESUME
},
387 /* Razer - Razer Blade Keyboard */
388 { USB_DEVICE(0x1532, 0x0116), .driver_info
=
389 USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL
},
391 /* BUILDWIN Photo Frame */
392 { USB_DEVICE(0x1908, 0x1315), .driver_info
=
393 USB_QUIRK_HONOR_BNUMINTERFACES
},
395 /* Protocol and OTG Electrical Test Device */
396 { USB_DEVICE(0x1a0a, 0x0200), .driver_info
=
397 USB_QUIRK_LINEAR_UFRAME_INTR_BINTERVAL
},
399 /* Terminus Technology Inc. Hub */
400 { USB_DEVICE(0x1a40, 0x0101), .driver_info
= USB_QUIRK_HUB_SLOW_RESET
},
402 /* Corsair K70 RGB */
403 { USB_DEVICE(0x1b1c, 0x1b13), .driver_info
= USB_QUIRK_DELAY_INIT
|
404 USB_QUIRK_DELAY_CTRL_MSG
},
407 { USB_DEVICE(0x1b1c, 0x1b15), .driver_info
= USB_QUIRK_DELAY_INIT
|
408 USB_QUIRK_DELAY_CTRL_MSG
},
410 /* Corsair Strafe RGB */
411 { USB_DEVICE(0x1b1c, 0x1b20), .driver_info
= USB_QUIRK_DELAY_INIT
|
412 USB_QUIRK_DELAY_CTRL_MSG
},
414 /* Corsair K70 LUX RGB */
415 { USB_DEVICE(0x1b1c, 0x1b33), .driver_info
= USB_QUIRK_DELAY_INIT
},
417 /* Corsair K70 LUX */
418 { USB_DEVICE(0x1b1c, 0x1b36), .driver_info
= USB_QUIRK_DELAY_INIT
},
420 /* MIDI keyboard WORLDE MINI */
421 { USB_DEVICE(0x1c75, 0x0204), .driver_info
=
422 USB_QUIRK_CONFIG_INTF_STRINGS
},
424 /* Acer C120 LED Projector */
425 { USB_DEVICE(0x1de1, 0xc102), .driver_info
= USB_QUIRK_NO_LPM
},
427 /* Blackmagic Design Intensity Shuttle */
428 { USB_DEVICE(0x1edb, 0xbd3b), .driver_info
= USB_QUIRK_NO_LPM
},
430 /* Blackmagic Design UltraStudio SDI */
431 { USB_DEVICE(0x1edb, 0xbd4f), .driver_info
= USB_QUIRK_NO_LPM
},
433 /* Hauppauge HVR-950q */
434 { USB_DEVICE(0x2040, 0x7200), .driver_info
=
435 USB_QUIRK_CONFIG_INTF_STRINGS
},
437 /* Raydium Touchscreen */
438 { USB_DEVICE(0x2386, 0x3114), .driver_info
= USB_QUIRK_NO_LPM
},
440 { USB_DEVICE(0x2386, 0x3119), .driver_info
= USB_QUIRK_NO_LPM
},
443 { USB_DEVICE(0x2ca3, 0x0031), .driver_info
= USB_QUIRK_NO_LPM
},
445 /* INTEL VALUE SSD */
446 { USB_DEVICE(0x8086, 0xf1a5), .driver_info
= USB_QUIRK_RESET_RESUME
},
448 { } /* terminating entry must be last */
451 static const struct usb_device_id usb_interface_quirk_list
[] = {
452 /* Logitech UVC Cameras */
453 { USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO
, 1, 0),
454 .driver_info
= USB_QUIRK_RESET_RESUME
},
456 { } /* terminating entry must be last */
459 static const struct usb_device_id usb_amd_resume_quirk_list
[] = {
460 /* Lenovo Mouse with Pixart controller */
461 { USB_DEVICE(0x17ef, 0x602e), .driver_info
= USB_QUIRK_RESET_RESUME
},
464 { USB_DEVICE(0x093a, 0x2500), .driver_info
= USB_QUIRK_RESET_RESUME
},
465 { USB_DEVICE(0x093a, 0x2510), .driver_info
= USB_QUIRK_RESET_RESUME
},
466 { USB_DEVICE(0x093a, 0x2521), .driver_info
= USB_QUIRK_RESET_RESUME
},
467 { USB_DEVICE(0x03f0, 0x2b4a), .driver_info
= USB_QUIRK_RESET_RESUME
},
469 /* Logitech Optical Mouse M90/M100 */
470 { USB_DEVICE(0x046d, 0xc05a), .driver_info
= USB_QUIRK_RESET_RESUME
},
472 { } /* terminating entry must be last */
475 static bool usb_match_any_interface(struct usb_device
*udev
,
476 const struct usb_device_id
*id
)
480 for (i
= 0; i
< udev
->descriptor
.bNumConfigurations
; ++i
) {
481 struct usb_host_config
*cfg
= &udev
->config
[i
];
484 for (j
= 0; j
< cfg
->desc
.bNumInterfaces
; ++j
) {
485 struct usb_interface_cache
*cache
;
486 struct usb_host_interface
*intf
;
488 cache
= cfg
->intf_cache
[j
];
489 if (cache
->num_altsetting
== 0)
492 intf
= &cache
->altsetting
[0];
493 if (usb_match_one_id_intf(udev
, intf
, id
))
501 static int usb_amd_resume_quirk(struct usb_device
*udev
)
505 hcd
= bus_to_hcd(udev
->bus
);
506 /* The device should be attached directly to root hub */
507 if (udev
->level
== 1 && hcd
->amd_resume_bug
== 1)
513 static u32
usb_detect_static_quirks(struct usb_device
*udev
,
514 const struct usb_device_id
*id
)
518 for (; id
->match_flags
; id
++) {
519 if (!usb_match_device(udev
, id
))
522 if ((id
->match_flags
& USB_DEVICE_ID_MATCH_INT_INFO
) &&
523 !usb_match_any_interface(udev
, id
))
526 quirks
|= (u32
)(id
->driver_info
);
532 static u32
usb_detect_dynamic_quirks(struct usb_device
*udev
)
534 u16 vid
= le16_to_cpu(udev
->descriptor
.idVendor
);
535 u16 pid
= le16_to_cpu(udev
->descriptor
.idProduct
);
538 mutex_lock(&quirk_mutex
);
540 for (i
= 0; i
< quirk_count
; i
++) {
541 if (vid
== quirk_list
[i
].vid
&& pid
== quirk_list
[i
].pid
) {
542 flags
= quirk_list
[i
].flags
;
547 mutex_unlock(&quirk_mutex
);
553 * Detect any quirks the device has, and do any housekeeping for it if needed.
555 void usb_detect_quirks(struct usb_device
*udev
)
557 udev
->quirks
= usb_detect_static_quirks(udev
, usb_quirk_list
);
560 * Pixart-based mice would trigger remote wakeup issue on AMD
561 * Yangtze chipset, so set them as RESET_RESUME flag.
563 if (usb_amd_resume_quirk(udev
))
564 udev
->quirks
|= usb_detect_static_quirks(udev
,
565 usb_amd_resume_quirk_list
);
567 udev
->quirks
^= usb_detect_dynamic_quirks(udev
);
570 dev_dbg(&udev
->dev
, "USB quirks for this device: %x\n",
573 #ifdef CONFIG_USB_DEFAULT_PERSIST
574 if (!(udev
->quirks
& USB_QUIRK_RESET
))
575 udev
->persist_enabled
= 1;
577 /* Hubs are automatically enabled for USB-PERSIST */
578 if (udev
->descriptor
.bDeviceClass
== USB_CLASS_HUB
)
579 udev
->persist_enabled
= 1;
580 #endif /* CONFIG_USB_DEFAULT_PERSIST */
583 void usb_detect_interface_quirks(struct usb_device
*udev
)
587 quirks
= usb_detect_static_quirks(udev
, usb_interface_quirk_list
);
591 dev_dbg(&udev
->dev
, "USB interface quirks for this device: %x\n",
593 udev
->quirks
|= quirks
;
596 void usb_release_quirk_list(void)
598 mutex_lock(&quirk_mutex
);
601 mutex_unlock(&quirk_mutex
);