iwlwifi: make debug level more user friendly
[linux-2.6.git] / drivers / net / wireless / iwlwifi / iwl-debug.h
blob9faf0c2ff608a49d7aea5141c2a9126bcf682be9
1 /******************************************************************************
3 * Copyright(c) 2003 - 2009 Intel Corporation. All rights reserved.
5 * Portions of this file are derived from the ipw3945 project.
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of version 2 of the GNU General Public License as
9 * published by the Free Software Foundation.
11 * This program is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * more details.
16 * You should have received a copy of the GNU General Public License along with
17 * this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
20 * The full GNU General Public License is included in this distribution in the
21 * file called LICENSE.
23 * Contact Information:
24 * Intel Linux Wireless <ilw@linux.intel.com>
25 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
27 *****************************************************************************/
29 #ifndef __iwl_debug_h__
30 #define __iwl_debug_h__
32 struct iwl_priv;
33 extern u32 iwl_debug_level;
35 #define IWL_ERR(p, f, a...) dev_err(&((p)->pci_dev->dev), f, ## a)
36 #define IWL_WARN(p, f, a...) dev_warn(&((p)->pci_dev->dev), f, ## a)
37 #define IWL_INFO(p, f, a...) dev_info(&((p)->pci_dev->dev), f, ## a)
38 #define IWL_CRIT(p, f, a...) dev_crit(&((p)->pci_dev->dev), f, ## a)
40 #define iwl_print_hex_error(priv, p, len) \
41 do { \
42 print_hex_dump(KERN_ERR, "iwl data: ", \
43 DUMP_PREFIX_OFFSET, 16, 1, p, len, 1); \
44 } while (0)
46 #ifdef CONFIG_IWLWIFI_DEBUG
47 #define IWL_DEBUG(__priv, level, fmt, args...) \
48 do { \
49 if (iwl_debug_level & (level)) \
50 dev_printk(KERN_ERR, &(__priv->hw->wiphy->dev), \
51 "%c %s " fmt, in_interrupt() ? 'I' : 'U', \
52 __func__ , ## args); \
53 } while (0)
55 #define IWL_DEBUG_LIMIT(__priv, level, fmt, args...) \
56 do { \
57 if ((iwl_debug_level & (level)) && net_ratelimit()) \
58 dev_printk(KERN_ERR, &(__priv->hw->wiphy->dev), \
59 "%c %s " fmt, in_interrupt() ? 'I' : 'U', \
60 __func__ , ## args); \
61 } while (0)
63 #define iwl_print_hex_dump(level, p, len) \
64 do { \
65 if (iwl_debug_level & level) \
66 print_hex_dump(KERN_DEBUG, "iwl data: ", \
67 DUMP_PREFIX_OFFSET, 16, 1, p, len, 1); \
68 } while (0)
70 #ifdef CONFIG_IWLWIFI_DEBUGFS
71 struct iwl_debugfs {
72 const char *name;
73 struct dentry *dir_drv;
74 struct dentry *dir_data;
75 struct dentry *dir_rf;
76 struct dir_data_files {
77 struct dentry *file_sram;
78 struct dentry *file_nvm;
79 struct dentry *file_stations;
80 struct dentry *file_rx_statistics;
81 struct dentry *file_tx_statistics;
82 struct dentry *file_log_event;
83 struct dentry *file_channels;
84 struct dentry *file_status;
85 struct dentry *file_interrupt;
86 struct dentry *file_qos;
87 #ifdef CONFIG_IWLWIFI_LEDS
88 struct dentry *file_led;
89 #endif
90 } dbgfs_data_files;
91 struct dir_rf_files {
92 struct dentry *file_disable_sensitivity;
93 struct dentry *file_disable_chain_noise;
94 struct dentry *file_disable_tx_power;
95 } dbgfs_rf_files;
96 u32 sram_offset;
97 u32 sram_len;
100 int iwl_dbgfs_register(struct iwl_priv *priv, const char *name);
101 void iwl_dbgfs_unregister(struct iwl_priv *priv);
102 #endif
104 #else
105 #define IWL_DEBUG(__priv, level, fmt, args...)
106 #define IWL_DEBUG_LIMIT(__priv, level, fmt, args...)
107 static inline void iwl_print_hex_dump(int level, void *p, u32 len)
109 #endif /* CONFIG_IWLWIFI_DEBUG */
113 #ifndef CONFIG_IWLWIFI_DEBUGFS
114 static inline int iwl_dbgfs_register(struct iwl_priv *priv, const char *name)
116 return 0;
118 static inline void iwl_dbgfs_unregister(struct iwl_priv *priv)
121 #endif /* CONFIG_IWLWIFI_DEBUGFS */
124 * To use the debug system:
126 * If you are defining a new debug classification, simply add it to the #define
127 * list here in the form of
129 * #define IWL_DL_xxxx VALUE
131 * where xxxx should be the name of the classification (for example, WEP).
133 * You then need to either add a IWL_xxxx_DEBUG() macro definition for your
134 * classification, or use IWL_DEBUG(IWL_DL_xxxx, ...) whenever you want
135 * to send output to that classification.
137 * The active debug levels can be accessed via files
139 * /sys/module/iwlagn/parameters/debug{50}
140 * /sys/class/net/wlan0/device/debug_level
142 * when CONFIG_IWLWIFI_DEBUG=y.
145 /* 0x0000000F - 0x00000001 */
146 #define IWL_DL_INFO (1 << 0)
147 #define IWL_DL_MAC80211 (1 << 1)
148 #define IWL_DL_HCMD (1 << 2)
149 #define IWL_DL_STATE (1 << 3)
150 /* 0x000000F0 - 0x00000010 */
151 #define IWL_DL_MACDUMP (1 << 4)
152 #define IWL_DL_HCMD_DUMP (1 << 5)
153 #define IWL_DL_RADIO (1 << 7)
154 /* 0x00000F00 - 0x00000100 */
155 #define IWL_DL_POWER (1 << 8)
156 #define IWL_DL_TEMP (1 << 9)
157 #define IWL_DL_NOTIF (1 << 10)
158 #define IWL_DL_SCAN (1 << 11)
159 /* 0x0000F000 - 0x00001000 */
160 #define IWL_DL_ASSOC (1 << 12)
161 #define IWL_DL_DROP (1 << 13)
162 #define IWL_DL_TXPOWER (1 << 14)
163 #define IWL_DL_AP (1 << 15)
164 /* 0x000F0000 - 0x00010000 */
165 #define IWL_DL_FW (1 << 16)
166 #define IWL_DL_RF_KILL (1 << 17)
167 #define IWL_DL_FW_ERRORS (1 << 18)
168 #define IWL_DL_LED (1 << 19)
169 /* 0x00F00000 - 0x00100000 */
170 #define IWL_DL_RATE (1 << 20)
171 #define IWL_DL_CALIB (1 << 21)
172 #define IWL_DL_WEP (1 << 22)
173 #define IWL_DL_TX (1 << 23)
174 /* 0x0F000000 - 0x01000000 */
175 #define IWL_DL_RX (1 << 24)
176 #define IWL_DL_ISR (1 << 25)
177 #define IWL_DL_HT (1 << 26)
178 #define IWL_DL_IO (1 << 27)
179 /* 0xF0000000 - 0x10000000 */
180 #define IWL_DL_11H (1 << 28)
181 #define IWL_DL_STATS (1 << 29)
182 #define IWL_DL_TX_REPLY (1 << 30)
183 #define IWL_DL_QOS (1 << 31)
185 #define IWL_DEBUG_INFO(p, f, a...) IWL_DEBUG(p, IWL_DL_INFO, f, ## a)
186 #define IWL_DEBUG_MAC80211(p, f, a...) IWL_DEBUG(p, IWL_DL_MAC80211, f, ## a)
187 #define IWL_DEBUG_MACDUMP(p, f, a...) IWL_DEBUG(p, IWL_DL_MACDUMP, f, ## a)
188 #define IWL_DEBUG_TEMP(p, f, a...) IWL_DEBUG(p, IWL_DL_TEMP, f, ## a)
189 #define IWL_DEBUG_SCAN(p, f, a...) IWL_DEBUG(p, IWL_DL_SCAN, f, ## a)
190 #define IWL_DEBUG_RX(p, f, a...) IWL_DEBUG(p, IWL_DL_RX, f, ## a)
191 #define IWL_DEBUG_TX(p, f, a...) IWL_DEBUG(p, IWL_DL_TX, f, ## a)
192 #define IWL_DEBUG_ISR(p, f, a...) IWL_DEBUG(p, IWL_DL_ISR, f, ## a)
193 #define IWL_DEBUG_LED(p, f, a...) IWL_DEBUG(p, IWL_DL_LED, f, ## a)
194 #define IWL_DEBUG_WEP(p, f, a...) IWL_DEBUG(p, IWL_DL_WEP, f, ## a)
195 #define IWL_DEBUG_HC(p, f, a...) IWL_DEBUG(p, IWL_DL_HCMD, f, ## a)
196 #define IWL_DEBUG_HC_DUMP(p, f, a...) IWL_DEBUG(p, IWL_DL_HCMD_DUMP, f, ## a)
197 #define IWL_DEBUG_CALIB(p, f, a...) IWL_DEBUG(p, IWL_DL_CALIB, f, ## a)
198 #define IWL_DEBUG_FW(p, f, a...) IWL_DEBUG(p, IWL_DL_FW, f, ## a)
199 #define IWL_DEBUG_RF_KILL(p, f, a...) IWL_DEBUG(p, IWL_DL_RF_KILL, f, ## a)
200 #define IWL_DEBUG_DROP(p, f, a...) IWL_DEBUG(p, IWL_DL_DROP, f, ## a)
201 #define IWL_DEBUG_DROP_LIMIT(p, f, a...) \
202 IWL_DEBUG_LIMIT(p, IWL_DL_DROP, f, ## a)
203 #define IWL_DEBUG_AP(p, f, a...) IWL_DEBUG(p, IWL_DL_AP, f, ## a)
204 #define IWL_DEBUG_TXPOWER(p, f, a...) IWL_DEBUG(p, IWL_DL_TXPOWER, f, ## a)
205 #define IWL_DEBUG_IO(p, f, a...) IWL_DEBUG(p, IWL_DL_IO, f, ## a)
206 #define IWL_DEBUG_RATE(p, f, a...) IWL_DEBUG(p, IWL_DL_RATE, f, ## a)
207 #define IWL_DEBUG_RATE_LIMIT(p, f, a...) \
208 IWL_DEBUG_LIMIT(p, IWL_DL_RATE, f, ## a)
209 #define IWL_DEBUG_NOTIF(p, f, a...) IWL_DEBUG(p, IWL_DL_NOTIF, f, ## a)
210 #define IWL_DEBUG_ASSOC(p, f, a...) \
211 IWL_DEBUG(p, IWL_DL_ASSOC | IWL_DL_INFO, f, ## a)
212 #define IWL_DEBUG_ASSOC_LIMIT(p, f, a...) \
213 IWL_DEBUG_LIMIT(p, IWL_DL_ASSOC | IWL_DL_INFO, f, ## a)
214 #define IWL_DEBUG_HT(p, f, a...) IWL_DEBUG(p, IWL_DL_HT, f, ## a)
215 #define IWL_DEBUG_STATS(p, f, a...) IWL_DEBUG(p, IWL_DL_STATS, f, ## a)
216 #define IWL_DEBUG_STATS_LIMIT(p, f, a...) \
217 IWL_DEBUG_LIMIT(p, IWL_DL_STATS, f, ## a)
218 #define IWL_DEBUG_TX_REPLY(p, f, a...) IWL_DEBUG(p, IWL_DL_TX_REPLY, f, ## a)
219 #define IWL_DEBUG_TX_REPLY_LIMIT(p, f, a...) \
220 IWL_DEBUG_LIMIT(p, IWL_DL_TX_REPLY, f, ## a)
221 #define IWL_DEBUG_QOS(p, f, a...) IWL_DEBUG(p, IWL_DL_QOS, f, ## a)
222 #define IWL_DEBUG_RADIO(p, f, a...) IWL_DEBUG(p, IWL_DL_RADIO, f, ## a)
223 #define IWL_DEBUG_POWER(p, f, a...) IWL_DEBUG(p, IWL_DL_POWER, f, ## a)
224 #define IWL_DEBUG_11H(p, f, a...) IWL_DEBUG(p, IWL_DL_11H, f, ## a)
226 #endif