xref: /linux/drivers/net/wireless/ath/ath10k/debug.h (revision 7c66e12136c2fa421ae75497e02728f252108a1b)
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 #define ATH10K_DFS_STAT_INC(ar, c) (ar->debug.dfs_stats.c++)
88 
89 void ath10k_debug_get_et_strings(struct ieee80211_hw *hw,
90 				 struct ieee80211_vif *vif,
91 				 u32 sset, u8 *data);
92 int ath10k_debug_get_et_sset_count(struct ieee80211_hw *hw,
93 				   struct ieee80211_vif *vif, int sset);
94 void ath10k_debug_get_et_stats(struct ieee80211_hw *hw,
95 			       struct ieee80211_vif *vif,
96 			       struct ethtool_stats *stats, u64 *data);
97 #else
98 static inline int ath10k_debug_start(struct ath10k *ar)
99 {
100 	return 0;
101 }
102 
103 static inline void ath10k_debug_stop(struct ath10k *ar)
104 {
105 }
106 
107 static inline int ath10k_debug_create(struct ath10k *ar)
108 {
109 	return 0;
110 }
111 
112 static inline void ath10k_debug_destroy(struct ath10k *ar)
113 {
114 }
115 
116 static inline int ath10k_debug_register(struct ath10k *ar)
117 {
118 	return 0;
119 }
120 
121 static inline void ath10k_debug_unregister(struct ath10k *ar)
122 {
123 }
124 
125 static inline void ath10k_debug_fw_stats_process(struct ath10k *ar,
126 						 struct sk_buff *skb)
127 {
128 }
129 
130 static inline void ath10k_debug_tpc_stats_process(struct ath10k *ar,
131 						  struct ath10k_tpc_stats *tpc_stats)
132 {
133 	kfree(tpc_stats);
134 }
135 
136 static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
137 					   int len)
138 {
139 }
140 
141 static inline struct ath10k_fw_crash_data *
142 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar)
143 {
144 	return NULL;
145 }
146 
147 #define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
148 
149 #define ath10k_debug_get_et_strings NULL
150 #define ath10k_debug_get_et_sset_count NULL
151 #define ath10k_debug_get_et_stats NULL
152 
153 #endif /* CONFIG_ATH10K_DEBUGFS */
154 #ifdef CONFIG_MAC80211_DEBUGFS
155 void ath10k_sta_add_debugfs(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
156 			    struct ieee80211_sta *sta, struct dentry *dir);
157 void ath10k_sta_update_rx_duration(struct ath10k *ar,
158 				   struct ath10k_fw_stats *stats);
159 void ath10k_sta_statistics(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
160 			   struct ieee80211_sta *sta,
161 			   struct station_info *sinfo);
162 #else
163 static inline
164 void ath10k_sta_update_rx_duration(struct ath10k *ar,
165 				   struct ath10k_fw_stats *stats)
166 {
167 }
168 #endif /* CONFIG_MAC80211_DEBUGFS */
169 
170 #ifdef CONFIG_ATH10K_DEBUG
171 __printf(3, 4) void ath10k_dbg(struct ath10k *ar,
172 			       enum ath10k_debug_mask mask,
173 			       const char *fmt, ...);
174 void ath10k_dbg_dump(struct ath10k *ar,
175 		     enum ath10k_debug_mask mask,
176 		     const char *msg, const char *prefix,
177 		     const void *buf, size_t len);
178 #else /* CONFIG_ATH10K_DEBUG */
179 
180 static inline int ath10k_dbg(struct ath10k *ar,
181 			     enum ath10k_debug_mask dbg_mask,
182 			     const char *fmt, ...)
183 {
184 	return 0;
185 }
186 
187 static inline void ath10k_dbg_dump(struct ath10k *ar,
188 				   enum ath10k_debug_mask mask,
189 				   const char *msg, const char *prefix,
190 				   const void *buf, size_t len)
191 {
192 }
193 #endif /* CONFIG_ATH10K_DEBUG */
194 #endif /* _DEBUG_H_ */
195