xref: /linux/drivers/net/wireless/ath/ath10k/debug.h (revision e5c86679d5e864947a52fb31e45a425dea3e7fa9)
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_AHB		= 0x00008000,
41 	ATH10K_DBG_ANY		= 0xffffffff,
42 };
43 
44 enum ath10k_pktlog_filter {
45 	ATH10K_PKTLOG_RX         = 0x000000001,
46 	ATH10K_PKTLOG_TX         = 0x000000002,
47 	ATH10K_PKTLOG_RCFIND     = 0x000000004,
48 	ATH10K_PKTLOG_RCUPDATE   = 0x000000008,
49 	ATH10K_PKTLOG_DBG_PRINT  = 0x000000010,
50 	ATH10K_PKTLOG_ANY        = 0x00000001f,
51 };
52 
53 enum ath10k_dbg_aggr_mode {
54 	ATH10K_DBG_AGGR_MODE_AUTO,
55 	ATH10K_DBG_AGGR_MODE_MANUAL,
56 	ATH10K_DBG_AGGR_MODE_MAX,
57 };
58 
59 /* FIXME: How to calculate the buffer size sanely? */
60 #define ATH10K_FW_STATS_BUF_SIZE (1024 * 1024)
61 
62 extern unsigned int ath10k_debug_mask;
63 
64 __printf(2, 3) void ath10k_info(struct ath10k *ar, const char *fmt, ...);
65 __printf(2, 3) void ath10k_err(struct ath10k *ar, const char *fmt, ...);
66 __printf(2, 3) void ath10k_warn(struct ath10k *ar, const char *fmt, ...);
67 
68 void ath10k_debug_print_hwfw_info(struct ath10k *ar);
69 void ath10k_debug_print_board_info(struct ath10k *ar);
70 void ath10k_debug_print_boot_info(struct ath10k *ar);
71 void ath10k_print_driver_info(struct ath10k *ar);
72 
73 #ifdef CONFIG_ATH10K_DEBUGFS
74 int ath10k_debug_start(struct ath10k *ar);
75 void ath10k_debug_stop(struct ath10k *ar);
76 int ath10k_debug_create(struct ath10k *ar);
77 void ath10k_debug_destroy(struct ath10k *ar);
78 int ath10k_debug_register(struct ath10k *ar);
79 void ath10k_debug_unregister(struct ath10k *ar);
80 void ath10k_debug_fw_stats_process(struct ath10k *ar, struct sk_buff *skb);
81 void ath10k_debug_tpc_stats_process(struct ath10k *ar,
82 				    struct ath10k_tpc_stats *tpc_stats);
83 struct ath10k_fw_crash_data *
84 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar);
85 
86 void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer, int len);
87 
88 int ath10k_debug_fw_devcoredump(struct ath10k *ar);
89 
90 #define ATH10K_DFS_STAT_INC(ar, c) (ar->debug.dfs_stats.c++)
91 
92 void ath10k_debug_get_et_strings(struct ieee80211_hw *hw,
93 				 struct ieee80211_vif *vif,
94 				 u32 sset, u8 *data);
95 int ath10k_debug_get_et_sset_count(struct ieee80211_hw *hw,
96 				   struct ieee80211_vif *vif, int sset);
97 void ath10k_debug_get_et_stats(struct ieee80211_hw *hw,
98 			       struct ieee80211_vif *vif,
99 			       struct ethtool_stats *stats, u64 *data);
100 
101 static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
102 {
103 	return ar->debug.fw_dbglog_mask;
104 }
105 
106 static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
107 {
108 	return ar->debug.fw_dbglog_level;
109 }
110 
111 #else
112 
113 static inline int ath10k_debug_start(struct ath10k *ar)
114 {
115 	return 0;
116 }
117 
118 static inline void ath10k_debug_stop(struct ath10k *ar)
119 {
120 }
121 
122 static inline int ath10k_debug_create(struct ath10k *ar)
123 {
124 	return 0;
125 }
126 
127 static inline void ath10k_debug_destroy(struct ath10k *ar)
128 {
129 }
130 
131 static inline int ath10k_debug_register(struct ath10k *ar)
132 {
133 	return 0;
134 }
135 
136 static inline void ath10k_debug_unregister(struct ath10k *ar)
137 {
138 }
139 
140 static inline void ath10k_debug_fw_stats_process(struct ath10k *ar,
141 						 struct sk_buff *skb)
142 {
143 }
144 
145 static inline void ath10k_debug_tpc_stats_process(struct ath10k *ar,
146 						  struct ath10k_tpc_stats *tpc_stats)
147 {
148 	kfree(tpc_stats);
149 }
150 
151 static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
152 					   int len)
153 {
154 }
155 
156 static inline struct ath10k_fw_crash_data *
157 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar)
158 {
159 	return NULL;
160 }
161 
162 static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
163 {
164 	return 0;
165 }
166 
167 static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
168 {
169 	return 0;
170 }
171 
172 static inline int ath10k_debug_fw_devcoredump(struct ath10k *ar)
173 {
174 	return 0;
175 }
176 
177 #define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
178 
179 #define ath10k_debug_get_et_strings NULL
180 #define ath10k_debug_get_et_sset_count NULL
181 #define ath10k_debug_get_et_stats NULL
182 
183 #endif /* CONFIG_ATH10K_DEBUGFS */
184 #ifdef CONFIG_MAC80211_DEBUGFS
185 void ath10k_sta_add_debugfs(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
186 			    struct ieee80211_sta *sta, struct dentry *dir);
187 void ath10k_sta_update_rx_duration(struct ath10k *ar,
188 				   struct ath10k_fw_stats *stats);
189 void ath10k_sta_statistics(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
190 			   struct ieee80211_sta *sta,
191 			   struct station_info *sinfo);
192 #else
193 static inline
194 void ath10k_sta_update_rx_duration(struct ath10k *ar,
195 				   struct ath10k_fw_stats *stats)
196 {
197 }
198 #endif /* CONFIG_MAC80211_DEBUGFS */
199 
200 #ifdef CONFIG_ATH10K_DEBUG
201 __printf(3, 4) void ath10k_dbg(struct ath10k *ar,
202 			       enum ath10k_debug_mask mask,
203 			       const char *fmt, ...);
204 void ath10k_dbg_dump(struct ath10k *ar,
205 		     enum ath10k_debug_mask mask,
206 		     const char *msg, const char *prefix,
207 		     const void *buf, size_t len);
208 #else /* CONFIG_ATH10K_DEBUG */
209 
210 static inline int ath10k_dbg(struct ath10k *ar,
211 			     enum ath10k_debug_mask dbg_mask,
212 			     const char *fmt, ...)
213 {
214 	return 0;
215 }
216 
217 static inline void ath10k_dbg_dump(struct ath10k *ar,
218 				   enum ath10k_debug_mask mask,
219 				   const char *msg, const char *prefix,
220 				   const void *buf, size_t len)
221 {
222 }
223 #endif /* CONFIG_ATH10K_DEBUG */
224 #endif /* _DEBUG_H_ */
225