1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ 2 /* Copyright(c) 2019-2020 Realtek Corporation 3 */ 4 5 #ifndef __RTW89_DEBUG_H__ 6 #define __RTW89_DEBUG_H__ 7 8 #include "core.h" 9 10 #if defined(__FreeBSD__) 11 #include <linux/printk.h> 12 #ifndef DUMP_PREFIX_OFFSET 13 #define DUMP_PREFIX_OFFSET 0 14 #endif 15 #endif 16 17 enum rtw89_debug_mask { 18 RTW89_DBG_TXRX = BIT(0), 19 RTW89_DBG_RFK = BIT(1), 20 RTW89_DBG_RFK_TRACK = BIT(2), 21 RTW89_DBG_CFO = BIT(3), 22 RTW89_DBG_TSSI = BIT(4), 23 RTW89_DBG_TXPWR = BIT(5), 24 RTW89_DBG_HCI = BIT(6), 25 RTW89_DBG_RA = BIT(7), 26 RTW89_DBG_REGD = BIT(8), 27 RTW89_DBG_PHY_TRACK = BIT(9), 28 RTW89_DBG_DIG = BIT(10), 29 RTW89_DBG_SER = BIT(11), 30 RTW89_DBG_FW = BIT(12), 31 RTW89_DBG_BTC = BIT(13), 32 RTW89_DBG_BF = BIT(14), 33 RTW89_DBG_HW_SCAN = BIT(15), 34 RTW89_DBG_SAR = BIT(16), 35 RTW89_DBG_STATE = BIT(17), 36 RTW89_DBG_WOW = BIT(18), 37 RTW89_DBG_UL_TB = BIT(19), 38 RTW89_DBG_CHAN = BIT(20), 39 RTW89_DBG_ACPI = BIT(21), 40 RTW89_DBG_EDCCA = BIT(22), 41 RTW89_DBG_PS = BIT(23), 42 43 #if defined(__FreeBSD__) 44 RTW89_DBG_IO_RW = BIT(30), 45 #endif 46 RTW89_DBG_UNEXP = BIT(31), 47 }; 48 49 enum rtw89_debug_mac_reg_sel { 50 RTW89_DBG_SEL_MAC_00, 51 RTW89_DBG_SEL_MAC_30, 52 RTW89_DBG_SEL_MAC_40, 53 RTW89_DBG_SEL_MAC_80, 54 RTW89_DBG_SEL_MAC_C0, 55 RTW89_DBG_SEL_MAC_E0, 56 RTW89_DBG_SEL_BB, 57 RTW89_DBG_SEL_IQK, 58 RTW89_DBG_SEL_RFC, 59 }; 60 61 #ifdef CONFIG_RTW89_DEBUGFS 62 void rtw89_debugfs_init(struct rtw89_dev *rtwdev); 63 void rtw89_debugfs_deinit(struct rtw89_dev *rtwdev); 64 #else 65 static inline void rtw89_debugfs_init(struct rtw89_dev *rtwdev) {} 66 static inline void rtw89_debugfs_deinit(struct rtw89_dev *rtwdev) {} 67 #endif 68 69 #define rtw89_info(rtwdev, a...) dev_info((rtwdev)->dev, ##a) 70 #define rtw89_info_once(rtwdev, a...) dev_info_once((rtwdev)->dev, ##a) 71 #define rtw89_warn(rtwdev, a...) dev_warn((rtwdev)->dev, ##a) 72 #define rtw89_err(rtwdev, a...) dev_err((rtwdev)->dev, ##a) 73 74 #ifdef CONFIG_RTW89_DEBUGMSG 75 extern unsigned int rtw89_debug_mask; 76 77 __printf(3, 4) 78 void rtw89_debug(struct rtw89_dev *rtwdev, enum rtw89_debug_mask mask, 79 const char *fmt, ...); 80 static inline void rtw89_hex_dump(struct rtw89_dev *rtwdev, 81 enum rtw89_debug_mask mask, 82 const char *prefix_str, 83 const void *buf, size_t len) 84 { 85 if (!(rtw89_debug_mask & mask)) 86 return; 87 88 print_hex_dump_bytes(prefix_str, DUMP_PREFIX_OFFSET, buf, len); 89 } 90 91 static inline bool rtw89_debug_is_enabled(struct rtw89_dev *rtwdev, 92 enum rtw89_debug_mask mask) 93 { 94 return !!(rtw89_debug_mask & mask); 95 } 96 #else 97 static inline void rtw89_debug(struct rtw89_dev *rtwdev, 98 enum rtw89_debug_mask mask, 99 const char *fmt, ...) {} 100 static inline void rtw89_hex_dump(struct rtw89_dev *rtwdev, 101 enum rtw89_debug_mask mask, 102 const char *prefix_str, 103 const void *buf, size_t len) {} 104 static inline bool rtw89_debug_is_enabled(struct rtw89_dev *rtwdev, 105 enum rtw89_debug_mask mask) 106 { 107 return false; 108 } 109 #endif 110 111 #endif 112