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