xe_tile_debugfs.c

  1// SPDX-License-Identifier: MIT
  2/*
  3 * Copyright © 2025 Intel Corporation
  4 */
  5
  6#include <linux/debugfs.h>
  7#include <drm/drm_debugfs.h>
  8
  9#include "xe_ggtt.h"
 10#include "xe_pm.h"
 11#include "xe_sa.h"
 12#include "xe_tile_debugfs.h"
 13
 14static struct xe_tile *node_to_tile(struct drm_info_node *node)
 15{
 16	return node->dent->d_parent->d_inode->i_private;
 17}
 18
 19/**
 20 * xe_tile_debugfs_simple_show() - A show callback for struct drm_info_list
 21 * @m: the &seq_file
 22 * @data: data used by the drm debugfs helpers
 23 *
 24 * This callback can be used in struct drm_info_list to describe debugfs
 25 * files that are &xe_tile specific.
 26 *
 27 * It is assumed that those debugfs files will be created on directory entry
 28 * which struct dentry d_inode->i_private points to &xe_tile.
 29 *
 30 *      /sys/kernel/debug/dri/0/
 31 *      ├── tile0/		# tile = dentry->d_inode->i_private
 32 *      │   │   ├── id		# tile = dentry->d_parent->d_inode->i_private
 33 *
 34 * This function assumes that &m->private will be set to the &struct
 35 * drm_info_node corresponding to the instance of the info on a given &struct
 36 * drm_minor (see struct drm_info_list.show for details).
 37 *
 38 * This function also assumes that struct drm_info_list.data will point to the
 39 * function code that will actually print a file content::
 40 *
 41 *   int (*print)(struct xe_tile *, struct drm_printer *)
 42 *
 43 * Example::
 44 *
 45 *    int tile_id(struct xe_tile *tile, struct drm_printer *p)
 46 *    {
 47 *        drm_printf(p, "%u\n", tile->id);
 48 *        return 0;
 49 *    }
 50 *
 51 *    static const struct drm_info_list info[] = {
 52 *        { name = "id", .show = tile_debugfs_simple_show, .data = tile_id },
 53 *    };
 54 *
 55 *    dir = debugfs_create_dir("tile0", parent);
 56 *    dir->d_inode->i_private = tile;
 57 *    drm_debugfs_create_files(info, ARRAY_SIZE(info), dir, minor);
 58 *
 59 * Return: 0 on success or a negative error code on failure.
 60 */
 61int xe_tile_debugfs_simple_show(struct seq_file *m, void *data)
 62{
 63	struct drm_printer p = drm_seq_file_printer(m);
 64	struct drm_info_node *node = m->private;
 65	struct xe_tile *tile = node_to_tile(node);
 66	int (*print)(struct xe_tile *, struct drm_printer *) = node->info_ent->data;
 67
 68	return print(tile, &p);
 69}
 70
 71/**
 72 * xe_tile_debugfs_show_with_rpm() - A show callback for struct drm_info_list
 73 * @m: the &seq_file
 74 * @data: data used by the drm debugfs helpers
 75 *
 76 * Similar to tile_debugfs_simple_show() but implicitly takes a RPM ref.
 77 *
 78 * Return: 0 on success or a negative error code on failure.
 79 */
 80int xe_tile_debugfs_show_with_rpm(struct seq_file *m, void *data)
 81{
 82	struct drm_info_node *node = m->private;
 83	struct xe_tile *tile = node_to_tile(node);
 84	struct xe_device *xe = tile_to_xe(tile);
 85	int ret;
 86
 87	xe_pm_runtime_get(xe);
 88	ret = xe_tile_debugfs_simple_show(m, data);
 89	xe_pm_runtime_put(xe);
 90
 91	return ret;
 92}
 93
 94static int ggtt(struct xe_tile *tile, struct drm_printer *p)
 95{
 96	return xe_ggtt_dump(tile->mem.ggtt, p);
 97}
 98
 99static int sa_info(struct xe_tile *tile, struct drm_printer *p)
100{
101	drm_suballoc_dump_debug_info(&tile->mem.kernel_bb_pool->base, p,
102				     xe_sa_manager_gpu_addr(tile->mem.kernel_bb_pool));
103
104	return 0;
105}
106
107/* only for debugfs files which can be safely used on the VF */
108static const struct drm_info_list vf_safe_debugfs_list[] = {
109	{ "ggtt", .show = xe_tile_debugfs_show_with_rpm, .data = ggtt },
110	{ "sa_info", .show = xe_tile_debugfs_show_with_rpm, .data = sa_info },
111};
112
113/**
114 * xe_tile_debugfs_register - Register tile's debugfs attributes
115 * @tile: the &xe_tile to register
116 *
117 * Create debugfs sub-directory with a name that includes a tile ID and
118 * then creates set of debugfs files (attributes) specific to this tile.
119 */
120void xe_tile_debugfs_register(struct xe_tile *tile)
121{
122	struct xe_device *xe = tile_to_xe(tile);
123	struct drm_minor *minor = xe->drm.primary;
124	struct dentry *root = minor->debugfs_root;
125	char name[8];
126
127	snprintf(name, sizeof(name), "tile%u", tile->id);
128	tile->debugfs = debugfs_create_dir(name, root);
129	if (IS_ERR(tile->debugfs))
130		return;
131
132	/*
133	 * Store the xe_tile pointer as private data of the tile/ directory
134	 * node so other tile specific attributes under that directory may
135	 * refer to it by looking at its parent node private data.
136	 */
137	tile->debugfs->d_inode->i_private = tile;
138
139	drm_debugfs_create_files(vf_safe_debugfs_list,
140				 ARRAY_SIZE(vf_safe_debugfs_list),
141				 tile->debugfs, minor);
142}