1 /* SPDX-License-Identifier: ISC */
2 /*
3 * Copyright (c) 2005-2011 Atheros Communications Inc.
4 * Copyright (c) 2011-2017 Qualcomm Atheros, Inc.
5 * Copyright (c) 2018, The Linux Foundation. All rights reserved.
6 */
7
8 #ifndef _DEBUG_H_
9 #define _DEBUG_H_
10
11 #include <linux/types.h>
12 #include "trace.h"
13
14 enum ath10k_debug_mask {
15 ATH10K_DBG_PCI = 0x00000001,
16 ATH10K_DBG_WMI = 0x00000002,
17 ATH10K_DBG_HTC = 0x00000004,
18 ATH10K_DBG_HTT = 0x00000008,
19 ATH10K_DBG_MAC = 0x00000010,
20 ATH10K_DBG_BOOT = 0x00000020,
21 ATH10K_DBG_PCI_DUMP = 0x00000040,
22 ATH10K_DBG_HTT_DUMP = 0x00000080,
23 ATH10K_DBG_MGMT = 0x00000100,
24 ATH10K_DBG_DATA = 0x00000200,
25 ATH10K_DBG_BMI = 0x00000400,
26 ATH10K_DBG_REGULATORY = 0x00000800,
27 ATH10K_DBG_TESTMODE = 0x00001000,
28 ATH10K_DBG_WMI_PRINT = 0x00002000,
29 ATH10K_DBG_PCI_PS = 0x00004000,
30 ATH10K_DBG_AHB = 0x00008000,
31 ATH10K_DBG_SDIO = 0x00010000,
32 ATH10K_DBG_SDIO_DUMP = 0x00020000,
33 ATH10K_DBG_USB = 0x00040000,
34 ATH10K_DBG_USB_BULK = 0x00080000,
35 ATH10K_DBG_SNOC = 0x00100000,
36 ATH10K_DBG_QMI = 0x00200000,
37 ATH10K_DBG_ANY = 0xffffffff,
38 };
39
40 enum ath10k_pktlog_filter {
41 ATH10K_PKTLOG_RX = 0x000000001,
42 ATH10K_PKTLOG_TX = 0x000000002,
43 ATH10K_PKTLOG_RCFIND = 0x000000004,
44 ATH10K_PKTLOG_RCUPDATE = 0x000000008,
45 ATH10K_PKTLOG_DBG_PRINT = 0x000000010,
46 ATH10K_PKTLOG_PEER_STATS = 0x000000040,
47 ATH10K_PKTLOG_ANY = 0x00000005f,
48 };
49
50 enum ath10k_dbg_aggr_mode {
51 ATH10K_DBG_AGGR_MODE_AUTO,
52 ATH10K_DBG_AGGR_MODE_MANUAL,
53 ATH10K_DBG_AGGR_MODE_MAX,
54 };
55
56 /* Types of packet log events */
57 enum ath_pktlog_type {
58 ATH_PKTLOG_TYPE_TX_CTRL = 1,
59 ATH_PKTLOG_TYPE_TX_STAT,
60 };
61
62 struct ath10k_pktlog_hdr {
63 __le16 flags;
64 __le16 missed_cnt;
65 __le16 log_type; /* Type of log information foll this header */
66 __le16 size; /* Size of variable length log information in bytes */
67 __le32 timestamp;
68 u8 payload[];
69 } __packed;
70
71 /* FIXME: How to calculate the buffer size sanely? */
72 #define ATH10K_FW_STATS_BUF_SIZE (1024 * 1024)
73
74 #define ATH10K_TX_POWER_MAX_VAL 70
75 #define ATH10K_TX_POWER_MIN_VAL 0
76
77 extern unsigned int ath10k_debug_mask;
78
79 __printf(2, 3) void ath10k_info(struct ath10k *ar, const char *fmt, ...);
80 __printf(2, 3) void ath10k_err(struct ath10k *ar, const char *fmt, ...);
81 __printf(2, 3) void ath10k_warn(struct ath10k *ar, const char *fmt, ...);
82
83 void ath10k_debug_print_hwfw_info(struct ath10k *ar);
84 void ath10k_debug_print_board_info(struct ath10k *ar);
85 void ath10k_debug_print_boot_info(struct ath10k *ar);
86 void ath10k_print_driver_info(struct ath10k *ar);
87
88 #ifdef CONFIG_ATH10K_DEBUGFS
89 int ath10k_debug_start(struct ath10k *ar);
90 void ath10k_debug_stop(struct ath10k *ar);
91 int ath10k_debug_create(struct ath10k *ar);
92 void ath10k_debug_destroy(struct ath10k *ar);
93 int ath10k_debug_register(struct ath10k *ar);
94 void ath10k_debug_unregister(struct ath10k *ar);
95 void ath10k_debug_fw_stats_process(struct ath10k *ar, struct sk_buff *skb);
96 void ath10k_debug_tpc_stats_process(struct ath10k *ar,
97 struct ath10k_tpc_stats *tpc_stats);
98 void
99 ath10k_debug_tpc_stats_final_process(struct ath10k *ar,
100 struct ath10k_tpc_stats_final *tpc_stats);
101 void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer, int len);
102
103 #define ATH10K_DFS_STAT_INC(ar, c) (ar->debug.dfs_stats.c++)
104
105 void ath10k_debug_get_et_strings(struct ieee80211_hw *hw,
106 struct ieee80211_vif *vif,
107 u32 sset, u8 *data);
108 int ath10k_debug_get_et_sset_count(struct ieee80211_hw *hw,
109 struct ieee80211_vif *vif, int sset);
110 void ath10k_debug_get_et_stats(struct ieee80211_hw *hw,
111 struct ieee80211_vif *vif,
112 struct ethtool_stats *stats, u64 *data);
113
ath10k_debug_get_fw_dbglog_mask(struct ath10k * ar)114 static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
115 {
116 return ar->debug.fw_dbglog_mask;
117 }
118
ath10k_debug_get_fw_dbglog_level(struct ath10k * ar)119 static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
120 {
121 return ar->debug.fw_dbglog_level;
122 }
123
ath10k_debug_is_extd_tx_stats_enabled(struct ath10k * ar)124 static inline int ath10k_debug_is_extd_tx_stats_enabled(struct ath10k *ar)
125 {
126 return ar->debug.enable_extd_tx_stats;
127 }
128
129 int ath10k_debug_fw_stats_request(struct ath10k *ar);
130
131 #else
132
ath10k_debug_start(struct ath10k * ar)133 static inline int ath10k_debug_start(struct ath10k *ar)
134 {
135 return 0;
136 }
137
ath10k_debug_stop(struct ath10k * ar)138 static inline void ath10k_debug_stop(struct ath10k *ar)
139 {
140 }
141
ath10k_debug_create(struct ath10k * ar)142 static inline int ath10k_debug_create(struct ath10k *ar)
143 {
144 return 0;
145 }
146
ath10k_debug_destroy(struct ath10k * ar)147 static inline void ath10k_debug_destroy(struct ath10k *ar)
148 {
149 }
150
ath10k_debug_register(struct ath10k * ar)151 static inline int ath10k_debug_register(struct ath10k *ar)
152 {
153 return 0;
154 }
155
ath10k_debug_unregister(struct ath10k * ar)156 static inline void ath10k_debug_unregister(struct ath10k *ar)
157 {
158 }
159
ath10k_debug_fw_stats_process(struct ath10k * ar,struct sk_buff * skb)160 static inline void ath10k_debug_fw_stats_process(struct ath10k *ar,
161 struct sk_buff *skb)
162 {
163 }
164
ath10k_debug_tpc_stats_process(struct ath10k * ar,struct ath10k_tpc_stats * tpc_stats)165 static inline void ath10k_debug_tpc_stats_process(struct ath10k *ar,
166 struct ath10k_tpc_stats *tpc_stats)
167 {
168 kfree(tpc_stats);
169 }
170
171 static inline void
ath10k_debug_tpc_stats_final_process(struct ath10k * ar,struct ath10k_tpc_stats_final * tpc_stats)172 ath10k_debug_tpc_stats_final_process(struct ath10k *ar,
173 struct ath10k_tpc_stats_final *tpc_stats)
174 {
175 kfree(tpc_stats);
176 }
177
ath10k_debug_dbglog_add(struct ath10k * ar,u8 * buffer,int len)178 static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
179 int len)
180 {
181 }
182
ath10k_debug_get_fw_dbglog_mask(struct ath10k * ar)183 static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
184 {
185 return 0;
186 }
187
ath10k_debug_get_fw_dbglog_level(struct ath10k * ar)188 static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
189 {
190 return 0;
191 }
192
ath10k_debug_is_extd_tx_stats_enabled(struct ath10k * ar)193 static inline int ath10k_debug_is_extd_tx_stats_enabled(struct ath10k *ar)
194 {
195 return 0;
196 }
197
ath10k_debug_fw_stats_request(struct ath10k * ar)198 static inline int ath10k_debug_fw_stats_request(struct ath10k *ar)
199 {
200 return 0;
201 }
202
203 #define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
204
205 #define ath10k_debug_get_et_strings NULL
206 #define ath10k_debug_get_et_sset_count NULL
207 #define ath10k_debug_get_et_stats NULL
208
209 #endif /* CONFIG_ATH10K_DEBUGFS */
210 #ifdef CONFIG_MAC80211_DEBUGFS
211 void ath10k_sta_add_debugfs(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
212 struct ieee80211_sta *sta, struct dentry *dir);
213 void ath10k_sta_update_rx_duration(struct ath10k *ar,
214 struct ath10k_fw_stats *stats);
215 void ath10k_sta_update_rx_tid_stats(struct ath10k *ar, u8 *first_hdr,
216 unsigned long num_msdus,
217 enum ath10k_pkt_rx_err err,
218 unsigned long unchain_cnt,
219 unsigned long drop_cnt,
220 unsigned long drop_cnt_filter,
221 unsigned long queued_msdus);
222 void ath10k_sta_update_rx_tid_stats_ampdu(struct ath10k *ar,
223 u16 peer_id, u8 tid,
224 struct htt_rx_indication_mpdu_range *ranges,
225 int num_ranges);
226 #else
227 static inline
ath10k_sta_update_rx_duration(struct ath10k * ar,struct ath10k_fw_stats * stats)228 void ath10k_sta_update_rx_duration(struct ath10k *ar,
229 struct ath10k_fw_stats *stats)
230 {
231 }
232
233 static inline
ath10k_sta_update_rx_tid_stats(struct ath10k * ar,u8 * first_hdr,unsigned long num_msdus,enum ath10k_pkt_rx_err err,unsigned long unchain_cnt,unsigned long drop_cnt,unsigned long drop_cnt_filter,unsigned long queued_msdus)234 void ath10k_sta_update_rx_tid_stats(struct ath10k *ar, u8 *first_hdr,
235 unsigned long num_msdus,
236 enum ath10k_pkt_rx_err err,
237 unsigned long unchain_cnt,
238 unsigned long drop_cnt,
239 unsigned long drop_cnt_filter,
240 unsigned long queued_msdus)
241 {
242 }
243
244 static inline
ath10k_sta_update_rx_tid_stats_ampdu(struct ath10k * ar,u16 peer_id,u8 tid,struct htt_rx_indication_mpdu_range * ranges,int num_ranges)245 void ath10k_sta_update_rx_tid_stats_ampdu(struct ath10k *ar,
246 u16 peer_id, u8 tid,
247 struct htt_rx_indication_mpdu_range *ranges,
248 int num_ranges)
249 {
250 }
251 #endif /* CONFIG_MAC80211_DEBUGFS */
252
253 #ifdef CONFIG_ATH10K_DEBUG
254 __printf(3, 4) void __ath10k_dbg(struct ath10k *ar,
255 enum ath10k_debug_mask mask,
256 const char *fmt, ...);
257 void ath10k_dbg_dump(struct ath10k *ar,
258 enum ath10k_debug_mask mask,
259 const char *msg, const char *prefix,
260 const void *buf, size_t len);
261 #else /* CONFIG_ATH10K_DEBUG */
262
__ath10k_dbg(struct ath10k * ar,enum ath10k_debug_mask dbg_mask,const char * fmt,...)263 static inline int __ath10k_dbg(struct ath10k *ar,
264 enum ath10k_debug_mask dbg_mask,
265 const char *fmt, ...)
266 {
267 return 0;
268 }
269
ath10k_dbg_dump(struct ath10k * ar,enum ath10k_debug_mask mask,const char * msg,const char * prefix,const void * buf,size_t len)270 static inline void ath10k_dbg_dump(struct ath10k *ar,
271 enum ath10k_debug_mask mask,
272 const char *msg, const char *prefix,
273 const void *buf, size_t len)
274 {
275 }
276 #endif /* CONFIG_ATH10K_DEBUG */
277
278 /* Avoid calling __ath10k_dbg() if debug_mask is not set and tracing
279 * disabled.
280 */
281 #define ath10k_dbg(ar, dbg_mask, fmt, ...) \
282 do { \
283 if ((ath10k_debug_mask & dbg_mask) || \
284 trace_ath10k_log_dbg_enabled()) \
285 __ath10k_dbg(ar, dbg_mask, fmt, ##__VA_ARGS__); \
286 } while (0)
287 #endif /* _DEBUG_H_ */
288