Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * drivers/usb/core/sysfs.c | |
3 | * | |
4 | * (C) Copyright 2002 David Brownell | |
5 | * (C) Copyright 2002,2004 Greg Kroah-Hartman | |
6 | * (C) Copyright 2002,2004 IBM Corp. | |
7 | * | |
8 | * All of the sysfs file attributes for usb devices and interfaces. | |
9 | * | |
10 | */ | |
11 | ||
12 | ||
1da177e4 | 13 | #include <linux/kernel.h> |
2add5229 | 14 | #include <linux/string.h> |
1da177e4 | 15 | #include <linux/usb.h> |
1662e3a7 | 16 | #include <linux/usb/quirks.h> |
1da177e4 LT |
17 | #include "usb.h" |
18 | ||
19 | /* Active configuration fields */ | |
8d8479db | 20 | #define usb_actconfig_show(field, format_string) \ |
d03f254f GKH |
21 | static ssize_t field##_show(struct device *dev, \ |
22 | struct device_attribute *attr, char *buf) \ | |
1da177e4 LT |
23 | { \ |
24 | struct usb_device *udev; \ | |
25 | struct usb_host_config *actconfig; \ | |
232275a0 | 26 | ssize_t rc = 0; \ |
1da177e4 | 27 | \ |
9251644a | 28 | udev = to_usb_device(dev); \ |
232275a0 | 29 | usb_lock_device(udev); \ |
1da177e4 LT |
30 | actconfig = udev->actconfig; \ |
31 | if (actconfig) \ | |
232275a0 | 32 | rc = sprintf(buf, format_string, \ |
8d8479db | 33 | actconfig->desc.field); \ |
232275a0 AS |
34 | usb_unlock_device(udev); \ |
35 | return rc; \ | |
1da177e4 LT |
36 | } \ |
37 | ||
8d8479db SAS |
38 | #define usb_actconfig_attr(field, format_string) \ |
39 | usb_actconfig_show(field, format_string) \ | |
d03f254f | 40 | static DEVICE_ATTR_RO(field) |
1da177e4 | 41 | |
d03f254f GKH |
42 | usb_actconfig_attr(bNumInterfaces, "%2d\n"); |
43 | usb_actconfig_attr(bmAttributes, "%2x\n"); | |
8d8479db | 44 | |
d03f254f | 45 | static ssize_t bMaxPower_show(struct device *dev, |
8d8479db SAS |
46 | struct device_attribute *attr, char *buf) |
47 | { | |
48 | struct usb_device *udev; | |
49 | struct usb_host_config *actconfig; | |
232275a0 | 50 | ssize_t rc = 0; |
8d8479db SAS |
51 | |
52 | udev = to_usb_device(dev); | |
232275a0 | 53 | usb_lock_device(udev); |
8d8479db | 54 | actconfig = udev->actconfig; |
232275a0 AS |
55 | if (actconfig) |
56 | rc = sprintf(buf, "%dmA\n", usb_get_max_power(udev, actconfig)); | |
57 | usb_unlock_device(udev); | |
58 | return rc; | |
8d8479db | 59 | } |
d03f254f | 60 | static DEVICE_ATTR_RO(bMaxPower); |
1da177e4 | 61 | |
d03f254f | 62 | static ssize_t configuration_show(struct device *dev, |
b724ae77 | 63 | struct device_attribute *attr, char *buf) |
1da177e4 LT |
64 | { |
65 | struct usb_device *udev; | |
66 | struct usb_host_config *actconfig; | |
232275a0 | 67 | ssize_t rc = 0; |
1da177e4 | 68 | |
9251644a | 69 | udev = to_usb_device(dev); |
232275a0 | 70 | usb_lock_device(udev); |
1da177e4 | 71 | actconfig = udev->actconfig; |
232275a0 AS |
72 | if (actconfig && actconfig->string) |
73 | rc = sprintf(buf, "%s\n", actconfig->string); | |
74 | usb_unlock_device(udev); | |
75 | return rc; | |
1da177e4 | 76 | } |
d03f254f | 77 | static DEVICE_ATTR_RO(configuration); |
1da177e4 LT |
78 | |
79 | /* configuration value is always present, and r/w */ | |
8d8479db | 80 | usb_actconfig_show(bConfigurationValue, "%u\n"); |
1da177e4 | 81 | |
d03f254f GKH |
82 | static ssize_t bConfigurationValue_store(struct device *dev, |
83 | struct device_attribute *attr, | |
84 | const char *buf, size_t count) | |
1da177e4 | 85 | { |
9251644a | 86 | struct usb_device *udev = to_usb_device(dev); |
1da177e4 LT |
87 | int config, value; |
88 | ||
3f141e2a | 89 | if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255) |
1da177e4 LT |
90 | return -EINVAL; |
91 | usb_lock_device(udev); | |
9251644a | 92 | value = usb_set_configuration(udev, config); |
1da177e4 LT |
93 | usb_unlock_device(udev); |
94 | return (value < 0) ? value : count; | |
95 | } | |
356c05d5 | 96 | static DEVICE_ATTR_IGNORE_LOCKDEP(bConfigurationValue, S_IRUGO | S_IWUSR, |
d03f254f | 97 | bConfigurationValue_show, bConfigurationValue_store); |
1da177e4 LT |
98 | |
99 | /* String fields */ | |
100 | #define usb_string_attr(name) \ | |
d03f254f | 101 | static ssize_t name##_show(struct device *dev, \ |
b724ae77 | 102 | struct device_attribute *attr, char *buf) \ |
1da177e4 LT |
103 | { \ |
104 | struct usb_device *udev; \ | |
da307123 | 105 | int retval; \ |
1da177e4 | 106 | \ |
9251644a | 107 | udev = to_usb_device(dev); \ |
da307123 AS |
108 | usb_lock_device(udev); \ |
109 | retval = sprintf(buf, "%s\n", udev->name); \ | |
110 | usb_unlock_device(udev); \ | |
111 | return retval; \ | |
1da177e4 | 112 | } \ |
d03f254f | 113 | static DEVICE_ATTR_RO(name) |
1da177e4 LT |
114 | |
115 | usb_string_attr(product); | |
116 | usb_string_attr(manufacturer); | |
117 | usb_string_attr(serial); | |
118 | ||
d03f254f GKH |
119 | static ssize_t speed_show(struct device *dev, struct device_attribute *attr, |
120 | char *buf) | |
1da177e4 LT |
121 | { |
122 | struct usb_device *udev; | |
123 | char *speed; | |
124 | ||
9251644a | 125 | udev = to_usb_device(dev); |
1da177e4 LT |
126 | |
127 | switch (udev->speed) { | |
128 | case USB_SPEED_LOW: | |
129 | speed = "1.5"; | |
130 | break; | |
131 | case USB_SPEED_UNKNOWN: | |
132 | case USB_SPEED_FULL: | |
133 | speed = "12"; | |
134 | break; | |
135 | case USB_SPEED_HIGH: | |
136 | speed = "480"; | |
137 | break; | |
551cdbbe | 138 | case USB_SPEED_WIRELESS: |
b132b04e GKH |
139 | speed = "480"; |
140 | break; | |
141 | case USB_SPEED_SUPER: | |
142 | speed = "5000"; | |
143 | break; | |
1da177e4 LT |
144 | default: |
145 | speed = "unknown"; | |
146 | } | |
9251644a | 147 | return sprintf(buf, "%s\n", speed); |
1da177e4 | 148 | } |
d03f254f | 149 | static DEVICE_ATTR_RO(speed); |
1da177e4 | 150 | |
d03f254f GKH |
151 | static ssize_t busnum_show(struct device *dev, struct device_attribute *attr, |
152 | char *buf) | |
83f7d958 AS |
153 | { |
154 | struct usb_device *udev; | |
155 | ||
156 | udev = to_usb_device(dev); | |
157 | return sprintf(buf, "%d\n", udev->bus->busnum); | |
158 | } | |
d03f254f | 159 | static DEVICE_ATTR_RO(busnum); |
83f7d958 | 160 | |
d03f254f GKH |
161 | static ssize_t devnum_show(struct device *dev, struct device_attribute *attr, |
162 | char *buf) | |
1da177e4 LT |
163 | { |
164 | struct usb_device *udev; | |
165 | ||
9251644a ON |
166 | udev = to_usb_device(dev); |
167 | return sprintf(buf, "%d\n", udev->devnum); | |
1da177e4 | 168 | } |
d03f254f | 169 | static DEVICE_ATTR_RO(devnum); |
1da177e4 | 170 | |
d03f254f GKH |
171 | static ssize_t devpath_show(struct device *dev, struct device_attribute *attr, |
172 | char *buf) | |
9af23624 GKH |
173 | { |
174 | struct usb_device *udev; | |
175 | ||
176 | udev = to_usb_device(dev); | |
177 | return sprintf(buf, "%s\n", udev->devpath); | |
178 | } | |
d03f254f | 179 | static DEVICE_ATTR_RO(devpath); |
9af23624 | 180 | |
d03f254f GKH |
181 | static ssize_t version_show(struct device *dev, struct device_attribute *attr, |
182 | char *buf) | |
1da177e4 LT |
183 | { |
184 | struct usb_device *udev; | |
185 | u16 bcdUSB; | |
186 | ||
187 | udev = to_usb_device(dev); | |
188 | bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB); | |
189 | return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff); | |
190 | } | |
d03f254f | 191 | static DEVICE_ATTR_RO(version); |
1da177e4 | 192 | |
d03f254f GKH |
193 | static ssize_t maxchild_show(struct device *dev, struct device_attribute *attr, |
194 | char *buf) | |
1da177e4 LT |
195 | { |
196 | struct usb_device *udev; | |
197 | ||
9251644a ON |
198 | udev = to_usb_device(dev); |
199 | return sprintf(buf, "%d\n", udev->maxchild); | |
1da177e4 | 200 | } |
d03f254f | 201 | static DEVICE_ATTR_RO(maxchild); |
1da177e4 | 202 | |
d03f254f GKH |
203 | static ssize_t quirks_show(struct device *dev, struct device_attribute *attr, |
204 | char *buf) | |
7ceec1f1 ON |
205 | { |
206 | struct usb_device *udev; | |
207 | ||
208 | udev = to_usb_device(dev); | |
209 | return sprintf(buf, "0x%x\n", udev->quirks); | |
210 | } | |
d03f254f | 211 | static DEVICE_ATTR_RO(quirks); |
7ceec1f1 | 212 | |
d03f254f GKH |
213 | static ssize_t avoid_reset_quirk_show(struct device *dev, |
214 | struct device_attribute *attr, char *buf) | |
ef955341 ON |
215 | { |
216 | struct usb_device *udev; | |
217 | ||
218 | udev = to_usb_device(dev); | |
7fda953f | 219 | return sprintf(buf, "%d\n", !!(udev->quirks & USB_QUIRK_RESET)); |
ef955341 ON |
220 | } |
221 | ||
d03f254f GKH |
222 | static ssize_t avoid_reset_quirk_store(struct device *dev, |
223 | struct device_attribute *attr, | |
224 | const char *buf, size_t count) | |
ef955341 ON |
225 | { |
226 | struct usb_device *udev = to_usb_device(dev); | |
7fc2cc32 | 227 | int val; |
ef955341 | 228 | |
7fc2cc32 | 229 | if (sscanf(buf, "%d", &val) != 1 || val < 0 || val > 1) |
ef955341 ON |
230 | return -EINVAL; |
231 | usb_lock_device(udev); | |
7fc2cc32 | 232 | if (val) |
7fda953f | 233 | udev->quirks |= USB_QUIRK_RESET; |
ef955341 | 234 | else |
7fda953f | 235 | udev->quirks &= ~USB_QUIRK_RESET; |
ef955341 ON |
236 | usb_unlock_device(udev); |
237 | return count; | |
238 | } | |
d03f254f | 239 | static DEVICE_ATTR_RW(avoid_reset_quirk); |
ef955341 | 240 | |
d03f254f GKH |
241 | static ssize_t urbnum_show(struct device *dev, struct device_attribute *attr, |
242 | char *buf) | |
4d59d8a1 SS |
243 | { |
244 | struct usb_device *udev; | |
245 | ||
246 | udev = to_usb_device(dev); | |
247 | return sprintf(buf, "%d\n", atomic_read(&udev->urbnum)); | |
248 | } | |
d03f254f | 249 | static DEVICE_ATTR_RO(urbnum); |
4d59d8a1 | 250 | |
d03f254f GKH |
251 | static ssize_t removable_show(struct device *dev, struct device_attribute *attr, |
252 | char *buf) | |
0846e7e9 MG |
253 | { |
254 | struct usb_device *udev; | |
255 | char *state; | |
256 | ||
257 | udev = to_usb_device(dev); | |
258 | ||
259 | switch (udev->removable) { | |
260 | case USB_DEVICE_REMOVABLE: | |
261 | state = "removable"; | |
262 | break; | |
263 | case USB_DEVICE_FIXED: | |
264 | state = "fixed"; | |
265 | break; | |
266 | default: | |
267 | state = "unknown"; | |
268 | } | |
269 | ||
270 | return sprintf(buf, "%s\n", state); | |
271 | } | |
d03f254f | 272 | static DEVICE_ATTR_RO(removable); |
b41a60ec | 273 | |
d03f254f GKH |
274 | static ssize_t ltm_capable_show(struct device *dev, |
275 | struct device_attribute *attr, char *buf) | |
024f117c SS |
276 | { |
277 | if (usb_device_supports_ltm(to_usb_device(dev))) | |
278 | return sprintf(buf, "%s\n", "yes"); | |
279 | return sprintf(buf, "%s\n", "no"); | |
280 | } | |
d03f254f | 281 | static DEVICE_ATTR_RO(ltm_capable); |
024f117c | 282 | |
feccc30d | 283 | #ifdef CONFIG_PM |
b41a60ec | 284 | |
d03f254f GKH |
285 | static ssize_t persist_show(struct device *dev, struct device_attribute *attr, |
286 | char *buf) | |
b41a60ec AS |
287 | { |
288 | struct usb_device *udev = to_usb_device(dev); | |
289 | ||
290 | return sprintf(buf, "%d\n", udev->persist_enabled); | |
291 | } | |
292 | ||
d03f254f GKH |
293 | static ssize_t persist_store(struct device *dev, struct device_attribute *attr, |
294 | const char *buf, size_t count) | |
b41a60ec AS |
295 | { |
296 | struct usb_device *udev = to_usb_device(dev); | |
297 | int value; | |
298 | ||
299 | /* Hubs are always enabled for USB_PERSIST */ | |
300 | if (udev->descriptor.bDeviceClass == USB_CLASS_HUB) | |
301 | return -EPERM; | |
302 | ||
303 | if (sscanf(buf, "%d", &value) != 1) | |
304 | return -EINVAL; | |
0c4db6df AS |
305 | |
306 | usb_lock_device(udev); | |
b41a60ec | 307 | udev->persist_enabled = !!value; |
0c4db6df | 308 | usb_unlock_device(udev); |
b41a60ec AS |
309 | return count; |
310 | } | |
d03f254f | 311 | static DEVICE_ATTR_RW(persist); |
b41a60ec AS |
312 | |
313 | static int add_persist_attributes(struct device *dev) | |
314 | { | |
315 | int rc = 0; | |
316 | ||
317 | if (is_usb_device(dev)) { | |
318 | struct usb_device *udev = to_usb_device(dev); | |
319 | ||
feccc30d AS |
320 | /* Hubs are automatically enabled for USB_PERSIST, |
321 | * no point in creating the attribute file. | |
322 | */ | |
323 | if (udev->descriptor.bDeviceClass != USB_CLASS_HUB) | |
324 | rc = sysfs_add_file_to_group(&dev->kobj, | |
325 | &dev_attr_persist.attr, | |
045cac6b | 326 | power_group_name); |
b41a60ec AS |
327 | } |
328 | return rc; | |
329 | } | |
330 | ||
331 | static void remove_persist_attributes(struct device *dev) | |
332 | { | |
333 | sysfs_remove_file_from_group(&dev->kobj, | |
334 | &dev_attr_persist.attr, | |
045cac6b | 335 | power_group_name); |
b41a60ec | 336 | } |
b41a60ec AS |
337 | #else |
338 | ||
339 | #define add_persist_attributes(dev) 0 | |
340 | #define remove_persist_attributes(dev) do {} while (0) | |
341 | ||
feccc30d | 342 | #endif /* CONFIG_PM */ |
b41a60ec | 343 | |
84ebc102 | 344 | #ifdef CONFIG_PM_RUNTIME |
19c26239 | 345 | |
d03f254f GKH |
346 | static ssize_t connected_duration_show(struct device *dev, |
347 | struct device_attribute *attr, char *buf) | |
15123006 SS |
348 | { |
349 | struct usb_device *udev = to_usb_device(dev); | |
350 | ||
351 | return sprintf(buf, "%u\n", | |
352 | jiffies_to_msecs(jiffies - udev->connect_time)); | |
353 | } | |
d03f254f | 354 | static DEVICE_ATTR_RO(connected_duration); |
15123006 SS |
355 | |
356 | /* | |
357 | * If the device is resumed, the last time the device was suspended has | |
358 | * been pre-subtracted from active_duration. We add the current time to | |
359 | * get the duration that the device was actually active. | |
360 | * | |
361 | * If the device is suspended, the active_duration is up-to-date. | |
362 | */ | |
d03f254f GKH |
363 | static ssize_t active_duration_show(struct device *dev, |
364 | struct device_attribute *attr, char *buf) | |
15123006 SS |
365 | { |
366 | struct usb_device *udev = to_usb_device(dev); | |
367 | int duration; | |
368 | ||
369 | if (udev->state != USB_STATE_SUSPENDED) | |
370 | duration = jiffies_to_msecs(jiffies + udev->active_duration); | |
371 | else | |
372 | duration = jiffies_to_msecs(udev->active_duration); | |
373 | return sprintf(buf, "%u\n", duration); | |
374 | } | |
d03f254f | 375 | static DEVICE_ATTR_RO(active_duration); |
15123006 | 376 | |
d03f254f GKH |
377 | static ssize_t autosuspend_show(struct device *dev, |
378 | struct device_attribute *attr, char *buf) | |
19c26239 | 379 | { |
fcc4a01e | 380 | return sprintf(buf, "%d\n", dev->power.autosuspend_delay / 1000); |
19c26239 AS |
381 | } |
382 | ||
d03f254f GKH |
383 | static ssize_t autosuspend_store(struct device *dev, |
384 | struct device_attribute *attr, const char *buf, | |
385 | size_t count) | |
19c26239 | 386 | { |
fcc4a01e | 387 | int value; |
19c26239 | 388 | |
fcc4a01e AS |
389 | if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/1000 || |
390 | value <= -INT_MAX/1000) | |
19c26239 | 391 | return -EINVAL; |
19c26239 | 392 | |
fcc4a01e | 393 | pm_runtime_set_autosuspend_delay(dev, value * 1000); |
19c26239 AS |
394 | return count; |
395 | } | |
d03f254f | 396 | static DEVICE_ATTR_RW(autosuspend); |
19c26239 | 397 | |
2add5229 AS |
398 | static const char on_string[] = "on"; |
399 | static const char auto_string[] = "auto"; | |
2add5229 | 400 | |
a9030986 AS |
401 | static void warn_level(void) { |
402 | static int level_warned; | |
403 | ||
404 | if (!level_warned) { | |
405 | level_warned = 1; | |
406 | printk(KERN_WARNING "WARNING! power/level is deprecated; " | |
407 | "use power/control instead\n"); | |
408 | } | |
409 | } | |
410 | ||
d03f254f GKH |
411 | static ssize_t level_show(struct device *dev, struct device_attribute *attr, |
412 | char *buf) | |
2add5229 AS |
413 | { |
414 | struct usb_device *udev = to_usb_device(dev); | |
415 | const char *p = auto_string; | |
416 | ||
a9030986 | 417 | warn_level(); |
9e18c821 | 418 | if (udev->state != USB_STATE_SUSPENDED && !udev->dev.power.runtime_auto) |
8e4ceb38 | 419 | p = on_string; |
2add5229 AS |
420 | return sprintf(buf, "%s\n", p); |
421 | } | |
422 | ||
d03f254f GKH |
423 | static ssize_t level_store(struct device *dev, struct device_attribute *attr, |
424 | const char *buf, size_t count) | |
2add5229 AS |
425 | { |
426 | struct usb_device *udev = to_usb_device(dev); | |
427 | int len = count; | |
428 | char *cp; | |
9e18c821 | 429 | int rc = count; |
2add5229 | 430 | |
a9030986 | 431 | warn_level(); |
2add5229 AS |
432 | cp = memchr(buf, '\n', count); |
433 | if (cp) | |
434 | len = cp - buf; | |
435 | ||
436 | usb_lock_device(udev); | |
437 | ||
2add5229 | 438 | if (len == sizeof on_string - 1 && |
088f7fec | 439 | strncmp(buf, on_string, len) == 0) |
9e18c821 | 440 | usb_disable_autosuspend(udev); |
2add5229 | 441 | |
088f7fec AS |
442 | else if (len == sizeof auto_string - 1 && |
443 | strncmp(buf, auto_string, len) == 0) | |
9e18c821 | 444 | usb_enable_autosuspend(udev); |
2add5229 | 445 | |
088f7fec | 446 | else |
2add5229 AS |
447 | rc = -EINVAL; |
448 | ||
449 | usb_unlock_device(udev); | |
9e18c821 | 450 | return rc; |
2add5229 | 451 | } |
d03f254f | 452 | static DEVICE_ATTR_RW(level); |
2add5229 | 453 | |
d03f254f GKH |
454 | static ssize_t usb2_hardware_lpm_show(struct device *dev, |
455 | struct device_attribute *attr, char *buf) | |
c1045e87 AX |
456 | { |
457 | struct usb_device *udev = to_usb_device(dev); | |
458 | const char *p; | |
459 | ||
460 | if (udev->usb2_hw_lpm_enabled == 1) | |
461 | p = "enabled"; | |
462 | else | |
463 | p = "disabled"; | |
464 | ||
465 | return sprintf(buf, "%s\n", p); | |
466 | } | |
467 | ||
d03f254f GKH |
468 | static ssize_t usb2_hardware_lpm_store(struct device *dev, |
469 | struct device_attribute *attr, | |
470 | const char *buf, size_t count) | |
c1045e87 AX |
471 | { |
472 | struct usb_device *udev = to_usb_device(dev); | |
473 | bool value; | |
474 | int ret; | |
475 | ||
476 | usb_lock_device(udev); | |
477 | ||
478 | ret = strtobool(buf, &value); | |
479 | ||
480 | if (!ret) | |
481 | ret = usb_set_usb2_hardware_lpm(udev, value); | |
482 | ||
483 | usb_unlock_device(udev); | |
484 | ||
485 | if (!ret) | |
486 | return count; | |
487 | ||
488 | return ret; | |
489 | } | |
d03f254f | 490 | static DEVICE_ATTR_RW(usb2_hardware_lpm); |
c1045e87 | 491 | |
d03f254f GKH |
492 | static ssize_t usb2_lpm_l1_timeout_show(struct device *dev, |
493 | struct device_attribute *attr, | |
494 | char *buf) | |
17f34867 MN |
495 | { |
496 | struct usb_device *udev = to_usb_device(dev); | |
497 | return sprintf(buf, "%d\n", udev->l1_params.timeout); | |
498 | } | |
499 | ||
d03f254f GKH |
500 | static ssize_t usb2_lpm_l1_timeout_store(struct device *dev, |
501 | struct device_attribute *attr, | |
502 | const char *buf, size_t count) | |
17f34867 MN |
503 | { |
504 | struct usb_device *udev = to_usb_device(dev); | |
505 | u16 timeout; | |
506 | ||
507 | if (kstrtou16(buf, 0, &timeout)) | |
508 | return -EINVAL; | |
509 | ||
510 | udev->l1_params.timeout = timeout; | |
511 | ||
512 | return count; | |
513 | } | |
d03f254f | 514 | static DEVICE_ATTR_RW(usb2_lpm_l1_timeout); |
17f34867 | 515 | |
d03f254f GKH |
516 | static ssize_t usb2_lpm_besl_show(struct device *dev, |
517 | struct device_attribute *attr, char *buf) | |
17f34867 MN |
518 | { |
519 | struct usb_device *udev = to_usb_device(dev); | |
520 | return sprintf(buf, "%d\n", udev->l1_params.besl); | |
521 | } | |
522 | ||
d03f254f GKH |
523 | static ssize_t usb2_lpm_besl_store(struct device *dev, |
524 | struct device_attribute *attr, | |
525 | const char *buf, size_t count) | |
17f34867 MN |
526 | { |
527 | struct usb_device *udev = to_usb_device(dev); | |
528 | u8 besl; | |
529 | ||
530 | if (kstrtou8(buf, 0, &besl) || besl > 15) | |
531 | return -EINVAL; | |
532 | ||
533 | udev->l1_params.besl = besl; | |
534 | ||
535 | return count; | |
536 | } | |
d03f254f | 537 | static DEVICE_ATTR_RW(usb2_lpm_besl); |
17f34867 | 538 | |
c1045e87 AX |
539 | static struct attribute *usb2_hardware_lpm_attr[] = { |
540 | &dev_attr_usb2_hardware_lpm.attr, | |
17f34867 MN |
541 | &dev_attr_usb2_lpm_l1_timeout.attr, |
542 | &dev_attr_usb2_lpm_besl.attr, | |
c1045e87 AX |
543 | NULL, |
544 | }; | |
545 | static struct attribute_group usb2_hardware_lpm_attr_group = { | |
546 | .name = power_group_name, | |
547 | .attrs = usb2_hardware_lpm_attr, | |
548 | }; | |
549 | ||
045cac6b AS |
550 | static struct attribute *power_attrs[] = { |
551 | &dev_attr_autosuspend.attr, | |
552 | &dev_attr_level.attr, | |
553 | &dev_attr_connected_duration.attr, | |
554 | &dev_attr_active_duration.attr, | |
555 | NULL, | |
556 | }; | |
557 | static struct attribute_group power_attr_group = { | |
558 | .name = power_group_name, | |
559 | .attrs = power_attrs, | |
560 | }; | |
561 | ||
19c26239 AS |
562 | static int add_power_attributes(struct device *dev) |
563 | { | |
564 | int rc = 0; | |
565 | ||
c1045e87 AX |
566 | if (is_usb_device(dev)) { |
567 | struct usb_device *udev = to_usb_device(dev); | |
045cac6b | 568 | rc = sysfs_merge_group(&dev->kobj, &power_attr_group); |
c1045e87 AX |
569 | if (udev->usb2_hw_lpm_capable == 1) |
570 | rc = sysfs_merge_group(&dev->kobj, | |
571 | &usb2_hardware_lpm_attr_group); | |
572 | } | |
573 | ||
19c26239 AS |
574 | return rc; |
575 | } | |
576 | ||
577 | static void remove_power_attributes(struct device *dev) | |
578 | { | |
c1045e87 | 579 | sysfs_unmerge_group(&dev->kobj, &usb2_hardware_lpm_attr_group); |
045cac6b | 580 | sysfs_unmerge_group(&dev->kobj, &power_attr_group); |
19c26239 AS |
581 | } |
582 | ||
583 | #else | |
584 | ||
585 | #define add_power_attributes(dev) 0 | |
586 | #define remove_power_attributes(dev) do {} while (0) | |
587 | ||
84ebc102 | 588 | #endif /* CONFIG_PM_RUNTIME */ |
19c26239 | 589 | |
b41a60ec | 590 | |
1da177e4 LT |
591 | /* Descriptor fields */ |
592 | #define usb_descriptor_attr_le16(field, format_string) \ | |
593 | static ssize_t \ | |
d03f254f | 594 | field##_show(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 595 | char *buf) \ |
1da177e4 LT |
596 | { \ |
597 | struct usb_device *udev; \ | |
598 | \ | |
9251644a ON |
599 | udev = to_usb_device(dev); \ |
600 | return sprintf(buf, format_string, \ | |
1da177e4 LT |
601 | le16_to_cpu(udev->descriptor.field)); \ |
602 | } \ | |
d03f254f | 603 | static DEVICE_ATTR_RO(field) |
1da177e4 | 604 | |
d03f254f GKH |
605 | usb_descriptor_attr_le16(idVendor, "%04x\n"); |
606 | usb_descriptor_attr_le16(idProduct, "%04x\n"); | |
607 | usb_descriptor_attr_le16(bcdDevice, "%04x\n"); | |
1da177e4 LT |
608 | |
609 | #define usb_descriptor_attr(field, format_string) \ | |
610 | static ssize_t \ | |
d03f254f | 611 | field##_show(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 612 | char *buf) \ |
1da177e4 LT |
613 | { \ |
614 | struct usb_device *udev; \ | |
615 | \ | |
9251644a ON |
616 | udev = to_usb_device(dev); \ |
617 | return sprintf(buf, format_string, udev->descriptor.field); \ | |
1da177e4 | 618 | } \ |
d03f254f | 619 | static DEVICE_ATTR_RO(field) |
1da177e4 | 620 | |
d03f254f GKH |
621 | usb_descriptor_attr(bDeviceClass, "%02x\n"); |
622 | usb_descriptor_attr(bDeviceSubClass, "%02x\n"); | |
623 | usb_descriptor_attr(bDeviceProtocol, "%02x\n"); | |
624 | usb_descriptor_attr(bNumConfigurations, "%d\n"); | |
625 | usb_descriptor_attr(bMaxPacketSize0, "%d\n"); | |
e03f2e8a IPG |
626 | |
627 | ||
628 | /* show if the device is authorized (1) or not (0) */ | |
d03f254f GKH |
629 | static ssize_t authorized_show(struct device *dev, |
630 | struct device_attribute *attr, char *buf) | |
e03f2e8a IPG |
631 | { |
632 | struct usb_device *usb_dev = to_usb_device(dev); | |
633 | return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized); | |
634 | } | |
635 | ||
e03f2e8a IPG |
636 | /* |
637 | * Authorize a device to be used in the system | |
638 | * | |
639 | * Writing a 0 deauthorizes the device, writing a 1 authorizes it. | |
640 | */ | |
d03f254f GKH |
641 | static ssize_t authorized_store(struct device *dev, |
642 | struct device_attribute *attr, const char *buf, | |
643 | size_t size) | |
e03f2e8a IPG |
644 | { |
645 | ssize_t result; | |
646 | struct usb_device *usb_dev = to_usb_device(dev); | |
647 | unsigned val; | |
648 | result = sscanf(buf, "%u\n", &val); | |
649 | if (result != 1) | |
650 | result = -EINVAL; | |
651 | else if (val == 0) | |
652 | result = usb_deauthorize_device(usb_dev); | |
653 | else | |
654 | result = usb_authorize_device(usb_dev); | |
655 | return result < 0? result : size; | |
656 | } | |
d03f254f GKH |
657 | static DEVICE_ATTR_IGNORE_LOCKDEP(authorized, S_IRUGO | S_IWUSR, |
658 | authorized_show, authorized_store); | |
e03f2e8a | 659 | |
253e0572 | 660 | /* "Safely remove a device" */ |
d03f254f GKH |
661 | static ssize_t remove_store(struct device *dev, struct device_attribute *attr, |
662 | const char *buf, size_t count) | |
253e0572 AS |
663 | { |
664 | struct usb_device *udev = to_usb_device(dev); | |
665 | int rc = 0; | |
666 | ||
667 | usb_lock_device(udev); | |
668 | if (udev->state != USB_STATE_NOTATTACHED) { | |
669 | ||
670 | /* To avoid races, first unconfigure and then remove */ | |
671 | usb_set_configuration(udev, -1); | |
672 | rc = usb_remove_device(udev); | |
673 | } | |
674 | if (rc == 0) | |
675 | rc = count; | |
676 | usb_unlock_device(udev); | |
677 | return rc; | |
678 | } | |
d03f254f | 679 | static DEVICE_ATTR_IGNORE_LOCKDEP(remove, S_IWUSR, NULL, remove_store); |
253e0572 | 680 | |
e03f2e8a | 681 | |
1da177e4 LT |
682 | static struct attribute *dev_attrs[] = { |
683 | /* current configuration's attributes */ | |
b6eb2d84 | 684 | &dev_attr_configuration.attr, |
1da177e4 LT |
685 | &dev_attr_bNumInterfaces.attr, |
686 | &dev_attr_bConfigurationValue.attr, | |
687 | &dev_attr_bmAttributes.attr, | |
688 | &dev_attr_bMaxPower.attr, | |
689 | /* device attributes */ | |
9af23624 | 690 | &dev_attr_urbnum.attr, |
1da177e4 LT |
691 | &dev_attr_idVendor.attr, |
692 | &dev_attr_idProduct.attr, | |
693 | &dev_attr_bcdDevice.attr, | |
694 | &dev_attr_bDeviceClass.attr, | |
695 | &dev_attr_bDeviceSubClass.attr, | |
696 | &dev_attr_bDeviceProtocol.attr, | |
697 | &dev_attr_bNumConfigurations.attr, | |
cf5910bb | 698 | &dev_attr_bMaxPacketSize0.attr, |
1da177e4 | 699 | &dev_attr_speed.attr, |
83f7d958 | 700 | &dev_attr_busnum.attr, |
1da177e4 | 701 | &dev_attr_devnum.attr, |
9af23624 | 702 | &dev_attr_devpath.attr, |
1da177e4 LT |
703 | &dev_attr_version.attr, |
704 | &dev_attr_maxchild.attr, | |
7ceec1f1 | 705 | &dev_attr_quirks.attr, |
ef955341 | 706 | &dev_attr_avoid_reset_quirk.attr, |
e03f2e8a | 707 | &dev_attr_authorized.attr, |
253e0572 | 708 | &dev_attr_remove.attr, |
0846e7e9 | 709 | &dev_attr_removable.attr, |
024f117c | 710 | &dev_attr_ltm_capable.attr, |
1da177e4 LT |
711 | NULL, |
712 | }; | |
713 | static struct attribute_group dev_attr_grp = { | |
714 | .attrs = dev_attrs, | |
715 | }; | |
716 | ||
2e5f10e4 AS |
717 | /* When modifying this list, be sure to modify dev_string_attrs_are_visible() |
718 | * accordingly. | |
719 | */ | |
720 | static struct attribute *dev_string_attrs[] = { | |
721 | &dev_attr_manufacturer.attr, | |
722 | &dev_attr_product.attr, | |
723 | &dev_attr_serial.attr, | |
724 | NULL | |
725 | }; | |
726 | ||
587a1f16 | 727 | static umode_t dev_string_attrs_are_visible(struct kobject *kobj, |
2e5f10e4 AS |
728 | struct attribute *a, int n) |
729 | { | |
a864e3aa HS |
730 | struct device *dev = container_of(kobj, struct device, kobj); |
731 | struct usb_device *udev = to_usb_device(dev); | |
2e5f10e4 AS |
732 | |
733 | if (a == &dev_attr_manufacturer.attr) { | |
734 | if (udev->manufacturer == NULL) | |
735 | return 0; | |
736 | } else if (a == &dev_attr_product.attr) { | |
737 | if (udev->product == NULL) | |
738 | return 0; | |
739 | } else if (a == &dev_attr_serial.attr) { | |
740 | if (udev->serial == NULL) | |
741 | return 0; | |
742 | } | |
743 | return a->mode; | |
744 | } | |
745 | ||
746 | static struct attribute_group dev_string_attr_grp = { | |
747 | .attrs = dev_string_attrs, | |
748 | .is_visible = dev_string_attrs_are_visible, | |
749 | }; | |
750 | ||
a4dbd674 | 751 | const struct attribute_group *usb_device_groups[] = { |
2e5f10e4 AS |
752 | &dev_attr_grp, |
753 | &dev_string_attr_grp, | |
754 | NULL | |
755 | }; | |
756 | ||
69d42a78 AS |
757 | /* Binary descriptors */ |
758 | ||
759 | static ssize_t | |
2c3c8bea CW |
760 | read_descriptors(struct file *filp, struct kobject *kobj, |
761 | struct bin_attribute *attr, | |
69d42a78 AS |
762 | char *buf, loff_t off, size_t count) |
763 | { | |
a864e3aa HS |
764 | struct device *dev = container_of(kobj, struct device, kobj); |
765 | struct usb_device *udev = to_usb_device(dev); | |
69d42a78 AS |
766 | size_t nleft = count; |
767 | size_t srclen, n; | |
217a9081 AS |
768 | int cfgno; |
769 | void *src; | |
69d42a78 | 770 | |
217a9081 AS |
771 | /* The binary attribute begins with the device descriptor. |
772 | * Following that are the raw descriptor entries for all the | |
773 | * configurations (config plus subsidiary descriptors). | |
69d42a78 | 774 | */ |
232275a0 | 775 | usb_lock_device(udev); |
217a9081 AS |
776 | for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations && |
777 | nleft > 0; ++cfgno) { | |
778 | if (cfgno < 0) { | |
779 | src = &udev->descriptor; | |
780 | srclen = sizeof(struct usb_device_descriptor); | |
781 | } else { | |
782 | src = udev->rawdescriptors[cfgno]; | |
783 | srclen = __le16_to_cpu(udev->config[cfgno].desc. | |
784 | wTotalLength); | |
785 | } | |
69d42a78 | 786 | if (off < srclen) { |
217a9081 AS |
787 | n = min(nleft, srclen - (size_t) off); |
788 | memcpy(buf, src + off, n); | |
69d42a78 | 789 | nleft -= n; |
217a9081 AS |
790 | buf += n; |
791 | off = 0; | |
792 | } else { | |
793 | off -= srclen; | |
69d42a78 AS |
794 | } |
795 | } | |
232275a0 | 796 | usb_unlock_device(udev); |
69d42a78 AS |
797 | return count - nleft; |
798 | } | |
799 | ||
800 | static struct bin_attribute dev_bin_attr_descriptors = { | |
801 | .attr = {.name = "descriptors", .mode = 0444}, | |
802 | .read = read_descriptors, | |
803 | .size = 18 + 65535, /* dev descr + max-size raw descriptor */ | |
804 | }; | |
805 | ||
1b21d5e1 | 806 | int usb_create_sysfs_dev_files(struct usb_device *udev) |
1da177e4 LT |
807 | { |
808 | struct device *dev = &udev->dev; | |
1b21d5e1 | 809 | int retval; |
1da177e4 | 810 | |
69d42a78 AS |
811 | retval = device_create_bin_file(dev, &dev_bin_attr_descriptors); |
812 | if (retval) | |
813 | goto error; | |
814 | ||
b41a60ec AS |
815 | retval = add_persist_attributes(dev); |
816 | if (retval) | |
817 | goto error; | |
818 | ||
19c26239 AS |
819 | retval = add_power_attributes(dev); |
820 | if (retval) | |
821 | goto error; | |
3b23dd6f | 822 | return retval; |
1b21d5e1 | 823 | error: |
aa084f3e | 824 | usb_remove_sysfs_dev_files(udev); |
1b21d5e1 | 825 | return retval; |
1da177e4 LT |
826 | } |
827 | ||
9251644a | 828 | void usb_remove_sysfs_dev_files(struct usb_device *udev) |
1da177e4 LT |
829 | { |
830 | struct device *dev = &udev->dev; | |
831 | ||
19c26239 | 832 | remove_power_attributes(dev); |
b41a60ec | 833 | remove_persist_attributes(dev); |
69d42a78 | 834 | device_remove_bin_file(dev, &dev_bin_attr_descriptors); |
1da177e4 LT |
835 | } |
836 | ||
165fe97e CN |
837 | /* Interface Accociation Descriptor fields */ |
838 | #define usb_intf_assoc_attr(field, format_string) \ | |
839 | static ssize_t \ | |
d03f254f | 840 | iad_##field##_show(struct device *dev, struct device_attribute *attr, \ |
165fe97e CN |
841 | char *buf) \ |
842 | { \ | |
2c044a48 | 843 | struct usb_interface *intf = to_usb_interface(dev); \ |
165fe97e | 844 | \ |
2c044a48 GKH |
845 | return sprintf(buf, format_string, \ |
846 | intf->intf_assoc->field); \ | |
165fe97e | 847 | } \ |
d03f254f | 848 | static DEVICE_ATTR_RO(iad_##field) |
165fe97e | 849 | |
d03f254f GKH |
850 | usb_intf_assoc_attr(bFirstInterface, "%02x\n"); |
851 | usb_intf_assoc_attr(bInterfaceCount, "%02d\n"); | |
852 | usb_intf_assoc_attr(bFunctionClass, "%02x\n"); | |
853 | usb_intf_assoc_attr(bFunctionSubClass, "%02x\n"); | |
854 | usb_intf_assoc_attr(bFunctionProtocol, "%02x\n"); | |
165fe97e | 855 | |
1da177e4 LT |
856 | /* Interface fields */ |
857 | #define usb_intf_attr(field, format_string) \ | |
858 | static ssize_t \ | |
d03f254f | 859 | field##_show(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 860 | char *buf) \ |
1da177e4 | 861 | { \ |
9251644a | 862 | struct usb_interface *intf = to_usb_interface(dev); \ |
1da177e4 | 863 | \ |
9251644a | 864 | return sprintf(buf, format_string, \ |
b724ae77 | 865 | intf->cur_altsetting->desc.field); \ |
1da177e4 | 866 | } \ |
d03f254f | 867 | static DEVICE_ATTR_RO(field) |
1da177e4 | 868 | |
d03f254f GKH |
869 | usb_intf_attr(bInterfaceNumber, "%02x\n"); |
870 | usb_intf_attr(bAlternateSetting, "%2d\n"); | |
871 | usb_intf_attr(bNumEndpoints, "%02x\n"); | |
872 | usb_intf_attr(bInterfaceClass, "%02x\n"); | |
873 | usb_intf_attr(bInterfaceSubClass, "%02x\n"); | |
874 | usb_intf_attr(bInterfaceProtocol, "%02x\n"); | |
1da177e4 | 875 | |
d03f254f GKH |
876 | static ssize_t interface_show(struct device *dev, struct device_attribute *attr, |
877 | char *buf) | |
1da177e4 LT |
878 | { |
879 | struct usb_interface *intf; | |
2e5f10e4 | 880 | char *string; |
1da177e4 | 881 | |
9251644a | 882 | intf = to_usb_interface(dev); |
232275a0 | 883 | string = ACCESS_ONCE(intf->cur_altsetting->string); |
2e5f10e4 | 884 | if (!string) |
1da177e4 | 885 | return 0; |
2e5f10e4 | 886 | return sprintf(buf, "%s\n", string); |
1da177e4 | 887 | } |
d03f254f | 888 | static DEVICE_ATTR_RO(interface); |
1da177e4 | 889 | |
d03f254f GKH |
890 | static ssize_t modalias_show(struct device *dev, struct device_attribute *attr, |
891 | char *buf) | |
360b52b0 GK |
892 | { |
893 | struct usb_interface *intf; | |
894 | struct usb_device *udev; | |
7521803d | 895 | struct usb_host_interface *alt; |
360b52b0 GK |
896 | |
897 | intf = to_usb_interface(dev); | |
898 | udev = interface_to_usbdev(intf); | |
232275a0 | 899 | alt = ACCESS_ONCE(intf->cur_altsetting); |
7521803d GKH |
900 | |
901 | return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X" | |
81df2d59 | 902 | "ic%02Xisc%02Xip%02Xin%02X\n", |
7521803d GKH |
903 | le16_to_cpu(udev->descriptor.idVendor), |
904 | le16_to_cpu(udev->descriptor.idProduct), | |
905 | le16_to_cpu(udev->descriptor.bcdDevice), | |
906 | udev->descriptor.bDeviceClass, | |
907 | udev->descriptor.bDeviceSubClass, | |
908 | udev->descriptor.bDeviceProtocol, | |
909 | alt->desc.bInterfaceClass, | |
910 | alt->desc.bInterfaceSubClass, | |
81df2d59 BM |
911 | alt->desc.bInterfaceProtocol, |
912 | alt->desc.bInterfaceNumber); | |
360b52b0 | 913 | } |
d03f254f | 914 | static DEVICE_ATTR_RO(modalias); |
360b52b0 | 915 | |
d03f254f GKH |
916 | static ssize_t supports_autosuspend_show(struct device *dev, |
917 | struct device_attribute *attr, | |
918 | char *buf) | |
49e7cc84 | 919 | { |
232275a0 | 920 | int s; |
49e7cc84 | 921 | |
232275a0 | 922 | device_lock(dev); |
49e7cc84 | 923 | /* Devices will be autosuspended even when an interface isn't claimed */ |
232275a0 AS |
924 | s = (!dev->driver || to_usb_driver(dev->driver)->supports_autosuspend); |
925 | device_unlock(dev); | |
49e7cc84 | 926 | |
232275a0 | 927 | return sprintf(buf, "%u\n", s); |
49e7cc84 | 928 | } |
d03f254f | 929 | static DEVICE_ATTR_RO(supports_autosuspend); |
49e7cc84 | 930 | |
1da177e4 LT |
931 | static struct attribute *intf_attrs[] = { |
932 | &dev_attr_bInterfaceNumber.attr, | |
933 | &dev_attr_bAlternateSetting.attr, | |
934 | &dev_attr_bNumEndpoints.attr, | |
935 | &dev_attr_bInterfaceClass.attr, | |
936 | &dev_attr_bInterfaceSubClass.attr, | |
937 | &dev_attr_bInterfaceProtocol.attr, | |
360b52b0 | 938 | &dev_attr_modalias.attr, |
49e7cc84 | 939 | &dev_attr_supports_autosuspend.attr, |
1da177e4 LT |
940 | NULL, |
941 | }; | |
942 | static struct attribute_group intf_attr_grp = { | |
943 | .attrs = intf_attrs, | |
944 | }; | |
945 | ||
2e5f10e4 AS |
946 | static struct attribute *intf_assoc_attrs[] = { |
947 | &dev_attr_iad_bFirstInterface.attr, | |
948 | &dev_attr_iad_bInterfaceCount.attr, | |
949 | &dev_attr_iad_bFunctionClass.attr, | |
950 | &dev_attr_iad_bFunctionSubClass.attr, | |
951 | &dev_attr_iad_bFunctionProtocol.attr, | |
952 | NULL, | |
953 | }; | |
954 | ||
587a1f16 | 955 | static umode_t intf_assoc_attrs_are_visible(struct kobject *kobj, |
2e5f10e4 AS |
956 | struct attribute *a, int n) |
957 | { | |
a864e3aa HS |
958 | struct device *dev = container_of(kobj, struct device, kobj); |
959 | struct usb_interface *intf = to_usb_interface(dev); | |
2e5f10e4 AS |
960 | |
961 | if (intf->intf_assoc == NULL) | |
962 | return 0; | |
963 | return a->mode; | |
964 | } | |
965 | ||
966 | static struct attribute_group intf_assoc_attr_grp = { | |
967 | .attrs = intf_assoc_attrs, | |
968 | .is_visible = intf_assoc_attrs_are_visible, | |
969 | }; | |
970 | ||
a4dbd674 | 971 | const struct attribute_group *usb_interface_groups[] = { |
2e5f10e4 AS |
972 | &intf_attr_grp, |
973 | &intf_assoc_attr_grp, | |
974 | NULL | |
975 | }; | |
976 | ||
643de624 | 977 | void usb_create_sysfs_intf_files(struct usb_interface *intf) |
1da177e4 | 978 | { |
4f62efe6 AS |
979 | struct usb_device *udev = interface_to_usbdev(intf); |
980 | struct usb_host_interface *alt = intf->cur_altsetting; | |
981 | ||
352d0263 | 982 | if (intf->sysfs_files_created || intf->unregistering) |
643de624 | 983 | return; |
1da177e4 | 984 | |
643de624 | 985 | if (!alt->string && !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS)) |
4f62efe6 | 986 | alt->string = usb_cache_string(udev, alt->desc.iInterface); |
643de624 MN |
987 | if (alt->string && device_create_file(&intf->dev, &dev_attr_interface)) |
988 | ; /* We don't actually care if the function fails. */ | |
7e61559f | 989 | intf->sysfs_files_created = 1; |
1da177e4 LT |
990 | } |
991 | ||
9251644a | 992 | void usb_remove_sysfs_intf_files(struct usb_interface *intf) |
1da177e4 | 993 | { |
7e61559f AS |
994 | if (!intf->sysfs_files_created) |
995 | return; | |
92b0da15 | 996 | |
92b0da15 | 997 | device_remove_file(&intf->dev, &dev_attr_interface); |
7e61559f | 998 | intf->sysfs_files_created = 0; |
1da177e4 | 999 | } |