drivers/usb/core/quirks.c

   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 "usb.h"
  17
  18 /* Lists of quirky USB devices, split in device quirks and interface quirks.
  19  * Device quirks are applied at the very beginning of the enumeration process,
  20  * right after reading the device descriptor. They can thus only match on device
  21  * information.
  22  *
  23  * Interface quirks are applied after reading all the configuration descriptors.
  24  * They can match on both device and interface information.
  25  *
  26  * Note that the DELAY_INIT and HONOR_BNUMINTERFACES quirks do not make sense as
  27  * interface quirks, as they only influence the enumeration process which is run
  28  * before processing the interface quirks.
  29  *
  30  * Please keep the lists ordered by:
  31  *      1) Vendor ID
  32  *      2) Product ID
  33  *      3) Class ID
  34  */
  35 static const struct usb_device_id usb_quirk_list[] = {
  36         /* CBM - Flash disk */
  37         { USB_DEVICE(0x0204, 0x6025), .driver_info = USB_QUIRK_RESET_RESUME },
  38
  39         /* HP 5300/5370C scanner */
  40         { USB_DEVICE(0x03f0, 0x0701), .driver_info =
  41                         USB_QUIRK_STRING_FETCH_255 },
  42
  43         /* Creative SB Audigy 2 NX */
  44         { USB_DEVICE(0x041e, 0x3020), .driver_info = USB_QUIRK_RESET_RESUME },
  45
  46         /* Microsoft LifeCam-VX700 v2.0 */
  47         { USB_DEVICE(0x045e, 0x0770), .driver_info = USB_QUIRK_RESET_RESUME },
  48
  49         /* Logitech Quickcam Fusion */
  50         { USB_DEVICE(0x046d, 0x08c1), .driver_info = USB_QUIRK_RESET_RESUME },
  51
  52         /* Logitech Quickcam Orbit MP */
  53         { USB_DEVICE(0x046d, 0x08c2), .driver_info = USB_QUIRK_RESET_RESUME },
  54
  55         /* Logitech Quickcam Pro for Notebook */
  56         { USB_DEVICE(0x046d, 0x08c3), .driver_info = USB_QUIRK_RESET_RESUME },
  57
  58         /* Logitech Quickcam Pro 5000 */
  59         { USB_DEVICE(0x046d, 0x08c5), .driver_info = USB_QUIRK_RESET_RESUME },
  60
  61         /* Logitech Quickcam OEM Dell Notebook */
  62         { USB_DEVICE(0x046d, 0x08c6), .driver_info = USB_QUIRK_RESET_RESUME },
  63
  64         /* Logitech Quickcam OEM Cisco VT Camera II */
  65         { USB_DEVICE(0x046d, 0x08c7), .driver_info = USB_QUIRK_RESET_RESUME },
  66
  67         /* Logitech Harmony 700-series */
  68         { USB_DEVICE(0x046d, 0xc122), .driver_info = USB_QUIRK_DELAY_INIT },
  69
  70         /* Philips PSC805 audio device */
  71         { USB_DEVICE(0x0471, 0x0155), .driver_info = USB_QUIRK_RESET_RESUME },
  72
  73         /* Artisman Watchdog Dongle */
  74         { USB_DEVICE(0x04b4, 0x0526), .driver_info =
  75                         USB_QUIRK_CONFIG_INTF_STRINGS },
  76
  77         /* Microchip Joss Optical infrared touchboard device */
  78         { USB_DEVICE(0x04d8, 0x000c), .driver_info =
  79                         USB_QUIRK_CONFIG_INTF_STRINGS },
  80
  81         /* CarrolTouch 4000U */
  82         { USB_DEVICE(0x04e7, 0x0009), .driver_info = USB_QUIRK_RESET_RESUME },
  83
  84         /* CarrolTouch 4500U */
  85         { USB_DEVICE(0x04e7, 0x0030), .driver_info = USB_QUIRK_RESET_RESUME },
  86
  87         /* Samsung Android phone modem - ID conflict with SPH-I500 */
  88         { USB_DEVICE(0x04e8, 0x6601), .driver_info =
  89                         USB_QUIRK_CONFIG_INTF_STRINGS },
  90
  91         /* Roland SC-8820 */
  92         { USB_DEVICE(0x0582, 0x0007), .driver_info = USB_QUIRK_RESET_RESUME },
  93
  94         /* Edirol SD-20 */
  95         { USB_DEVICE(0x0582, 0x0027), .driver_info = USB_QUIRK_RESET_RESUME },
  96
  97         /* Alcor Micro Corp. Hub */
  98         { USB_DEVICE(0x058f, 0x9254), .driver_info = USB_QUIRK_RESET_RESUME },
  99
 100         /* MicroTouch Systems touchscreen */
 101         { USB_DEVICE(0x0596, 0x051e), .driver_info = USB_QUIRK_RESET_RESUME },
 102
 103         /* appletouch */
 104         { USB_DEVICE(0x05ac, 0x021a), .driver_info = USB_QUIRK_RESET_RESUME },
 105
 106         /* Avision AV600U */
 107         { USB_DEVICE(0x0638, 0x0a13), .driver_info =
 108           USB_QUIRK_STRING_FETCH_255 },
 109
 110         /* Saitek Cyborg Gold Joystick */
 111         { USB_DEVICE(0x06a3, 0x0006), .driver_info =
 112                         USB_QUIRK_CONFIG_INTF_STRINGS },
 113
 114         /* Guillemot Webcam Hercules Dualpix Exchange (2nd ID) */
 115         { USB_DEVICE(0x06f8, 0x0804), .driver_info = USB_QUIRK_RESET_RESUME },
 116
 117         /* Guillemot Webcam Hercules Dualpix Exchange*/
 118         { USB_DEVICE(0x06f8, 0x3005), .driver_info = USB_QUIRK_RESET_RESUME },
 119
 120         /* Midiman M-Audio Keystation 88es */
 121         { USB_DEVICE(0x0763, 0x0192), .driver_info = USB_QUIRK_RESET_RESUME },
 122
 123         /* M-Systems Flash Disk Pioneers */
 124         { USB_DEVICE(0x08ec, 0x1000), .driver_info = USB_QUIRK_RESET_RESUME },
 125
 126         /* Keytouch QWERTY Panel keyboard */
 127         { USB_DEVICE(0x0926, 0x3333), .driver_info =
 128                         USB_QUIRK_CONFIG_INTF_STRINGS },
 129
 130         /* X-Rite/Gretag-Macbeth Eye-One Pro display colorimeter */
 131         { USB_DEVICE(0x0971, 0x2000), .driver_info = USB_QUIRK_NO_SET_INTF },
 132
 133         /* Broadcom BCM92035DGROM BT dongle */
 134         { USB_DEVICE(0x0a5c, 0x2021), .driver_info = USB_QUIRK_RESET_RESUME },
 135
 136         /* MAYA44USB sound device */
 137         { USB_DEVICE(0x0a92, 0x0091), .driver_info = USB_QUIRK_RESET_RESUME },
 138
 139         /* Action Semiconductor flash disk */
 140         { USB_DEVICE(0x10d6, 0x2200), .driver_info =
 141                         USB_QUIRK_STRING_FETCH_255 },
 142
 143         /* SKYMEDI USB_DRIVE */
 144         { USB_DEVICE(0x1516, 0x8628), .driver_info = USB_QUIRK_RESET_RESUME },
 145
 146         /* BUILDWIN Photo Frame */
 147         { USB_DEVICE(0x1908, 0x1315), .driver_info =
 148                         USB_QUIRK_HONOR_BNUMINTERFACES },
 149
 150         /* INTEL VALUE SSD */
 151         { USB_DEVICE(0x8086, 0xf1a5), .driver_info = USB_QUIRK_RESET_RESUME },
 152
 153         { }  /* terminating entry must be last */
 154 };
 155
 156 static const struct usb_device_id usb_interface_quirk_list[] = {
 157         /* Logitech UVC Cameras */
 158         { USB_VENDOR_AND_INTERFACE_INFO(0x046d, USB_CLASS_VIDEO, 1, 0),
 159           .driver_info = USB_QUIRK_RESET_RESUME },
 160
 161         { }  /* terminating entry must be last */
 162 };
 163
 164 static bool usb_match_any_interface(struct usb_device *udev,
 165                                     const struct usb_device_id *id)
 166 {
 167         unsigned int i;
 168
 169         for (i = 0; i < udev->descriptor.bNumConfigurations; ++i) {
 170                 struct usb_host_config *cfg = &udev->config[i];
 171                 unsigned int j;
 172
 173                 for (j = 0; j < cfg->desc.bNumInterfaces; ++j) {
 174                         struct usb_interface_cache *cache;
 175                         struct usb_host_interface *intf;
 176
 177                         cache = cfg->intf_cache[j];
 178                         if (cache->num_altsetting == 0)
 179                                 continue;
 180
 181                         intf = &cache->altsetting[0];
 182                         if (usb_match_one_id_intf(udev, intf, id))
 183                                 return true;
 184                 }
 185         }
 186
 187         return false;
 188 }
 189
 190 static u32 __usb_detect_quirks(struct usb_device *udev,
 191                                const struct usb_device_id *id)
 192 {
 193         u32 quirks = 0;
 194
 195         for (; id->match_flags; id++) {
 196                 if (!usb_match_device(udev, id))
 197                         continue;
 198
 199                 if ((id->match_flags & USB_DEVICE_ID_MATCH_INT_INFO) &&
 200                     !usb_match_any_interface(udev, id))
 201                         continue;
 202
 203                 quirks |= (u32)(id->driver_info);
 204         }
 205
 206         return quirks;
 207 }
 208
 209 /*
 210  * Detect any quirks the device has, and do any housekeeping for it if needed.
 211  */
 212 void usb_detect_quirks(struct usb_device *udev)
 213 {
 214         udev->quirks = __usb_detect_quirks(udev, usb_quirk_list);
 215         if (udev->quirks)
 216                 dev_dbg(&udev->dev, "USB quirks for this device: %x\n",
 217                         udev->quirks);
 218
 219         /* For the present, all devices default to USB-PERSIST enabled */
 220 #if 0           /* was: #ifdef CONFIG_PM */
 221         /* Hubs are automatically enabled for USB-PERSIST */
 222         if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
 223                 udev->persist_enabled = 1;
 224
 225 #else
 226         /* In the absence of PM, we can safely enable USB-PERSIST
 227          * for all devices.  It will affect things like hub resets
 228          * and EMF-related port disables.
 229          */
 230         if (!(udev->quirks & USB_QUIRK_RESET_MORPHS))
 231                 udev->persist_enabled = 1;
 232 #endif  /* CONFIG_PM */
 233 }
 234
 235 void usb_detect_interface_quirks(struct usb_device *udev)
 236 {
 237         u32 quirks;
 238
 239         quirks = __usb_detect_quirks(udev, usb_interface_quirk_list);
 240         if (quirks == 0)
 241                 return;
 242
 243         dev_dbg(&udev->dev, "USB interface quirks for this device: %x\n",
 244                 quirks);
 245         udev->quirks |= quirks;
 246 }