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