iwl-debug.h 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216
  1. /******************************************************************************
  2. *
  3. * Copyright(c) 2003 - 2011 Intel Corporation. All rights reserved.
  4. *
  5. * Portions of this file are derived from the ipw3945 project.
  6. *
  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.
  10. *
  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.
  15. *
  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
  19. *
  20. * The full GNU General Public License is included in this distribution in the
  21. * file called LICENSE.
  22. *
  23. * Contact Information:
  24. * Intel Linux Wireless <ilw@linux.intel.com>
  25. * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  26. *
  27. *****************************************************************************/
  28. #ifndef __iwl_debug_h__
  29. #define __iwl_debug_h__
  30. #include "iwl-bus.h"
  31. #include "iwl-shared.h"
  32. struct iwl_priv;
  33. /*No matter what is m (priv, bus, trans), this will work */
  34. #define IWL_ERR(m, f, a...) dev_err(bus(m)->dev, f, ## a)
  35. #define IWL_WARN(m, f, a...) dev_warn(bus(m)->dev, f, ## a)
  36. #define IWL_INFO(m, f, a...) dev_info(bus(m)->dev, f, ## a)
  37. #define IWL_CRIT(m, f, a...) dev_crit(bus(m)->dev, f, ## a)
  38. #define iwl_print_hex_error(m, p, len) \
  39. do { \
  40. print_hex_dump(KERN_ERR, "iwl data: ", \
  41. DUMP_PREFIX_OFFSET, 16, 1, p, len, 1); \
  42. } while (0)
  43. #ifdef CONFIG_IWLWIFI_DEBUG
  44. #define IWL_DEBUG(m, level, fmt, ...) \
  45. do { \
  46. if (iwl_get_debug_level((m)->shrd) & (level)) \
  47. dev_err(bus(m)->dev, "%c %s " fmt, \
  48. in_interrupt() ? 'I' : 'U', __func__, \
  49. ##__VA_ARGS__); \
  50. } while (0)
  51. #define IWL_DEBUG_LIMIT(m, level, fmt, ...) \
  52. do { \
  53. if (iwl_get_debug_level((m)->shrd) & (level) && \
  54. net_ratelimit()) \
  55. dev_err(bus(m)->dev, "%c %s " fmt, \
  56. in_interrupt() ? 'I' : 'U', __func__, \
  57. ##__VA_ARGS__); \
  58. } while (0)
  59. #define iwl_print_hex_dump(m, level, p, len) \
  60. do { \
  61. if (iwl_get_debug_level((m)->shrd) & level) \
  62. print_hex_dump(KERN_DEBUG, "iwl data: ", \
  63. DUMP_PREFIX_OFFSET, 16, 1, p, len, 1); \
  64. } while (0)
  65. #define IWL_DEBUG_QUIET_RFKILL(p, fmt, ...) \
  66. do { \
  67. if (!iwl_is_rfkill(p->shrd)) \
  68. dev_err(bus(p)->dev, "%s%c %s " fmt, \
  69. "", \
  70. in_interrupt() ? 'I' : 'U', __func__, \
  71. ##__VA_ARGS__); \
  72. else if (iwl_get_debug_level(p->shrd) & IWL_DL_RADIO) \
  73. dev_err(bus(p)->dev, "%s%c %s " fmt, \
  74. "(RFKILL) ", \
  75. in_interrupt() ? 'I' : 'U', __func__, \
  76. ##__VA_ARGS__); \
  77. } while (0)
  78. #else
  79. #define IWL_DEBUG(m, level, fmt, args...)
  80. #define IWL_DEBUG_LIMIT(m, level, fmt, args...)
  81. #define iwl_print_hex_dump(m, level, p, len)
  82. #define IWL_DEBUG_QUIET_RFKILL(p, fmt, args...) \
  83. do { \
  84. if (!iwl_is_rfkill(p->shrd)) \
  85. IWL_ERR(p, fmt, ##args); \
  86. } while (0)
  87. #endif /* CONFIG_IWLWIFI_DEBUG */
  88. #ifdef CONFIG_IWLWIFI_DEBUGFS
  89. int iwl_dbgfs_register(struct iwl_priv *priv, const char *name);
  90. void iwl_dbgfs_unregister(struct iwl_priv *priv);
  91. #else
  92. static inline int iwl_dbgfs_register(struct iwl_priv *priv, const char *name)
  93. {
  94. return 0;
  95. }
  96. static inline void iwl_dbgfs_unregister(struct iwl_priv *priv)
  97. {
  98. }
  99. #endif /* CONFIG_IWLWIFI_DEBUGFS */
  100. /*
  101. * To use the debug system:
  102. *
  103. * If you are defining a new debug classification, simply add it to the #define
  104. * list here in the form of
  105. *
  106. * #define IWL_DL_xxxx VALUE
  107. *
  108. * where xxxx should be the name of the classification (for example, WEP).
  109. *
  110. * You then need to either add a IWL_xxxx_DEBUG() macro definition for your
  111. * classification, or use IWL_DEBUG(IWL_DL_xxxx, ...) whenever you want
  112. * to send output to that classification.
  113. *
  114. * The active debug levels can be accessed via files
  115. *
  116. * /sys/module/iwlwifi/parameters/debug
  117. * when CONFIG_IWLWIFI_DEBUG=y.
  118. *
  119. * /sys/kernel/debug/phy0/iwlwifi/debug/debug_level
  120. * when CONFIG_IWLWIFI_DEBUGFS=y.
  121. *
  122. */
  123. /* 0x0000000F - 0x00000001 */
  124. #define IWL_DL_INFO (1 << 0)
  125. #define IWL_DL_MAC80211 (1 << 1)
  126. #define IWL_DL_HCMD (1 << 2)
  127. #define IWL_DL_STATE (1 << 3)
  128. /* 0x000000F0 - 0x00000010 */
  129. #define IWL_DL_MACDUMP (1 << 4)
  130. #define IWL_DL_HCMD_DUMP (1 << 5)
  131. #define IWL_DL_EEPROM (1 << 6)
  132. #define IWL_DL_RADIO (1 << 7)
  133. /* 0x00000F00 - 0x00000100 */
  134. #define IWL_DL_POWER (1 << 8)
  135. #define IWL_DL_TEMP (1 << 9)
  136. /* reserved (1 << 10) */
  137. #define IWL_DL_SCAN (1 << 11)
  138. /* 0x0000F000 - 0x00001000 */
  139. #define IWL_DL_ASSOC (1 << 12)
  140. #define IWL_DL_DROP (1 << 13)
  141. /* reserved (1 << 14) */
  142. #define IWL_DL_COEX (1 << 15)
  143. /* 0x000F0000 - 0x00010000 */
  144. #define IWL_DL_FW (1 << 16)
  145. #define IWL_DL_RF_KILL (1 << 17)
  146. #define IWL_DL_FW_ERRORS (1 << 18)
  147. #define IWL_DL_LED (1 << 19)
  148. /* 0x00F00000 - 0x00100000 */
  149. #define IWL_DL_RATE (1 << 20)
  150. #define IWL_DL_CALIB (1 << 21)
  151. #define IWL_DL_WEP (1 << 22)
  152. #define IWL_DL_TX (1 << 23)
  153. /* 0x0F000000 - 0x01000000 */
  154. #define IWL_DL_RX (1 << 24)
  155. #define IWL_DL_ISR (1 << 25)
  156. #define IWL_DL_HT (1 << 26)
  157. /* 0xF0000000 - 0x10000000 */
  158. #define IWL_DL_11H (1 << 28)
  159. #define IWL_DL_STATS (1 << 29)
  160. #define IWL_DL_TX_REPLY (1 << 30)
  161. #define IWL_DL_TX_QUEUES (1 << 31)
  162. #define IWL_DEBUG_INFO(p, f, a...) IWL_DEBUG(p, IWL_DL_INFO, f, ## a)
  163. #define IWL_DEBUG_MAC80211(p, f, a...) IWL_DEBUG(p, IWL_DL_MAC80211, f, ## a)
  164. #define IWL_DEBUG_MACDUMP(p, f, a...) IWL_DEBUG(p, IWL_DL_MACDUMP, f, ## a)
  165. #define IWL_DEBUG_TEMP(p, f, a...) IWL_DEBUG(p, IWL_DL_TEMP, f, ## a)
  166. #define IWL_DEBUG_SCAN(p, f, a...) IWL_DEBUG(p, IWL_DL_SCAN, f, ## a)
  167. #define IWL_DEBUG_RX(p, f, a...) IWL_DEBUG(p, IWL_DL_RX, f, ## a)
  168. #define IWL_DEBUG_TX(p, f, a...) IWL_DEBUG(p, IWL_DL_TX, f, ## a)
  169. #define IWL_DEBUG_ISR(p, f, a...) IWL_DEBUG(p, IWL_DL_ISR, f, ## a)
  170. #define IWL_DEBUG_LED(p, f, a...) IWL_DEBUG(p, IWL_DL_LED, f, ## a)
  171. #define IWL_DEBUG_WEP(p, f, a...) IWL_DEBUG(p, IWL_DL_WEP, f, ## a)
  172. #define IWL_DEBUG_HC(p, f, a...) IWL_DEBUG(p, IWL_DL_HCMD, f, ## a)
  173. #define IWL_DEBUG_HC_DUMP(p, f, a...) IWL_DEBUG(p, IWL_DL_HCMD_DUMP, f, ## a)
  174. #define IWL_DEBUG_EEPROM(p, f, a...) IWL_DEBUG(p, IWL_DL_EEPROM, f, ## a)
  175. #define IWL_DEBUG_CALIB(p, f, a...) IWL_DEBUG(p, IWL_DL_CALIB, f, ## a)
  176. #define IWL_DEBUG_FW(p, f, a...) IWL_DEBUG(p, IWL_DL_FW, f, ## a)
  177. #define IWL_DEBUG_RF_KILL(p, f, a...) IWL_DEBUG(p, IWL_DL_RF_KILL, f, ## a)
  178. #define IWL_DEBUG_FW_ERRORS(p, f, a...) IWL_DEBUG(p, IWL_DL_FW_ERRORS, f, ## a)
  179. #define IWL_DEBUG_DROP(p, f, a...) IWL_DEBUG(p, IWL_DL_DROP, f, ## a)
  180. #define IWL_DEBUG_DROP_LIMIT(p, f, a...) \
  181. IWL_DEBUG_LIMIT(p, IWL_DL_DROP, f, ## a)
  182. #define IWL_DEBUG_COEX(p, f, a...) IWL_DEBUG(p, IWL_DL_COEX, f, ## a)
  183. #define IWL_DEBUG_RATE(p, f, a...) IWL_DEBUG(p, IWL_DL_RATE, f, ## a)
  184. #define IWL_DEBUG_RATE_LIMIT(p, f, a...) \
  185. IWL_DEBUG_LIMIT(p, IWL_DL_RATE, f, ## a)
  186. #define IWL_DEBUG_ASSOC(p, f, a...) \
  187. IWL_DEBUG(p, IWL_DL_ASSOC | IWL_DL_INFO, f, ## a)
  188. #define IWL_DEBUG_ASSOC_LIMIT(p, f, a...) \
  189. IWL_DEBUG_LIMIT(p, IWL_DL_ASSOC | IWL_DL_INFO, f, ## a)
  190. #define IWL_DEBUG_HT(p, f, a...) IWL_DEBUG(p, IWL_DL_HT, f, ## a)
  191. #define IWL_DEBUG_STATS(p, f, a...) IWL_DEBUG(p, IWL_DL_STATS, f, ## a)
  192. #define IWL_DEBUG_STATS_LIMIT(p, f, a...) \
  193. IWL_DEBUG_LIMIT(p, IWL_DL_STATS, f, ## a)
  194. #define IWL_DEBUG_TX_REPLY(p, f, a...) IWL_DEBUG(p, IWL_DL_TX_REPLY, f, ## a)
  195. #define IWL_DEBUG_TX_REPLY_LIMIT(p, f, a...) \
  196. IWL_DEBUG_LIMIT(p, IWL_DL_TX_REPLY, f, ## a)
  197. #define IWL_DEBUG_TX_QUEUES(p, f, a...) IWL_DEBUG(p, IWL_DL_TX_QUEUES, f, ## a)
  198. #define IWL_DEBUG_RADIO(p, f, a...) IWL_DEBUG(p, IWL_DL_RADIO, f, ## a)
  199. #define IWL_DEBUG_POWER(p, f, a...) IWL_DEBUG(p, IWL_DL_POWER, f, ## a)
  200. #define IWL_DEBUG_11H(p, f, a...) IWL_DEBUG(p, IWL_DL_11H, f, ## a)
  201. #endif