1 /*
2  * Copyright (c) 2005-2011 Atheros Communications Inc.
3  * Copyright (c) 2011-2013 Qualcomm Atheros, Inc.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  */
17 
18 #ifndef _DEBUG_H_
19 #define _DEBUG_H_
20 
21 #include <linux/types.h>
22 #include "trace.h"
23 
24 enum ath10k_debug_mask {
25 	ATH10K_DBG_PCI		= 0x00000001,
26 	ATH10K_DBG_WMI		= 0x00000002,
27 	ATH10K_DBG_HTC		= 0x00000004,
28 	ATH10K_DBG_HTT		= 0x00000008,
29 	ATH10K_DBG_MAC		= 0x00000010,
30 	ATH10K_DBG_BOOT		= 0x00000020,
31 	ATH10K_DBG_PCI_DUMP	= 0x00000040,
32 	ATH10K_DBG_HTT_DUMP	= 0x00000080,
33 	ATH10K_DBG_MGMT		= 0x00000100,
34 	ATH10K_DBG_DATA		= 0x00000200,
35 	ATH10K_DBG_BMI		= 0x00000400,
36 	ATH10K_DBG_REGULATORY	= 0x00000800,
37 	ATH10K_DBG_TESTMODE	= 0x00001000,
38 	ATH10K_DBG_WMI_PRINT	= 0x00002000,
39 	ATH10K_DBG_PCI_PS	= 0x00004000,
40 	ATH10K_DBG_ANY		= 0xffffffff,
41 };
42 
43 enum ath10k_pktlog_filter {
44 	ATH10K_PKTLOG_RX         = 0x000000001,
45 	ATH10K_PKTLOG_TX         = 0x000000002,
46 	ATH10K_PKTLOG_RCFIND     = 0x000000004,
47 	ATH10K_PKTLOG_RCUPDATE   = 0x000000008,
48 	ATH10K_PKTLOG_DBG_PRINT  = 0x000000010,
49 	ATH10K_PKTLOG_ANY        = 0x00000001f,
50 };
51 
52 enum ath10k_dbg_aggr_mode {
53 	ATH10K_DBG_AGGR_MODE_AUTO,
54 	ATH10K_DBG_AGGR_MODE_MANUAL,
55 	ATH10K_DBG_AGGR_MODE_MAX,
56 };
57 
58 /* FIXME: How to calculate the buffer size sanely? */
59 #define ATH10K_FW_STATS_BUF_SIZE (1024*1024)
60 
61 extern unsigned int ath10k_debug_mask;
62 
63 __printf(2, 3) void ath10k_info(struct ath10k *ar, const char *fmt, ...);
64 __printf(2, 3) void ath10k_err(struct ath10k *ar, const char *fmt, ...);
65 __printf(2, 3) void ath10k_warn(struct ath10k *ar, const char *fmt, ...);
66 
67 void ath10k_debug_print_hwfw_info(struct ath10k *ar);
68 void ath10k_debug_print_board_info(struct ath10k *ar);
69 void ath10k_debug_print_boot_info(struct ath10k *ar);
70 void ath10k_print_driver_info(struct ath10k *ar);
71 
72 #ifdef CONFIG_ATH10K_DEBUGFS
73 int ath10k_debug_start(struct ath10k *ar);
74 void ath10k_debug_stop(struct ath10k *ar);
75 int ath10k_debug_create(struct ath10k *ar);
76 void ath10k_debug_destroy(struct ath10k *ar);
77 int ath10k_debug_register(struct ath10k *ar);
78 void ath10k_debug_unregister(struct ath10k *ar);
79 void ath10k_debug_fw_stats_process(struct ath10k *ar, struct sk_buff *skb);
80 void ath10k_debug_tpc_stats_process(struct ath10k *ar,
81 				    struct ath10k_tpc_stats *tpc_stats);
82 struct ath10k_fw_crash_data *
83 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar);
84 
85 void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer, int len);
86 #define ATH10K_DFS_STAT_INC(ar, c) (ar->debug.dfs_stats.c++)
87 
88 void ath10k_debug_get_et_strings(struct ieee80211_hw *hw,
89 				 struct ieee80211_vif *vif,
90 				 u32 sset, u8 *data);
91 int ath10k_debug_get_et_sset_count(struct ieee80211_hw *hw,
92 				   struct ieee80211_vif *vif, int sset);
93 void ath10k_debug_get_et_stats(struct ieee80211_hw *hw,
94 			       struct ieee80211_vif *vif,
95 			       struct ethtool_stats *stats, u64 *data);
96 #else
97 static inline int ath10k_debug_start(struct ath10k *ar)
98 {
99 	return 0;
100 }
101 
102 static inline void ath10k_debug_stop(struct ath10k *ar)
103 {
104 }
105 
106 static inline int ath10k_debug_create(struct ath10k *ar)
107 {
108 	return 0;
109 }
110 
111 static inline void ath10k_debug_destroy(struct ath10k *ar)
112 {
113 }
114 
115 static inline int ath10k_debug_register(struct ath10k *ar)
116 {
117 	return 0;
118 }
119 
120 static inline void ath10k_debug_unregister(struct ath10k *ar)
121 {
122 }
123 
124 static inline void ath10k_debug_fw_stats_process(struct ath10k *ar,
125 						 struct sk_buff *skb)
126 {
127 }
128 
129 static inline void ath10k_debug_tpc_stats_process(struct ath10k *ar,
130 						  struct ath10k_tpc_stats *tpc_stats)
131 {
132 	kfree(tpc_stats);
133 }
134 
135 static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
136 					   int len)
137 {
138 }
139 
140 static inline struct ath10k_fw_crash_data *
141 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar)
142 {
143 	return NULL;
144 }
145 
146 #define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
147 
148 #define ath10k_debug_get_et_strings NULL
149 #define ath10k_debug_get_et_sset_count NULL
150 #define ath10k_debug_get_et_stats NULL
151 
152 #endif /* CONFIG_ATH10K_DEBUGFS */
153 #ifdef CONFIG_MAC80211_DEBUGFS
154 void ath10k_sta_add_debugfs(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
155 			    struct ieee80211_sta *sta, struct dentry *dir);
156 #endif /* CONFIG_MAC80211_DEBUGFS */
157 
158 #ifdef CONFIG_ATH10K_DEBUG
159 __printf(3, 4) void ath10k_dbg(struct ath10k *ar,
160 			       enum ath10k_debug_mask mask,
161 			       const char *fmt, ...);
162 void ath10k_dbg_dump(struct ath10k *ar,
163 		     enum ath10k_debug_mask mask,
164 		     const char *msg, const char *prefix,
165 		     const void *buf, size_t len);
166 #else /* CONFIG_ATH10K_DEBUG */
167 
168 static inline int ath10k_dbg(struct ath10k *ar,
169 			     enum ath10k_debug_mask dbg_mask,
170 			     const char *fmt, ...)
171 {
172 	return 0;
173 }
174 
175 static inline void ath10k_dbg_dump(struct ath10k *ar,
176 				   enum ath10k_debug_mask mask,
177 				   const char *msg, const char *prefix,
178 				   const void *buf, size_t len)
179 {
180 }
181 #endif /* CONFIG_ATH10K_DEBUG */
182 #endif /* _DEBUG_H_ */
183