]>
Commit | Line | Data |
---|---|---|
e6075b66 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
b65fba3d GKH |
2 | /* |
3 | * Released under the GPLv2 only. | |
b65fba3d GKH |
4 | */ |
5 | ||
65bfd296 | 6 | #include <linux/pm.h> |
d5575424 | 7 | #include <linux/acpi.h> |
65bfd296 | 8 | |
d2123fd9 | 9 | struct usb_hub_descriptor; |
9b6f0c4b | 10 | struct usb_dev_state; |
336c5c31 | 11 | |
1da177e4 LT |
12 | /* Functions local to drivers/usb/core/ */ |
13 | ||
84cca820 GKH |
14 | extern int usb_create_sysfs_dev_files(struct usb_device *dev); |
15 | extern void usb_remove_sysfs_dev_files(struct usb_device *dev); | |
643de624 | 16 | extern void usb_create_sysfs_intf_files(struct usb_interface *intf); |
84cca820 | 17 | extern void usb_remove_sysfs_intf_files(struct usb_interface *intf); |
3b23dd6f | 18 | extern int usb_create_ep_devs(struct device *parent, |
84cca820 | 19 | struct usb_host_endpoint *endpoint, |
84412f62 | 20 | struct usb_device *udev); |
3b23dd6f | 21 | extern void usb_remove_ep_devs(struct usb_host_endpoint *endpoint); |
1da177e4 | 22 | |
bdd016ba | 23 | extern void usb_enable_endpoint(struct usb_device *dev, |
2caf7fcd AS |
24 | struct usb_host_endpoint *ep, bool reset_toggle); |
25 | extern void usb_enable_interface(struct usb_device *dev, | |
26 | struct usb_interface *intf, bool reset_toggles); | |
ddeac4e7 AS |
27 | extern void usb_disable_endpoint(struct usb_device *dev, unsigned int epaddr, |
28 | bool reset_hardware); | |
84cca820 | 29 | extern void usb_disable_interface(struct usb_device *dev, |
ddeac4e7 | 30 | struct usb_interface *intf, bool reset_hardware); |
1da177e4 | 31 | extern void usb_release_interface_cache(struct kref *ref); |
84cca820 GKH |
32 | extern void usb_disable_device(struct usb_device *dev, int skip_ep0); |
33 | extern int usb_deauthorize_device(struct usb_device *); | |
34 | extern int usb_authorize_device(struct usb_device *); | |
b3910cef SK |
35 | extern void usb_deauthorize_interface(struct usb_interface *); |
36 | extern void usb_authorize_interface(struct usb_interface *); | |
7ceec1f1 | 37 | extern void usb_detect_quirks(struct usb_device *udev); |
80da2e0d | 38 | extern void usb_detect_interface_quirks(struct usb_device *udev); |
027bd6ca | 39 | extern void usb_release_quirk_list(void); |
91c7eaa6 | 40 | extern bool usb_endpoint_is_ignored(struct usb_device *udev, |
73f8bda9 JH |
41 | struct usb_host_interface *intf, |
42 | struct usb_endpoint_descriptor *epd); | |
253e0572 | 43 | extern int usb_remove_device(struct usb_device *udev); |
1da177e4 LT |
44 | |
45 | extern int usb_get_device_descriptor(struct usb_device *dev, | |
46 | unsigned int size); | |
886ee36e | 47 | extern int usb_set_isoch_delay(struct usb_device *dev); |
3148bf04 AX |
48 | extern int usb_get_bos_descriptor(struct usb_device *dev); |
49 | extern void usb_release_bos_descriptor(struct usb_device *dev); | |
4f62efe6 | 50 | extern char *usb_cache_string(struct usb_device *udev, int index); |
1da177e4 | 51 | extern int usb_set_configuration(struct usb_device *dev, int configuration); |
b5ea060f | 52 | extern int usb_choose_configuration(struct usb_device *udev); |
ef0f7d18 BN |
53 | extern int usb_generic_driver_probe(struct usb_device *udev); |
54 | extern void usb_generic_driver_disconnect(struct usb_device *udev); | |
55 | extern int usb_generic_driver_suspend(struct usb_device *udev, | |
56 | pm_message_t msg); | |
57 | extern int usb_generic_driver_resume(struct usb_device *udev, | |
58 | pm_message_t msg); | |
1da177e4 | 59 | |
8d8479db SAS |
60 | static inline unsigned usb_get_max_power(struct usb_device *udev, |
61 | struct usb_host_config *c) | |
62 | { | |
63 | /* SuperSpeed power is in 8 mA units; others are in 2 mA units */ | |
8a1b2725 | 64 | unsigned mul = (udev->speed >= USB_SPEED_SUPER ? 8 : 2); |
8d8479db SAS |
65 | |
66 | return c->desc.bMaxPower * mul; | |
67 | } | |
68 | ||
59d48b3f | 69 | extern void usb_kick_hub_wq(struct usb_device *dev); |
80da2e0d LP |
70 | extern int usb_match_one_id_intf(struct usb_device *dev, |
71 | struct usb_host_interface *intf, | |
72 | const struct usb_device_id *id); | |
bb417020 GKH |
73 | extern int usb_match_device(struct usb_device *dev, |
74 | const struct usb_device_id *id); | |
aeebf2b5 BN |
75 | extern const struct usb_device_id *usb_device_match_id(struct usb_device *udev, |
76 | const struct usb_device_id *id); | |
0942d59b BN |
77 | extern bool usb_driver_applicable(struct usb_device *udev, |
78 | struct usb_device_driver *udrv); | |
78d9a487 | 79 | extern void usb_forced_unbind_intf(struct usb_interface *intf); |
6aec044c | 80 | extern void usb_unbind_and_rebind_marked_interfaces(struct usb_device *udev); |
1da177e4 | 81 | |
336c5c31 | 82 | extern void usb_hub_release_all_ports(struct usb_device *hdev, |
9b6f0c4b | 83 | struct usb_dev_state *owner); |
7cbe5dca AS |
84 | extern bool usb_device_is_owned(struct usb_device *udev); |
85 | ||
6d5e8254 GKH |
86 | extern int usb_hub_init(void); |
87 | extern void usb_hub_cleanup(void); | |
88 | extern int usb_major_init(void); | |
89 | extern void usb_major_cleanup(void); | |
2d2a3167 | 90 | extern int usb_device_supports_lpm(struct usb_device *udev); |
8dd8d2c9 | 91 | extern int usb_port_disable(struct usb_device *udev); |
6d5e8254 | 92 | |
d388dab7 AS |
93 | #ifdef CONFIG_PM |
94 | ||
f2189c47 | 95 | extern int usb_suspend(struct device *dev, pm_message_t msg); |
65bfd296 | 96 | extern int usb_resume(struct device *dev, pm_message_t msg); |
98d9a82e | 97 | extern int usb_resume_complete(struct device *dev); |
f2189c47 | 98 | |
65bfd296 AS |
99 | extern int usb_port_suspend(struct usb_device *dev, pm_message_t msg); |
100 | extern int usb_port_resume(struct usb_device *dev, pm_message_t msg); | |
e0318ebf | 101 | |
ceb6c9c8 RW |
102 | extern void usb_autosuspend_device(struct usb_device *udev); |
103 | extern int usb_autoresume_device(struct usb_device *udev); | |
104 | extern int usb_remote_wakeup(struct usb_device *dev); | |
105 | extern int usb_runtime_suspend(struct device *dev); | |
106 | extern int usb_runtime_resume(struct device *dev); | |
107 | extern int usb_runtime_idle(struct device *dev); | |
7529b257 KHF |
108 | extern int usb_enable_usb2_hardware_lpm(struct usb_device *udev); |
109 | extern int usb_disable_usb2_hardware_lpm(struct usb_device *udev); | |
ceb6c9c8 | 110 | |
7794f486 AS |
111 | extern void usbfs_notify_suspend(struct usb_device *udev); |
112 | extern void usbfs_notify_resume(struct usb_device *udev); | |
113 | ||
d388dab7 AS |
114 | #else |
115 | ||
65bfd296 | 116 | static inline int usb_port_suspend(struct usb_device *udev, pm_message_t msg) |
4956eccd AS |
117 | { |
118 | return 0; | |
119 | } | |
120 | ||
65bfd296 | 121 | static inline int usb_port_resume(struct usb_device *udev, pm_message_t msg) |
4956eccd AS |
122 | { |
123 | return 0; | |
124 | } | |
125 | ||
19c26239 | 126 | #define usb_autosuspend_device(udev) do {} while (0) |
94fcda1f | 127 | static inline int usb_autoresume_device(struct usb_device *udev) |
e0318ebf AS |
128 | { |
129 | return 0; | |
130 | } | |
645daaab | 131 | |
7529b257 KHF |
132 | static inline int usb_enable_usb2_hardware_lpm(struct usb_device *udev) |
133 | { | |
134 | return 0; | |
135 | } | |
136 | ||
137 | static inline int usb_disable_usb2_hardware_lpm(struct usb_device *udev) | |
65580b43 AX |
138 | { |
139 | return 0; | |
140 | } | |
ceb6c9c8 | 141 | |
645daaab AS |
142 | #endif |
143 | ||
36e56a34 | 144 | extern struct bus_type usb_bus_type; |
d8521afe | 145 | extern struct mutex usb_port_peer_mutex; |
9f8b17e6 KS |
146 | extern struct device_type usb_device_type; |
147 | extern struct device_type usb_if_device_type; | |
55129666 | 148 | extern struct device_type usb_ep_device_type; |
d5575424 | 149 | extern struct device_type usb_port_device_type; |
8bb54ab5 AS |
150 | extern struct usb_device_driver usb_generic_driver; |
151 | ||
095bc335 | 152 | static inline int is_usb_device(const struct device *dev) |
8bb54ab5 | 153 | { |
9f8b17e6 | 154 | return dev->type == &usb_device_type; |
8bb54ab5 AS |
155 | } |
156 | ||
55129666 KS |
157 | static inline int is_usb_interface(const struct device *dev) |
158 | { | |
159 | return dev->type == &usb_if_device_type; | |
160 | } | |
161 | ||
162 | static inline int is_usb_endpoint(const struct device *dev) | |
163 | { | |
164 | return dev->type == &usb_ep_device_type; | |
165 | } | |
166 | ||
d5575424 LT |
167 | static inline int is_usb_port(const struct device *dev) |
168 | { | |
169 | return dev->type == &usb_port_device_type; | |
170 | } | |
171 | ||
27709ae4 TW |
172 | static inline int is_root_hub(struct usb_device *udev) |
173 | { | |
174 | return (udev->parent == NULL); | |
175 | } | |
176 | ||
8bb54ab5 AS |
177 | /* Do the same for device drivers and interface drivers. */ |
178 | ||
179 | static inline int is_usb_device_driver(struct device_driver *drv) | |
180 | { | |
181 | return container_of(drv, struct usbdrv_wrap, driver)-> | |
182 | for_devices; | |
183 | } | |
5edbfb7c | 184 | |
1da177e4 LT |
185 | /* for labeling diagnostics */ |
186 | extern const char *usbcore_name; | |
187 | ||
2e5f10e4 | 188 | /* sysfs stuff */ |
a4dbd674 DB |
189 | extern const struct attribute_group *usb_device_groups[]; |
190 | extern const struct attribute_group *usb_interface_groups[]; | |
2e5f10e4 | 191 | |
1da177e4 LT |
192 | /* usbfs stuff */ |
193 | extern struct usb_driver usbfs_driver; | |
066202dd | 194 | extern const struct file_operations usbfs_devices_fops; |
9f8b17e6 | 195 | extern const struct file_operations usbdev_file_operations; |
1da177e4 | 196 | |
9f8b17e6 KS |
197 | extern int usb_devio_init(void); |
198 | extern void usb_devio_cleanup(void); | |
6d5e8254 | 199 | |
3bfd659b DW |
200 | /* |
201 | * Firmware specific cookie identifying a port's location. '0' == no location | |
202 | * data available | |
203 | */ | |
204 | typedef u32 usb_port_location_t; | |
205 | ||
3099e75a GKH |
206 | /* internal notify stuff */ |
207 | extern void usb_notify_add_device(struct usb_device *udev); | |
208 | extern void usb_notify_remove_device(struct usb_device *udev); | |
209 | extern void usb_notify_add_bus(struct usb_bus *ubus); | |
210 | extern void usb_notify_remove_bus(struct usb_bus *ubus); | |
d2123fd9 LT |
211 | extern void usb_hub_adjust_deviceremovable(struct usb_device *hdev, |
212 | struct usb_hub_descriptor *desc); | |
3099e75a | 213 | |
da0af6e7 MG |
214 | #ifdef CONFIG_ACPI |
215 | extern int usb_acpi_register(void); | |
216 | extern void usb_acpi_unregister(void); | |
d5575424 LT |
217 | extern acpi_handle usb_get_hub_port_acpi_handle(struct usb_device *hdev, |
218 | int port1); | |
da0af6e7 MG |
219 | #else |
220 | static inline int usb_acpi_register(void) { return 0; }; | |
221 | static inline void usb_acpi_unregister(void) { }; | |
222 | #endif |