1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Copyright (c) 2012-2016, Intel Corporation. All rights reserved
4 * Intel Management Engine Interface (Intel MEI) Linux driver
5 */
6
7#include <linux/slab.h>
8#include <linux/kernel.h>
9#include <linux/device.h>
10#include <linux/debugfs.h>
11#include <linux/seq_file.h>
12
13#include <linux/mei.h>
14
15#include "mei_dev.h"
16#include "client.h"
17#include "hw.h"
18
19static int mei_dbgfs_meclients_show(struct seq_file *m, void *unused)
20{
21	struct mei_device *dev = m->private;
22	struct mei_me_client *me_cl;
23	int i = 0;
24
25	if (!dev)
26		return -ENODEV;
27
28	down_read(&dev->me_clients_rwsem);
29
30	seq_puts(m, "  |id|fix|         UUID                       |con|msg len|sb|refc|vt|\n");
31
32	/*  if the driver is not enabled the list won't be consistent */
33	if (dev->dev_state != MEI_DEV_ENABLED)
34		goto out;
35
36	list_for_each_entry(me_cl, &dev->me_clients, list) {
37		if (!mei_me_cl_get(me_cl))
38			continue;
39
40		seq_printf(m, "%2d|%2d|%3d|%pUl|%3d|%7d|%2d|%4d|%2d|\n",
41			   i++, me_cl->client_id,
42			   me_cl->props.fixed_address,
43			   &me_cl->props.protocol_name,
44			   me_cl->props.max_number_of_connections,
45			   me_cl->props.max_msg_length,
46			   me_cl->props.single_recv_buf,
47			   kref_read(&me_cl->refcnt),
48			   me_cl->props.vt_supported);
49		mei_me_cl_put(me_cl);
50	}
51
52out:
53	up_read(&dev->me_clients_rwsem);
54	return 0;
55}
56DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_meclients);
57
58static int mei_dbgfs_active_show(struct seq_file *m, void *unused)
59{
60	struct mei_device *dev = m->private;
61	struct mei_cl *cl;
62	int i = 0;
63
64	if (!dev)
65		return -ENODEV;
66
67	mutex_lock(&dev->device_lock);
68
69	seq_puts(m, "   |me|host|state|rd|wr|wrq\n");
70
71	/*  if the driver is not enabled the list won't be consistent */
72	if (dev->dev_state != MEI_DEV_ENABLED)
73		goto out;
74
75	list_for_each_entry(cl, &dev->file_list, link) {
76
77		seq_printf(m, "%3d|%2d|%4d|%5d|%2d|%2d|%3u\n",
78			   i, mei_cl_me_id(cl), cl->host_client_id, cl->state,
79			   !list_empty(&cl->rd_completed), cl->writing_state,
80			   cl->tx_cb_queued);
81		i++;
82	}
83out:
84	mutex_unlock(&dev->device_lock);
85	return 0;
86}
87DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_active);
88
89static int mei_dbgfs_devstate_show(struct seq_file *m, void *unused)
90{
91	struct mei_device *dev = m->private;
92
93	seq_printf(m, "dev: %s\n", mei_dev_state_str(dev->dev_state));
94	seq_printf(m, "hbm: %s\n", mei_hbm_state_str(dev->hbm_state));
95
96	if (dev->hbm_state >= MEI_HBM_ENUM_CLIENTS &&
97	    dev->hbm_state <= MEI_HBM_STARTED) {
98		seq_puts(m, "hbm features:\n");
99		seq_printf(m, "\tPG: %01d\n", dev->hbm_f_pg_supported);
100		seq_printf(m, "\tDC: %01d\n", dev->hbm_f_dc_supported);
101		seq_printf(m, "\tIE: %01d\n", dev->hbm_f_ie_supported);
102		seq_printf(m, "\tDOT: %01d\n", dev->hbm_f_dot_supported);
103		seq_printf(m, "\tEV: %01d\n", dev->hbm_f_ev_supported);
104		seq_printf(m, "\tFA: %01d\n", dev->hbm_f_fa_supported);
105		seq_printf(m, "\tOS: %01d\n", dev->hbm_f_os_supported);
106		seq_printf(m, "\tDR: %01d\n", dev->hbm_f_dr_supported);
107		seq_printf(m, "\tVT: %01d\n", dev->hbm_f_vt_supported);
108		seq_printf(m, "\tCAP: %01d\n", dev->hbm_f_cap_supported);
109	}
110
111	seq_printf(m, "pg:  %s, %s\n",
112		   mei_pg_is_enabled(dev) ? "ENABLED" : "DISABLED",
113		   mei_pg_state_str(mei_pg_state(dev)));
114	return 0;
115}
116DEFINE_SHOW_ATTRIBUTE(mei_dbgfs_devstate);
117
118static ssize_t mei_dbgfs_write_allow_fa(struct file *file,
119					const char __user *user_buf,
120					size_t count, loff_t *ppos)
121{
122	struct mei_device *dev;
123	int ret;
124
125	dev = container_of(file->private_data,
126			   struct mei_device, allow_fixed_address);
127
128	ret = debugfs_write_file_bool(file, user_buf, count, ppos);
129	if (ret < 0)
130		return ret;
131	dev->override_fixed_address = true;
132	return ret;
133}
134
135static const struct file_operations mei_dbgfs_allow_fa_fops = {
136	.open = simple_open,
137	.read = debugfs_read_file_bool,
138	.write = mei_dbgfs_write_allow_fa,
139	.llseek = generic_file_llseek,
140};
141
142/**
143 * mei_dbgfs_deregister - Remove the debugfs files and directories
144 *
145 * @dev: the mei device structure
146 */
147void mei_dbgfs_deregister(struct mei_device *dev)
148{
149	if (!dev->dbgfs_dir)
150		return;
151	debugfs_remove_recursive(dev->dbgfs_dir);
152	dev->dbgfs_dir = NULL;
153}
154
155/**
156 * mei_dbgfs_register - Add the debugfs files
157 *
158 * @dev: the mei device structure
159 * @name: the mei device name
160 */
161void mei_dbgfs_register(struct mei_device *dev, const char *name)
162{
163	struct dentry *dir;
164
165	dir = debugfs_create_dir(name, NULL);
166	dev->dbgfs_dir = dir;
167
168	debugfs_create_file("meclients", S_IRUSR, dir, dev,
169			    &mei_dbgfs_meclients_fops);
170	debugfs_create_file("active", S_IRUSR, dir, dev,
171			    &mei_dbgfs_active_fops);
172	debugfs_create_file("devstate", S_IRUSR, dir, dev,
173			    &mei_dbgfs_devstate_fops);
174	debugfs_create_file("allow_fixed_address", S_IRUSR | S_IWUSR, dir,
175			    &dev->allow_fixed_address,
176			    &mei_dbgfs_allow_fa_fops);
177}
178