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