Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

Apr 14-17, 2025
Register
Loading...
v6.8
  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_ */
v5.4
  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_ANY		= 0xffffffff,
 38};
 39
 40enum 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
 50enum 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 */
 57enum ath_pktlog_type {
 58	ATH_PKTLOG_TYPE_TX_CTRL = 1,
 59	ATH_PKTLOG_TYPE_TX_STAT,
 60};
 61
 62struct 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[0];
 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
 77extern 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
 83void ath10k_debug_print_hwfw_info(struct ath10k *ar);
 84void ath10k_debug_print_board_info(struct ath10k *ar);
 85void ath10k_debug_print_boot_info(struct ath10k *ar);
 86void ath10k_print_driver_info(struct ath10k *ar);
 87
 88#ifdef CONFIG_ATH10K_DEBUGFS
 89int ath10k_debug_start(struct ath10k *ar);
 90void ath10k_debug_stop(struct ath10k *ar);
 91int ath10k_debug_create(struct ath10k *ar);
 92void ath10k_debug_destroy(struct ath10k *ar);
 93int ath10k_debug_register(struct ath10k *ar);
 94void ath10k_debug_unregister(struct ath10k *ar);
 95void ath10k_debug_fw_stats_process(struct ath10k *ar, struct sk_buff *skb);
 96void ath10k_debug_tpc_stats_process(struct ath10k *ar,
 97				    struct ath10k_tpc_stats *tpc_stats);
 98void
 99ath10k_debug_tpc_stats_final_process(struct ath10k *ar,
100				     struct ath10k_tpc_stats_final *tpc_stats);
101void 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
105void ath10k_debug_get_et_strings(struct ieee80211_hw *hw,
106				 struct ieee80211_vif *vif,
107				 u32 sset, u8 *data);
108int ath10k_debug_get_et_sset_count(struct ieee80211_hw *hw,
109				   struct ieee80211_vif *vif, int sset);
110void ath10k_debug_get_et_stats(struct ieee80211_hw *hw,
111			       struct ieee80211_vif *vif,
112			       struct ethtool_stats *stats, u64 *data);
113
114static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
115{
116	return ar->debug.fw_dbglog_mask;
117}
118
119static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
120{
121	return ar->debug.fw_dbglog_level;
122}
123
124static inline int ath10k_debug_is_extd_tx_stats_enabled(struct ath10k *ar)
125{
126	return ar->debug.enable_extd_tx_stats;
127}
 
 
 
128#else
129
130static inline int ath10k_debug_start(struct ath10k *ar)
131{
132	return 0;
133}
134
135static inline void ath10k_debug_stop(struct ath10k *ar)
136{
137}
138
139static inline int ath10k_debug_create(struct ath10k *ar)
140{
141	return 0;
142}
143
144static inline void ath10k_debug_destroy(struct ath10k *ar)
145{
146}
147
148static inline int ath10k_debug_register(struct ath10k *ar)
149{
150	return 0;
151}
152
153static inline void ath10k_debug_unregister(struct ath10k *ar)
154{
155}
156
157static inline void ath10k_debug_fw_stats_process(struct ath10k *ar,
158						 struct sk_buff *skb)
159{
160}
161
162static inline void ath10k_debug_tpc_stats_process(struct ath10k *ar,
163						  struct ath10k_tpc_stats *tpc_stats)
164{
165	kfree(tpc_stats);
166}
167
168static inline void
169ath10k_debug_tpc_stats_final_process(struct ath10k *ar,
170				     struct ath10k_tpc_stats_final *tpc_stats)
171{
172	kfree(tpc_stats);
173}
174
175static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
176					   int len)
177{
178}
179
180static inline u64 ath10k_debug_get_fw_dbglog_mask(struct ath10k *ar)
181{
182	return 0;
183}
184
185static inline u32 ath10k_debug_get_fw_dbglog_level(struct ath10k *ar)
186{
187	return 0;
188}
189
190static inline int ath10k_debug_is_extd_tx_stats_enabled(struct ath10k *ar)
 
 
 
 
 
191{
192	return 0;
193}
194
195#define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
196
197#define ath10k_debug_get_et_strings NULL
198#define ath10k_debug_get_et_sset_count NULL
199#define ath10k_debug_get_et_stats NULL
200
201#endif /* CONFIG_ATH10K_DEBUGFS */
202#ifdef CONFIG_MAC80211_DEBUGFS
203void ath10k_sta_add_debugfs(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
204			    struct ieee80211_sta *sta, struct dentry *dir);
205void ath10k_sta_update_rx_duration(struct ath10k *ar,
206				   struct ath10k_fw_stats *stats);
207void ath10k_sta_update_rx_tid_stats(struct ath10k *ar, u8 *first_hdr,
208				    unsigned long num_msdus,
209				    enum ath10k_pkt_rx_err err,
210				    unsigned long unchain_cnt,
211				    unsigned long drop_cnt,
212				    unsigned long drop_cnt_filter,
213				    unsigned long queued_msdus);
214void ath10k_sta_update_rx_tid_stats_ampdu(struct ath10k *ar,
215					  u16 peer_id, u8 tid,
216					  struct htt_rx_indication_mpdu_range *ranges,
217					  int num_ranges);
218#else
219static inline
220void ath10k_sta_update_rx_duration(struct ath10k *ar,
221				   struct ath10k_fw_stats *stats)
222{
223}
224
225static inline
226void ath10k_sta_update_rx_tid_stats(struct ath10k *ar, u8 *first_hdr,
227				    unsigned long num_msdus,
228				    enum ath10k_pkt_rx_err err,
229				    unsigned long unchain_cnt,
230				    unsigned long drop_cnt,
231				    unsigned long drop_cnt_filter,
232				    unsigned long queued_msdus)
233{
234}
235
236static inline
237void ath10k_sta_update_rx_tid_stats_ampdu(struct ath10k *ar,
238					  u16 peer_id, u8 tid,
239					  struct htt_rx_indication_mpdu_range *ranges,
240					  int num_ranges)
241{
242}
243#endif /* CONFIG_MAC80211_DEBUGFS */
244
245#ifdef CONFIG_ATH10K_DEBUG
246__printf(3, 4) void __ath10k_dbg(struct ath10k *ar,
247				 enum ath10k_debug_mask mask,
248				 const char *fmt, ...);
249void ath10k_dbg_dump(struct ath10k *ar,
250		     enum ath10k_debug_mask mask,
251		     const char *msg, const char *prefix,
252		     const void *buf, size_t len);
253#else /* CONFIG_ATH10K_DEBUG */
254
255static inline int __ath10k_dbg(struct ath10k *ar,
256			       enum ath10k_debug_mask dbg_mask,
257			       const char *fmt, ...)
258{
259	return 0;
260}
261
262static inline void ath10k_dbg_dump(struct ath10k *ar,
263				   enum ath10k_debug_mask mask,
264				   const char *msg, const char *prefix,
265				   const void *buf, size_t len)
266{
267}
268#endif /* CONFIG_ATH10K_DEBUG */
269
270/* Avoid calling __ath10k_dbg() if debug_mask is not set and tracing
271 * disabled.
272 */
273#define ath10k_dbg(ar, dbg_mask, fmt, ...)			\
274do {								\
275	if ((ath10k_debug_mask & dbg_mask) ||			\
276	    trace_ath10k_log_dbg_enabled())			\
277		__ath10k_dbg(ar, dbg_mask, fmt, ##__VA_ARGS__); \
278} while (0)
279#endif /* _DEBUG_H_ */