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

source code of linux/drivers/net/wireless/ath/ath10k/debug.h