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