2 * Intel Wireless WiMAX Connection 2400m
3 * Debugfs interfaces to manipulate driver and device information
6 * Copyright (C) 2007 Intel Corporation <linux-wimax@intel.com>
7 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License version
11 * 2 as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
24 #include <linux/debugfs.h>
25 #include <linux/netdevice.h>
26 #include <linux/etherdevice.h>
27 #include <linux/spinlock.h>
28 #include <linux/device.h>
32 #define D_SUBMODULE debugfs
33 #include "debug-levels.h"
36 int debugfs_netdev_queue_stopped_get(void *data, u64 *val)
38 struct i2400m *i2400m = data;
39 *val = netif_queue_stopped(i2400m->wimax_dev.net_dev);
42 DEFINE_SIMPLE_ATTRIBUTE(fops_netdev_queue_stopped,
43 debugfs_netdev_queue_stopped_get,
48 struct dentry *debugfs_create_netdev_queue_stopped(
49 const char *name, struct dentry *parent, struct i2400m *i2400m)
51 return debugfs_create_file(name, 0400, parent, i2400m,
52 &fops_netdev_queue_stopped);
57 * inode->i_private has the @data argument to debugfs_create_file()
60 int i2400m_stats_open(struct inode *inode, struct file *filp)
62 filp->private_data = inode->i_private;
67 * We don't allow partial reads of this file, as then the reader would
68 * get weirdly confused data as it is updated.
70 * So or you read it all or nothing; if you try to read with an offset
71 * != 0, we consider you are done reading.
74 ssize_t i2400m_rx_stats_read(struct file *filp, char __user *buffer,
75 size_t count, loff_t *ppos)
77 struct i2400m *i2400m = filp->private_data;
83 if (count < sizeof(buf))
85 spin_lock_irqsave(&i2400m->rx_lock, flags);
86 snprintf(buf, sizeof(buf), "%u %u %u %u %u %u %u\n",
87 i2400m->rx_pl_num, i2400m->rx_pl_min,
88 i2400m->rx_pl_max, i2400m->rx_num,
90 i2400m->rx_size_min, i2400m->rx_size_max);
91 spin_unlock_irqrestore(&i2400m->rx_lock, flags);
92 return simple_read_from_buffer(buffer, count, ppos, buf, strlen(buf));
96 /* Any write clears the stats */
98 ssize_t i2400m_rx_stats_write(struct file *filp, const char __user *buffer,
99 size_t count, loff_t *ppos)
101 struct i2400m *i2400m = filp->private_data;
104 spin_lock_irqsave(&i2400m->rx_lock, flags);
105 i2400m->rx_pl_num = 0;
106 i2400m->rx_pl_max = 0;
107 i2400m->rx_pl_min = UINT_MAX;
109 i2400m->rx_size_acc = 0;
110 i2400m->rx_size_min = UINT_MAX;
111 i2400m->rx_size_max = 0;
112 spin_unlock_irqrestore(&i2400m->rx_lock, flags);
117 const struct file_operations i2400m_rx_stats_fops = {
118 .owner = THIS_MODULE,
119 .open = i2400m_stats_open,
120 .read = i2400m_rx_stats_read,
121 .write = i2400m_rx_stats_write,
125 /* See i2400m_rx_stats_read() */
127 ssize_t i2400m_tx_stats_read(struct file *filp, char __user *buffer,
128 size_t count, loff_t *ppos)
130 struct i2400m *i2400m = filp->private_data;
136 if (count < sizeof(buf))
138 spin_lock_irqsave(&i2400m->tx_lock, flags);
139 snprintf(buf, sizeof(buf), "%u %u %u %u %u %u %u\n",
140 i2400m->tx_pl_num, i2400m->tx_pl_min,
141 i2400m->tx_pl_max, i2400m->tx_num,
143 i2400m->tx_size_min, i2400m->tx_size_max);
144 spin_unlock_irqrestore(&i2400m->tx_lock, flags);
145 return simple_read_from_buffer(buffer, count, ppos, buf, strlen(buf));
148 /* Any write clears the stats */
150 ssize_t i2400m_tx_stats_write(struct file *filp, const char __user *buffer,
151 size_t count, loff_t *ppos)
153 struct i2400m *i2400m = filp->private_data;
156 spin_lock_irqsave(&i2400m->tx_lock, flags);
157 i2400m->tx_pl_num = 0;
158 i2400m->tx_pl_max = 0;
159 i2400m->tx_pl_min = UINT_MAX;
161 i2400m->tx_size_acc = 0;
162 i2400m->tx_size_min = UINT_MAX;
163 i2400m->tx_size_max = 0;
164 spin_unlock_irqrestore(&i2400m->tx_lock, flags);
169 const struct file_operations i2400m_tx_stats_fops = {
170 .owner = THIS_MODULE,
171 .open = i2400m_stats_open,
172 .read = i2400m_tx_stats_read,
173 .write = i2400m_tx_stats_write,
177 /* Write 1 to ask the device to go into suspend */
179 int debugfs_i2400m_suspend_set(void *data, u64 val)
182 struct i2400m *i2400m = data;
183 result = i2400m_cmd_enter_powersave(i2400m);
188 DEFINE_SIMPLE_ATTRIBUTE(fops_i2400m_suspend,
189 NULL, debugfs_i2400m_suspend_set,
193 struct dentry *debugfs_create_i2400m_suspend(
194 const char *name, struct dentry *parent, struct i2400m *i2400m)
196 return debugfs_create_file(name, 0200, parent, i2400m,
197 &fops_i2400m_suspend);
204 * Write 0 to ask the device to soft reset, 1 to cold reset, 2 to bus
205 * reset (as defined by enum i2400m_reset_type).
208 int debugfs_i2400m_reset_set(void *data, u64 val)
211 struct i2400m *i2400m = data;
212 enum i2400m_reset_type rt = val;
217 result = i2400m->bus_reset(i2400m, rt);
225 DEFINE_SIMPLE_ATTRIBUTE(fops_i2400m_reset,
226 NULL, debugfs_i2400m_reset_set,
230 struct dentry *debugfs_create_i2400m_reset(
231 const char *name, struct dentry *parent, struct i2400m *i2400m)
233 return debugfs_create_file(name, 0200, parent, i2400m,
238 #define __debugfs_register(prefix, name, parent) \
240 result = d_level_register_debugfs(prefix, name, parent); \
246 int i2400m_debugfs_add(struct i2400m *i2400m)
249 struct device *dev = i2400m_dev(i2400m);
250 struct dentry *dentry = i2400m->wimax_dev.debugfs_dentry;
253 dentry = debugfs_create_dir("i2400m", dentry);
254 result = PTR_ERR(dentry);
255 if (IS_ERR(dentry)) {
256 if (result == -ENODEV)
257 result = 0; /* No debugfs support */
260 i2400m->debugfs_dentry = dentry;
261 __debugfs_register("dl_", control, dentry);
262 __debugfs_register("dl_", driver, dentry);
263 __debugfs_register("dl_", debugfs, dentry);
264 __debugfs_register("dl_", fw, dentry);
265 __debugfs_register("dl_", netdev, dentry);
266 __debugfs_register("dl_", rfkill, dentry);
267 __debugfs_register("dl_", rx, dentry);
268 __debugfs_register("dl_", tx, dentry);
270 fd = debugfs_create_size_t("tx_in", 0400, dentry,
272 result = PTR_ERR(fd);
273 if (IS_ERR(fd) && result != -ENODEV) {
274 dev_err(dev, "Can't create debugfs entry "
275 "tx_in: %d\n", result);
279 fd = debugfs_create_size_t("tx_out", 0400, dentry,
281 result = PTR_ERR(fd);
282 if (IS_ERR(fd) && result != -ENODEV) {
283 dev_err(dev, "Can't create debugfs entry "
284 "tx_out: %d\n", result);
288 fd = debugfs_create_u32("state", 0600, dentry,
290 result = PTR_ERR(fd);
291 if (IS_ERR(fd) && result != -ENODEV) {
292 dev_err(dev, "Can't create debugfs entry "
293 "state: %d\n", result);
298 * Trace received messages from user space
300 * In order to tap the bidirectional message stream in the
301 * 'msg' pipe, user space can read from the 'msg' pipe;
302 * however, due to limitations in libnl, we can't know what
303 * the different applications are sending down to the kernel.
305 * So we have this hack where the driver will echo any message
306 * received on the msg pipe from user space [through a call to
307 * wimax_dev->op_msg_from_user() into
308 * i2400m_op_msg_from_user()] into the 'trace' pipe that this
311 * So then, reading from both the 'trace' and 'msg' pipes in
312 * user space will provide a full dump of the traffic.
314 * Write 1 to activate, 0 to clear.
316 * It is not really very atomic, but it is also not too
319 fd = debugfs_create_u8("trace_msg_from_user", 0600, dentry,
320 &i2400m->trace_msg_from_user);
321 result = PTR_ERR(fd);
322 if (IS_ERR(fd) && result != -ENODEV) {
323 dev_err(dev, "Can't create debugfs entry "
324 "trace_msg_from_user: %d\n", result);
328 fd = debugfs_create_netdev_queue_stopped("netdev_queue_stopped",
330 result = PTR_ERR(fd);
331 if (IS_ERR(fd) && result != -ENODEV) {
332 dev_err(dev, "Can't create debugfs entry "
333 "netdev_queue_stopped: %d\n", result);
337 fd = debugfs_create_file("rx_stats", 0600, dentry, i2400m,
338 &i2400m_rx_stats_fops);
339 result = PTR_ERR(fd);
340 if (IS_ERR(fd) && result != -ENODEV) {
341 dev_err(dev, "Can't create debugfs entry "
342 "rx_stats: %d\n", result);
346 fd = debugfs_create_file("tx_stats", 0600, dentry, i2400m,
347 &i2400m_tx_stats_fops);
348 result = PTR_ERR(fd);
349 if (IS_ERR(fd) && result != -ENODEV) {
350 dev_err(dev, "Can't create debugfs entry "
351 "tx_stats: %d\n", result);
355 fd = debugfs_create_i2400m_suspend("suspend", dentry, i2400m);
356 result = PTR_ERR(fd);
357 if (IS_ERR(fd) && result != -ENODEV) {
358 dev_err(dev, "Can't create debugfs entry suspend: %d\n",
363 fd = debugfs_create_i2400m_reset("reset", dentry, i2400m);
364 result = PTR_ERR(fd);
365 if (IS_ERR(fd) && result != -ENODEV) {
366 dev_err(dev, "Can't create debugfs entry reset: %d\n", result);
375 void i2400m_debugfs_rm(struct i2400m *i2400m)
377 debugfs_remove_recursive(i2400m->debugfs_dentry);