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