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_ANY		= 0xffffffff,
39 };
40 
41 extern unsigned int ath10k_debug_mask;
42 
43 __printf(2, 3) int ath10k_info(struct ath10k *ar, const char *fmt, ...);
44 __printf(2, 3) int ath10k_err(struct ath10k *ar, const char *fmt, ...);
45 __printf(2, 3) int ath10k_warn(struct ath10k *ar, const char *fmt, ...);
46 void ath10k_print_driver_info(struct ath10k *ar);
47 
48 #ifdef CONFIG_ATH10K_DEBUGFS
49 int ath10k_debug_start(struct ath10k *ar);
50 void ath10k_debug_stop(struct ath10k *ar);
51 int ath10k_debug_create(struct ath10k *ar);
52 void ath10k_debug_destroy(struct ath10k *ar);
53 int ath10k_debug_register(struct ath10k *ar);
54 void ath10k_debug_unregister(struct ath10k *ar);
55 void ath10k_debug_read_service_map(struct ath10k *ar,
56 				   void *service_map,
57 				   size_t map_size);
58 void ath10k_debug_read_target_stats(struct ath10k *ar,
59 				    struct wmi_stats_event *ev);
60 struct ath10k_fw_crash_data *
61 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar);
62 
63 void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer, int len);
64 
65 #define ATH10K_DFS_STAT_INC(ar, c) (ar->debug.dfs_stats.c++)
66 
67 #else
68 static inline int ath10k_debug_start(struct ath10k *ar)
69 {
70 	return 0;
71 }
72 
73 static inline void ath10k_debug_stop(struct ath10k *ar)
74 {
75 }
76 
77 static inline int ath10k_debug_create(struct ath10k *ar)
78 {
79 	return 0;
80 }
81 
82 static inline void ath10k_debug_destroy(struct ath10k *ar)
83 {
84 }
85 
86 static inline int ath10k_debug_register(struct ath10k *ar)
87 {
88 	return 0;
89 }
90 
91 static inline void ath10k_debug_unregister(struct ath10k *ar)
92 {
93 }
94 
95 static inline void ath10k_debug_read_service_map(struct ath10k *ar,
96 						 void *service_map,
97 						 size_t map_size)
98 {
99 }
100 
101 static inline void ath10k_debug_read_target_stats(struct ath10k *ar,
102 						  struct wmi_stats_event *ev)
103 {
104 }
105 
106 static inline void ath10k_debug_dbglog_add(struct ath10k *ar, u8 *buffer,
107 					   int len)
108 {
109 }
110 
111 static inline struct ath10k_fw_crash_data *
112 ath10k_debug_get_new_fw_crash_data(struct ath10k *ar)
113 {
114 	return NULL;
115 }
116 
117 #define ATH10K_DFS_STAT_INC(ar, c) do { } while (0)
118 
119 #endif /* CONFIG_ATH10K_DEBUGFS */
120 
121 #ifdef CONFIG_ATH10K_DEBUG
122 __printf(3, 4) void ath10k_dbg(struct ath10k *ar,
123 			       enum ath10k_debug_mask mask,
124 			       const char *fmt, ...);
125 void ath10k_dbg_dump(struct ath10k *ar,
126 		     enum ath10k_debug_mask mask,
127 		     const char *msg, const char *prefix,
128 		     const void *buf, size_t len);
129 #else /* CONFIG_ATH10K_DEBUG */
130 
131 static inline int ath10k_dbg(struct ath10k *ar,
132 			     enum ath10k_debug_mask dbg_mask,
133 			     const char *fmt, ...)
134 {
135 	return 0;
136 }
137 
138 static inline void ath10k_dbg_dump(struct ath10k *ar,
139 				   enum ath10k_debug_mask mask,
140 				   const char *msg, const char *prefix,
141 				   const void *buf, size_t len)
142 {
143 }
144 #endif /* CONFIG_ATH10K_DEBUG */
145 #endif /* _DEBUG_H_ */
146