1 /*
2 * Ultra Wide Band
3 * Debug support
4 *
5 * Copyright (C) 2005-2006 Intel Corporation
6 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
7 * Copyright (C) 2008 Cambridge Silicon Radio Ltd.
8 *
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.
12 *
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.
17 *
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
21 * 02110-1301, USA.
22 *
23 *
24 * FIXME: doc
25 */
26
27 #include <linux/spinlock.h>
28 #include <linux/module.h>
29 #include <linux/slab.h>
30 #include <linux/notifier.h>
31 #include <linux/device.h>
32 #include <linux/debugfs.h>
33 #include <linux/uaccess.h>
34 #include <linux/seq_file.h>
35
36 #include <linux/uwb/debug-cmd.h>
37
38 #include "uwb-internal.h"
39
40 /*
41 * Debug interface
42 *
43 * Per radio controller debugfs files (in uwb/uwbN/):
44 *
45 * command: Flexible command interface (see <linux/uwb/debug-cmd.h>).
46 *
47 * reservations: information on reservations.
48 *
49 * accept: Set to true (Y or 1) to accept reservation requests from
50 * peers.
51 *
52 * drp_avail: DRP availability information.
53 */
54
55 struct uwb_dbg {
56 struct uwb_pal pal;
57
58 bool accept;
59 struct list_head rsvs;
60
61 struct dentry *root_d;
62 struct dentry *command_f;
63 struct dentry *reservations_f;
64 struct dentry *accept_f;
65 struct dentry *drp_avail_f;
66 spinlock_t list_lock;
67 };
68
69 static struct dentry *root_dir;
70
uwb_dbg_rsv_cb(struct uwb_rsv * rsv)71 static void uwb_dbg_rsv_cb(struct uwb_rsv *rsv)
72 {
73 struct uwb_dbg *dbg = rsv->pal_priv;
74
75 uwb_rsv_dump("debug", rsv);
76
77 if (rsv->state == UWB_RSV_STATE_NONE) {
78 spin_lock(&dbg->list_lock);
79 list_del(&rsv->pal_node);
80 spin_unlock(&dbg->list_lock);
81 uwb_rsv_destroy(rsv);
82 }
83 }
84
cmd_rsv_establish(struct uwb_rc * rc,struct uwb_dbg_cmd_rsv_establish * cmd)85 static int cmd_rsv_establish(struct uwb_rc *rc,
86 struct uwb_dbg_cmd_rsv_establish *cmd)
87 {
88 struct uwb_mac_addr macaddr;
89 struct uwb_rsv *rsv;
90 struct uwb_dev *target;
91 int ret;
92
93 memcpy(&macaddr, cmd->target, sizeof(macaddr));
94 target = uwb_dev_get_by_macaddr(rc, &macaddr);
95 if (target == NULL)
96 return -ENODEV;
97
98 rsv = uwb_rsv_create(rc, uwb_dbg_rsv_cb, rc->dbg);
99 if (rsv == NULL) {
100 uwb_dev_put(target);
101 return -ENOMEM;
102 }
103
104 rsv->target.type = UWB_RSV_TARGET_DEV;
105 rsv->target.dev = target;
106 rsv->type = cmd->type;
107 rsv->max_mas = cmd->max_mas;
108 rsv->min_mas = cmd->min_mas;
109 rsv->max_interval = cmd->max_interval;
110
111 ret = uwb_rsv_establish(rsv);
112 if (ret)
113 uwb_rsv_destroy(rsv);
114 else {
115 spin_lock(&(rc->dbg)->list_lock);
116 list_add_tail(&rsv->pal_node, &rc->dbg->rsvs);
117 spin_unlock(&(rc->dbg)->list_lock);
118 }
119 return ret;
120 }
121
cmd_rsv_terminate(struct uwb_rc * rc,struct uwb_dbg_cmd_rsv_terminate * cmd)122 static int cmd_rsv_terminate(struct uwb_rc *rc,
123 struct uwb_dbg_cmd_rsv_terminate *cmd)
124 {
125 struct uwb_rsv *rsv, *found = NULL;
126 int i = 0;
127
128 spin_lock(&(rc->dbg)->list_lock);
129
130 list_for_each_entry(rsv, &rc->dbg->rsvs, pal_node) {
131 if (i == cmd->index) {
132 found = rsv;
133 uwb_rsv_get(found);
134 break;
135 }
136 i++;
137 }
138
139 spin_unlock(&(rc->dbg)->list_lock);
140
141 if (!found)
142 return -EINVAL;
143
144 uwb_rsv_terminate(found);
145 uwb_rsv_put(found);
146
147 return 0;
148 }
149
cmd_ie_add(struct uwb_rc * rc,struct uwb_dbg_cmd_ie * ie_to_add)150 static int cmd_ie_add(struct uwb_rc *rc, struct uwb_dbg_cmd_ie *ie_to_add)
151 {
152 return uwb_rc_ie_add(rc,
153 (const struct uwb_ie_hdr *) ie_to_add->data,
154 ie_to_add->len);
155 }
156
cmd_ie_rm(struct uwb_rc * rc,struct uwb_dbg_cmd_ie * ie_to_rm)157 static int cmd_ie_rm(struct uwb_rc *rc, struct uwb_dbg_cmd_ie *ie_to_rm)
158 {
159 return uwb_rc_ie_rm(rc, ie_to_rm->data[0]);
160 }
161
command_write(struct file * file,const char __user * buf,size_t len,loff_t * off)162 static ssize_t command_write(struct file *file, const char __user *buf,
163 size_t len, loff_t *off)
164 {
165 struct uwb_rc *rc = file->private_data;
166 struct uwb_dbg_cmd cmd;
167 int ret = 0;
168
169 if (len != sizeof(struct uwb_dbg_cmd))
170 return -EINVAL;
171
172 if (copy_from_user(&cmd, buf, len) != 0)
173 return -EFAULT;
174
175 switch (cmd.type) {
176 case UWB_DBG_CMD_RSV_ESTABLISH:
177 ret = cmd_rsv_establish(rc, &cmd.rsv_establish);
178 break;
179 case UWB_DBG_CMD_RSV_TERMINATE:
180 ret = cmd_rsv_terminate(rc, &cmd.rsv_terminate);
181 break;
182 case UWB_DBG_CMD_IE_ADD:
183 ret = cmd_ie_add(rc, &cmd.ie_add);
184 break;
185 case UWB_DBG_CMD_IE_RM:
186 ret = cmd_ie_rm(rc, &cmd.ie_rm);
187 break;
188 case UWB_DBG_CMD_RADIO_START:
189 ret = uwb_radio_start(&rc->dbg->pal);
190 break;
191 case UWB_DBG_CMD_RADIO_STOP:
192 uwb_radio_stop(&rc->dbg->pal);
193 break;
194 default:
195 return -EINVAL;
196 }
197
198 return ret < 0 ? ret : len;
199 }
200
201 static const struct file_operations command_fops = {
202 .open = simple_open,
203 .write = command_write,
204 .read = NULL,
205 .llseek = no_llseek,
206 .owner = THIS_MODULE,
207 };
208
reservations_show(struct seq_file * s,void * p)209 static int reservations_show(struct seq_file *s, void *p)
210 {
211 struct uwb_rc *rc = s->private;
212 struct uwb_rsv *rsv;
213
214 mutex_lock(&rc->rsvs_mutex);
215
216 list_for_each_entry(rsv, &rc->reservations, rc_node) {
217 struct uwb_dev_addr devaddr;
218 char owner[UWB_ADDR_STRSIZE], target[UWB_ADDR_STRSIZE];
219 bool is_owner;
220
221 uwb_dev_addr_print(owner, sizeof(owner), &rsv->owner->dev_addr);
222 if (rsv->target.type == UWB_RSV_TARGET_DEV) {
223 devaddr = rsv->target.dev->dev_addr;
224 is_owner = &rc->uwb_dev == rsv->owner;
225 } else {
226 devaddr = rsv->target.devaddr;
227 is_owner = true;
228 }
229 uwb_dev_addr_print(target, sizeof(target), &devaddr);
230
231 seq_printf(s, "%c %s -> %s: %s\n",
232 is_owner ? 'O' : 'T',
233 owner, target, uwb_rsv_state_str(rsv->state));
234 seq_printf(s, " stream: %d type: %s\n",
235 rsv->stream, uwb_rsv_type_str(rsv->type));
236 seq_printf(s, " %*pb\n", UWB_NUM_MAS, rsv->mas.bm);
237 }
238
239 mutex_unlock(&rc->rsvs_mutex);
240
241 return 0;
242 }
243 DEFINE_SHOW_ATTRIBUTE(reservations);
244
drp_avail_show(struct seq_file * s,void * p)245 static int drp_avail_show(struct seq_file *s, void *p)
246 {
247 struct uwb_rc *rc = s->private;
248
249 seq_printf(s, "global: %*pb\n", UWB_NUM_MAS, rc->drp_avail.global);
250 seq_printf(s, "local: %*pb\n", UWB_NUM_MAS, rc->drp_avail.local);
251 seq_printf(s, "pending: %*pb\n", UWB_NUM_MAS, rc->drp_avail.pending);
252
253 return 0;
254 }
255 DEFINE_SHOW_ATTRIBUTE(drp_avail);
256
uwb_dbg_channel_changed(struct uwb_pal * pal,int channel)257 static void uwb_dbg_channel_changed(struct uwb_pal *pal, int channel)
258 {
259 struct device *dev = &pal->rc->uwb_dev.dev;
260
261 if (channel > 0)
262 dev_info(dev, "debug: channel %d started\n", channel);
263 else
264 dev_info(dev, "debug: channel stopped\n");
265 }
266
uwb_dbg_new_rsv(struct uwb_pal * pal,struct uwb_rsv * rsv)267 static void uwb_dbg_new_rsv(struct uwb_pal *pal, struct uwb_rsv *rsv)
268 {
269 struct uwb_dbg *dbg = container_of(pal, struct uwb_dbg, pal);
270
271 if (dbg->accept) {
272 spin_lock(&dbg->list_lock);
273 list_add_tail(&rsv->pal_node, &dbg->rsvs);
274 spin_unlock(&dbg->list_lock);
275 uwb_rsv_accept(rsv, uwb_dbg_rsv_cb, dbg);
276 }
277 }
278
279 /**
280 * uwb_dbg_add_rc - add a debug interface for a radio controller
281 * @rc: the radio controller
282 */
uwb_dbg_add_rc(struct uwb_rc * rc)283 void uwb_dbg_add_rc(struct uwb_rc *rc)
284 {
285 rc->dbg = kzalloc(sizeof(struct uwb_dbg), GFP_KERNEL);
286 if (rc->dbg == NULL)
287 return;
288
289 INIT_LIST_HEAD(&rc->dbg->rsvs);
290 spin_lock_init(&(rc->dbg)->list_lock);
291
292 uwb_pal_init(&rc->dbg->pal);
293 rc->dbg->pal.rc = rc;
294 rc->dbg->pal.channel_changed = uwb_dbg_channel_changed;
295 rc->dbg->pal.new_rsv = uwb_dbg_new_rsv;
296 uwb_pal_register(&rc->dbg->pal);
297
298 if (root_dir) {
299 rc->dbg->root_d = debugfs_create_dir(dev_name(&rc->uwb_dev.dev),
300 root_dir);
301 rc->dbg->command_f = debugfs_create_file("command", 0200,
302 rc->dbg->root_d, rc,
303 &command_fops);
304 rc->dbg->reservations_f = debugfs_create_file("reservations", 0444,
305 rc->dbg->root_d, rc,
306 &reservations_fops);
307 rc->dbg->accept_f = debugfs_create_bool("accept", 0644,
308 rc->dbg->root_d,
309 &rc->dbg->accept);
310 rc->dbg->drp_avail_f = debugfs_create_file("drp_avail", 0444,
311 rc->dbg->root_d, rc,
312 &drp_avail_fops);
313 }
314 }
315
316 /**
317 * uwb_dbg_del_rc - remove a radio controller's debug interface
318 * @rc: the radio controller
319 */
uwb_dbg_del_rc(struct uwb_rc * rc)320 void uwb_dbg_del_rc(struct uwb_rc *rc)
321 {
322 struct uwb_rsv *rsv, *t;
323
324 if (rc->dbg == NULL)
325 return;
326
327 list_for_each_entry_safe(rsv, t, &rc->dbg->rsvs, pal_node) {
328 uwb_rsv_terminate(rsv);
329 }
330
331 uwb_pal_unregister(&rc->dbg->pal);
332
333 if (root_dir) {
334 debugfs_remove(rc->dbg->drp_avail_f);
335 debugfs_remove(rc->dbg->accept_f);
336 debugfs_remove(rc->dbg->reservations_f);
337 debugfs_remove(rc->dbg->command_f);
338 debugfs_remove(rc->dbg->root_d);
339 }
340 }
341
342 /**
343 * uwb_dbg_exit - initialize the debug interface sub-module
344 */
uwb_dbg_init(void)345 void uwb_dbg_init(void)
346 {
347 root_dir = debugfs_create_dir("uwb", NULL);
348 }
349
350 /**
351 * uwb_dbg_exit - clean-up the debug interface sub-module
352 */
uwb_dbg_exit(void)353 void uwb_dbg_exit(void)
354 {
355 debugfs_remove(root_dir);
356 }
357
358 /**
359 * uwb_dbg_create_pal_dir - create a debugfs directory for a PAL
360 * @pal: The PAL.
361 */
uwb_dbg_create_pal_dir(struct uwb_pal * pal)362 struct dentry *uwb_dbg_create_pal_dir(struct uwb_pal *pal)
363 {
364 struct uwb_rc *rc = pal->rc;
365
366 if (root_dir && rc->dbg && rc->dbg->root_d && pal->name)
367 return debugfs_create_dir(pal->name, rc->dbg->root_d);
368 return NULL;
369 }
370