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