2 Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
3 <http://rt2x00.serialmonkey.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the
17 Free Software Foundation, Inc.,
18 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 Abstract: rt2x00 debugfs specific routines.
26 #include <linux/debugfs.h>
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/poll.h>
30 #include <linux/sched.h>
31 #include <linux/slab.h>
32 #include <linux/uaccess.h>
35 #include "rt2x00lib.h"
36 #include "rt2x00dump.h"
38 #define MAX_LINE_LENGTH 64
40 struct rt2x00debug_crypto
{
41 unsigned long success
;
42 unsigned long icv_error
;
43 unsigned long mic_error
;
44 unsigned long key_error
;
47 struct rt2x00debug_intf
{
49 * Pointer to driver structure where
50 * this debugfs entry belongs to.
52 struct rt2x00_dev
*rt2x00dev
;
55 * Reference to the rt2x00debug structure
56 * which can be used to communicate with
59 const struct rt2x00debug
*debug
;
62 * Debugfs entries for:
68 * - csr offset/value files
69 * - eeprom offset/value files
70 * - bbp offset/value files
71 * - rf offset/value files
77 struct dentry
*driver_folder
;
78 struct dentry
*driver_entry
;
79 struct dentry
*chipset_entry
;
80 struct dentry
*dev_flags
;
81 struct dentry
*register_folder
;
82 struct dentry
*csr_off_entry
;
83 struct dentry
*csr_val_entry
;
84 struct dentry
*eeprom_off_entry
;
85 struct dentry
*eeprom_val_entry
;
86 struct dentry
*bbp_off_entry
;
87 struct dentry
*bbp_val_entry
;
88 struct dentry
*rf_off_entry
;
89 struct dentry
*rf_val_entry
;
90 struct dentry
*queue_folder
;
91 struct dentry
*queue_frame_dump_entry
;
92 struct dentry
*queue_stats_entry
;
93 struct dentry
*crypto_stats_entry
;
96 * The frame dump file only allows a single reader,
97 * so we need to store the current state here.
99 unsigned long frame_dump_flags
;
100 #define FRAME_DUMP_FILE_OPEN 1
103 * We queue each frame before dumping it to the user,
104 * per read command we will pass a single skb structure
105 * so we should be prepared to queue multiple sk buffers
106 * before sending it to userspace.
108 struct sk_buff_head frame_dump_skbqueue
;
109 wait_queue_head_t frame_dump_waitqueue
;
112 * HW crypto statistics.
113 * All statistics are stored separately per cipher type.
115 struct rt2x00debug_crypto crypto_stats
[CIPHER_MAX
];
118 * Driver and chipset files will use a data buffer
119 * that has been created in advance. This will simplify
120 * the code since we can use the debugfs functions.
122 struct debugfs_blob_wrapper driver_blob
;
123 struct debugfs_blob_wrapper chipset_blob
;
126 * Requested offset for each register type.
128 unsigned int offset_csr
;
129 unsigned int offset_eeprom
;
130 unsigned int offset_bbp
;
131 unsigned int offset_rf
;
134 void rt2x00debug_update_crypto(struct rt2x00_dev
*rt2x00dev
,
135 struct rxdone_entry_desc
*rxdesc
)
137 struct rt2x00debug_intf
*intf
= rt2x00dev
->debugfs_intf
;
138 enum cipher cipher
= rxdesc
->cipher
;
139 enum rx_crypto status
= rxdesc
->cipher_status
;
141 if (cipher
== CIPHER_TKIP_NO_MIC
)
142 cipher
= CIPHER_TKIP
;
143 if (cipher
== CIPHER_NONE
|| cipher
>= CIPHER_MAX
)
146 /* Remove CIPHER_NONE index */
149 intf
->crypto_stats
[cipher
].success
+= (status
== RX_CRYPTO_SUCCESS
);
150 intf
->crypto_stats
[cipher
].icv_error
+= (status
== RX_CRYPTO_FAIL_ICV
);
151 intf
->crypto_stats
[cipher
].mic_error
+= (status
== RX_CRYPTO_FAIL_MIC
);
152 intf
->crypto_stats
[cipher
].key_error
+= (status
== RX_CRYPTO_FAIL_KEY
);
155 void rt2x00debug_dump_frame(struct rt2x00_dev
*rt2x00dev
,
156 enum rt2x00_dump_type type
, struct sk_buff
*skb
)
158 struct rt2x00debug_intf
*intf
= rt2x00dev
->debugfs_intf
;
159 struct skb_frame_desc
*skbdesc
= get_skb_frame_desc(skb
);
160 struct sk_buff
*skbcopy
;
161 struct rt2x00dump_hdr
*dump_hdr
;
162 struct timeval timestamp
;
165 if (likely(!test_bit(FRAME_DUMP_FILE_OPEN
, &intf
->frame_dump_flags
)))
168 do_gettimeofday(×tamp
);
170 if (skb_queue_len(&intf
->frame_dump_skbqueue
) > 20) {
171 DEBUG(rt2x00dev
, "txrx dump queue length exceeded.\n");
176 if (skbdesc
->flags
& SKBDESC_DESC_IN_SKB
)
177 data_len
-= skbdesc
->desc_len
;
179 skbcopy
= alloc_skb(sizeof(*dump_hdr
) + skbdesc
->desc_len
+ data_len
,
182 DEBUG(rt2x00dev
, "Failed to copy skb for dump.\n");
186 dump_hdr
= (struct rt2x00dump_hdr
*)skb_put(skbcopy
, sizeof(*dump_hdr
));
187 dump_hdr
->version
= cpu_to_le32(DUMP_HEADER_VERSION
);
188 dump_hdr
->header_length
= cpu_to_le32(sizeof(*dump_hdr
));
189 dump_hdr
->desc_length
= cpu_to_le32(skbdesc
->desc_len
);
190 dump_hdr
->data_length
= cpu_to_le32(data_len
);
191 dump_hdr
->chip_rt
= cpu_to_le16(rt2x00dev
->chip
.rt
);
192 dump_hdr
->chip_rf
= cpu_to_le16(rt2x00dev
->chip
.rf
);
193 dump_hdr
->chip_rev
= cpu_to_le16(rt2x00dev
->chip
.rev
);
194 dump_hdr
->type
= cpu_to_le16(type
);
195 dump_hdr
->queue_index
= skbdesc
->entry
->queue
->qid
;
196 dump_hdr
->entry_index
= skbdesc
->entry
->entry_idx
;
197 dump_hdr
->timestamp_sec
= cpu_to_le32(timestamp
.tv_sec
);
198 dump_hdr
->timestamp_usec
= cpu_to_le32(timestamp
.tv_usec
);
200 if (!(skbdesc
->flags
& SKBDESC_DESC_IN_SKB
))
201 memcpy(skb_put(skbcopy
, skbdesc
->desc_len
), skbdesc
->desc
,
203 memcpy(skb_put(skbcopy
, skb
->len
), skb
->data
, skb
->len
);
205 skb_queue_tail(&intf
->frame_dump_skbqueue
, skbcopy
);
206 wake_up_interruptible(&intf
->frame_dump_waitqueue
);
209 * Verify that the file has not been closed while we were working.
211 if (!test_bit(FRAME_DUMP_FILE_OPEN
, &intf
->frame_dump_flags
))
212 skb_queue_purge(&intf
->frame_dump_skbqueue
);
214 EXPORT_SYMBOL_GPL(rt2x00debug_dump_frame
);
216 static int rt2x00debug_file_open(struct inode
*inode
, struct file
*file
)
218 struct rt2x00debug_intf
*intf
= inode
->i_private
;
220 file
->private_data
= inode
->i_private
;
222 if (!try_module_get(intf
->debug
->owner
))
228 static int rt2x00debug_file_release(struct inode
*inode
, struct file
*file
)
230 struct rt2x00debug_intf
*intf
= file
->private_data
;
232 module_put(intf
->debug
->owner
);
237 static int rt2x00debug_open_queue_dump(struct inode
*inode
, struct file
*file
)
239 struct rt2x00debug_intf
*intf
= inode
->i_private
;
242 retval
= rt2x00debug_file_open(inode
, file
);
246 if (test_and_set_bit(FRAME_DUMP_FILE_OPEN
, &intf
->frame_dump_flags
)) {
247 rt2x00debug_file_release(inode
, file
);
254 static int rt2x00debug_release_queue_dump(struct inode
*inode
, struct file
*file
)
256 struct rt2x00debug_intf
*intf
= inode
->i_private
;
258 skb_queue_purge(&intf
->frame_dump_skbqueue
);
260 clear_bit(FRAME_DUMP_FILE_OPEN
, &intf
->frame_dump_flags
);
262 return rt2x00debug_file_release(inode
, file
);
265 static ssize_t
rt2x00debug_read_queue_dump(struct file
*file
,
270 struct rt2x00debug_intf
*intf
= file
->private_data
;
275 if (file
->f_flags
& O_NONBLOCK
)
279 wait_event_interruptible(intf
->frame_dump_waitqueue
,
281 skb_dequeue(&intf
->frame_dump_skbqueue
)));
285 status
= min((size_t)skb
->len
, length
);
286 if (copy_to_user(buf
, skb
->data
, status
)) {
299 static unsigned int rt2x00debug_poll_queue_dump(struct file
*file
,
302 struct rt2x00debug_intf
*intf
= file
->private_data
;
304 poll_wait(file
, &intf
->frame_dump_waitqueue
, wait
);
306 if (!skb_queue_empty(&intf
->frame_dump_skbqueue
))
307 return POLLOUT
| POLLWRNORM
;
312 static const struct file_operations rt2x00debug_fop_queue_dump
= {
313 .owner
= THIS_MODULE
,
314 .read
= rt2x00debug_read_queue_dump
,
315 .poll
= rt2x00debug_poll_queue_dump
,
316 .open
= rt2x00debug_open_queue_dump
,
317 .release
= rt2x00debug_release_queue_dump
,
318 .llseek
= default_llseek
,
321 static ssize_t
rt2x00debug_read_queue_stats(struct file
*file
,
326 struct rt2x00debug_intf
*intf
= file
->private_data
;
327 struct data_queue
*queue
;
328 unsigned long irqflags
;
329 unsigned int lines
= 1 + intf
->rt2x00dev
->data_queues
;
337 data
= kcalloc(lines
, MAX_LINE_LENGTH
, GFP_KERNEL
);
342 sprintf(data
, "qid\tflags\t\tcount\tlimit\tlength\tindex\tdma done\tdone\n");
344 queue_for_each(intf
->rt2x00dev
, queue
) {
345 spin_lock_irqsave(&queue
->index_lock
, irqflags
);
347 temp
+= sprintf(temp
, "%d\t0x%.8x\t%d\t%d\t%d\t%d\t%d\t\t%d\n",
348 queue
->qid
, (unsigned int)queue
->flags
,
349 queue
->count
, queue
->limit
, queue
->length
,
350 queue
->index
[Q_INDEX
],
351 queue
->index
[Q_INDEX_DMA_DONE
],
352 queue
->index
[Q_INDEX_DONE
]);
354 spin_unlock_irqrestore(&queue
->index_lock
, irqflags
);
358 size
= min(size
, length
);
360 if (copy_to_user(buf
, data
, size
)) {
371 static const struct file_operations rt2x00debug_fop_queue_stats
= {
372 .owner
= THIS_MODULE
,
373 .read
= rt2x00debug_read_queue_stats
,
374 .open
= rt2x00debug_file_open
,
375 .release
= rt2x00debug_file_release
,
376 .llseek
= default_llseek
,
379 #ifdef CONFIG_RT2X00_LIB_CRYPTO
380 static ssize_t
rt2x00debug_read_crypto_stats(struct file
*file
,
385 struct rt2x00debug_intf
*intf
= file
->private_data
;
386 static const char * const name
[] = { "WEP64", "WEP128", "TKIP", "AES" };
395 data
= kzalloc((1 + CIPHER_MAX
) * MAX_LINE_LENGTH
, GFP_KERNEL
);
400 temp
+= sprintf(data
, "cipher\tsuccess\ticv err\tmic err\tkey err\n");
402 for (i
= 0; i
< CIPHER_MAX
; i
++) {
403 temp
+= sprintf(temp
, "%s\t%lu\t%lu\t%lu\t%lu\n", name
[i
],
404 intf
->crypto_stats
[i
].success
,
405 intf
->crypto_stats
[i
].icv_error
,
406 intf
->crypto_stats
[i
].mic_error
,
407 intf
->crypto_stats
[i
].key_error
);
411 size
= min(size
, length
);
413 if (copy_to_user(buf
, data
, size
)) {
424 static const struct file_operations rt2x00debug_fop_crypto_stats
= {
425 .owner
= THIS_MODULE
,
426 .read
= rt2x00debug_read_crypto_stats
,
427 .open
= rt2x00debug_file_open
,
428 .release
= rt2x00debug_file_release
,
429 .llseek
= default_llseek
,
433 #define RT2X00DEBUGFS_OPS_READ(__name, __format, __type) \
434 static ssize_t rt2x00debug_read_##__name(struct file *file, \
439 struct rt2x00debug_intf *intf = file->private_data; \
440 const struct rt2x00debug *debug = intf->debug; \
443 unsigned int index = intf->offset_##__name; \
449 if (index >= debug->__name.word_count) \
452 index += (debug->__name.word_base / \
453 debug->__name.word_size); \
455 if (debug->__name.flags & RT2X00DEBUGFS_OFFSET) \
456 index *= debug->__name.word_size; \
458 debug->__name.read(intf->rt2x00dev, index, &value); \
460 size = sprintf(line, __format, value); \
462 if (copy_to_user(buf, line, size)) \
469 #define RT2X00DEBUGFS_OPS_WRITE(__name, __type) \
470 static ssize_t rt2x00debug_write_##__name(struct file *file, \
471 const char __user *buf,\
475 struct rt2x00debug_intf *intf = file->private_data; \
476 const struct rt2x00debug *debug = intf->debug; \
479 unsigned int index = intf->offset_##__name; \
485 if (index >= debug->__name.word_count) \
488 if (length > sizeof(line)) \
491 if (copy_from_user(line, buf, length)) \
494 size = strlen(line); \
495 value = simple_strtoul(line, NULL, 0); \
497 index += (debug->__name.word_base / \
498 debug->__name.word_size); \
500 if (debug->__name.flags & RT2X00DEBUGFS_OFFSET) \
501 index *= debug->__name.word_size; \
503 debug->__name.write(intf->rt2x00dev, index, value); \
509 #define RT2X00DEBUGFS_OPS(__name, __format, __type) \
510 RT2X00DEBUGFS_OPS_READ(__name, __format, __type); \
511 RT2X00DEBUGFS_OPS_WRITE(__name, __type); \
513 static const struct file_operations rt2x00debug_fop_##__name = {\
514 .owner = THIS_MODULE, \
515 .read = rt2x00debug_read_##__name, \
516 .write = rt2x00debug_write_##__name, \
517 .open = rt2x00debug_file_open, \
518 .release = rt2x00debug_file_release, \
519 .llseek = generic_file_llseek, \
522 RT2X00DEBUGFS_OPS(csr
, "0x%.8x\n", u32
);
523 RT2X00DEBUGFS_OPS(eeprom
, "0x%.4x\n", u16
);
524 RT2X00DEBUGFS_OPS(bbp
, "0x%.2x\n", u8
);
525 RT2X00DEBUGFS_OPS(rf
, "0x%.8x\n", u32
);
527 static ssize_t
rt2x00debug_read_dev_flags(struct file
*file
,
532 struct rt2x00debug_intf
*intf
= file
->private_data
;
539 size
= sprintf(line
, "0x%.8x\n", (unsigned int)intf
->rt2x00dev
->flags
);
541 if (copy_to_user(buf
, line
, size
))
548 static const struct file_operations rt2x00debug_fop_dev_flags
= {
549 .owner
= THIS_MODULE
,
550 .read
= rt2x00debug_read_dev_flags
,
551 .open
= rt2x00debug_file_open
,
552 .release
= rt2x00debug_file_release
,
553 .llseek
= default_llseek
,
556 static struct dentry
*rt2x00debug_create_file_driver(const char *name
,
557 struct rt2x00debug_intf
559 struct debugfs_blob_wrapper
564 data
= kzalloc(3 * MAX_LINE_LENGTH
, GFP_KERNEL
);
569 data
+= sprintf(data
, "driver:\t%s\n", intf
->rt2x00dev
->ops
->name
);
570 data
+= sprintf(data
, "version:\t%s\n", DRV_VERSION
);
571 data
+= sprintf(data
, "compiled:\t%s %s\n", __DATE__
, __TIME__
);
572 blob
->size
= strlen(blob
->data
);
574 return debugfs_create_blob(name
, S_IRUSR
, intf
->driver_folder
, blob
);
577 static struct dentry
*rt2x00debug_create_file_chipset(const char *name
,
578 struct rt2x00debug_intf
584 const struct rt2x00debug
*debug
= intf
->debug
;
587 data
= kzalloc(8 * MAX_LINE_LENGTH
, GFP_KERNEL
);
592 data
+= sprintf(data
, "rt chip:\t%04x\n", intf
->rt2x00dev
->chip
.rt
);
593 data
+= sprintf(data
, "rf chip:\t%04x\n", intf
->rt2x00dev
->chip
.rf
);
594 data
+= sprintf(data
, "revision:\t%04x\n", intf
->rt2x00dev
->chip
.rev
);
595 data
+= sprintf(data
, "\n");
596 data
+= sprintf(data
, "register\tbase\twords\twordsize\n");
597 data
+= sprintf(data
, "csr\t%d\t%d\t%d\n",
598 debug
->csr
.word_base
,
599 debug
->csr
.word_count
,
600 debug
->csr
.word_size
);
601 data
+= sprintf(data
, "eeprom\t%d\t%d\t%d\n",
602 debug
->eeprom
.word_base
,
603 debug
->eeprom
.word_count
,
604 debug
->eeprom
.word_size
);
605 data
+= sprintf(data
, "bbp\t%d\t%d\t%d\n",
606 debug
->bbp
.word_base
,
607 debug
->bbp
.word_count
,
608 debug
->bbp
.word_size
);
609 data
+= sprintf(data
, "rf\t%d\t%d\t%d\n",
611 debug
->rf
.word_count
,
612 debug
->rf
.word_size
);
613 blob
->size
= strlen(blob
->data
);
615 return debugfs_create_blob(name
, S_IRUSR
, intf
->driver_folder
, blob
);
618 void rt2x00debug_register(struct rt2x00_dev
*rt2x00dev
)
620 const struct rt2x00debug
*debug
= rt2x00dev
->ops
->debugfs
;
621 struct rt2x00debug_intf
*intf
;
623 intf
= kzalloc(sizeof(struct rt2x00debug_intf
), GFP_KERNEL
);
625 ERROR(rt2x00dev
, "Failed to allocate debug handler.\n");
630 intf
->rt2x00dev
= rt2x00dev
;
631 rt2x00dev
->debugfs_intf
= intf
;
633 intf
->driver_folder
=
634 debugfs_create_dir(intf
->rt2x00dev
->ops
->name
,
635 rt2x00dev
->hw
->wiphy
->debugfsdir
);
636 if (IS_ERR(intf
->driver_folder
) || !intf
->driver_folder
)
640 rt2x00debug_create_file_driver("driver", intf
, &intf
->driver_blob
);
641 if (IS_ERR(intf
->driver_entry
) || !intf
->driver_entry
)
644 intf
->chipset_entry
=
645 rt2x00debug_create_file_chipset("chipset",
646 intf
, &intf
->chipset_blob
);
647 if (IS_ERR(intf
->chipset_entry
) || !intf
->chipset_entry
)
650 intf
->dev_flags
= debugfs_create_file("dev_flags", S_IRUSR
,
651 intf
->driver_folder
, intf
,
652 &rt2x00debug_fop_dev_flags
);
653 if (IS_ERR(intf
->dev_flags
) || !intf
->dev_flags
)
656 intf
->register_folder
=
657 debugfs_create_dir("register", intf
->driver_folder
);
658 if (IS_ERR(intf
->register_folder
) || !intf
->register_folder
)
661 #define RT2X00DEBUGFS_CREATE_REGISTER_ENTRY(__intf, __name) \
663 (__intf)->__name##_off_entry = \
664 debugfs_create_u32(__stringify(__name) "_offset", \
666 (__intf)->register_folder, \
667 &(__intf)->offset_##__name); \
668 if (IS_ERR((__intf)->__name##_off_entry) \
669 || !(__intf)->__name##_off_entry) \
672 (__intf)->__name##_val_entry = \
673 debugfs_create_file(__stringify(__name) "_value", \
675 (__intf)->register_folder, \
676 (__intf), &rt2x00debug_fop_##__name);\
677 if (IS_ERR((__intf)->__name##_val_entry) \
678 || !(__intf)->__name##_val_entry) \
682 RT2X00DEBUGFS_CREATE_REGISTER_ENTRY(intf
, csr
);
683 RT2X00DEBUGFS_CREATE_REGISTER_ENTRY(intf
, eeprom
);
684 RT2X00DEBUGFS_CREATE_REGISTER_ENTRY(intf
, bbp
);
685 RT2X00DEBUGFS_CREATE_REGISTER_ENTRY(intf
, rf
);
687 #undef RT2X00DEBUGFS_CREATE_REGISTER_ENTRY
690 debugfs_create_dir("queue", intf
->driver_folder
);
691 if (IS_ERR(intf
->queue_folder
) || !intf
->queue_folder
)
694 intf
->queue_frame_dump_entry
=
695 debugfs_create_file("dump", S_IRUSR
, intf
->queue_folder
,
696 intf
, &rt2x00debug_fop_queue_dump
);
697 if (IS_ERR(intf
->queue_frame_dump_entry
)
698 || !intf
->queue_frame_dump_entry
)
701 skb_queue_head_init(&intf
->frame_dump_skbqueue
);
702 init_waitqueue_head(&intf
->frame_dump_waitqueue
);
704 intf
->queue_stats_entry
=
705 debugfs_create_file("queue", S_IRUSR
, intf
->queue_folder
,
706 intf
, &rt2x00debug_fop_queue_stats
);
708 #ifdef CONFIG_RT2X00_LIB_CRYPTO
709 if (test_bit(CONFIG_SUPPORT_HW_CRYPTO
, &rt2x00dev
->flags
))
710 intf
->crypto_stats_entry
=
711 debugfs_create_file("crypto", S_IRUGO
, intf
->queue_folder
,
712 intf
, &rt2x00debug_fop_crypto_stats
);
718 rt2x00debug_deregister(rt2x00dev
);
719 ERROR(rt2x00dev
, "Failed to register debug handler.\n");
722 void rt2x00debug_deregister(struct rt2x00_dev
*rt2x00dev
)
724 struct rt2x00debug_intf
*intf
= rt2x00dev
->debugfs_intf
;
729 skb_queue_purge(&intf
->frame_dump_skbqueue
);
731 #ifdef CONFIG_RT2X00_LIB_CRYPTO
732 debugfs_remove(intf
->crypto_stats_entry
);
734 debugfs_remove(intf
->queue_stats_entry
);
735 debugfs_remove(intf
->queue_frame_dump_entry
);
736 debugfs_remove(intf
->queue_folder
);
737 debugfs_remove(intf
->rf_val_entry
);
738 debugfs_remove(intf
->rf_off_entry
);
739 debugfs_remove(intf
->bbp_val_entry
);
740 debugfs_remove(intf
->bbp_off_entry
);
741 debugfs_remove(intf
->eeprom_val_entry
);
742 debugfs_remove(intf
->eeprom_off_entry
);
743 debugfs_remove(intf
->csr_val_entry
);
744 debugfs_remove(intf
->csr_off_entry
);
745 debugfs_remove(intf
->register_folder
);
746 debugfs_remove(intf
->dev_flags
);
747 debugfs_remove(intf
->chipset_entry
);
748 debugfs_remove(intf
->driver_entry
);
749 debugfs_remove(intf
->driver_folder
);
750 kfree(intf
->chipset_blob
.data
);
751 kfree(intf
->driver_blob
.data
);
754 rt2x00dev
->debugfs_intf
= NULL
;