xref: /freebsd/sys/contrib/dev/iwlwifi/iwl-debug.h (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
1 /*-
2  * Copyright (c) 2020-2021 The FreeBSD Foundation
3  *
4  * This software was developed by Björn Zeeb under sponsorship from
5  * the FreeBSD Foundation.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  * $FreeBSD$
29  */
30 
31 #ifndef _IWL_DEBUG_H
32 #define	_IWL_DEBUG_H
33 
34 #if defined(__FreeBSD__)
35 #ifdef CONFIG_IWLWIFI_DEBUG
36 #include <sys/types.h>
37 #endif
38 #endif
39 
40 #include <linux/device.h>
41 
42 enum iwl_dl {
43 	IWL_DL_ASSOC		= 0x00000001,
44 	IWL_DL_CALIB		= 0x00000002,
45 	IWL_DL_COEX		= 0x00000004,
46 	IWL_DL_WOWLAN		= 0x00000008,
47 	IWL_DL_DROP		= 0x00000010,
48 	IWL_DL_EEPROM		= 0x00000020,
49 	IWL_DL_FW		= 0x00000040,
50 	/*			= 0x00000080, */
51 	IWL_DL_HC		= 0x00000100,
52 	IWL_DL_HT		= 0x00000200,
53 	IWL_DL_INFO		= 0x00000400,
54 	IWL_DL_ISR		= 0x00000800,
55 	IWL_DL_LAR		= 0x00001000,
56 	IWL_DL_MAC80211		= 0x00002000,
57 	IWL_DL_POWER		= 0x00004000,
58 	IWL_DL_QUOTA		= 0x00008000,
59 	IWL_DL_RADIO		= 0x00010000,
60 	IWL_DL_RATE		= 0x00020000,
61 	IWL_DL_RF_KILL		= 0x00040000,
62 	IWL_DL_RX		= 0x00080000,
63 	IWL_DL_SCAN		= 0x00100000,
64 	IWL_DL_STATS		= 0x00200000,
65 	/*			= 0x00400000, */
66 	IWL_DL_TDLS		= 0x00800000,
67 	IWL_DL_TE		= 0x01000000,
68 	IWL_DL_TEMP		= 0x02000000,
69 	IWL_DL_TPT		= 0x04000000,
70 	IWL_DL_TX		= 0x08000000,
71 	IWL_DL_TX_QUEUES	= 0x10000000,
72 	IWL_DL_TX_REPLY		= 0x20000000,
73 	IWL_DL_WEP		= 0x40000000,
74 
75 	IWL_DL_PCI_RW		= 0x80000000,
76 
77 	IWL_DL_ANY		= 0x7fffffff,
78 };
79 
80 enum iwl_err_mode {
81 	IWL_ERR_MODE_RATELIMIT,
82 	IWL_ERR_MODE_REGULAR,
83 	IWL_ERR_MODE_RFKILL,	/* XXX we do not pass that from anywhere? */
84 };
85 
86 void __iwl_crit(struct device *, const char *, ...);
87 void __iwl_info(struct device *, const char *, ...);
88 void __iwl_warn(struct device *, const char *, ...);
89 void __iwl_err(struct device *, enum iwl_err_mode, const char *, ...);
90 
91 #define	IWL_CRIT(_subsys, _fmt, ...)					\
92 	__iwl_crit((_subsys)->dev, _fmt, ##__VA_ARGS__)
93 #define	IWL_INFO(_subsys, _fmt, ...)					\
94 	__iwl_info((_subsys)->dev, _fmt, ##__VA_ARGS__)
95 #define	IWL_WARN(_subsys, _fmt, ...)					\
96 	__iwl_warn((_subsys)->dev, _fmt, ##__VA_ARGS__)
97 /* XXX Not sure what the two bools are good for if never passed. */
98 #define	__IWL_ERR_DEV(_dev, _mode, _fmt, ...)				\
99 	__iwl_err((_dev), IWL_ERR_MODE_REGULAR, _fmt, ##__VA_ARGS__)
100 #define	IWL_ERR_DEV(_dev, _fmt, ...)					\
101 	__IWL_ERR_DEV(_dev, IWL_ERR_MODE_REGULAR, _fmt, ##__VA_ARGS__)
102 #define	IWL_ERR(_subsys, _fmt, ...)					\
103 	IWL_ERR_DEV((_subsys)->dev, _fmt, ##__VA_ARGS__)
104 #define	IWL_ERR_LIMIT(_subsys, _fmt, ...)				\
105 	__IWL_ERR_DEV((_subsys)->dev, IWL_ERR_MODE_RATELIMIT,		\
106 	    _fmt, ##__VA_ARGS__)
107 
108 #define	iwl_print_hex_error(_subsys, _pkt, _n)		/* XXX-BZ TODO */
109 
110 #ifdef CONFIG_IWLWIFI_DEBUG
111 bool iwl_have_debug_level(enum iwl_dl);
112 #if defined(__linux__)
113 void iwl_print_hex_dump(void *, enum iwl_dl, const char *, uint8_t *, size_t);
114 #elif defined(__FreeBSD__)
115 void iwl_print_hex_dump(void *, enum iwl_dl, const char *, const uint8_t *, size_t);
116 #endif
117 void __iwl_dbg(struct device *, u32, bool, const char *, const char *fmt, ...);
118 
119 #define	IWL_DPRINTF_DEV_PREFIX(_dev, _e, _prefix, _fmt, ...)		\
120 	__iwl_dbg(_dev, _e, false, __func__, #_prefix " " _fmt, ##__VA_ARGS__)
121 #define	IWL_DPRINTF_DEV(_dev, _e, _fmt, ...)				\
122 	IWL_DPRINTF_DEV_PREFIX(_dev, _e, _e, _fmt, ##__VA_ARGS__)
123 #define	IWL_DPRINTF(_subsys, _e, _fmt, ...)				\
124 	IWL_DPRINTF_DEV((_subsys)->dev, _e, _fmt, ##__VA_ARGS__)
125 #define	IWL_DPRINTF_PREFIX(_subsys, _e, _prefix, _fmt, ...)		\
126 	IWL_DPRINTF_DEV_PREFIX((_subsys)->dev, _e, _prefix, _fmt, ##__VA_ARGS__)
127 
128 #else /* !CONFIG_IWLWIFI_DEBUG */
129 #define	IWL_DPRINTF_DEV(_dev, _e, _fmt, ...)
130 #define	IWL_DPRINTF(_subsys, _e, _fmt, ...)
131 #define	IWL_DPRINTF_PREFIX(_subsys, _e, _prefix, _fmt, ...)
132 #endif /* CONFIG_IWLWIFI_DEBUG */
133 
134 #define	IWL_DEBUG_ASSOC(_subsys, _fmt, ...)				\
135 	IWL_DPRINTF(_subsys, IWL_DL_ASSOC, _fmt, ##__VA_ARGS__)
136 #define	IWL_DEBUG_CALIB(_subsys, _fmt, ...)				\
137 	IWL_DPRINTF(_subsys, IWL_DL_CALIB, _fmt, ##__VA_ARGS__)
138 #define	IWL_DEBUG_COEX(_subsys, _fmt, ...)				\
139 	IWL_DPRINTF(_subsys, IWL_DL_COEX, _fmt, ##__VA_ARGS__)
140 #define	IWL_DEBUG_DEV(_dev, _level, _fmt, ...)				\
141 	IWL_DPRINTF_DEV((_dev), (_level), _fmt, ##__VA_ARGS__)
142 #define	IWL_DEBUG_DROP(_subsys, _fmt, ...)				\
143 	IWL_DPRINTF(_subsys, IWL_DL_DROP, _fmt, ##__VA_ARGS__)
144 #define	IWL_DEBUG_EEPROM(_dev, _fmt, ...)				\
145 	IWL_DPRINTF_DEV((_dev), IWL_DL_EEPROM, _fmt, ##__VA_ARGS__)
146 #define	IWL_DEBUG_FW(_subsys, _fmt, ...)				\
147 	IWL_DPRINTF(_subsys, IWL_DL_FW, _fmt, ##__VA_ARGS__)
148 #define	IWL_DEBUG_FW_INFO(_subsys, _fmt, ...)				\
149 	IWL_DPRINTF_PREFIX(_subsys, IWL_DL_FW | IWL_DL_INFO, IWL_DL_FW_INFO, _fmt, ##__VA_ARGS__)
150 #define	IWL_DEBUG_HC(_subsys, _fmt, ...)				\
151 	IWL_DPRINTF(_subsys, IWL_DL_HC, _fmt, ##__VA_ARGS__)
152 #define	IWL_DEBUG_HT(_subsys, _fmt, ...)				\
153 	IWL_DPRINTF(_subsys, IWL_DL_HT, _fmt, ##__VA_ARGS__)
154 #define	IWL_DEBUG_INFO(_subsys, _fmt, ...)				\
155 	IWL_DPRINTF(_subsys, IWL_DL_INFO, _fmt, ##__VA_ARGS__)
156 #define	IWL_DEBUG_ISR(_subsys, _fmt, ...)				\
157 	IWL_DPRINTF(_subsys, IWL_DL_ISR, _fmt, ##__VA_ARGS__)
158 #define	IWL_DEBUG_LAR(_subsys, _fmt, ...)				\
159 	IWL_DPRINTF(_subsys, IWL_DL_LAR, _fmt, ##__VA_ARGS__)
160 #define	IWL_DEBUG_MAC80211(_subsys, _fmt, ...)				\
161 	IWL_DPRINTF(_subsys, IWL_DL_MAC80211, _fmt, ##__VA_ARGS__)
162 #define	IWL_DEBUG_POWER(_subsys, _fmt, ...)				\
163 	IWL_DPRINTF(_subsys, IWL_DL_POWER, _fmt, ##__VA_ARGS__)
164 #define	IWL_DEBUG_QUOTA(_subsys, _fmt, ...)				\
165 	IWL_DPRINTF(_subsys, IWL_DL_QUOTA, _fmt, ##__VA_ARGS__)
166 #define	IWL_DEBUG_RADIO(_subsys, _fmt, ...)				\
167 	IWL_DPRINTF(_subsys, IWL_DL_RADIO, _fmt, ##__VA_ARGS__)
168 #define	IWL_DEBUG_RATE(_subsys, _fmt, ...)				\
169 	IWL_DPRINTF(_subsys, IWL_DL_RATE, _fmt, ##__VA_ARGS__)
170 #define	IWL_DEBUG_RF_KILL(_subsys, _fmt, ...)				\
171 	IWL_DPRINTF(_subsys, IWL_DL_RF_KILL, _fmt, ##__VA_ARGS__)
172 #define	IWL_DEBUG_RX(_subsys, _fmt, ...)				\
173 	IWL_DPRINTF(_subsys, IWL_DL_RX, _fmt, ##__VA_ARGS__)
174 #define	IWL_DEBUG_SCAN(_subsys, _fmt, ...)				\
175 	IWL_DPRINTF(_subsys, IWL_DL_SCAN, _fmt, ##__VA_ARGS__)
176 #define	IWL_DEBUG_STATS(_subsys, _fmt, ...)				\
177 	IWL_DPRINTF(_subsys, IWL_DL_STATS, _fmt, ##__VA_ARGS__)
178 #define	IWL_DEBUG_STATS_LIMIT(_subsys, _fmt, ...)			\
179 	IWL_DPRINTF(_subsys, IWL_DL_STATS, _fmt, ##__VA_ARGS__)
180 #define	IWL_DEBUG_TDLS(_subsys, _fmt, ...)				\
181 	IWL_DPRINTF(_subsys, IWL_DL_TDLS, _fmt, ##__VA_ARGS__)
182 #define	IWL_DEBUG_TE(_subsys, _fmt, ...)				\
183 	IWL_DPRINTF(_subsys, IWL_DL_TE, _fmt, ##__VA_ARGS__)
184 #define	IWL_DEBUG_TEMP(_subsys, _fmt, ...)				\
185 	IWL_DPRINTF(_subsys, IWL_DL_TEMP, _fmt, ##__VA_ARGS__)
186 #define	IWL_DEBUG_TPT(_subsys, _fmt, ...)				\
187 	IWL_DPRINTF(_subsys, IWL_DL_TPT, _fmt, ##__VA_ARGS__)
188 #define	IWL_DEBUG_TX(_subsys, _fmt, ...)				\
189 	IWL_DPRINTF(_subsys, IWL_DL_TX, _fmt, ##__VA_ARGS__)
190 #define	IWL_DEBUG_TX_QUEUES(_subsys, _fmt, ...)				\
191 	IWL_DPRINTF(_subsys, IWL_DL_TX_QUEUES, _fmt, ##__VA_ARGS__)
192 #define	IWL_DEBUG_TX_REPLY(_subsys, _fmt, ...)				\
193 	IWL_DPRINTF(_subsys, IWL_DL_TX_REPLY, _fmt, ##__VA_ARGS__)
194 #define	IWL_DEBUG_WEP(_subsys, _fmt, ...)				\
195 	IWL_DPRINTF(_subsys, IWL_DL_WEP, _fmt, ##__VA_ARGS__)
196 #define	IWL_DEBUG_WOWLAN(_subsys, _fmt, ...)				\
197 	IWL_DPRINTF(_subsys, IWL_DL_WOWLAN, _fmt, ##__VA_ARGS__)
198 
199 #define	IWL_DEBUG_PCI_RW(_subsys, _fmt, ...)				\
200 	IWL_DPRINTF(_subsys, IWL_DL_PCI_RW, _fmt, ##__VA_ARGS__)
201 
202 #endif /* _IWL_DEBUG_H */
203