drivers/net/wireless/rtlwifi/debug.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2009-2012  Realtek Corporation.
   4  *
   5  * Tmis program is free software; you can redistribute it and/or modify it
   6  * under the terms of version 2 of the GNU General Public License as
   7  * published by the Free Software Foundation.
   8  *
   9  * Tmis program is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  12  * more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along with
  15  * tmis program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
  17  *
  18  * Tme full GNU General Public License is included in this distribution in the
  19  * file called LICENSE.
  20  *
  21  * Contact Information:
  22  * wlanfae <wlanfae@realtek.com>
  23  * Realtek Corporation, No. 2, Innovation Road II, Hsinchu Science Park,
  24  * Hsinchu 300, Taiwan.
  25  *
  26  * Larry Finger <Larry.Finger@lwfinger.net>
  27  *****************************************************************************/
  28
  29 #ifndef __RTL_DEBUG_H__
  30 #define __RTL_DEBUG_H__
  31
  32 /*--------------------------------------------------------------
  33                         Debug level
  34 --------------------------------------------------------------*/
  35 /*
  36  *Fatal bug.
  37  *For example, Tx/Rx/IO locked up,
  38  *memory access violation,
  39  *resource allocation failed,
  40  *unexpected HW behavior, HW BUG
  41  *and so on.
  42  */
  43 #define DBG_EMERG                       0
  44
  45 /*
  46  *Abnormal, rare, or unexpeted cases.
  47  *For example, Packet/IO Ctl canceled,
  48  *device suprisely unremoved and so on.
  49  */
  50 #define DBG_WARNING                     2
  51
  52 /*
  53  *Normal case driver developer should
  54  *open, we can see link status like
  55  *assoc/AddBA/DHCP/adapter start and
  56  *so on basic and useful infromations.
  57  */
  58 #define DBG_DMESG                       3
  59
  60 /*
  61  *Normal case with useful information
  62  *about current SW or HW state.
  63  *For example, Tx/Rx descriptor to fill,
  64  *Tx/Rx descriptor completed status,
  65  *SW protocol state change, dynamic
  66  *mechanism state change and so on.
  67  */
  68 #define DBG_LOUD                        4
  69
  70 /*
  71  *Normal case with detail execution
  72  *flow or information.
  73  */
  74 #define DBG_TRACE                       5
  75
  76 /*--------------------------------------------------------------
  77                 Define the rt_trace components
  78 --------------------------------------------------------------*/
  79 #define COMP_ERR                        BIT(0)
  80 #define COMP_FW                         BIT(1)
  81 #define COMP_INIT                       BIT(2)  /*For init/deinit */
  82 #define COMP_RECV                       BIT(3)  /*For Rx. */
  83 #define COMP_SEND                       BIT(4)  /*For Tx. */
  84 #define COMP_MLME                       BIT(5)  /*For MLME. */
  85 #define COMP_SCAN                       BIT(6)  /*For Scan. */
  86 #define COMP_INTR                       BIT(7)  /*For interrupt Related. */
  87 #define COMP_LED                        BIT(8)  /*For LED. */
  88 #define COMP_SEC                        BIT(9)  /*For sec. */
  89 #define COMP_BEACON                     BIT(10) /*For beacon. */
  90 #define COMP_RATE                       BIT(11) /*For rate. */
  91 #define COMP_RXDESC                     BIT(12) /*For rx desc. */
  92 #define COMP_DIG                        BIT(13) /*For DIG */
  93 #define COMP_TXAGC                      BIT(14) /*For Tx power */
  94 #define COMP_HIPWR                      BIT(15) /*For High Power Mechanism */
  95 #define COMP_POWER                      BIT(16) /*For lps/ips/aspm. */
  96 #define COMP_POWER_TRACKING     BIT(17) /*For TX POWER TRACKING */
  97 #define COMP_BB_POWERSAVING     BIT(18)
  98 #define COMP_SWAS                       BIT(19) /*For SW Antenna Switch */
  99 #define COMP_RF                         BIT(20) /*For RF. */
 100 #define COMP_TURBO                      BIT(21) /*For EDCA TURBO. */
 101 #define COMP_RATR                       BIT(22)
 102 #define COMP_CMD                        BIT(23)
 103 #define COMP_EFUSE                      BIT(24)
 104 #define COMP_QOS                        BIT(25)
 105 #define COMP_MAC80211           BIT(26)
 106 #define COMP_REGD                       BIT(27)
 107 #define COMP_CHAN                       BIT(28)
 108 #define COMP_USB                        BIT(29)
 109 #define COMP_EASY_CONCURRENT    COMP_USB /* reuse of this bit is OK */
 110 #define COMP_BT_COEXIST                 BIT(30)
 111
 112 /*--------------------------------------------------------------
 113                 Define the rt_print components
 114 --------------------------------------------------------------*/
 115 /* Define EEPROM and EFUSE  check module bit*/
 116 #define EEPROM_W                        BIT(0)
 117 #define EFUSE_PG                        BIT(1)
 118 #define EFUSE_READ_ALL          BIT(2)
 119
 120 /* Define init check for module bit*/
 121 #define INIT_EEPROM                     BIT(0)
 122 #define INIT_TxPower            BIT(1)
 123 #define INIT_IQK                        BIT(2)
 124 #define INIT_RF                         BIT(3)
 125
 126 /* Define PHY-BB/RF/MAC check module bit */
 127 #define PHY_BBR                         BIT(0)
 128 #define PHY_BBW                         BIT(1)
 129 #define PHY_RFR                         BIT(2)
 130 #define PHY_RFW                         BIT(3)
 131 #define PHY_MACR                        BIT(4)
 132 #define PHY_MACW                        BIT(5)
 133 #define PHY_ALLR                        BIT(6)
 134 #define PHY_ALLW                        BIT(7)
 135 #define PHY_TXPWR                       BIT(8)
 136 #define PHY_PWRDIFF                     BIT(9)
 137
 138 enum dbgp_flag_e {
 139         FQOS = 0,
 140         FTX = 1,
 141         FRX = 2,
 142         FSEC = 3,
 143         FMGNT = 4,
 144         FMLME = 5,
 145         FRESOURCE = 6,
 146         FBEACON = 7,
 147         FISR = 8,
 148         FPHY = 9,
 149         FMP = 10,
 150         FEEPROM = 11,
 151         FPWR = 12,
 152         FDM = 13,
 153         FDBGCtrl = 14,
 154         FC2H = 15,
 155         FBT = 16,
 156         FINIT = 17,
 157         FIOCTL = 18,
 158         DBGP_TYPE_MAX
 159 };
 160
 161 #ifdef CONFIG_RTLWIFI_DEBUG
 162
 163 #define RT_ASSERT(_exp, fmt, ...)                                       \
 164 do {                                                                    \
 165         if (!(_exp)) {                                                  \
 166                 printk(KERN_DEBUG KBUILD_MODNAME ":%s(): " fmt,         \
 167                        __func__, ##__VA_ARGS__);                        \
 168         }                                                               \
 169 } while (0)
 170
 171 #define RT_TRACE(rtlpriv, comp, level, fmt, ...)                        \
 172 do {                                                                    \
 173         if (unlikely(((comp) & rtlpriv->dbg.global_debugcomponents) &&  \
 174                      ((level) <= rtlpriv->dbg.global_debuglevel))) {    \
 175                 printk(KERN_DEBUG KBUILD_MODNAME ":%s():<%lx-%x> " fmt, \
 176                        __func__, in_interrupt(), in_atomic(),           \
 177                        ##__VA_ARGS__);                                  \
 178         }                                                               \
 179 } while (0)
 180
 181 #define RTPRINT(rtlpriv, dbgtype, dbgflag, fmt, ...)                    \
 182 do {                                                                    \
 183         if (unlikely(rtlpriv->dbg.dbgp_type[dbgtype] & dbgflag)) {      \
 184                 printk(KERN_DEBUG KBUILD_MODNAME ": " fmt,              \
 185                        ##__VA_ARGS__);                                  \
 186         }                                                               \
 187 } while (0)
 188
 189 #define RT_PRINT_DATA(rtlpriv, _comp, _level, _titlestring, _hexdata,   \
 190                       _hexdatalen)                                      \
 191 do {                                                                    \
 192         if (unlikely(((_comp) & rtlpriv->dbg.global_debugcomponents) && \
 193                      (_level <= rtlpriv->dbg.global_debuglevel))) {     \
 194                 printk(KERN_DEBUG "%s: In process \"%s\" (pid %i): %s\n", \
 195                        KBUILD_MODNAME, current->comm, current->pid,     \
 196                        _titlestring);                                   \
 197                 print_hex_dump_bytes("", DUMP_PREFIX_NONE,              \
 198                                      _hexdata, _hexdatalen);            \
 199         }                                                               \
 200 } while (0)
 201
 202 #else
 203
 204 struct rtl_priv;
 205
 206 __printf(2, 3)
 207 static inline void RT_ASSERT(int exp, const char *fmt, ...)
 208 {
 209 }
 210
 211 __printf(4, 5)
 212 static inline void RT_TRACE(struct rtl_priv *rtlpriv,
 213                             int comp, int level,
 214                             const char *fmt, ...)
 215 {
 216 }
 217
 218 __printf(4, 5)
 219 static inline void RTPRINT(struct rtl_priv *rtlpriv,
 220                            int dbgtype, int dbgflag,
 221                            const char *fmt, ...)
 222 {
 223 }
 224
 225 static inline void RT_PRINT_DATA(struct rtl_priv *rtlpriv,
 226                                  int comp, int level,
 227                                  const char *titlestring,
 228                                  const void *hexdata, size_t hexdatalen)
 229 {
 230 }
 231
 232 #endif
 233
 234 void rtl_dbgp_flag_init(struct ieee80211_hw *hw);
 235 #endif