1 // SPDX-License-Identifier: GPL-2.0
3 * xhci-debugfs.c - xHCI debugfs interface
5 * Copyright (C) 2017 Intel Corporation
7 * Author: Lu Baolu <baolu.lu@linux.intel.com>
10 #include <linux/slab.h>
11 #include <linux/uaccess.h>
14 #include "xhci-debugfs.h"
16 static const struct debugfs_reg32 xhci_cap_regs[] = {
17 dump_register(CAPLENGTH),
18 dump_register(HCSPARAMS1),
19 dump_register(HCSPARAMS2),
20 dump_register(HCSPARAMS3),
21 dump_register(HCCPARAMS1),
22 dump_register(DOORBELLOFF),
23 dump_register(RUNTIMEOFF),
24 dump_register(HCCPARAMS2),
27 static const struct debugfs_reg32 xhci_op_regs[] = {
28 dump_register(USBCMD),
29 dump_register(USBSTS),
30 dump_register(PAGESIZE),
31 dump_register(DNCTRL),
33 dump_register(DCBAAP_LOW),
34 dump_register(DCBAAP_HIGH),
35 dump_register(CONFIG),
38 static const struct debugfs_reg32 xhci_runtime_regs[] = {
39 dump_register(MFINDEX),
40 dump_register(IR0_IMAN),
41 dump_register(IR0_IMOD),
42 dump_register(IR0_ERSTSZ),
43 dump_register(IR0_ERSTBA_LOW),
44 dump_register(IR0_ERSTBA_HIGH),
45 dump_register(IR0_ERDP_LOW),
46 dump_register(IR0_ERDP_HIGH),
49 static const struct debugfs_reg32 xhci_extcap_legsup[] = {
50 dump_register(EXTCAP_USBLEGSUP),
51 dump_register(EXTCAP_USBLEGCTLSTS),
54 static const struct debugfs_reg32 xhci_extcap_protocol[] = {
55 dump_register(EXTCAP_REVISION),
56 dump_register(EXTCAP_NAME),
57 dump_register(EXTCAP_PORTINFO),
58 dump_register(EXTCAP_PORTTYPE),
59 dump_register(EXTCAP_MANTISSA1),
60 dump_register(EXTCAP_MANTISSA2),
61 dump_register(EXTCAP_MANTISSA3),
62 dump_register(EXTCAP_MANTISSA4),
63 dump_register(EXTCAP_MANTISSA5),
64 dump_register(EXTCAP_MANTISSA6),
67 static const struct debugfs_reg32 xhci_extcap_dbc[] = {
68 dump_register(EXTCAP_DBC_CAPABILITY),
69 dump_register(EXTCAP_DBC_DOORBELL),
70 dump_register(EXTCAP_DBC_ERSTSIZE),
71 dump_register(EXTCAP_DBC_ERST_LOW),
72 dump_register(EXTCAP_DBC_ERST_HIGH),
73 dump_register(EXTCAP_DBC_ERDP_LOW),
74 dump_register(EXTCAP_DBC_ERDP_HIGH),
75 dump_register(EXTCAP_DBC_CONTROL),
76 dump_register(EXTCAP_DBC_STATUS),
77 dump_register(EXTCAP_DBC_PORTSC),
78 dump_register(EXTCAP_DBC_CONT_LOW),
79 dump_register(EXTCAP_DBC_CONT_HIGH),
80 dump_register(EXTCAP_DBC_DEVINFO1),
81 dump_register(EXTCAP_DBC_DEVINFO2),
84 static struct dentry *xhci_debugfs_root;
86 static struct xhci_regset *xhci_debugfs_alloc_regset(struct xhci_hcd *xhci)
88 struct xhci_regset *regset;
90 regset = kzalloc(sizeof(*regset), GFP_KERNEL);
95 * The allocation and free of regset are executed in order.
96 * We needn't a lock here.
98 INIT_LIST_HEAD(®set->list);
99 list_add_tail(®set->list, &xhci->regset_list);
104 static void xhci_debugfs_free_regset(struct xhci_regset *regset)
109 list_del(®set->list);
114 static void xhci_debugfs_regset(struct xhci_hcd *xhci, u32 base,
115 const struct debugfs_reg32 *regs,
116 size_t nregs, struct dentry *parent,
117 const char *fmt, ...)
119 struct xhci_regset *rgs;
121 struct debugfs_regset32 *regset;
122 struct usb_hcd *hcd = xhci_to_hcd(xhci);
124 rgs = xhci_debugfs_alloc_regset(xhci);
129 vsnprintf(rgs->name, sizeof(rgs->name), fmt, args);
132 regset = &rgs->regset;
134 regset->nregs = nregs;
135 regset->base = hcd->regs + base;
137 debugfs_create_regset32((const char *)rgs->name, 0444, parent, regset);
140 static void xhci_debugfs_extcap_regset(struct xhci_hcd *xhci, int cap_id,
141 const struct debugfs_reg32 *regs,
142 size_t n, const char *cap_name)
146 size_t psic, nregs = n;
147 void __iomem *base = &xhci->cap_regs->hc_capbase;
149 offset = xhci_find_next_ext_cap(base, 0, cap_id);
151 if (cap_id == XHCI_EXT_CAPS_PROTOCOL) {
152 psic = XHCI_EXT_PORT_PSIC(readl(base + offset + 8));
153 nregs = min(4 + psic, n);
156 xhci_debugfs_regset(xhci, offset, regs, nregs,
157 xhci->debugfs_root, "%s:%02d",
159 offset = xhci_find_next_ext_cap(base, offset, cap_id);
164 static int xhci_ring_enqueue_show(struct seq_file *s, void *unused)
167 struct xhci_ring *ring = *(struct xhci_ring **)s->private;
169 dma = xhci_trb_virt_to_dma(ring->enq_seg, ring->enqueue);
170 seq_printf(s, "%pad\n", &dma);
175 static int xhci_ring_dequeue_show(struct seq_file *s, void *unused)
178 struct xhci_ring *ring = *(struct xhci_ring **)s->private;
180 dma = xhci_trb_virt_to_dma(ring->deq_seg, ring->dequeue);
181 seq_printf(s, "%pad\n", &dma);
186 static int xhci_ring_cycle_show(struct seq_file *s, void *unused)
188 struct xhci_ring *ring = *(struct xhci_ring **)s->private;
190 seq_printf(s, "%d\n", ring->cycle_state);
195 static void xhci_ring_dump_segment(struct seq_file *s,
196 struct xhci_segment *seg)
201 char str[XHCI_MSG_MAX];
203 for (i = 0; i < TRBS_PER_SEGMENT; i++) {
205 dma = seg->dma + i * sizeof(*trb);
206 seq_printf(s, "%pad: %s\n", &dma,
207 xhci_decode_trb(str, XHCI_MSG_MAX, le32_to_cpu(trb->generic.field[0]),
208 le32_to_cpu(trb->generic.field[1]),
209 le32_to_cpu(trb->generic.field[2]),
210 le32_to_cpu(trb->generic.field[3])));
214 static int xhci_ring_trb_show(struct seq_file *s, void *unused)
217 struct xhci_ring *ring = *(struct xhci_ring **)s->private;
218 struct xhci_segment *seg = ring->first_seg;
220 for (i = 0; i < ring->num_segs; i++) {
221 xhci_ring_dump_segment(s, seg);
228 static struct xhci_file_map ring_files[] = {
229 {"enqueue", xhci_ring_enqueue_show, },
230 {"dequeue", xhci_ring_dequeue_show, },
231 {"cycle", xhci_ring_cycle_show, },
232 {"trbs", xhci_ring_trb_show, },
235 static int xhci_ring_open(struct inode *inode, struct file *file)
238 struct xhci_file_map *f_map;
239 const char *file_name = file_dentry(file)->d_iname;
241 for (i = 0; i < ARRAY_SIZE(ring_files); i++) {
242 f_map = &ring_files[i];
244 if (strcmp(f_map->name, file_name) == 0)
248 return single_open(file, f_map->show, inode->i_private);
251 static const struct file_operations xhci_ring_fops = {
252 .open = xhci_ring_open,
255 .release = single_release,
258 static int xhci_slot_context_show(struct seq_file *s, void *unused)
260 struct xhci_hcd *xhci;
261 struct xhci_slot_ctx *slot_ctx;
262 struct xhci_slot_priv *priv = s->private;
263 struct xhci_virt_device *dev = priv->dev;
264 char str[XHCI_MSG_MAX];
266 xhci = hcd_to_xhci(bus_to_hcd(dev->udev->bus));
267 slot_ctx = xhci_get_slot_ctx(xhci, dev->out_ctx);
268 seq_printf(s, "%pad: %s\n", &dev->out_ctx->dma,
269 xhci_decode_slot_context(str,
270 le32_to_cpu(slot_ctx->dev_info),
271 le32_to_cpu(slot_ctx->dev_info2),
272 le32_to_cpu(slot_ctx->tt_info),
273 le32_to_cpu(slot_ctx->dev_state)));
278 static int xhci_endpoint_context_show(struct seq_file *s, void *unused)
282 struct xhci_hcd *xhci;
283 struct xhci_ep_ctx *ep_ctx;
284 struct xhci_slot_priv *priv = s->private;
285 struct xhci_virt_device *dev = priv->dev;
286 char str[XHCI_MSG_MAX];
288 xhci = hcd_to_xhci(bus_to_hcd(dev->udev->bus));
290 for (ep_index = 0; ep_index < 31; ep_index++) {
291 ep_ctx = xhci_get_ep_ctx(xhci, dev->out_ctx, ep_index);
292 dma = dev->out_ctx->dma + (ep_index + 1) * CTX_SIZE(xhci->hcc_params);
293 seq_printf(s, "%pad: %s\n", &dma,
294 xhci_decode_ep_context(str,
295 le32_to_cpu(ep_ctx->ep_info),
296 le32_to_cpu(ep_ctx->ep_info2),
297 le64_to_cpu(ep_ctx->deq),
298 le32_to_cpu(ep_ctx->tx_info)));
304 static int xhci_device_name_show(struct seq_file *s, void *unused)
306 struct xhci_slot_priv *priv = s->private;
307 struct xhci_virt_device *dev = priv->dev;
309 seq_printf(s, "%s\n", dev_name(&dev->udev->dev));
314 static struct xhci_file_map context_files[] = {
315 {"name", xhci_device_name_show, },
316 {"slot-context", xhci_slot_context_show, },
317 {"ep-context", xhci_endpoint_context_show, },
320 static int xhci_context_open(struct inode *inode, struct file *file)
323 struct xhci_file_map *f_map;
324 const char *file_name = file_dentry(file)->d_iname;
326 for (i = 0; i < ARRAY_SIZE(context_files); i++) {
327 f_map = &context_files[i];
329 if (strcmp(f_map->name, file_name) == 0)
333 return single_open(file, f_map->show, inode->i_private);
336 static const struct file_operations xhci_context_fops = {
337 .open = xhci_context_open,
340 .release = single_release,
345 static int xhci_portsc_show(struct seq_file *s, void *unused)
347 struct xhci_port *port = s->private;
349 char str[XHCI_MSG_MAX];
351 portsc = readl(port->addr);
352 seq_printf(s, "%s\n", xhci_decode_portsc(str, portsc));
357 static int xhci_port_open(struct inode *inode, struct file *file)
359 return single_open(file, xhci_portsc_show, inode->i_private);
362 static ssize_t xhci_port_write(struct file *file, const char __user *ubuf,
363 size_t count, loff_t *ppos)
365 struct seq_file *s = file->private_data;
366 struct xhci_port *port = s->private;
367 struct xhci_hcd *xhci = hcd_to_xhci(port->rhub->hcd);
372 if (copy_from_user(&buf, ubuf, min_t(size_t, sizeof(buf) - 1, count)))
375 if (!strncmp(buf, "compliance", 10)) {
376 /* If CTC is clear, compliance is enabled by default */
377 if (!HCC2_CTC(xhci->hcc_params2))
379 spin_lock_irqsave(&xhci->lock, flags);
380 /* compliance mode can only be enabled on ports in RxDetect */
381 portsc = readl(port->addr);
382 if ((portsc & PORT_PLS_MASK) != XDEV_RXDETECT) {
383 spin_unlock_irqrestore(&xhci->lock, flags);
386 portsc = xhci_port_state_to_neutral(portsc);
387 portsc &= ~PORT_PLS_MASK;
388 portsc |= PORT_LINK_STROBE | XDEV_COMP_MODE;
389 writel(portsc, port->addr);
390 spin_unlock_irqrestore(&xhci->lock, flags);
397 static const struct file_operations port_fops = {
398 .open = xhci_port_open,
399 .write = xhci_port_write,
402 .release = single_release,
405 static void xhci_debugfs_create_files(struct xhci_hcd *xhci,
406 struct xhci_file_map *files,
407 size_t nentries, void *data,
408 struct dentry *parent,
409 const struct file_operations *fops)
413 for (i = 0; i < nentries; i++)
414 debugfs_create_file(files[i].name, 0444, parent, data, fops);
417 static struct dentry *xhci_debugfs_create_ring_dir(struct xhci_hcd *xhci,
418 struct xhci_ring **ring,
420 struct dentry *parent)
424 dir = debugfs_create_dir(name, parent);
425 xhci_debugfs_create_files(xhci, ring_files, ARRAY_SIZE(ring_files),
426 ring, dir, &xhci_ring_fops);
431 static void xhci_debugfs_create_context_files(struct xhci_hcd *xhci,
432 struct dentry *parent,
435 struct xhci_virt_device *dev = xhci->devs[slot_id];
437 xhci_debugfs_create_files(xhci, context_files,
438 ARRAY_SIZE(context_files),
439 dev->debugfs_private,
440 parent, &xhci_context_fops);
443 void xhci_debugfs_create_endpoint(struct xhci_hcd *xhci,
444 struct xhci_virt_device *dev,
447 struct xhci_ep_priv *epriv;
448 struct xhci_slot_priv *spriv = dev->debugfs_private;
453 if (spriv->eps[ep_index])
456 epriv = kzalloc(sizeof(*epriv), GFP_KERNEL);
460 epriv->show_ring = dev->eps[ep_index].ring;
462 snprintf(epriv->name, sizeof(epriv->name), "ep%02d", ep_index);
463 epriv->root = xhci_debugfs_create_ring_dir(xhci,
467 spriv->eps[ep_index] = epriv;
470 void xhci_debugfs_remove_endpoint(struct xhci_hcd *xhci,
471 struct xhci_virt_device *dev,
474 struct xhci_ep_priv *epriv;
475 struct xhci_slot_priv *spriv = dev->debugfs_private;
477 if (!spriv || !spriv->eps[ep_index])
480 epriv = spriv->eps[ep_index];
481 debugfs_remove_recursive(epriv->root);
482 spriv->eps[ep_index] = NULL;
486 static int xhci_stream_id_show(struct seq_file *s, void *unused)
488 struct xhci_ep_priv *epriv = s->private;
490 if (!epriv->stream_info)
493 seq_printf(s, "Show stream ID %d trb ring, supported [1 - %d]\n",
494 epriv->stream_id, epriv->stream_info->num_streams - 1);
499 static int xhci_stream_id_open(struct inode *inode, struct file *file)
501 return single_open(file, xhci_stream_id_show, inode->i_private);
504 static ssize_t xhci_stream_id_write(struct file *file, const char __user *ubuf,
505 size_t count, loff_t *ppos)
507 struct seq_file *s = file->private_data;
508 struct xhci_ep_priv *epriv = s->private;
510 u16 stream_id; /* MaxPStreams + 1 <= 16 */
512 if (!epriv->stream_info)
516 ret = kstrtou16_from_user(ubuf, count, 10, &stream_id);
520 if (stream_id == 0 || stream_id >= epriv->stream_info->num_streams)
523 epriv->stream_id = stream_id;
524 epriv->show_ring = epriv->stream_info->stream_rings[stream_id];
529 static const struct file_operations stream_id_fops = {
530 .open = xhci_stream_id_open,
531 .write = xhci_stream_id_write,
534 .release = single_release,
537 static int xhci_stream_context_array_show(struct seq_file *s, void *unused)
539 struct xhci_ep_priv *epriv = s->private;
540 struct xhci_stream_ctx *stream_ctx;
544 if (!epriv->stream_info)
547 seq_printf(s, "Allocated %d streams and %d stream context array entries\n",
548 epriv->stream_info->num_streams,
549 epriv->stream_info->num_stream_ctxs);
551 for (id = 0; id < epriv->stream_info->num_stream_ctxs; id++) {
552 stream_ctx = epriv->stream_info->stream_ctx_array + id;
553 dma = epriv->stream_info->ctx_array_dma + id * 16;
554 if (id < epriv->stream_info->num_streams)
555 seq_printf(s, "%pad stream id %d deq %016llx\n", &dma,
556 id, le64_to_cpu(stream_ctx->stream_ring));
558 seq_printf(s, "%pad stream context entry not used deq %016llx\n",
559 &dma, le64_to_cpu(stream_ctx->stream_ring));
564 DEFINE_SHOW_ATTRIBUTE(xhci_stream_context_array);
566 void xhci_debugfs_create_stream_files(struct xhci_hcd *xhci,
567 struct xhci_virt_device *dev,
570 struct xhci_slot_priv *spriv = dev->debugfs_private;
571 struct xhci_ep_priv *epriv;
573 if (!spriv || !spriv->eps[ep_index] ||
574 !dev->eps[ep_index].stream_info)
577 epriv = spriv->eps[ep_index];
578 epriv->stream_info = dev->eps[ep_index].stream_info;
580 /* Show trb ring of stream ID 1 by default */
581 epriv->stream_id = 1;
582 epriv->show_ring = epriv->stream_info->stream_rings[1];
583 debugfs_create_file("stream_id", 0644,
586 debugfs_create_file("stream_context_array", 0444,
588 &xhci_stream_context_array_fops);
591 void xhci_debugfs_create_slot(struct xhci_hcd *xhci, int slot_id)
593 struct xhci_slot_priv *priv;
594 struct xhci_virt_device *dev = xhci->devs[slot_id];
596 priv = kzalloc(sizeof(*priv), GFP_KERNEL);
600 snprintf(priv->name, sizeof(priv->name), "%02d", slot_id);
601 priv->root = debugfs_create_dir(priv->name, xhci->debugfs_slots);
603 dev->debugfs_private = priv;
605 xhci_debugfs_create_ring_dir(xhci, &dev->eps[0].ring,
608 xhci_debugfs_create_context_files(xhci, priv->root, slot_id);
611 void xhci_debugfs_remove_slot(struct xhci_hcd *xhci, int slot_id)
614 struct xhci_slot_priv *priv;
615 struct xhci_virt_device *dev = xhci->devs[slot_id];
617 if (!dev || !dev->debugfs_private)
620 priv = dev->debugfs_private;
622 debugfs_remove_recursive(priv->root);
624 for (i = 0; i < 31; i++)
628 dev->debugfs_private = NULL;
631 static void xhci_debugfs_create_ports(struct xhci_hcd *xhci,
632 struct dentry *parent)
634 unsigned int num_ports;
636 struct xhci_port *port;
639 num_ports = HCS_MAX_PORTS(xhci->hcs_params1);
641 parent = debugfs_create_dir("ports", parent);
643 while (num_ports--) {
644 scnprintf(port_name, sizeof(port_name), "port%02d",
646 dir = debugfs_create_dir(port_name, parent);
647 port = &xhci->hw_ports[num_ports];
648 debugfs_create_file("portsc", 0644, dir, port, &port_fops);
652 void xhci_debugfs_init(struct xhci_hcd *xhci)
654 struct device *dev = xhci_to_hcd(xhci)->self.controller;
656 xhci->debugfs_root = debugfs_create_dir(dev_name(dev),
659 INIT_LIST_HEAD(&xhci->regset_list);
661 xhci_debugfs_regset(xhci,
663 xhci_cap_regs, ARRAY_SIZE(xhci_cap_regs),
664 xhci->debugfs_root, "reg-cap");
666 xhci_debugfs_regset(xhci,
667 HC_LENGTH(readl(&xhci->cap_regs->hc_capbase)),
668 xhci_op_regs, ARRAY_SIZE(xhci_op_regs),
669 xhci->debugfs_root, "reg-op");
671 xhci_debugfs_regset(xhci,
672 readl(&xhci->cap_regs->run_regs_off) & RTSOFF_MASK,
673 xhci_runtime_regs, ARRAY_SIZE(xhci_runtime_regs),
674 xhci->debugfs_root, "reg-runtime");
676 xhci_debugfs_extcap_regset(xhci, XHCI_EXT_CAPS_LEGACY,
678 ARRAY_SIZE(xhci_extcap_legsup),
681 xhci_debugfs_extcap_regset(xhci, XHCI_EXT_CAPS_PROTOCOL,
682 xhci_extcap_protocol,
683 ARRAY_SIZE(xhci_extcap_protocol),
686 xhci_debugfs_extcap_regset(xhci, XHCI_EXT_CAPS_DEBUG,
688 ARRAY_SIZE(xhci_extcap_dbc),
691 xhci_debugfs_create_ring_dir(xhci, &xhci->cmd_ring,
695 xhci_debugfs_create_ring_dir(xhci, &xhci->interrupter->event_ring,
699 xhci->debugfs_slots = debugfs_create_dir("devices", xhci->debugfs_root);
701 xhci_debugfs_create_ports(xhci, xhci->debugfs_root);
704 void xhci_debugfs_exit(struct xhci_hcd *xhci)
706 struct xhci_regset *rgs, *tmp;
708 debugfs_remove_recursive(xhci->debugfs_root);
709 xhci->debugfs_root = NULL;
710 xhci->debugfs_slots = NULL;
712 list_for_each_entry_safe(rgs, tmp, &xhci->regset_list, list)
713 xhci_debugfs_free_regset(rgs);
716 void __init xhci_debugfs_create_root(void)
718 xhci_debugfs_root = debugfs_create_dir("xhci", usb_debug_root);
721 void __exit xhci_debugfs_remove_root(void)
723 debugfs_remove_recursive(xhci_debugfs_root);
724 xhci_debugfs_root = NULL;