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> 13 #include <linux/spinlock.h> 14 #include <linux/slab.h> 15 #include <linux/idr.h> 16 #include <linux/usb.h> 17 #include "usb.h" 18 19 struct ep_device { 20 struct usb_endpoint_descriptor *desc; 21 struct usb_device *udev; 22 struct device dev; 23 }; 24 #define to_ep_device(_dev) \ 25 container_of(_dev, struct ep_device, dev) 26 27 struct device_type usb_ep_device_type = { 28 .name = "usb_endpoint", 29 }; 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 39 #define usb_ep_attr(field, format_string) \ 40 static ssize_t show_ep_##field(struct device *dev, \ 41 struct device_attribute *attr, \ 42 char *buf) \ 43 { \ 44 struct ep_device *ep = to_ep_device(dev); \ 45 return sprintf(buf, format_string, ep->desc->field); \ 46 } \ 47 static DEVICE_ATTR(field, S_IRUGO, show_ep_##field, NULL); 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 54 static ssize_t show_ep_wMaxPacketSize(struct device *dev, 55 struct device_attribute *attr, char *buf) 56 { 57 struct ep_device *ep = to_ep_device(dev); 58 return sprintf(buf, "%04x\n", 59 le16_to_cpu(ep->desc->wMaxPacketSize) & 0x07ff); 60 } 61 static DEVICE_ATTR(wMaxPacketSize, S_IRUGO, show_ep_wMaxPacketSize, NULL); 62 63 static ssize_t show_ep_type(struct device *dev, struct device_attribute *attr, 64 char *buf) 65 { 66 struct ep_device *ep = to_ep_device(dev); 67 char *type = "unknown"; 68 69 switch (usb_endpoint_type(ep->desc)) { 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 } 85 static DEVICE_ATTR(type, S_IRUGO, show_ep_type, NULL); 86 87 static ssize_t show_ep_interval(struct device *dev, 88 struct device_attribute *attr, char *buf) 89 { 90 struct ep_device *ep = to_ep_device(dev); 91 char unit; 92 unsigned interval = 0; 93 unsigned in; 94 95 in = (ep->desc->bEndpointAddress & USB_DIR_IN); 96 97 switch (usb_endpoint_type(ep->desc)) { 98 case USB_ENDPOINT_XFER_CONTROL: 99 if (ep->udev->speed == USB_SPEED_HIGH) /* uframes per NAK */ 100 interval = ep->desc->bInterval; 101 break; 102 case USB_ENDPOINT_XFER_ISOC: 103 interval = 1 << (ep->desc->bInterval - 1); 104 break; 105 case USB_ENDPOINT_XFER_BULK: 106 if (ep->udev->speed == USB_SPEED_HIGH && !in) /* uframes per NAK */ 107 interval = ep->desc->bInterval; 108 break; 109 case USB_ENDPOINT_XFER_INT: 110 if (ep->udev->speed == USB_SPEED_HIGH) 111 interval = 1 << (ep->desc->bInterval - 1); 112 else 113 interval = ep->desc->bInterval; 114 break; 115 } 116 interval *= (ep->udev->speed == USB_SPEED_HIGH) ? 125 : 1000; 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 } 126 static DEVICE_ATTR(interval, S_IRUGO, show_ep_interval, NULL); 127 128 static ssize_t show_ep_direction(struct device *dev, 129 struct device_attribute *attr, char *buf) 130 { 131 struct ep_device *ep = to_ep_device(dev); 132 char *direction; 133 134 if (usb_endpoint_xfer_control(ep->desc)) 135 direction = "both"; 136 else if (usb_endpoint_dir_in(ep->desc)) 137 direction = "in"; 138 else 139 direction = "out"; 140 return sprintf(buf, "%s\n", direction); 141 } 142 static DEVICE_ATTR(direction, S_IRUGO, show_ep_direction, NULL); 143 144 static struct attribute *ep_dev_attrs[] = { 145 &dev_attr_bLength.attr, 146 &dev_attr_bEndpointAddress.attr, 147 &dev_attr_bmAttributes.attr, 148 &dev_attr_bInterval.attr, 149 &dev_attr_wMaxPacketSize.attr, 150 &dev_attr_interval.attr, 151 &dev_attr_type.attr, 152 &dev_attr_direction.attr, 153 NULL, 154 }; 155 static struct attribute_group ep_dev_attr_grp = { 156 .attrs = ep_dev_attrs, 157 }; 158 static const struct attribute_group *ep_dev_groups[] = { 159 &ep_dev_attr_grp, 160 NULL 161 }; 162 163 static void ep_device_release(struct device *dev) 164 { 165 struct ep_device *ep_dev = to_ep_device(dev); 166 167 kfree(ep_dev); 168 } 169 170 int usb_create_ep_devs(struct device *parent, 171 struct usb_host_endpoint *endpoint, 172 struct usb_device *udev) 173 { 174 struct ep_device *ep_dev; 175 int retval; 176 177 ep_dev = kzalloc(sizeof(*ep_dev), GFP_KERNEL); 178 if (!ep_dev) { 179 retval = -ENOMEM; 180 goto exit; 181 } 182 183 ep_dev->desc = &endpoint->desc; 184 ep_dev->udev = udev; 185 ep_dev->dev.groups = ep_dev_groups; 186 ep_dev->dev.type = &usb_ep_device_type; 187 ep_dev->dev.parent = parent; 188 ep_dev->dev.release = ep_device_release; 189 dev_set_name(&ep_dev->dev, "ep_%02x", endpoint->desc.bEndpointAddress); 190 device_enable_async_suspend(&ep_dev->dev); 191 192 retval = device_register(&ep_dev->dev); 193 if (retval) 194 goto error_register; 195 196 endpoint->ep_dev = ep_dev; 197 return retval; 198 199 error_register: 200 kfree(ep_dev); 201 exit: 202 return retval; 203 } 204 205 void usb_remove_ep_devs(struct usb_host_endpoint *endpoint) 206 { 207 struct ep_device *ep_dev = endpoint->ep_dev; 208 209 if (ep_dev) { 210 device_unregister(&ep_dev->dev); 211 endpoint->ep_dev = NULL; 212 } 213 } 214