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