]>
Commit | Line | Data |
---|---|---|
84412f62 GKH |
1 | /* |
2 | * drivers/usb/core/endpoint.c | |
3 | * | |
4 | * (C) Copyright 2002,2004,2006 Greg Kroah-Hartman | |
5 | * (C) Copyright 2002,2004 IBM Corp. | |
6 | * (C) Copyright 2006 Novell Inc. | |
7 | * | |
8 | * Endpoint sysfs stuff | |
9 | * | |
10 | */ | |
11 | ||
12 | #include <linux/kernel.h> | |
7e27780f SB |
13 | #include <linux/spinlock.h> |
14 | #include <linux/idr.h> | |
84412f62 GKH |
15 | #include <linux/usb.h> |
16 | #include "usb.h" | |
17 | ||
7e27780f SB |
18 | #define MAX_ENDPOINT_MINORS (64*128*32) |
19 | static int usb_endpoint_major; | |
20 | static DEFINE_IDR(endpoint_idr); | |
9bde7497 GKH |
21 | |
22 | struct ep_device { | |
84412f62 GKH |
23 | struct usb_endpoint_descriptor *desc; |
24 | struct usb_device *udev; | |
9bde7497 | 25 | struct device dev; |
7e27780f | 26 | int minor; |
84412f62 | 27 | }; |
9bde7497 GKH |
28 | #define to_ep_device(_dev) \ |
29 | container_of(_dev, struct ep_device, dev) | |
84412f62 GKH |
30 | |
31 | struct ep_attribute { | |
32 | struct attribute attr; | |
33 | ssize_t (*show)(struct usb_device *, | |
34 | struct usb_endpoint_descriptor *, char *); | |
35 | }; | |
36 | #define to_ep_attribute(_attr) \ | |
37 | container_of(_attr, struct ep_attribute, attr) | |
38 | ||
84412f62 | 39 | #define usb_ep_attr(field, format_string) \ |
9bde7497 GKH |
40 | static ssize_t show_ep_##field(struct device *dev, \ |
41 | struct device_attribute *attr, \ | |
42 | char *buf) \ | |
84412f62 | 43 | { \ |
9bde7497 GKH |
44 | struct ep_device *ep = to_ep_device(dev); \ |
45 | return sprintf(buf, format_string, ep->desc->field); \ | |
84412f62 | 46 | } \ |
9bde7497 | 47 | static DEVICE_ATTR(field, S_IRUGO, show_ep_##field, NULL); |
84412f62 GKH |
48 | |
49 | usb_ep_attr(bLength, "%02x\n") | |
50 | usb_ep_attr(bEndpointAddress, "%02x\n") | |
51 | usb_ep_attr(bmAttributes, "%02x\n") | |
52 | usb_ep_attr(bInterval, "%02x\n") | |
53 | ||
9bde7497 GKH |
54 | static ssize_t show_ep_wMaxPacketSize(struct device *dev, |
55 | struct device_attribute *attr, char *buf) | |
84412f62 | 56 | { |
9bde7497 | 57 | struct ep_device *ep = to_ep_device(dev); |
84412f62 | 58 | return sprintf(buf, "%04x\n", |
9bde7497 | 59 | le16_to_cpu(ep->desc->wMaxPacketSize) & 0x07ff); |
84412f62 | 60 | } |
9bde7497 | 61 | static DEVICE_ATTR(wMaxPacketSize, S_IRUGO, show_ep_wMaxPacketSize, NULL); |
84412f62 | 62 | |
9bde7497 GKH |
63 | static ssize_t show_ep_type(struct device *dev, struct device_attribute *attr, |
64 | char *buf) | |
84412f62 | 65 | { |
9bde7497 | 66 | struct ep_device *ep = to_ep_device(dev); |
84412f62 GKH |
67 | char *type = "unknown"; |
68 | ||
9bde7497 | 69 | switch (ep->desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) { |
84412f62 GKH |
70 | case USB_ENDPOINT_XFER_CONTROL: |
71 | type = "Control"; | |
72 | break; | |
73 | case USB_ENDPOINT_XFER_ISOC: | |
74 | type = "Isoc"; | |
75 | break; | |
76 | case USB_ENDPOINT_XFER_BULK: | |
77 | type = "Bulk"; | |
78 | break; | |
79 | case USB_ENDPOINT_XFER_INT: | |
80 | type = "Interrupt"; | |
81 | break; | |
82 | } | |
83 | return sprintf(buf, "%s\n", type); | |
84 | } | |
9bde7497 | 85 | static DEVICE_ATTR(type, S_IRUGO, show_ep_type, NULL); |
84412f62 | 86 | |
9bde7497 GKH |
87 | static ssize_t show_ep_interval(struct device *dev, |
88 | struct device_attribute *attr, char *buf) | |
84412f62 | 89 | { |
9bde7497 | 90 | struct ep_device *ep = to_ep_device(dev); |
84412f62 GKH |
91 | char unit; |
92 | unsigned interval = 0; | |
93 | unsigned in; | |
94 | ||
9bde7497 | 95 | in = (ep->desc->bEndpointAddress & USB_DIR_IN); |
84412f62 | 96 | |
9bde7497 | 97 | switch (ep->desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) { |
84412f62 | 98 | case USB_ENDPOINT_XFER_CONTROL: |
9bde7497 GKH |
99 | if (ep->udev->speed == USB_SPEED_HIGH) /* uframes per NAK */ |
100 | interval = ep->desc->bInterval; | |
84412f62 GKH |
101 | break; |
102 | case USB_ENDPOINT_XFER_ISOC: | |
9bde7497 | 103 | interval = 1 << (ep->desc->bInterval - 1); |
84412f62 GKH |
104 | break; |
105 | case USB_ENDPOINT_XFER_BULK: | |
9bde7497 GKH |
106 | if (ep->udev->speed == USB_SPEED_HIGH && !in) /* uframes per NAK */ |
107 | interval = ep->desc->bInterval; | |
84412f62 GKH |
108 | break; |
109 | case USB_ENDPOINT_XFER_INT: | |
9bde7497 GKH |
110 | if (ep->udev->speed == USB_SPEED_HIGH) |
111 | interval = 1 << (ep->desc->bInterval - 1); | |
84412f62 | 112 | else |
9bde7497 | 113 | interval = ep->desc->bInterval; |
84412f62 GKH |
114 | break; |
115 | } | |
9bde7497 | 116 | interval *= (ep->udev->speed == USB_SPEED_HIGH) ? 125 : 1000; |
84412f62 GKH |
117 | if (interval % 1000) |
118 | unit = 'u'; | |
119 | else { | |
120 | unit = 'm'; | |
121 | interval /= 1000; | |
122 | } | |
123 | ||
124 | return sprintf(buf, "%d%cs\n", interval, unit); | |
125 | } | |
9bde7497 | 126 | static DEVICE_ATTR(interval, S_IRUGO, show_ep_interval, NULL); |
84412f62 | 127 | |
9bde7497 GKH |
128 | static ssize_t show_ep_direction(struct device *dev, |
129 | struct device_attribute *attr, char *buf) | |
84412f62 | 130 | { |
9bde7497 | 131 | struct ep_device *ep = to_ep_device(dev); |
84412f62 GKH |
132 | char *direction; |
133 | ||
9bde7497 | 134 | if ((ep->desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) == |
84412f62 GKH |
135 | USB_ENDPOINT_XFER_CONTROL) |
136 | direction = "both"; | |
9bde7497 | 137 | else if (ep->desc->bEndpointAddress & USB_DIR_IN) |
84412f62 GKH |
138 | direction = "in"; |
139 | else | |
140 | direction = "out"; | |
141 | return sprintf(buf, "%s\n", direction); | |
142 | } | |
9bde7497 GKH |
143 | static DEVICE_ATTR(direction, S_IRUGO, show_ep_direction, NULL); |
144 | ||
145 | static struct attribute *ep_dev_attrs[] = { | |
146 | &dev_attr_bLength.attr, | |
147 | &dev_attr_bEndpointAddress.attr, | |
148 | &dev_attr_bmAttributes.attr, | |
149 | &dev_attr_bInterval.attr, | |
150 | &dev_attr_wMaxPacketSize.attr, | |
151 | &dev_attr_interval.attr, | |
152 | &dev_attr_type.attr, | |
153 | &dev_attr_direction.attr, | |
84412f62 GKH |
154 | NULL, |
155 | }; | |
9bde7497 GKH |
156 | static struct attribute_group ep_dev_attr_grp = { |
157 | .attrs = ep_dev_attrs, | |
158 | }; | |
2e5f10e4 AS |
159 | static struct attribute_group *ep_dev_groups[] = { |
160 | &ep_dev_attr_grp, | |
161 | NULL | |
162 | }; | |
84412f62 | 163 | |
7e27780f SB |
164 | static int usb_endpoint_major_init(void) |
165 | { | |
166 | dev_t dev; | |
167 | int error; | |
168 | ||
169 | error = alloc_chrdev_region(&dev, 0, MAX_ENDPOINT_MINORS, | |
170 | "usb_endpoint"); | |
171 | if (error) { | |
172 | err("unable to get a dynamic major for usb endpoints"); | |
173 | return error; | |
174 | } | |
175 | usb_endpoint_major = MAJOR(dev); | |
176 | ||
177 | return error; | |
178 | } | |
179 | ||
180 | static void usb_endpoint_major_cleanup(void) | |
181 | { | |
182 | unregister_chrdev_region(MKDEV(usb_endpoint_major, 0), | |
183 | MAX_ENDPOINT_MINORS); | |
184 | } | |
185 | ||
186 | static int endpoint_get_minor(struct ep_device *ep_dev) | |
187 | { | |
188 | static DEFINE_MUTEX(minor_lock); | |
189 | int retval = -ENOMEM; | |
190 | int id; | |
191 | ||
192 | mutex_lock(&minor_lock); | |
193 | if (idr_pre_get(&endpoint_idr, GFP_KERNEL) == 0) | |
194 | goto exit; | |
195 | ||
196 | retval = idr_get_new(&endpoint_idr, ep_dev, &id); | |
197 | if (retval < 0) { | |
198 | if (retval == -EAGAIN) | |
199 | retval = -ENOMEM; | |
200 | goto exit; | |
201 | } | |
202 | ep_dev->minor = id & MAX_ID_MASK; | |
203 | exit: | |
204 | mutex_unlock(&minor_lock); | |
205 | return retval; | |
206 | } | |
207 | ||
208 | static void endpoint_free_minor(struct ep_device *ep_dev) | |
209 | { | |
210 | idr_remove(&endpoint_idr, ep_dev->minor); | |
211 | } | |
212 | ||
9bde7497 GKH |
213 | static struct endpoint_class { |
214 | struct kref kref; | |
215 | struct class *class; | |
216 | } *ep_class; | |
217 | ||
218 | static int init_endpoint_class(void) | |
84412f62 | 219 | { |
9bde7497 GKH |
220 | int result = 0; |
221 | ||
222 | if (ep_class != NULL) { | |
223 | kref_get(&ep_class->kref); | |
224 | goto exit; | |
225 | } | |
226 | ||
227 | ep_class = kmalloc(sizeof(*ep_class), GFP_KERNEL); | |
228 | if (!ep_class) { | |
229 | result = -ENOMEM; | |
230 | goto exit; | |
231 | } | |
232 | ||
233 | kref_init(&ep_class->kref); | |
234 | ep_class->class = class_create(THIS_MODULE, "usb_endpoint"); | |
235 | if (IS_ERR(ep_class->class)) { | |
c5999f0d | 236 | result = PTR_ERR(ep_class->class); |
7e27780f | 237 | goto class_create_error; |
9bde7497 GKH |
238 | } |
239 | ||
7e27780f SB |
240 | result = usb_endpoint_major_init(); |
241 | if (result) | |
242 | goto endpoint_major_error; | |
243 | ||
244 | goto exit; | |
245 | ||
246 | endpoint_major_error: | |
247 | class_destroy(ep_class->class); | |
248 | class_create_error: | |
249 | kfree(ep_class); | |
250 | ep_class = NULL; | |
9bde7497 GKH |
251 | exit: |
252 | return result; | |
84412f62 GKH |
253 | } |
254 | ||
9bde7497 | 255 | static void release_endpoint_class(struct kref *kref) |
84412f62 | 256 | { |
9bde7497 GKH |
257 | /* Ok, we cheat as we know we only have one ep_class */ |
258 | class_destroy(ep_class->class); | |
259 | kfree(ep_class); | |
260 | ep_class = NULL; | |
7e27780f | 261 | usb_endpoint_major_cleanup(); |
9bde7497 | 262 | } |
84412f62 | 263 | |
9bde7497 GKH |
264 | static void destroy_endpoint_class(void) |
265 | { | |
266 | if (ep_class) | |
267 | kref_put(&ep_class->kref, release_endpoint_class); | |
84412f62 GKH |
268 | } |
269 | ||
9bde7497 GKH |
270 | static void ep_device_release(struct device *dev) |
271 | { | |
272 | struct ep_device *ep_dev = to_ep_device(dev); | |
84412f62 | 273 | |
c07be136 | 274 | endpoint_free_minor(ep_dev); |
9bde7497 GKH |
275 | kfree(ep_dev); |
276 | } | |
84412f62 | 277 | |
1b21d5e1 GKH |
278 | int usb_create_ep_files(struct device *parent, |
279 | struct usb_host_endpoint *endpoint, | |
280 | struct usb_device *udev) | |
84412f62 | 281 | { |
9bde7497 GKH |
282 | char name[8]; |
283 | struct ep_device *ep_dev; | |
9bde7497 GKH |
284 | int retval; |
285 | ||
286 | retval = init_endpoint_class(); | |
287 | if (retval) | |
288 | goto exit; | |
84412f62 | 289 | |
9bde7497 GKH |
290 | ep_dev = kzalloc(sizeof(*ep_dev), GFP_KERNEL); |
291 | if (!ep_dev) { | |
292 | retval = -ENOMEM; | |
d5477c11 | 293 | goto error_alloc; |
9bde7497 | 294 | } |
84412f62 | 295 | |
7e27780f SB |
296 | retval = endpoint_get_minor(ep_dev); |
297 | if (retval) { | |
898eb71c | 298 | dev_err(parent, "can not allocate minor number for %s\n", |
7071a3ce | 299 | dev_name(&ep_dev->dev)); |
7e27780f SB |
300 | goto error_register; |
301 | } | |
84412f62 | 302 | |
9bde7497 GKH |
303 | ep_dev->desc = &endpoint->desc; |
304 | ep_dev->udev = udev; | |
2e5f10e4 | 305 | ep_dev->dev.groups = ep_dev_groups; |
7e27780f | 306 | ep_dev->dev.devt = MKDEV(usb_endpoint_major, ep_dev->minor); |
9bde7497 GKH |
307 | ep_dev->dev.class = ep_class->class; |
308 | ep_dev->dev.parent = parent; | |
309 | ep_dev->dev.release = ep_device_release; | |
310 | snprintf(ep_dev->dev.bus_id, BUS_ID_SIZE, "usbdev%d.%d_ep%02x", | |
311 | udev->bus->busnum, udev->devnum, | |
312 | endpoint->desc.bEndpointAddress); | |
84412f62 | 313 | |
9bde7497 GKH |
314 | retval = device_register(&ep_dev->dev); |
315 | if (retval) | |
7e27780f | 316 | goto error_chrdev; |
9bde7497 | 317 | |
9bde7497 GKH |
318 | /* create the symlink to the old-style "ep_XX" directory */ |
319 | sprintf(name, "ep_%02x", endpoint->desc.bEndpointAddress); | |
d5477c11 | 320 | retval = sysfs_create_link(&parent->kobj, &ep_dev->dev.kobj, name); |
1b21d5e1 GKH |
321 | if (retval) |
322 | goto error_link; | |
d5477c11 | 323 | endpoint->ep_dev = ep_dev; |
1b21d5e1 GKH |
324 | return retval; |
325 | ||
326 | error_link: | |
1b21d5e1 | 327 | device_unregister(&ep_dev->dev); |
1b21d5e1 GKH |
328 | destroy_endpoint_class(); |
329 | return retval; | |
d5477c11 | 330 | |
7e27780f SB |
331 | error_chrdev: |
332 | endpoint_free_minor(ep_dev); | |
333 | ||
d5477c11 | 334 | error_register: |
9bde7497 | 335 | kfree(ep_dev); |
d5477c11 | 336 | error_alloc: |
1b21d5e1 | 337 | destroy_endpoint_class(); |
d5477c11 | 338 | exit: |
1b21d5e1 | 339 | return retval; |
84412f62 GKH |
340 | } |
341 | ||
342 | void usb_remove_ep_files(struct usb_host_endpoint *endpoint) | |
343 | { | |
7e27780f | 344 | struct ep_device *ep_dev = endpoint->ep_dev; |
84412f62 | 345 | |
7e27780f | 346 | if (ep_dev) { |
9bde7497 GKH |
347 | char name[8]; |
348 | ||
349 | sprintf(name, "ep_%02x", endpoint->desc.bEndpointAddress); | |
7e27780f | 350 | sysfs_remove_link(&ep_dev->dev.parent->kobj, name); |
7e27780f | 351 | device_unregister(&ep_dev->dev); |
9bde7497 | 352 | endpoint->ep_dev = NULL; |
c40fd5ea | 353 | destroy_endpoint_class(); |
84412f62 GKH |
354 | } |
355 | } |