/* SPDX-License-Identifier: GPL-2.0 */ /****************************************************************************** * * Copyright(c) 2009-2012 Realtek Corporation. * * Contact Information: * wlanfae * Realtek Corporation, No. 2, Innovation Road II, Hsinchu Science Park, * Hsinchu 300, Taiwan. * * Larry Finger *****************************************************************************/ #ifndef __RTL_DEBUG_H__ #define __RTL_DEBUG_H__ /*-------------------------------------------------------------- * Debug level *------------------------------------------------------------ * *Fatal bug. *For example, Tx/Rx/IO locked up, *memory access violation, *resource allocation failed, *unexpected HW behavior, HW BUG *and so on. */ /*#define DBG_EMERG 0 */ /*Abnormal, rare, or unexpected cases. *For example, Packet/IO Ctl canceled, *device surprisingly removed and so on. */ #define DBG_WARNING 2 /*Normal case driver developer should *open, we can see link status like *assoc/AddBA/DHCP/adapter start and *so on basic and useful infromations. */ #define DBG_DMESG 3 /*Normal case with useful information *about current SW or HW state. *For example, Tx/Rx descriptor to fill, *Tx/Rx descriptor completed status, *SW protocol state change, dynamic *mechanism state change and so on. */ #define DBG_LOUD 4 /*Normal case with detail execution *flow or information. */ #define DBG_TRACE 5 /*-------------------------------------------------------------- * Define the rt_trace components *-------------------------------------------------------------- */ #define COMP_ERR BIT(0) #define COMP_FW BIT(1) #define COMP_INIT BIT(2) /*For init/deinit */ #define COMP_RECV BIT(3) /*For Rx. */ #define COMP_SEND BIT(4) /*For Tx. */ #define COMP_MLME BIT(5) /*For MLME. */ #define COMP_SCAN BIT(6) /*For Scan. */ #define COMP_INTR BIT(7) /*For interrupt Related. */ #define COMP_LED BIT(8) /*For LED. */ #define COMP_SEC BIT(9) /*For sec. */ #define COMP_BEACON BIT(10) /*For beacon. */ #define COMP_RATE BIT(11) /*For rate. */ #define COMP_RXDESC BIT(12) /*For rx desc. */ #define COMP_DIG BIT(13) /*For DIG */ #define COMP_TXAGC BIT(14) /*For Tx power */ #define COMP_HIPWR BIT(15) /*For High Power Mechanism */ #define COMP_POWER BIT(16) /*For lps/ips/aspm. */ #define COMP_POWER_TRACKING BIT(17) /*For TX POWER TRACKING */ #define COMP_BB_POWERSAVING BIT(18) #define COMP_SWAS BIT(19) /*For SW Antenna Switch */ #define COMP_RF BIT(20) /*For RF. */ #define COMP_TURBO BIT(21) /*For EDCA TURBO. */ #define COMP_RATR BIT(22) #define COMP_CMD BIT(23) #define COMP_EFUSE BIT(24) #define COMP_QOS BIT(25) #define COMP_MAC80211 BIT(26) #define COMP_REGD BIT(27) #define COMP_CHAN BIT(28) #define COMP_USB BIT(29) #define COMP_EASY_CONCURRENT COMP_USB /* reuse of this bit is OK */ #define COMP_BT_COEXIST BIT(30) #define COMP_IQK BIT(31) #define COMP_TX_REPORT BIT_ULL(32) #define COMP_HALMAC BIT_ULL(34) #define COMP_PHYDM BIT_ULL(35) /*-------------------------------------------------------------- * Define the rt_print components *-------------------------------------------------------------- */ /* Define EEPROM and EFUSE check module bit*/ #define EEPROM_W BIT(0) #define EFUSE_PG BIT(1) #define EFUSE_READ_ALL BIT(2) /* Define init check for module bit*/ #define INIT_EEPROM BIT(0) #define INIT_TXPOWER BIT(1) #define INIT_IQK BIT(2) #define INIT_RF BIT(3) /* Define PHY-BB/RF/MAC check module bit */ #define PHY_BBR BIT(0) #define PHY_BBW BIT(1) #define PHY_RFR BIT(2) #define PHY_RFW BIT(3) #define PHY_MACR BIT(4) #define PHY_MACW BIT(5) #define PHY_ALLR BIT(6) #define PHY_ALLW BIT(7) #define PHY_TXPWR BIT(8) #define PHY_PWRDIFF BIT(9) /* Define Dynamic Mechanism check module bit --> FDM */ #define WA_IOT BIT(0) #define DM_PWDB BIT(1) #define DM_MONITOR BIT(2) #define DM_DIG BIT(3) #define DM_EDCA_TURBO BIT(4) #define DM_PWDB BIT(1) enum dbgp_flag_e { FQOS = 0, FTX = 1, FRX = 2, FSEC = 3, FMGNT = 4, FMLME = 5, FRESOURCE = 6, FBEACON = 7, FISR = 8, FPHY = 9, FMP = 10, FEEPROM = 11, FPWR = 12, FDM = 13, FDBGCTRL = 14, FC2H = 15, FBT = 16, FINIT = 17, FIOCTL = 18, DBGP_TYPE_MAX }; #ifdef CONFIG_RTLWIFI_DEBUG_ST struct rtl_priv; __printf(4, 5) void _rtl_dbg_trace(struct rtl_priv *rtlpriv, u64 comp, int level, const char *fmt, ...); __printf(4, 5) void _rtl_dbg_print(struct rtl_priv *rtlpriv, u64 comp, int level, const char *fmt, ...); void _rtl_dbg_print_data(struct rtl_priv *rtlpriv, u64 comp, int level, const char *titlestring, const void *hexdata, int hexdatalen); #define RT_TRACE(rtlpriv, comp, level, fmt, ...) \ _rtl_dbg_trace(rtlpriv, comp, level, \ fmt, ##__VA_ARGS__) #define RTPRINT(rtlpriv, dbgtype, dbgflag, fmt, ...) \ _rtl_dbg_print(rtlpriv, dbgtype, dbgflag, fmt, ##__VA_ARGS__) #define RT_PRINT_DATA(rtlpriv, _comp, _level, _titlestring, _hexdata, \ _hexdatalen) \ _rtl_dbg_print_data(rtlpriv, _comp, _level, \ _titlestring, _hexdata, _hexdatalen) #else struct rtl_priv; __printf(4, 5) static inline void RT_TRACE(struct rtl_priv *rtlpriv, u64 comp, int level, const char *fmt, ...) { } __printf(4, 5) static inline void RTPRINT(struct rtl_priv *rtlpriv, int dbgtype, int dbgflag, const char *fmt, ...) { } static inline void RT_PRINT_DATA(struct rtl_priv *rtlpriv, u64 comp, int level, const char *titlestring, const void *hexdata, size_t hexdatalen) { } #endif #ifdef CONFIG_RTLWIFI_DEBUG_ST void rtl_debug_add_one(struct ieee80211_hw *hw); void rtl_debug_remove_one(struct ieee80211_hw *hw); void rtl_debugfs_add_topdir(void); void rtl_debugfs_remove_topdir(void); #else #define rtl_debug_add_one(hw) #define rtl_debug_remove_one(hw) #define rtl_debugfs_add_topdir() #define rtl_debugfs_remove_topdir() #endif #endif