1aa1f3bb5SGreg Kroah-Hartman // SPDX-License-Identifier: GPL-2.0 236e56a34SAlan Stern /* 336e56a34SAlan Stern * drivers/usb/generic.c - generic driver for USB devices (not interfaces) 436e56a34SAlan Stern * 536e56a34SAlan Stern * (C) Copyright 2005 Greg Kroah-Hartman <gregkh@suse.de> 636e56a34SAlan Stern * 736e56a34SAlan Stern * based on drivers/usb/usb.c which had the following copyrights: 836e56a34SAlan Stern * (C) Copyright Linus Torvalds 1999 936e56a34SAlan Stern * (C) Copyright Johannes Erdfelt 1999-2001 1036e56a34SAlan Stern * (C) Copyright Andreas Gal 1999 1136e56a34SAlan Stern * (C) Copyright Gregory P. Smith 1999 1236e56a34SAlan Stern * (C) Copyright Deti Fliegl 1999 (new USB architecture) 1336e56a34SAlan Stern * (C) Copyright Randy Dunlap 2000 1436e56a34SAlan Stern * (C) Copyright David Brownell 2000-2004 1536e56a34SAlan Stern * (C) Copyright Yggdrasil Computing, Inc. 2000 1636e56a34SAlan Stern * (usb_device_id matching changes by Adam J. Richter) 1736e56a34SAlan Stern * (C) Copyright Greg Kroah-Hartman 2002-2003 1836e56a34SAlan Stern * 19b65fba3dSGreg Kroah-Hartman * Released under the GPLv2 only. 2036e56a34SAlan Stern */ 2136e56a34SAlan Stern 2236e56a34SAlan Stern #include <linux/usb.h> 2327729aadSEric Lescouet #include <linux/usb/hcd.h> 24f13912d3SSaranya Gopal #include <uapi/linux/usb/audio.h> 2536e56a34SAlan Stern #include "usb.h" 2636e56a34SAlan Stern 27782da727SAlan Stern static inline const char *plural(int n) 28782da727SAlan Stern { 29782da727SAlan Stern return (n == 1 ? "" : "s"); 30782da727SAlan Stern } 31782da727SAlan Stern 32ad55d71aSOle Andre Vadla Ravnas static int is_rndis(struct usb_interface_descriptor *desc) 33ad55d71aSOle Andre Vadla Ravnas { 34ad55d71aSOle Andre Vadla Ravnas return desc->bInterfaceClass == USB_CLASS_COMM 35ad55d71aSOle Andre Vadla Ravnas && desc->bInterfaceSubClass == 2 36ad55d71aSOle Andre Vadla Ravnas && desc->bInterfaceProtocol == 0xff; 37ad55d71aSOle Andre Vadla Ravnas } 38ad55d71aSOle Andre Vadla Ravnas 39ad55d71aSOle Andre Vadla Ravnas static int is_activesync(struct usb_interface_descriptor *desc) 40ad55d71aSOle Andre Vadla Ravnas { 41ad55d71aSOle Andre Vadla Ravnas return desc->bInterfaceClass == USB_CLASS_MISC 42ad55d71aSOle Andre Vadla Ravnas && desc->bInterfaceSubClass == 1 43ad55d71aSOle Andre Vadla Ravnas && desc->bInterfaceProtocol == 1; 44ad55d71aSOle Andre Vadla Ravnas } 45ad55d71aSOle Andre Vadla Ravnas 46f13912d3SSaranya Gopal static bool is_audio(struct usb_interface_descriptor *desc) 47f13912d3SSaranya Gopal { 48f13912d3SSaranya Gopal return desc->bInterfaceClass == USB_CLASS_AUDIO; 49f13912d3SSaranya Gopal } 50f13912d3SSaranya Gopal 51f13912d3SSaranya Gopal static bool is_uac3_config(struct usb_interface_descriptor *desc) 52f13912d3SSaranya Gopal { 53f13912d3SSaranya Gopal return desc->bInterfaceProtocol == UAC_VERSION_3; 54f13912d3SSaranya Gopal } 55f13912d3SSaranya Gopal 56b5ea060fSGreg Kroah-Hartman int usb_choose_configuration(struct usb_device *udev) 57782da727SAlan Stern { 58782da727SAlan Stern int i; 59782da727SAlan Stern int num_configs; 60782da727SAlan Stern int insufficient_power = 0; 61782da727SAlan Stern struct usb_host_config *c, *best; 62782da727SAlan Stern 63c13b86a3SHindin Joseph if (usb_device_is_owned(udev)) 64c13b86a3SHindin Joseph return 0; 65c13b86a3SHindin Joseph 66782da727SAlan Stern best = NULL; 67782da727SAlan Stern c = udev->config; 68782da727SAlan Stern num_configs = udev->descriptor.bNumConfigurations; 69782da727SAlan Stern for (i = 0; i < num_configs; (i++, c++)) { 70782da727SAlan Stern struct usb_interface_descriptor *desc = NULL; 71782da727SAlan Stern 72782da727SAlan Stern /* It's possible that a config has no interfaces! */ 73782da727SAlan Stern if (c->desc.bNumInterfaces > 0) 74782da727SAlan Stern desc = &c->intf_cache[0]->altsetting->desc; 75782da727SAlan Stern 76782da727SAlan Stern /* 77782da727SAlan Stern * HP's USB bus-powered keyboard has only one configuration 78782da727SAlan Stern * and it claims to be self-powered; other devices may have 79782da727SAlan Stern * similar errors in their descriptors. If the next test 80782da727SAlan Stern * were allowed to execute, such configurations would always 81782da727SAlan Stern * be rejected and the devices would not work as expected. 82782da727SAlan Stern * In the meantime, we run the risk of selecting a config 83782da727SAlan Stern * that requires external power at a time when that power 84782da727SAlan Stern * isn't available. It seems to be the lesser of two evils. 85782da727SAlan Stern * 86782da727SAlan Stern * Bugzilla #6448 reports a device that appears to crash 87782da727SAlan Stern * when it receives a GET_DEVICE_STATUS request! We don't 88782da727SAlan Stern * have any other way to tell whether a device is self-powered, 89782da727SAlan Stern * but since we don't use that information anywhere but here, 90782da727SAlan Stern * the call has been removed. 91782da727SAlan Stern * 92782da727SAlan Stern * Maybe the GET_DEVICE_STATUS call and the test below can 93782da727SAlan Stern * be reinstated when device firmwares become more reliable. 94782da727SAlan Stern * Don't hold your breath. 95782da727SAlan Stern */ 96782da727SAlan Stern #if 0 97782da727SAlan Stern /* Rule out self-powered configs for a bus-powered device */ 98782da727SAlan Stern if (bus_powered && (c->desc.bmAttributes & 99782da727SAlan Stern USB_CONFIG_ATT_SELFPOWER)) 100782da727SAlan Stern continue; 101782da727SAlan Stern #endif 102782da727SAlan Stern 103782da727SAlan Stern /* 104782da727SAlan Stern * The next test may not be as effective as it should be. 105782da727SAlan Stern * Some hubs have errors in their descriptor, claiming 106782da727SAlan Stern * to be self-powered when they are really bus-powered. 107782da727SAlan Stern * We will overestimate the amount of current such hubs 108782da727SAlan Stern * make available for each port. 109782da727SAlan Stern * 110782da727SAlan Stern * This is a fairly benign sort of failure. It won't 111782da727SAlan Stern * cause us to reject configurations that we should have 112782da727SAlan Stern * accepted. 113782da727SAlan Stern */ 114782da727SAlan Stern 115782da727SAlan Stern /* Rule out configs that draw too much bus current */ 1168d8479dbSSebastian Andrzej Siewior if (usb_get_max_power(udev, c) > udev->bus_mA) { 117782da727SAlan Stern insufficient_power++; 118782da727SAlan Stern continue; 119782da727SAlan Stern } 120782da727SAlan Stern 121ad55d71aSOle Andre Vadla Ravnas /* When the first config's first interface is one of Microsoft's 122ad55d71aSOle Andre Vadla Ravnas * pet nonstandard Ethernet-over-USB protocols, ignore it unless 123ad55d71aSOle Andre Vadla Ravnas * this kernel has enabled the necessary host side driver. 124c4e0b508SAlan Stern * But: Don't ignore it if it's the only config. 125ad55d71aSOle Andre Vadla Ravnas */ 126c4e0b508SAlan Stern if (i == 0 && num_configs > 1 && desc && 127c4e0b508SAlan Stern (is_rndis(desc) || is_activesync(desc))) { 128ad55d71aSOle Andre Vadla Ravnas #if !defined(CONFIG_USB_NET_RNDIS_HOST) && !defined(CONFIG_USB_NET_RNDIS_HOST_MODULE) 129782da727SAlan Stern continue; 130782da727SAlan Stern #else 131782da727SAlan Stern best = c; 132782da727SAlan Stern #endif 133782da727SAlan Stern } 134782da727SAlan Stern 135f13912d3SSaranya Gopal /* 136f13912d3SSaranya Gopal * Select first configuration as default for audio so that 137f13912d3SSaranya Gopal * devices that don't comply with UAC3 protocol are supported. 138f13912d3SSaranya Gopal * But, still iterate through other configurations and 139f13912d3SSaranya Gopal * select UAC3 compliant config if present. 140f13912d3SSaranya Gopal */ 141f13912d3SSaranya Gopal if (i == 0 && num_configs > 1 && desc && is_audio(desc)) { 142f13912d3SSaranya Gopal best = c; 143f13912d3SSaranya Gopal continue; 144f13912d3SSaranya Gopal } 145f13912d3SSaranya Gopal 146f13912d3SSaranya Gopal if (i > 0 && desc && is_audio(desc) && is_uac3_config(desc)) { 147f13912d3SSaranya Gopal best = c; 148f13912d3SSaranya Gopal break; 149f13912d3SSaranya Gopal } 150f13912d3SSaranya Gopal 151782da727SAlan Stern /* From the remaining configs, choose the first one whose 152782da727SAlan Stern * first interface is for a non-vendor-specific class. 153782da727SAlan Stern * Reason: Linux is more likely to have a class driver 154782da727SAlan Stern * than a vendor-specific driver. */ 155782da727SAlan Stern else if (udev->descriptor.bDeviceClass != 156782da727SAlan Stern USB_CLASS_VENDOR_SPEC && 15762f9cfa3SAlan Stern (desc && desc->bInterfaceClass != 158782da727SAlan Stern USB_CLASS_VENDOR_SPEC)) { 159782da727SAlan Stern best = c; 160782da727SAlan Stern break; 161782da727SAlan Stern } 162782da727SAlan Stern 163782da727SAlan Stern /* If all the remaining configs are vendor-specific, 164782da727SAlan Stern * choose the first one. */ 165782da727SAlan Stern else if (!best) 166782da727SAlan Stern best = c; 167782da727SAlan Stern } 168782da727SAlan Stern 169782da727SAlan Stern if (insufficient_power > 0) 170782da727SAlan Stern dev_info(&udev->dev, "rejected %d configuration%s " 171782da727SAlan Stern "due to insufficient available bus power\n", 172782da727SAlan Stern insufficient_power, plural(insufficient_power)); 173782da727SAlan Stern 174782da727SAlan Stern if (best) { 175782da727SAlan Stern i = best->desc.bConfigurationValue; 176b1f0a34cSMatthew Wilcox dev_dbg(&udev->dev, 177782da727SAlan Stern "configuration #%d chosen from %d choice%s\n", 178782da727SAlan Stern i, num_configs, plural(num_configs)); 179782da727SAlan Stern } else { 180782da727SAlan Stern i = -1; 181782da727SAlan Stern dev_warn(&udev->dev, 182782da727SAlan Stern "no configuration chosen from %d choice%s\n", 183782da727SAlan Stern num_configs, plural(num_configs)); 184782da727SAlan Stern } 185782da727SAlan Stern return i; 186782da727SAlan Stern } 187b7945b77SValentina Manea EXPORT_SYMBOL_GPL(usb_choose_configuration); 188782da727SAlan Stern 1898bb54ab5SAlan Stern static int generic_probe(struct usb_device *udev) 19036e56a34SAlan Stern { 191782da727SAlan Stern int err, c; 192782da727SAlan Stern 193782da727SAlan Stern /* Choose and set the configuration. This registers the interfaces 194782da727SAlan Stern * with the driver core and lets interface drivers bind to them. 195782da727SAlan Stern */ 196c13b86a3SHindin Joseph if (udev->authorized == 0) 197f8a37464SInaky Perez-Gonzalez dev_err(&udev->dev, "Device is not authorized for usage\n"); 198f8a37464SInaky Perez-Gonzalez else { 199b5ea060fSGreg Kroah-Hartman c = usb_choose_configuration(udev); 200782da727SAlan Stern if (c >= 0) { 201782da727SAlan Stern err = usb_set_configuration(udev, c); 202e9e88fb7SAlan Stern if (err && err != -ENODEV) { 203782da727SAlan Stern dev_err(&udev->dev, "can't set config #%d, error %d\n", 204782da727SAlan Stern c, err); 205782da727SAlan Stern /* This need not be fatal. The user can try to 206782da727SAlan Stern * set other configurations. */ 207782da727SAlan Stern } 208782da727SAlan Stern } 209f8a37464SInaky Perez-Gonzalez } 210782da727SAlan Stern /* USB device state == configured ... usable */ 211782da727SAlan Stern usb_notify_add_device(udev); 212782da727SAlan Stern 21336e56a34SAlan Stern return 0; 21436e56a34SAlan Stern } 215782da727SAlan Stern 2168bb54ab5SAlan Stern static void generic_disconnect(struct usb_device *udev) 21736e56a34SAlan Stern { 218782da727SAlan Stern usb_notify_remove_device(udev); 219782da727SAlan Stern 22036e56a34SAlan Stern /* if this is only an unbind, not a physical disconnect, then 22136e56a34SAlan Stern * unconfigure the device */ 22201d883d4SAlan Stern if (udev->actconfig) 2233f141e2aSAlan Stern usb_set_configuration(udev, -1); 22436e56a34SAlan Stern } 22536e56a34SAlan Stern 226782da727SAlan Stern #ifdef CONFIG_PM 227782da727SAlan Stern 228782da727SAlan Stern static int generic_suspend(struct usb_device *udev, pm_message_t msg) 229782da727SAlan Stern { 230b6f6436dSAlan Stern int rc; 231b6f6436dSAlan Stern 232686314cfSAlan Stern /* Normal USB devices suspend through their upstream port. 233686314cfSAlan Stern * Root hubs don't have upstream ports to suspend, 234686314cfSAlan Stern * so we have to shut down their downstream HC-to-USB 235686314cfSAlan Stern * interfaces manually by doing a bus (or "global") suspend. 236b6f6436dSAlan Stern */ 237686314cfSAlan Stern if (!udev->parent) 23865bfd296SAlan Stern rc = hcd_bus_suspend(udev, msg); 2395ad4f71eSAlan Stern 24064627388SZhengjun Xing /* 24164627388SZhengjun Xing * Non-root USB2 devices don't need to do anything for FREEZE 24264627388SZhengjun Xing * or PRETHAW. USB3 devices don't support global suspend and 24364627388SZhengjun Xing * needs to be selectively suspended. 24464627388SZhengjun Xing */ 24564627388SZhengjun Xing else if ((msg.event == PM_EVENT_FREEZE || msg.event == PM_EVENT_PRETHAW) 24664627388SZhengjun Xing && (udev->speed < USB_SPEED_SUPER)) 2475ad4f71eSAlan Stern rc = 0; 248686314cfSAlan Stern else 24965bfd296SAlan Stern rc = usb_port_suspend(udev, msg); 2505ad4f71eSAlan Stern 251b6f6436dSAlan Stern return rc; 252782da727SAlan Stern } 253782da727SAlan Stern 25465bfd296SAlan Stern static int generic_resume(struct usb_device *udev, pm_message_t msg) 255782da727SAlan Stern { 256b6f6436dSAlan Stern int rc; 257b6f6436dSAlan Stern 258686314cfSAlan Stern /* Normal USB devices resume/reset through their upstream port. 259686314cfSAlan Stern * Root hubs don't have upstream ports to resume or reset, 260686314cfSAlan Stern * so we have to start up their downstream HC-to-USB 261686314cfSAlan Stern * interfaces manually by doing a bus (or "global") resume. 262686314cfSAlan Stern */ 263686314cfSAlan Stern if (!udev->parent) 26465bfd296SAlan Stern rc = hcd_bus_resume(udev, msg); 2650458d5b4SAlan Stern else 26665bfd296SAlan Stern rc = usb_port_resume(udev, msg); 267b6f6436dSAlan Stern return rc; 268782da727SAlan Stern } 269782da727SAlan Stern 270782da727SAlan Stern #endif /* CONFIG_PM */ 271782da727SAlan Stern 2728bb54ab5SAlan Stern struct usb_device_driver usb_generic_driver = { 27336e56a34SAlan Stern .name = "usb", 27436e56a34SAlan Stern .probe = generic_probe, 2758bb54ab5SAlan Stern .disconnect = generic_disconnect, 276782da727SAlan Stern #ifdef CONFIG_PM 277782da727SAlan Stern .suspend = generic_suspend, 278782da727SAlan Stern .resume = generic_resume, 279782da727SAlan Stern #endif 28001d883d4SAlan Stern .supports_autosuspend = 1, 28136e56a34SAlan Stern }; 282