Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 1 | #include <linux/pm.h> |
| 2 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 3 | /* Functions local to drivers/usb/core/ */ |
| 4 | |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 5 | extern int usb_create_sysfs_dev_files(struct usb_device *dev); |
| 6 | extern void usb_remove_sysfs_dev_files(struct usb_device *dev); |
| 7 | extern int usb_create_sysfs_intf_files(struct usb_interface *intf); |
| 8 | extern void usb_remove_sysfs_intf_files(struct usb_interface *intf); |
Alan Stern | 3b23dd6 | 2008-12-05 14:10:34 -0500 | [diff] [blame] | 9 | extern int usb_create_ep_devs(struct device *parent, |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 10 | struct usb_host_endpoint *endpoint, |
Greg Kroah-Hartman | 84412f6 | 2006-06-14 12:14:34 -0700 | [diff] [blame] | 11 | struct usb_device *udev); |
Alan Stern | 3b23dd6 | 2008-12-05 14:10:34 -0500 | [diff] [blame] | 12 | extern void usb_remove_ep_devs(struct usb_host_endpoint *endpoint); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 13 | |
Alan Stern | bdd016b | 2007-07-30 17:05:22 -0400 | [diff] [blame] | 14 | extern void usb_enable_endpoint(struct usb_device *dev, |
Alan Stern | 2caf7fc | 2008-12-31 11:31:33 -0500 | [diff] [blame] | 15 | struct usb_host_endpoint *ep, bool reset_toggle); |
| 16 | extern void usb_enable_interface(struct usb_device *dev, |
| 17 | struct usb_interface *intf, bool reset_toggles); |
Alan Stern | ddeac4e | 2009-01-15 17:03:33 -0500 | [diff] [blame] | 18 | extern void usb_disable_endpoint(struct usb_device *dev, unsigned int epaddr, |
| 19 | bool reset_hardware); |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 20 | extern void usb_disable_interface(struct usb_device *dev, |
Alan Stern | ddeac4e | 2009-01-15 17:03:33 -0500 | [diff] [blame] | 21 | struct usb_interface *intf, bool reset_hardware); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | extern void usb_release_interface_cache(struct kref *ref); |
Greg Kroah-Hartman | 84cca82 | 2008-01-30 15:21:33 -0800 | [diff] [blame] | 23 | extern void usb_disable_device(struct usb_device *dev, int skip_ep0); |
| 24 | extern int usb_deauthorize_device(struct usb_device *); |
| 25 | extern int usb_authorize_device(struct usb_device *); |
Oliver Neukum | 7ceec1f | 2007-01-26 14:26:21 +0100 | [diff] [blame] | 26 | extern void usb_detect_quirks(struct usb_device *udev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | |
| 28 | extern int usb_get_device_descriptor(struct usb_device *dev, |
| 29 | unsigned int size); |
Alan Stern | 4f62efe | 2005-10-24 16:24:14 -0400 | [diff] [blame] | 30 | extern char *usb_cache_string(struct usb_device *udev, int index); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 31 | extern int usb_set_configuration(struct usb_device *dev, int configuration); |
Greg Kroah-Hartman | b5ea060 | 2007-08-02 22:44:27 -0600 | [diff] [blame] | 32 | extern int usb_choose_configuration(struct usb_device *udev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 33 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 34 | extern void usb_kick_khubd(struct usb_device *dev); |
Greg Kroah-Hartman | bb41702 | 2007-01-26 14:26:21 +0100 | [diff] [blame] | 35 | extern int usb_match_device(struct usb_device *dev, |
| 36 | const struct usb_device_id *id); |
Alan Stern | 78d9a48 | 2008-06-23 16:00:40 -0400 | [diff] [blame] | 37 | extern void usb_forced_unbind_intf(struct usb_interface *intf); |
| 38 | extern void usb_rebind_intf(struct usb_interface *intf); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 39 | |
Alan Stern | 7cbe5dc | 2009-06-29 10:56:54 -0400 | [diff] [blame] | 40 | extern int usb_hub_claim_port(struct usb_device *hdev, unsigned port, |
| 41 | void *owner); |
| 42 | extern int usb_hub_release_port(struct usb_device *hdev, unsigned port, |
| 43 | void *owner); |
| 44 | extern void usb_hub_release_all_ports(struct usb_device *hdev, void *owner); |
| 45 | extern bool usb_device_is_owned(struct usb_device *udev); |
| 46 | |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 47 | extern int usb_hub_init(void); |
| 48 | extern void usb_hub_cleanup(void); |
| 49 | extern int usb_major_init(void); |
| 50 | extern void usb_major_cleanup(void); |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 51 | |
Alan Stern | d388dab | 2006-07-01 22:14:24 -0400 | [diff] [blame] | 52 | #ifdef CONFIG_PM |
| 53 | |
Alan Stern | f2189c4 | 2008-08-12 14:34:10 -0400 | [diff] [blame] | 54 | extern int usb_suspend(struct device *dev, pm_message_t msg); |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 55 | extern int usb_resume(struct device *dev, pm_message_t msg); |
Alan Stern | f2189c4 | 2008-08-12 14:34:10 -0400 | [diff] [blame] | 56 | |
Alan Stern | 718efa6 | 2007-03-09 15:41:13 -0500 | [diff] [blame] | 57 | extern void usb_autosuspend_work(struct work_struct *work); |
Alan Stern | 9ac39f2 | 2008-11-12 16:19:49 -0500 | [diff] [blame] | 58 | extern void usb_autoresume_work(struct work_struct *work); |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 59 | extern int usb_port_suspend(struct usb_device *dev, pm_message_t msg); |
| 60 | extern int usb_port_resume(struct usb_device *dev, pm_message_t msg); |
Alan Stern | 6b157c9 | 2007-03-13 16:37:30 -0400 | [diff] [blame] | 61 | extern int usb_external_suspend_device(struct usb_device *udev, |
| 62 | pm_message_t msg); |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 63 | extern int usb_external_resume_device(struct usb_device *udev, |
| 64 | pm_message_t msg); |
David Brownell | 5edbfb7 | 2005-09-22 22:45:26 -0700 | [diff] [blame] | 65 | |
Alan Stern | e0318eb | 2006-09-26 14:50:20 -0400 | [diff] [blame] | 66 | static inline void usb_pm_lock(struct usb_device *udev) |
| 67 | { |
| 68 | mutex_lock_nested(&udev->pm_mutex, udev->level); |
| 69 | } |
| 70 | |
| 71 | static inline void usb_pm_unlock(struct usb_device *udev) |
| 72 | { |
| 73 | mutex_unlock(&udev->pm_mutex); |
| 74 | } |
| 75 | |
Alan Stern | d388dab | 2006-07-01 22:14:24 -0400 | [diff] [blame] | 76 | #else |
| 77 | |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 78 | 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] | 79 | { |
| 80 | return 0; |
| 81 | } |
| 82 | |
Alan Stern | 65bfd29 | 2008-11-25 16:39:18 -0500 | [diff] [blame] | 83 | 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] | 84 | { |
| 85 | return 0; |
| 86 | } |
| 87 | |
Alan Stern | e0318eb | 2006-09-26 14:50:20 -0400 | [diff] [blame] | 88 | static inline void usb_pm_lock(struct usb_device *udev) {} |
| 89 | static inline void usb_pm_unlock(struct usb_device *udev) {} |
Alan Stern | d388dab | 2006-07-01 22:14:24 -0400 | [diff] [blame] | 90 | |
| 91 | #endif |
| 92 | |
Alan Stern | 645daaa | 2006-08-30 15:47:02 -0400 | [diff] [blame] | 93 | #ifdef CONFIG_USB_SUSPEND |
| 94 | |
Alan Stern | 94fcda1 | 2006-11-20 11:38:46 -0500 | [diff] [blame] | 95 | extern void usb_autosuspend_device(struct usb_device *udev); |
Alan Stern | 19c2623 | 2007-02-20 15:03:32 -0500 | [diff] [blame] | 96 | extern void usb_try_autosuspend_device(struct usb_device *udev); |
Alan Stern | 94fcda1 | 2006-11-20 11:38:46 -0500 | [diff] [blame] | 97 | extern int usb_autoresume_device(struct usb_device *udev); |
Alan Stern | 645daaa | 2006-08-30 15:47:02 -0400 | [diff] [blame] | 98 | |
| 99 | #else |
| 100 | |
Alan Stern | 19c2623 | 2007-02-20 15:03:32 -0500 | [diff] [blame] | 101 | #define usb_autosuspend_device(udev) do {} while (0) |
| 102 | #define usb_try_autosuspend_device(udev) do {} while (0) |
Alan Stern | 94fcda1 | 2006-11-20 11:38:46 -0500 | [diff] [blame] | 103 | static inline int usb_autoresume_device(struct usb_device *udev) |
Alan Stern | e0318eb | 2006-09-26 14:50:20 -0400 | [diff] [blame] | 104 | { |
| 105 | return 0; |
| 106 | } |
Alan Stern | 645daaa | 2006-08-30 15:47:02 -0400 | [diff] [blame] | 107 | |
| 108 | #endif |
| 109 | |
Alan Stern | bd85928 | 2006-09-19 10:14:07 -0400 | [diff] [blame] | 110 | extern struct workqueue_struct *ksuspend_usb_wq; |
Alan Stern | 36e56a3 | 2006-07-01 22:08:06 -0400 | [diff] [blame] | 111 | extern struct bus_type usb_bus_type; |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 112 | extern struct device_type usb_device_type; |
| 113 | extern struct device_type usb_if_device_type; |
Kay Sievers | 5512966 | 2009-05-04 19:48:32 +0200 | [diff] [blame] | 114 | extern struct device_type usb_ep_device_type; |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 115 | extern struct usb_device_driver usb_generic_driver; |
| 116 | |
Luiz Fernando N. Capitulino | 095bc33 | 2006-08-26 23:48:11 -0300 | [diff] [blame] | 117 | static inline int is_usb_device(const struct device *dev) |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 118 | { |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 119 | return dev->type == &usb_device_type; |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 120 | } |
| 121 | |
Kay Sievers | 5512966 | 2009-05-04 19:48:32 +0200 | [diff] [blame] | 122 | static inline int is_usb_interface(const struct device *dev) |
| 123 | { |
| 124 | return dev->type == &usb_if_device_type; |
| 125 | } |
| 126 | |
| 127 | static inline int is_usb_endpoint(const struct device *dev) |
| 128 | { |
| 129 | return dev->type == &usb_ep_device_type; |
| 130 | } |
| 131 | |
Alan Stern | 8bb54ab | 2006-07-01 22:08:49 -0400 | [diff] [blame] | 132 | /* Do the same for device drivers and interface drivers. */ |
| 133 | |
| 134 | static inline int is_usb_device_driver(struct device_driver *drv) |
| 135 | { |
| 136 | return container_of(drv, struct usbdrv_wrap, driver)-> |
| 137 | for_devices; |
| 138 | } |
David Brownell | 5edbfb7 | 2005-09-22 22:45:26 -0700 | [diff] [blame] | 139 | |
David Brownell | db69087 | 2005-09-13 19:56:33 -0700 | [diff] [blame] | 140 | /* Interfaces and their "power state" are owned by usbcore */ |
| 141 | |
| 142 | static inline void mark_active(struct usb_interface *f) |
| 143 | { |
Alan Stern | 4d064c0 | 2006-07-01 22:11:44 -0400 | [diff] [blame] | 144 | f->is_active = 1; |
David Brownell | db69087 | 2005-09-13 19:56:33 -0700 | [diff] [blame] | 145 | } |
| 146 | |
| 147 | static inline void mark_quiesced(struct usb_interface *f) |
| 148 | { |
Alan Stern | 4d064c0 | 2006-07-01 22:11:44 -0400 | [diff] [blame] | 149 | f->is_active = 0; |
David Brownell | db69087 | 2005-09-13 19:56:33 -0700 | [diff] [blame] | 150 | } |
| 151 | |
Luiz Fernando N. Capitulino | 095bc33 | 2006-08-26 23:48:11 -0300 | [diff] [blame] | 152 | static inline int is_active(const struct usb_interface *f) |
David Brownell | db69087 | 2005-09-13 19:56:33 -0700 | [diff] [blame] | 153 | { |
Alan Stern | 4d064c0 | 2006-07-01 22:11:44 -0400 | [diff] [blame] | 154 | return f->is_active; |
David Brownell | db69087 | 2005-09-13 19:56:33 -0700 | [diff] [blame] | 155 | } |
| 156 | |
| 157 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 158 | /* for labeling diagnostics */ |
| 159 | extern const char *usbcore_name; |
| 160 | |
Alan Stern | 2e5f10e | 2008-04-30 15:37:19 -0400 | [diff] [blame] | 161 | /* sysfs stuff */ |
David Brownell | a4dbd67 | 2009-06-24 10:06:31 -0700 | [diff] [blame] | 162 | extern const struct attribute_group *usb_device_groups[]; |
| 163 | extern const struct attribute_group *usb_interface_groups[]; |
Alan Stern | 2e5f10e | 2008-04-30 15:37:19 -0400 | [diff] [blame] | 164 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 165 | /* usbfs stuff */ |
Alan Stern | 4a2a8a2 | 2006-07-01 22:05:01 -0400 | [diff] [blame] | 166 | extern struct mutex usbfs_mutex; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 167 | extern struct usb_driver usbfs_driver; |
Luiz Fernando N. Capitulino | 066202d | 2006-08-05 20:37:11 -0300 | [diff] [blame] | 168 | extern const struct file_operations usbfs_devices_fops; |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 169 | extern const struct file_operations usbdev_file_operations; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 170 | extern void usbfs_conn_disc_event(void); |
| 171 | |
Kay Sievers | 9f8b17e | 2007-03-13 15:59:31 +0100 | [diff] [blame] | 172 | extern int usb_devio_init(void); |
| 173 | extern void usb_devio_cleanup(void); |
Greg KH | 6d5e825 | 2005-04-18 17:39:24 -0700 | [diff] [blame] | 174 | |
Greg Kroah-Hartman | 3099e75 | 2005-06-20 21:15:16 -0700 | [diff] [blame] | 175 | /* internal notify stuff */ |
| 176 | extern void usb_notify_add_device(struct usb_device *udev); |
| 177 | extern void usb_notify_remove_device(struct usb_device *udev); |
| 178 | extern void usb_notify_add_bus(struct usb_bus *ubus); |
| 179 | extern void usb_notify_remove_bus(struct usb_bus *ubus); |
| 180 | |