Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 1 | #include <linux/pm.h> |
Lan Tianyu | d557542 | 2012-09-05 13:44:33 +0800 | [diff] [blame] | 2 | #include <linux/acpi.h> |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 3 | |
Lan Tianyu | d2123fd | 2013-01-21 22:18:00 +0800 | [diff] [blame] | 4 | struct usb_hub_descriptor; |
Valentina Manea | 9b6f0c4 | 2014-03-10 10:36:40 +0200 | [diff] [blame] | 5 | struct usb_dev_state; |
Lan Tianyu | 336c5c3 | 2012-07-06 14:13:52 +0800 | [diff] [blame] | 6 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 7 | /* Functions local to drivers/usb/core/ */ |
| 8 | |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 9 | extern int usb_create_sysfs_dev_files(struct usb_device *dev); |
| 10 | extern void usb_remove_sysfs_dev_files(struct usb_device *dev); |
Michal Nazarewicz | 643de62 | 2011-04-14 17:47:09 +0200 | [diff] [blame] | 11 | extern void usb_create_sysfs_intf_files(struct usb_interface *intf); |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 12 | extern void usb_remove_sysfs_intf_files(struct usb_interface *intf); |
Alan Stern | 3b23dd6 | 2008-12-05 14:10:34 -0500 | [diff] [blame] | 13 | extern int usb_create_ep_devs(struct device *parent, |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 14 | struct usb_host_endpoint *endpoint, |
Greg Kroah-Hartman | 84412f6 | 2006-06-14 12:14:34 -0700 | [diff] [blame] | 15 | struct usb_device *udev); |
Alan Stern | 3b23dd6 | 2008-12-05 14:10:34 -0500 | [diff] [blame] | 16 | extern void usb_remove_ep_devs(struct usb_host_endpoint *endpoint); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 17 | |
Alan Stern | bdd016b | 2007-07-30 17:05:22 -0400 | [diff] [blame] | 18 | extern void usb_enable_endpoint(struct usb_device *dev, |
Alan Stern | 2caf7fc | 2008-12-31 11:31:33 -0500 | [diff] [blame] | 19 | struct usb_host_endpoint *ep, bool reset_toggle); |
| 20 | extern void usb_enable_interface(struct usb_device *dev, |
| 21 | struct usb_interface *intf, bool reset_toggles); |
Alan Stern | ddeac4e7 | 2009-01-15 17:03:33 -0500 | [diff] [blame] | 22 | extern void usb_disable_endpoint(struct usb_device *dev, unsigned int epaddr, |
| 23 | bool reset_hardware); |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 24 | extern void usb_disable_interface(struct usb_device *dev, |
Alan Stern | ddeac4e7 | 2009-01-15 17:03:33 -0500 | [diff] [blame] | 25 | struct usb_interface *intf, bool reset_hardware); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 26 | extern void usb_release_interface_cache(struct kref *ref); |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 27 | extern void usb_disable_device(struct usb_device *dev, int skip_ep0); |
| 28 | extern int usb_deauthorize_device(struct usb_device *); |
| 29 | extern int usb_authorize_device(struct usb_device *); |
Stefan Koch | b3910ce | 2015-08-25 21:10:08 +0200 | [diff] [blame] | 30 | extern void usb_deauthorize_interface(struct usb_interface *); |
| 31 | extern void usb_authorize_interface(struct usb_interface *); |
Oliver Neukum | 7ceec1f | 2007-01-26 14:26:21 +0100 | [diff] [blame] | 32 | extern void usb_detect_quirks(struct usb_device *udev); |
Laurent Pinchart | 80da2e0 | 2012-07-19 12:39:13 +0200 | [diff] [blame] | 33 | extern void usb_detect_interface_quirks(struct usb_device *udev); |
Alan Stern | 253e057 | 2009-10-27 15:20:13 -0400 | [diff] [blame] | 34 | extern int usb_remove_device(struct usb_device *udev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 35 | |
| 36 | extern int usb_get_device_descriptor(struct usb_device *dev, |
| 37 | unsigned int size); |
Andiry Xu | 3148bf0 | 2011-09-23 14:19:47 -0700 | [diff] [blame] | 38 | extern int usb_get_bos_descriptor(struct usb_device *dev); |
| 39 | extern void usb_release_bos_descriptor(struct usb_device *dev); |
Alan Stern | 4f62efe | 2005-10-24 16:24:14 -0400 | [diff] [blame] | 40 | extern char *usb_cache_string(struct usb_device *udev, int index); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 41 | extern int usb_set_configuration(struct usb_device *dev, int configuration); |
Greg Kroah-Hartman | b5ea060 | 2007-08-02 22:44:27 -0600 | [diff] [blame] | 42 | extern int usb_choose_configuration(struct usb_device *udev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 43 | |
Sebastian Andrzej Siewior | 8d8479d | 2012-12-18 15:25:46 +0100 | [diff] [blame] | 44 | static inline unsigned usb_get_max_power(struct usb_device *udev, |
| 45 | struct usb_host_config *c) |
| 46 | { |
| 47 | /* SuperSpeed power is in 8 mA units; others are in 2 mA units */ |
Mathias Nyman | 8a1b272 | 2015-12-10 09:59:25 +0200 | [diff] [blame] | 48 | unsigned mul = (udev->speed >= USB_SPEED_SUPER ? 8 : 2); |
Sebastian Andrzej Siewior | 8d8479d | 2012-12-18 15:25:46 +0100 | [diff] [blame] | 49 | |
| 50 | return c->desc.bMaxPower * mul; |
| 51 | } |
| 52 | |
Petr Mladek | 59d48b3 | 2014-09-19 17:32:22 +0200 | [diff] [blame] | 53 | extern void usb_kick_hub_wq(struct usb_device *dev); |
Laurent Pinchart | 80da2e0 | 2012-07-19 12:39:13 +0200 | [diff] [blame] | 54 | extern int usb_match_one_id_intf(struct usb_device *dev, |
| 55 | struct usb_host_interface *intf, |
| 56 | const struct usb_device_id *id); |
Greg Kroah-Hartman | bb41702 | 2007-01-26 14:26:21 +0100 | [diff] [blame] | 57 | extern int usb_match_device(struct usb_device *dev, |
| 58 | const struct usb_device_id *id); |
Alan Stern | 78d9a48 | 2008-06-23 16:00:40 -0400 | [diff] [blame] | 59 | extern void usb_forced_unbind_intf(struct usb_interface *intf); |
Alan Stern | 6aec044 | 2014-03-12 11:30:38 -0400 | [diff] [blame] | 60 | extern void usb_unbind_and_rebind_marked_interfaces(struct usb_device *udev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 61 | |
Lan Tianyu | 336c5c3 | 2012-07-06 14:13:52 +0800 | [diff] [blame] | 62 | extern void usb_hub_release_all_ports(struct usb_device *hdev, |
Valentina Manea | 9b6f0c4 | 2014-03-10 10:36:40 +0200 | [diff] [blame] | 63 | struct usb_dev_state *owner); |
Alan Stern | 7cbe5dc | 2009-06-29 10:56:54 -0400 | [diff] [blame] | 64 | extern bool usb_device_is_owned(struct usb_device *udev); |
| 65 | |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 66 | extern int usb_hub_init(void); |
| 67 | extern void usb_hub_cleanup(void); |
| 68 | extern int usb_major_init(void); |
| 69 | extern void usb_major_cleanup(void); |
Lu Baolu | 2d2a316 | 2015-06-16 09:08:26 +0800 | [diff] [blame] | 70 | extern int usb_device_supports_lpm(struct usb_device *udev); |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 71 | |
Alan Stern | d388dab | 2006-07-01 22:14:24 -0400 | [diff] [blame] | 72 | #ifdef CONFIG_PM |
| 73 | |
Alan Stern | f2189c4 | 2008-08-12 14:34:10 -0400 | [diff] [blame] | 74 | extern int usb_suspend(struct device *dev, pm_message_t msg); |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 75 | extern int usb_resume(struct device *dev, pm_message_t msg); |
Oliver Neukum | 98d9a82 | 2012-01-11 08:38:35 +0100 | [diff] [blame] | 76 | extern int usb_resume_complete(struct device *dev); |
Alan Stern | f2189c4 | 2008-08-12 14:34:10 -0400 | [diff] [blame] | 77 | |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 78 | extern int usb_port_suspend(struct usb_device *dev, pm_message_t msg); |
| 79 | extern int usb_port_resume(struct usb_device *dev, pm_message_t msg); |
Alan Stern | e0318eb | 2006-09-26 14:50:20 -0400 | [diff] [blame] | 80 | |
Rafael J. Wysocki | ceb6c9c | 2014-11-29 23:47:05 +0100 | [diff] [blame] | 81 | extern void usb_autosuspend_device(struct usb_device *udev); |
| 82 | extern int usb_autoresume_device(struct usb_device *udev); |
| 83 | extern int usb_remote_wakeup(struct usb_device *dev); |
| 84 | extern int usb_runtime_suspend(struct device *dev); |
| 85 | extern int usb_runtime_resume(struct device *dev); |
| 86 | extern int usb_runtime_idle(struct device *dev); |
| 87 | extern int usb_set_usb2_hardware_lpm(struct usb_device *udev, int enable); |
| 88 | |
Alan Stern | d388dab | 2006-07-01 22:14:24 -0400 | [diff] [blame] | 89 | #else |
| 90 | |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 91 | static inline int usb_port_suspend(struct usb_device *udev, pm_message_t msg) |
Alan Stern | 4956ecc | 2007-05-30 16:51:28 -0400 | [diff] [blame] | 92 | { |
| 93 | return 0; |
| 94 | } |
| 95 | |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 96 | static inline int usb_port_resume(struct usb_device *udev, pm_message_t msg) |
Alan Stern | 4956ecc | 2007-05-30 16:51:28 -0400 | [diff] [blame] | 97 | { |
| 98 | return 0; |
| 99 | } |
| 100 | |
Alan Stern | 19c2623 | 2007-02-20 15:03:32 -0500 | [diff] [blame] | 101 | #define usb_autosuspend_device(udev) do {} while (0) |
Alan Stern | 94fcda1 | 2006-11-20 11:38:46 -0500 | [diff] [blame] | 102 | static inline int usb_autoresume_device(struct usb_device *udev) |
Alan Stern | e0318eb | 2006-09-26 14:50:20 -0400 | [diff] [blame] | 103 | { |
| 104 | return 0; |
| 105 | } |
Alan Stern | 645daaa | 2006-08-30 15:47:02 -0400 | [diff] [blame] | 106 | |
Andiry Xu | 65580b43 | 2011-09-23 14:19:52 -0700 | [diff] [blame] | 107 | static inline int usb_set_usb2_hardware_lpm(struct usb_device *udev, int enable) |
| 108 | { |
| 109 | return 0; |
| 110 | } |
Rafael J. Wysocki | ceb6c9c | 2014-11-29 23:47:05 +0100 | [diff] [blame] | 111 | |
Alan Stern | 645daaa | 2006-08-30 15:47:02 -0400 | [diff] [blame] | 112 | #endif |
| 113 | |
Alan Stern | 36e56a3 | 2006-07-01 22:08:06 -0400 | [diff] [blame] | 114 | extern struct bus_type usb_bus_type; |
Dan Williams | d8521af | 2014-05-20 18:08:28 -0700 | [diff] [blame] | 115 | extern struct mutex usb_port_peer_mutex; |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 116 | extern struct device_type usb_device_type; |
| 117 | extern struct device_type usb_if_device_type; |
Kay Sievers | 5512966 | 2009-05-04 19:48:32 +0200 | [diff] [blame] | 118 | extern struct device_type usb_ep_device_type; |
Lan Tianyu | d557542 | 2012-09-05 13:44:33 +0800 | [diff] [blame] | 119 | extern struct device_type usb_port_device_type; |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 120 | extern struct usb_device_driver usb_generic_driver; |
| 121 | |
Luiz Fernando N. Capitulino | 095bc33 | 2006-08-26 23:48:11 -0300 | [diff] [blame] | 122 | static inline int is_usb_device(const struct device *dev) |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 123 | { |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 124 | return dev->type == &usb_device_type; |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 125 | } |
| 126 | |
Kay Sievers | 5512966 | 2009-05-04 19:48:32 +0200 | [diff] [blame] | 127 | static inline int is_usb_interface(const struct device *dev) |
| 128 | { |
| 129 | return dev->type == &usb_if_device_type; |
| 130 | } |
| 131 | |
| 132 | static inline int is_usb_endpoint(const struct device *dev) |
| 133 | { |
| 134 | return dev->type == &usb_ep_device_type; |
| 135 | } |
| 136 | |
Lan Tianyu | d557542 | 2012-09-05 13:44:33 +0800 | [diff] [blame] | 137 | static inline int is_usb_port(const struct device *dev) |
| 138 | { |
| 139 | return dev->type == &usb_port_device_type; |
| 140 | } |
| 141 | |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 142 | /* Do the same for device drivers and interface drivers. */ |
| 143 | |
| 144 | static inline int is_usb_device_driver(struct device_driver *drv) |
| 145 | { |
| 146 | return container_of(drv, struct usbdrv_wrap, driver)-> |
| 147 | for_devices; |
| 148 | } |
David Brownell | 5edbfb7 | 2005-09-22 22:45:26 -0700 | [diff] [blame] | 149 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 150 | /* for labeling diagnostics */ |
| 151 | extern const char *usbcore_name; |
| 152 | |
Alan Stern | 2e5f10e | 2008-04-30 15:37:19 -0400 | [diff] [blame] | 153 | /* sysfs stuff */ |
David Brownell | a4dbd67 | 2009-06-24 10:06:31 -0700 | [diff] [blame] | 154 | extern const struct attribute_group *usb_device_groups[]; |
| 155 | extern const struct attribute_group *usb_interface_groups[]; |
Alan Stern | 2e5f10e | 2008-04-30 15:37:19 -0400 | [diff] [blame] | 156 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | /* usbfs stuff */ |
Alan Stern | 4a2a8a2 | 2006-07-01 22:05:01 -0400 | [diff] [blame] | 158 | extern struct mutex usbfs_mutex; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 159 | extern struct usb_driver usbfs_driver; |
Luiz Fernando N. Capitulino | 066202d | 2006-08-05 20:37:11 -0300 | [diff] [blame] | 160 | extern const struct file_operations usbfs_devices_fops; |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 161 | extern const struct file_operations usbdev_file_operations; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 162 | extern void usbfs_conn_disc_event(void); |
| 163 | |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 164 | extern int usb_devio_init(void); |
| 165 | extern void usb_devio_cleanup(void); |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 166 | |
Dan Williams | 3bfd659 | 2014-05-20 18:08:40 -0700 | [diff] [blame] | 167 | /* |
| 168 | * Firmware specific cookie identifying a port's location. '0' == no location |
| 169 | * data available |
| 170 | */ |
| 171 | typedef u32 usb_port_location_t; |
| 172 | |
Greg Kroah-Hartman | 3099e75 | 2005-06-20 21:15:16 -0700 | [diff] [blame] | 173 | /* internal notify stuff */ |
| 174 | extern void usb_notify_add_device(struct usb_device *udev); |
| 175 | extern void usb_notify_remove_device(struct usb_device *udev); |
| 176 | extern void usb_notify_add_bus(struct usb_bus *ubus); |
| 177 | extern void usb_notify_remove_bus(struct usb_bus *ubus); |
Lan Tianyu | d2123fd | 2013-01-21 22:18:00 +0800 | [diff] [blame] | 178 | extern void usb_hub_adjust_deviceremovable(struct usb_device *hdev, |
| 179 | struct usb_hub_descriptor *desc); |
Greg Kroah-Hartman | 3099e75 | 2005-06-20 21:15:16 -0700 | [diff] [blame] | 180 | |
Matthew Garrett | da0af6e | 2012-05-11 16:08:27 +0800 | [diff] [blame] | 181 | #ifdef CONFIG_ACPI |
| 182 | extern int usb_acpi_register(void); |
| 183 | extern void usb_acpi_unregister(void); |
Lan Tianyu | d557542 | 2012-09-05 13:44:33 +0800 | [diff] [blame] | 184 | extern acpi_handle usb_get_hub_port_acpi_handle(struct usb_device *hdev, |
| 185 | int port1); |
Matthew Garrett | da0af6e | 2012-05-11 16:08:27 +0800 | [diff] [blame] | 186 | #else |
| 187 | static inline int usb_acpi_register(void) { return 0; }; |
| 188 | static inline void usb_acpi_unregister(void) { }; |
| 189 | #endif |